|
@@ -0,0 +1,56 @@
|
|
|
+Babylon.js Viewer
|
|
|
+=====================
|
|
|
+
|
|
|
+Babylon's viewer is a wrapper around Babylon, that automatically initializes the needed components in order to display a loaded model. It is easy to use, and require no coding at all.
|
|
|
+
|
|
|
+The viewer automatically interacts with the DOM, searching for HTML elements named `babylon`. It will then automatically read the configuration from the DOM element and will create a scene for it.
|
|
|
+
|
|
|
+for basic and advanced usage instructions please read the doc at https://doc.babylonjs.com/extensions/the_babylon_viewer
|
|
|
+
|
|
|
+The source code can be found at https://github.com/BabylonJS/Babylon.js/tree/master/Viewer
|
|
|
+
|
|
|
+# Basic usage
|
|
|
+
|
|
|
+to create a simple viewer add the following code to your HTML>
|
|
|
+
|
|
|
+```HTML
|
|
|
+<babylon model="https://playground.babylonjs.com/scenes/Rabbit.babylon"></babylon>
|
|
|
+<script src="https://viewer.babylonjs.com/viewer.min.js"></script>
|
|
|
+```
|
|
|
+
|
|
|
+Make sure to size the babylon HTML tag. For example:
|
|
|
+
|
|
|
+```css
|
|
|
+babylon {
|
|
|
+ max-width: 800px;
|
|
|
+ max-height: 500px;
|
|
|
+ width: 100%;
|
|
|
+ height: 600px;
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+# Installation instructions
|
|
|
+
|
|
|
+## CDN
|
|
|
+
|
|
|
+Compiled js files (minified) are offered on our public CDN here:
|
|
|
+
|
|
|
+* https://viewer.babylonjs.com/serializers/viewer.min.js
|
|
|
+
|
|
|
+## NPM
|
|
|
+
|
|
|
+To install using npm :
|
|
|
+
|
|
|
+```
|
|
|
+npm install --save babylonjs-viewer
|
|
|
+```
|
|
|
+
|
|
|
+Afterwards it can be imported to the project using:
|
|
|
+
|
|
|
+```
|
|
|
+import from 'babylonjs-viewer';
|
|
|
+```
|
|
|
+
|
|
|
+This will enable the BabylonViewer namespace.
|
|
|
+
|
|
|
+Using webpack to package your project will use the minified js file.
|