Merge pull request #5 from muonlineph/dev

v3.0.0 merge from dev to master

README.md

@@ -35,12 +35,45 @@
 4. Load the webgl json loader from  
 `http://localhost:3000`
 
+5. Load the basic-usage object loader demo from  
+`http://localhost:3000/simple.html`
+
 
 
 ## Usage
 
-1. Initialize a ThreeJS scene, camera and renderer. See `public/main.js` **init()** for more information.
-2. Load ojbect model file(s) (.obj) and add to the ThreeJS scene.  
+
+### Model Viewer and Object Loader Usage
+
+> This is the recommended usage for rendering object models as all Three.js scenes are already set-up in the **Viewer** object.
+
+1. Include the required Three.js files in your website (from the **/public/js** directory):  
+`three.min.js`, `DDSLoader.js`, `MTLLoader.js`, `OBJLoader.js`.
+
+2. Include the custom loader and model viewer (from the **/public** directory):  
+`loader.js`, `viewer.js`
+
+3. Load your object model(s) using **async-await**, but do not add them to the scene. See [**Object Loader (Basic Usage)**, #2]() for more information.
+
+		let a = await loadModel(...)
+		let b = await loadModel(...)
+		let c = await loadModel(...)
+
+4. Initialize a new **Viewer** object with the loaded models from #1 as parameters.  
+`const viewer = new Viewer([a, b, c])`
+
+
+### Object Loader (Basic Usage)
+
+1. Include the required Three.js files in your website (from the **/public/js** directory):  
+`three.min.js`, `DDSLoader.js`, `MTLLoader.js`, `OBJLoader.js`.
+
+2. Include the custom loader and model viewer (from the **/public** directory):  
+`loader.js`, `simple.js`
+
+3. Initialize a ThreeJS scene, camera and renderer. See `public/simple.js` **init()** for more information.
+
+4. Load ojbect model file(s) (.obj) and add to the ThreeJS scene.  
 
 		let staff = await loadModel('objects/staffofkundun/', 'kundun-OBJ.mtl', 'kundun-OBJ.obj', {
 		  position: { y:10 },
@@ -49,7 +82,7 @@
 
 		scene.add(staff)
 
-	- see `public/loader.js` for more loading options
+	- see `public/loader.js` for more object loading options
 	- any number of object files can be loaded and added to the `scene`.