commented and completed sample

samples/basic/Main.hx

@@ -1,46 +1,80 @@
 import h3d.scene.*;
 
 class Main extends hxd.App {
-	
+
 	var time : Float = 0.;
 	var obj1 : Mesh;
 	var obj2 : Mesh;
-		
+
 	override function init() {
-		
+
+		// creates a new unit cube
 		var prim = new h3d.prim.Cube();
+
+		// translate it so its center will be at the center of the cube
 		prim.translate( -0.5, -0.5, -0.5);
-		prim.addUVs();
+
+		// unindex the faces to create hard edges normals
+		prim.unindex();
+
+		// add face normals
 		prim.addNormals();
-		
+
+		// add texture coordinates
+		prim.addUVs();
+
+		// accesss the logo resource and convert it to a texture
 		var tex = hxd.Res.hxlogo.toTexture();
+
+		// create a material with this texture
 		var mat = new h3d.mat.MeshMaterial(tex);
-		
+
+		// our first cube mesh on the 3D scene with our created material
 		obj1 = new Mesh(prim, mat, s3d);
+
+		// creates another cube, this time with no texture
 		obj2 = new Mesh(prim, new h3d.mat.MeshMaterial(), s3d);
-		obj2.material.color.set(1, 0.7, 0.5);
-	
-		mat.mainPass.addShader(new h3d.shader.VertexColor()).additive = true; // this will use normals
-		
-		/*mat.lightSystem = {
-			ambient : new h3d.Vector(0, 0, 0),
-			dirs : [{ dir : new h3d.Vector(-0.3,-0.5,-1), color : new h3d.Vector(1,1,1) }],
-			points : [{ pos : new h3d.Vector(1.5,0,0), color : new h3d.Vector(3,0,0), att : new h3d.Vector(0,0,1) }],
-		};*/
-		
-		update(0);
+
+		// set the second cube color
+		obj2.material.color.setColor(0xFFB280);
+
+		// put it above the first cube
+		obj2.z = 0.7;
+
+		// scale it down to 60%
+		obj2.scale(0.6);
+
+		// adds a directional light to the scene
+		new h3d.scene.DirLight(new h3d.Vector(0.5, 0.5, -0.5), s3d);
+
+		// set the ambient light to 30%
+		s3d.getPass("default").getLightSystem().ambientLight.set(0.3, 0.3, 0.3);
+
+		// activate lights on boss cubes
+		obj1.material.mainPass.enableLights = true;
+		obj2.material.mainPass.enableLights = true;
 	}
-	
+
 	override function update( dt : Float ) {
-		var dist = 5;
+
+		// time is flying...
 		time += 0.01 * dt;
-		s3d.camera.pos.set(Math.cos(time) * dist, Math.sin(time) * dist, 3);
+
+		// move the camera position around the two cubes
+		var dist = 3;
+		s3d.camera.pos.set(Math.cos(time) * dist, Math.sin(time) * dist, dist * 0.7 * Math.sin(time));
+
+		// rotate the second cube along a given axis + angle
 		obj2.setRotateAxis(-0.5, 2, Math.cos(time), time + Math.PI / 2);
 	}
-	
+
 	static function main() {
+
+		// initialize embeded ressources
 		hxd.Res.initEmbed();
+
+		// start the application
 		new Main();
 	}
-	
+
 }