Complete rewrite with new images and adapted display

README.md

@@ -2,17 +2,38 @@ threex.planets.js
 =================
 
 It is a three.js extension to display planets
-based on the data from [planetpixelemporium](http://planetpixelemporium.com/planets.html).
-It is a cool site, go check it out.
-It provides all the planets from the solar system.
-As a cherry on the cake, it has a 'atmosphere material'.
-It is released under MIT license.
+based on the data from  
+* [planetpixelemporium](http://planetpixelemporium.com/planets.html) (Sun*, Earth DEM, Uranus)  
+* [USGS Astrogeology](http://astrogeology.usgs.gov/solar-system) (Mercury DEM, Moon*, Mars, Jupiter Moons, Uranus Moons)
+* [NASA/JHUAPL/Carnegie Institution of Washington](http://messenger.jhuapl.edu/Explore/Images.html#global-mosaics) (Mercury Map*)
+* [NASA/JHUAPL/SWRI](http://pluto.jhuapl.edu/Multimedia/Science-Photos/image.php?gallery_id=2&image_id=252) (Pluto*, Charon)
+* [NASA/JPL-Caltech/Space Science Institute](http://www.jpl.nasa.gov/spaceimages/searchwp.php?category=saturn) (Saturn Rings*, Titan, Triton*)
+* [NASA/JPL-Caltech/Space Science Institute/LPI](http://www.lpi.usra.edu/icy_moons/) (Saturn Icy Moons*)
+* [NASA/JPL-Caltech](http://voyager.jpl.nasa.gov/gallery/uranus.html) (Uranus Rings*)
+* [NASA/JPL-Caltech](http://maps.jpl.nasa.gov/) (Stars)
+* [NASA Visible Earth](http://visibleearth.nasa.gov/view_cat.php?categoryID=1484) (Earth, Earth Clouds*)
+* [ESO](http://www.eso.org/public/usa/images/eso0127a/) (Solar Corona*)
+* [Björn Jónsson](http://bjj.mmedia.is/data/planetary_maps.html) (Venus*, Jupiter, Neptune)
+* [Solar System Scope](http://www.solarsystemscope.com/nexus/textures/planet_textures/) (Saturn, Titan Clouds)
+* [Philip Stooke](http://solarviews.com/cap/index/maps-cylindrical1.html) (Deimos, Proteus)  
+\* Hand adapted by ofrohn, also Jupiter & Neptune ring maps
+
 Here is some demos to show off
 
+* [planetary systems](http://ofrohn.github.io/threex-planets-demo/planetary-systems.html)
+and its 
+[source](https://github.com/ofrohn/threex.planets/blob/master/examples/planetary-systems.html). Simulation of planets with their moons.  
+* [all the planets](http://ofrohn.github.io/threex-planets-demo/planets.html)
+and its 
+[source](https://github.com/ofrohn/threex.planets/blob/master/examples/planets.html). All the implemented objects dancing in a circle.  
+* [earth and moon](http://ofrohn.github.io/threex-planets-demo/eartmoon.html)
+and its 
+[source](https://github.com/ofrohn/threex.planets/blob/master/examples/earthmoon.html). The Earth spinning and the Moon orbiting it.  
+_Older examples_  
 * [earth demo](http://jeromeetienne.github.io/threex.planets/examples/earth.html)
 and check its 
 [source](https://github.com/jeromeetienne/threex.planets/blob/master/examples/earth.html).
-It display a nice earth with cloud and even the moon.
+It displays a nice earth with cloud and even the moon.
 * [select demo](http://jeromeetienne.github.io/threex.planets/examples/select.html)
 and check its 
 [source](https://github.com/jeromeetienne/threex.planets/blob/master/examples/select.html).
@@ -73,12 +94,37 @@ updateFcts.push(function(delta, now){
 })
 ```
 
+new simpler form:
+
+```javascript
+var mesh = THREEx.Planets.create("Uranus"); // ring included
+scene.add(mesh);
+
+var mesh	= THREEx.Planets.create("Earth"); // clouds included
+scene.add(mesh);
+updateFcts.push(function(delta, now){
+	mesh.traverse(function(child) {
+    if (child.name.search("cloud") !== -1) child.rotation.y += 1/8 * delta;
+  });
+});
+
+var mesh	= THREEx.Planets.create("Earth", true);  // no clouds
+```
+
 ## API
 
 Here is the list of all the functions.
 They all return a ```THREE.Object3d```. 
 You can tune it to fit your need
 
+* ```THREEx.Planets.create(body, skipextras)``` return the mesh of any supported body  
+      body: Sun|Mercury|Venus|Earth|Moon|Mars|Vesta|Ceres|Jupiter|Saturn|Uranus|Neptune|Pluto  
+      skipextras: No ring, cloud, corona or other extra elements  
+* ```THREEx.Planets.createRings(body)```  return the ring mesh of any supported body  
+      body: Jupiter|Saturn|Uranus|Neptune  
+* ```THREEx.Planets.createClouds(body)``` return the cloud mesh of any supported body  
+      body: Earth|Mars  
+
 * ```THREEx.Planets.createSun()``` return the mesh of the Sun
 * ```THREEx.Planets.createMercury()``` return the mesh of Mercury
 * ```THREEx.Planets.createVenus()``` return the mesh of Venus

examples/atmospherematerial.html

@@ -59,25 +59,25 @@
 	// mesh.visible	= false
 	scene.add(mesh)
 
-	var geometry	= new THREE.SphereGeometry(0.5, 32, 32)
+	var geometry	= new THREE.SphereGeometry(THREEx.Planets.params.sun.radius, 32, 32)
 	geometry	= mesh.geometry.clone()
 	var material	= THREEx.createAtmosphereMaterial()
 	material.uniforms.glowColor.value	= glowColor
 	var mesh	= new THREE.Mesh(geometry, material );
-	mesh.scale.multiplyScalar(1.01);
+	mesh.scale.multiplyScalar(1.005);
 	scene.add( mesh );
 
 	// new THREEx.addAtmosphereMaterial2DatGui(material, datGUI)
 
-	var geometry	= new THREE.SphereGeometry(0.5, 32, 32)
+	var geometry	= new THREE.SphereGeometry(THREEx.Planets.params.sun.radius, 32, 32)
 	geometry	= mesh.geometry.clone()
 	var material	= THREEx.createAtmosphereMaterial()
 	material.side	= THREE.BackSide
 	material.uniforms.coeficient.value	= 0.5
 	material.uniforms.power.value		= 4.0
 	material.uniforms.glowColor.value	= glowColor
 	var mesh	= new THREE.Mesh(geometry, material );
-	mesh.scale.multiplyScalar(1.2);
+	mesh.scale.multiplyScalar(1.1);
 	scene.add( mesh );
 
 	new THREEx.addAtmosphereMaterial2DatGui(material, datGUI)

examples/earth.html

@@ -73,24 +73,24 @@
 		earthMesh.rotation.y += 1/32 * delta;		
 	})
 
-	var geometry	= new THREE.SphereGeometry(0.5, 32, 32)
+	var geometry	= new THREE.SphereGeometry(THREEx.Planets.params.earth.radius, 32, 32)
 	var material	= THREEx.createAtmosphereMaterial()
 	material.uniforms.glowColor.value.set(0x00b3ff)
 	material.uniforms.coeficient.value	= 0.8
 	material.uniforms.power.value		= 2.0
 	var mesh	= new THREE.Mesh(geometry, material );
-	mesh.scale.multiplyScalar(1.01);
+	mesh.scale.multiplyScalar(1.005);
 	containerEarth.add( mesh );
 	// new THREEx.addAtmosphereMaterial2DatGui(material, datGUI)
 
-	var geometry	= new THREE.SphereGeometry(0.5, 32, 32)
+	var geometry	= new THREE.SphereGeometry(THREEx.Planets.params.earth.radius, 32, 32)
 	var material	= THREEx.createAtmosphereMaterial()
 	material.side	= THREE.BackSide
 	material.uniforms.glowColor.value.set(0x00b3ff)
 	material.uniforms.coeficient.value	= 0.5
 	material.uniforms.power.value		= 4.0
 	var mesh	= new THREE.Mesh(geometry, material );
-	mesh.scale.multiplyScalar(1.15);
+	mesh.scale.multiplyScalar(1.05);
 	containerEarth.add( mesh );
 	// new THREEx.addAtmosphereMaterial2DatGui(material, datGUI)
 

examples/earthmoon.html

@@ -0,0 +1,121 @@
+<!DOCTYPE html>
+  <meta name="viewport" content="width=device-width, user-scalable=no, minimum-scale=1.0, maximum-scale=1.0">
+  <meta charset="utf-8">
+  <script src='../lib/three.js'></script>
+  <script src='../lib/OrbitControls.js'></script>
+  <script src='../lib/threex.planets.js'></script>
+  <script src='../lib/planetary.js'></script>
+<body id="map" style='margin: 0px; overflow: hidden; text-align:center;'><script>
+ var luna = {
+    "name":"Moon",
+    "parent":"ter",
+    "map":"lun",
+    "trajectory":false,
+    "H":0.25,
+    "ref":"ecl",
+    "elements":[{"a":384400,"e":0.0554,"i":5.16,"M":135.27,"w":318.15,"N":125.08,"n":13.176358,"dw":6003.002,"dN":1935.484,"ep":"2000-01-01.5TT"}]
+  };
+
+  // init renderer
+  var renderer = new THREE.WebGLRenderer({
+   antialias : true
+  });
+  renderer.setClearColor("#000");
+  renderer.setSize( window.innerWidth, window.innerHeight );
+  document.body.appendChild( renderer.domElement );
+
+  // array of functions for the rendering loop
+  var onRenderFcts= [], earth, moon, rot= [], speed = 0.25;
+
+  // init scene and camera
+  var scene = new THREE.Scene();
+  var camera = new THREE.PerspectiveCamera(45, window.innerWidth / window.innerHeight, 0.01, 10000);
+  camera.position.z = 10;
+  //camera.position.x = -1;
+  var controls = new THREE.OrbitControls(camera)
+
+  var light = new THREE.AmbientLight(0x333366);
+  scene.add(light);
+
+	var light	= new THREE.DirectionalLight(0xffffff, 1);
+	light.position.set(-100, 0, 0);
+	scene.add(light);
+
+  // stellar background
+  var starSphere	= THREEx.Planets.createStarfield()
+	scene.add(starSphere)
+
+  // radius & initial position of the moon "orbit"
+  var radius = 1e-5;
+  //to scale
+  //var radius = 6.3e-5; 
+  //THREEx.Planets.params.lun.radius = 0.1;
+
+  var dt = new Date();
+  var pos = transform(luna.elements[0], dt, luna.parent);
+
+  // the Earth mesh
+  var sun = THREEx.Planets.create("Sun");
+  sun.position.set(-100, 0, 0);
+
+  scene.add(sun);
+
+  // the Earth mesh
+  earth = THREEx.Planets.create("Earth");
+  scene.add(earth);
+  // rotation speed
+  rot.push(THREE.Math.degToRad(-15 * speed));
+  // the Moon mesh
+  moon = THREEx.Planets.create("Moon");
+  // initial position
+  moon.position.set(pos.x * radius, pos.z * radius, pos.y * radius);
+  moon.rotateOnAxis( new THREE.Vector3( 0, 1, 0 ), Math.PI);
+  scene.add(moon);
+  // rotaion/orbital speed
+  rot.push(THREE.Math.degToRad(-0.549 * speed));
+
+  // handle window resize
+  window.addEventListener('resize', function(){
+    renderer.setSize( window.innerWidth, window.innerHeight )
+    camera.aspect = window.innerWidth / window.innerHeight
+    camera.updateProjectionMatrix()  
+  }, false);
+
+
+  // render the scene
+  onRenderFcts.push(function(){
+    // turn the Earth 1 step
+    earth.rotateOnAxis( new THREE.Vector3( 0, 1, 0 ), rot[0]);
+    // spin the clouds a bit faster
+    earth.traverse(function(child) {
+      if (child.name.search("cloud") !== -1) child.rotateOnAxis( new THREE.Vector3( 0, 1, 0 ), 0.005);
+    });
+
+    dt = dateAdd(dt, speed, "h");
+    var pos = transform(luna.elements[0], dt, luna.parent);
+
+    // turn the Moon and move it at same speed
+    moon.rotateOnAxis( new THREE.Vector3( 0, 1, 0 ), rot[1]);
+    //theta += rot[1];
+    moon.position.set(pos.x * radius, pos.z * radius, pos.y * radius);
+
+    renderer.render(scene, camera);  
+  });
+
+  // run the rendering loop
+  var lastTimeMsec= null;
+  requestAnimationFrame(function animate(nowMsec) {
+    // keep looping
+    requestAnimationFrame(animate);
+    // measure time
+    lastTimeMsec = lastTimeMsec || nowMsec-1000/60;
+    var deltaMsec = Math.min(200, nowMsec - lastTimeMsec);
+    lastTimeMsec = nowMsec;
+    // call each update function
+    onRenderFcts.forEach(function(onRenderFct) {
+      onRenderFct(deltaMsec/1000, nowMsec/1000);
+    })
+  })
+
+
+</script></body>