update stable to 3.0.6, see http://hub.jmonkeyengine.org/forum/topic/candidate-changes-for-3-0-6/

git-svn-id: https://jmonkeyengine.googlecode.com/svn/branches/3.0final@11112 75d07b2b-3a1a-0410-a2c5-0572b91ccdca

engine/src/bullet-common/com/jme3/bullet/control/KinematicRagdollControl.java

@@ -355,6 +355,9 @@ public class KinematicRagdollControl extends AbstractPhysicsControl implements P
         //I remove the skeletonControl and readd it to the spatial to make sure it's after the ragdollControl in the stack
         //Find a proper way to order the controls.
         SkeletonControl sc = model.getControl(SkeletonControl.class);
+        if(sc == null){
+            throw new IllegalArgumentException("The root node of the model should have a SkeletonControl. Make sure the control is there and that it's not on a sub node.");
+        }
         model.removeControl(sc);
         model.addControl(sc);
 

engine/src/bullet-common/com/jme3/bullet/util/CollisionShapeFactory.java

@@ -210,7 +210,7 @@ public class CollisionShapeFactory {
     private static MeshCollisionShape createSingleMeshShape(Geometry geom, Spatial parent) {
         Mesh mesh = geom.getMesh();
         Transform trans = getTransform(geom, parent);
-        if (mesh != null) {
+        if (mesh != null && mesh.getMode() == Mesh.Mode.Triangles) {
             MeshCollisionShape mColl = new MeshCollisionShape(mesh);
             mColl.setScale(trans.getScale());
             return mColl;

engine/src/core-data/Common/MatDefs/Light/Lighting.frag

@@ -211,11 +211,14 @@ void main(){
     // ***********************
     #if defined(NORMALMAP) && !defined(VERTEX_LIGHTING)
       vec4 normalHeight = texture2D(m_NormalMap, newTexCoord);
-      vec3 normal = normalize((normalHeight.xyz * vec3(2.0) - vec3(1.0)));
+      //Note the -2.0 and -1.0. We invert the green channel of the normal map, 
+      //as it's complient with normal maps generated with blender.
+      //see http://hub.jmonkeyengine.org/forum/topic/parallax-mapping-fundamental-bug/#post-256898
+      //for more explanation.
+      vec3 normal = normalize((normalHeight.xyz * vec3(2.0,-2.0,2.0) - vec3(1.0,-1.0,1.0)));
       #ifdef LATC
         normal.z = sqrt(1.0 - (normal.x * normal.x) - (normal.y * normal.y));
-      #endif
-      //normal.y = -normal.y;
+      #endif      
     #elif !defined(VERTEX_LIGHTING)
       vec3 normal = vNormal;
       #if !defined(LOW_QUALITY) && !defined(V_TANGENT)

engine/src/core-data/Common/MatDefs/Light/Lighting.vert

@@ -171,7 +171,7 @@ void main(){
      vec3 wvTangent = normalize(g_NormalMatrix * modelSpaceTan);
      vec3 wvBinormal = cross(wvNormal, wvTangent);
 
-     mat3 tbnMat = mat3(wvTangent, wvBinormal * -inTangent.w,wvNormal);
+     mat3 tbnMat = mat3(wvTangent, wvBinormal * inTangent.w,wvNormal);
      
      //vPosition = wvPosition * tbnMat;
      //vViewDir  = viewDir * tbnMat;

engine/src/core-data/Common/MatDefs/Shadow/PostShadowFilter.frag

@@ -35,6 +35,10 @@ vec3 getPosition(in float depth, in vec2 uv){
 }
 
 void main(){    
+    #if !defined( RENDER_SHADOWS )
+          gl_FragColor = texture2D(m_Texture,texCoord);
+          return;
+    #endif
     
     float depth = texture2D(m_DepthTexture,texCoord).r;
     vec4 color = texture2D(m_Texture,texCoord);

engine/src/core-data/Common/MatDefs/Shadow/PostShadowFilter.j3md

@@ -57,6 +57,9 @@ MaterialDef Post Shadow {
             FADE : FadeInfo
             PSSM : Splits
             POINTLIGHT : LightViewProjectionMatrix5
+            //if no shadow map don't render shadows
+            RENDER_SHADOWS : ShadowMap0
+
         }
       
     }

engine/src/core-data/Common/MatDefs/Shadow/PostShadowFilter15.frag

@@ -87,6 +87,11 @@ vec4 main_multiSample(in int numSample){
 
 void main(){  
 
+    #if !defined( RENDER_SHADOWS )
+          outFragColor = fetchTextureSample(m_Texture,texCoord,0);
+          return;
+    #endif
+    
     #ifdef RESOLVE_MS
         vec4 color = vec4(0.0);
         for (int i = 0; i < m_NumSamples; i++){

engine/src/core-data/Common/ShaderLib/MultiSample.glsllib

@@ -46,17 +46,17 @@ vec4 getDepth(in sampler2DMS tex,in vec2 texC){
 #endif
 
 vec4 fetchTextureSample(in sampler2D tex,in vec2 texC,in int sample){
-    return texture2D(tex,texC);
+    return texture(tex,texC);
 }
 
 vec4 getColor(in sampler2D tex, in vec2 texC){
-    return texture2D(tex,texC);
+    return texture(tex,texC);
 }
 
 vec4 getColorSingle(in sampler2D tex, in vec2 texC){
-    return texture2D(tex, texC);
+    return texture(tex, texC);
 }
 
 vec4 getDepth(in sampler2D tex,in vec2 texC){
-    return texture2D(tex,texC);
+    return texture(tex,texC);
 }

engine/src/core-effects/com/jme3/post/filters/BloomFilter.java

@@ -1,314 +1,329 @@
-/*
- * Copyright (c) 2009-2012 jMonkeyEngine
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are
- * met:
- *
- * * Redistributions of source code must retain the above copyright
- *   notice, this list of conditions and the following disclaimer.
- *
- * * Redistributions in binary form must reproduce the above copyright
- *   notice, this list of conditions and the following disclaimer in the
- *   documentation and/or other materials provided with the distribution.
- *
- * * Neither the name of 'jMonkeyEngine' nor the names of its contributors
- *   may be used to endorse or promote products derived from this software
- *   without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
- * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
- * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
- * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
- * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
- * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
- * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
- * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
- * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-package com.jme3.post.filters;
-
-import com.jme3.asset.AssetManager;
-import com.jme3.export.InputCapsule;
-import com.jme3.export.JmeExporter;
-import com.jme3.export.JmeImporter;
-import com.jme3.export.OutputCapsule;
-import com.jme3.material.Material;
-import com.jme3.math.ColorRGBA;
-import com.jme3.post.Filter;
-import com.jme3.renderer.RenderManager;
-import com.jme3.renderer.ViewPort;
-import com.jme3.renderer.queue.RenderQueue;
-import com.jme3.texture.Image.Format;
-import java.io.IOException;
-import java.util.ArrayList;
-
-/**
- * BloomFilter is used to make objects in the scene have a glow effect.<br>
- * There are 2 mode : Scene and Objects.<br>
- * Scene mode extracts the bright parts of the scene to make them glow<br>
- * Object mode make objects glow according to their material's glowMap or their GlowColor<br>
- * @see <a href="http://jmonkeyengine.org/wiki/doku.php/jme3:advanced:bloom_and_glow">advanced:bloom_and_glow</a> for more details
- * 
- * @author Rémy Bouquet aka Nehon
- */
-public class BloomFilter extends Filter {
-
-    /**
-     * GlowMode specifies if the glow will be applied to the whole scene,or to objects that have aglow color or a glow map
-     */
-    public enum GlowMode {
-
-        /**
-         * Apply bloom filter to bright areas in the scene.
-         */
-        Scene,
-        /**
-         * Apply bloom only to objects that have a glow map or a glow color.
-         */
-        Objects,
-        /**
-         * Apply bloom to both bright parts of the scene and objects with glow map.
-         */
-        SceneAndObjects;
-    }
-
-    private GlowMode glowMode = GlowMode.Scene;
-    //Bloom parameters
-    private float blurScale = 1.5f;
-    private float exposurePower = 5.0f;
-    private float exposureCutOff = 0.0f;
-    private float bloomIntensity = 2.0f;
-    private float downSamplingFactor = 1;
-    private Pass preGlowPass;
-    private Pass extractPass;
-    private Pass horizontalBlur = new Pass();
-    private Pass verticalalBlur = new Pass();
-    private Material extractMat;
-    private Material vBlurMat;
-    private Material hBlurMat;
-    private int screenWidth;
-    private int screenHeight;    
-    private RenderManager renderManager;
-    private ViewPort viewPort;
-
-    /**
-     * Creates a Bloom filter
-     */
-    public BloomFilter() {
-        super("BloomFilter");
-    }
-
-    /**
-     * Creates the bloom filter with the specific glow mode
-     * @param glowMode
-     */
-    public BloomFilter(GlowMode glowMode) {
-        this();
-        this.glowMode = glowMode;
-    }
-
-    @Override
-    protected void initFilter(AssetManager manager, RenderManager renderManager, ViewPort vp, int w, int h) {
-             this.renderManager = renderManager;
-        this.viewPort = vp;
-        screenWidth = (int) Math.max(1, (w / downSamplingFactor));
-        screenHeight = (int) Math.max(1, (h / downSamplingFactor));
-        //    System.out.println(screenWidth + " " + screenHeight);
-        if (glowMode != GlowMode.Scene) {
-            preGlowPass = new Pass();
-            preGlowPass.init(renderManager.getRenderer(), screenWidth, screenHeight, Format.RGBA8, Format.Depth);
-        }
-
-        postRenderPasses = new ArrayList<Pass>();
-        //configuring extractPass
-        extractMat = new Material(manager, "Common/MatDefs/Post/BloomExtract.j3md");
-        extractPass = new Pass() {
-
-            @Override
-            public boolean requiresSceneAsTexture() {
-                return true;
-            }
-
-            @Override
-            public void beforeRender() {
-                extractMat.setFloat("ExposurePow", exposurePower);
-                extractMat.setFloat("ExposureCutoff", exposureCutOff);
-                if (glowMode != GlowMode.Scene) {
-                    extractMat.setTexture("GlowMap", preGlowPass.getRenderedTexture());
-                }
-                extractMat.setBoolean("Extract", glowMode != GlowMode.Objects);
-            }
-        };
-
-        extractPass.init(renderManager.getRenderer(), screenWidth, screenHeight, Format.RGBA8, Format.Depth, 1, extractMat);
-        postRenderPasses.add(extractPass);
-
-        //configuring horizontal blur pass
-        hBlurMat = new Material(manager, "Common/MatDefs/Blur/HGaussianBlur.j3md");
-        horizontalBlur = new Pass() {
-
-            @Override
-            public void beforeRender() {
-                hBlurMat.setTexture("Texture", extractPass.getRenderedTexture());
-                hBlurMat.setFloat("Size", screenWidth);
-                hBlurMat.setFloat("Scale", blurScale);
-            }
-        };
-
-        horizontalBlur.init(renderManager.getRenderer(), screenWidth, screenHeight, Format.RGBA8, Format.Depth, 1, hBlurMat);
-        postRenderPasses.add(horizontalBlur);
-
-        //configuring vertical blur pass
-        vBlurMat = new Material(manager, "Common/MatDefs/Blur/VGaussianBlur.j3md");
-        verticalalBlur = new Pass() {
-
-            @Override
-            public void beforeRender() {
-                vBlurMat.setTexture("Texture", horizontalBlur.getRenderedTexture());
-                vBlurMat.setFloat("Size", screenHeight);
-                vBlurMat.setFloat("Scale", blurScale);
-            }
-        };
-
-        verticalalBlur.init(renderManager.getRenderer(), screenWidth, screenHeight, Format.RGBA8, Format.Depth, 1, vBlurMat);
-        postRenderPasses.add(verticalalBlur);
-
-
-        //final material
-        material = new Material(manager, "Common/MatDefs/Post/BloomFinal.j3md");
-        material.setTexture("BloomTex", verticalalBlur.getRenderedTexture());
-    }
-
-
-    @Override
-    protected Material getMaterial() {
-        material.setFloat("BloomIntensity", bloomIntensity);
-        return material;
-    }
-
-    @Override
-    protected void postQueue(RenderQueue queue) {
-        if (glowMode != GlowMode.Scene) {           
-            renderManager.getRenderer().setBackgroundColor(ColorRGBA.BlackNoAlpha);            
-            renderManager.getRenderer().setFrameBuffer(preGlowPass.getRenderFrameBuffer());
-            renderManager.getRenderer().clearBuffers(true, true, true);
-            renderManager.setForcedTechnique("Glow");
-            renderManager.renderViewPortQueues(viewPort, false);         
-            renderManager.setForcedTechnique(null);
-            renderManager.getRenderer().setFrameBuffer(viewPort.getOutputFrameBuffer());
-        }
-    }
-
-    /**
-     * returns the bloom intensity
-     * @return 
-     */
-    public float getBloomIntensity() {
-        return bloomIntensity;
-    }
-
-    /**
-     * intensity of the bloom effect default is 2.0
-     * @param bloomIntensity
-     */
-    public void setBloomIntensity(float bloomIntensity) {
-        this.bloomIntensity = bloomIntensity;
-    }
-
-    /**
-     * returns the blur scale
-     * @return 
-     */
-    public float getBlurScale() {
-        return blurScale;
-    }
-
-    /**
-     * sets The spread of the bloom default is 1.5f
-     * @param blurScale
-     */
-    public void setBlurScale(float blurScale) {
-        this.blurScale = blurScale;
-    }
-
-    /**
-     * returns the exposure cutoff<br>
-     * for more details see {@link #setExposureCutOff(float exposureCutOff)}
-     * @return 
-     */    
-    public float getExposureCutOff() {
-        return exposureCutOff;
-    }
-
-    /**
-     * Define the color threshold on which the bloom will be applied (0.0 to 1.0)
-     * @param exposureCutOff
-     */
-    public void setExposureCutOff(float exposureCutOff) {
-        this.exposureCutOff = exposureCutOff;
-    }
-
-    /**
-     * returns the exposure power<br>
-     * form more details see {@link #setExposurePower(float exposurePower)}
-     * @return 
-     */
-    public float getExposurePower() {
-        return exposurePower;
-    }
-
-    /**
-     * defines how many time the bloom extracted color will be multiplied by itself. default id 5.0<br>
-     * a high value will reduce rough edges in the bloom and somhow the range of the bloom area     * 
-     * @param exposurePower
-     */
-    public void setExposurePower(float exposurePower) {
-        this.exposurePower = exposurePower;
-    }
-
-    /**
-     * returns the downSampling factor<br>
-     * form more details see {@link #setDownSamplingFactor(float downSamplingFactor)}
-     * @return
-     */
-    public float getDownSamplingFactor() {
-        return downSamplingFactor;
-    }
-
-    /**
-     * Sets the downSampling factor : the size of the computed texture will be divided by this factor. default is 1 for no downsampling
-     * A 2 value is a good way of widening the blur
-     * @param downSamplingFactor
-     */
-    public void setDownSamplingFactor(float downSamplingFactor) {
-        this.downSamplingFactor = downSamplingFactor;
-    }
-
-    @Override
-    public void write(JmeExporter ex) throws IOException {
-        super.write(ex);
-        OutputCapsule oc = ex.getCapsule(this);
-        oc.write(glowMode, "glowMode", GlowMode.Scene);
-        oc.write(blurScale, "blurScale", 1.5f);
-        oc.write(exposurePower, "exposurePower", 5.0f);
-        oc.write(exposureCutOff, "exposureCutOff", 0.0f);
-        oc.write(bloomIntensity, "bloomIntensity", 2.0f);
-        oc.write(downSamplingFactor, "downSamplingFactor", 1);
-    }
-
-    @Override
-    public void read(JmeImporter im) throws IOException {
-        super.read(im);
-        InputCapsule ic = im.getCapsule(this);
-        glowMode = ic.readEnum("glowMode", GlowMode.class, GlowMode.Scene);
-        blurScale = ic.readFloat("blurScale", 1.5f);
-        exposurePower = ic.readFloat("exposurePower", 5.0f);
-        exposureCutOff = ic.readFloat("exposureCutOff", 0.0f);
-        bloomIntensity = ic.readFloat("bloomIntensity", 2.0f);
-        downSamplingFactor = ic.readFloat("downSamplingFactor", 1);
-    }
-}
+/*
+ * Copyright (c) 2009-2012 jMonkeyEngine
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ * * Redistributions of source code must retain the above copyright
+ *   notice, this list of conditions and the following disclaimer.
+ *
+ * * Redistributions in binary form must reproduce the above copyright
+ *   notice, this list of conditions and the following disclaimer in the
+ *   documentation and/or other materials provided with the distribution.
+ *
+ * * Neither the name of 'jMonkeyEngine' nor the names of its contributors
+ *   may be used to endorse or promote products derived from this software
+ *   without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+ * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+ * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+ * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+ * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+ * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+ * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+ * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+package com.jme3.post.filters;
+
+import com.jme3.asset.AssetManager;
+import com.jme3.export.InputCapsule;
+import com.jme3.export.JmeExporter;
+import com.jme3.export.JmeImporter;
+import com.jme3.export.OutputCapsule;
+import com.jme3.material.Material;
+import com.jme3.math.ColorRGBA;
+import com.jme3.post.Filter;
+import com.jme3.renderer.RenderManager;
+import com.jme3.renderer.ViewPort;
+import com.jme3.renderer.queue.RenderQueue;
+import com.jme3.texture.Image.Format;
+import java.io.IOException;
+import java.util.ArrayList;
+
+/**
+ * BloomFilter is used to make objects in the scene have a glow effect.<br>
+ * There are 2 mode : Scene and Objects.<br>
+ * Scene mode extracts the bright parts of the scene to make them glow<br>
+ * Object mode make objects glow according to their material's glowMap or their GlowColor<br>
+ * @see <a href="http://jmonkeyengine.org/wiki/doku.php/jme3:advanced:bloom_and_glow">advanced:bloom_and_glow</a> for more details
+ * 
+ * @author Rémy Bouquet aka Nehon
+ */
+public class BloomFilter extends Filter {
+
+    /**
+     * GlowMode specifies if the glow will be applied to the whole scene,or to objects that have aglow color or a glow map
+     */
+    public enum GlowMode {
+
+        /**
+         * Apply bloom filter to bright areas in the scene.
+         */
+        Scene,
+        /**
+         * Apply bloom only to objects that have a glow map or a glow color.
+         */
+        Objects,
+        /**
+         * Apply bloom to both bright parts of the scene and objects with glow map.
+         */
+        SceneAndObjects;
+    }
+
+    private GlowMode glowMode = GlowMode.Scene;
+    //Bloom parameters
+    private float blurScale = 1.5f;
+    private float exposurePower = 5.0f;
+    private float exposureCutOff = 0.0f;
+    private float bloomIntensity = 2.0f;
+    private float downSamplingFactor = 1;
+    private Pass preGlowPass;
+    private Pass extractPass;
+    private Pass horizontalBlur = new Pass();
+    private Pass verticalalBlur = new Pass();
+    private Material extractMat;
+    private Material vBlurMat;
+    private Material hBlurMat;
+    private int screenWidth;
+    private int screenHeight;    
+    private RenderManager renderManager;
+    private ViewPort viewPort;
+
+    private AssetManager assetManager;
+    private int initalWidth;
+    private int initalHeight;
+    
+    /**
+     * Creates a Bloom filter
+     */
+    public BloomFilter() {
+        super("BloomFilter");
+    }
+
+    /**
+     * Creates the bloom filter with the specific glow mode
+     * @param glowMode
+     */
+    public BloomFilter(GlowMode glowMode) {
+        this();
+        this.glowMode = glowMode;
+    }
+
+    @Override
+    protected void initFilter(AssetManager manager, RenderManager renderManager, ViewPort vp, int w, int h) {
+             this.renderManager = renderManager;
+        this.viewPort = vp;
+
+        this.assetManager = manager;
+        this.initalWidth = w;
+        this.initalHeight = h;
+                
+        screenWidth = (int) Math.max(1, (w / downSamplingFactor));
+        screenHeight = (int) Math.max(1, (h / downSamplingFactor));
+        //    System.out.println(screenWidth + " " + screenHeight);
+        if (glowMode != GlowMode.Scene) {
+            preGlowPass = new Pass();
+            preGlowPass.init(renderManager.getRenderer(), screenWidth, screenHeight, Format.RGBA8, Format.Depth);
+        }
+
+        postRenderPasses = new ArrayList<Pass>();
+        //configuring extractPass
+        extractMat = new Material(manager, "Common/MatDefs/Post/BloomExtract.j3md");
+        extractPass = new Pass() {
+
+            @Override
+            public boolean requiresSceneAsTexture() {
+                return true;
+            }
+
+            @Override
+            public void beforeRender() {
+                extractMat.setFloat("ExposurePow", exposurePower);
+                extractMat.setFloat("ExposureCutoff", exposureCutOff);
+                if (glowMode != GlowMode.Scene) {
+                    extractMat.setTexture("GlowMap", preGlowPass.getRenderedTexture());
+                }
+                extractMat.setBoolean("Extract", glowMode != GlowMode.Objects);
+            }
+        };
+
+        extractPass.init(renderManager.getRenderer(), screenWidth, screenHeight, Format.RGBA8, Format.Depth, 1, extractMat);
+        postRenderPasses.add(extractPass);
+
+        //configuring horizontal blur pass
+        hBlurMat = new Material(manager, "Common/MatDefs/Blur/HGaussianBlur.j3md");
+        horizontalBlur = new Pass() {
+
+            @Override
+            public void beforeRender() {
+                hBlurMat.setTexture("Texture", extractPass.getRenderedTexture());
+                hBlurMat.setFloat("Size", screenWidth);
+                hBlurMat.setFloat("Scale", blurScale);
+            }
+        };
+
+        horizontalBlur.init(renderManager.getRenderer(), screenWidth, screenHeight, Format.RGBA8, Format.Depth, 1, hBlurMat);
+        postRenderPasses.add(horizontalBlur);
+
+        //configuring vertical blur pass
+        vBlurMat = new Material(manager, "Common/MatDefs/Blur/VGaussianBlur.j3md");
+        verticalalBlur = new Pass() {
+
+            @Override
+            public void beforeRender() {
+                vBlurMat.setTexture("Texture", horizontalBlur.getRenderedTexture());
+                vBlurMat.setFloat("Size", screenHeight);
+                vBlurMat.setFloat("Scale", blurScale);
+            }
+        };
+
+        verticalalBlur.init(renderManager.getRenderer(), screenWidth, screenHeight, Format.RGBA8, Format.Depth, 1, vBlurMat);
+        postRenderPasses.add(verticalalBlur);
+
+
+        //final material
+        material = new Material(manager, "Common/MatDefs/Post/BloomFinal.j3md");
+        material.setTexture("BloomTex", verticalalBlur.getRenderedTexture());
+    }
+
+
+    protected void reInitFilter() {
+        initFilter(assetManager, renderManager, viewPort, initalWidth, initalHeight);
+    }
+    
+    @Override
+    protected Material getMaterial() {
+        material.setFloat("BloomIntensity", bloomIntensity);
+        return material;
+    }
+
+    @Override
+    protected void postQueue(RenderQueue queue) {
+        if (glowMode != GlowMode.Scene) {           
+            renderManager.getRenderer().setBackgroundColor(ColorRGBA.BlackNoAlpha);            
+            renderManager.getRenderer().setFrameBuffer(preGlowPass.getRenderFrameBuffer());
+            renderManager.getRenderer().clearBuffers(true, true, true);
+            renderManager.setForcedTechnique("Glow");
+            renderManager.renderViewPortQueues(viewPort, false);         
+            renderManager.setForcedTechnique(null);
+            renderManager.getRenderer().setFrameBuffer(viewPort.getOutputFrameBuffer());
+        }
+    }
+
+    /**
+     * returns the bloom intensity
+     * @return 
+     */
+    public float getBloomIntensity() {
+        return bloomIntensity;
+    }
+
+    /**
+     * intensity of the bloom effect default is 2.0
+     * @param bloomIntensity
+     */
+    public void setBloomIntensity(float bloomIntensity) {
+        this.bloomIntensity = bloomIntensity;
+    }
+
+    /**
+     * returns the blur scale
+     * @return 
+     */
+    public float getBlurScale() {
+        return blurScale;
+    }
+
+    /**
+     * sets The spread of the bloom default is 1.5f
+     * @param blurScale
+     */
+    public void setBlurScale(float blurScale) {
+        this.blurScale = blurScale;
+    }
+
+    /**
+     * returns the exposure cutoff<br>
+     * for more details see {@link #setExposureCutOff(float exposureCutOff)}
+     * @return 
+     */    
+    public float getExposureCutOff() {
+        return exposureCutOff;
+    }
+
+    /**
+     * Define the color threshold on which the bloom will be applied (0.0 to 1.0)
+     * @param exposureCutOff
+     */
+    public void setExposureCutOff(float exposureCutOff) {
+        this.exposureCutOff = exposureCutOff;
+    }
+
+    /**
+     * returns the exposure power<br>
+     * form more details see {@link #setExposurePower(float exposurePower)}
+     * @return 
+     */
+    public float getExposurePower() {
+        return exposurePower;
+    }
+
+    /**
+     * defines how many time the bloom extracted color will be multiplied by itself. default id 5.0<br>
+     * a high value will reduce rough edges in the bloom and somhow the range of the bloom area     * 
+     * @param exposurePower
+     */
+    public void setExposurePower(float exposurePower) {
+        this.exposurePower = exposurePower;
+    }
+
+    /**
+     * returns the downSampling factor<br>
+     * form more details see {@link #setDownSamplingFactor(float downSamplingFactor)}
+     * @return
+     */
+    public float getDownSamplingFactor() {
+        return downSamplingFactor;
+    }
+
+    /**
+     * Sets the downSampling factor : the size of the computed texture will be divided by this factor. default is 1 for no downsampling
+     * A 2 value is a good way of widening the blur
+     * @param downSamplingFactor
+     */
+    public void setDownSamplingFactor(float downSamplingFactor) {
+        this.downSamplingFactor = downSamplingFactor;
+        if (assetManager != null) // dirty isInitialised check
+            reInitFilter();
+    }
+
+    @Override
+    public void write(JmeExporter ex) throws IOException {
+        super.write(ex);
+        OutputCapsule oc = ex.getCapsule(this);
+        oc.write(glowMode, "glowMode", GlowMode.Scene);
+        oc.write(blurScale, "blurScale", 1.5f);
+        oc.write(exposurePower, "exposurePower", 5.0f);
+        oc.write(exposureCutOff, "exposureCutOff", 0.0f);
+        oc.write(bloomIntensity, "bloomIntensity", 2.0f);
+        oc.write(downSamplingFactor, "downSamplingFactor", 1);
+    }
+
+    @Override
+    public void read(JmeImporter im) throws IOException {
+        super.read(im);
+        InputCapsule ic = im.getCapsule(this);
+        glowMode = ic.readEnum("glowMode", GlowMode.class, GlowMode.Scene);
+        blurScale = ic.readFloat("blurScale", 1.5f);
+        exposurePower = ic.readFloat("exposurePower", 5.0f);
+        exposureCutOff = ic.readFloat("exposureCutOff", 0.0f);
+        bloomIntensity = ic.readFloat("bloomIntensity", 2.0f);
+        downSamplingFactor = ic.readFloat("downSamplingFactor", 1);
+    }
+}

engine/src/core-effects/com/jme3/post/filters/LightScatteringFilter.java

@@ -37,6 +37,7 @@ import com.jme3.export.JmeExporter;
 import com.jme3.export.JmeImporter;
 import com.jme3.export.OutputCapsule;
 import com.jme3.material.Material;
+import com.jme3.math.FastMath;
 import com.jme3.math.Vector3f;
 import com.jme3.post.Filter;
 import com.jme3.renderer.Camera;
@@ -102,7 +103,9 @@ public class LightScatteringFilter extends Filter {
         getClipCoordinates(lightPosition, screenLightPos, viewPort.getCamera());
         viewPort.getCamera().getViewMatrix().mult(lightPosition, viewLightPos);        
         if (adaptative) {
-            innerLightDensity = Math.max(lightDensity - Math.max(screenLightPos.x, screenLightPos.y), 0.0f);
+            float densityX = 1f - FastMath.clamp(FastMath.abs(screenLightPos.x - 0.5f), 0, 1);
+            float densityY = 1f - FastMath.clamp(FastMath.abs(screenLightPos.y - 0.5f), 0, 1);
+            innerLightDensity = lightDensity * densityX * densityY;
         } else {
             innerLightDensity = lightDensity;
         }

engine/src/core-effects/com/jme3/water/SimpleWaterProcessor.java

@@ -48,6 +48,7 @@ import com.jme3.texture.Image.Format;
 import com.jme3.texture.Texture.WrapMode;
 import com.jme3.texture.Texture2D;
 import com.jme3.ui.Picture;
+import com.jme3.util.TempVars;
 
 /**
  *
@@ -119,15 +120,12 @@ public class SimpleWaterProcessor implements SceneProcessor {
     private Plane reflectionClipPlane;
     private Plane refractionClipPlane;
     private float refractionClippingOffset = 0.3f;
-    private float reflectionClippingOffset = -5f;
-    private Vector3f vect1 = new Vector3f();
-    private Vector3f vect2 = new Vector3f();
-    private Vector3f vect3 = new Vector3f();
+    private float reflectionClippingOffset = -5f;        
     private float distortionScale = 0.2f;
     private float distortionMix = 0.5f;
     private float texScale = 1f;
     
-
+       
     /**
      * Creates a SimpleWaterProcessor
      * @param manager the asset manager
@@ -190,10 +188,6 @@ public class SimpleWaterProcessor implements SceneProcessor {
     public void postQueue(RenderQueue rq) {
         Camera sceneCam = rm.getCurrentCamera();
 
-        //update ray
-        ray.setOrigin(sceneCam.getLocation());
-        ray.setDirection(sceneCam.getDirection());
-
         //update refraction cam
         refractionCam.setLocation(sceneCam.getLocation());
         refractionCam.setRotation(sceneCam.getRotation());
@@ -203,40 +197,11 @@ public class SimpleWaterProcessor implements SceneProcessor {
                 sceneCam.getFrustumRight(),
                 sceneCam.getFrustumTop(),
                 sceneCam.getFrustumBottom());
-        refractionCam.setParallelProjection(false);
+        refractionCam.setParallelProjection(sceneCam.isParallelProjection());
 
         //update reflection cam
-        boolean inv = false;
-        if (!ray.intersectsWherePlane(plane, targetLocation)) {
-            ray.setDirection(ray.getDirection().negateLocal());
-            ray.intersectsWherePlane(plane, targetLocation);
-            inv = true;
-        }
-        Vector3f loc = plane.reflect(sceneCam.getLocation(), new Vector3f());
-        reflectionCam.setLocation(loc);
-        reflectionCam.setFrustum(sceneCam.getFrustumNear(),
-                sceneCam.getFrustumFar(),
-                sceneCam.getFrustumLeft(),
-                sceneCam.getFrustumRight(),
-                sceneCam.getFrustumTop(),
-                sceneCam.getFrustumBottom());
-        reflectionCam.setParallelProjection(false);
-        // tempVec and calcVect are just temporary vector3f objects
-        vect1.set(sceneCam.getLocation()).addLocal(sceneCam.getUp());
-        float planeDistance = plane.pseudoDistance(vect1);
-        vect2.set(plane.getNormal()).multLocal(planeDistance * 2.0f);
-        vect3.set(vect1.subtractLocal(vect2)).subtractLocal(loc).normalizeLocal().negateLocal();
-        // now set the up vector
-        reflectionCam.lookAt(targetLocation, vect3);
-        if (inv) {
-            reflectionCam.setAxes(reflectionCam.getLeft().negateLocal(), reflectionCam.getUp(), reflectionCam.getDirection().negateLocal());
-        }
-
-        //we are rendering a sub part of the scene so the camera planeState may never be reseted to 0.
-//        reflectionCam.setPlaneState(0);
-//        refractionCam.setPlaneState(0);
-
-
+        WaterUtils.updateReflectionCam(reflectionCam, plane, sceneCam);
+        
         //Rendering reflection and refraction
         rm.renderViewPort(reflectionView, savedTpf);
         rm.renderViewPort(refractionView, savedTpf);

engine/src/core-effects/com/jme3/water/WaterFilter.java

@@ -155,40 +155,11 @@ public class WaterFilter extends Filter {
 
         material.setFloat("WaterHeight", waterHeight);
 
-        //update reflection cam
-        ray.setOrigin(sceneCam.getLocation());
-        ray.setDirection(sceneCam.getDirection());
+        //update reflection cam      
         plane = new Plane(Vector3f.UNIT_Y, new Vector3f(0, waterHeight, 0).dot(Vector3f.UNIT_Y));
-        reflectionProcessor.setReflectionClipPlane(plane);
-        boolean inv = false;
-        if (!ray.intersectsWherePlane(plane, targetLocation)) {
-            ray.setDirection(ray.getDirection().negateLocal());
-            ray.intersectsWherePlane(plane, targetLocation);
-            inv = true;
-        }
-        Vector3f loc = plane.reflect(sceneCam.getLocation(), new Vector3f());
-        reflectionCam.setLocation(loc);
-        reflectionCam.setFrustum(sceneCam.getFrustumNear(),
-                sceneCam.getFrustumFar(),
-                sceneCam.getFrustumLeft(),
-                sceneCam.getFrustumRight(),
-                sceneCam.getFrustumTop(),
-                sceneCam.getFrustumBottom());
-        reflectionCam.setParallelProjection(false);
-        TempVars vars = TempVars.get();
-
-
-        vars.vect1.set(sceneCam.getLocation()).addLocal(sceneCam.getUp());
-        float planeDistance = plane.pseudoDistance(vars.vect1);
-        vars.vect2.set(plane.getNormal()).multLocal(planeDistance * 2.0f);
-        vars.vect3.set(vars.vect1.subtractLocal(vars.vect2)).subtractLocal(loc).normalizeLocal().negateLocal();
-
-        reflectionCam.lookAt(targetLocation, vars.vect3);
-        vars.release();
-
-        if (inv) {
-            reflectionCam.setAxes(reflectionCam.getLeft().negateLocal(), reflectionCam.getUp(), reflectionCam.getDirection().negateLocal());
-        }
+        reflectionProcessor.setReflectionClipPlane(plane);        
+        WaterUtils.updateReflectionCam(reflectionCam, plane, sceneCam);
+      
 
         //if we're under water no need to compute reflection
         if (sceneCam.getLocation().y >= waterHeight) {
@@ -1026,7 +997,7 @@ public class WaterFilter extends Filter {
     public void setReflectionDisplace(float reflectionDisplace) {
         this.reflectionDisplace = reflectionDisplace;
         if (material != null) {
-            material.setFloat("m_ReflectionDisplace", reflectionDisplace);
+            material.setFloat("ReflectionDisplace", reflectionDisplace);
         }
     }
 

engine/src/core-effects/com/jme3/water/WaterUtils.java

@@ -0,0 +1,53 @@
+/*
+ * To change this template, choose Tools | Templates
+ * and open the template in the editor.
+ */
+package com.jme3.water;
+
+import com.jme3.math.Plane;
+import com.jme3.math.Vector3f;
+import com.jme3.renderer.Camera;
+import com.jme3.util.TempVars;
+
+/**
+ *
+ * @author Nehon
+ */
+public class WaterUtils {
+    
+    public static void updateReflectionCam(Camera reflectionCam, Plane plane, Camera sceneCam){
+        
+        TempVars vars = TempVars.get();
+         //Temp vects for reflection cam orientation calculation
+        Vector3f sceneTarget =  vars.vect1;
+        Vector3f  reflectDirection =  vars.vect2;
+        Vector3f  reflectUp =  vars.vect3;
+        Vector3f  reflectLeft = vars.vect4;
+        Vector3f  camLoc = vars.vect5;
+        camLoc = plane.reflect(sceneCam.getLocation(), camLoc);
+        reflectionCam.setLocation(camLoc);
+        reflectionCam.setFrustum(sceneCam.getFrustumNear(),
+                sceneCam.getFrustumFar(),
+                sceneCam.getFrustumLeft(),
+                sceneCam.getFrustumRight(),
+                sceneCam.getFrustumTop(),
+                sceneCam.getFrustumBottom());
+        reflectionCam.setParallelProjection(sceneCam.isParallelProjection());
+
+        sceneTarget.set(sceneCam.getLocation()).addLocal(sceneCam.getDirection());
+        reflectDirection = plane.reflect(sceneTarget, reflectDirection);
+        reflectDirection.subtractLocal(camLoc);
+
+        sceneTarget.set(sceneCam.getLocation()).subtractLocal(sceneCam.getUp());
+        reflectUp = plane.reflect(sceneTarget, reflectUp);
+        reflectUp.subtractLocal(camLoc);
+
+        sceneTarget.set(sceneCam.getLocation()).addLocal(sceneCam.getLeft());
+        reflectLeft = plane.reflect(sceneTarget, reflectLeft);
+        reflectLeft.subtractLocal(camLoc);
+
+        reflectionCam.setAxes(reflectLeft, reflectUp, reflectDirection);
+
+        vars.release();
+    }
+}

engine/src/core-plugins/com/jme3/export/binary/BinaryExporter.java

@@ -327,14 +327,18 @@ public class BinaryExporter implements JmeExporter {
 
     public boolean save(Savable object, File f) throws IOException {
         File parentDirectory = f.getParentFile();
-        if(parentDirectory != null && !parentDirectory.exists()) {
+        if (parentDirectory != null && !parentDirectory.exists()) {
             parentDirectory.mkdirs();
         }
 
         FileOutputStream fos = new FileOutputStream(f);
-        boolean rVal = save(object, fos);
-        fos.close();
-        return rVal;
+        try {
+            return save(object, fos);
+        } finally {
+            if (fos != null) {
+                fos.close();
+            }
+        }
     }
 
     public BinaryOutputCapsule getCapsule(Savable object) {

engine/src/core-plugins/com/jme3/export/binary/BinaryImporter.java

@@ -267,9 +267,13 @@ public final class BinaryImporter implements JmeImporter {
 
     public Savable load(File f, ReadListener listener) throws IOException {
         FileInputStream fis = new FileInputStream(f);
-        Savable rVal = load(fis, listener);
-        fis.close();
-        return rVal;
+        try {
+            return load(fis, listener);
+        } finally {
+            if (fis != null) {
+                fis.close();
+            }
+        }
     }
 
     public Savable load(byte[] data) throws IOException {

engine/src/core/com/jme3/animation/AnimChannel.java

@@ -59,6 +59,7 @@ public final class AnimChannel {
     private float time;
     private float speed;
     private float timeBlendFrom;
+    private float blendTime;
     private float speedBlendFrom;
     private boolean notified=false;
 
@@ -192,6 +193,11 @@ public final class AnimChannel {
      */
     public void setSpeed(float speed) {
         this.speed = speed;
+        if(blendTime>0){
+            this.speedBlendFrom = speed;
+            blendTime = Math.min(blendTime, animation.getLength() / speed);  
+            blendRate = 1/ blendTime;
+        }
     }
 
     /**
@@ -248,7 +254,9 @@ public final class AnimChannel {
         control.notifyAnimChange(this, name);
 
         if (animation != null && blendTime > 0f){
+            this.blendTime = blendTime;
             // activate blending
+            blendTime = Math.min(blendTime, anim.getLength() / speed);            
             blendFrom = animation;
             timeBlendFrom = time;
             speedBlendFrom = speed;
@@ -393,8 +401,7 @@ public final class AnimChannel {
         }
         
         animation.setTime(time, blendAmount, control, this, vars);
-        time += tpf * speed;
-
+        
         if (animation.getLength() > 0){
             if (!notified && (time >= animation.getLength() || time < 0)) {
                 if (loopMode == LoopMode.DontLoop) {
@@ -406,7 +413,7 @@ public final class AnimChannel {
                 control.notifyAnimCycleDone(this, animation.getName());
             } 
         }
-
+        time += tpf * speed;      
         time = clampWrapTime(time, animation.getLength(), loopMode);
         if (time < 0){
             // Negative time indicates that speed should be inverted

engine/src/core/com/jme3/app/FlyCamAppState.java

@@ -87,7 +87,9 @@ public class FlyCamAppState extends AbstractAppState {
     public void cleanup() {
         super.cleanup();
 
-        flyCam.unregisterInput();        
+        if (app.getInputManager() != null) {        
+            flyCam.unregisterInput();
+        }        
     }
 
 

engine/src/core/com/jme3/app/StatsAppState.java

@@ -81,7 +81,7 @@ public class StatsAppState extends AbstractAppState {
      *  is because several applications expect to directly access
      *  fpsText... unfortunately.
      */
-    void setFont( BitmapFont guiFont ) {
+    public void setFont( BitmapFont guiFont ) {
         this.guiFont = guiFont;
         this.fpsText = new BitmapText(guiFont, false);
     }

engine/src/core/com/jme3/audio/AudioNode.java

@@ -45,15 +45,18 @@ import java.util.logging.Level;
 import java.util.logging.Logger;
 
 /**
- * An <code>AudioNode</code> is used in jME3 for playing audio files.
- * <br/>
- * First, an {@link AudioNode} is loaded from file, and then assigned
- * to an audio node for playback. Once the audio node is attached to the 
- * scene, its location will influence the position it is playing from relative
- * to the {@link Listener}.
- * <br/>
- * An audio node can also play in "headspace", meaning its location
- * or velocity does not influence how it is played. 
+ * An <code>AudioNode</code> is a scene Node which can play audio assets. 
+ * 
+ * An AudioNode is either positional or ambient, with positional being the 
+ * default. Once a positional node is attached to the scene, its location and 
+ * velocity relative to the {@link Listener} affect how it sounds when played. 
+ * Positional nodes can only play monoaural (single-channel) assets, not stereo 
+ * ones. 
+ * 
+ * An ambient AudioNode plays in "headspace", meaning that the node's location 
+ * and velocity do not affect how it sounds when played. Ambient audio nodes can 
+ * play stereo assets. 
+ * 
  * The "positional" property of an AudioNode can be set via 
  * {@link AudioNode#setPositional(boolean) }.
  * 

engine/src/core/com/jme3/bounding/BoundingBox.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2009-2012 jMonkeyEngine
+ * Copyright (c) 2009-2013 jMonkeyEngine
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -47,31 +47,40 @@ import java.nio.FloatBuffer;
 //import com.jme.scene.TriMesh;
 
 /**
- * <code>BoundingBox</code> defines an axis-aligned cube that defines a
- * container for a group of vertices of a particular piece of geometry. This box
- * defines a center and extents from that center along the x, y and z axis. <br>
+ * <code>BoundingBox</code> describes a bounding volume as an axis-aligned box.
  * <br>
- * A typical usage is to allow the class define the center and radius by calling
- * either <code>containAABB</code> or <code>averagePoints</code>. A call to
- * <code>computeFramePoint</code> in turn calls <code>containAABB</code>.
- * 
+ * Instances may be initialized by invoking the <code>containAABB</code> method.
+ *
  * @author Joshua Slack
  * @version $Id: BoundingBox.java,v 1.50 2007/09/22 16:46:35 irrisor Exp $
  */
 public class BoundingBox extends BoundingVolume {
-
-    float xExtent, yExtent, zExtent;
-
     /**
-     * Default constructor instantiates a new <code>BoundingBox</code>
-     * object.
+     * the X-extent of the box (>=0, may be +Infinity)
+     */
+    float xExtent;
+    /**
+     * the Y-extent of the box (>=0, may be +Infinity)
+     */
+    float yExtent;
+    /**
+     * the Z-extent of the box (>=0, may be +Infinity)
+     */
+    float zExtent;
+    
+    /**
+     * Instantiate a <code>BoundingBox</code> without initializing it.
      */
     public BoundingBox() {
     }
 
     /**
-     * Contstructor instantiates a new <code>BoundingBox</code> object with
-     * given specs.
+     * Instantiate a <code>BoundingBox</code> with given center and extents.
+     *
+     * @param c the coordinates of the center of the box (not null, not altered)
+     * @param x the X-extent of the box (>=0, may be +Infinity)
+     * @param y the Y-extent of the box (>=0, may be +Infinity)
+     * @param z the Z-extent of the box (>=0, may be +Infinity)
      */
     public BoundingBox(Vector3f c, float x, float y, float z) {
         this.center.set(c);
@@ -80,6 +89,11 @@ public class BoundingBox extends BoundingVolume {
         this.zExtent = z;
     }
 
+    /**
+     * Instantiate a <code>BoundingBox</code> equivalent to an existing box.
+     *
+     * @param source the existing box (not null, not altered)
+     */
     public BoundingBox(BoundingBox source) {
         this.center.set(source.center);
         this.xExtent = source.xExtent;
@@ -368,52 +382,28 @@ public class BoundingBox extends BoundingVolume {
     }
 
     /**
-     * <code>merge</code> combines this bounding box with a second bounding box.
-     * This new box contains both bounding box and is returned.
-     * 
-     * @param volume
-     *            the bounding box to combine with this bounding box.
-     * @return the new bounding box
+     * <code>merge</code> combines this bounding box locally with a second
+     * bounding volume. The result contains both the original box and the second
+     * volume.
+     *
+     * @param volume the bounding volume to combine with this box (or null) (not
+     * altered)
+     * @return this box (with its components modified) or null if the second
+     * volume is of some type other than AABB or Sphere
      */
     public BoundingVolume merge(BoundingVolume volume) {
-        if (volume == null) {
-            return this;
-        }
-
-        switch (volume.getType()) {
-            case AABB: {
-                BoundingBox vBox = (BoundingBox) volume;
-                return merge(vBox.center, vBox.xExtent, vBox.yExtent,
-                        vBox.zExtent, new BoundingBox(new Vector3f(0, 0, 0), 0,
-                        0, 0));
-            }
-
-            case Sphere: {
-                BoundingSphere vSphere = (BoundingSphere) volume;
-                return merge(vSphere.center, vSphere.radius, vSphere.radius,
-                        vSphere.radius, new BoundingBox(new Vector3f(0, 0, 0),
-                        0, 0, 0));
-            }
-
-//            case OBB: {
-//                OrientedBoundingBox box = (OrientedBoundingBox) volume;
-//                BoundingBox rVal = (BoundingBox) this.clone(null);
-//                return rVal.mergeOBB(box);
-//            }
-
-            default:
-                return null;
-        }
+        return mergeLocal(volume);
     }
 
     /**
-     * <code>mergeLocal</code> combines this sphere with a second bounding
-     * sphere locally. Altering this sphere to contain both the original and the
-     * additional sphere volumes;
-     * 
-     * @param volume
-     *            the sphere to combine with this sphere.
-     * @return this
+     * <code>mergeLocal</code> combines this bounding box locally with a second
+     * bounding volume. The result contains both the original box and the second
+     * volume.
+     *
+     * @param volume the bounding volume to combine with this box (or null) (not
+     * altered)
+     * @return this box (with its components modified) or null if the second
+     * volume is of some type other than AABB or Sphere
      */
     public BoundingVolume mergeLocal(BoundingVolume volume) {
         if (volume == null) {
@@ -421,17 +411,15 @@ public class BoundingBox extends BoundingVolume {
         }
 
         switch (volume.getType()) {
-            case AABB: {
+            case AABB:
                 BoundingBox vBox = (BoundingBox) volume;
-                return merge(vBox.center, vBox.xExtent, vBox.yExtent,
-                        vBox.zExtent, this);
-            }
+                return mergeLocal(vBox.center, vBox.xExtent, vBox.yExtent,
+                        vBox.zExtent);
 
-            case Sphere: {
+            case Sphere:
                 BoundingSphere vSphere = (BoundingSphere) volume;
-                return merge(vSphere.center, vSphere.radius, vSphere.radius,
-                        vSphere.radius, this);
-            }
+                return mergeLocal(vSphere.center, vSphere.radius,
+                        vSphere.radius, vSphere.radius);
 
 //            case OBB: {
 //                return mergeOBB((OrientedBoundingBox) volume);
@@ -486,61 +474,68 @@ public class BoundingBox extends BoundingVolume {
 //        return this;
 //    }
     /**
-     * <code>merge</code> combines this bounding box with another box which is
-     * defined by the center, x, y, z extents.
-     * 
-     * @param boxCenter
-     *            the center of the box to merge with
-     * @param boxX
-     *            the x extent of the box to merge with.
-     * @param boxY
-     *            the y extent of the box to merge with.
-     * @param boxZ
-     *            the z extent of the box to merge with.
-     * @param rVal
-     *            the resulting merged box.
+     * <code>mergeLocal</code> combines this bounding box locally with a second
+     * bounding box described by its center and extents.
+     *
+     * @param c the center of the second box (not null, not altered)
+     * @param x the X-extent of the second box
+     * @param y the Y-extent of the second box
+     * @param z the Z-extent of the second box
      * @return the resulting merged box.
      */
-    private BoundingBox merge(Vector3f boxCenter, float boxX, float boxY,
-            float boxZ, BoundingBox rVal) {
-
-        TempVars vars = TempVars.get();
-
-        vars.vect1.x = center.x - xExtent;
-        if (vars.vect1.x > boxCenter.x - boxX) {
-            vars.vect1.x = boxCenter.x - boxX;
-        }
-        vars.vect1.y = center.y - yExtent;
-        if (vars.vect1.y > boxCenter.y - boxY) {
-            vars.vect1.y = boxCenter.y - boxY;
-        }
-        vars.vect1.z = center.z - zExtent;
-        if (vars.vect1.z > boxCenter.z - boxZ) {
-            vars.vect1.z = boxCenter.z - boxZ;
+    private BoundingBox mergeLocal(Vector3f c, float x, float y, float z) {
+        if (xExtent == Float.POSITIVE_INFINITY
+                || x == Float.POSITIVE_INFINITY) {
+            center.x = 0;
+            xExtent = Float.POSITIVE_INFINITY;
+        } else {
+            float low = center.x - xExtent;
+            if (low > c.x - x) {
+                low = c.x - x;
+            }
+            float high = center.x + xExtent;
+            if (high < c.x + x) {
+                high = c.x + x;
+            }
+            center.x = (low + high) / 2;
+            xExtent = high - center.x;
         }
 
-        vars.vect2.x = center.x + xExtent;
-        if (vars.vect2.x < boxCenter.x + boxX) {
-            vars.vect2.x = boxCenter.x + boxX;
-        }
-        vars.vect2.y = center.y + yExtent;
-        if (vars.vect2.y < boxCenter.y + boxY) {
-            vars.vect2.y = boxCenter.y + boxY;
-        }
-        vars.vect2.z = center.z + zExtent;
-        if (vars.vect2.z < boxCenter.z + boxZ) {
-            vars.vect2.z = boxCenter.z + boxZ;
+        if (yExtent == Float.POSITIVE_INFINITY
+                || y == Float.POSITIVE_INFINITY) {
+            center.y = 0;
+            yExtent = Float.POSITIVE_INFINITY;
+        } else {
+            float low = center.y - yExtent;
+            if (low > c.y - y) {
+                low = c.y - y;
+            }
+            float high = center.y + yExtent;
+            if (high < c.y + y) {
+                high = c.y + y;
+            }
+            center.y = (low + high) / 2;
+            yExtent = high - center.y;
         }
 
-        center.set(vars.vect2).addLocal(vars.vect1).multLocal(0.5f);
-
-        xExtent = vars.vect2.x - center.x;
-        yExtent = vars.vect2.y - center.y;
-        zExtent = vars.vect2.z - center.z;
-
-        vars.release();
+        if (zExtent == Float.POSITIVE_INFINITY
+                || z == Float.POSITIVE_INFINITY) {
+            center.z = 0;
+            zExtent = Float.POSITIVE_INFINITY;
+        } else {
+            float low = center.z - zExtent;
+            if (low > c.z - z) {
+                low = c.z - z;
+            }
+            float high = center.z + zExtent;
+            if (high < c.z + z) {
+                high = c.z + z;
+            }
+            center.z = (low + high) / 2;
+            zExtent = high - center.z;
+        }
 
-        return rVal;
+        return this;
     }
 
     /**
@@ -570,8 +565,9 @@ public class BoundingBox extends BoundingVolume {
 
     /**
      * <code>toString</code> returns the string representation of this object.
-     * The form is: "Radius: RRR.SSSS Center: <Vector>".
-     * 
+     * The form is: "[Center: <Vector> xExtent: X.XX yExtent: Y.YY zExtent:
+     * Z.ZZ]".
+     *
      * @return the string representation of this.
      */
     @Override
@@ -985,4 +981,4 @@ public class BoundingBox extends BoundingVolume {
     public float getVolume() {
         return (8 * xExtent * yExtent * zExtent);
     }
-}
+}

engine/src/core/com/jme3/cinematic/events/AbstractCinematicEvent.java

@@ -44,34 +44,35 @@ import java.util.ArrayList;
 import java.util.List;
 
 /**
- * This calls contains basic behavior of a cinematic event
- * every cinematic event must extend this class
+ * This call contains the basic behaviour of a cinematic event.
+ * Every cinematic event must extend this class.
  * 
- * A cinematic event must be given an inital duration in seconds (duration of the event at speed = 1) (default is 10)
+ * A cinematic event must be given an inital duration in seconds 
+ * (duration of the event at speed = 1). Default is 10 sec.
  * @author Nehon
  */
 public abstract class AbstractCinematicEvent implements CinematicEvent {
 
     protected PlayState playState = PlayState.Stopped;
-    protected float speed = 1;
-    protected float initialDuration = 10;
     protected LoopMode loopMode = LoopMode.DontLoop;
+    protected float initialDuration = 10;
+    protected float speed = 1;
     protected float time = 0;
     protected boolean resuming = false;
     
     /**
-     * the list of listeners
+     * The list of listeners.
      */
     protected List<CinematicEventListener> listeners;
 
     /**
-     * contruct a cinematic event
+     * Contruct a cinematic event (empty constructor).
      */
     public AbstractCinematicEvent() {
     }
 
     /**
-     * contruct a cinematic event wwith the given initial duration
+     * Contruct a cinematic event with the given initial duration.
      * @param initialDuration 
      */
     public AbstractCinematicEvent(float initialDuration) {
@@ -79,7 +80,7 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
 
     /**
-     * contruct a cinematic event with the given loopMode
+     * Contruct a cinematic event with the given loopMode.
      * @param loopMode 
      */
     public AbstractCinematicEvent(LoopMode loopMode) {
@@ -87,9 +88,9 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
 
     /**
-     * contruct a cinematic event with the given loopMode and the given initialDuration
-     * @param initialDuration the duration of the event at speed = 1
-     * @param loopMode the loop mode of the event
+     * Contruct a cinematic event with the given loopMode and the given initialDuration.
+     * @param initialDuration the duration of the event at speed = 1.
+     * @param loopMode the loop mode of the event.
      */
     public AbstractCinematicEvent(float initialDuration, LoopMode loopMode) {
         this.initialDuration = initialDuration;
@@ -97,17 +98,17 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
     
     /**
-     * this method can be implemented if the event needs different handling when 
-     * stopped naturally (when the event reach its end)
-     * or when it was forced stopped during playback
-     * otherwise it just call regular stop()
+     * Implement this method if the event needs different handling when 
+     * stopped naturally (when the event reach its end),
+     * or when it was force-stopped during playback.
+     * By default, this method just calls regular stop().
      */
     public void forceStop(){
         stop();
     }
 
     /**
-     * Play this event
+     * Play this event.
      */
     public void play() {
         onPlay();        
@@ -121,13 +122,13 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
 
     /**
-     * Place here the code you want to execute when the event is started
+     * Implement this method with code that you want to execute when the event is started.
      */
     protected abstract void onPlay();
 
     /**
-     * should be used internally only
-     * @param tpf time per frame
+     * Used internally only.
+     * @param tpf time per frame.
      */
     public void internalUpdate(float tpf) {
         if (playState == PlayState.Playing) {
@@ -135,7 +136,7 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
             onUpdate(tpf);
             if (time >= initialDuration && loopMode == LoopMode.DontLoop) {
                 stop();
-            }else if(time >= initialDuration && loopMode == LoopMode.Loop){
+            } else if(time >= initialDuration && loopMode == LoopMode.Loop){
                 setTime(0);
             }
         }
@@ -143,13 +144,15 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
 
     /**
-     * Place here the code you want to execute on update (only called when the event is playing)
+     * Implement this method with the code that you want to execute on update 
+     * (only called when the event is playing).
      * @param tpf time per frame
      */
     protected abstract void onUpdate(float tpf);
 
     /**
-     * stops the animation, next time play() is called the animation will start from the begining.
+     * Stops the animation. 
+     * Next time when play() is called, the animation starts from the beginning.
      */
     public void stop() {
         onStop();
@@ -164,12 +167,13 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
 
     /**
-     * Place here the code you want to execute when the event is stoped.
+     * Implement this method with code that you want to execute when the event is stopped.
      */
     protected abstract void onStop();
 
     /**
-     * pause this event
+     * Pause this event.
+     * Next time when play() is called, the animation restarts from here.
      */
     public void pause() {
         onPause();
@@ -183,12 +187,12 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
 
     /**
-     * place here the code you want to execute when the event is paused
+     * Implement this method with code that you want to execute when the event is paused.
      */
     public abstract void onPause();
 
     /**
-     * returns the actual duration of the animtion (initialDuration/speed)
+     * Returns the actual duration of the animtion (initialDuration/speed)
      * @return
      */
     public float getDuration() {
@@ -198,7 +202,7 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     /**
      * Sets the speed of the animation.
      * At speed = 1, the animation will last initialDuration seconds,
-     * At speed = 2 the animation will last initialDuraiton/2...
+     * At speed = 2, the animation will last initialDuration/2...
      * @param speed
      */
     public void setSpeed(float speed) {
@@ -206,7 +210,7 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
 
     /**
-     * returns the speed of the animation.
+     * Returns the speed of the animation.
      * @return
      */
     public float getSpeed() {
@@ -214,7 +218,7 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
 
     /**
-     * Returns the current playstate of the animation
+     * Returns the current playstate of the animation (playing or paused or stopped).
      * @return
      */
     public PlayState getPlayState() {
@@ -222,7 +226,7 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
 
     /**
-     * returns the initial duration of the animation at speed = 1 in seconds.
+     * Returns the initial duration of the animation at speed = 1 in seconds.
      * @return
      */
     public float getInitialDuration() {
@@ -230,7 +234,7 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
 
     /**
-     * Sets the duration of the antionamtion at speed = 1 in seconds
+     * Sets the duration of the animation at speed = 1 in seconds.
      * @param initialDuration
      */
     public void setInitialDuration(float initialDuration) {
@@ -238,7 +242,7 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
 
     /**
-     * retursthe loopMode of the animation
+     * Returns the loopMode of the animation.
      * @see LoopMode
      * @return
      */
@@ -247,7 +251,7 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
 
     /**
-     * Sets the loopMode of the animation
+     * Sets the loopMode of the animation.
      * @see LoopMode
      * @param loopMode
      */
@@ -256,7 +260,7 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
 
     /**
-     * for serialization only
+     * Used for serialization only.
      * @param ex exporter
      * @throws IOException 
      */
@@ -269,7 +273,7 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
 
     /**
-     * for serialization only
+     * Used for serialization only.
      * @param im importer
      * @throws IOException 
      */
@@ -282,7 +286,7 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
 
     /**
-     * initialize this event (should be called internally only)
+     * Initialize this event (called internally only).
      * @param app
      * @param cinematic 
      */
@@ -290,7 +294,7 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
 
     /**
-     * return a list of CinematicEventListener added on this event
+     * Returns the list of CinematicEventListeners added to this event.
      * @return 
      */
     private List<CinematicEventListener> getListeners() {
@@ -301,7 +305,7 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
 
     /**
-     * Add a CinematicEventListener to this event
+     * Add a CinematicEventListener to this event.
      * @param listener CinematicEventListener
      */
     public void addListener(CinematicEventListener listener) {
@@ -309,7 +313,7 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
 
     /**
-     * remove a CinematicEventListener from this event
+     * Remove a CinematicEventListener from this event.
      * @param listener CinematicEventListener
      */
     public void removeListener(CinematicEventListener listener) {
@@ -317,13 +321,16 @@ public abstract class AbstractCinematicEvent implements CinematicEvent {
     }
 
     /**
-     * When this method is invoked, the event should fast forward to the given time according tim 0 is the start of the event.
-     * @param time the time to fast forward to
+     * Fast-forward the event to the given timestamp. Time=0 is the start of the event.
+     * @param time the time to fast forward to.
      */
     public void setTime(float time) {
         this.time = time ;
     }
 
+    /**
+     * Return the current timestamp of the event. Time=0 is the start of the event.
+     */
     public float getTime() {
         return time;
     }

engine/src/core/com/jme3/input/FlyByCamera.java

@@ -341,7 +341,11 @@ public class FlyByCamera implements AnalogListener, ActionListener {
 
         float fovY = FastMath.atan(h / near)
                   / (FastMath.DEG_TO_RAD * .5f);
-        fovY += value * 0.1f * zoomSpeed;
+        float newFovY = fovY + value * 0.1f * zoomSpeed;
+        if (newFovY > 0f) {
+            // Don't let the FOV go zero or negative.
+            fovY = newFovY;
+        }
 
         h = FastMath.tan( fovY * FastMath.DEG_TO_RAD * .5f) * near;
         w = h * aspect;

engine/src/core/com/jme3/input/KeyNames.java

@@ -149,7 +149,7 @@ public class KeyNames {
         KEY_NAMES[KEY_BACK] = "Backspace";
         KEY_NAMES[KEY_TAB] = "Tab";
         
-        KEY_NAMES[KEY_SYSRQ] = "SysEq";
+        KEY_NAMES[KEY_SYSRQ] = "SysRq";
         KEY_NAMES[KEY_PAUSE] = "Pause";
         
         KEY_NAMES[KEY_HOME] = "Home";

engine/src/core/com/jme3/light/DirectionalLight.java

@@ -69,8 +69,8 @@ public class DirectionalLight extends Light {
     /**
      * Sets the direction of the light.
      * <p>
-     * Represents the vector direction the light is coming from.
-     * (1, 0, 0) would represent a directional light coming from the X axis.
+     * Represents the direction the light is shining.
+     * (1, 0, 0) would represent light shining in the +X direction.
      * 
      * @param dir the direction of the light.
      */

engine/src/core/com/jme3/light/SpotLight.java

@@ -76,8 +76,7 @@ public class SpotLight extends Light implements Savable {
         if(((int)packedAngleCos)== ((int)(outerCos*1000)) ){
             outerCos -= 0.001f;
         }
-        packedAngleCos+=outerCos;
-        System.out.println("anfle"+ packedAngleCos);
+        packedAngleCos+=outerCos;        
     }
 
     @Override

engine/src/core/com/jme3/post/FilterPostProcessor.java

@@ -312,11 +312,7 @@ public class FilterPostProcessor implements SceneProcessor, Savable {
             }
 
         } else {
-            if (renderFrameBufferMS != null) {
-                viewPort.setOutputFrameBuffer(renderFrameBufferMS);
-            } else {
-                viewPort.setOutputFrameBuffer(renderFrameBuffer);
-            }
+           setupViewPortFrameBuffer();
             //init of the camera if it wasn't already
             if (!cameraInit) {
                 viewPort.getCamera().resize(width, height, true);
@@ -353,11 +349,20 @@ public class FilterPostProcessor implements SceneProcessor, Savable {
         for (int i = filters.size() - 1; i >= 0 && lastFilterIndex == -1; i--) {
             if (filters.get(i).isEnabled()) {
                 lastFilterIndex = i;
+                //the Fpp is initialized, but the viwport framebuffer is the 
+                //original out framebuffer so we must recover from a situation 
+                //where no filter was enabled. So we set th correc framebuffer 
+                //on the viewport
+                if(isInitialized() && viewPort.getOutputFrameBuffer()==outputBuffer){
+                    setupViewPortFrameBuffer();
+                }
                 return;
             }
         }
         if (lastFilterIndex == -1) {
-            cleanup();
+            //There is no enabled filter, we restore the original framebuffer 
+            //to the viewport to bypass the fpp.
+            viewPort.setOutputFrameBuffer(outputBuffer);
         }
     }
 
@@ -441,12 +446,7 @@ public class FilterPostProcessor implements SceneProcessor, Savable {
             Filter filter = it.next();
             initFilter(filter, vp);
         }
-
-        if (renderFrameBufferMS != null) {
-            viewPort.setOutputFrameBuffer(renderFrameBufferMS);
-        } else {
-            viewPort.setOutputFrameBuffer(renderFrameBuffer);
-        }
+        setupViewPortFrameBuffer();
     }
 
     /**
@@ -543,4 +543,12 @@ public class FilterPostProcessor implements SceneProcessor, Savable {
     public List<Filter> getFilterList(){
         return Collections.unmodifiableList(filters);
     }
+
+    private void setupViewPortFrameBuffer() {
+        if (renderFrameBufferMS != null) {
+            viewPort.setOutputFrameBuffer(renderFrameBufferMS);
+        } else {
+            viewPort.setOutputFrameBuffer(renderFrameBuffer);
+        }
+    }
 }

engine/src/core/com/jme3/renderer/Camera.java

@@ -320,33 +320,33 @@ public class Camera implements Savable, Cloneable {
         this.width = cam.width;
         this.height = cam.height;
         
-        this.planeState = cam.planeState;
-        this.viewportChanged = cam.viewportChanged;
+        this.planeState = 0;
+        this.viewportChanged = true;
         for (int i = 0; i < MAX_WORLD_PLANES; ++i) {
             worldPlane[i].setNormal(cam.worldPlane[i].getNormal());
             worldPlane[i].setConstant(cam.worldPlane[i].getConstant());
         }
         
         this.parallelProjection = cam.parallelProjection;
-        if(cam.projectionMatrixOverride != null) {
-        	if(this.projectionMatrixOverride == null) {
-        		this.projectionMatrixOverride = cam.projectionMatrixOverride.clone();
-        	} else {
-        		this.projectionMatrixOverride.set(cam.projectionMatrixOverride);
-        	}
+        if (cam.projectionMatrixOverride != null) {
+            if (this.projectionMatrixOverride == null) {
+                this.projectionMatrixOverride = cam.projectionMatrixOverride.clone();
+            } else {
+                this.projectionMatrixOverride.set(cam.projectionMatrixOverride);
+            }
         } else {
-        	this.projectionMatrixOverride = null;
+            this.projectionMatrixOverride = null;
         }
         this.viewMatrix.set(cam.viewMatrix);
         this.projectionMatrix.set(cam.projectionMatrix);
         this.viewProjectionMatrix.set(cam.viewProjectionMatrix);
-        
+
         this.guiBounding.setXExtent(cam.guiBounding.getXExtent());
         this.guiBounding.setYExtent(cam.guiBounding.getYExtent());
         this.guiBounding.setZExtent(cam.guiBounding.getZExtent());
         this.guiBounding.setCenter(cam.guiBounding.getCenter());
         this.guiBounding.setCheckPlane(cam.guiBounding.getCheckPlane());
-        
+
         this.name = cam.name;
     }
 

engine/src/core/com/jme3/renderer/RenderContext.java

@@ -55,10 +55,15 @@ public class RenderContext {
     public boolean depthTestEnabled = false;
 
     /**
-     * @see RenderState#setAlphaTest(boolean) 
+     * @see RenderState#setAlphaFallOff(float) 
      */
     public float alphaTestFallOff = 0f;
 
+    /**
+     * @see RenderState#setAlphaTest(boolean) 
+     */
+    public boolean alphaTestEnabled = false;
+
     /**
      * @see RenderState#setDepthWrite(boolean) 
      */

engine/src/core/com/jme3/scene/BatchNode.java

@@ -754,4 +754,24 @@ public class BatchNode extends Node implements Savable {
     public int getOffsetIndex(Geometry batchedGeometry) {
         return batchedGeometry.startIndex;
     }
+        
+    @Override
+    public Node clone(boolean cloneMaterials) {
+        BatchNode clone = (BatchNode)super.clone(cloneMaterials);
+        if ( batches.size() > 0) {
+            for ( Batch b : batches ) {
+                for ( int i =0; i < clone.children.size(); i++ ) {
+                    if ( clone.children.get(i).getName().equals(b.geometry.getName())) {
+                        clone.children.remove(i);
+                        break;
+                    }
+                }
+            }
+            clone.needsFullRebatch = true;
+            clone.batches.clear();
+            clone.batchesByGeom.clear();
+            clone.batch();
+        }
+        return clone;
+    }
 }

engine/src/core/com/jme3/scene/Mesh.java

@@ -240,8 +240,8 @@ public class Mesh implements Savable, Cloneable {
             }
             
             clone.vertexArrayID = -1;
-            clone.vertCount = -1;
-            clone.elementCount = -1;
+            clone.vertCount = vertCount;
+            clone.elementCount = elementCount;
             
             // although this could change
             // if the bone weight/index buffers are modified

engine/src/core/com/jme3/scene/Node.java

@@ -229,7 +229,7 @@ public class Node extends Spatial implements Savable {
      * @param child
      *            the child to attach to this node.
      * @return the number of children maintained by this node.
-     * @throws NullPointerException If child is null.
+     * @throws IllegalArgumentException if child is null.
      */
     public int attachChild(Spatial child) {
         if (child == null)

engine/src/core/com/jme3/scene/Spatial.java

@@ -1,1512 +1,1515 @@
-/*
- * Copyright (c) 2009-2012 jMonkeyEngine
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are
- * met:
- *
- * * Redistributions of source code must retain the above copyright
- *   notice, this list of conditions and the following disclaimer.
- *
- * * Redistributions in binary form must reproduce the above copyright
- *   notice, this list of conditions and the following disclaimer in the
- *   documentation and/or other materials provided with the distribution.
- *
- * * Neither the name of 'jMonkeyEngine' nor the names of its contributors
- *   may be used to endorse or promote products derived from this software
- *   without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
- * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
- * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
- * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
- * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
- * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
- * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
- * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
- * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-package com.jme3.scene;
-
-import com.jme3.asset.AssetKey;
-import com.jme3.asset.CloneableSmartAsset;
-import com.jme3.bounding.BoundingVolume;
-import com.jme3.collision.Collidable;
-import com.jme3.export.*;
-import com.jme3.light.Light;
-import com.jme3.light.LightList;
-import com.jme3.material.Material;
-import com.jme3.math.*;
-import com.jme3.renderer.Camera;
-import com.jme3.renderer.RenderManager;
-import com.jme3.renderer.ViewPort;
-import com.jme3.renderer.queue.RenderQueue;
-import com.jme3.renderer.queue.RenderQueue.Bucket;
-import com.jme3.renderer.queue.RenderQueue.ShadowMode;
-import com.jme3.scene.control.Control;
-import com.jme3.util.SafeArrayList;
-import com.jme3.util.TempVars;
-import java.io.IOException;
-import java.util.*;
-import java.util.logging.Logger;
-
-/**
- * <code>Spatial</code> defines the base class for scene graph nodes. It
- * maintains a link to a parent, it's local transforms and the world's
- * transforms. All other scene graph elements, such as {@link Node} and
- * {@link Geometry} are subclasses of <code>Spatial</code>.
- *
- * @author Mark Powell
- * @author Joshua Slack
- * @version $Revision: 4075 $, $Data$
- */
-public abstract class Spatial implements Savable, Cloneable, Collidable, CloneableSmartAsset {
-
-    private static final Logger logger = Logger.getLogger(Spatial.class.getName());
-
-    /**
-     * Specifies how frustum culling should be handled by 
-     * this spatial.
-     */
-    public enum CullHint {
-
-        /** 
-         * Do whatever our parent does. If no parent, default to {@link #Dynamic}.
-         */
-        Inherit,
-        /**
-         * Do not draw if we are not at least partially within the view frustum
-         * of the camera. This is determined via the defined
-         * Camera planes whether or not this Spatial should be culled.
-         */
-        Dynamic,
-        /** 
-         * Always cull this from the view, throwing away this object
-         * and any children from rendering commands.
-         */
-        Always,
-        /**
-         * Never cull this from view, always draw it. 
-         * Note that we will still get culled if our parent is culled.
-         */
-        Never;
-    }
-
-    /**
-     * Specifies if this spatial should be batched
-     */
-    public enum BatchHint {
-
-        /** 
-         * Do whatever our parent does. If no parent, default to {@link #Always}.
-         */
-        Inherit,
-        /** 
-         * This spatial will always be batched when attached to a BatchNode.
-         */
-        Always,
-        /** 
-         * This spatial will never be batched when attached to a BatchNode.
-         */
-        Never;
-    }
-    /**
-     * Refresh flag types
-     */
-    protected static final int RF_TRANSFORM = 0x01, // need light resort + combine transforms
-                               RF_BOUND = 0x02,
-                               RF_LIGHTLIST = 0x04; // changes in light lists 
-    
-    protected CullHint cullHint = CullHint.Inherit;
-    protected BatchHint batchHint = BatchHint.Inherit;
-    /** 
-     * Spatial's bounding volume relative to the world.
-     */
-    protected BoundingVolume worldBound;
-    /**
-     * LightList
-     */
-    protected LightList localLights;
-    protected transient LightList worldLights;
-    /** 
-     * This spatial's name.
-     */
-    protected String name;
-    // scale values
-    protected transient Camera.FrustumIntersect frustrumIntersects = Camera.FrustumIntersect.Intersects;
-    protected RenderQueue.Bucket queueBucket = RenderQueue.Bucket.Inherit;
-    protected ShadowMode shadowMode = RenderQueue.ShadowMode.Inherit;
-    public transient float queueDistance = Float.NEGATIVE_INFINITY;
-    protected Transform localTransform;
-    protected Transform worldTransform;
-    protected SafeArrayList<Control> controls = new SafeArrayList<Control>(Control.class);
-    protected HashMap<String, Savable> userData = null;
-    /**
-     * Used for smart asset caching
-     * 
-     * @see AssetKey#useSmartCache() 
-     */
-    protected AssetKey key;
-    /** 
-     * Spatial's parent, or null if it has none.
-     */
-    protected transient Node parent;
-    /**
-     * Refresh flags. Indicate what data of the spatial need to be
-     * updated to reflect the correct state.
-     */
-    protected transient int refreshFlags = 0;
-
-    /**
-     * Serialization only. Do not use.
-     */
-    public Spatial() {
-        localTransform = new Transform();
-        worldTransform = new Transform();
-
-        localLights = new LightList(this);
-        worldLights = new LightList(this);
-
-        refreshFlags |= RF_BOUND;
-    }
-
-    /**
-     * Constructor instantiates a new <code>Spatial</code> object setting the
-     * rotation, translation and scale value to defaults.
-     *
-     * @param name
-     *            the name of the scene element. This is required for
-     *            identification and comparison purposes.
-     */
-    public Spatial(String name) {
-        this();
-        this.name = name;
-    }
-
-    public void setKey(AssetKey key) {
-        this.key = key;
-    }
-
-    public AssetKey getKey() {
-        return key;
-    }
-
-    /**
-     * Indicate that the transform of this spatial has changed and that
-     * a refresh is required.
-     */
-    protected void setTransformRefresh() {
-        refreshFlags |= RF_TRANSFORM;
-        setBoundRefresh();
-    }
-
-    protected void setLightListRefresh() {
-        refreshFlags |= RF_LIGHTLIST;
-    }
-
-    /**
-     * Indicate that the bounding of this spatial has changed and that
-     * a refresh is required.
-     */
-    protected void setBoundRefresh() {
-        refreshFlags |= RF_BOUND;
-
-        Spatial p = parent;
-        while (p != null) {
-            if ((p.refreshFlags & RF_BOUND) != 0) {
-                return;
-            }
-
-            p.refreshFlags |= RF_BOUND;
-            p = p.parent;
-        }
-    }
-    
-    /**
-     * (Internal use only) Forces a refresh of the given types of data.
-     * 
-     * @param transforms Refresh world transform based on parents'
-     * @param bounds Refresh bounding volume data based on child nodes
-     * @param lights Refresh light list based on parents'
-     */
-    public void forceRefresh(boolean transforms, boolean bounds, boolean lights) {
-        if (transforms) {
-            setTransformRefresh();
-        }
-        if (bounds) {
-            setBoundRefresh();
-        }
-        if (lights) {
-            setLightListRefresh();
-        }
-    }
-
-    /**
-     * <code>checkCulling</code> checks the spatial with the camera to see if it
-     * should be culled.
-     * <p>
-     * This method is called by the renderer. Usually it should not be called
-     * directly.
-     *
-     * @param cam The camera to check against.
-     * @return true if inside or intersecting camera frustum
-     * (should be rendered), false if outside.
-     */
-    public boolean checkCulling(Camera cam) {
-        if (refreshFlags != 0) {
-            throw new IllegalStateException("Scene graph is not properly updated for rendering.\n"
-                    + "State was changed after rootNode.updateGeometricState() call. \n"
-                    + "Make sure you do not modify the scene from another thread!\n"
-                    + "Problem spatial name: " + getName());
-        }
-
-        CullHint cm = getCullHint();
-        assert cm != CullHint.Inherit;
-        if (cm == Spatial.CullHint.Always) {
-            setLastFrustumIntersection(Camera.FrustumIntersect.Outside);
-            return false;
-        } else if (cm == Spatial.CullHint.Never) {
-            setLastFrustumIntersection(Camera.FrustumIntersect.Intersects);
-            return true;
-        }
-
-        // check to see if we can cull this node
-        frustrumIntersects = (parent != null ? parent.frustrumIntersects
-                : Camera.FrustumIntersect.Intersects);
-
-        if (frustrumIntersects == Camera.FrustumIntersect.Intersects) {
-            if (getQueueBucket() == Bucket.Gui) {
-                return cam.containsGui(getWorldBound());
-            } else {
-                frustrumIntersects = cam.contains(getWorldBound());
-            }
-        }
-
-        return frustrumIntersects != Camera.FrustumIntersect.Outside;
-    }
-
-    /**
-     * Sets the name of this spatial.
-     *
-     * @param name
-     *            The spatial's new name.
-     */
-    public void setName(String name) {
-        this.name = name;
-    }
-
-    /**
-     * Returns the name of this spatial.
-     *
-     * @return This spatial's name.
-     */
-    public String getName() {
-        return name;
-    }
-
-    /**
-     * Returns the local {@link LightList}, which are the lights
-     * that were directly attached to this <code>Spatial</code> through the
-     * {@link #addLight(com.jme3.light.Light) } and 
-     * {@link #removeLight(com.jme3.light.Light) } methods.
-     * 
-     * @return The local light list
-     */
-    public LightList getLocalLightList() {
-        return localLights;
-    }
-
-    /**
-     * Returns the world {@link LightList}, containing the lights
-     * combined from all this <code>Spatial's</code> parents up to and including
-     * this <code>Spatial</code>'s lights.
-     * 
-     * @return The combined world light list
-     */
-    public LightList getWorldLightList() {
-        return worldLights;
-    }
-
-    /**
-     * <code>getWorldRotation</code> retrieves the absolute rotation of the
-     * Spatial.
-     *
-     * @return the Spatial's world rotation quaternion.
-     */
-    public Quaternion getWorldRotation() {
-        checkDoTransformUpdate();
-        return worldTransform.getRotation();
-    }
-
-    /**
-     * <code>getWorldTranslation</code> retrieves the absolute translation of
-     * the spatial.
-     *
-     * @return the Spatial's world tranlsation vector.
-     */
-    public Vector3f getWorldTranslation() {
-        checkDoTransformUpdate();
-        return worldTransform.getTranslation();
-    }
-
-    /**
-     * <code>getWorldScale</code> retrieves the absolute scale factor of the
-     * spatial.
-     *
-     * @return the Spatial's world scale factor.
-     */
-    public Vector3f getWorldScale() {
-        checkDoTransformUpdate();
-        return worldTransform.getScale();
-    }
-
-    /**
-     * <code>getWorldTransform</code> retrieves the world transformation
-     * of the spatial.
-     *
-     * @return the world transform.
-     */
-    public Transform getWorldTransform() {
-        checkDoTransformUpdate();
-        return worldTransform;
-    }
-
-    /**
-     * <code>rotateUpTo</code> is a utility function that alters the
-     * local rotation to point the Y axis in the direction given by newUp.
-     *
-     * @param newUp
-     *            the up vector to use - assumed to be a unit vector.
-     */
-    public void rotateUpTo(Vector3f newUp) {
-        TempVars vars = TempVars.get();
-
-        Vector3f compVecA = vars.vect1;
-        Quaternion q = vars.quat1;
-
-        // First figure out the current up vector.
-        Vector3f upY = compVecA.set(Vector3f.UNIT_Y);
-        Quaternion rot = localTransform.getRotation();
-        rot.multLocal(upY);
-
-        // get angle between vectors
-        float angle = upY.angleBetween(newUp);
-
-        // figure out rotation axis by taking cross product
-        Vector3f rotAxis = upY.crossLocal(newUp).normalizeLocal();
-
-        // Build a rotation quat and apply current local rotation.
-        q.fromAngleNormalAxis(angle, rotAxis);
-        q.mult(rot, rot);
-
-        vars.release();
-
-        setTransformRefresh();
-    }
-
-    /**
-     * <code>lookAt</code> is a convenience method for auto-setting the local
-     * rotation based on a position in world space and an up vector. It computes the rotation
-     * to transform the z-axis to point onto 'position' and the y-axis to 'up'.
-     * Unlike {@link Quaternion#lookAt(com.jme3.math.Vector3f, com.jme3.math.Vector3f) } 
-     * this method takes a world position to look at and not a relative direction.
-     *
-     * Note : 28/01/2013 this method has been fixed as it was not taking into account the parent rotation.
-     * This was resulting in improper rotation when the spatial had rotated parent nodes.
-     * This method is intended to work in world space, so no matter what parent graph the 
-     * spatial has, it will look at the given position in world space.
-     * 
-     * @param position
-     *            where to look at in terms of world coordinates
-     * @param upVector
-     *            a vector indicating the (local) up direction. (typically {0,
-     *            1, 0} in jME.)
-     */
-    public void lookAt(Vector3f position, Vector3f upVector) {
-        Vector3f worldTranslation = getWorldTranslation();
-
-        TempVars vars = TempVars.get();
-
-        Vector3f compVecA = vars.vect4;
-      
-        compVecA.set(position).subtractLocal(worldTranslation);
-        getLocalRotation().lookAt(compVecA, upVector);        
-        
-        if ( getParent() != null ) {
-            Quaternion rot=vars.quat1;
-            rot =  rot.set(parent.getWorldRotation()).inverseLocal().multLocal(getLocalRotation());
-            rot.normalizeLocal();
-            setLocalRotation(rot);
-        }
-        vars.release();
-        setTransformRefresh();
-    }
-
-    /**
-     * Should be overridden by Node and Geometry.
-     */
-    protected void updateWorldBound() {
-        // the world bound of a leaf is the same as it's model bound
-        // for a node, the world bound is a combination of all it's children
-        // bounds
-        // -> handled by subclass
-        refreshFlags &= ~RF_BOUND;
-    }
-
-    protected void updateWorldLightList() {
-        if (parent == null) {
-            worldLights.update(localLights, null);
-            refreshFlags &= ~RF_LIGHTLIST;
-        } else {
-            if ((parent.refreshFlags & RF_LIGHTLIST) == 0) {
-                worldLights.update(localLights, parent.worldLights);
-                refreshFlags &= ~RF_LIGHTLIST;
-            } else {
-                assert false;
-            }
-        }
-    }
-
-    /**
-     * Should only be called from updateGeometricState().
-     * In most cases should not be subclassed.
-     */
-    protected void updateWorldTransforms() {
-        if (parent == null) {
-            worldTransform.set(localTransform);
-            refreshFlags &= ~RF_TRANSFORM;
-        } else {
-            // check if transform for parent is updated
-            assert ((parent.refreshFlags & RF_TRANSFORM) == 0);
-            worldTransform.set(localTransform);
-            worldTransform.combineWithParent(parent.worldTransform);
-            refreshFlags &= ~RF_TRANSFORM;
-        }
-    }
-
-    /**
-     * Computes the world transform of this Spatial in the most 
-     * efficient manner possible.
-     */
-    void checkDoTransformUpdate() {
-        if ((refreshFlags & RF_TRANSFORM) == 0) {
-            return;
-        }
-
-        if (parent == null) {
-            worldTransform.set(localTransform);
-            refreshFlags &= ~RF_TRANSFORM;
-        } else {
-            TempVars vars = TempVars.get();
-
-            Spatial[] stack = vars.spatialStack;
-            Spatial rootNode = this;
-            int i = 0;
-            while (true) {
-                Spatial hisParent = rootNode.parent;
-                if (hisParent == null) {
-                    rootNode.worldTransform.set(rootNode.localTransform);
-                    rootNode.refreshFlags &= ~RF_TRANSFORM;
-                    i--;
-                    break;
-                }
-
-                stack[i] = rootNode;
-
-                if ((hisParent.refreshFlags & RF_TRANSFORM) == 0) {
-                    break;
-                }
-
-                rootNode = hisParent;
-                i++;
-            }
-
-            vars.release();
-
-            for (int j = i; j >= 0; j--) {
-                rootNode = stack[j];
-                //rootNode.worldTransform.set(rootNode.localTransform);
-                //rootNode.worldTransform.combineWithParent(rootNode.parent.worldTransform);
-                //rootNode.refreshFlags &= ~RF_TRANSFORM;
-                rootNode.updateWorldTransforms();
-            }
-        }
-    }
-
-    /**
-     * Computes this Spatial's world bounding volume in the most efficient
-     * manner possible.
-     */
-    void checkDoBoundUpdate() {
-        if ((refreshFlags & RF_BOUND) == 0) {
-            return;
-        }
-
-        checkDoTransformUpdate();
-
-        // Go to children recursively and update their bound
-        if (this instanceof Node) {
-            Node node = (Node) this;
-            int len = node.getQuantity();
-            for (int i = 0; i < len; i++) {
-                Spatial child = node.getChild(i);
-                child.checkDoBoundUpdate();
-            }
-        }
-
-        // All children's bounds have been updated. Update my own now.
-        updateWorldBound();
-    }
-
-    private void runControlUpdate(float tpf) {
-        if (controls.isEmpty()) {
-            return;
-        }
-
-        for (Control c : controls.getArray()) {
-            c.update(tpf);
-        }
-    }
-
-    /**
-     * Called when the Spatial is about to be rendered, to notify
-     * controls attached to this Spatial using the Control.render() method.
-     *
-     * @param rm The RenderManager rendering the Spatial.
-     * @param vp The ViewPort to which the Spatial is being rendered to.
-     *
-     * @see Spatial#addControl(com.jme3.scene.control.Control)
-     * @see Spatial#getControl(java.lang.Class) 
-     */
-    public void runControlRender(RenderManager rm, ViewPort vp) {
-        if (controls.isEmpty()) {
-            return;
-        }
-
-        for (Control c : controls.getArray()) {
-            c.render(rm, vp);
-        }
-    }
-
-    /**
-     * Add a control to the list of controls.
-     * @param control The control to add.
-     *
-     * @see Spatial#removeControl(java.lang.Class) 
-     */
-    public void addControl(Control control) {
-        controls.add(control);
-        control.setSpatial(this);
-    }
-
-    /**
-     * Removes the first control that is an instance of the given class.
-     *
-     * @see Spatial#addControl(com.jme3.scene.control.Control) 
-     */
-    public void removeControl(Class<? extends Control> controlType) {
-        for (int i = 0; i < controls.size(); i++) {
-            if (controlType.isAssignableFrom(controls.get(i).getClass())) {
-                Control control = controls.remove(i);
-                control.setSpatial(null);
-            }
-        }
-    }
-
-    /**
-     * Removes the given control from this spatial's controls.
-     * 
-     * @param control The control to remove
-     * @return True if the control was successfuly removed. False if 
-     * the control is not assigned to this spatial.
-     * 
-     * @see Spatial#addControl(com.jme3.scene.control.Control) 
-     */
-    public boolean removeControl(Control control) {
-        boolean result = controls.remove(control);
-        if (result) {
-            control.setSpatial(null);
-        }
-
-        return result;
-    }
-
-    /**
-     * Returns the first control that is an instance of the given class,
-     * or null if no such control exists.
-     *
-     * @param controlType The superclass of the control to look for.
-     * @return The first instance in the list of the controlType class, or null.
-     *
-     * @see Spatial#addControl(com.jme3.scene.control.Control) 
-     */
-    public <T extends Control> T getControl(Class<T> controlType) {
-        for (Control c : controls.getArray()) {
-            if (controlType.isAssignableFrom(c.getClass())) {
-                return (T) c;
-            }
-        }
-        return null;
-    }
-
-    /**
-     * Returns the control at the given index in the list.
-     *
-     * @param index The index of the control in the list to find.
-     * @return The control at the given index.
-     *
-     * @throws IndexOutOfBoundsException
-     *      If the index is outside the range [0, getNumControls()-1]
-     *
-     * @see Spatial#addControl(com.jme3.scene.control.Control)
-     */
-    public Control getControl(int index) {
-        return controls.get(index);
-    }
-
-    /**
-     * @return The number of controls attached to this Spatial.
-     * @see Spatial#addControl(com.jme3.scene.control.Control)
-     * @see Spatial#removeControl(java.lang.Class) 
-     */
-    public int getNumControls() {
-        return controls.size();
-    }
-
-    /**
-     * <code>updateLogicalState</code> calls the <code>update()</code> method
-     * for all controls attached to this Spatial.
-     *
-     * @param tpf Time per frame.
-     *
-     * @see Spatial#addControl(com.jme3.scene.control.Control)
-     */
-    public void updateLogicalState(float tpf) {
-        runControlUpdate(tpf);
-    }
-
-    /**
-     * <code>updateGeometricState</code> updates the lightlist,
-     * computes the world transforms, and computes the world bounds
-     * for this Spatial.
-     * Calling this when the Spatial is attached to a node
-     * will cause undefined results. User code should only call this
-     * method on Spatials having no parent.
-     * 
-     * @see Spatial#getWorldLightList()
-     * @see Spatial#getWorldTransform()
-     * @see Spatial#getWorldBound()
-     */
-    public void updateGeometricState() {
-        // assume that this Spatial is a leaf, a proper implementation
-        // for this method should be provided by Node.
-
-        // NOTE: Update world transforms first because
-        // bound transform depends on them.
-        if ((refreshFlags & RF_LIGHTLIST) != 0) {
-            updateWorldLightList();
-        }
-        if ((refreshFlags & RF_TRANSFORM) != 0) {
-            updateWorldTransforms();
-        }
-        if ((refreshFlags & RF_BOUND) != 0) {
-            updateWorldBound();
-        }
-
-        assert refreshFlags == 0;
-    }
-
-    /**
-     * Convert a vector (in) from this spatials' local coordinate space to world
-     * coordinate space.
-     *
-     * @param in
-     *            vector to read from
-     * @param store
-     *            where to write the result (null to create a new vector, may be
-     *            same as in)
-     * @return the result (store)
-     */
-    public Vector3f localToWorld(final Vector3f in, Vector3f store) {
-        checkDoTransformUpdate();
-        return worldTransform.transformVector(in, store);
-    }
-
-    /**
-     * Convert a vector (in) from world coordinate space to this spatials' local
-     * coordinate space.
-     *
-     * @param in
-     *            vector to read from
-     * @param store
-     *            where to write the result
-     * @return the result (store)
-     */
-    public Vector3f worldToLocal(final Vector3f in, final Vector3f store) {
-        checkDoTransformUpdate();
-        return worldTransform.transformInverseVector(in, store);
-    }
-
-    /**
-     * <code>getParent</code> retrieves this node's parent. If the parent is
-     * null this is the root node.
-     *
-     * @return the parent of this node.
-     */
-    public Node getParent() {
-        return parent;
-    }
-
-    /**
-     * Called by {@link Node#attachChild(Spatial)} and
-     * {@link Node#detachChild(Spatial)} - don't call directly.
-     * <code>setParent</code> sets the parent of this node.
-     *
-     * @param parent
-     *            the parent of this node.
-     */
-    protected void setParent(Node parent) {
-        this.parent = parent;
-    }
-
-    /**
-     * <code>removeFromParent</code> removes this Spatial from it's parent.
-     *
-     * @return true if it has a parent and performed the remove.
-     */
-    public boolean removeFromParent() {
-        if (parent != null) {
-            parent.detachChild(this);
-            return true;
-        }
-        return false;
-    }
-
-    /**
-     * determines if the provided Node is the parent, or parent's parent, etc. of this Spatial.
-     *
-     * @param ancestor
-     *            the ancestor object to look for.
-     * @return true if the ancestor is found, false otherwise.
-     */
-    public boolean hasAncestor(Node ancestor) {
-        if (parent == null) {
-            return false;
-        } else if (parent.equals(ancestor)) {
-            return true;
-        } else {
-            return parent.hasAncestor(ancestor);
-        }
-    }
-
-    /**
-     * <code>getLocalRotation</code> retrieves the local rotation of this
-     * node.
-     *
-     * @return the local rotation of this node.
-     */
-    public Quaternion getLocalRotation() {
-        return localTransform.getRotation();
-    }
-
-    /**
-     * <code>setLocalRotation</code> sets the local rotation of this node
-     * by using a {@link Matrix3f}.
-     *
-     * @param rotation
-     *            the new local rotation.
-     */
-    public void setLocalRotation(Matrix3f rotation) {
-        localTransform.getRotation().fromRotationMatrix(rotation);
-        setTransformRefresh();
-    }
-
-    /**
-     * <code>setLocalRotation</code> sets the local rotation of this node.
-     *
-     * @param quaternion
-     *            the new local rotation.
-     */
-    public void setLocalRotation(Quaternion quaternion) {
-        localTransform.setRotation(quaternion);
-        setTransformRefresh();
-    }
-
-    /**
-     * <code>getLocalScale</code> retrieves the local scale of this node.
-     *
-     * @return the local scale of this node.
-     */
-    public Vector3f getLocalScale() {
-        return localTransform.getScale();
-    }
-
-    /**
-     * <code>setLocalScale</code> sets the local scale of this node.
-     *
-     * @param localScale
-     *            the new local scale, applied to x, y and z
-     */
-    public void setLocalScale(float localScale) {
-        localTransform.setScale(localScale);
-        setTransformRefresh();
-    }
-
-    /**
-     * <code>setLocalScale</code> sets the local scale of this node.
-     */
-    public void setLocalScale(float x, float y, float z) {
-        localTransform.setScale(x, y, z);
-        setTransformRefresh();
-    }
-
-    /**
-     * <code>setLocalScale</code> sets the local scale of this node.
-     *
-     * @param localScale
-     *            the new local scale.
-     */
-    public void setLocalScale(Vector3f localScale) {
-        localTransform.setScale(localScale);
-        setTransformRefresh();
-    }
-
-    /**
-     * <code>getLocalTranslation</code> retrieves the local translation of
-     * this node.
-     *
-     * @return the local translation of this node.
-     */
-    public Vector3f getLocalTranslation() {
-        return localTransform.getTranslation();
-    }
-
-    /**
-     * <code>setLocalTranslation</code> sets the local translation of this
-     * spatial.
-     *
-     * @param localTranslation
-     *            the local translation of this spatial.
-     */
-    public void setLocalTranslation(Vector3f localTranslation) {
-        this.localTransform.setTranslation(localTranslation);
-        setTransformRefresh();
-    }
-
-    /**
-     * <code>setLocalTranslation</code> sets the local translation of this
-     * spatial.
-     */
-    public void setLocalTranslation(float x, float y, float z) {
-        this.localTransform.setTranslation(x, y, z);
-        setTransformRefresh();
-    }
-
-    /**
-     * <code>setLocalTransform</code> sets the local transform of this
-     * spatial.
-     */
-    public void setLocalTransform(Transform t) {
-        this.localTransform.set(t);
-        setTransformRefresh();
-    }
-
-    /**
-     * <code>getLocalTransform</code> retrieves the local transform of
-     * this spatial.
-     *
-     * @return the local transform of this spatial.
-     */
-    public Transform getLocalTransform() {
-        return localTransform;
-    }
-
-    /**
-     * Applies the given material to the Spatial, this will propagate the
-     * material down to the geometries in the scene graph.
-     *
-     * @param material The material to set.
-     */
-    public void setMaterial(Material material) {
-    }
-
-    /**
-     * <code>addLight</code> adds the given light to the Spatial; causing
-     * all child Spatials to be effected by it.
-     *
-     * @param light The light to add.
-     */
-    public void addLight(Light light) {
-        localLights.add(light);
-        setLightListRefresh();
-    }
-
-    /**
-     * <code>removeLight</code> removes the given light from the Spatial.
-     * 
-     * @param light The light to remove.
-     * @see Spatial#addLight(com.jme3.light.Light) 
-     */
-    public void removeLight(Light light) {
-        localLights.remove(light);
-        setLightListRefresh();
-    }
-
-    /**
-     * Translates the spatial by the given translation vector.
-     *
-     * @return The spatial on which this method is called, e.g <code>this</code>.
-     */
-    public Spatial move(float x, float y, float z) {
-        this.localTransform.getTranslation().addLocal(x, y, z);
-        setTransformRefresh();
-
-        return this;
-    }
-
-    /**
-     * Translates the spatial by the given translation vector.
-     *
-     * @return The spatial on which this method is called, e.g <code>this</code>.
-     */
-    public Spatial move(Vector3f offset) {
-        this.localTransform.getTranslation().addLocal(offset);
-        setTransformRefresh();
-
-        return this;
-    }
-
-    /**
-     * Scales the spatial by the given value
-     *
-     * @return The spatial on which this method is called, e.g <code>this</code>.
-     */
-    public Spatial scale(float s) {
-        return scale(s, s, s);
-    }
-
-    /**
-     * Scales the spatial by the given scale vector.
-     *
-     * @return The spatial on which this method is called, e.g <code>this</code>.
-     */
-    public Spatial scale(float x, float y, float z) {
-        this.localTransform.getScale().multLocal(x, y, z);
-        setTransformRefresh();
-
-        return this;
-    }
-
-    /**
-     * Rotates the spatial by the given rotation.
-     *
-     * @return The spatial on which this method is called, e.g <code>this</code>.
-     */
-    public Spatial rotate(Quaternion rot) {
-        this.localTransform.getRotation().multLocal(rot);
-        setTransformRefresh();
-
-        return this;
-    }
-
-    /**
-     * Rotates the spatial by the xAngle, yAngle and zAngle angles (in radians),
-     * (aka pitch, yaw, roll) in the local coordinate space.
-     *
-     * @return The spatial on which this method is called, e.g <code>this</code>.
-     */
-    public Spatial rotate(float xAngle, float yAngle, float zAngle) {
-        TempVars vars = TempVars.get();
-        Quaternion q = vars.quat1;
-        q.fromAngles(xAngle, yAngle, zAngle);
-        rotate(q);
-        vars.release();
-
-        return this;
-    }
-
-    /**
-     * Centers the spatial in the origin of the world bound.
-     * @return The spatial on which this method is called, e.g <code>this</code>.
-     */
-    public Spatial center() {
-        Vector3f worldTrans = getWorldTranslation();
-        Vector3f worldCenter = getWorldBound().getCenter();
-
-        Vector3f absTrans = worldTrans.subtract(worldCenter);
-        setLocalTranslation(absTrans);
-
-        return this;
-    }
-
-    /**
-     * @see #setCullHint(CullHint)
-     * @return the cull mode of this spatial, or if set to CullHint.Inherit,
-     * the cullmode of it's parent.
-     */
-    public CullHint getCullHint() {
-        if (cullHint != CullHint.Inherit) {
-            return cullHint;
-        } else if (parent != null) {
-            return parent.getCullHint();
-        } else {
-            return CullHint.Dynamic;
-        }
-    }
-
-    public BatchHint getBatchHint() {
-        if (batchHint != BatchHint.Inherit) {
-            return batchHint;
-        } else if (parent != null) {
-            return parent.getBatchHint();
-        } else {
-            return BatchHint.Always;
-        }
-    }
-
-    /**
-     * Returns this spatial's renderqueue bucket. If the mode is set to inherit,
-     * then the spatial gets its renderqueue bucket from its parent.
-     *
-     * @return The spatial's current renderqueue mode.
-     */
-    public RenderQueue.Bucket getQueueBucket() {
-        if (queueBucket != RenderQueue.Bucket.Inherit) {
-            return queueBucket;
-        } else if (parent != null) {
-            return parent.getQueueBucket();
-        } else {
-            return RenderQueue.Bucket.Opaque;
-        }
-    }
-
-    /**
-     * @return The shadow mode of this spatial, if the local shadow
-     * mode is set to inherit, then the parent's shadow mode is returned.
-     *
-     * @see Spatial#setShadowMode(com.jme3.renderer.queue.RenderQueue.ShadowMode)
-     * @see ShadowMode
-     */
-    public RenderQueue.ShadowMode getShadowMode() {
-        if (shadowMode != RenderQueue.ShadowMode.Inherit) {
-            return shadowMode;
-        } else if (parent != null) {
-            return parent.getShadowMode();
-        } else {
-            return ShadowMode.Off;
-        }
-    }
-
-    /**
-     * Sets the level of detail to use when rendering this Spatial,
-     * this call propagates to all geometries under this Spatial.
-     *
-     * @param lod The lod level to set.
-     */
-    public void setLodLevel(int lod) {
-    }
-
-    /**
-     * <code>updateModelBound</code> recalculates the bounding object for this
-     * Spatial.
-     */
-    public abstract void updateModelBound();
-
-    /**
-     * <code>setModelBound</code> sets the bounding object for this Spatial.
-     *
-     * @param modelBound
-     *            the bounding object for this spatial.
-     */
-    public abstract void setModelBound(BoundingVolume modelBound);
-
-    /**
-     * @return The sum of all verticies under this Spatial.
-     */
-    public abstract int getVertexCount();
-
-    /**
-     * @return The sum of all triangles under this Spatial.
-     */
-    public abstract int getTriangleCount();
-
-    /**
-     * @return A clone of this Spatial, the scene graph in its entirety
-     * is cloned and can be altered independently of the original scene graph.
-     *
-     * Note that meshes of geometries are not cloned explicitly, they
-     * are shared if static, or specially cloned if animated.
-     *
-     * All controls will be cloned using the Control.cloneForSpatial method
-     * on the clone.
-     *
-     * @see Mesh#cloneForAnim() 
-     */
-    public Spatial clone(boolean cloneMaterial) {
-        try {
-            Spatial clone = (Spatial) super.clone();
-            if (worldBound != null) {
-                clone.worldBound = worldBound.clone();
-            }
-            clone.worldLights = worldLights.clone();
-            clone.localLights = localLights.clone();
-
-            // Set the new owner of the light lists
-            clone.localLights.setOwner(clone);
-            clone.worldLights.setOwner(clone);
-
-            // No need to force cloned to update.
-            // This node already has the refresh flags
-            // set below so it will have to update anyway.
-            clone.worldTransform = worldTransform.clone();
-            clone.localTransform = localTransform.clone();
-
-            if (clone instanceof Node) {
-                Node node = (Node) this;
-                Node nodeClone = (Node) clone;
-                nodeClone.children = new SafeArrayList<Spatial>(Spatial.class);
-                for (Spatial child : node.children) {
-                    Spatial childClone = child.clone(cloneMaterial);
-                    childClone.parent = nodeClone;
-                    nodeClone.children.add(childClone);
-                }
-            }
-
-            clone.parent = null;
-            clone.setBoundRefresh();
-            clone.setTransformRefresh();
-            clone.setLightListRefresh();
-
-            clone.controls = new SafeArrayList<Control>(Control.class);
-            for (int i = 0; i < controls.size(); i++) {
-                Control newControl = controls.get(i).cloneForSpatial(clone);
-                newControl.setSpatial(clone);
-                clone.controls.add(newControl);
-            }
-
-            if (userData != null) {
-                clone.userData = (HashMap<String, Savable>) userData.clone();
-            }
-
-            return clone;
-        } catch (CloneNotSupportedException ex) {
-            throw new AssertionError();
-        }
-    }
-
-    /**
-     * @return A clone of this Spatial, the scene graph in its entirety
-     * is cloned and can be altered independently of the original scene graph.
-     *
-     * Note that meshes of geometries are not cloned explicitly, they
-     * are shared if static, or specially cloned if animated.
-     *
-     * All controls will be cloned using the Control.cloneForSpatial method
-     * on the clone.
-     *
-     * @see Mesh#cloneForAnim() 
-     */
-    @Override
-    public Spatial clone() {
-        return clone(true);
-    }
-
-    /**
-     * @return Similar to Spatial.clone() except will create a deep clone
-     * of all geometry's meshes, normally this method shouldn't be used
-     * instead use Spatial.clone()
-     *
-     * @see Spatial#clone()
-     */
-    public abstract Spatial deepClone();
-
-    public void setUserData(String key, Object data) {
-        if (userData == null) {
-            userData = new HashMap<String, Savable>();
-        }
-
-        if(data == null){
-            userData.remove(key);            
-        }else if (data instanceof Savable) {
-            userData.put(key, (Savable) data);
-        } else {
-            userData.put(key, new UserData(UserData.getObjectType(data), data));
-        }
-    }
-
-    @SuppressWarnings("unchecked")
-    public <T> T getUserData(String key) {
-        if (userData == null) {
-            return null;
-        }
-
-        Savable s = userData.get(key);
-        if (s instanceof UserData) {
-            return (T) ((UserData) s).getValue();
-        } else {
-            return (T) s;
-        }
-    }
-
-    public Collection<String> getUserDataKeys() {
-        if (userData != null) {
-            return userData.keySet();
-        }
-
-        return Collections.EMPTY_SET;
-    }
-
-    /**
-     * Note that we are <i>matching</i> the pattern, therefore the pattern
-     * must match the entire pattern (i.e. it behaves as if it is sandwiched
-     * between "^" and "$").
-     * You can set regex modes, like case insensitivity, by using the (?X)
-     * or (?X:Y) constructs.
-     *
-     * @param spatialSubclass Subclass which this must implement.
-     *                        Null causes all Spatials to qualify.
-     * @param nameRegex  Regular expression to match this name against.
-     *                        Null causes all Names to qualify.
-     * @return true if this implements the specified class and this's name
-     *         matches the specified pattern.
-     *
-     * @see java.util.regex.Pattern
-     */
-    public boolean matches(Class<? extends Spatial> spatialSubclass,
-            String nameRegex) {
-        if (spatialSubclass != null && !spatialSubclass.isInstance(this)) {
-            return false;
-        }
-
-        if (nameRegex != null && (name == null || !name.matches(nameRegex))) {
-            return false;
-        }
-
-        return true;
-    }
-
-    public void write(JmeExporter ex) throws IOException {
-        OutputCapsule capsule = ex.getCapsule(this);
-        capsule.write(name, "name", null);
-        capsule.write(worldBound, "world_bound", null);
-        capsule.write(cullHint, "cull_mode", CullHint.Inherit);
-        capsule.write(batchHint, "batch_hint", BatchHint.Inherit);
-        capsule.write(queueBucket, "queue", RenderQueue.Bucket.Inherit);
-        capsule.write(shadowMode, "shadow_mode", ShadowMode.Inherit);
-        capsule.write(localTransform, "transform", Transform.IDENTITY);
-        capsule.write(localLights, "lights", null);
-
-        // Shallow clone the controls array to convert its type.
-        capsule.writeSavableArrayList(new ArrayList(controls), "controlsList", null);
-        capsule.writeStringSavableMap(userData, "user_data", null);
-    }
-
-    public void read(JmeImporter im) throws IOException {
-        InputCapsule ic = im.getCapsule(this);
-
-        name = ic.readString("name", null);
-        worldBound = (BoundingVolume) ic.readSavable("world_bound", null);
-        cullHint = ic.readEnum("cull_mode", CullHint.class, CullHint.Inherit);
-        batchHint = ic.readEnum("batch_hint", BatchHint.class, BatchHint.Inherit);
-        queueBucket = ic.readEnum("queue", RenderQueue.Bucket.class,
-                RenderQueue.Bucket.Inherit);
-        shadowMode = ic.readEnum("shadow_mode", ShadowMode.class,
-                ShadowMode.Inherit);
-
-        localTransform = (Transform) ic.readSavable("transform", Transform.IDENTITY);
-
-        localLights = (LightList) ic.readSavable("lights", null);
-        localLights.setOwner(this);
-
-        //changed for backward compatibility with j3o files generated before the AnimControl/SkeletonControl split
-        //the AnimControl creates the SkeletonControl for old files and add it to the spatial.
-        //The SkeletonControl must be the last in the stack so we add the list of all other control before it.
-        //When backward compatibility won't be needed anymore this can be replaced by : 
-        //controls = ic.readSavableArrayList("controlsList", null));
-        controls.addAll(0, ic.readSavableArrayList("controlsList", null));
-
-        userData = (HashMap<String, Savable>) ic.readStringSavableMap("user_data", null);
-    }
-
-    /**
-     * <code>getWorldBound</code> retrieves the world bound at this node
-     * level.
-     *
-     * @return the world bound at this level.
-     */
-    public BoundingVolume getWorldBound() {
-        checkDoBoundUpdate();
-        return worldBound;
-    }
-
-    /**
-     * <code>setCullHint</code> sets how scene culling should work on this
-     * spatial during drawing. NOTE: You must set this AFTER attaching to a 
-     * parent or it will be reset with the parent's cullMode value.
-     *
-     * @param hint
-     *            one of CullHint.Dynamic, CullHint.Always, CullHint.Inherit or
-     *            CullHint.Never
-     */
-    public void setCullHint(CullHint hint) {
-        cullHint = hint;
-    }
-
-    /**
-     * <code>setBatchHint</code> sets how batching should work on this
-     * spatial. NOTE: You must set this AFTER attaching to a 
-     * parent or it will be reset with the parent's cullMode value.
-     *
-     * @param hint
-     *            one of BatchHint.Never, BatchHint.Always, BatchHint.Inherit 
-     */
-    public void setBatchHint(BatchHint hint) {
-        batchHint = hint;
-    }
-
-    /**
-     * @return the cullmode set on this Spatial
-     */
-    public CullHint getLocalCullHint() {
-        return cullHint;
-    }
-
-    /**
-     * @return the batchHint set on this Spatial
-     */
-    public BatchHint getLocalBatchHint() {
-        return batchHint;
-    }
-
-    /**
-     * <code>setQueueBucket</code> determines at what phase of the
-     * rendering process this Spatial will rendered. See the
-     * {@link Bucket} enum for an explanation of the various 
-     * render queue buckets.
-     * 
-     * @param queueBucket
-     *            The bucket to use for this Spatial.
-     */
-    public void setQueueBucket(RenderQueue.Bucket queueBucket) {
-        this.queueBucket = queueBucket;
-    }
-
-    /**
-     * Sets the shadow mode of the spatial
-     * The shadow mode determines how the spatial should be shadowed,
-     * when a shadowing technique is used. See the
-     * documentation for the class {@link ShadowMode} for more information.
-     *
-     * @see ShadowMode
-     *
-     * @param shadowMode The local shadow mode to set.
-     */
-    public void setShadowMode(RenderQueue.ShadowMode shadowMode) {
-        this.shadowMode = shadowMode;
-    }
-
-    /**
-     * @return The locally set queue bucket mode
-     *
-     * @see Spatial#setQueueBucket(com.jme3.renderer.queue.RenderQueue.Bucket)
-     */
-    public RenderQueue.Bucket getLocalQueueBucket() {
-        return queueBucket;
-    }
-
-    /**
-     * @return The locally set shadow mode
-     *
-     * @see Spatial#setShadowMode(com.jme3.renderer.queue.RenderQueue.ShadowMode)
-     */
-    public RenderQueue.ShadowMode getLocalShadowMode() {
-        return shadowMode;
-    }
-
-    /**
-     * Returns this spatial's last frustum intersection result. This int is set
-     * when a check is made to determine if the bounds of the object fall inside
-     * a camera's frustum. If a parent is found to fall outside the frustum, the
-     * value for this spatial will not be updated.
-     *
-     * @return The spatial's last frustum intersection result.
-     */
-    public Camera.FrustumIntersect getLastFrustumIntersection() {
-        return frustrumIntersects;
-    }
-
-    /**
-     * Overrides the last intersection result. This is useful for operations
-     * that want to start rendering at the middle of a scene tree and don't want
-     * the parent of that node to influence culling.
-     *
-     * @param intersects
-     *            the new value
-     */
-    public void setLastFrustumIntersection(Camera.FrustumIntersect intersects) {
-        frustrumIntersects = intersects;
-    }
-
-    /**
-     * Returns the Spatial's name followed by the class of the spatial <br>
-     * Example: "MyNode (com.jme3.scene.Spatial)
-     *
-     * @return Spatial's name followed by the class of the Spatial
-     */
-    @Override
-    public String toString() {
-        return name + " (" + this.getClass().getSimpleName() + ')';
-    }
-
-    /**
-     * Creates a transform matrix that will convert from this spatials'
-     * local coordinate space to the world coordinate space
-     * based on the world transform.
-     *
-     * @param store Matrix where to store the result, if null, a new one
-     * will be created and returned.
-     *
-     * @return store if not null, otherwise, a new matrix containing the result.
-     *
-     * @see Spatial#getWorldTransform() 
-     */
-    public Matrix4f getLocalToWorldMatrix(Matrix4f store) {
-        if (store == null) {
-            store = new Matrix4f();
-        } else {
-            store.loadIdentity();
-        }
-        // multiply with scale first, then rotate, finally translate (cf.
-        // Eberly)
-        store.scale(getWorldScale());
-        store.multLocal(getWorldRotation());
-        store.setTranslation(getWorldTranslation());
-        return store;
-    }
-
-    /**
-     * Visit each scene graph element ordered by DFS
-     * @param visitor
-     */
-    public abstract void depthFirstTraversal(SceneGraphVisitor visitor);
-
-    /**
-     * Visit each scene graph element ordered by BFS
-     * @param visitor
-     */
-    public void breadthFirstTraversal(SceneGraphVisitor visitor) {
-        Queue<Spatial> queue = new LinkedList<Spatial>();
-        queue.add(this);
-
-        while (!queue.isEmpty()) {
-            Spatial s = queue.poll();
-            visitor.visit(s);
-            s.breadthFirstTraversal(visitor, queue);
-        }
-    }
-
-    protected abstract void breadthFirstTraversal(SceneGraphVisitor visitor, Queue<Spatial> queue);
-}
+/*
+ * Copyright (c) 2009-2013 jMonkeyEngine
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ * * Redistributions of source code must retain the above copyright
+ *   notice, this list of conditions and the following disclaimer.
+ *
+ * * Redistributions in binary form must reproduce the above copyright
+ *   notice, this list of conditions and the following disclaimer in the
+ *   documentation and/or other materials provided with the distribution.
+ *
+ * * Neither the name of 'jMonkeyEngine' nor the names of its contributors
+ *   may be used to endorse or promote products derived from this software
+ *   without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+ * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+ * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+ * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+ * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+ * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+ * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+ * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+package com.jme3.scene;
+
+import com.jme3.asset.AssetKey;
+import com.jme3.asset.CloneableSmartAsset;
+import com.jme3.bounding.BoundingVolume;
+import com.jme3.collision.Collidable;
+import com.jme3.export.*;
+import com.jme3.light.Light;
+import com.jme3.light.LightList;
+import com.jme3.material.Material;
+import com.jme3.math.*;
+import com.jme3.renderer.Camera;
+import com.jme3.renderer.RenderManager;
+import com.jme3.renderer.ViewPort;
+import com.jme3.renderer.queue.RenderQueue;
+import com.jme3.renderer.queue.RenderQueue.Bucket;
+import com.jme3.renderer.queue.RenderQueue.ShadowMode;
+import com.jme3.scene.control.Control;
+import com.jme3.util.SafeArrayList;
+import com.jme3.util.TempVars;
+import java.io.IOException;
+import java.util.*;
+import java.util.logging.Logger;
+
+/**
+ * <code>Spatial</code> defines the base class for scene graph nodes. It
+ * maintains a link to a parent, it's local transforms and the world's
+ * transforms. All other scene graph elements, such as {@link Node} and
+ * {@link Geometry} are subclasses of <code>Spatial</code>.
+ *
+ * @author Mark Powell
+ * @author Joshua Slack
+ * @version $Revision: 4075 $, $Data$
+ */
+public abstract class Spatial implements Savable, Cloneable, Collidable, CloneableSmartAsset {
+
+    private static final Logger logger = Logger.getLogger(Spatial.class.getName());
+
+    /**
+     * Specifies how frustum culling should be handled by 
+     * this spatial.
+     */
+    public enum CullHint {
+
+        /** 
+         * Do whatever our parent does. If no parent, default to {@link #Dynamic}.
+         */
+        Inherit,
+        /**
+         * Do not draw if we are not at least partially within the view frustum
+         * of the camera. This is determined via the defined
+         * Camera planes whether or not this Spatial should be culled.
+         */
+        Dynamic,
+        /** 
+         * Always cull this from the view, throwing away this object
+         * and any children from rendering commands.
+         */
+        Always,
+        /**
+         * Never cull this from view, always draw it. 
+         * Note that we will still get culled if our parent is culled.
+         */
+        Never;
+    }
+
+    /**
+     * Specifies if this spatial should be batched
+     */
+    public enum BatchHint {
+
+        /** 
+         * Do whatever our parent does. If no parent, default to {@link #Always}.
+         */
+        Inherit,
+        /** 
+         * This spatial will always be batched when attached to a BatchNode.
+         */
+        Always,
+        /** 
+         * This spatial will never be batched when attached to a BatchNode.
+         */
+        Never;
+    }
+    /**
+     * Refresh flag types
+     */
+    protected static final int RF_TRANSFORM = 0x01, // need light resort + combine transforms
+                               RF_BOUND = 0x02,
+                               RF_LIGHTLIST = 0x04; // changes in light lists 
+    
+    protected CullHint cullHint = CullHint.Inherit;
+    protected BatchHint batchHint = BatchHint.Inherit;
+    /** 
+     * Spatial's bounding volume relative to the world.
+     */
+    protected BoundingVolume worldBound;
+    /**
+     * LightList
+     */
+    protected LightList localLights;
+    protected transient LightList worldLights;
+    /** 
+     * This spatial's name.
+     */
+    protected String name;
+    // scale values
+    protected transient Camera.FrustumIntersect frustrumIntersects = Camera.FrustumIntersect.Intersects;
+    protected RenderQueue.Bucket queueBucket = RenderQueue.Bucket.Inherit;
+    protected ShadowMode shadowMode = RenderQueue.ShadowMode.Inherit;
+    public transient float queueDistance = Float.NEGATIVE_INFINITY;
+    protected Transform localTransform;
+    protected Transform worldTransform;
+    protected SafeArrayList<Control> controls = new SafeArrayList<Control>(Control.class);
+    protected HashMap<String, Savable> userData = null;
+    /**
+     * Used for smart asset caching
+     * 
+     * @see AssetKey#useSmartCache() 
+     */
+    protected AssetKey key;
+    /** 
+     * Spatial's parent, or null if it has none.
+     */
+    protected transient Node parent;
+    /**
+     * Refresh flags. Indicate what data of the spatial need to be
+     * updated to reflect the correct state.
+     */
+    protected transient int refreshFlags = 0;
+
+    /**
+     * Serialization only. Do not use.
+     */
+    public Spatial() {
+        localTransform = new Transform();
+        worldTransform = new Transform();
+
+        localLights = new LightList(this);
+        worldLights = new LightList(this);
+
+        refreshFlags |= RF_BOUND;
+    }
+
+    /**
+     * Constructor instantiates a new <code>Spatial</code> object setting the
+     * rotation, translation and scale value to defaults.
+     *
+     * @param name
+     *            the name of the scene element. This is required for
+     *            identification and comparison purposes.
+     */
+    public Spatial(String name) {
+        this();
+        this.name = name;
+    }
+
+    public void setKey(AssetKey key) {
+        this.key = key;
+    }
+
+    public AssetKey getKey() {
+        return key;
+    }
+
+    /**
+     * Indicate that the transform of this spatial has changed and that
+     * a refresh is required.
+     */
+    protected void setTransformRefresh() {
+        refreshFlags |= RF_TRANSFORM;
+        setBoundRefresh();
+    }
+
+    protected void setLightListRefresh() {
+        refreshFlags |= RF_LIGHTLIST;
+    }
+
+    /**
+     * Indicate that the bounding of this spatial has changed and that
+     * a refresh is required.
+     */
+    protected void setBoundRefresh() {
+        refreshFlags |= RF_BOUND;
+
+        Spatial p = parent;
+        while (p != null) {
+            if ((p.refreshFlags & RF_BOUND) != 0) {
+                return;
+            }
+
+            p.refreshFlags |= RF_BOUND;
+            p = p.parent;
+        }
+    }
+    
+    /**
+     * (Internal use only) Forces a refresh of the given types of data.
+     * 
+     * @param transforms Refresh world transform based on parents'
+     * @param bounds Refresh bounding volume data based on child nodes
+     * @param lights Refresh light list based on parents'
+     */
+    public void forceRefresh(boolean transforms, boolean bounds, boolean lights) {
+        if (transforms) {
+            setTransformRefresh();
+        }
+        if (bounds) {
+            setBoundRefresh();
+        }
+        if (lights) {
+            setLightListRefresh();
+        }
+    }
+
+    /**
+     * <code>checkCulling</code> checks the spatial with the camera to see if it
+     * should be culled.
+     * <p>
+     * This method is called by the renderer. Usually it should not be called
+     * directly.
+     *
+     * @param cam The camera to check against.
+     * @return true if inside or intersecting camera frustum
+     * (should be rendered), false if outside.
+     */
+    public boolean checkCulling(Camera cam) {
+        if (refreshFlags != 0) {
+            throw new IllegalStateException("Scene graph is not properly updated for rendering.\n"
+                    + "State was changed after rootNode.updateGeometricState() call. \n"
+                    + "Make sure you do not modify the scene from another thread!\n"
+                    + "Problem spatial name: " + getName());
+        }
+
+        CullHint cm = getCullHint();
+        assert cm != CullHint.Inherit;
+        if (cm == Spatial.CullHint.Always) {
+            setLastFrustumIntersection(Camera.FrustumIntersect.Outside);
+            return false;
+        } else if (cm == Spatial.CullHint.Never) {
+            setLastFrustumIntersection(Camera.FrustumIntersect.Intersects);
+            return true;
+        }
+
+        // check to see if we can cull this node
+        frustrumIntersects = (parent != null ? parent.frustrumIntersects
+                : Camera.FrustumIntersect.Intersects);
+
+        if (frustrumIntersects == Camera.FrustumIntersect.Intersects) {
+            if (getQueueBucket() == Bucket.Gui) {
+                return cam.containsGui(getWorldBound());
+            } else {
+                frustrumIntersects = cam.contains(getWorldBound());
+            }
+        }
+
+        return frustrumIntersects != Camera.FrustumIntersect.Outside;
+    }
+
+    /**
+     * Sets the name of this spatial.
+     *
+     * @param name
+     *            The spatial's new name.
+     */
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    /**
+     * Returns the name of this spatial.
+     *
+     * @return This spatial's name.
+     */
+    public String getName() {
+        return name;
+    }
+
+    /**
+     * Returns the local {@link LightList}, which are the lights
+     * that were directly attached to this <code>Spatial</code> through the
+     * {@link #addLight(com.jme3.light.Light) } and 
+     * {@link #removeLight(com.jme3.light.Light) } methods.
+     * 
+     * @return The local light list
+     */
+    public LightList getLocalLightList() {
+        return localLights;
+    }
+
+    /**
+     * Returns the world {@link LightList}, containing the lights
+     * combined from all this <code>Spatial's</code> parents up to and including
+     * this <code>Spatial</code>'s lights.
+     * 
+     * @return The combined world light list
+     */
+    public LightList getWorldLightList() {
+        return worldLights;
+    }
+
+    /**
+     * <code>getWorldRotation</code> retrieves the absolute rotation of the
+     * Spatial.
+     *
+     * @return the Spatial's world rotation quaternion.
+     */
+    public Quaternion getWorldRotation() {
+        checkDoTransformUpdate();
+        return worldTransform.getRotation();
+    }
+
+    /**
+     * <code>getWorldTranslation</code> retrieves the absolute translation of
+     * the spatial.
+     *
+     * @return the Spatial's world tranlsation vector.
+     */
+    public Vector3f getWorldTranslation() {
+        checkDoTransformUpdate();
+        return worldTransform.getTranslation();
+    }
+
+    /**
+     * <code>getWorldScale</code> retrieves the absolute scale factor of the
+     * spatial.
+     *
+     * @return the Spatial's world scale factor.
+     */
+    public Vector3f getWorldScale() {
+        checkDoTransformUpdate();
+        return worldTransform.getScale();
+    }
+
+    /**
+     * <code>getWorldTransform</code> retrieves the world transformation
+     * of the spatial.
+     *
+     * @return the world transform.
+     */
+    public Transform getWorldTransform() {
+        checkDoTransformUpdate();
+        return worldTransform;
+    }
+
+    /**
+     * <code>rotateUpTo</code> is a utility function that alters the
+     * local rotation to point the Y axis in the direction given by newUp.
+     *
+     * @param newUp
+     *            the up vector to use - assumed to be a unit vector.
+     */
+    public void rotateUpTo(Vector3f newUp) {
+        TempVars vars = TempVars.get();
+
+        Vector3f compVecA = vars.vect1;
+        Quaternion q = vars.quat1;
+
+        // First figure out the current up vector.
+        Vector3f upY = compVecA.set(Vector3f.UNIT_Y);
+        Quaternion rot = localTransform.getRotation();
+        rot.multLocal(upY);
+
+        // get angle between vectors
+        float angle = upY.angleBetween(newUp);
+
+        // figure out rotation axis by taking cross product
+        Vector3f rotAxis = upY.crossLocal(newUp).normalizeLocal();
+
+        // Build a rotation quat and apply current local rotation.
+        q.fromAngleNormalAxis(angle, rotAxis);
+        q.mult(rot, rot);
+
+        vars.release();
+
+        setTransformRefresh();
+    }
+
+    /**
+     * <code>lookAt</code> is a convenience method for auto-setting the local
+     * rotation based on a position in world space and an up vector. It computes the rotation
+     * to transform the z-axis to point onto 'position' and the y-axis to 'up'.
+     * Unlike {@link Quaternion#lookAt(com.jme3.math.Vector3f, com.jme3.math.Vector3f) } 
+     * this method takes a world position to look at and not a relative direction.
+     *
+     * Note : 28/01/2013 this method has been fixed as it was not taking into account the parent rotation.
+     * This was resulting in improper rotation when the spatial had rotated parent nodes.
+     * This method is intended to work in world space, so no matter what parent graph the 
+     * spatial has, it will look at the given position in world space.
+     * 
+     * @param position
+     *            where to look at in terms of world coordinates
+     * @param upVector
+     *            a vector indicating the (local) up direction. (typically {0,
+     *            1, 0} in jME.)
+     */
+    public void lookAt(Vector3f position, Vector3f upVector) {
+        Vector3f worldTranslation = getWorldTranslation();
+
+        TempVars vars = TempVars.get();
+
+        Vector3f compVecA = vars.vect4;
+      
+        compVecA.set(position).subtractLocal(worldTranslation);
+        getLocalRotation().lookAt(compVecA, upVector);        
+        
+        if ( getParent() != null ) {
+            Quaternion rot=vars.quat1;
+            rot =  rot.set(parent.getWorldRotation()).inverseLocal().multLocal(getLocalRotation());
+            rot.normalizeLocal();
+            setLocalRotation(rot);
+        }
+        vars.release();
+        setTransformRefresh();
+    }
+
+    /**
+     * Should be overridden by Node and Geometry.
+     */
+    protected void updateWorldBound() {
+        // the world bound of a leaf is the same as it's model bound
+        // for a node, the world bound is a combination of all it's children
+        // bounds
+        // -> handled by subclass
+        refreshFlags &= ~RF_BOUND;
+    }
+
+    protected void updateWorldLightList() {
+        if (parent == null) {
+            worldLights.update(localLights, null);
+            refreshFlags &= ~RF_LIGHTLIST;
+        } else {
+            if ((parent.refreshFlags & RF_LIGHTLIST) == 0) {
+                worldLights.update(localLights, parent.worldLights);
+                refreshFlags &= ~RF_LIGHTLIST;
+            } else {
+                assert false;
+            }
+        }
+    }
+
+    /**
+     * Should only be called from updateGeometricState().
+     * In most cases should not be subclassed.
+     */
+    protected void updateWorldTransforms() {
+        if (parent == null) {
+            worldTransform.set(localTransform);
+            refreshFlags &= ~RF_TRANSFORM;
+        } else {
+            // check if transform for parent is updated
+            assert ((parent.refreshFlags & RF_TRANSFORM) == 0);
+            worldTransform.set(localTransform);
+            worldTransform.combineWithParent(parent.worldTransform);
+            refreshFlags &= ~RF_TRANSFORM;
+        }
+    }
+
+    /**
+     * Computes the world transform of this Spatial in the most 
+     * efficient manner possible.
+     */
+    void checkDoTransformUpdate() {
+        if ((refreshFlags & RF_TRANSFORM) == 0) {
+            return;
+        }
+
+        if (parent == null) {
+            worldTransform.set(localTransform);
+            refreshFlags &= ~RF_TRANSFORM;
+        } else {
+            TempVars vars = TempVars.get();
+
+            Spatial[] stack = vars.spatialStack;
+            Spatial rootNode = this;
+            int i = 0;
+            while (true) {
+                Spatial hisParent = rootNode.parent;
+                if (hisParent == null) {
+                    rootNode.worldTransform.set(rootNode.localTransform);
+                    rootNode.refreshFlags &= ~RF_TRANSFORM;
+                    i--;
+                    break;
+                }
+
+                stack[i] = rootNode;
+
+                if ((hisParent.refreshFlags & RF_TRANSFORM) == 0) {
+                    break;
+                }
+
+                rootNode = hisParent;
+                i++;
+            }
+
+            vars.release();
+
+            for (int j = i; j >= 0; j--) {
+                rootNode = stack[j];
+                //rootNode.worldTransform.set(rootNode.localTransform);
+                //rootNode.worldTransform.combineWithParent(rootNode.parent.worldTransform);
+                //rootNode.refreshFlags &= ~RF_TRANSFORM;
+                rootNode.updateWorldTransforms();
+            }
+        }
+    }
+
+    /**
+     * Computes this Spatial's world bounding volume in the most efficient
+     * manner possible.
+     */
+    void checkDoBoundUpdate() {
+        if ((refreshFlags & RF_BOUND) == 0) {
+            return;
+        }
+
+        checkDoTransformUpdate();
+
+        // Go to children recursively and update their bound
+        if (this instanceof Node) {
+            Node node = (Node) this;
+            int len = node.getQuantity();
+            for (int i = 0; i < len; i++) {
+                Spatial child = node.getChild(i);
+                child.checkDoBoundUpdate();
+            }
+        }
+
+        // All children's bounds have been updated. Update my own now.
+        updateWorldBound();
+    }
+
+    private void runControlUpdate(float tpf) {
+        if (controls.isEmpty()) {
+            return;
+        }
+
+        for (Control c : controls.getArray()) {
+            c.update(tpf);
+        }
+    }
+
+    /**
+     * Called when the Spatial is about to be rendered, to notify
+     * controls attached to this Spatial using the Control.render() method.
+     *
+     * @param rm The RenderManager rendering the Spatial.
+     * @param vp The ViewPort to which the Spatial is being rendered to.
+     *
+     * @see Spatial#addControl(com.jme3.scene.control.Control)
+     * @see Spatial#getControl(java.lang.Class) 
+     */
+    public void runControlRender(RenderManager rm, ViewPort vp) {
+        if (controls.isEmpty()) {
+            return;
+        }
+
+        for (Control c : controls.getArray()) {
+            c.render(rm, vp);
+        }
+    }
+
+    /**
+     * Add a control to the list of controls.
+     * @param control The control to add.
+     *
+     * @see Spatial#removeControl(java.lang.Class) 
+     */
+    public void addControl(Control control) {
+        controls.add(control);
+        control.setSpatial(this);
+    }
+
+    /**
+     * Removes the first control that is an instance of the given class.
+     *
+     * @see Spatial#addControl(com.jme3.scene.control.Control) 
+     */
+    public void removeControl(Class<? extends Control> controlType) {
+        for (int i = 0; i < controls.size(); i++) {
+            if (controlType.isAssignableFrom(controls.get(i).getClass())) {
+                Control control = controls.remove(i);
+                control.setSpatial(null);
+            }
+        }
+    }
+
+    /**
+     * Removes the given control from this spatial's controls.
+     * 
+     * @param control The control to remove
+     * @return True if the control was successfuly removed. False if 
+     * the control is not assigned to this spatial.
+     * 
+     * @see Spatial#addControl(com.jme3.scene.control.Control) 
+     */
+    public boolean removeControl(Control control) {
+        boolean result = controls.remove(control);
+        if (result) {
+            control.setSpatial(null);
+        }
+
+        return result;
+    }
+
+    /**
+     * Returns the first control that is an instance of the given class,
+     * or null if no such control exists.
+     *
+     * @param controlType The superclass of the control to look for.
+     * @return The first instance in the list of the controlType class, or null.
+     *
+     * @see Spatial#addControl(com.jme3.scene.control.Control) 
+     */
+    public <T extends Control> T getControl(Class<T> controlType) {
+        for (Control c : controls.getArray()) {
+            if (controlType.isAssignableFrom(c.getClass())) {
+                return (T) c;
+            }
+        }
+        return null;
+    }
+
+    /**
+     * Returns the control at the given index in the list.
+     *
+     * @param index The index of the control in the list to find.
+     * @return The control at the given index.
+     *
+     * @throws IndexOutOfBoundsException
+     *      If the index is outside the range [0, getNumControls()-1]
+     *
+     * @see Spatial#addControl(com.jme3.scene.control.Control)
+     */
+    public Control getControl(int index) {
+        return controls.get(index);
+    }
+
+    /**
+     * @return The number of controls attached to this Spatial.
+     * @see Spatial#addControl(com.jme3.scene.control.Control)
+     * @see Spatial#removeControl(java.lang.Class) 
+     */
+    public int getNumControls() {
+        return controls.size();
+    }
+
+    /**
+     * <code>updateLogicalState</code> calls the <code>update()</code> method
+     * for all controls attached to this Spatial.
+     *
+     * @param tpf Time per frame.
+     *
+     * @see Spatial#addControl(com.jme3.scene.control.Control)
+     */
+    public void updateLogicalState(float tpf) {
+        runControlUpdate(tpf);
+    }
+
+    /**
+     * <code>updateGeometricState</code> updates the lightlist,
+     * computes the world transforms, and computes the world bounds
+     * for this Spatial.
+     * Calling this when the Spatial is attached to a node
+     * will cause undefined results. User code should only call this
+     * method on Spatials having no parent.
+     * 
+     * @see Spatial#getWorldLightList()
+     * @see Spatial#getWorldTransform()
+     * @see Spatial#getWorldBound()
+     */
+    public void updateGeometricState() {
+        // assume that this Spatial is a leaf, a proper implementation
+        // for this method should be provided by Node.
+
+        // NOTE: Update world transforms first because
+        // bound transform depends on them.
+        if ((refreshFlags & RF_LIGHTLIST) != 0) {
+            updateWorldLightList();
+        }
+        if ((refreshFlags & RF_TRANSFORM) != 0) {
+            updateWorldTransforms();
+        }
+        if ((refreshFlags & RF_BOUND) != 0) {
+            updateWorldBound();
+        }
+
+        assert refreshFlags == 0;
+    }
+
+    /**
+     * Convert a vector (in) from this spatials' local coordinate space to world
+     * coordinate space.
+     *
+     * @param in
+     *            vector to read from
+     * @param store
+     *            where to write the result (null to create a new vector, may be
+     *            same as in)
+     * @return the result (store)
+     */
+    public Vector3f localToWorld(final Vector3f in, Vector3f store) {
+        checkDoTransformUpdate();
+        return worldTransform.transformVector(in, store);
+    }
+
+    /**
+     * Convert a vector (in) from world coordinate space to this spatials' local
+     * coordinate space.
+     *
+     * @param in
+     *            vector to read from
+     * @param store
+     *            where to write the result
+     * @return the result (store)
+     */
+    public Vector3f worldToLocal(final Vector3f in, final Vector3f store) {
+        checkDoTransformUpdate();
+        return worldTransform.transformInverseVector(in, store);
+    }
+
+    /**
+     * <code>getParent</code> retrieves this node's parent. If the parent is
+     * null this is the root node.
+     *
+     * @return the parent of this node.
+     */
+    public Node getParent() {
+        return parent;
+    }
+
+    /**
+     * Called by {@link Node#attachChild(Spatial)} and
+     * {@link Node#detachChild(Spatial)} - don't call directly.
+     * <code>setParent</code> sets the parent of this node.
+     *
+     * @param parent
+     *            the parent of this node.
+     */
+    protected void setParent(Node parent) {
+        this.parent = parent;
+    }
+
+    /**
+     * <code>removeFromParent</code> removes this Spatial from it's parent.
+     *
+     * @return true if it has a parent and performed the remove.
+     */
+    public boolean removeFromParent() {
+        if (parent != null) {
+            parent.detachChild(this);
+            return true;
+        }
+        return false;
+    }
+
+    /**
+     * determines if the provided Node is the parent, or parent's parent, etc. of this Spatial.
+     *
+     * @param ancestor
+     *            the ancestor object to look for.
+     * @return true if the ancestor is found, false otherwise.
+     */
+    public boolean hasAncestor(Node ancestor) {
+        if (parent == null) {
+            return false;
+        } else if (parent.equals(ancestor)) {
+            return true;
+        } else {
+            return parent.hasAncestor(ancestor);
+        }
+    }
+
+    /**
+     * <code>getLocalRotation</code> retrieves the local rotation of this
+     * node.
+     *
+     * @return the local rotation of this node.
+     */
+    public Quaternion getLocalRotation() {
+        return localTransform.getRotation();
+    }
+
+    /**
+     * <code>setLocalRotation</code> sets the local rotation of this node
+     * by using a {@link Matrix3f}.
+     *
+     * @param rotation
+     *            the new local rotation.
+     */
+    public void setLocalRotation(Matrix3f rotation) {
+        localTransform.getRotation().fromRotationMatrix(rotation);
+        setTransformRefresh();
+    }
+
+    /**
+     * <code>setLocalRotation</code> sets the local rotation of this node.
+     *
+     * @param quaternion
+     *            the new local rotation.
+     */
+    public void setLocalRotation(Quaternion quaternion) {
+        localTransform.setRotation(quaternion);
+        setTransformRefresh();
+    }
+
+    /**
+     * <code>getLocalScale</code> retrieves the local scale of this node.
+     *
+     * @return the local scale of this node.
+     */
+    public Vector3f getLocalScale() {
+        return localTransform.getScale();
+    }
+
+    /**
+     * <code>setLocalScale</code> sets the local scale of this node.
+     *
+     * @param localScale
+     *            the new local scale, applied to x, y and z
+     */
+    public void setLocalScale(float localScale) {
+        localTransform.setScale(localScale);
+        setTransformRefresh();
+    }
+
+    /**
+     * <code>setLocalScale</code> sets the local scale of this node.
+     */
+    public void setLocalScale(float x, float y, float z) {
+        localTransform.setScale(x, y, z);
+        setTransformRefresh();
+    }
+
+    /**
+     * <code>setLocalScale</code> sets the local scale of this node.
+     *
+     * @param localScale
+     *            the new local scale.
+     */
+    public void setLocalScale(Vector3f localScale) {
+        localTransform.setScale(localScale);
+        setTransformRefresh();
+    }
+
+    /**
+     * <code>getLocalTranslation</code> retrieves the local translation of
+     * this node.
+     *
+     * @return the local translation of this node.
+     */
+    public Vector3f getLocalTranslation() {
+        return localTransform.getTranslation();
+    }
+
+    /**
+     * <code>setLocalTranslation</code> sets the local translation of this
+     * spatial.
+     *
+     * @param localTranslation
+     *            the local translation of this spatial.
+     */
+    public void setLocalTranslation(Vector3f localTranslation) {
+        this.localTransform.setTranslation(localTranslation);
+        setTransformRefresh();
+    }
+
+    /**
+     * <code>setLocalTranslation</code> sets the local translation of this
+     * spatial.
+     */
+    public void setLocalTranslation(float x, float y, float z) {
+        this.localTransform.setTranslation(x, y, z);
+        setTransformRefresh();
+    }
+
+    /**
+     * <code>setLocalTransform</code> sets the local transform of this
+     * spatial.
+     */
+    public void setLocalTransform(Transform t) {
+        this.localTransform.set(t);
+        setTransformRefresh();
+    }
+
+    /**
+     * <code>getLocalTransform</code> retrieves the local transform of
+     * this spatial.
+     *
+     * @return the local transform of this spatial.
+     */
+    public Transform getLocalTransform() {
+        return localTransform;
+    }
+
+    /**
+     * Applies the given material to the Spatial, this will propagate the
+     * material down to the geometries in the scene graph.
+     *
+     * @param material The material to set.
+     */
+    public void setMaterial(Material material) {
+    }
+
+    /**
+     * <code>addLight</code> adds the given light to the Spatial; causing
+     * all child Spatials to be effected by it.
+     *
+     * @param light The light to add.
+     */
+    public void addLight(Light light) {
+        localLights.add(light);
+        setLightListRefresh();
+    }
+
+    /**
+     * <code>removeLight</code> removes the given light from the Spatial.
+     * 
+     * @param light The light to remove.
+     * @see Spatial#addLight(com.jme3.light.Light) 
+     */
+    public void removeLight(Light light) {
+        localLights.remove(light);
+        setLightListRefresh();
+    }
+
+    /**
+     * Translates the spatial by the given translation vector.
+     *
+     * @return The spatial on which this method is called, e.g <code>this</code>.
+     */
+    public Spatial move(float x, float y, float z) {
+        this.localTransform.getTranslation().addLocal(x, y, z);
+        setTransformRefresh();
+
+        return this;
+    }
+
+    /**
+     * Translates the spatial by the given translation vector.
+     *
+     * @return The spatial on which this method is called, e.g <code>this</code>.
+     */
+    public Spatial move(Vector3f offset) {
+        this.localTransform.getTranslation().addLocal(offset);
+        setTransformRefresh();
+
+        return this;
+    }
+
+    /**
+     * Scales the spatial by the given value
+     *
+     * @return The spatial on which this method is called, e.g <code>this</code>.
+     */
+    public Spatial scale(float s) {
+        return scale(s, s, s);
+    }
+
+    /**
+     * Scales the spatial by the given scale vector.
+     *
+     * @return The spatial on which this method is called, e.g <code>this</code>.
+     */
+    public Spatial scale(float x, float y, float z) {
+        this.localTransform.getScale().multLocal(x, y, z);
+        setTransformRefresh();
+
+        return this;
+    }
+
+    /**
+     * Rotates the spatial by the given rotation.
+     *
+     * @return The spatial on which this method is called, e.g <code>this</code>.
+     */
+    public Spatial rotate(Quaternion rot) {
+        this.localTransform.getRotation().multLocal(rot);
+        setTransformRefresh();
+
+        return this;
+    }
+
+    /**
+     * Rotates the spatial by the xAngle, yAngle and zAngle angles (in radians),
+     * (aka pitch, yaw, roll) in the local coordinate space.
+     *
+     * @return The spatial on which this method is called, e.g <code>this</code>.
+     */
+    public Spatial rotate(float xAngle, float yAngle, float zAngle) {
+        TempVars vars = TempVars.get();
+        Quaternion q = vars.quat1;
+        q.fromAngles(xAngle, yAngle, zAngle);
+        rotate(q);
+        vars.release();
+
+        return this;
+    }
+
+    /**
+     * Centers the spatial in the origin of the world bound.
+     * @return The spatial on which this method is called, e.g <code>this</code>.
+     */
+    public Spatial center() {
+        Vector3f worldTrans = getWorldTranslation();
+        Vector3f worldCenter = getWorldBound().getCenter();
+
+        Vector3f absTrans = worldTrans.subtract(worldCenter);
+        setLocalTranslation(absTrans);
+
+        return this;
+    }
+
+    /**
+     * @see #setCullHint(CullHint)
+     * @return the cull mode of this spatial, or if set to CullHint.Inherit,
+     * the cullmode of it's parent.
+     */
+    public CullHint getCullHint() {
+        if (cullHint != CullHint.Inherit) {
+            return cullHint;
+        } else if (parent != null) {
+            return parent.getCullHint();
+        } else {
+            return CullHint.Dynamic;
+        }
+    }
+
+    public BatchHint getBatchHint() {
+        if (batchHint != BatchHint.Inherit) {
+            return batchHint;
+        } else if (parent != null) {
+            return parent.getBatchHint();
+        } else {
+            return BatchHint.Always;
+        }
+    }
+
+    /**
+     * Returns this spatial's renderqueue bucket. If the mode is set to inherit,
+     * then the spatial gets its renderqueue bucket from its parent.
+     *
+     * @return The spatial's current renderqueue mode.
+     */
+    public RenderQueue.Bucket getQueueBucket() {
+        if (queueBucket != RenderQueue.Bucket.Inherit) {
+            return queueBucket;
+        } else if (parent != null) {
+            return parent.getQueueBucket();
+        } else {
+            return RenderQueue.Bucket.Opaque;
+        }
+    }
+
+    /**
+     * @return The shadow mode of this spatial, if the local shadow
+     * mode is set to inherit, then the parent's shadow mode is returned.
+     *
+     * @see Spatial#setShadowMode(com.jme3.renderer.queue.RenderQueue.ShadowMode)
+     * @see ShadowMode
+     */
+    public RenderQueue.ShadowMode getShadowMode() {
+        if (shadowMode != RenderQueue.ShadowMode.Inherit) {
+            return shadowMode;
+        } else if (parent != null) {
+            return parent.getShadowMode();
+        } else {
+            return ShadowMode.Off;
+        }
+    }
+
+    /**
+     * Sets the level of detail to use when rendering this Spatial,
+     * this call propagates to all geometries under this Spatial.
+     *
+     * @param lod The lod level to set.
+     */
+    public void setLodLevel(int lod) {
+    }
+
+    /**
+     * <code>updateModelBound</code> recalculates the bounding object for this
+     * Spatial.
+     */
+    public abstract void updateModelBound();
+
+    /**
+     * <code>setModelBound</code> sets the bounding object for this Spatial.
+     *
+     * @param modelBound
+     *            the bounding object for this spatial.
+     */
+    public abstract void setModelBound(BoundingVolume modelBound);
+
+    /**
+     * @return The sum of all verticies under this Spatial.
+     */
+    public abstract int getVertexCount();
+
+    /**
+     * @return The sum of all triangles under this Spatial.
+     */
+    public abstract int getTriangleCount();
+
+    /**
+     * @return A clone of this Spatial, the scene graph in its entirety
+     * is cloned and can be altered independently of the original scene graph.
+     *
+     * Note that meshes of geometries are not cloned explicitly, they
+     * are shared if static, or specially cloned if animated.
+     *
+     * All controls will be cloned using the Control.cloneForSpatial method
+     * on the clone.
+     *
+     * @see Mesh#cloneForAnim() 
+     */
+    public Spatial clone(boolean cloneMaterial) {
+        try {
+            Spatial clone = (Spatial) super.clone();
+            if (worldBound != null) {
+                clone.worldBound = worldBound.clone();
+            }
+            clone.worldLights = worldLights.clone();
+            clone.localLights = localLights.clone();
+
+            // Set the new owner of the light lists
+            clone.localLights.setOwner(clone);
+            clone.worldLights.setOwner(clone);
+
+            // No need to force cloned to update.
+            // This node already has the refresh flags
+            // set below so it will have to update anyway.
+            clone.worldTransform = worldTransform.clone();
+            clone.localTransform = localTransform.clone();
+
+            if (clone instanceof Node) {
+                Node node = (Node) this;
+                Node nodeClone = (Node) clone;
+                nodeClone.children = new SafeArrayList<Spatial>(Spatial.class);
+                for (Spatial child : node.children) {
+                    Spatial childClone = child.clone(cloneMaterial);
+                    childClone.parent = nodeClone;
+                    nodeClone.children.add(childClone);
+                }
+            }
+
+            clone.parent = null;
+            clone.setBoundRefresh();
+            clone.setTransformRefresh();
+            clone.setLightListRefresh();
+
+            clone.controls = new SafeArrayList<Control>(Control.class);
+            for (int i = 0; i < controls.size(); i++) {
+                Control newControl = controls.get(i).cloneForSpatial(clone);
+                newControl.setSpatial(clone);
+                clone.controls.add(newControl);
+            }
+
+            if (userData != null) {
+                clone.userData = (HashMap<String, Savable>) userData.clone();
+            }
+
+            return clone;
+        } catch (CloneNotSupportedException ex) {
+            throw new AssertionError();
+        }
+    }
+
+    /**
+     * @return A clone of this Spatial, the scene graph in its entirety
+     * is cloned and can be altered independently of the original scene graph.
+     *
+     * Note that meshes of geometries are not cloned explicitly, they
+     * are shared if static, or specially cloned if animated.
+     *
+     * All controls will be cloned using the Control.cloneForSpatial method
+     * on the clone.
+     *
+     * @see Mesh#cloneForAnim() 
+     */
+    @Override
+    public Spatial clone() {
+        return clone(true);
+    }
+
+    /**
+     * @return Similar to Spatial.clone() except will create a deep clone
+     * of all geometry's meshes, normally this method shouldn't be used
+     * instead use Spatial.clone()
+     *
+     * @see Spatial#clone()
+     */
+    public abstract Spatial deepClone();
+
+    public void setUserData(String key, Object data) {
+        if (userData == null) {
+            userData = new HashMap<String, Savable>();
+        }
+
+        if(data == null){
+            userData.remove(key);            
+        }else if (data instanceof Savable) {
+            userData.put(key, (Savable) data);
+        } else {
+            userData.put(key, new UserData(UserData.getObjectType(data), data));
+        }
+    }
+
+    @SuppressWarnings("unchecked")
+    public <T> T getUserData(String key) {
+        if (userData == null) {
+            return null;
+        }
+
+        Savable s = userData.get(key);
+        if (s instanceof UserData) {
+            return (T) ((UserData) s).getValue();
+        } else {
+            return (T) s;
+        }
+    }
+
+    public Collection<String> getUserDataKeys() {
+        if (userData != null) {
+            return userData.keySet();
+        }
+
+        return Collections.EMPTY_SET;
+    }
+
+    /**
+     * Note that we are <i>matching</i> the pattern, therefore the pattern
+     * must match the entire pattern (i.e. it behaves as if it is sandwiched
+     * between "^" and "$").
+     * You can set regex modes, like case insensitivity, by using the (?X)
+     * or (?X:Y) constructs.
+     *
+     * @param spatialSubclass Subclass which this must implement.
+     *                        Null causes all Spatials to qualify.
+     * @param nameRegex  Regular expression to match this name against.
+     *                        Null causes all Names to qualify.
+     * @return true if this implements the specified class and this's name
+     *         matches the specified pattern.
+     *
+     * @see java.util.regex.Pattern
+     */
+    public boolean matches(Class<? extends Spatial> spatialSubclass,
+            String nameRegex) {
+        if (spatialSubclass != null && !spatialSubclass.isInstance(this)) {
+            return false;
+        }
+
+        if (nameRegex != null && (name == null || !name.matches(nameRegex))) {
+            return false;
+        }
+
+        return true;
+    }
+
+    public void write(JmeExporter ex) throws IOException {
+        OutputCapsule capsule = ex.getCapsule(this);
+        capsule.write(name, "name", null);
+        capsule.write(worldBound, "world_bound", null);
+        capsule.write(cullHint, "cull_mode", CullHint.Inherit);
+        capsule.write(batchHint, "batch_hint", BatchHint.Inherit);
+        capsule.write(queueBucket, "queue", RenderQueue.Bucket.Inherit);
+        capsule.write(shadowMode, "shadow_mode", ShadowMode.Inherit);
+        capsule.write(localTransform, "transform", Transform.IDENTITY);
+        capsule.write(localLights, "lights", null);
+
+        // Shallow clone the controls array to convert its type.
+        capsule.writeSavableArrayList(new ArrayList(controls), "controlsList", null);
+        capsule.writeStringSavableMap(userData, "user_data", null);
+    }
+
+    public void read(JmeImporter im) throws IOException {
+        InputCapsule ic = im.getCapsule(this);
+
+        name = ic.readString("name", null);
+        worldBound = (BoundingVolume) ic.readSavable("world_bound", null);
+        cullHint = ic.readEnum("cull_mode", CullHint.class, CullHint.Inherit);
+        batchHint = ic.readEnum("batch_hint", BatchHint.class, BatchHint.Inherit);
+        queueBucket = ic.readEnum("queue", RenderQueue.Bucket.class,
+                RenderQueue.Bucket.Inherit);
+        shadowMode = ic.readEnum("shadow_mode", ShadowMode.class,
+                ShadowMode.Inherit);
+
+        localTransform = (Transform) ic.readSavable("transform", Transform.IDENTITY);
+
+        localLights = (LightList) ic.readSavable("lights", null);
+        localLights.setOwner(this);
+
+        //changed for backward compatibility with j3o files generated before the AnimControl/SkeletonControl split
+        //the AnimControl creates the SkeletonControl for old files and add it to the spatial.
+        //The SkeletonControl must be the last in the stack so we add the list of all other control before it.
+        //When backward compatibility won't be needed anymore this can be replaced by : 
+        //controls = ic.readSavableArrayList("controlsList", null));
+        controls.addAll(0, ic.readSavableArrayList("controlsList", null));
+
+        userData = (HashMap<String, Savable>) ic.readStringSavableMap("user_data", null);
+    }
+
+    /**
+     * <code>getWorldBound</code> retrieves the world bound at this node
+     * level.
+     *
+     * @return the world bound at this level.
+     */
+    public BoundingVolume getWorldBound() {
+        checkDoBoundUpdate();
+        return worldBound;
+    }
+
+    /**
+     * <code>setCullHint</code> alters how view frustum culling will treat this
+     * spatial.
+     *
+     * @param hint one of: <code>CullHint.Dynamic</code>,
+     * <code>CullHint.Always</code>, <code>CullHint.Inherit</code>, or
+     * <code>CullHint.Never</code>
+     * <p>
+     * The effect of the default value (CullHint.Inherit) may change if the
+     * spatial gets re-parented.
+     */
+    public void setCullHint(CullHint hint) {
+        cullHint = hint;
+    }
+
+    /**
+     * <code>setBatchHint</code> alters how batching will treat this spatial.
+     *
+     * @param hint one of: <code>BatchHint.Never</code>,
+     * <code>BatchHint.Always</code>, or <code>BatchHint.Inherit</code>
+     * <p>
+     * The effect of the default value (BatchHint.Inherit) may change if the
+     * spatial gets re-parented.
+     */
+    public void setBatchHint(BatchHint hint) {
+        batchHint = hint;
+    }
+
+    /**
+     * @return the cullmode set on this Spatial
+     */
+    public CullHint getLocalCullHint() {
+        return cullHint;
+    }
+
+    /**
+     * @return the batchHint set on this Spatial
+     */
+    public BatchHint getLocalBatchHint() {
+        return batchHint;
+    }
+
+    /**
+     * <code>setQueueBucket</code> determines at what phase of the
+     * rendering process this Spatial will rendered. See the
+     * {@link Bucket} enum for an explanation of the various 
+     * render queue buckets.
+     * 
+     * @param queueBucket
+     *            The bucket to use for this Spatial.
+     */
+    public void setQueueBucket(RenderQueue.Bucket queueBucket) {
+        this.queueBucket = queueBucket;
+    }
+
+    /**
+     * Sets the shadow mode of the spatial
+     * The shadow mode determines how the spatial should be shadowed,
+     * when a shadowing technique is used. See the
+     * documentation for the class {@link ShadowMode} for more information.
+     *
+     * @see ShadowMode
+     *
+     * @param shadowMode The local shadow mode to set.
+     */
+    public void setShadowMode(RenderQueue.ShadowMode shadowMode) {
+        this.shadowMode = shadowMode;
+    }
+
+    /**
+     * @return The locally set queue bucket mode
+     *
+     * @see Spatial#setQueueBucket(com.jme3.renderer.queue.RenderQueue.Bucket)
+     */
+    public RenderQueue.Bucket getLocalQueueBucket() {
+        return queueBucket;
+    }
+
+    /**
+     * @return The locally set shadow mode
+     *
+     * @see Spatial#setShadowMode(com.jme3.renderer.queue.RenderQueue.ShadowMode)
+     */
+    public RenderQueue.ShadowMode getLocalShadowMode() {
+        return shadowMode;
+    }
+
+    /**
+     * Returns this spatial's last frustum intersection result. This int is set
+     * when a check is made to determine if the bounds of the object fall inside
+     * a camera's frustum. If a parent is found to fall outside the frustum, the
+     * value for this spatial will not be updated.
+     *
+     * @return The spatial's last frustum intersection result.
+     */
+    public Camera.FrustumIntersect getLastFrustumIntersection() {
+        return frustrumIntersects;
+    }
+
+    /**
+     * Overrides the last intersection result. This is useful for operations
+     * that want to start rendering at the middle of a scene tree and don't want
+     * the parent of that node to influence culling.
+     *
+     * @param intersects
+     *            the new value
+     */
+    public void setLastFrustumIntersection(Camera.FrustumIntersect intersects) {
+        frustrumIntersects = intersects;
+    }
+
+    /**
+     * Returns the Spatial's name followed by the class of the spatial <br>
+     * Example: "MyNode (com.jme3.scene.Spatial)
+     *
+     * @return Spatial's name followed by the class of the Spatial
+     */
+    @Override
+    public String toString() {
+        return name + " (" + this.getClass().getSimpleName() + ')';
+    }
+
+    /**
+     * Creates a transform matrix that will convert from this spatials'
+     * local coordinate space to the world coordinate space
+     * based on the world transform.
+     *
+     * @param store Matrix where to store the result, if null, a new one
+     * will be created and returned.
+     *
+     * @return store if not null, otherwise, a new matrix containing the result.
+     *
+     * @see Spatial#getWorldTransform() 
+     */
+    public Matrix4f getLocalToWorldMatrix(Matrix4f store) {
+        if (store == null) {
+            store = new Matrix4f();
+        } else {
+            store.loadIdentity();
+        }
+        // multiply with scale first, then rotate, finally translate (cf.
+        // Eberly)
+        store.scale(getWorldScale());
+        store.multLocal(getWorldRotation());
+        store.setTranslation(getWorldTranslation());
+        return store;
+    }
+
+    /**
+     * Visit each scene graph element ordered by DFS
+     * @param visitor
+     */
+    public abstract void depthFirstTraversal(SceneGraphVisitor visitor);
+
+    /**
+     * Visit each scene graph element ordered by BFS
+     * @param visitor
+     */
+    public void breadthFirstTraversal(SceneGraphVisitor visitor) {
+        Queue<Spatial> queue = new LinkedList<Spatial>();
+        queue.add(this);
+
+        while (!queue.isEmpty()) {
+            Spatial s = queue.poll();
+            visitor.visit(s);
+            s.breadthFirstTraversal(visitor, queue);
+        }
+    }
+
+    protected abstract void breadthFirstTraversal(SceneGraphVisitor visitor, Queue<Spatial> queue);
+}

engine/src/core/com/jme3/scene/shape/Dome.java

@@ -250,7 +250,7 @@ public class Dome extends Mesh {
                 BufferUtils.populateFromBuffer(tempVa, vb, i);
                 kNormal = tempVa.subtractLocal(center);
                 kNormal.normalizeLocal();
-                if (insideView) {
+                if (!insideView) {
                     nb.put(kNormal.x).put(kNormal.y).put(kNormal.z);
                 } else {
                     nb.put(-kNormal.x).put(-kNormal.y).put(-kNormal.z);
@@ -267,7 +267,7 @@ public class Dome extends Mesh {
 
         // pole
         vb.put(center.x).put(center.y + radius).put(center.z);
-        nb.put(0).put(insideView ? 1 : -1).put(0);
+        nb.put(0).put(insideView ? -1 : 1).put(0);
         tb.put(0.5f).put(1.0f);
 
         // allocate connectivity

engine/src/core/com/jme3/shadow/AbstractShadowFilter.java

@@ -71,7 +71,7 @@ public abstract class AbstractShadowFilter<T extends AbstractShadowRenderer> ext
     @SuppressWarnings("all")
     protected AbstractShadowFilter(AssetManager manager, int shadowMapSize, T shadowRenderer) {
         super("Post Shadow");
-        material = new Material(manager, "Common/MatDefs/Shadow/PostShadowFilter.j3md");
+        material = new Material(manager, "Common/MatDefs/Shadow/PostShadowFilter.j3md");       
         this.shadowRenderer = shadowRenderer;
         this.shadowRenderer.setPostShadowMaterial(material);
     }
@@ -86,7 +86,7 @@ public abstract class AbstractShadowFilter<T extends AbstractShadowRenderer> ext
         return true;
     }
 
-    public Material getShadowMaterial() {
+    public Material getShadowMaterial() {       
         return material;
     }
     Vector4f tmpv = new Vector4f();
@@ -103,11 +103,17 @@ public abstract class AbstractShadowFilter<T extends AbstractShadowRenderer> ext
     @Override
     protected void postQueue(RenderQueue queue) {
         shadowRenderer.postQueue(queue);
+         if(shadowRenderer.skipPostPass){
+             //removing the shadow map so that the post pass is skipped
+             material.setTexture("ShadowMap0", null);
+         }
     }
 
     @Override
     protected void postFrame(RenderManager renderManager, ViewPort viewPort, FrameBuffer prevFilterBuffer, FrameBuffer sceneBuffer) {
-        shadowRenderer.setPostShadowParams();
+        if(!shadowRenderer.skipPostPass){
+            shadowRenderer.setPostShadowParams();
+        }
     }
 
     @Override

engine/src/core/com/jme3/shadow/AbstractShadowRenderer.java

@@ -92,18 +92,27 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable
     protected CompareMode shadowCompareMode = CompareMode.Hardware;
     protected Picture[] dispPic;
     protected boolean flushQueues = true;
-    // define if the fallback material should be used.
+    /**
+     * true if the fallback material should be used, otherwise false
+     */
     protected boolean needsfallBackMaterial = false;
-    //Name of the post material technique
+    /**
+     * name of the post material technique
+     */
     protected String postTechniqueName = "PostShadow";
-    //flags to know when to change params in the materials
-    //a list of material of the post shadow queue geometries.
+    /**
+     * list of materials for post shadow queue geometries
+     */
     protected List<Material> matCache = new ArrayList<Material>();
     protected GeometryList sceneReceivers;
     protected GeometryList lightReceivers = new GeometryList(new OpaqueComparator());
     protected GeometryList shadowMapOccluders = new GeometryList(new OpaqueComparator());
     private String[] shadowMapStringCache;
     private String[] lightViewStringCache;
+    /**
+     * true to skip the post pass when there are no shadow casters
+     */
+    protected boolean skipPostPass;
 
     
     /**
@@ -113,14 +122,13 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable
     }    
     
     /**
-     * Create an abstract shadow renderer, this is to be called in extending
-     * classes
+     * Create an abstract shadow renderer. Subclasses invoke this constructor.
      *
      * @param assetManager the application asset manager
-     * @param shadowMapSize the size of the rendered shadowmaps (512,1024,2048,
+     * @param shadowMapSize the size of the rendered shadow maps (512,1024,2048,
      * etc...)
      * @param nbShadowMaps the number of shadow maps rendered (the more shadow
-     * maps the more quality, the less fps).
+     * maps the more quality, the fewer fps).
      */
     protected AbstractShadowRenderer(AssetManager assetManager, int shadowMapSize, int nbShadowMaps) {
 
@@ -187,10 +195,10 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable
     }
 
     /**
-     * Sets the filtering mode for shadow edges see {@link EdgeFilteringMode}
-     * for more info
+     * Sets the filtering mode for shadow edges. See {@link EdgeFilteringMode}
+     * for more info.
      *
-     * @param EdgeFilteringMode
+     * @param filterMode the desired filter mode (not null)
      */
     final public void setEdgeFilteringMode(EdgeFilteringMode filterMode) {
         if (filterMode == null) {
@@ -214,7 +222,7 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable
     }
 
     /**
-     * returns the the edge filtering mode
+     * returns the edge filtering mode
      *
      * @see EdgeFilteringMode
      * @return
@@ -224,9 +232,9 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable
     }
 
     /**
-     * sets the shadow compare mode see {@link CompareMode} for more info
+     * Sets the shadow compare mode. See {@link CompareMode} for more info.
      *
-     * @param compareMode
+     * @param compareMode the desired compare mode (not null)
      */
     final public void setShadowCompareMode(CompareMode compareMode) {
         if (compareMode == null) {
@@ -263,7 +271,9 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable
         return shadowCompareMode;
     }
 
-    //debug function that create a displayable frustrum
+    /**
+     * debug function to create a visible frustum
+     */
     protected Geometry createFrustum(Vector3f[] pts, int i) {
         WireFrustum frustum = new WireFrustum(pts);
         Geometry frustumMdl = new Geometry("f", frustum);
@@ -294,6 +304,12 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable
         return frustumMdl;
     }
 
+    /**
+     * Initialize this shadow renderer prior to its first update.
+     *
+     * @param rm the render manager
+     * @param vp the viewport
+     */
     public void initialize(RenderManager rm, ViewPort vp) {
         renderManager = rm;
         viewPort = vp;
@@ -305,25 +321,31 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable
         }
     }
 
+    /**
+     * Test whether this shadow renderer has been initialized.
+     *
+     * @return true if initialized, otherwise false
+     */
     public boolean isInitialized() {
         return viewPort != null;
     }
 
     /**
-     * This mehtod is called once per frame. it is responsible for updating the
-     * shadow cams according to the light view.
-     *
+     * Invoked once per frame to update the shadow cams according to the light
+     * view.
+     * 
      * @param viewCam the scene cam
      */
     protected abstract void updateShadowCams(Camera viewCam);
 
     /**
-     * this method must return the geomtryList that contains the oclluders to be
+     * Returns a subclass-specific geometryList containing the occluders to be
      * rendered in the shadow map
      *
      * @param shadowMapIndex the index of the shadow map being rendered
      * @param sceneOccluders the occluders of the whole scene
-     * @param sceneReceivers the recievers of the whole scene
+     * @param sceneReceivers the receivers of the whole scene
+     * @param shadowMapOcculders
      * @return
      */
     protected abstract GeometryList getOccludersToRender(int shadowMapIndex, GeometryList sceneOccluders, GeometryList sceneReceivers, GeometryList shadowMapOccluders);
@@ -350,7 +372,9 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable
     public void postQueue(RenderQueue rq) {
         GeometryList occluders = rq.getShadowQueueContent(ShadowMode.Cast);
         sceneReceivers = rq.getShadowQueueContent(ShadowMode.Receive);
+        skipPostPass = false;
         if (sceneReceivers.size() == 0 || occluders.size() == 0) {
+            skipPostPass = true;
             return;
         }
 
@@ -401,7 +425,9 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable
         debugfrustums = true;
     }
 
-    //debug only : displays depth shadow maps
+    /**
+     * For debugging purposes, display depth shadow maps.
+     */
     protected void displayShadowMap(Renderer r) {
         Camera cam = viewPort.getCamera();
         renderManager.setCamera(cam, true);
@@ -417,8 +443,7 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable
     }
 
     /**
-     * For dubuging purpose Allow to "snapshot" the current frustrum to the
-     * scene
+     * For debugging purposes, "snapshot" the current frustum to the scene.
      */
     public void displayDebug() {
         debug = true;
@@ -427,7 +452,9 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable
     abstract GeometryList getReceivers(GeometryList sceneReceivers, GeometryList lightReceivers);
 
     public void postFrame(FrameBuffer out) {
-
+        if (skipPostPass) {
+            return;
+        }
         if (debug) {
             displayShadowMap(renderManager.getRenderer());
         }
@@ -463,10 +490,10 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable
     }
 
     /**
-     * This method is called once per frame and is responsible of setting the
-     * material parameters than sub class may need to set on the post material
+     * This method is called once per frame and is responsible for setting any
+     * material parameters than subclass may need to set on the post material.
      *
-     * @param material the materail to use for the post shadow pass
+     * @param material the material to use for the post shadow pass
      */
     protected abstract void setMaterialParameters(Material material);
 
@@ -537,7 +564,7 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable
     }
 
     /**
-     * returns the shdaow intensity
+     * Returns the shadow intensity.
      *
      * @see #setShadowIntensity(float shadowIntensity)
      * @return shadowIntensity
@@ -547,9 +574,9 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable
     }
 
     /**
-     * Set the shadowIntensity, the value should be between 0 and 1, a 0 value
-     * gives a bright and invisilble shadow, a 1 value gives a pitch black
-     * shadow, default is 0.7
+     * Set the shadowIntensity. The value should be between 0 and 1. A 0 value
+     * gives a bright and invisible shadow, a 1 value gives a pitch black
+     * shadow. The default is 0.7
      *
      * @param shadowIntensity the darkness of the shadow
      */
@@ -581,7 +608,7 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable
     }
 
     /**
-     * returns true if the PssmRenderer flushed the shadow queues
+     * Returns true if this shadow renderer flushes the shadow queues.
      *
      * @return flushQueues
      */
@@ -590,9 +617,9 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable
     }
 
     /**
-     * Set this to false if you want to use several PssmRederers to have
-     * multiple shadows cast by multiple light sources. Make sure the last
-     * PssmRenderer in the stack DO flush the queues, but not the others
+     * Set flushQueues to false if you have multiple shadow renderers, in order
+     * for multiple light sources to cast shadows. Make sure the last shadow
+     * renderer in the stack DOES flush the queues, but not the others.
      *
      * @param flushQueues
      */
@@ -600,11 +627,16 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable
         this.flushQueues = flushQueues;
     }
 
+    /**
+     * De-serialize this instance, for example when loading from a J3O file.
+     *
+     * @param im importer (not null)
+     */
     public void read(JmeImporter im) throws IOException {
         InputCapsule ic = (InputCapsule) im.getCapsule(this);
         assetManager = im.getAssetManager();
         nbShadowMaps = ic.readInt("nbShadowMaps", 1);
-        shadowMapSize = ic.readInt("shadowMapSize", 0);
+        shadowMapSize = ic.readFloat("shadowMapSize", 0f);
         shadowIntensity = ic.readFloat("shadowIntensity", 0.7f);
         edgeFilteringMode = ic.readEnum("edgeFilteringMode", EdgeFilteringMode.class, EdgeFilteringMode.Bilinear);
         shadowCompareMode = ic.readEnum("shadowCompareMode", CompareMode.class, CompareMode.Hardware);
@@ -615,6 +647,11 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable
 
     }
 
+    /**
+     * Serialize this instance, for example when saving to a J3O file.
+     *
+     * @param ex exporter (not null)
+     */
     public void write(JmeExporter ex) throws IOException {
         OutputCapsule oc = (OutputCapsule) ex.getCapsule(this);
         oc.write(nbShadowMaps, "nbShadowMaps", 1);
@@ -625,4 +662,4 @@ public abstract class AbstractShadowRenderer implements SceneProcessor, Savable
         oc.write(flushQueues, "flushQueues", false);
         oc.write(edgesThickness, "edgesThickness", 1.0f);
     }
-}
+}

engine/src/core/com/jme3/shadow/EdgeFilteringMode.java

@@ -57,8 +57,13 @@ public enum EdgeFilteringMode {
      */
     PCF4(3),
     /**
-     * 8x8 percentage-closer filtering is used. Shadows will be smoother at the
-     * cost of performance
+     * 12 samples percentage-closer filtering with a POISON disc distribution 
+     * is used. 
+     * http://devmag.org.za/2009/05/03/poisson-disk-sampling/
+     * The principle is to eliminate the regular blurring pattern that can be 
+     * seen with pcf4x4 by randomizing the samble position with a poisson disc.
+     * Shadows will look smoother than 4x4 PCF but with slightly better or 
+     * similar performance.
      */
     PCFPOISSON(4),
     /**

engine/src/core/com/jme3/system/JmeVersion.java

@@ -32,5 +32,5 @@
 package com.jme3.system;
 
 public class JmeVersion {
-    public static final String FULL_NAME = "jMonkeyEngine 3.0.5";
+    public static final String FULL_NAME = "jMonkeyEngine 3.0.6";
 }

engine/src/core/com/jme3/util/SkyFactory.java

@@ -1,245 +1,298 @@
-/*
- * Copyright (c) 2009-2012 jMonkeyEngine
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are
- * met:
- *
- * * Redistributions of source code must retain the above copyright
- *   notice, this list of conditions and the following disclaimer.
- *
- * * Redistributions in binary form must reproduce the above copyright
- *   notice, this list of conditions and the following disclaimer in the
- *   documentation and/or other materials provided with the distribution.
- *
- * * Neither the name of 'jMonkeyEngine' nor the names of its contributors
- *   may be used to endorse or promote products derived from this software
- *   without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
- * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
- * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
- * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
- * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
- * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
- * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
- * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
- * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- */
-package com.jme3.util;
-
-import com.jme3.asset.AssetManager;
-import com.jme3.asset.TextureKey;
-import com.jme3.bounding.BoundingSphere;
-import com.jme3.material.Material;
-import com.jme3.math.Vector3f;
-import com.jme3.renderer.queue.RenderQueue.Bucket;
-import com.jme3.scene.Geometry;
-import com.jme3.scene.Spatial;
-import com.jme3.scene.shape.Sphere;
-import com.jme3.texture.Image;
-import com.jme3.texture.Image.Format;
-import com.jme3.texture.Texture;
-import com.jme3.texture.TextureCubeMap;
-import java.nio.ByteBuffer;
-import java.util.ArrayList;
-
-/**
- * <code>SkyFactory</code> is used to create jME {@link Spatial}s that can
- * be attached to the scene to display a sky image in the background.
- * 
- * @author Kirill Vainer
- */
-public class SkyFactory {
-
-    /**
-     * Creates a sky using the given texture (cubemap or spheremap). 
-     * 
-     * @param assetManager The asset manager to use to load materials
-     * @param texture Texture to use for the sky
-     * @param normalScale The normal scale is multiplied by the 3D normal
-     * to get a texture coordinate. Use Vector3f.UNIT_XYZ to not apply 
-     * and transformation to the normal.
-     * @param sphereMap The way the texture is used
-     * depends on this value:<br>
-     * <ul>
-     * <li>true: Its a Texture2D with the pixels arranged for  
-     * <a href="http://en.wikipedia.org/wiki/Sphere_mapping">sphere mapping</a>.</li>
-     * <li>false: Its either a TextureCubeMap or Texture2D. If its a Texture2D
-     * then the image is taken from it and is inserted into a TextureCubeMap</li>
-     * </ul>
-     * @return A spatial representing the sky
-     */
-    public static Spatial createSky(AssetManager assetManager, Texture texture, Vector3f normalScale, boolean sphereMap) {
-        return createSky(assetManager, texture, normalScale, sphereMap, 10);
-    }
-
-    /**
-     * Creates a sky using the given texture (cubemap or spheremap). 
-     * 
-     * @param assetManager The asset manager to use to load materials
-     * @param texture Texture to use for the sky
-     * @param normalScale The normal scale is multiplied by the 3D normal
-     * to get a texture coordinate. Use Vector3f.UNIT_XYZ to not apply 
-     * and transformation to the normal.
-     * @param sphereMap The way the texture is used
-     * depends on this value:<br>
-     * <ul>
-     * <li>true: Its a Texture2D with the pixels arranged for  
-     * <a href="http://en.wikipedia.org/wiki/Sphere_mapping">sphere mapping</a>.</li>
-     * <li>false: Its either a TextureCubeMap or Texture2D. If its a Texture2D
-     * then the image is taken from it and is inserted into a TextureCubeMap</li>
-     * </ul>
-     * @param sphereRadius If specified, this will be the sky sphere's radius.
-     * This should be the camera's near plane for optimal quality.
-     * @return A spatial representing the sky
-     */
-    public static Spatial createSky(AssetManager assetManager, Texture texture, Vector3f normalScale, boolean sphereMap, int sphereRadius) {
-        if (texture == null) {
-            throw new IllegalArgumentException("texture cannot be null");
-        }
-        final Sphere sphereMesh = new Sphere(10, 10, sphereRadius, false, true);
-
-        Geometry sky = new Geometry("Sky", sphereMesh);
-        sky.setQueueBucket(Bucket.Sky);
-        sky.setCullHint(Spatial.CullHint.Never);
-        sky.setModelBound(new BoundingSphere(Float.POSITIVE_INFINITY, Vector3f.ZERO));
-
-        Material skyMat = new Material(assetManager, "Common/MatDefs/Misc/Sky.j3md");
-
-        skyMat.setVector3("NormalScale", normalScale);
-        if (sphereMap) {
-            skyMat.setBoolean("SphereMap", sphereMap);
-        } else if (!(texture instanceof TextureCubeMap)) {
-            // make sure its a cubemap
-            Image img = texture.getImage();
-            texture = new TextureCubeMap();
-            texture.setImage(img);
-        }
-        skyMat.setTexture("Texture", texture);
-        sky.setMaterial(skyMat);
-
-        return sky;
-    }
-
-    private static void checkImage(Image image) {
-//        if (image.getDepth() != 1)
-//            throw new IllegalArgumentException("3D/Array images not allowed");
-
-        if (image.getWidth() != image.getHeight()) {
-            throw new IllegalArgumentException("Image width and height must be the same");
-        }
-
-        if (image.getMultiSamples() != 1) {
-            throw new IllegalArgumentException("Multisample textures not allowed");
-        }
-    }
-
-    private static void checkImagesForCubeMap(Image... images) {
-        if (images.length == 1) {
-            return;
-        }
-
-        Format fmt = images[0].getFormat();
-        int width = images[0].getWidth();
-        int height = images[0].getHeight();
-        
-        ByteBuffer data = images[0].getData(0);
-        int size = data != null ? data.capacity() : 0;
-
-        checkImage(images[0]);
-
-        for (int i = 1; i < images.length; i++) {
-            Image image = images[i];
-            checkImage(images[i]);
-            if (image.getFormat() != fmt) {
-                throw new IllegalArgumentException("Images must have same format");
-            }
-            if (image.getWidth() != width || image.getHeight() != height)  {
-                throw new IllegalArgumentException("Images must have same resolution");
-            }
-            ByteBuffer data2 = image.getData(0);
-            if (data2 != null){
-                if (data2.capacity() != size) {
-                    throw new IllegalArgumentException("Images must have same size");
-                }
-            }
-        }
-    }
-
-    public static Spatial createSky(AssetManager assetManager, Texture west, Texture east, Texture north, Texture south, Texture up, Texture down, Vector3f normalScale) {
-        return createSky(assetManager, west, east, north, south, up, down, normalScale, 10);
-    }
-
-    public static Spatial createSky(AssetManager assetManager, Texture west, Texture east, Texture north, Texture south, Texture up, Texture down, Vector3f normalScale, int sphereRadius) {
-        final Sphere sphereMesh = new Sphere(10, 10, sphereRadius, false, true);
-        Geometry sky = new Geometry("Sky", sphereMesh);
-        sky.setQueueBucket(Bucket.Sky);
-        sky.setCullHint(Spatial.CullHint.Never);
-        sky.setModelBound(new BoundingSphere(Float.POSITIVE_INFINITY, Vector3f.ZERO));
-
-        Image westImg = west.getImage();
-        Image eastImg = east.getImage();
-        Image northImg = north.getImage();
-        Image southImg = south.getImage();
-        Image upImg = up.getImage();
-        Image downImg = down.getImage();
-
-        checkImagesForCubeMap(westImg, eastImg, northImg, southImg, upImg, downImg);
-
-        Image cubeImage = new Image(westImg.getFormat(), westImg.getWidth(), westImg.getHeight(), null);
-
-        cubeImage.addData(westImg.getData(0));
-        cubeImage.addData(eastImg.getData(0));
-
-        cubeImage.addData(downImg.getData(0));
-        cubeImage.addData(upImg.getData(0));
-
-        cubeImage.addData(southImg.getData(0));
-        cubeImage.addData(northImg.getData(0));
-        
-        if (westImg.getEfficentData() != null){
-            // also consilidate efficient data
-            ArrayList<Object> efficientData = new ArrayList<Object>(6);
-            efficientData.add(westImg.getEfficentData());
-            efficientData.add(eastImg.getEfficentData());
-            efficientData.add(downImg.getEfficentData());
-            efficientData.add(upImg.getEfficentData());
-            efficientData.add(southImg.getEfficentData());
-            efficientData.add(northImg.getEfficentData());
-            cubeImage.setEfficentData(efficientData);
-        }
-
-        TextureCubeMap cubeMap = new TextureCubeMap(cubeImage);
-        cubeMap.setAnisotropicFilter(0);
-        cubeMap.setMagFilter(Texture.MagFilter.Bilinear);
-        cubeMap.setMinFilter(Texture.MinFilter.NearestNoMipMaps);
-        cubeMap.setWrap(Texture.WrapMode.EdgeClamp);
-
-        Material skyMat = new Material(assetManager, "Common/MatDefs/Misc/Sky.j3md");
-        skyMat.setTexture("Texture", cubeMap);
-        skyMat.setVector3("NormalScale", normalScale);
-        sky.setMaterial(skyMat);
-
-        return sky;
-    }
-
-    public static Spatial createSky(AssetManager assetManager, Texture west, Texture east, Texture north, Texture south, Texture up, Texture down) {
-        return createSky(assetManager, west, east, north, south, up, down, Vector3f.UNIT_XYZ);
-    }
-
-    public static Spatial createSky(AssetManager assetManager, Texture texture, boolean sphereMap) {
-        return createSky(assetManager, texture, Vector3f.UNIT_XYZ, sphereMap);
-    }
-
-    public static Spatial createSky(AssetManager assetManager, String textureName, boolean sphereMap) {
-        TextureKey key = new TextureKey(textureName, true);
-        key.setGenerateMips(true);
-        key.setAsCube(!sphereMap);
-        Texture tex = assetManager.loadTexture(key);
-        return createSky(assetManager, tex, sphereMap);
-    }
-}
+/*
+ * Copyright (c) 2009-2012 jMonkeyEngine
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ *
+ * * Redistributions of source code must retain the above copyright
+ *   notice, this list of conditions and the following disclaimer.
+ *
+ * * Redistributions in binary form must reproduce the above copyright
+ *   notice, this list of conditions and the following disclaimer in the
+ *   documentation and/or other materials provided with the distribution.
+ *
+ * * Neither the name of 'jMonkeyEngine' nor the names of its contributors
+ *   may be used to endorse or promote products derived from this software
+ *   without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+ * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+ * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+ * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+ * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+ * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+ * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+ * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+package com.jme3.util;
+
+import com.jme3.asset.AssetManager;
+import com.jme3.asset.TextureKey;
+import com.jme3.bounding.BoundingSphere;
+import com.jme3.material.Material;
+import com.jme3.math.Vector3f;
+import com.jme3.renderer.queue.RenderQueue.Bucket;
+import com.jme3.scene.Geometry;
+import com.jme3.scene.Spatial;
+import com.jme3.scene.shape.Sphere;
+import com.jme3.texture.Image;
+import com.jme3.texture.Image.Format;
+import com.jme3.texture.Texture;
+import com.jme3.texture.TextureCubeMap;
+import java.nio.ByteBuffer;
+import java.util.ArrayList;
+
+/**
+ * <code>SkyFactory</code> is used to create jME {@link Spatial}s that can
+ * be attached to the scene to display a sky image in the background.
+ * 
+ * @author Kirill Vainer
+ */
+public class SkyFactory {
+
+    /**
+     * Create a sky with radius=10 using the given cubemap or spheremap texture.
+     *
+     * For the sky to be visible, its radius must fall between the near and far
+     * planes of the camera's frustrum.
+     *
+     * @param assetManager from which to load materials
+     * @param texture to use
+     * @param normalScale The normal scale is multiplied by the 3D normal to get
+     * a texture coordinate. Use Vector3f.UNIT_XYZ to not apply and
+     * transformation to the normal.
+     * @param sphereMap determines how the texture is used:<br>
+     * <ul>
+     * <li>true: The texture is a Texture2D with the pixels arranged for
+     * <a href="http://en.wikipedia.org/wiki/Sphere_mapping">sphere
+     * mapping</a>.</li>
+     * <li>false: The texture is either a TextureCubeMap or Texture2D. If it is
+     * a Texture2D then the image is taken from it and is inserted into a
+     * TextureCubeMap</li>
+     * </ul>
+     * @return a new spatial representing the sky, ready to be attached to the
+     * scene graph
+     */
+    public static Spatial createSky(AssetManager assetManager, Texture texture,
+            Vector3f normalScale, boolean sphereMap) {
+        return createSky(assetManager, texture, normalScale, sphereMap, 10);
+    }
+
+    /**
+     * Create a sky using the given cubemap or spheremap texture.
+     *
+     * @param assetManager from which to load materials
+     * @param texture to use
+     * @param normalScale The normal scale is multiplied by the 3D normal to get
+     * a texture coordinate. Use Vector3f.UNIT_XYZ to not apply and
+     * transformation to the normal.
+     * @param sphereMap determines how the texture is used:<br>
+     * <ul>
+     * <li>true: The texture is a Texture2D with the pixels arranged for
+     * <a href="http://en.wikipedia.org/wiki/Sphere_mapping">sphere
+     * mapping</a>.</li>
+     * <li>false: The texture is either a TextureCubeMap or Texture2D. If it is
+     * a Texture2D then the image is taken from it and is inserted into a
+     * TextureCubeMap</li>
+     * </ul>
+     * @param sphereRadius the sky sphere's radius: for the sky to be visible,
+     * its radius must fall between the near and far planes of the camera's
+     * frustrum
+     * @return a new spatial representing the sky, ready to be attached to the
+     * scene graph
+     */
+    public static Spatial createSky(AssetManager assetManager, Texture texture,
+            Vector3f normalScale, boolean sphereMap, int sphereRadius) {
+        if (texture == null) {
+            throw new IllegalArgumentException("texture cannot be null");
+        }
+        final Sphere sphereMesh = new Sphere(10, 10, sphereRadius, false, true);
+
+        Geometry sky = new Geometry("Sky", sphereMesh);
+        sky.setQueueBucket(Bucket.Sky);
+        sky.setCullHint(Spatial.CullHint.Never);
+        sky.setModelBound(new BoundingSphere(Float.POSITIVE_INFINITY, Vector3f.ZERO));
+
+        Material skyMat = new Material(assetManager, "Common/MatDefs/Misc/Sky.j3md");
+
+        skyMat.setVector3("NormalScale", normalScale);
+        if (sphereMap) {
+            skyMat.setBoolean("SphereMap", sphereMap);
+        } else if (!(texture instanceof TextureCubeMap)) {
+            // make sure its a cubemap
+            Image img = texture.getImage();
+            texture = new TextureCubeMap();
+            texture.setImage(img);
+        }
+        skyMat.setTexture("Texture", texture);
+        sky.setMaterial(skyMat);
+
+        return sky;
+    }
+
+    private static void checkImage(Image image) {
+//        if (image.getDepth() != 1)
+//            throw new IllegalArgumentException("3D/Array images not allowed");
+
+        if (image.getWidth() != image.getHeight()) {
+            throw new IllegalArgumentException("Image width and height must be the same");
+        }
+
+        if (image.getMultiSamples() != 1) {
+            throw new IllegalArgumentException("Multisample textures not allowed");
+        }
+    }
+
+    private static void checkImagesForCubeMap(Image... images) {
+        if (images.length == 1) {
+            return;
+        }
+
+        Format fmt = images[0].getFormat();
+        int width = images[0].getWidth();
+        int height = images[0].getHeight();
+        
+        ByteBuffer data = images[0].getData(0);
+        int size = data != null ? data.capacity() : 0;
+
+        checkImage(images[0]);
+
+        for (int i = 1; i < images.length; i++) {
+            Image image = images[i];
+            checkImage(images[i]);
+            if (image.getFormat() != fmt) {
+                throw new IllegalArgumentException("Images must have same format");
+            }
+            if (image.getWidth() != width || image.getHeight() != height)  {
+                throw new IllegalArgumentException("Images must have same resolution");
+            }
+            ByteBuffer data2 = image.getData(0);
+            if (data2 != null){
+                if (data2.capacity() != size) {
+                    throw new IllegalArgumentException("Images must have same size");
+                }
+            }
+        }
+    }
+
+    /**
+     * Create a cube-mapped sky with radius=10 using six textures.
+     *
+     * For the sky to be visible, its radius must fall between the near and far
+     * planes of the camera's frustrum.
+     *
+     * @param assetManager from which to load materials
+     * @param west texture for the western face of the cube
+     * @param east texture for the eastern face of the cube
+     * @param north texture for the northern face of the cube
+     * @param south texture for the southern face of the cube
+     * @param up texture for the top face of the cube
+     * @param down texture for the bottom face of the cube
+     * @param normalScale The normal scale is multiplied by the 3D normal to get
+     * a texture coordinate. Use Vector3f.UNIT_XYZ to not apply and
+     * transformation to the normal.
+     * @return a new spatial representing the sky, ready to be attached to the
+     * scene graph
+     */
+    public static Spatial createSky(AssetManager assetManager, Texture west,
+            Texture east, Texture north, Texture south, Texture up,
+            Texture down, Vector3f normalScale) {
+        return createSky(assetManager, west, east, north, south, up, down,
+                normalScale, 10);
+    }
+
+    /**
+     * Create a cube-mapped sky using six textures.
+     *
+     * @param assetManager from which to load materials
+     * @param west texture for the western face of the cube
+     * @param east texture for the eastern face of the cube
+     * @param north texture for the northern face of the cube
+     * @param south texture for the southern face of the cube
+     * @param up texture for the top face of the cube
+     * @param down texture for the bottom face of the cube
+     * @param normalScale The normal scale is multiplied by the 3D normal to get
+     * a texture coordinate. Use Vector3f.UNIT_XYZ to not apply and
+     * transformation to the normal.
+     * @param sphereRadius the sky sphere's radius: for the sky to be visible,
+     * its radius must fall between the near and far planes of the camera's
+     * frustrum
+     * @return a new spatial representing the sky, ready to be attached to the
+     * scene graph
+     */
+    public static Spatial createSky(AssetManager assetManager, Texture west,
+            Texture east, Texture north, Texture south, Texture up,
+            Texture down, Vector3f normalScale, float sphereRadius) {
+        final Sphere sphereMesh = new Sphere(10, 10, sphereRadius, false, true);
+        Geometry sky = new Geometry("Sky", sphereMesh);
+        sky.setQueueBucket(Bucket.Sky);
+        sky.setCullHint(Spatial.CullHint.Never);
+        sky.setModelBound(new BoundingSphere(Float.POSITIVE_INFINITY, Vector3f.ZERO));
+
+        Image westImg = west.getImage();
+        Image eastImg = east.getImage();
+        Image northImg = north.getImage();
+        Image southImg = south.getImage();
+        Image upImg = up.getImage();
+        Image downImg = down.getImage();
+
+        checkImagesForCubeMap(westImg, eastImg, northImg, southImg, upImg, downImg);
+
+        Image cubeImage = new Image(westImg.getFormat(), westImg.getWidth(), westImg.getHeight(), null);
+
+        cubeImage.addData(westImg.getData(0));
+        cubeImage.addData(eastImg.getData(0));
+
+        cubeImage.addData(downImg.getData(0));
+        cubeImage.addData(upImg.getData(0));
+
+        cubeImage.addData(southImg.getData(0));
+        cubeImage.addData(northImg.getData(0));
+        
+        if (westImg.getEfficentData() != null){
+            // also consilidate efficient data
+            ArrayList<Object> efficientData = new ArrayList<Object>(6);
+            efficientData.add(westImg.getEfficentData());
+            efficientData.add(eastImg.getEfficentData());
+            efficientData.add(downImg.getEfficentData());
+            efficientData.add(upImg.getEfficentData());
+            efficientData.add(southImg.getEfficentData());
+            efficientData.add(northImg.getEfficentData());
+            cubeImage.setEfficentData(efficientData);
+        }
+
+        TextureCubeMap cubeMap = new TextureCubeMap(cubeImage);
+        cubeMap.setAnisotropicFilter(0);
+        cubeMap.setMagFilter(Texture.MagFilter.Bilinear);
+        cubeMap.setMinFilter(Texture.MinFilter.NearestNoMipMaps);
+        cubeMap.setWrap(Texture.WrapMode.EdgeClamp);
+
+        Material skyMat = new Material(assetManager, "Common/MatDefs/Misc/Sky.j3md");
+        skyMat.setTexture("Texture", cubeMap);
+        skyMat.setVector3("NormalScale", normalScale);
+        sky.setMaterial(skyMat);
+
+        return sky;
+    }
+
+    public static Spatial createSky(AssetManager assetManager, Texture west, Texture east, Texture north, Texture south, Texture up, Texture down) {
+        return createSky(assetManager, west, east, north, south, up, down, Vector3f.UNIT_XYZ);
+    }
+
+    public static Spatial createSky(AssetManager assetManager, Texture texture, boolean sphereMap) {
+        return createSky(assetManager, texture, Vector3f.UNIT_XYZ, sphereMap);
+    }
+
+    public static Spatial createSky(AssetManager assetManager, String textureName, boolean sphereMap) {
+        TextureKey key = new TextureKey(textureName, true);
+        key.setGenerateMips(true);
+        key.setAsCube(!sphereMap);
+        Texture tex = assetManager.loadTexture(key);
+        return createSky(assetManager, tex, sphereMap);
+    }
+}

engine/src/desktop/com/jme3/cursors/plugins/CursorLoader.java

@@ -41,6 +41,7 @@ import java.awt.image.AffineTransformOp;
 import java.awt.image.BufferedImage;
 import java.awt.image.DataBufferInt;
 import java.io.ByteArrayInputStream;
+import java.io.ByteArrayOutputStream;
 import java.io.DataInput;
 import java.io.DataInputStream;
 import java.io.IOException;
@@ -210,13 +211,13 @@ public class CursorLoader implements AssetLoader {
             }
         } else if (isIco) {
             DataInputStream in = new DataInputStream(inStream);
-            int bytesToRead;
-            while ((bytesToRead = in.available()) != 0) {
-                byte[] icoimage2 = new byte[icoimages.length + bytesToRead];
-                System.arraycopy(icoimages, 0, icoimage2, 0, icoimages.length);
-                in.read(icoimage2, icoimages.length, bytesToRead);
-                icoimages = icoimage2;
+            ByteArrayOutputStream out = new ByteArrayOutputStream();
+            byte[] buffer = new byte[16384];
+            int bytesRead;
+            while ((bytesRead = in.read(buffer)) >= 0) {
+                out.write(buffer, 0, bytesRead);
             }
+            icoimages = out.toByteArray();
         }
 
         BufferedImage bi[] = parseICOImage(icoimages);

engine/src/desktop/com/jme3/system/Natives.java

@@ -85,6 +85,7 @@ public final class Natives {
     }
 
     private static int computeNativesHash() {
+        URLConnection conn = null;
         try {
             String classpath = System.getProperty("java.class.path");
             URL url = Thread.currentThread().getContextClassLoader().getResource("com/jme3/system/Natives.class");
@@ -101,11 +102,18 @@ public final class Natives {
                 throw new UnsupportedOperationException(ex);
             }
 
-            URLConnection conn = url.openConnection();
+            conn = url.openConnection();
             int hash = classpath.hashCode() ^ (int) conn.getLastModified();
             return hash;
         } catch (IOException ex) {
             throw new UnsupportedOperationException(ex);
+        } finally {
+            if (conn != null) {
+                try {
+                    conn.getInputStream().close();
+                    conn.getOutputStream().close();
+                } catch (IOException ex) { }
+            }
         }
     }
 
@@ -233,7 +241,7 @@ public final class Natives {
 
         String libraryPath = getExtractionDir().toString();
         if (needLWJGL) {
-            logger.log(Level.FINE, "Extraction Directory: {0}", getExtractionDir().toString());
+            logger.log(Level.INFO, "Extraction Directory: {0}", getExtractionDir().toString());
 
             // LWJGL supports this feature where
             // it can load libraries from this path.

engine/src/lwjgl/com/jme3/renderer/lwjgl/LwjglRenderer.java

@@ -490,14 +490,31 @@ public class LwjglRenderer implements Renderer {
             context.depthTestEnabled = false;
         }
 
-        if (state.isAlphaTest() && context.alphaTestFallOff == 0) {
+        if (state.isAlphaTest() && !context.alphaTestEnabled) {
             glEnable(GL_ALPHA_TEST);
+<<<<<<< .working
             glAlphaFunc(GL_GREATER, state.getAlphaFallOff());
             context.alphaTestFallOff = state.getAlphaFallOff();
         } else if (!state.isAlphaTest() && context.alphaTestFallOff != 0) {
+=======
+            glAlphaFunc(convertTestFunction(context.alphaFunc), context.alphaTestFallOff);
+            context.alphaTestEnabled = true;
+        } else if (!state.isAlphaTest() && context.alphaTestEnabled) {
+>>>>>>> .merge-right.r10938
             glDisable(GL_ALPHA_TEST);
-            context.alphaTestFallOff = 0;
+            context.alphaTestEnabled = false;
         }
+<<<<<<< .working
+=======
+        if (state.getAlphaFallOff() != context.alphaTestFallOff) {
+            glAlphaFunc(convertTestFunction(context.alphaFunc), context.alphaTestFallOff);   
+            context.alphaTestFallOff = state.getAlphaFallOff();
+        }         
+        if (state.getAlphaFunc() != context.alphaFunc) {
+            glAlphaFunc(convertTestFunction(state.getAlphaFunc()), context.alphaTestFallOff);
+            context.alphaFunc = state.getAlphaFunc();
+        }
+>>>>>>> .merge-right.r10938
 
         if (state.isDepthWrite() && !context.depthWriteEnabled) {
             glDepthMask(true);
@@ -1762,6 +1779,7 @@ public class LwjglRenderer implements Renderer {
             case ThreeDimensional:
             case CubeMap: // cubemaps use 3D coords
                 glTexParameteri(target, GL_TEXTURE_WRAP_R, convertWrapMode(tex.getWrap(WrapAxis.R)));
+                //There is no break statement on purpose here
             case TwoDimensional:
             case TwoDimensionalArray:
                 glTexParameteri(target, GL_TEXTURE_WRAP_T, convertWrapMode(tex.getWrap(WrapAxis.T)));

engine/src/niftygui/com/jme3/niftygui/InputSystemJme.java

@@ -130,7 +130,42 @@ public class InputSystemJme implements InputSystem, RawInputListener {
             //System.out.format("niftyMouse(%d, %d, %d, true) = %b\n", x, y, button, consumed);
         } else {
             // Forward the event if nifty owns it or if the cursor is visible.
-            if (niftyOwnsDragging[button] || inputManager.isCursorVisible()){
+            //
+            // 2013-10-06: void256 was here and changed stuff ;-) Explanation:
+            //
+            // Currently Nifty remembers any mouse down event internally as "mouse button now down" regardless of it
+            // hitting a Nifty element. As long as it does not receive a mouse up event, Nifty will think of the mouse
+            // button as being pressed.
+            //
+            // The original code:
+            // -> if (niftyOwnsDragging[button] || inputManager.isCursorVisible()){
+            //
+            // forwarded mouse up events to Nifty when:
+            // a) Nifty owns dragging, e.g. there was a mouse down event that actually hit a Nifty element before OR
+            // b) when the jme mouse cursor is visible.
+            //
+            // That's ok but the "Nifty remembers the mouse down event" thing had the following consequences in one
+            // special case:
+            // 1) You click on the jme scene (not Nifty) and Nifty will correctly return false (event not consumed) but
+            //    internally it remembers: "mouse button is now down". Note that the jme mouse cursor is now hidden.
+            // 2) You release the mouse button but the mouse down event will not be forwarded to Nifty because it did
+            //    owned the mouse and the jme mouse cursor is not visible.
+            //
+            // Nifty now still thinks that the mouse button is down although it's not. The result is that the next click
+            // on any Nifty element will not be recognized as an initial click by Nifty. So you need an additional click
+            // on the Nifty element to activate it correctly. In case of drag and drop this additional click was quite
+            // irritating.
+            //
+            // To fix that we'll now forward the mouse button up event ALWAYS to Nifty regardless of it owning the mouse
+            // or the jme mouse cursor visibility.
+            //
+            // Please note: Compared to the original version a side effect is that jme will now always send mouse move
+            // events to Nifty even when the mouse cursor is hidden. So in theory it could happen that input events are
+            // handled by both: jme and Nifty when f.i. you move around your scene with the mouse cursor hidden and that
+            // invisible cursor is moved over some Nifty element. I've not been able to reproduce that case though,
+            // which is good ;-) If that ever happens to someone there is an easy fix possible:
+            // nifty.setIgnoreMouseEvents() to completely stop Nifty from processing events.
+
                 boolean consumed = nic.processMouseEvent(x, y, 0, button, false);
 
                 // Only consume event if it ORIGINATED in nifty!
@@ -138,7 +173,7 @@ public class InputSystemJme implements InputSystem, RawInputListener {
                     evt.setConsumed();
                     processSoftKeyboard();
                 }
-            }
+
             niftyOwnsDragging[button] = false;
             //System.out.format("niftyMouse(%d, %d, %d, false) = %b\n", x, y, button, consumed);
         }

engine/src/terrain/com/jme3/terrain/heightmap/AbstractHeightMap.java

@@ -253,9 +253,12 @@ public abstract class AbstractHeightMap implements HeightMap {
             throw new Exception("Filename must not be null");
         }
         //open the streams and send the height data to the file.
+        FileOutputStream fos = null;
+        DataOutputStream dos = null;
         try {
-            FileOutputStream fos = new FileOutputStream(filename);
-            DataOutputStream dos = new DataOutputStream(fos);
+            fos = new FileOutputStream(filename);
+            dos = new DataOutputStream(fos);
+            
             for (int i = 0; i < size; i++) {
                 for (int j = 0; j < size; j++) {
                     dos.write((int) heightData[j + (i * size)]);
@@ -270,6 +273,13 @@ public abstract class AbstractHeightMap implements HeightMap {
         } catch (IOException e) {
             logger.log(Level.WARNING, "Error writing to file {0}", filename);
             return false;
+        } finally {
+            if (fos != null) {
+                fos.close();
+            }
+            if (dos != null) {
+                dos.close();
+            }
         }
 
         logger.log(Level.FINE, "Saved terrain to {0}", filename);

engine/src/test/jme3test/audio/TestMusicStreaming.java

@@ -47,6 +47,8 @@ public class TestMusicStreaming extends SimpleApplication {
     public void simpleInitApp(){
         assetManager.registerLocator("http://www.vorbis.com/music/", UrlLocator.class);
         AudioNode audioSource = new AudioNode(assetManager, "Lumme-Badloop.ogg", true);
+        audioSource.setPositional(false);
+        audioSource.setReverbEnabled(false);
         audioSource.play();
     }
 

sdk/jme3-blender/src/com/jme3/gde/blender/filetypes/BlenderFbxDataObject.java

@@ -83,7 +83,7 @@ public class BlenderFbxDataObject extends AbstractBlenderImportDataObject {
 
     public BlenderFbxDataObject(FileObject pf, MultiFileLoader loader) throws DataObjectExistsException, IOException {
         super(pf, loader);
-        SUFFIX = "3ds";
+        SUFFIX = "fbx";
 //        registerEditor("application/fbx", false);
     }
 //    @Override

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/3d_models.html

@@ -83,7 +83,7 @@ To export your models as Ogre <acronym title="Extensible Markup Language">XML</a
 
 <p>
 
-You can now use the <a href="/com/jme3/gde/docs/sdk.html">jMonkeyEngine SDK</a> to <a href="/com/jme3/gde/docs/sdk/model_loader_and_viewer.html">load and view models</a>. You can <a href="/com/jme3/gde/docs/sdk/scene_composer.html">create scenes</a> from them and write cde that loads them into your application. 
+You can now use the <a href="/com/jme3/gde/docs/sdk.html">jMonkeyEngine SDK</a> to <a href="/com/jme3/gde/docs/sdk/model_loader_and_viewer.html">load and view models</a>. You can <a href="/com/jme3/gde/docs/sdk/scene_composer.html">create scenes</a> from them and write code that loads them into your application. 
 </p>
 
 </div>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/application_states.html

@@ -4,16 +4,16 @@
 
 <p>
 
-The <code>com.jme3.app.state.AppState</code> class is a customizable jME3 interface that allows you to control the global game logic ??? the overall game mechanics. (To control the behaviour of a Spatial, see <a href="/com/jme3/gde/docs/jme3/advanced/custom_controls.html">Custom Controls</a> instead. Controls and AppStates can be used together.)
+The <code>com.jme3.app.state.AppState</code> class is a customizable jME3 interface that allows you to control the global game logic, the overall game mechanics. (To control the behaviour of a Spatial, see <a href="/com/jme3/gde/docs/jme3/advanced/custom_controls.html">Custom Controls</a> instead. Controls and AppStates can be used together.)
 </p>
 
 </div>
-<!-- EDIT1 SECTION "Application States" [1-324] -->
+<!-- EDIT1 SECTION "Application States" [1-322] -->
 <h2><a>Overview</a></h2>
 <div>
 
 </div>
-<!-- EDIT2 SECTION "Overview" [325-346] -->
+<!-- EDIT2 SECTION "Overview" [323-344] -->
 <h3><a>Use Case Examples</a></h3>
 <div>
 
@@ -56,7 +56,7 @@ You can! This is what AppStates are there for. An AppState class is subset of (o
 </ul>
 
 </div>
-<!-- EDIT3 SECTION "Use Case Examples" [347-2034] -->
+<!-- EDIT3 SECTION "Use Case Examples" [345-2032] -->
 <h3><a>Supported Features</a></h3>
 <div>
 
@@ -86,7 +86,7 @@ Each AppState has its own update loop, which hooks into the main simpleUpdate()
 </p>
 
 </div>
-<!-- EDIT4 SECTION "Supported Features" [2035-3763] -->
+<!-- EDIT4 SECTION "Supported Features" [2033-3761] -->
 <h3><a>Usage</a></h3>
 <div>
 
@@ -109,7 +109,7 @@ To implement game logic:
 </li>
 <li><div> Enable and disable (unpause and pause) the AppStates that you need during the game.</div>
 </li>
-<li><div> Detach the AppState from the AppStateManager (<code>stateManager.detach(myAppState);</code>) and clean it up it.</div>
+<li><div> Detach the AppState from the AppStateManager (<code>stateManager.detach(myAppState);</code>) and clean it up.</div>
 </li>
 </ol>
 
@@ -119,7 +119,7 @@ When you add several AppStates to one Application and activate them, their initi
 </p>
 
 </div>
-<!-- EDIT5 SECTION "Usage" [3764-4625] -->
+<!-- EDIT5 SECTION "Usage" [3762-4620] -->
 <h3><a>Code Samples</a></h3>
 <div>
 
@@ -139,7 +139,7 @@ JME3 comes with a BulletAppState that implements Physical behaviour (using the j
 </ul>
 
 </div>
-<!-- EDIT6 SECTION "Code Samples" [4626-5406] -->
+<!-- EDIT6 SECTION "Code Samples" [4621-5401] -->
 <h2><a>AppState</a></h2>
 <div>
 
@@ -184,9 +184,9 @@ stateDetached(asm)</td><td>The AppState knows when it is attached to, or detache
 		<td>postRender()</td><td>Called after all rendering commands are flushed, including your optional customizations. (Typically not used.)</td>
 	</tr>
 </table></div>
-<!-- EDIT8 TABLE [5555-7117] -->
+<!-- EDIT8 TABLE [5550-7112] -->
 </div>
-<!-- EDIT7 SECTION "AppState" [5407-7118] -->
+<!-- EDIT7 SECTION "AppState" [5402-7113] -->
 <h2><a>AbstractAppState</a></h2>
 <div>
 
@@ -249,7 +249,7 @@ Definition:
 &#125;</pre>
 
 </div>
-<!-- EDIT9 SECTION "AbstractAppState" [7119-9291] -->
+<!-- EDIT9 SECTION "AbstractAppState" [7114-9286] -->
 <h2><a>Pausing and Unpausing</a></h2>
 <div>
 
@@ -259,7 +259,7 @@ You define what an AppState does when Paused or Unpaused, in the <code>setEnable
 </p>
 
 </div>
-<!-- EDIT10 SECTION "Pausing and Unpausing" [9292-9582] -->
+<!-- EDIT10 SECTION "Pausing and Unpausing" [9287-9577] -->
 <h2><a>AppStateManager</a></h2>
 <div>
 
@@ -279,7 +279,7 @@ The com.jme3.app.state.AppStateManager holds the list of AppStates for an applic
 		<td>getState(MyAppState.class)</td><td>Returns the first attached state that is an instance of a subclass of <code>MyAppState.class</code>.</td>
 	</tr>
 </table></div>
-<!-- EDIT12 TABLE [9990-10200] -->
+<!-- EDIT12 TABLE [9985-10195] -->
 <p>
 
 The AppStateManager&#039;s <code>render(), postRender(), cleanup()</code> methods are internal, ignore them, users never call them directly.
@@ -299,12 +299,12 @@ The AppStateManager&#039;s <code>render(), postRender(), cleanup()</code> method
 </ul>
 
 </div>
-<!-- EDIT11 SECTION "AppStateManager" [9583-10966] -->
+<!-- EDIT11 SECTION "AppStateManager" [9578-10961] -->
 <h2><a>Best Practices</a></h2>
 <div>
 
 </div>
-<!-- EDIT13 SECTION "Best Practices" [10967-10994] -->
+<!-- EDIT13 SECTION "Best Practices" [10962-10989] -->
 <h3><a>Communication Among AppStates</a></h3>
 <div>
 
@@ -320,7 +320,7 @@ You can use custom accessors to get data from AppStates, to set data in AppState
 <pre>this.app.getStateManager&#40;&#41;.getState&#40;MyAppState.class&#41;.doSomeCustomStuffInThisState&#40;&#41;;</pre>
 
 </div>
-<!-- EDIT14 SECTION "Communication Among AppStates" [10995-11750] -->
+<!-- EDIT14 SECTION "Communication Among AppStates" [10990-11745] -->
 <h3><a>Initialize Familiar Class Fields</a></h3>
 <div>
 
@@ -351,5 +351,5 @@ public class MyAppState extends AbstractAppState &#123;
 &#125;</pre>
 
 </div>
-<!-- EDIT15 SECTION "Initialize Familiar Class Fields" [11751-] -->
+<!-- EDIT15 SECTION "Initialize Familiar Class Fields" [11746-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:application_states?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/audio.html

@@ -50,7 +50,7 @@ AudioNode boom = new AudioNode(assetManager, "Sound/boom.wav", fal
 		<th>AudioNode Method</th><th>Usage</th>
 	</tr>
 	<tr>
-		<td>getStatus()</td><td>Returns either Status.Playing, Status.Stopped, or Status.Paused. </td>
+		<td>getStatus()</td><td>Returns either AudioSource.Status.Playing, AudioSource.Status.Stopped, or AudioSource.Status.Paused. </td>
 	</tr>
 	<tr>
 		<td>getVolume()</td><td>Returns the volume. </td>
@@ -59,14 +59,13 @@ AudioNode boom = new AudioNode&#40;assetManager, &quot;Sound/boom.wav&quot;, fal
 		<td>getPitch()</td><td>Returns the pitch. </td>
 	</tr>
 </table></div>
-<!-- EDIT5 TABLE [1882-2054] -->
+<!-- EDIT5 TABLE [1882-2090] -->
 <p>
-
 Note: There are other obvious getters to poll the status of all corresponding setters listed here.
 </p>
 
 </div>
-<!-- EDIT4 SECTION "Getting AudioNode Properties" [1840-2155] -->
+<!-- EDIT4 SECTION "Getting AudioNode Properties" [1840-2192] -->
 <h2><a>Setting AudioNode Properties</a></h2>
 <div>
 <div><table>
@@ -92,9 +91,9 @@ Note: There are other obvious getters to poll the status of all corresponding se
 		<td>setLooping(false)</td><td>Configures the sound so that, if it is played, it plays once and stops. No looping is the default.</td>
 	</tr>
 </table></div>
-<!-- EDIT7 TABLE [2198-3327] -->
+<!-- EDIT7 TABLE [2235-3364] -->
 </div>
-<!-- EDIT6 SECTION "Setting AudioNode Properties" [2156-3328] -->
+<!-- EDIT6 SECTION "Setting AudioNode Properties" [2193-3365] -->
 <h3><a>Looping &amp; Ambient Sounds</a></h3>
 <div>
 <div><table>
@@ -110,9 +109,9 @@ setDirectional(false)</td><td>All 3D effects switched off. This sound is global
 <strong>Looping does not work on streamed sounds.</strong> </td>
 	</tr>
 </table></div>
-<!-- EDIT9 TABLE [3365-3846] -->
+<!-- EDIT9 TABLE [3402-3883] -->
 </div>
-<!-- EDIT8 SECTION "Looping & Ambient Sounds" [3329-3847] -->
+<!-- EDIT8 SECTION "Looping & Ambient Sounds" [3366-3884] -->
 <h3><a>Positional 3D Sounds</a></h3>
 <div>
 <div><table>
@@ -127,7 +126,7 @@ setLocalTranslation(???)</td><td>Activates 3D audio: The sound appears to come f
 		<td>setReverbEnabled(true)</td><td>Reverb is a 3D echo effect that only makes sense with positional AudioNodes. Use Audio Environments to make scenes sound as if they were &quot;outdoors&quot;, or &quot;indoors&quot; in a large or small room, etc. The reverb effect is defined by the <code>com.jme3.audio.Environment</code> that the <code>audioRenderer</code> is in. See &quot;Setting Audio Environment Properties&quot; below. </td>
 	</tr>
 </table></div>
-<!-- EDIT11 TABLE [3880-4496] -->
+<!-- EDIT11 TABLE [3917-4533] -->
 <p>
 
 <p><div>Positional 3D sounds require an <code>AudioListener</code> object in the scene (representing the player&#039;s ears).
@@ -135,7 +134,7 @@ setLocalTranslation(???)</td><td>Activates 3D audio: The sound appears to come f
 </p>
 
 </div>
-<!-- EDIT10 SECTION "Positional 3D Sounds" [3848-4625] -->
+<!-- EDIT10 SECTION "Positional 3D Sounds" [3885-4662] -->
 <h3><a>Directional 3D Sounds</a></h3>
 <div>
 <div><table>
@@ -151,7 +150,7 @@ setDirection(???) </td><td>Activates 3D audio: This sound can only be heard from
 setOuterAngle()</td><td>Set the angle in degrees for the directional audio. The angle is relative to the direction. Note: By default, both angles are 360?? and the sound can be heard from all directions!</td>
 	</tr>
 </table></div>
-<!-- EDIT13 TABLE [4659-5186] -->
+<!-- EDIT13 TABLE [4696-5223] -->
 <p>
 
 <p><div>Directional 3D sounds require an AudioListener object in the scene (representing the player&#039;s ears). 
@@ -159,7 +158,7 @@ setOuterAngle()</td><td>Set the angle in degrees for the directional audio. The
 </p>
 
 </div>
-<!-- EDIT12 SECTION "Directional 3D Sounds" [4626-5313] -->
+<!-- EDIT12 SECTION "Directional 3D Sounds" [4663-5350] -->
 <h2><a>Play, Pause, Stop</a></h2>
 <div>
 
@@ -181,7 +180,7 @@ You can also start playing instances of an AudioNode. Use the <code>playInstance
 <pre>myAudioNode.playInstance&#40;&#41;;</pre>
 
 </div>
-<!-- EDIT14 SECTION "Play, Pause, Stop" [5314-6018] -->
+<!-- EDIT14 SECTION "Play, Pause, Stop" [5351-6055] -->
 <h2><a>The Audio Listener</a></h2>
 <div>
 
@@ -197,7 +196,7 @@ The default AudioListener object <code>listener</code> in <code>SimpleApplicatio
   &#125;</pre>
 
 </div>
-<!-- EDIT15 SECTION "The Audio Listener" [6019-6655] -->
+<!-- EDIT15 SECTION "The Audio Listener" [6056-6692] -->
 <h2><a>Setting Audio Environment Properties</a></h2>
 <div>
 
@@ -226,7 +225,7 @@ Optionally, You can choose from the following environmental presets from <code>c
 		<td>Closet      </td><td>1.00f</td><td>1.0f</td><td>1.0f</td><td>1.00f</td><td>0.15f</td><td>1.0f</td><td>0.600f</td><td>0.0025f</td><td>0.500f</td><td>0.0006f</td>
 	</tr>
 </table></div>
-<!-- EDIT17 TABLE [7098-7587] --><ol>
+<!-- EDIT17 TABLE [7135-7624] --><ol>
 <li><div> Activate a Environment preset</div>
 <ul>
 <li><div> Either use a default, e.g. make you scene sounds like a dungeon environment: <pre>audioRenderer.setEnvironment&#40;new Environment&#40;Environment.Dungeon&#41;&#41;;</pre>
@@ -266,5 +265,5 @@ Advanced users find more info about OpenAL and its features here: <object classi
 </span></div>
 
 </div>
-<!-- EDIT16 SECTION "Setting Audio Environment Properties" [6656-] -->
+<!-- EDIT16 SECTION "Setting Audio Environment Properties" [6693-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:audio?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/capture_audio_video_to_a_file.html

@@ -571,7 +571,7 @@ public class Advanced extends SimpleApplication {
  
 	public void simpleUpdate(float tpf) {
 		motionTimer.update();
-		if (music.getStatus() != AudioNode.Status.Playing){
+		if (music.getStatus() != AudioSource.Status.Playing){
 			music.play();
 		}
 		Vector3f loc = cam.getLocation();
@@ -600,7 +600,7 @@ The <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param
 </p>
 
 </div>
-<!-- EDIT6 SECTION "Advanced Example" [7328-17231] -->
+<!-- EDIT6 SECTION "Advanced Example" [7328-17233] -->
 <h3><a>Using Advanced features to Record from more than one perspective at once</a></h3>
 <div>
 
@@ -621,7 +621,7 @@ The <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param
 </p>
 
 </div>
-<!-- EDIT7 SECTION "Using Advanced features to Record from more than one perspective at once" [17232-17373] -->
+<!-- EDIT7 SECTION "Using Advanced features to Record from more than one perspective at once" [17234-17375] -->
 <h2><a>More Information</a></h2>
 <div>
 
@@ -653,5 +653,5 @@ listeners can be found here.
 </p>
 
 </div>
-<!-- EDIT8 SECTION "More Information" [17374-] -->
+<!-- EDIT8 SECTION "More Information" [17376-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:capture_audio_video_to_a_file?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/cinematics.html

@@ -4,7 +4,11 @@
 
 <p>
 
-JME3 cinematics (com.jme.cinematic) allow you to remote control nodes and cameras in a 3D game: You can script and and play cinematic scenes. You can use cinematics to create <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://en.wikipedia.org/wiki/Cutscene"><param name="text" value="<html><u>cutscenes</u></html>"><param name="textColor" value="blue"></object> and movies/trailers for your game. Internally, Cinematics are implemented as <a href="/com/jme3/gde/docs/jme3/advanced/application_states.html">AppStates</a>. 
+JME3 cinematics (com.jme.cinematic) allow you to remote control nodes and cameras in a 3D game: You can script and and play cinematic scenes. You can use cinematics to create <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://en.wikipedia.org/wiki/Cutscene"><param name="text" value="<html><u>cutscenes</u></html>"><param name="textColor" value="blue"></object> and movies/trailers for your game. Another good use case is efficient &quot;destruction physics&quot;: Playing back prerecorded flying pieces of debris for demolitions is much faster than calculating them with live physics.
+</p>
+
+<p>
+Internally, Cinematics are implemented as <a href="/com/jme3/gde/docs/jme3/advanced/application_states.html">AppStates</a>. 
 </p>
 
 <p>
@@ -24,7 +28,7 @@ This Node can be the rootNode, or a Node that is attached to the rootNode. </div
 </ol>
 
 </div>
-<!-- EDIT1 SECTION "JME3 Cinematics" [1-923] -->
+<!-- EDIT1 SECTION "JME3 Cinematics" [1-1103] -->
 <h2><a>Sample Code</a></h2>
 <div>
 <ul>
@@ -33,7 +37,7 @@ This Node can be the rootNode, or a Node that is attached to the rootNode. </div
 </ul>
 
 </div>
-<!-- EDIT2 SECTION "Sample Code" [924-1090] -->
+<!-- EDIT2 SECTION "Sample Code" [1104-1270] -->
 <h2><a>How to Use a Cinematic</a></h2>
 <div>
 
@@ -85,9 +89,9 @@ stateManager.attach&#40;cinematic&#41;;</pre>
 		<td>cinematic.pause()</td><td>Pauses the cinematic.</td>
 	</tr>
 </table></div>
-<!-- EDIT4 TABLE [2182-2394] -->
+<!-- EDIT4 TABLE [2362-2574] -->
 </div>
-<!-- EDIT3 SECTION "How to Use a Cinematic" [1091-2394] -->
+<!-- EDIT3 SECTION "How to Use a Cinematic" [1271-2574] -->
 <h2><a>Events(CinematicEvents)</a></h2>
 <div>
 
@@ -117,7 +121,7 @@ Here is the list of available CinematicEvents that you use as events. Each track
 		<td>AnimationEvent</td><td>Use this to start playing a model <a href="/com/jme3/gde/docs/jme3/advanced/animation.html">animation</a> at a given time (a character walking animation for example)</td>
 	</tr>
 </table></div>
-<!-- EDIT6 TABLE [2688-3489] -->
+<!-- EDIT6 TABLE [2868-3669] -->
 <p>
 
 Of course one can make is own event implementation, by extending the AbstractCinematicEvent.
@@ -125,7 +129,7 @@ Of course one can make is own event implementation, by extending the AbstractCin
 </p>
 
 </div>
-<!-- EDIT5 SECTION "Events(CinematicEvents)" [2395-3583] -->
+<!-- EDIT5 SECTION "Events(CinematicEvents)" [2575-3763] -->
 <h3><a>MotionEvent</a></h3>
 <div>
 
@@ -189,14 +193,14 @@ To create a MotionEvent, do the following:
 		<td>event.setRotation(quaternion)</td><td>Sets the rotation. Use together with <code>MotionEvent.Direction.Rotation</code> or <code>MotionEvent.Direction.PathAndRotation</code>.</td>
 	</tr>
 </table></div>
-<!-- EDIT8 TABLE [4069-5478] -->
+<!-- EDIT8 TABLE [4249-5658] -->
 <p>
 
 <strong>Tip:</strong> Most likely you remote-control more than one object in your scene. Give the events and paths useful names such as <code>dragonEvent</code>, <code>dragonPath</code>, <code>heroEvent</code>, <code>heroPath</code>, etc.
 </p>
 
 </div>
-<!-- EDIT7 SECTION "MotionEvent" [3584-5673] -->
+<!-- EDIT7 SECTION "MotionEvent" [3764-5853] -->
 <h3><a>SoundEvent</a></h3>
 <div>
 
@@ -223,7 +227,7 @@ Details of the constructor:
 </ul>
 
 </div>
-<!-- EDIT9 SECTION "SoundEvent" [5674-6204] -->
+<!-- EDIT9 SECTION "SoundEvent" [5854-6384] -->
 <h3><a>GuiEvent</a></h3>
 <div>
 
@@ -254,7 +258,7 @@ Details of the constructor:
 </ul>
 
 </div>
-<!-- EDIT10 SECTION "GuiEvent" [6205-6732] -->
+<!-- EDIT10 SECTION "GuiEvent" [6385-6912] -->
 <h3><a>AnimationEvent</a></h3>
 <div>
 
@@ -281,7 +285,7 @@ Details of the constructor:
 </ul>
 
 </div>
-<!-- EDIT11 SECTION "AnimationEvent" [6733-7245] -->
+<!-- EDIT11 SECTION "AnimationEvent" [6913-7425] -->
 <h3><a>Camera Management</a></h3>
 <div>
 
@@ -314,7 +318,7 @@ Then i just have to schedule its activation in the cinematic. I want it to get a
 <pre> cinematic.activateCamera&#40;3,???topView???&#41;;</pre>
 
 </div>
-<!-- EDIT12 SECTION "Camera Management" [7246-8358] -->
+<!-- EDIT12 SECTION "Camera Management" [7426-8538] -->
 <h3><a>Customizations</a></h3>
 <div>
 
@@ -328,12 +332,12 @@ You can also create new CinematicEvent by extending <object classid="java:org.ne
 </p>
 
 </div>
-<!-- EDIT13 SECTION "Customizations" [8359-9404] -->
+<!-- EDIT13 SECTION "Customizations" [8539-9584] -->
 <h2><a>Interacting with Cinematics</a></h2>
 <div>
 
 </div>
-<!-- EDIT14 SECTION "Interacting with Cinematics" [9405-9445] -->
+<!-- EDIT14 SECTION "Interacting with Cinematics" [9585-9625] -->
 <h3><a>CinematicEventListener</a></h3>
 <div>
 <pre>CinematicEventListener cel = new CinematicEventListener&#40;&#41; &#123;
@@ -355,7 +359,7 @@ You can also create new CinematicEvent by extending <object classid="java:org.ne
 cinematic.addListener&#40;cel&#41;;</pre>
 
 </div>
-<!-- EDIT15 SECTION "CinematicEventListener" [9446-9941] -->
+<!-- EDIT15 SECTION "CinematicEventListener" [9626-10121] -->
 <h3><a>Physics Interaction</a></h3>
 <div>
 
@@ -365,5 +369,5 @@ Upcoming.
 </p>
 
 </div>
-<!-- EDIT16 SECTION "Physics Interaction" [9942-] -->
+<!-- EDIT16 SECTION "Physics Interaction" [10122-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:cinematics?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/custom_controls.html

@@ -3,7 +3,7 @@
 <div>
 
 <p>
-A <code>com.jme3.scene.control.Control</code> is a customizable jME3 interface that allows you to cleanly steer the behaviour of game entities (Spatials), such as artificially intelligent behaviour in NPCs, traps, automatic alarms and doors, animals and pets, self-steering vehicles or platforms ??? anything that moves and interacts. Several instances of customs Controls together implement the behaviours of a type of Spatial. 
+A <code>com.jme3.scene.control.Control</code> is a customizable jME3 interface that allows you to cleanly steer the behaviour of game entities (Spatials), such as artificially intelligent behaviour in NPCs, traps, automatic alarms and doors, animals and pets, self-steering vehicles or platforms ??? anything that moves and interacts. Several instances of custom Controls together implement the behaviours of a type of Spatial. 
 </p>
 
 <p>
@@ -43,7 +43,7 @@ To implement game logic for a type of spatial, you will either extend AbstractCo
 </p>
 
 </div>
-<!-- EDIT1 SECTION "Custom Controls" [1-1747] -->
+<!-- EDIT1 SECTION "Custom Controls" [1-1746] -->
 <h2><a>Usage</a></h2>
 <div>
 
@@ -91,7 +91,7 @@ The possibilities are endless. <img src="/wiki/lib/images/smileys/icon_smile.gif
 </p>
 
 </div>
-<!-- EDIT2 SECTION "Usage" [1748-3215] -->
+<!-- EDIT2 SECTION "Usage" [1747-3214] -->
 <h2><a>Example Code</a></h2>
 <div>
 
@@ -115,7 +115,7 @@ Existing examples in the code base include:
 </ul>
 
 </div>
-<!-- EDIT3 SECTION "Example Code" [3216-4500] -->
+<!-- EDIT3 SECTION "Example Code" [3215-4499] -->
 <h2><a>AbstractControl Class</a></h2>
 <div>
 
@@ -155,12 +155,19 @@ Usage: Your custom subclass implements the three methods <code>controlUpdate()</
     // index=i; // example 
   &#125; 
 &nbsp;
-  <span>/** This is your init method. Optionally, you can modify 
-    * the spatial from here (transform it, initialize userdata, etc). */</span>
+  <span>/** This method is called when the control is added to the spatial,
+    * and when the control is removed from the spatial (setting a null value).
+    * It can be used for both initialization and cleanup. */</span>    
   @Override
   public void setSpatial&#40;Spatial spatial&#41; &#123;
     super.setSpatial&#40;spatial&#41;;
-    // spatial.setUserData(&quot;index&quot;, i); // example
+    <span>/* Example:
+    if (spatial != null){
+        // initialize
+    }else{
+        // cleanup
+    }
+    */</span>
   &#125;
 &nbsp;
 &nbsp;
@@ -214,13 +221,13 @@ See also:
 </ul>
 
 </div>
-<!-- EDIT4 SECTION "AbstractControl Class" [4501-7447] -->
+<!-- EDIT4 SECTION "AbstractControl Class" [4500-7583] -->
 <h2><a>The Control Interface</a></h2>
 <div>
 
 <p>
 
-<p><div>In the less common case that you want to create a Control that also extends another class, create a custom interface that  extends jME3&#039;s Control interface. Your class can become a Control by implement the Control interface, and at the same time extend another class.
+<p><div>In the less common case that you want to create a Control that also extends another class, create a custom interface that  extends jME3&#039;s Control interface. Your class can become a Control by implementing the Control interface, and at the same time extending another class.
 </div></p>
 </p>
 
@@ -321,7 +328,7 @@ Usage example:
 &#125;</pre>
 
 </div>
-<!-- EDIT5 SECTION "The Control Interface" [7448-10699] -->
+<!-- EDIT5 SECTION "The Control Interface" [7584-10841] -->
 <h2><a>Best Practices</a></h2>
 <div>
 
@@ -387,5 +394,5 @@ vehicleSpatial.addControl&#40;new ManualVehicleControl&#40;&#41;&#41;;
 c.steerX&#40;steerX&#41;;</pre>
 
 </div>
-<!-- EDIT6 SECTION "Best Practices" [10700-] -->
+<!-- EDIT6 SECTION "Best Practices" [10842-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:custom_controls?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/debugging.html

@@ -132,8 +132,24 @@ You can display a wireframe of the (usually invisible) collision shape around al
 </p>
 <pre>physicsSpace.enableDebug&#40;assetManager&#41;;</pre>
 
+<p>
+With debugging enabled, colors are used to indicate various types of physical objects:
+</p>
+<ul>
+<li><div> A magenta wire mesh indicates an active rigid body.</div>
+</li>
+<li><div> A blue wire mesh indicates a rigid body which is either new or inactive.</div>
+</li>
+<li><div> A yellow wire mesh indicates a ghost.</div>
+</li>
+<li><div> Two green arrows indicate a joint.</div>
+</li>
+<li><div> A pink wire mesh indicates a character.</div>
+</li>
+</ul>
+
 </div>
-<!-- EDIT7 SECTION "Wireframe for Physics" [4221-4567] -->
+<!-- EDIT7 SECTION "Wireframe for Physics" [4221-4913] -->
 <h2><a>Wireframe for Animations</a></h2>
 <div>
 
@@ -150,7 +166,7 @@ Making the skeleton visible inside animated models can be handy for debugging an
      player.attachChild&#40;skeletonDebug&#41;;</pre>
 
 </div>
-<!-- EDIT8 SECTION "Wireframe for Animations" [4568-5159] -->
+<!-- EDIT8 SECTION "Wireframe for Animations" [4914-5505] -->
 <h2><a>Example: Toggle Wireframe on Model</a></h2>
 <div>
 
@@ -208,7 +224,7 @@ TIP :: To set the line width of wireframe display, use mesh.setLineWidth(lineWid
 </p>
 
 </div>
-<!-- EDIT9 SECTION "Example: Toggle Wireframe on Model" [5160-7050] -->
+<!-- EDIT9 SECTION "Example: Toggle Wireframe on Model" [5506-7396] -->
 <h2><a>Example: Toggle Wireframe on the scene</a></h2>
 <div>
 
@@ -262,7 +278,7 @@ Then attach the scene processor to the <acronym title="Graphical User Interface"
 <pre>getViewPort&#40;&#41;.addProcessor&#40;new WireProcessor&#40;&#41;&#41;;</pre>
 
 </div>
-<!-- EDIT10 SECTION "Example: Toggle Wireframe on the scene" [7051-8424] -->
+<!-- EDIT10 SECTION "Example: Toggle Wireframe on the scene" [7397-8770] -->
 <h2><a>See also</a></h2>
 <div>
 <ul>
@@ -271,5 +287,5 @@ Then attach the scene processor to the <acronym title="Graphical User Interface"
 </ul>
 
 </div>
-<!-- EDIT11 SECTION "See also" [8425-] -->
+<!-- EDIT11 SECTION "See also" [8771-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:debugging?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/effects_overview.html

@@ -298,6 +298,57 @@ Thanks for your awesome contributions! Keep them coming!
 </ul>
 <hr />
 
+</div>
+<!-- EDIT20 SECTION "Particle Emitters: Explosions, Fire, Smoke" [8466-9440] -->
+<h3><a>Creating your own Filters</a></h3>
+<div>
+
+<p>
+
+Here is an extract taken from @nehon in the forum thread (<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://hub.jmonkeyengine.org/forum/topic/how-exactly-do-filters-work/"><param name="text" value="<html><u>http://hub.jmonkeyengine.org/forum/topic/how-exactly-do-filters-work/</u></html>"><param name="textColor" value="blue"></object>)
+</p>
+
+<p>
+The methods are called in this order (pretty much the same flow as processors):
+- initFilter() is called once when the FilterPostPorcessor is initialized or when the filter is added to the processor and this one as already been initialized.
+</p>
+
+<p>
+for each frame the methods are called in that sequence :
+- preFrame() occurs before anything happens
+- postQueue() occcurs once the queues have been populated (there is one queue per bucket and 2 additional queues for the shadows, casters and recievers). Note that geometries in the queues are the one in the view frustum.
+- postFrame occurs once the main frame has been rendered (the back buffer)
+</p>
+
+<p>
+Those methods are optional in a filter, they are only there if you want to hook in the rendering process.
+</p>
+
+<p>
+The material variable is here for convenience. You have a getMaterial method that returns the material that???s gonna be used to render the full screen quad. It just happened that in every implementation I had a material attribute in all my sub-classes, so I just put it back in the abstract class. Most of the time getMaterial returns this attribute.
+</p>
+
+<p>
+Forced-technique can be any technique really, they are more related with the material system than to the filters but anyway. When you use a forced technique the renderer tries to select it on the material of each geometry, if the technique does not exists for the material the geometry is not rendered.
+You assume well about the SSAO filer, the normal of the scene are rendered to a texture in a pre pass.
+</p>
+
+<p>
+Passes : these are filters in filters in a way. First they are a convenient way to initialize a FrameBuffer and the associated textures it needs, then you can use them for what ever you want.
+For example, a Pass can be (as in the SSAO filter) an extra render of the scene with a forced technique, and you have to handle the render yourself in the postQueue method.
+It can be a post pass to do after the main filter has been rendered to screen (for example an additional blur pass used in SSAO again). You have a list of passes called postRenderPass in the Filter abstract class. If you add a pass to this list, it???ll be automatically rendered by the FilterPostProcessor during the filter chain.
+</p>
+
+<p>
+The bloom Filter does an intensive use of passes.
+</p>
+
+<p>
+Filters in a nutshell.
+
+</p>
+<hr />
+
 <p>
 See also:
 </p>
@@ -317,5 +368,5 @@ See also:
 </span></div>
 
 </div>
-<!-- EDIT20 SECTION "Particle Emitters: Explosions, Fire, Smoke" [8466-] -->
+<!-- EDIT21 SECTION "Creating your own Filters" [9441-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:effects_overview?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/input_handling.html

@@ -158,15 +158,15 @@ In your IDE, use code completion to quickly look up Trigger literals. In the jMo
 		<td>INPUT_MAPPING_CAMERA_POS</td><td>KEY_C</td><td>Prints debug output about the camera.</td>
 	</tr>
 	<tr>
-		<td>INPUT_MAPPING_MEMORY</td><td>KEY_M</td><td>Prints debug output for memtory usage.</td>
+		<td>INPUT_MAPPING_MEMORY</td><td>KEY_M</td><td>Prints debug output for memory usage.</td>
 	</tr>
 	<tr>
 		<td>INPUT_MAPPING_EXIT</td><td>KEY_ESCAPE</td><td>Closes the application by calling <code>stop();</code>. Typically you do not remove this, unless you replace it by another way of quitting gracefully.</td>
 	</tr>
 </table></div>
-<!-- EDIT6 TABLE [3701-4118] -->
+<!-- EDIT6 TABLE [3701-4117] -->
 </div>
-<!-- EDIT5 SECTION "2. Remove Default Trigger Mappings" [3569-4119] -->
+<!-- EDIT5 SECTION "2. Remove Default Trigger Mappings" [3569-4118] -->
 <h2><a>3. Add Custom Trigger Mapping</a></h2>
 <div>
 
@@ -192,7 +192,7 @@ inputManager.addMapping&#40;&quot;Right&quot;, new KeyTrigger&#40;KeyInput.KEY_D
                                  ...</pre>
 
 </div>
-<!-- EDIT7 SECTION "3. Add Custom Trigger Mapping" [4120-5184] -->
+<!-- EDIT7 SECTION "3. Add Custom Trigger Mapping" [4119-5183] -->
 <h2><a>4. Create Listeners</a></h2>
 <div>
 
@@ -206,7 +206,7 @@ The jME3 input manager supports two types of event listeners for inputs: AnalogL
 </p>
 
 </div>
-<!-- EDIT8 SECTION "4. Create Listeners" [5185-5658] -->
+<!-- EDIT8 SECTION "4. Create Listeners" [5184-5657] -->
 <h3><a>ActionListener</a></h3>
 <div>
 
@@ -241,7 +241,7 @@ The jME3 input manager supports two types of event listeners for inputs: AnalogL
 &#125;;</pre>
 
 </div>
-<!-- EDIT9 SECTION "ActionListener" [5659-6325] -->
+<!-- EDIT9 SECTION "ActionListener" [5658-6324] -->
 <h3><a>AnalogListener</a></h3>
 <div>
 
@@ -274,7 +274,7 @@ The jME3 input manager supports two types of event listeners for inputs: AnalogL
 &#125;;</pre>
 
 </div>
-<!-- EDIT10 SECTION "AnalogListener" [6326-6962] -->
+<!-- EDIT10 SECTION "AnalogListener" [6325-6961] -->
 <h2><a>4. Register Mappings to Listeners</a></h2>
 <div>
 
@@ -303,7 +303,7 @@ As you see, you can add several listeners in one String array. You can call the
 </p>
 
 </div>
-<!-- EDIT11 SECTION "4. Register Mappings to Listeners" [6963-8211] -->
+<!-- EDIT11 SECTION "4. Register Mappings to Listeners" [6962-8210] -->
 <h2><a>5. Implement Actions in Listeners</a></h2>
 <div>
 
@@ -323,7 +323,7 @@ Make use of the distinction between <code>if</code> and <code>else if</code> in
 </ul>
 
 </div>
-<!-- EDIT12 SECTION "5. Implement Actions in Listeners" [8212-8947] -->
+<!-- EDIT12 SECTION "5. Implement Actions in Listeners" [8211-8946] -->
 <h3><a>ActionListener</a></h3>
 <div>
 
@@ -344,7 +344,7 @@ In the most common case, you want an action to be triggered once, in the moment
   &#125;;</pre>
 
 </div>
-<!-- EDIT13 SECTION "ActionListener" [8948-9619] -->
+<!-- EDIT13 SECTION "ActionListener" [8947-9618] -->
 <h3><a>AnalogListener</a></h3>
 <div>
 
@@ -365,7 +365,7 @@ The following example shows how you define actions with an AnalogListener. Thies
   &#125;;</pre>
 
 </div>
-<!-- EDIT14 SECTION "AnalogListener" [9620-10200] -->
+<!-- EDIT14 SECTION "AnalogListener" [9619-10199] -->
 <h2><a>Let Users Remap Keys</a></h2>
 <div>
 
@@ -384,5 +384,5 @@ The abstraction of separating triggers and mappings has the advantage that you c
 </span></div>
 
 </div>
-<!-- EDIT15 SECTION "Let Users Remap Keys" [10201-] -->
+<!-- EDIT15 SECTION "Let Users Remap Keys" [10200-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:input_handling?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/light_and_shadow.html

@@ -75,7 +75,7 @@ You can get a list of all lights added to a Spatial by calling <code>getWorldLig
 </p>
 
 <p>
-A PointLight has a location and shines from there in all directions as far as its radius reaches. The light intensity decreases with increased distance from the light source. A PointLight can at the moment not be used for casting shadows (using the PssmShadowRenderer - read more about this below). 
+A PointLight has a location and shines from there in all directions as far as its radius reaches. The light intensity decreases with increased distance from the light source. A PointLight can be used to cast shadows along with a PointLightShadowRenderer (see the Casting Shadows section)
 </p>
 
 <p>
@@ -88,7 +88,7 @@ lamp_light.setPosition&#40;new Vector3f&#40;lamp_geo.getLocalTranslation&#40;&#4
 rootNode.addLight&#40;lamp_light&#41;;</pre>
 
 </div>
-<!-- EDIT3 SECTION "PointLight" [2060-2762] -->
+<!-- EDIT3 SECTION "PointLight" [2060-2750] -->
 <h3><a>DirectionalLight</a></h3>
 <div>
 
@@ -110,7 +110,7 @@ sun.setDirection&#40;new Vector3f&#40;-.5f,-.5f,-.5f&#41;.normalizeLocal&#40;&#4
 rootNode.addLight&#40;sun&#41;;</pre>
 
 </div>
-<!-- EDIT4 SECTION "DirectionalLight" [2763-3367] -->
+<!-- EDIT4 SECTION "DirectionalLight" [2751-3355] -->
 <h3><a>SpotLight</a></h3>
 <div>
 
@@ -140,7 +140,7 @@ If you want the spotlight to follow the flycam, repeat the setDirection(???) and
 </p>
 
 </div>
-<!-- EDIT5 SECTION "SpotLight" [3368-4502] -->
+<!-- EDIT5 SECTION "SpotLight" [3356-4490] -->
 <h3><a>AmbientLight</a></h3>
 <div>
 
@@ -163,7 +163,7 @@ Example: <code>mylight.setColor(ColorRGBA.White.mult(1.3f));</code>
 </p>
 
 </div>
-<!-- EDIT6 SECTION "AmbientLight" [4503-5325] -->
+<!-- EDIT6 SECTION "AmbientLight" [4491-5313] -->
 <h2><a>Light Follows Spatial</a></h2>
 <div>
 
@@ -181,117 +181,84 @@ Obviously, this does not apply to AmbientLights, which have no position.
 </p>
 
 </div>
-<!-- EDIT7 SECTION "Light Follows Spatial" [5326-5891] -->
-<h2><a>Simple Lighting</a></h2>
+<!-- EDIT7 SECTION "Light Follows Spatial" [5314-5880] -->
+<h2><a>BasicShadowRenderer (deprecated)</a></h2>
 <div>
 
 <p>
 
-Full sample code:
+Full code sample
 </p>
 <ul>
-<li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/test/jme3test/light/TestSimpleLighting.java"><param name="text" value="<html><u>TestSimpleLighting.java</u></html>"><param name="textColor" value="blue"></object></div>
-</li>
-<li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/test/jme3test/light/TestLightRadius.java"><param name="text" value="<html><u>TestLightRadius.java</u></html>"><param name="textColor" value="blue"></object></div>
+<li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/test/jme3test/light/TestShadow.java"><param name="text" value="<html><u>TestShadow.java</u></html>"><param name="textColor" value="blue"></object></div>
 </li>
 </ul>
 
-<p>
-
-For Simple Lighting we use Geometries with Materials based on Lighting.j3md (learn <a href="/com/jme3/gde/docs/jme3/advanced/materials_overview.html">more about Materials</a> here). Lighting.j3md-based materials dynamically support Shininess, and Ambient, Diffuse, and Specular light if there is a light source present. Note that this lighting method alone does not make the Geometry cast a shadow onto other Geometries automatically (see below for how to add drop shadows etc).
-</p>
-
-<p>
-<img src="nbdocs:/com/jme3/gde/docs/jme3/advanced/teapot-phong-illuminated.png">
-</p>
-<pre>Geometry teapot = &#40;Geometry&#41; assetManager.loadModel&#40;&quot;Models/Teapot/Teapot.obj&quot;&#41;;
-TangentBinormalGenerator.generate&#40;teapot.getMesh&#40;&#41;, true&#41;;
-Material mat = new Material&#40;assetManager, &quot;Common/MatDefs/Light/Lighting.j3md&quot;&#41;;
-mat.setBoolean&#40;&quot;m_UseMaterialColors&quot;, true&#41;;
-mat.setColor&#40;&quot;m_Ambient&quot;,  ColorRGBA.Orange&#41;;
-mat.setColor&#40;&quot;m_Diffuse&quot;,  ColorRGBA.Orange&#41;;
-mat.setColor&#40;&quot;m_Specular&quot;, ColorRGBA.White&#41;;
-mat.setFloat&#40;&quot;m_Shininess&quot;, 12&#41;;
-rootNode.attachChild&#40;teapot&#41;;</pre>
-
-<p>
-The above example uses material colors and no textures. You can of course also use Lighting.j3md to create a lit Material that uses Texture Maps. The following example uses Shininess, Diffuse Map and Normal Map (a.k.a Bump Map).
-</p>
-
-<p>
-<img src="nbdocs:/com/jme3/gde/docs/jme3/advanced/bump-mapped-sphere.png">
-</p>
-<pre>Sphere rock = new Sphere&#40;32,32, 2f&#41;;
-Geometry shiny_rock = new Geometry&#40;&quot;Shiny rock&quot;, rock&#41;;
-rock.setTextureMode&#40;Sphere.TextureMode.Projected&#41;; // better quality on spheres
-TangentBinormalGenerator.generate&#40;rock&#41;;           // for lighting effect
-Material mat_lit = new Material&#40;
-    assetManager, &quot;Common/MatDefs/Light/Lighting.j3md&quot;&#41;;
-mat_lit.setTexture&#40;&quot;m_DiffuseMap&quot;,                 // surface color
-    assetManager.loadTexture&#40;&quot;Textures/Terrain/Pond/Pond.png&quot;&#41;&#41;;
-mat_lit.setTexture&#40;&quot;m_NormalMap&quot;,                  // surface bumps
-    assetManager.loadTexture&#40;&quot;Textures/Terrain/Pond/Pond_normal.png&quot;&#41;&#41;;
-mat_lit.setFloat&#40;&quot;m_Shininess&quot;, 5f&#41;;               // surface smoothness [1,128]
-shiny_rock.setMaterial&#40;mat_lit&#41;;
-rootNode.attachChild&#40;shiny_rock&#41;;</pre>
-
-<p>
-These light effects update live when the object or light source moves. If you shine a colored PointLight at this object, you will see a light reflection tinged in the color of the PointLight.
-</p>
-
 </div>
-<!-- EDIT8 SECTION "Simple Lighting" [5892-8541] -->
-<h2><a>BasicShadowRenderer</a></h2>
+<!-- EDIT8 SECTION "BasicShadowRenderer (deprecated)" [5881-6073] -->
+<h2><a>Casting Shadows</a></h2>
 <div>
 
 <p>
 
-Full code sample
+For each type of non-ambient light source, JME3 implements two ways to simulate geometries casting shadows on other geometries:
 </p>
 <ul>
-<li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/test/jme3test/light/TestShadow.java"><param name="text" value="<html><u>TestShadow.java</u></html>"><param name="textColor" value="blue"></object></div>
+<li><div> a shadow renderer (which you apply to a viewport) and</div>
+</li>
+<li><div> a shadow filter (which you can add to a viewport&#039;s filter post-processor).</div>
 </li>
 </ul>
-
+<div><table>
+	<tr>
+		<th> light source class </th><th> shadow renderer class </th><th> shadow filter class </th>
+	</tr>
+	<tr>
+		<td> DirectionalLight </td><td> DirectionalLightShadowRenderer </td><td> DirectionalLightShadowFilter </td>
+	</tr>
+	<tr>
+		<td> PointLight </td><td> PointLightShadowRenderer </td><td> PointLightShadowFilter </td>
+	</tr>
+	<tr>
+		<td> SpotLight </td><td> SpotLightShadowRenderer </td><td> SpotLightShadowFilter </td>
+	</tr>
+	<tr>
+		<td> AmbientLight </td><td> (not applicable) </td><td> (not applicable) </td>
+	</tr>
+</table></div>
+<!-- EDIT10 TABLE [6369-6708] -->
 <p>
 
-Use the Shadow Renderer to make Geometries with Lighting.j3md-based Materials cast and receive basic drop shadows. This fast and simple implementation of a shadow effect is good for scenes with flat floors, but looks less realistic on uneven terrains. To use it, you add a jME SceneProcessor named com.jme3.shadow.BasicShadowRenderer to the viewPort.
+You only need one shadow simulation per light source:  if you use shadow rendering, you won&#039;t need a shadow filter and vice versa.  Which way is more efficient depends partly on the complexity of your scene. All six shadow simulation classes have similar interfaces, so once you know how to use one, you can easily figure out the rest.
 </p>
 
 <p>
-<img src="nbdocs:/com/jme3/gde/docs/jme3/advanced/drop-shadows.png">
+Shadow calculations (cast and receive) have a performance impact, so use them sparingly.  With shadow renderers, you can turn off shadow casting and/or shadow receiving for individual geometries, for portions of the scene graph, or for the entire scene:
 </p>
-<pre>BasicShadowRenderer bsr;
-...
-public void simpleInitApp&#40;&#41; &#123;
-    ...
-    bsr = new BasicShadowRenderer&#40;assetManager, 256&#41;;
-    bsr.setDirection&#40;new Vector3f&#40;-.5f,-.5f,-.5f&#41;.normalizeLocal&#40;&#41;&#41;; // light direction
-    viewPort.addProcessor&#40;bsr&#41;;
-    ...</pre>
+<pre>spatial.setShadowMode&#40;ShadowMode.Inherit&#41;;     // This is the default setting for new spatials.
+rootNode.setShadowMode&#40;ShadowMode.Off&#41;;        // Disable shadows for the whole scene, except where overridden. 
+wall.setShadowMode&#40;ShadowMode.CastAndReceive&#41;; // The wall can cast shadows and also receive them.
+floor.setShadowMode&#40;ShadowMode.Receive&#41;;       // Any shadows cast by the floor would be hidden by it.
+airplane.setShadowMode&#40;ShadowMode.Cast&#41;;       // There's nothing above the airplane to cast shadows on it.
+ghost.setShadowMode&#40;ShadowMode.Off&#41;;           // The ghost is translucent: it neither casts nor receives shadows.</pre>
 
 <p>
-Shadow calculations (cast and receive) have a performance impact, therefor we recommend to use them smartly. Switch off the default shadow mode for the whole scene graph, and then specify the shadow behaviour individually for every scene node that needs shadows: You specifiy whether it casts shadows, receives shadows, both (slower), or neither (faster). 
+Both shadow renderers and shadow filters use shadow modes to determine which objects can cast shadows. However, only the shadow renderers pay attention to shadow modes when determining which objects receive shadows.  With a shadow filter, shadow modes have no effect on which objects receive shadows.
 </p>
-<pre>rootNode.setShadowMode&#40;ShadowMode.Off&#41;;        // reset all
-wall.setShadowMode&#40;ShadowMode.CastAndReceive&#41;; // normal behaviour (slow)
-floor.setShadowMode&#40;ShadowMode.Receive&#41;;       // can't see shadow cast below floor anyway...
-airplane.setShadowMode&#40;ShadowMode.Cast&#41;;       // nothing casts shadows onto airplane anyway...
-ghost.setShadowMode&#40;ShadowMode.Off&#41;;           // ghost is translucent anyway...</pre>
-
-</div>
-<!-- EDIT9 SECTION "BasicShadowRenderer" [8542-10211] -->
-<h2><a>DirectionalLightShadowRenderer</a></h2>
-<div>
 
 <p>
-
-Full sample code
+Here&#039;s a sample application which demonstrates both DirectionalLightShadowRenderer and DirectionalLightShadowFilter:
 </p>
 <ul>
 <li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/test/jme3test/light/TestDirectionalLightShadow.java"><param name="text" value="<html><u>TestDirectionalLightShadow.java</u></html>"><param name="textColor" value="blue"></object></div>
 </li>
 </ul>
+
+<p>
+
+Here is the key code fragment:
+
+</p>
 <pre>        DirectionalLight sun = new DirectionalLight&#40;&#41;;
         sun.setColor&#40;ColorRGBA.White&#41;;
         sun.setDirection&#40;cam.getDirection&#40;&#41;&#41;;
@@ -310,8 +277,24 @@ Full sample code
         fpp.addFilter&#40;dlsf&#41;;
         viewPort.addProcessor&#40;fpp&#41;;</pre>
 
+<p>
+Constructor arguments:
+ * your AssetManager object
+ * size of the rendered shadow maps, in pixels per side (512, 1024, 2048, etc???)
+ * the number of shadow maps rendered (more shadow maps = better quality, but slower)
+</p>
+
+<p>
+Properties you can set:
+ * setDirection(Vector3f) ??? the direction of the light
+ * setLambda(0.65f) ??? to reduce the split size
+ * setShadowIntensity(0.7f) ??? shadow darkness (1=black, 0=invisible)
+ * setShadowZextend(float) ??? distance from camera to which shadows will be computed
+
+</p>
+
 </div>
-<!-- EDIT10 SECTION "DirectionalLightShadowRenderer" [10212-11184] -->
+<!-- EDIT9 SECTION "Casting Shadows" [6074-9825] -->
 <h2><a>Parallel-Split Shadow Map (deprecated)</a></h2>
 <div>
 
@@ -326,10 +309,6 @@ Full sample code
 
 <p>
 
-The more advanced PSSM shadow renderer can cast real-time shadows, even on curved surfaces such as terrains. It is a bit more resource hungry than the BasicShadowRenderer. To activate PSSM drop shadows, add a jME SceneProcessor named <code>com.jme3.shadow.PssmShadowRenderer</code> to the viewPort. PSSM stands for the Parallel-Split Shadow Map technique.
-</p>
-
-<p>
 <img src="nbdocs:/com/jme3/gde/docs/jme3/advanced/shadow.png">
 </p>
 <pre>private PssmShadowRenderer pssmRenderer;
@@ -340,42 +319,8 @@ public void simpleInitApp&#40;&#41; &#123;
     pssmRenderer.setDirection&#40;new Vector3f&#40;-.5f,-.5f,-.5f&#41;.normalizeLocal&#40;&#41;&#41;; // light direction
     viewPort.addProcessor&#40;pssmRenderer&#41;;</pre>
 
-<p>
-The constructor expects the following values:
-</p>
-<ul>
-<li><div> Your assetManager object</div>
-</li>
-<li><div> The size of the rendered shadowmaps (512, 1024, 2048, etc???)</div>
-</li>
-<li><div> The number of shadow maps rendered (the more shadow maps, the more quality, the less FPS).</div>
-</li>
-</ul>
-
-<p>
-
-You can set the following properties on the <code>pssmRenderer</code> object:
-</p>
-<ul>
-<li><div> setDirection(Vector3f) ??? the direction of the light</div>
-</li>
-<li><div> setLambda(0.65f) ??? Factor to use to reduce the split size</div>
-</li>
-<li><div> setShadowIntensity(0.7f) ??? shadow darkness (1 black, 0 invisible)</div>
-</li>
-<li><div> setShadowZextend() ??? distance how far away from camera shadows will still be computed</div>
-</li>
-</ul>
-
-<p>
-
-As said above, it&#039;s more efficient to specify individual shadow behaviour for each Geometry.
-</p>
-<pre>teapot.setShadowMode&#40;ShadowMode.CastAndReceive&#41;;
-terrain.setShadowMode&#40;ShadowMode.Receive&#41;; </pre>
-
 </div>
-<!-- EDIT11 SECTION "Parallel-Split Shadow Map (deprecated)" [11185-12920] -->
+<!-- EDIT11 SECTION "Parallel-Split Shadow Map (deprecated)" [9826-10415] -->
 <h2><a>Screen Space Ambient Occlusion</a></h2>
 <div>
 
@@ -384,17 +329,21 @@ terrain.setShadowMode&#40;ShadowMode.Receive&#41;; </pre>
 Full sample code
 </p>
 <ul>
-<li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/test/jme3test/post/TestSSAO.java"><param name="text" value="<html><u>jme3/src/test/jme3test/post/TestSSAO.java</u></html>"><param name="textColor" value="blue"></object>, <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/test/jme3test/post/TestSSAO2.java"><param name="text" value="<html><u>jme3/src/test/jme3test/post/TestSSAO2.java</u></html>"><param name="textColor" value="blue"></object> ??? Screen-Space Ambient Occlusion shadows</div>
+<li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/test/jme3test/post/TestSSAO.java"><param name="text" value="<html><u>jme3/src/test/jme3test/post/TestSSAO.java</u></html>"><param name="textColor" value="blue"></object> ??? Screen-Space Ambient Occlusion shadows</div>
 </li>
 <li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/test/jme3test/post/TestTransparentSSAO.java"><param name="text" value="<html><u>jme3/src/test/jme3test/post/TestTransparentSSAO.java</u></html>"><param name="textColor" value="blue"></object> ??? Screen-Space Ambient Occlusion shadows plus transparancy</div>
 </li>
-<li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://jmonkeyengine.org/2010/08/16/screen-space-ambient-occlusion-for-jmonkeyengine-3-0/#more-321"><param name="text" value="<html><u>Screen Space Ambient Occlusion for jMonkeyEngine (article)</u></html>"><param name="textColor" value="blue"></object></div>
+<li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://hub.jmonkeyengine.org/2010/08/screen-space-ambient-occlusion-for-jmonkeyengine-3-0/"><param name="text" value="<html><u>Screen Space Ambient Occlusion for jMonkeyEngine (article)</u></html>"><param name="textColor" value="blue"></object></div>
 </li>
 </ul>
 
 <p>
 
-Ambient Occlusion refers to the shadows that nearby objects cast on each other under an ambient lighting. It???s an approximation of how light radiates in a real life scene. To activate Ambient Occlusion shadows, add a jME SceneProcessor named <code>com.jme3.post.SSAOFilter</code> to the viewPort. SSAO stands for the Screen Space Ambient Occlusion technique.
+Ambient Occlusion refers to the shadows which nearby objects cast on each other under an ambient lighting. Screen Space Ambient Occlusion (SSAO) approximates how light radiates in real life.
+</p>
+
+<p>
+In JME3, SSAO is implemented by adding an instance of <code>com.jme3.post.SSAOFilter</code> to a viewport which already simulates shadows using another method such as DirectionalLightShadowRenderer.
 </p>
 <pre>FilterPostProcessor fpp = new FilterPostProcessor&#40;assetManager&#41;;
 SSAOFilter ssaoFilter = new SSAOFilter&#40;12.94f, 43.92f, 0.33f, 0.61f&#41;;
@@ -407,5 +356,5 @@ viewPort.addProcessor&#40;fpp&#41;;</pre>
 </p>
 
 </div>
-<!-- EDIT12 SECTION "Screen Space Ambient Occlusion" [12921-] -->
+<!-- EDIT12 SECTION "Screen Space Ambient Occlusion" [10416-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:light_and_shadow?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/mouse_picking.html

@@ -22,7 +22,7 @@ See <a href="/com/jme3/gde/docs/jme3/advanced/input_handling.html">Input Handlin
 
 <p>
 
-The following <code>pick target</code> input mapping implements an action that determines what a user clicked. It assumes that the mouse pointer is invisible and there are crosshairs painted in the center of the screen. It assumes that the user aims the crosshairs at an object in the scene and clicks. You use Ray Casting to identify the geometry that was picked by the user. Use use this method together with a first-person flyCam. 
+The following <code>pick target</code> input mapping implements an action that determines what a user clicked. It assumes that the mouse pointer is invisible and there are crosshairs painted in the center of the screen. It assumes that the user aims the crosshairs at an object in the scene and clicks. You use Ray Casting to identify the geometry that was picked by the user. Use this method together with a first-person flyCam. 
 
 </p>
 <ol>
@@ -72,7 +72,7 @@ The following example rotates Spatials named &quot;Red Box&quot; or &quot;Blue B
   &#125;;</pre>
 
 </div>
-<!-- EDIT2 SECTION "Pick a Target Using Fixed Crosshairs" [534-3109] -->
+<!-- EDIT2 SECTION "Pick a Target Using Fixed Crosshairs" [534-3105] -->
 <h2><a>Pick a Target Using the Mouse Pointer</a></h2>
 <div>
 
@@ -146,5 +146,5 @@ The following example rotates Spatials named &quot;Red Box&quot; or &quot;Blue B
 </span></div>
 
 </div>
-<!-- EDIT3 SECTION "Pick a Target Using the Mouse Pointer" [3110-] -->
+<!-- EDIT3 SECTION "Pick a Target Using the Mouse Pointer" [3106-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:mouse_picking?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/multithreading.html

@@ -4,7 +4,7 @@
 
 <p>
 
-jME3 is similar to Swing in that for speed and efficiency all changes to the world must be made in a single update thread. This is happening automatically if using Controls and AppSates update metod or simpleUpdate however whenever you pass work to another thread you need to hand the results back to the main jME3 thread before making any changes to the scene graph.
+jME3 is similar to Swing in that, for speed and efficiency, all changes to the scene graph must be made in a single update thread. If you make changes only in Control.update(), AppState.update(), or SimpleApplication.simpleUpdate(), this will happen automatically.  However, if you pass work to another thread, you may need to pass results back to the main jME3 thread so that scene graph changes can take place there.
 </p>
 <pre>public void rotateGeometry&#40;final Geometry geo, final Quaternion rot&#41; &#123;
     mainApp.enqueue&#40;new Callable&lt;Spatial&gt;&#40;&#41; &#123;
@@ -24,7 +24,7 @@ If the processing thread needs to wait or needs the return value then <code>get(
 </p>
 
 </div>
-<!-- EDIT1 SECTION "The jME3 Threading Model" [1-1092] -->
+<!-- EDIT1 SECTION "The jME3 Threading Model" [1-1143] -->
 <h1><a>Multithreading Optimization</a></h1>
 <div>
 
@@ -46,7 +46,7 @@ Effectively, each for-loop in the main update loop might be a chance for multith
 </p>
 
 </div>
-<!-- EDIT2 SECTION "Multithreading Optimization" [1093-2223] -->
+<!-- EDIT2 SECTION "Multithreading Optimization" [1144-2274] -->
 <h2><a>Java Multithreading</a></h2>
 <div>
 
@@ -65,7 +65,7 @@ The java.util.concurrent package provides a good foundation for multithreading a
 </ul>
 
 </div>
-<!-- EDIT3 SECTION "Java Multithreading" [2224-3296] -->
+<!-- EDIT3 SECTION "Java Multithreading" [2275-3347] -->
 <h2><a>Multithreading in jME3</a></h2>
 <div>
 
@@ -83,7 +83,7 @@ To avoid slowdown, we decide to keep the pathfinding operations in the NPC Contr
 </p>
 
 </div>
-<!-- EDIT4 SECTION "Multithreading in jME3" [3297-3969] -->
+<!-- EDIT4 SECTION "Multithreading in jME3" [3348-4020] -->
 <h3><a>Executor</a></h3>
 <div>
 
@@ -110,7 +110,7 @@ In your simple application you can override the destroy method and shutdown the
     &#125;</pre>
 
 </div>
-<!-- EDIT5 SECTION "Executor" [3970-5045] -->
+<!-- EDIT5 SECTION "Executor" [4021-5096] -->
 <h3><a>Control Class Fields</a></h3>
 <div>
 
@@ -130,7 +130,7 @@ Here we also created the Future variable to track the state of this task.
 </p>
 
 </div>
-<!-- EDIT6 SECTION "Control Class Fields" [5046-5636] -->
+<!-- EDIT6 SECTION "Control Class Fields" [5097-5687] -->
 <h3><a>Control Update() Method</a></h3>
 <div>
 
@@ -143,7 +143,7 @@ Next let&#039;s look at the update() call of the Control where the time-intensiv
         //If we have no waylist and not started a callable yet, do so!
         if&#40;wayList == null &amp;&amp; future == null&#41;&#123;
             //set the desired location vector, after that we should not modify it anymore
-            //because its being accessed on the other thread!
+            //because it's being accessed on the other thread!
             desiredLocation.set&#40;getGoodNextLocation&#40;&#41;&#41;;
             //start the callable on the executor
             future = executor.submit&#40;findWay&#41;;    //  Thread starts!
@@ -178,7 +178,7 @@ Remember not to mess with the class fields after starting the thread, because th
 </p>
 
 </div>
-<!-- EDIT7 SECTION "Control Update() Method" [5637-7507] -->
+<!-- EDIT7 SECTION "Control Update() Method" [5688-7559] -->
 <h3><a>The Callable</a></h3>
 <div>
 
@@ -230,7 +230,17 @@ private Callable&lt;MyWayList&gt; findWay = new Callable&lt;MyWayList&gt;&#40;&#
 &#125;;</pre>
 
 </div>
-<!-- EDIT8 SECTION "The Callable" [7508-9874] -->
+<!-- EDIT8 SECTION "The Callable" [7560-9926] -->
+<h2><a>Useful Links</a></h2>
+<div>
+
+<p>
+
+High level description which describes how to manage the game state and the rendering in different threads - <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://www.altdevblogaday.com/2011/07/03/threading-and-your-game-loop/"><param name="text" value="<html><u>link</u></html>"><param name="textColor" value="blue"></object>
+</p>
+
+</div>
+<!-- EDIT9 SECTION "Useful Links" [9927-10143] -->
 <h2><a>Conclusion</a></h2>
 <div>
 
@@ -249,5 +259,5 @@ The cool thing about this approach is that every entity creates one self-contain
 </span></div>
 
 </div>
-<!-- EDIT9 SECTION "Conclusion" [9875-] -->
+<!-- EDIT10 SECTION "Conclusion" [10144-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:multithreading?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/networking.html

@@ -53,15 +53,17 @@ You can register several types of listeners to be notified of changes.
 </li>
 <li><div> ConnectionListeners inform the Server about HostedConnection arrivals and removals, e.g. if a client joins or quits.</div>
 </li>
+<li><div> ErrorListeners inform the Client about network exceptions that have happened, e.g. if the server crashes, the client throws a ConnectorException, this can be picked up so that the application can do something about it.</div>
+</li>
 </ul>
 
 </div>
-<!-- EDIT2 SECTION "SpiderMonkey API Overview" [842-2386] -->
+<!-- EDIT2 SECTION "SpiderMonkey API Overview" [842-2609] -->
 <h2><a>Client and Server</a></h2>
 <div>
 
 </div>
-<!-- EDIT4 SECTION "Client and Server" [2387-2417] -->
+<!-- EDIT4 SECTION "Client and Server" [2610-2640] -->
 <h3><a>Creating a Server</a></h3>
 <div>
 
@@ -96,7 +98,7 @@ When you run this app on a host, the server is ready to accept clients. Let&#039
 </p>
 
 </div>
-<!-- EDIT5 SECTION "Creating a Server" [2418-3368] -->
+<!-- EDIT5 SECTION "Creating a Server" [2641-3591] -->
 <h3><a>Creating a Client</a></h3>
 <div>
 
@@ -135,7 +137,7 @@ When you run this client, it connects to the server.
 </p>
 
 </div>
-<!-- EDIT6 SECTION "Creating a Client" [3369-4534] -->
+<!-- EDIT6 SECTION "Creating a Client" [3592-4757] -->
 <h3><a>Getting Info About a Client</a></h3>
 <div>
 
@@ -158,7 +160,7 @@ The server refers to a connected client as com.jme3.network.HostedConnection obj
 		<td>myServer.getConnection(0)</td><td>Server gets the first (0), second (1), etc, connected HostedConnection object (one client).</td>
 	</tr>
 </table></div>
-<!-- EDIT8 TABLE [4711-5090] -->
+<!-- EDIT8 TABLE [4934-5313] -->
 <p>
 
 Your game can define its own game data based on whatever criteria you want, typically these include player ID and state. If the server needs to look up player/client-specific information, you can store this information directly on the HostedConnection object. The following examples read and write a custom Java object <code>MyState</code> in the HostedConnection object <code>conn</code>:
@@ -175,14 +177,14 @@ Your game can define its own game data based on whatever criteria you want, typi
 		<td> MyState state = conn.getAttribute(&quot;MyState&quot;)</td><td> Server can read an attribute of the HostedConnection. </td>
 	</tr>
 </table></div>
-<!-- EDIT9 TABLE [5465-5694] -->
+<!-- EDIT9 TABLE [5688-5917] -->
 </div>
-<!-- EDIT7 SECTION "Getting Info About a Client" [4535-5695] -->
+<!-- EDIT7 SECTION "Getting Info About a Client" [4758-5918] -->
 <h2><a>Messaging</a></h2>
 <div>
 
 </div>
-<!-- EDIT10 SECTION "Messaging" [5696-5718] -->
+<!-- EDIT10 SECTION "Messaging" [5919-5941] -->
 <h3><a>Creating Message Types</a></h3>
 <div>
 
@@ -203,7 +205,7 @@ You must register each message type to the com.jme3.network.serializing.Serializ
 <pre>Serializer.registerClass&#40;HelloMessage.class&#41;;</pre>
 
 </div>
-<!-- EDIT11 SECTION "Creating Message Types" [5719-6671] -->
+<!-- EDIT11 SECTION "Creating Message Types" [5942-6894] -->
 <h3><a>Responding to Messages</a></h3>
 <div>
 
@@ -260,7 +262,7 @@ For each message type, register a server listener to the server:
 <pre>myServer.addMessageListener&#40;new ServerListener&#40;&#41;, HelloMessage.class&#41;;</pre>
 
 </div>
-<!-- EDIT12 SECTION "Responding to Messages" [6672-8416] -->
+<!-- EDIT12 SECTION "Responding to Messages" [6895-8639] -->
 <h3><a>Creating and Sending Messages</a></h3>
 <div>
 
@@ -297,7 +299,7 @@ The last two broadcasting methods use com.jme3.network.Filters to select a subse
 </p>
 
 </div>
-<!-- EDIT13 SECTION "Creating and Sending Messages" [8417-9506] -->
+<!-- EDIT13 SECTION "Creating and Sending Messages" [8640-9729] -->
 <h2><a>Identification and Rejection</a></h2>
 <div>
 
@@ -308,21 +310,22 @@ The ID of the Client and HostedConnection are the same at both ends of a connect
 <pre>... myClient.getId&#40;&#41; ...</pre>
 
 <p>
-A server has a game version and game name property. Each client expects to communicate with a server with a certain game name and version. Test first whether the game name matches, and then whether game version matches, before sending any messages! If they do not match, you should refuse to connect, because unmatched clients and servers will likely miscommunicate.
+A server has a game version and game name property. Each client expects to communicate with a server with a certain game name and version. Test first whether the game name matches, and then whether game version matches, before sending any messages! If they do not match, SpiderMoney will reject it for you, you have no choice in the mater. This is so the client and server can avoid miscommunication.
 </p>
 
 <p>
 <p><div>Typically, your networked game defines its own attributes (such as player ID) based on whatever criteria you want. If you want to look up player/client-specific information beyond the game version, you can set this information directly on the Client/HostedConnection object (see Getting Info About a Client).
 </div></p>
+
 </p>
 
 </div>
-<!-- EDIT14 SECTION "Identification and Rejection" [9507-10424] -->
+<!-- EDIT14 SECTION "Identification and Rejection" [9730-10680] -->
 <h2><a>Closing Clients and Server Cleanly</a></h2>
 <div>
 
 </div>
-<!-- EDIT15 SECTION "Closing Clients and Server Cleanly" [10425-10471] -->
+<!-- EDIT15 SECTION "Closing Clients and Server Cleanly" [10681-10727] -->
 <h3><a>Closing a Client</a></h3>
 <div>
 
@@ -338,7 +341,7 @@ You must override the client&#039;s destroy() method to close the connection cle
   &#125;</pre>
 
 </div>
-<!-- EDIT16 SECTION "Closing a Client" [10472-10747] -->
+<!-- EDIT16 SECTION "Closing a Client" [10728-11003] -->
 <h3><a>Closing a Server</a></h3>
 <div>
 
@@ -354,7 +357,7 @@ You must override the server&#039;s destroy() method to close the connection whe
   &#125;</pre>
 
 </div>
-<!-- EDIT17 SECTION "Closing a Server" [10748-11004] -->
+<!-- EDIT17 SECTION "Closing a Server" [11004-11260] -->
 <h3><a>Kicking a Client</a></h3>
 <div>
 
@@ -365,7 +368,7 @@ The server can kick a HostedConnection to make it disconnect. You should provide
 <pre>conn.close&#40;&quot;We kick cheaters.&quot;&#41;;</pre>
 
 </div>
-<!-- EDIT18 SECTION "Kicking a Client" [11005-11395] -->
+<!-- EDIT18 SECTION "Kicking a Client" [11261-11651] -->
 <h2><a>Listening to Connection Notification</a></h2>
 <div>
 
@@ -375,13 +378,18 @@ The server and clients are notified about connection changes.
 </p>
 
 </div>
-<!-- EDIT19 SECTION "Listening to Connection Notification" [11396-11507] -->
+<!-- EDIT19 SECTION "Listening to Connection Notification" [11652-11763] -->
 <h3><a>ClientStateListener</a></h3>
 <div>
 
 <p>
 
 The com.jme3.network.ClientStateListener notifies the Client when the Client has fully connected to the server (including any internal handshaking), and when the Client is kicked (disconnected) from the server.
+</p>
+
+<p>
+<p><div>The ClientStateListener when it receives a network exception applies the default close action. This just stops the client and you&#039;ll have to build around it so your application knows what to do. If you need more control when a network exception happens and the client closes, you may want to investigate in a ErrorListener.
+</div></p>
 
 </p>
 <div><table>
@@ -395,7 +403,7 @@ The com.jme3.network.ClientStateListener notifies the Client when the Client has
 		<td> public void clientDisconnected(Client c, DisconnectInfo info){} </td><td> Implement here what happens after the server kicks this client. For example, display the DisconnectInfo to the user. </td>
 	</tr>
 </table></div>
-<!-- EDIT21 TABLE [11750-12119] -->
+<!-- EDIT21 TABLE [12348-12717] -->
 <p>
 
 First implement the ClientStateListener interface in the Client class. Then register it to myClient in MyGameClient&#039;s simpleInitApp() method:
@@ -403,7 +411,7 @@ First implement the ClientStateListener interface in the Client class. Then regi
 <pre>myClient.addClientStateListener&#40;this&#41;;</pre>
 
 </div>
-<!-- EDIT20 SECTION "ClientStateListener" [11508-12321] -->
+<!-- EDIT20 SECTION "ClientStateListener" [11764-12918] -->
 <h3><a>ConnectionListener</a></h3>
 <div>
 
@@ -423,7 +431,7 @@ The com.jme3.network.ConnectionListener notifies the Server whenever new HostedC
 		<td> public void connectionRemoved(Server s, HostedConnection c){} </td><td> Implement here what happens after a HostedConnection has left. E.g. a player has quit the game and the server removes his character. </td>
 	</tr>
 </table></div>
-<!-- EDIT23 TABLE [12587-12985] -->
+<!-- EDIT23 TABLE [13184-13582] -->
 <p>
 
 First implement the ConnectionListener interface in the Server class. Then register it to myServer in MyGameServer&#039;s simpleInitApp() method. 
@@ -432,7 +440,55 @@ First implement the ConnectionListener interface in the Server class. Then regis
 <pre>myServer.addConnectionListener&#40;this&#41;;</pre>
 
 </div>
-<!-- EDIT22 SECTION "ConnectionListener" [12322-13185] -->
+<!-- EDIT22 SECTION "ConnectionListener" [12919-13782] -->
+<h3><a>ErrorListener</a></h3>
+<div>
+
+<p>
+
+The com.jme3.network.ErrorListener is a listener for when network exception happens. This listener is built so that you can override the default actions when a network exception happens.
+</p>
+
+<p>
+<p><div>If you intend on using the default network mechanics, <strong>don&#039;t</strong> use this!
+If you do override this, make sure you add a mechanic that can close the client otherwise your client will get stuck open and cause errors.
+</div></p>
+
+</p>
+<div><table>
+	<tr>
+		<th> ErrorListener interface method </th><th> Purpose </th>
+	</tr>
+	<tr>
+		<td> public void handleError(Client c, Throwable t){} </td><td> Implemenent here what happens after a exception affects the network . </td>
+	</tr>
+</table></div>
+<!-- EDIT25 TABLE [14233-14402] -->
+<p>
+
+<p><div>This interface was built for the client and server, but the code has never been put on the server to handle this listener.
+</div></p>
+</p>
+
+<p>
+First implement the ErrorListener interface in the client class. Then you need to register it to myClient in MyGameClients&#039;s simpleInitApp() method.
+</p>
+<pre>myClient.addErrorListener&#40;this&#41;;</pre>
+
+<p>
+In the class that implements the ErrorListener, a method would of been added call handleError(Client s, Throwable t). Inside this method to get you started, you going to want to listen for an error. To do this you&#039;re going to want a bit of code like this.
+</p>
+<pre>if&#40;t instanceof exception&#41; &#123;
+     //Add your own code here
+&#125;</pre>
+
+<p>
+Replace <strong>exception</strong> part in the <strong>if</strong> statement for the type of exception that you would like it to handle.
+
+</p>
+
+</div>
+<!-- EDIT24 SECTION "ErrorListener" [13783-15194] -->
 <h2><a>UDP versus TCP</a></h2>
 <div>
 
@@ -450,7 +506,7 @@ message2.setReliable&#40;false&#41;; // UDP</pre>
 </ul>
 
 </div>
-<!-- EDIT24 SECTION "UDP versus TCP" [13186-13856] -->
+<!-- EDIT26 SECTION "UDP versus TCP" [15195-15865] -->
 <h2><a>Important: Use Multi-Threading</a></h2>
 <div>
 
@@ -474,7 +530,7 @@ For general advice, see the articles <object classid="java:org.netbeans.modules.
 </p>
 
 </div>
-<!-- EDIT25 SECTION "Important: Use Multi-Threading" [13857-15003] -->
+<!-- EDIT27 SECTION "Important: Use Multi-Threading" [15866-17012] -->
 <h2><a>Troubleshooting</a></h2>
 <div>
 
@@ -489,5 +545,5 @@ If you have set up a server in your home network, and the game clients cannot re
 </span></div>
 
 </div>
-<!-- EDIT26 SECTION "Troubleshooting" [15004-] -->
+<!-- EDIT28 SECTION "Troubleshooting" [17013-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:networking?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/nifty_gui.html

@@ -154,10 +154,16 @@ Learn more from the NiftyGUI page:
 </li>
 <li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://jmonkeyengine.org/groups/gui/forum/topic/anyone-succeeded-in-changing-text-in-nifty-programatically/#post-109510"><param name="text" value="<html><u>Forum post: Changing Text in Nifty GUIs programmatically</u></html>"><param name="textColor" value="blue"></object></div>
 </li>
+<li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:nifty_gui:editor"><param name="text" value="<html><u>Official Nifty GUI Editor</u></html>"><param name="textColor" value="blue"></object></div>
+</li>
+<li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:nifty_gui:new_editor"><param name="text" value="<html><u>New Nifty GUI Editor</u></html>"><param name="textColor" value="blue"></object></div>
+</li>
+<li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:nifty_gui:groovy"><param name="text" value="<html><u>Nifty GUI with Groovy</u></html>"><param name="textColor" value="blue"></object></div>
+</li>
 </ul>
 
 </div>
-<!-- EDIT6 SECTION "External Documentation" [3741-4357] -->
+<!-- EDIT6 SECTION "External Documentation" [3741-4677] -->
 <h2><a>Next Steps</a></h2>
 <div>
 
@@ -170,10 +176,12 @@ Now that you understand the concepts and know where to find more information, le
 </li>
 <li><div> <a href="/com/jme3/gde/docs/jme3/advanced/nifty_gui_java_layout.html">Lay out the GUI in Java</a> (optional)</div>
 </li>
+<li><div> <a href="/com/jme3/gde/docs/jme3/advanced/nifty_gui_editor.html">Lay out the GUI in Editor</a> (experimental)</div>
+</li>
 </ul>
 
 </div>
-<!-- EDIT7 SECTION "Next Steps" [4358-4717] -->
+<!-- EDIT7 SECTION "Next Steps" [4678-5117] -->
 <h2><a>Nifty Logging (Nifty 1.3.1)</a></h2>
 <div>
 
@@ -191,5 +199,5 @@ Logger.getLogger(&quot;NiftyInputEventHandlingLog&quot;).setLevel(Level.SEVERE);
 </span></div>
 
 </div>
-<!-- EDIT8 SECTION "Nifty Logging (Nifty 1.3.1)" [4718-] -->
+<!-- EDIT8 SECTION "Nifty Logging (Nifty 1.3.1)" [5118-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:nifty_gui?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/nifty_gui_java_interaction.html

@@ -26,7 +26,7 @@ In the previous parts of the tutorial, you created a two-screen user interface.
 
 <p>
 
-To let a Nifty screen communicate with the Java application, you register a <code>ScreenController</code> to every NiftyGUI screen. You create a ScreenController by creating a Java class that implements the <code>de.lessvoid.nifty.screen.ScreenController</code> interface and its abtract methods.
+To let a Nifty screen communicate with the Java application, you register a <code>ScreenController</code> to every NiftyGUI screen. You create a ScreenController by creating a Java class that implements the <code>de.lessvoid.nifty.screen.ScreenController</code> interface and its abstract methods.
 </p>
 
 <p>
@@ -100,7 +100,7 @@ Now the Java class <code>MyStartScreen</code> and this <acronym title="Graphical
 </p>
 
 </div>
-<!-- EDIT2 SECTION "Connect GUI to Java Controller" [792-3174] -->
+<!-- EDIT2 SECTION "Connect GUI to Java Controller" [792-3175] -->
 <h2><a>Make GUI and Java Interact</a></h2>
 <div>
 
@@ -114,7 +114,7 @@ Use any combination of the three following approaches to make Java classes inter
 </p>
 
 </div>
-<!-- EDIT3 SECTION "Make GUI and Java Interact" [3175-3547] -->
+<!-- EDIT3 SECTION "Make GUI and Java Interact" [3176-3548] -->
 <h3><a>GUI Calls a Void Java Method</a></h3>
 <div>
 
@@ -214,7 +214,7 @@ The quitGame() example shows that you have access to the application <code>app</
 </p>
 
 </div>
-<!-- EDIT4 SECTION "GUI Calls a Void Java Method" [3548-6724] -->
+<!-- EDIT4 SECTION "GUI Calls a Void Java Method" [3549-6725] -->
 <h3><a>GUI Gets Return Value from Java Method</a></h3>
 <div>
 
@@ -253,7 +253,7 @@ You can use this for Strings and numeric values (e.g. when you read settings fro
 </p>
 
 </div>
-<!-- EDIT5 SECTION "GUI Gets Return Value from Java Method" [6725-7912] -->
+<!-- EDIT5 SECTION "GUI Gets Return Value from Java Method" [6726-7913] -->
 <h3><a>Java Modifies Nifty Elements and Events</a></h3>
 <div>
 
@@ -293,7 +293,7 @@ For this to work, there already needs to be a (possibly inactive) <code>&lt;inte
 <pre><span>&lt;interact onClick=&quot;doNothing()&quot;/&gt;</span></pre>
 
 </div>
-<!-- EDIT6 SECTION "Java Modifies Nifty Elements and Events" [7913-9329] -->
+<!-- EDIT6 SECTION "Java Modifies Nifty Elements and Events" [7914-9330] -->
 <h2><a>Next Steps</a></h2>
 <div>
 
@@ -317,5 +317,5 @@ You&#039;re done with the basic Nifty <acronym title="Graphical User Interface">
 </span></div>
 
 </div>
-<!-- EDIT7 SECTION "Next Steps" [9330-] -->
+<!-- EDIT7 SECTION "Next Steps" [9331-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:nifty_gui_java_interaction?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/nifty_gui_scenarios.html

@@ -104,8 +104,22 @@ public StartScreenState(SimpleApplication app){
  
 &#125;</pre>
 
+<p>
+
+<p><div>It is not sufficient to just inherit from AbstractAppState. You need to instantiate your controller class, register it with app&#039;s stateManager and then pass it to nifty. See code sample below.
+</div></p>
+</p>
+<pre>public class TestNiftyGui extends SimpleApplication &#123;
+  public void simpleInitApp&#40;&#41; &#123;
+     StartScreenState startScreenState = new StartScreenState&#40;this&#41;;
+     stateManager.attach&#40;startScreenState&#41;;
+     // [...] boilerplate init nifty omitted
+     nifty.fromXml&#40;&quot;Interface/myGui.xml&quot;, &quot;start&quot;, startScreenState&#41;; //one of the XML screen elements needs to reference StartScreenState controller class
+  &#125;
+&#125;</pre>
+
 </div>
-<!-- EDIT3 SECTION "Get Access to Application and Update Loop" [2044-3599] -->
+<!-- EDIT3 SECTION "Get Access to Application and Update Loop" [2044-4243] -->
 <h2><a>Know Your Variables</a></h2>
 <div>
 <div><table>
@@ -125,14 +139,14 @@ public StartScreenState&#40;SimpleApplication app&#41;&#123;
 		<td>${PROP.key}</td><td> looks up <code>key</code> in the Nifty properties. Use Nifty.setGlobalproperties(properties) and Nifty.getGlobalproperties(&quot;key&quot;). Or SystemGetProperties(key);</td>
 	</tr>
 </table></div>
-<!-- EDIT5 TABLE [3632-4163] -->
+<!-- EDIT5 TABLE [4276-4807] -->
 <p>
 
 See also: <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://sourceforge.net/apps/mediawiki/nifty-gui/index.php?title=MarkUp"><param name="text" value="<html><u>http://sourceforge.net/apps/mediawiki/nifty-gui/index.php?title=MarkUp</u></html>"><param name="textColor" value="blue"></object>
 </p>
 
 </div>
-<!-- EDIT4 SECTION "Know Your Variables" [3600-4246] -->
+<!-- EDIT4 SECTION "Know Your Variables" [4244-4890] -->
 <h2><a>Use ScreenControllers for Mutally Exclusive Functionality</a></h2>
 <div>
 
@@ -152,7 +166,7 @@ For example, create a <code>MyHudScreen.java</code> for the <code>hud</code> scr
 </ul>
 
 </div>
-<!-- EDIT6 SECTION "Use ScreenControllers for Mutally Exclusive Functionality" [4247-5629] -->
+<!-- EDIT6 SECTION "Use ScreenControllers for Mutally Exclusive Functionality" [4891-6273] -->
 <h2><a>Create a &quot;Loading...&quot; Screen</a></h2>
 <div>
 
@@ -162,7 +176,7 @@ Get the full <a href="/com/jme3/gde/docs/jme3/advanced/loading_screen.html">Load
 </p>
 
 </div>
-<!-- EDIT7 SECTION "Create a Loading... Screen" [5630-5734] -->
+<!-- EDIT7 SECTION "Create a Loading... Screen" [6274-6378] -->
 <h2><a>Create a Popup Menu</a></h2>
 <div>
 
@@ -172,7 +186,7 @@ Get the full <a href="/com/jme3/gde/docs/jme3/advanced/nifty_gui_popup_menu.html
 </p>
 
 </div>
-<!-- EDIT8 SECTION "Create a Popup Menu" [5735-5837] -->
+<!-- EDIT8 SECTION "Create a Popup Menu" [6379-6481] -->
 <h2><a>Add Visual Effects</a></h2>
 <div>
 
@@ -206,7 +220,7 @@ Learn more from the NiftyGUI page:
 </ul>
 
 </div>
-<!-- EDIT9 SECTION "Add Visual Effects" [5838-6550] -->
+<!-- EDIT9 SECTION "Add Visual Effects" [6482-7194] -->
 <h2><a>Add Sound Effects</a></h2>
 <div>
 
@@ -223,7 +237,7 @@ Playing sounds using Nifty is also possible with a <code>playSound</code> effect
 <span><span>&lt;/label&gt;</span></span></pre>
 
 </div>
-<!-- EDIT10 SECTION "Add Sound Effects" [6551-6913] -->
+<!-- EDIT10 SECTION "Add Sound Effects" [7195-7557] -->
 <h2><a>Pass ClickLoc From Nifty to Java</a></h2>
 <div>
 
@@ -253,7 +267,7 @@ You can name the method (here <code>clicked</code>) what ever you like, as long
 </p>
 
 </div>
-<!-- EDIT11 SECTION "Pass ClickLoc From Nifty to Java" [6914-7675] -->
+<!-- EDIT11 SECTION "Pass ClickLoc From Nifty to Java" [7558-8319] -->
 <h2><a>Load Several XML Files</a></h2>
 <div>
 
@@ -274,7 +288,7 @@ stateManager.attach&#40;optionsControl&#41;;
 guiViewPort.addProcessor&#40;niftyDisplay&#41;;</pre>
 
 </div>
-<!-- EDIT12 SECTION "Load Several XML Files" [7676-8724] -->
+<!-- EDIT12 SECTION "Load Several XML Files" [8320-9368] -->
 <h2><a>Register additional explicit screen controllers</a></h2>
 <div>
 
@@ -293,7 +307,7 @@ nifty.registerScreenController&#40;new OptionsScreenController&#40;randomConstru
 nifty.addXml&#40;&quot;Interface/Screens/OptionsScreen.xml&quot;&#41;;</pre>
 
 </div>
-<!-- EDIT13 SECTION "Register additional explicit screen controllers" [8725-9493] -->
+<!-- EDIT13 SECTION "Register additional explicit screen controllers" [9369-10137] -->
 <h2><a>Design Your Own Styles</a></h2>
 <div>
 
@@ -345,5 +359,5 @@ Learn more from the NiftyGUI page:
 </span></div>
 
 </div>
-<!-- EDIT14 SECTION "Design Your Own Styles" [9494-] -->
+<!-- EDIT14 SECTION "Design Your Own Styles" [10138-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:nifty_gui_scenarios?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/nifty_gui_xml_layout.html

@@ -100,7 +100,7 @@ The following minimal <acronym title="Extensible Markup Language">XML</acronym>
 <pre><span>&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;</span>
 <span>&lt;nifty xmlns=&quot;http://nifty-gui.sourceforge.net/nifty-1.3.xsd&quot;</span>
 <span>  xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot;</span>
-<span>  xsi:schemaLocation=&quot;http://nifty-gui.sourceforge.net/nifty-1.3.xsd http://nifty-gui.sourceforge.net/nifty-1.3.xsd&quot;&gt;</span>
+<span>  xsi:schemaLocation=&quot;http://nifty-gui.sourceforge.net/nifty-1.3.xsd&quot;&gt;</span>
   <span>&lt;screen id=&quot;start&quot;&gt;</span>
     &lt;!-- ... --&gt;
   <span><span>&lt;/screen&gt;</span></span>
@@ -118,7 +118,7 @@ Every Nifty <acronym title="Graphical User Interface">GUI</acronym> must have a
 </p>
 
 </div>
-<!-- EDIT4 SECTION "Make Screens" [2140-2872] -->
+<!-- EDIT4 SECTION "Make Screens" [2140-2825] -->
 <h3><a>Make Layers</a></h3>
 <div>
 
@@ -150,7 +150,7 @@ In a layer, you can now add panels and arrange them. Panels are containers that
 </p>
 
 </div>
-<!-- EDIT5 SECTION "Make Layers" [2873-3646] -->
+<!-- EDIT5 SECTION "Make Layers" [2826-3599] -->
 <h3><a>Make Panels</a></h3>
 <div>
 
@@ -203,7 +203,7 @@ The result should look as follows:
 </p>
 
 </div>
-<!-- EDIT6 SECTION "Make Panels" [3647-5529] -->
+<!-- EDIT6 SECTION "Make Panels" [3600-5482] -->
 <h2><a>Adding Content to Panels</a></h2>
 <div>
 
@@ -213,7 +213,7 @@ See also <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><
 </p>
 
 </div>
-<!-- EDIT7 SECTION "Adding Content to Panels" [5530-5708] -->
+<!-- EDIT7 SECTION "Adding Content to Panels" [5483-5661] -->
 <h3><a>Add Images</a></h3>
 <div>
 
@@ -258,7 +258,7 @@ This image is scaled to use 50% of the height and 30% of the width of its contai
 </p>
 
 </div>
-<!-- EDIT8 SECTION "Add Images" [5709-7395] -->
+<!-- EDIT8 SECTION "Add Images" [5662-7348] -->
 <h3><a>Add Static Text</a></h3>
 <div>
 
@@ -285,7 +285,7 @@ The font used is jME3&#039;s default font &quot;Interface/Fonts/Default.fnt&quot
 </p>
 
 </div>
-<!-- EDIT9 SECTION "Add Static Text" [7396-8476] -->
+<!-- EDIT9 SECTION "Add Static Text" [7349-8429] -->
 <h3><a>Add Controls</a></h3>
 <div>
 
@@ -351,7 +351,7 @@ Nifty additionally offers many customizable controls such as check boxes, text f
 </p>
 
 </div>
-<!-- EDIT10 SECTION "Add Controls" [8477-10564] -->
+<!-- EDIT10 SECTION "Add Controls" [8430-10517] -->
 <h2><a>Intermediate Result</a></h2>
 <div>
 
@@ -369,7 +369,7 @@ Compare this result with the layout draft above.
 </p>
 
 </div>
-<!-- EDIT11 SECTION "Intermediate Result" [10565-10925] -->
+<!-- EDIT11 SECTION "Intermediate Result" [10518-10878] -->
 <h2><a>Next Steps</a></h2>
 <div>
 
@@ -391,5 +391,5 @@ Integrate the <acronym title="Graphical User Interface">GUI</acronym> into the g
 </span></div>
 
 </div>
-<!-- EDIT12 SECTION "Next Steps" [10926-] -->
+<!-- EDIT12 SECTION "Next Steps" [10879-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:nifty_gui_xml_layout?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/physics.html

@@ -360,12 +360,12 @@ Click the links for details on the special PhysicsControls. This article is abou
 
 </div>
 <!-- EDIT10 SECTION "Create PhysicsControl" [13625-15611] -->
-<h3><a>PhysicsControls Code Samples</a></h3>
+<h3><a>Physics Control Code Samples</a></h3>
 <div>
 
 <p>
 
-The PhysicsControl constructors expect a Collision Shape and a mass (a float in kilogram). The most commonly used PhysicsControl is the RigidBodyControl:
+The most commonly used physics control is RigidBodyControl.  The RigidBodyControl constructor takes up to two parameters:  a collision shape and a mass (a float in kilograms).  The mass parameter also determines whether the object is dynamic (movable) or static (fixed). For a static object such as a floor or wall, specify zero mass. 
 </p>
 <pre>RigidBodyControl myThing_phys = 
     new RigidBodyControl&#40; myThing_shape , 123.0f &#41;; // dynamic</pre>
@@ -373,7 +373,7 @@ The PhysicsControl constructors expect a Collision Shape and a mass (a float in
     new RigidBodyControl&#40; myDungeon_shape , 0.0f &#41;; // static </pre>
 
 <p>
-<p><div>When you create the PhysicsControl, the mass value makes an important distinction: Set the mass to a non-zero value to create a dynamic object that can fall or roll, etc. Set the mass value to zero to create a static object, such as floor, wall, etc. If you give your floor a mass, it will fall out of the scene! 
+<p><div>If you give your floor a non-zero mass, it will fall out of the scene!
 </div></p>
 </p>
 
@@ -395,10 +395,11 @@ gameLevel.addControl&#40;new RigidBodyControl&#40;0.0f&#41;&#41;; // explicit ze
 <p>
 <p><div>Spheres and Boxes automatically fall back on the correct default CollisionShape if you do not specify a CollisionShape in the RigidBodyControl constructor. Complex static objects can fall back on MeshCollisionShapes, unless it is a Node, in which case it will become a CompoundCollisionShape containing a MeshCollisionShape
 </div></p>
+
 </p>
 
 </div>
-<!-- EDIT13 SECTION "PhysicsControls Code Samples" [15612-17191] -->
+<!-- EDIT13 SECTION "Physics Control Code Samples" [15612-17129] -->
 <h2><a>Add PhysicsControl to Spatial</a></h2>
 <div>
 
@@ -415,7 +416,7 @@ For each physical Spatial in the scene:
 </ol>
 
 </div>
-<!-- EDIT14 SECTION "Add PhysicsControl to Spatial" [17192-17439] -->
+<!-- EDIT14 SECTION "Add PhysicsControl to Spatial" [17130-17377] -->
 <h2><a>Add PhysicsControl to PhysicsSpace</a></h2>
 <div>
 
@@ -442,7 +443,7 @@ myThing_geo.removeFromParent&#40;&#41;;</pre>
 </p>
 
 </div>
-<!-- EDIT15 SECTION "Add PhysicsControl to PhysicsSpace" [17440-18255] -->
+<!-- EDIT15 SECTION "Add PhysicsControl to PhysicsSpace" [17378-18193] -->
 <h2><a>Changing the Scale of a PhysicsControl</a></h2>
 <div>
 
@@ -481,7 +482,7 @@ With the corresponding output below:
 </p>
 
 </div>
-<!-- EDIT16 SECTION "Changing the Scale of a PhysicsControl" [18256-20006] -->
+<!-- EDIT16 SECTION "Changing the Scale of a PhysicsControl" [18194-19944] -->
 <h3><a>PhysicsSpace Code Samples</a></h3>
 <div>
 
@@ -511,9 +512,9 @@ setWorldMin(new Vector3f(-10000f, -10000f, -10000f));</td><td>Specifies the size
 		<td>setCcdMotionThreshold()</td><td>The amount of motion in 1 physics tick to trigger the continuous motion detection in moving objects that push one another. Rarely used, but necessary if your moving objects get stuck or roll through one another.</td>
 	</tr>
 </table></div>
-<!-- EDIT18 TABLE [20233-21440] -->
+<!-- EDIT18 TABLE [20171-21378] -->
 </div>
-<!-- EDIT17 SECTION "PhysicsSpace Code Samples" [20007-21441] -->
+<!-- EDIT17 SECTION "PhysicsSpace Code Samples" [19945-21379] -->
 <h2><a>Specify Physical Properties</a></h2>
 <div>
 
@@ -553,7 +554,7 @@ This setting has an impact on performance, so use it sparingly. </td><td> Brick:
 Rubber ball: 1.0f </td>
 	</tr>
 </table></div>
-<!-- EDIT20 TABLE [21666-23176] -->
+<!-- EDIT20 TABLE [21604-23114] -->
 <p>
 
 On a RigidBodyControl, you can apply the following physical forces:
@@ -574,9 +575,9 @@ On a RigidBodyControl, you can apply the following physical forces:
 (See detailed explanation below.) </td>
 	</tr>
 </table></div>
-<!-- EDIT21 TABLE [23247-23857] -->
+<!-- EDIT21 TABLE [23185-23795] -->
 </div>
-<!-- EDIT19 SECTION "Specify Physical Properties" [21442-23857] -->
+<!-- EDIT19 SECTION "Specify Physical Properties" [21380-23795] -->
 <h3><a>Kinematic vs Dynamic vs Static</a></h3>
 <div>
 
@@ -626,7 +627,7 @@ setKinematic(true);</td><td>setMass(1f); <br/>
 setKinematic(false);</td>
 	</tr>
 </table></div>
-<!-- EDIT23 TABLE [24094-25153] -->
+<!-- EDIT23 TABLE [24032-25091] -->
 </div>
 
 <h4><a>When Do I Use Kinematic Objects?</a></h4>
@@ -649,7 +650,7 @@ setKinematic(false);</td>
 </p>
 
 </div>
-<!-- EDIT22 SECTION "Kinematic vs Dynamic vs Static" [23858-26259] -->
+<!-- EDIT22 SECTION "Kinematic vs Dynamic vs Static" [23796-26197] -->
 <h2><a>Forces: Moving Dynamic Objects</a></h2>
 <div>
 
@@ -687,7 +688,7 @@ Use the following methods to move dynamic physical objects.
 		<td> clearForces()</td><td>Cancels out all forces (force, torque) etc and stops the motion.</td>
 	</tr>
 </table></div>
-<!-- EDIT25 TABLE [26365-27354] -->
+<!-- EDIT25 TABLE [26303-27292] -->
 <p>
 
 <p><div>It is technically possible to position PhysicsControls using setLocalTranslation(), e.g. to place them in their start position in the scene. However you must be very careful not to cause an &quot;impossible state&quot; where one physical object overlaps with another! Within the game, you typically use the setters shown here exclusively.
@@ -727,7 +728,7 @@ removeCollideWithGroup(COLLISION_GROUP_01)</td><td>Collision Groups are integer
 		<td> setCcdSweptSphereRadius(.5f)</td><td>Bullet does not use the full collision shape for continuous collision detection, instead it uses a &quot;swept sphere&quot; shape to approximate a motion, which can be imprecise and cause strange behaviors such as objects passing through one another or getting stuck. Only relevant for fast moving dynamic bodies. </td>
 	</tr>
 </table></div>
-<!-- EDIT26 TABLE [27772-29727] -->
+<!-- EDIT26 TABLE [27710-29665] -->
 <p>
 
 <p><div> You can <code>setApplyPhysicsLocal(true)</code> for an object to make it move relatively to its local physics space. You would do that if you need a physics space that moves with a node (e.g. a spaceship with artificial gravity surrounded by zero-g space). By default, it&#039;s set to false, and all movement is relative to the world.
@@ -735,7 +736,7 @@ removeCollideWithGroup(COLLISION_GROUP_01)</td><td>Collision Groups are integer
 </p>
 
 </div>
-<!-- EDIT24 SECTION "Forces: Moving Dynamic Objects" [26260-30069] -->
+<!-- EDIT24 SECTION "Forces: Moving Dynamic Objects" [26198-30007] -->
 <h2><a>Best Practices</a></h2>
 <div>
 <ul>
@@ -771,7 +772,7 @@ removeCollideWithGroup(COLLISION_GROUP_01)</td><td>Collision Groups are integer
 </span></div>
 
 </div>
-<!-- EDIT27 SECTION "Best Practices" [30070-] --><div>
+<!-- EDIT27 SECTION "Best Practices" [30008-] --><div>
 <div><sup><a href="#fnt__1">1)</a></sup> 
 Inertia is calculated for kinematic objects, and you need mass to do that.</div>
 </div>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/post-processor_water.html

@@ -188,11 +188,11 @@ manager.loadTexture(&quot;Textures/wavenormals.png&quot;) )</td><td>This normal
 	</tr>
 	<tr>
 		<td>water.setWaterColor(ColorRGBA.Brown.mult(2.0f));</td><td>Sets the main water color.</td><td>greenish blue <br/>
-Vector3f(0.0f,0.5f,0.5f,1.0f)</td>
+ColorRGBA(0.0f,0.5f,0.5f,1.0f)</td>
 	</tr>
 	<tr>
 		<td>water.setDeepWaterColor(ColorRGBA.Brown);</td><td>Sets the deep water color.</td><td>dark blue <br/>
-Vector3f(0.0f, 0.0f,0.2f,1.0f)</td>
+ColorRGBA(0.0f, 0.0f,0.2f,1.0f)</td>
 	</tr>
 	<tr>
 		<td>water.setWaterTransparency(0.2f);</td><td>Sets how fast colors fade out. use this to control how clear (e.g. 0.05f) or muddy (0.2f) water is.</td><td> 0.1f </td>
@@ -201,7 +201,7 @@ Vector3f(0.0f, 0.0f,0.2f,1.0f)</td>
 		<td>water.setColorExtinction(new Vector3f(10f,20f,30f));</td><td>Sets At what depth the refraction color extincts. The three values are RGB (red, green, blue) in this order. Play with these parameters to &quot;muddy&quot; the water.</td><td>Vector3f(5f,20f,30f)</td>
 	</tr>
 </table></div>
-<!-- EDIT9 TABLE [6562-7566] --><div><table>
+<!-- EDIT9 TABLE [6562-7568] --><div><table>
 	<tr>
 		<th> Water method example</th><th> Effects: Shore</th><th>Default</th>
 	</tr>
@@ -216,7 +216,7 @@ water.setRadius(260);</td><td>Limit the water filter to a semisphere with the gi
 		<td>water.setUseHQShoreline(false);</td><td>Renders shoreline with better quality ?</td><td>true</td>
 	</tr>
 </table></div>
-<!-- EDIT10 TABLE [7568-8066] --><div><table>
+<!-- EDIT10 TABLE [7570-8068] --><div><table>
 	<tr>
 		<th> Water method example</th><th> Effects: Foam</th><th>Default</th>
 	</tr>
@@ -234,7 +234,7 @@ water.setRadius(260);</td><td>Limit the water filter to a semisphere with the gi
 manager.loadTexture(&quot;Textures/foam.png&quot;) )</td><td>This foam texture will be used with WrapMode.Repeat</td><td>&quot;Common/MatDefs/Water/Textures/foam.jpg&quot;</td>
 	</tr>
 </table></div>
-<!-- EDIT11 TABLE [8068-8713] --><div><table>
+<!-- EDIT11 TABLE [8070-8715] --><div><table>
 	<tr>
 		<th> Water method example</th><th> Effects: Light</th><th>Default</th>
 	</tr>
@@ -260,9 +260,9 @@ manager.loadTexture(&quot;Textures/foam.png&quot;) )</td><td>This foam texture w
 		<td>water.setReflectionMapSize(256)</td><td>Sets the size of the reflection map. The higher, the better the quality, but the slower the effect.</td><td>512</td>
 	</tr>
 </table></div>
-<!-- EDIT12 TABLE [8715-9630] -->
+<!-- EDIT12 TABLE [8717-9632] -->
 </div>
-<!-- EDIT7 SECTION "Optional: Water Wave and Color Effects" [5230-9632] -->
+<!-- EDIT7 SECTION "Optional: Water Wave and Color Effects" [5230-9634] -->
 <h3><a>Sound Effects</a></h3>
 <div>
 
@@ -291,5 +291,5 @@ See also:
 </ul>
 
 </div>
-<!-- EDIT13 SECTION "Sound Effects" [9633-] -->
+<!-- EDIT13 SECTION "Sound Effects" [9635-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:post-processor_water?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/terrain.html

@@ -7,14 +7,14 @@
 The goal of TerraMonkey is to provide a base implementation that will be usable for 80% of people's goals, while providing tools and a good foundation for the other 20% to build off of. Check out the videos in the following announcements:
 </p>
 <ul>
-<li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://jmonkeyengine.org/2011/06/17/infinite-terrains-with-terraingrid-new-features-in-terramonkey/"><param name="text" value="<html><u>New features</u></html>"><param name="textColor" value="blue"></object></div>
+<li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://hub.jmonkeyengine.org/2011/06/17/infinite-terrains-with-terraingrid-new-features-in-terramonkey/"><param name="text" value="<html><u>New features</u></html>"><param name="textColor" value="blue"></object></div>
 </li>
-<li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://jmonkeyengine.org/2011/07/03/terramonkey-more-textures-tools-and-undo/"><param name="text" value="<html><u>More textures and Tools</u></html>"><param name="textColor" value="blue"></object></div>
+<li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://hub.jmonkeyengine.org/2011/07/03/terramonkey-more-textures-tools-and-undo/"><param name="text" value="<html><u>More textures and Tools</u></html>"><param name="textColor" value="blue"></object></div>
 </li>
 </ul>
 
 </div>
-<!-- EDIT1 SECTION "TerraMonkey - The jMonkeyEngine Terrain System" [1-533] -->
+<!-- EDIT1 SECTION "TerraMonkey - The jMonkeyEngine Terrain System" [1-541] -->
 <h2><a>Overview</a></h2>
 <div>
 
@@ -38,7 +38,7 @@ TerraMonkey is a GeoMipMapping quad tree of terrain tiles that supports real tim
 </ul>
 
 </div>
-<!-- EDIT2 SECTION "Overview" [534-1906] -->
+<!-- EDIT2 SECTION "Overview" [542-1914] -->
 <h3><a>Current Features:</a></h3>
 <div>
 <ul>
@@ -55,7 +55,7 @@ TerraMonkey is a GeoMipMapping quad tree of terrain tiles that supports real tim
 </ul>
 
 </div>
-<!-- EDIT3 SECTION "Current Features:" [1907-2293] -->
+<!-- EDIT3 SECTION "Current Features:" [1915-2301] -->
 <h3><a>Planned Features:</a></h3>
 <div>
 <ul>
@@ -66,7 +66,7 @@ TerraMonkey is a GeoMipMapping quad tree of terrain tiles that supports real tim
 </ul>
 
 </div>
-<!-- EDIT4 SECTION "Planned Features:" [2294-2403] -->
+<!-- EDIT4 SECTION "Planned Features:" [2302-2411] -->
 <h2><a>Sample Code</a></h2>
 <div>
 <ul>
@@ -83,7 +83,7 @@ TerraMonkey is a GeoMipMapping quad tree of terrain tiles that supports real tim
 </ul>
 
 </div>
-<!-- EDIT5 SECTION "Sample Code" [2404-3175] -->
+<!-- EDIT5 SECTION "Sample Code" [2412-3183] -->
 <h2><a>Geo Mip Mapping</a></h2>
 <div>
 
@@ -105,7 +105,7 @@ GeoMipMapping in TerraMonkey has been split into several parts: the terrain quad
 </p>
 
 </div>
-<!-- EDIT6 SECTION "Geo Mip Mapping" [3176-4787] -->
+<!-- EDIT6 SECTION "Geo Mip Mapping" [3184-4795] -->
 <h2><a>Terrain Quad Tree</a></h2>
 <div>
 
@@ -115,7 +115,7 @@ TerraMonkey is a quad tree. Each node is a TerrainQuad, and each leaf is a Terra
 </p>
 
 </div>
-<!-- EDIT7 SECTION "Terrain Quad Tree" [4788-5217] -->
+<!-- EDIT7 SECTION "Terrain Quad Tree" [4796-5225] -->
 <h2><a>Texture Splatting</a></h2>
 <div>
 
@@ -185,7 +185,7 @@ Here are the names of TerrainLighting.j3md&#039;s material properties:
 </p>
 
 <p>
-Video cards support a maximum of 16 Splat textures total. This means you can only use a subset of material properties at the same time!
+OpenGL supports a maximum of 16 <em>samplers</em> in any given shader. This means you can only use a subset of material properties at the same time if you use the terrain&#039;s default lighting shader (TerrainLighting.j3md)!
 </p>
 
 <p>
@@ -237,7 +237,7 @@ You can hand-paint Alpha, Diffuse, Glow, and Specular maps in a drawing program,
 </p>
 
 </div>
-<!-- EDIT8 SECTION "Texture Splatting" [5218-9435] -->
+<!-- EDIT8 SECTION "Texture Splatting" [5226-9523] -->
 <h2><a>Code Sample: Terrain.j3md</a></h2>
 <div>
 
@@ -304,5 +304,5 @@ PS: As an alternative to an image-based height map, you can also generate a Hill
 <pre>heightmap = new HillHeightMap&#40;1025, 1000, 50, 100, &#40;byte&#41; 3&#41;;</pre>
 
 </div>
-<!-- EDIT9 SECTION "Code Sample: Terrain.j3md" [9436-] -->
+<!-- EDIT9 SECTION "Code Sample: Terrain.j3md" [9524-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:terrain?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/advanced/walking_character.html

@@ -419,6 +419,15 @@ This method resets the walk animation.
 }
  
 public void onAnimChange&#40;AnimControl control, AnimChannel channel, String animName&#41; &#123; &#125;</pre>
+
+</div>
+<!-- EDIT13 SECTION "Handle Navigation" [10505-14748] -->
+<h2><a>See also</a></h2>
+<div>
+<ul>
+<li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://hub.jmonkeyengine.org/forum/topic/bettercharactercontrol-in-the-works/"><param name="text" value="<html><u>http://hub.jmonkeyengine.org/forum/topic/bettercharactercontrol-in-the-works/</u></html>"><param name="textColor" value="blue"></object></div>
+</li>
+</ul>
 <div><span>
 	<a href="/wiki/doku.php/tag:documentation?do=showtag&amp;tag=tag%3Adocumentation">documentation</a>,
 	<a href="/wiki/doku.php/tag:physics?do=showtag&amp;tag=tag%3Aphysics">physics</a>,
@@ -430,5 +439,5 @@ public void onAnimChange&#40;AnimControl control, AnimChannel channel, String an
 </span></div>
 
 </div>
-<!-- EDIT13 SECTION "Handle Navigation" [10505-] -->
+<!-- EDIT14 SECTION "See also" [14749-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:advanced:walking_character?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/beginner/hello_asset.html

@@ -55,7 +55,7 @@ public class HelloAssets extends SimpleApplication {
         rootNode.attachChild(teapot);
  
         // Create a wall with a simple texture from test_data
-        Box box = new Box(Vector3f.ZERO, 2.5f,2.5f,1.0f);
+        Box box = new Box(2.5f,2.5f,1.0f);
         Spatial wall = new Geometry("Box", box );
         Material mat_brick = new Material( 
             assetManager, "Common/MatDefs/Misc/Unshaded.j3md");
@@ -93,7 +93,7 @@ Build and run the code sample. You should see a green Ninja with a colorful teap
 </p>
 
 </div>
-<!-- EDIT2 SECTION "Code Sample" [839-3449] -->
+<!-- EDIT2 SECTION "Code Sample" [839-3434] -->
 <h2><a>The Asset Manager</a></h2>
 <div>
 
@@ -115,16 +115,17 @@ The AssetManager can load files from:
 
 The following is the recommended directory structure for storing assets in your project directoy: 
 </p>
-<pre>MyGame/assets/Interface/
+<pre>MyGame/assets/               
+MyGame/assets/Interface/
 MyGame/assets/MatDefs/
 MyGame/assets/Materials/
-MyGame/assets/Models/
+MyGame/assets/Models/       &lt;-- your .j3o models go here
 MyGame/assets/Scenes/
 MyGame/assets/Shaders/
-MyGame/assets/Sounds/
-MyGame/assets/Textures/
-MyGame/build.xml            &lt;-- Ant build script
-MyGame/src/...              &lt;-- Java sources go here
+MyGame/assets/Sounds/       &lt;-- your audio files go here
+MyGame/assets/Textures/     &lt;-- your textures go here
+MyGame/build.xml            &lt;-- Default Ant build script
+MyGame/src/...              &lt;-- your Java sources go here
 MyGame/...</pre>
 
 <p>
@@ -132,7 +133,7 @@ This is just a suggested best practice, and it&#039;s what you get by default wh
 </p>
 
 </div>
-<!-- EDIT3 SECTION "The Asset Manager" [3450-4573] -->
+<!-- EDIT3 SECTION "The Asset Manager" [3435-4701] -->
 <h3><a>Loading Textures</a></h3>
 <div>
 
@@ -141,7 +142,7 @@ This is just a suggested best practice, and it&#039;s what you get by default wh
 Place your textures in a subdirectory of <code>assets/Textures/</code>. Load the texture into the material before you set the Material. The following code sample is from the <code>simpleInitApp()</code> method and loads a simple wall model:
 </p>
 <pre>// Create a wall with a simple texture from test_data
-Box box = new Box&#40;Vector3f.ZERO, 2.5f,2.5f,1.0f&#41;;
+Box box = new Box&#40;2.5f,2.5f,1.0f&#41;;
 Spatial wall = new Geometry&#40;&quot;Box&quot;, box &#41;;
 Material mat_brick = new Material&#40; 
     assetManager, &quot;Common/MatDefs/Misc/Unshaded.j3md&quot;&#41;;
@@ -156,7 +157,7 @@ In this case, you <a href="/com/jme3/gde/docs/jme3/beginner/hello_material.html"
 </p>
 
 </div>
-<!-- EDIT4 SECTION "Loading Textures" [4574-5490] -->
+<!-- EDIT4 SECTION "Loading Textures" [4702-5603] -->
 <h3><a>Loading Text and Fonts</a></h3>
 <div>
 
@@ -179,7 +180,7 @@ guiNode.attachChild&#40;helloText&#41;;</pre>
 </p>
 
 </div>
-<!-- EDIT5 SECTION "Loading Text and Fonts" [5491-6336] -->
+<!-- EDIT5 SECTION "Loading Text and Fonts" [5604-6449] -->
 <h3><a>Loading a Model</a></h3>
 <div>
 
@@ -203,7 +204,7 @@ Note that you do not need to create a Material if you exported the model with a
 </p>
 
 </div>
-<!-- EDIT6 SECTION "Loading a Model" [6337-7266] -->
+<!-- EDIT6 SECTION "Loading a Model" [6450-7379] -->
 <h3><a>Loading Assets From Custom Paths</a></h3>
 <div>
 
@@ -233,18 +234,19 @@ JME3 offers ClasspathLocator, ZipLocator, FileLocator, HttpZipLocator, and UrlLo
 </p>
 
 </div>
-<!-- EDIT7 SECTION "Loading Assets From Custom Paths" [7267-8284] -->
+<!-- EDIT7 SECTION "Loading Assets From Custom Paths" [7380-8397] -->
 <h2><a>Creating Models and Scenes</a></h2>
 <div>
 
 <p>
 
-To create 3D models and scenes, you need a 3D Mesh Editor with an OgreXML Exporter plugin. For example, you can <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://en.wikibooks.org/wiki/Blender_3D:_Noob_to_Pro/UV_Map_Basics"><param name="text" value="<html><u>create fully textured models with Blender</u></html>"><param name="textColor" value="blue"></object>.
-You use the <a href="/com/jme3/gde/docs/sdk.html">SDK</a> to <a href="/com/jme3/gde/docs/sdk/model_loader_and_viewer.html">load models</a>, <a href="/com/jme3/gde/docs/sdk/blender.html">convert models</a> and <a href="/com/jme3/gde/docs/sdk/scene_composer.html">create scenes</a> from them. 
+To create 3D models and scenes, you need a 3D Mesh Editor. If you don&#039;t have any tools, install Blender and the OgreXML Exporter plugin. 
+Then you <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://en.wikibooks.org/wiki/Blender_3D:_Noob_to_Pro/UV_Map_Basics"><param name="text" value="<html><u>create fully textured models (e.g. with Blender)</u></html>"><param name="textColor" value="blue"></object> and export them to your project.
+Then you use the <a href="/com/jme3/gde/docs/sdk.html">SDK</a> to <a href="/com/jme3/gde/docs/sdk/model_loader_and_viewer.html">load models</a>, <a href="/com/jme3/gde/docs/sdk/blender.html">convert models</a>, and <a href="/com/jme3/gde/docs/sdk/scene_composer.html">create 3D scenes</a> from them. 
 </p>
 
 <p>
-If you use Blender, export your models as Ogre <acronym title="Extensible Markup Language">XML</acronym> meshes with materials as follows:
+<strong>Example:</strong> From Blender, you export your models as Ogre <acronym title="Extensible Markup Language">XML</acronym> meshes with materials as follows:
 </p>
 <ol>
 <li><div> Open the menu File &gt; Export &gt; OgreXML Exporter to open the exporter dialog.</div>
@@ -272,17 +274,28 @@ If you use Blender, export your models as Ogre <acronym title="Extensible Markup
 </ol>
 
 </div>
-<!-- EDIT8 SECTION "Creating Models and Scenes" [8285-9444] -->
+<!-- EDIT8 SECTION "Creating Models and Scenes" [8398-9651] -->
 <h3><a>Model File Formats</a></h3>
 <div>
 
 <p>
 
-JME3 can load Ogre <acronym title="Extensible Markup Language">XML</acronym> models + materials, Ogre DotScenes, as well as Wavefront OBJ+MTL models. The loadModel() code works with these files when you run the code directly from the jMonkeyEngine <acronym title="Software Development Kit">SDK</acronym>. 
+JME3 can convert and load
 </p>
+<ul>
+<li><div> Ogre <acronym title="Extensible Markup Language">XML</acronym> models + materials, </div>
+</li>
+<li><div> Ogre DotScenes, </div>
+</li>
+<li><div> Wavefront OBJ + MTL models, </div>
+</li>
+<li><div> .Blend files.</div>
+</li>
+</ul>
 
 <p>
-If you build the executables using the default build script, then <strong>the original model files (<acronym title="Extensible Markup Language">XML</acronym>, OBJ, etc) are not included.</strong> When you run the executable, you get an error message if you try to load any models directly: 
+
+The <code>loadModel()</code> method loads these original file formats when you run your code directly from the <acronym title="Software Development Kit">SDK</acronym>. If you however build the executables using the default build script, then the original model files (<acronym title="Extensible Markup Language">XML</acronym>, OBJ, etc) <em>are not included</em>. This means, when you run the executable outside the <acronym title="Software Development Kit">SDK</acronym>, and load any original models directly, you get the following error message: 
 </p>
 <pre>com.jme3.asset.DesktopAssetManager loadAsset
 WARNING: Cannot locate resource: Models/Ninja/Ninja.mesh.xml
@@ -291,11 +304,11 @@ SEVERE: Uncaught exception thrown in Thread[LWJGL Renderer Thread,5,main]
 java.lang.NullPointerException</pre>
 
 <p>
-Loading the <acronym title="Extensible Markup Language">XML</acronym>/OBJ files directly is only acceptable during the development phase. If your graphic designer pushes updated files to the asset directory, you can quickly review the latest version in your development environment.
+You see that loading the <strong><acronym title="Extensible Markup Language">XML</acronym>/OBJ/Blend files</strong> directly is only acceptable during the development phase in the <acronym title="Software Development Kit">SDK</acronym>. For example, every time your graphic designer pushes updated files to the asset directory, you can quickly review the latest version in your development environment.
 </p>
 
 <p>
-For testing and for the final release build, you use .j3o files exclusively. J3o is an optimized binary format for jME3 applications, and .j3o files are automatically included in the distributable JAR file by the build script. When you do QA test builds or are ready to release, use the <a href="/com/jme3/gde/docs/sdk.html">SDK</a> to <a href="/com/jme3/gde/docs/sdk/model_loader_and_viewer.html">convert</a> all .obj/.scene/.xml/.blend files to .j3o files, and only load the .j3o versions.
+But for QA test builds and for the final release build, you use <strong>.j3o files</strong> exclusively. J3o is an optimized binary format for jME3 applications. When you do QA test builds, or are ready to release, use the <a href="/com/jme3/gde/docs/sdk.html">SDK</a> to <a href="/com/jme3/gde/docs/sdk/model_loader_and_viewer.html">convert</a> all .obj/.scene/.xml/.blend files to .j3o files, and update all code to load the .j3o files. The default build script automatically packages .j3o files in the executables.
 </p>
 
 <p>
@@ -306,18 +319,20 @@ Open your JME3 Project in the jMonkeyEngine <acronym title="Software Development
 </li>
 <li><div> The .j3o file appears next to the .mesh.xml file and has the same name. </div>
 </li>
-<li><div> Change all your loadModel() lines accordingly. For example: <pre>Spatial ninja = assetManager.loadModel&#40;&quot;Models/Ninja/Ninja.j3o&quot;&#41;;</pre>
+<li><div> Update all your <code>loadModel()</code> lines accordingly. For example: <pre>Spatial ninja = assetManager.loadModel&#40;&quot;Models/Ninja/Ninja.j3o&quot;&#41;;</pre>
 </div>
 </li>
 </ol>
 
 <p>
 
-If your executable gets a runtime exception, make sure you have converted all models to .j3o!
+<p><div>If your executable throws a &quot;Cannot locate resource&quot; runtime exception, check all load paths and make sure you have converted all models to .j3o files!
+</div></p>
+
 </p>
 
 </div>
-<!-- EDIT9 SECTION "Model File Formats" [9445-11297] -->
+<!-- EDIT9 SECTION "Model File Formats" [9652-11736] -->
 <h3><a>Loading Models and Scenes</a></h3>
 <div>
 <div><table>
@@ -346,9 +361,9 @@ rootNode.attachChild&#40;scene&#41;;</pre>
 </td>
 	</tr>
 </table></div>
-<!-- EDIT11 TABLE [11335-12389] -->
+<!-- EDIT11 TABLE [11774-12828] -->
 </div>
-<!-- EDIT10 SECTION "Loading Models and Scenes" [11298-12390] -->
+<!-- EDIT10 SECTION "Loading Models and Scenes" [11737-12829] -->
 <h2><a>Excercise - How to Load Assets</a></h2>
 <div>
 
@@ -435,7 +450,7 @@ Here is a third method you must know, loading a scene/model from a .j3o file:
 </li>
 <li><div> In the projects window, browse to the <code>assets/Scenes/town</code> directory. </div>
 </li>
-<li><div> Right-click the <code>main.scene</code> and convert the scene to binary: The jMoneyPlatform generates a main.j3o file.</div>
+<li><div> Right-click the <code>main.scene</code> and convert the scene to binary: The jMonkeyPlatform generates a main.j3o file.</div>
 </li>
 <li><div> Add the following code under <code>simpleInitApp() {</code><pre>    Spatial gameLevel = assetManager.loadModel&#40;&quot;Scenes/town/main.j3o&quot;&#41;;
     gameLevel.setLocalTranslation&#40;0, -5.2f, 0&#41;;
@@ -453,7 +468,7 @@ Again, you should see the Ninja+wall+teapot standing in a town. </div>
 </ol>
 
 </div>
-<!-- EDIT12 SECTION "Excercise - How to Load Assets" [12391-15725] -->
+<!-- EDIT12 SECTION "Excercise - How to Load Assets" [12830-16165] -->
 <h2><a>Conclusion</a></h2>
 <div>
 
@@ -497,5 +512,5 @@ Let&#039;s add some action to the scene and continue with the <a href="/com/jme3
 </span></div>
 
 </div>
-<!-- EDIT13 SECTION "Conclusion" [15726-] -->
+<!-- EDIT13 SECTION "Conclusion" [16166-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:beginner:hello_asset?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/beginner/hello_audio.html

@@ -24,11 +24,11 @@ This tutorial explains how to add 3D sound to a game, and how to make sounds pla
  
 import com.jme3.app.SimpleApplication;
 import com.jme3.audio.AudioNode;
+import com.jme3.input.MouseInput;
 import com.jme3.input.controls.ActionListener;
 import com.jme3.input.controls.MouseButtonTrigger;
 import com.jme3.material.Material;
 import com.jme3.math.ColorRGBA;
-import com.jme3.math.Vector3f;
 import com.jme3.scene.Geometry;
 import com.jme3.scene.shape.Box;
  
@@ -49,10 +49,9 @@ public class HelloAudio extends SimpleApplication {
     flyCam.setMoveSpeed(40);
  
     /** just a blue box floating in space */
-    Box box1 = new Box(Vector3f.ZERO, 1, 1, 1);
+    Box box1 = new Box(1, 1, 1);
     player = new Geometry("Player", box1);
-    Material mat1 = new Material(assetManager, 
-            "Common/MatDefs/Misc/Unshaded.j3md");
+    Material mat1 = new Material(assetManager,"Common/MatDefs/Misc/Unshaded.j3md");
     mat1.setColor("Color", ColorRGBA.Blue);
     player.setMaterial(mat1);
     rootNode.attachChild(player);
@@ -66,23 +65,23 @@ public class HelloAudio extends SimpleApplication {
   private void initAudio() {
     /* gun shot sound is to be triggered by a mouse click. */
     audio_gun = new AudioNode(assetManager, "Sound/Effects/Gun.wav", false);
+    audio_gun.setPositional(false);
     audio_gun.setLooping(false);
     audio_gun.setVolume(2);
     rootNode.attachChild(audio_gun);
  
     /* nature sound - keeps playing in a loop. */
-    audio_nature = new AudioNode(assetManager, "Sound/Environment/Nature.ogg", false);
+    audio_nature = new AudioNode(assetManager, "Sound/Environment/Ocean Waves.ogg", true);
     audio_nature.setLooping(true);  // activate continuous playing
-    audio_nature.setPositional(true);
-    audio_nature.setLocalTranslation(Vector3f.ZERO.clone());
+    audio_nature.setPositional(true);   
     audio_nature.setVolume(3);
     rootNode.attachChild(audio_nature);
     audio_nature.play(); // play continuously!
   }
  
-  /** Declaring "Shoot" action, mapping it to a trigger (mouse click). */
+  /** Declaring "Shoot" action, mapping it to a trigger (mouse left click). */
   private void initKeys() {
-    inputManager.addMapping("Shoot", new MouseButtonTrigger(0));
+    inputManager.addMapping("Shoot", new MouseButtonTrigger(MouseInput.BUTTON_LEFT));
     inputManager.addListener(actionListener, "Shoot");
   }
  
@@ -110,7 +109,7 @@ When you run the sample, you should see a blue cube. You should hear a nature-li
 </p>
 
 </div>
-<!-- EDIT2 SECTION "Sample Code" [684-3519] -->
+<!-- EDIT2 SECTION "Sample Code" [684-3501] -->
 <h2><a>Understanding the Code Sample</a></h2>
 <div>
 
@@ -124,7 +123,7 @@ Let&#039;s have a closer look at <code>initAudio()</code> to learn how to use <c
 </p>
 
 </div>
-<!-- EDIT3 SECTION "Understanding the Code Sample" [3520-3857] -->
+<!-- EDIT3 SECTION "Understanding the Code Sample" [3502-3839] -->
 <h2><a>AudioNodes</a></h2>
 <div>
 
@@ -153,10 +152,17 @@ These two lines create new sound nodes from the given audio files in the AssetMa
 <p>
 You want the gunshot sound to play <em>once</em> (you don&#039;t want it to loop). You also specify its volume as gain factor (at 0, sound is muted, at 2, it is twice as loud, etc.).
 </p>
-<pre>    audio_gun.setLooping&#40;false&#41;;
+<pre>    audio_gun.setPositional&#40;false&#41;;
+    audio_gun.setLooping&#40;false&#41;;
     audio_gun.setVolume&#40;2&#41;;
     rootNode.attachChild&#40;audio_gun&#41;;</pre>
 
+<p>
+
+<p><div>Note that setPositional(false) is pretty important when you use stereo sounds. Positional sounds must always be mono audio files, otherwise the engine will remind it to you with a crash.
+</div></p>
+</p>
+
 <p>
 The nature sound is different: You want it to loop <em>continuously</em> as background sound. This is why you set looping to true, and immediately call the play() method on the node. You also choose to set its volume to 3.
 </p>
@@ -184,7 +190,7 @@ Here you make audio_nature a positional sound that comes from a certain place. F
 </p>
 
 </div>
-<!-- EDIT4 SECTION "AudioNodes" [3858-6947] -->
+<!-- EDIT4 SECTION "AudioNodes" [3840-7174] -->
 <h2><a>Triggering Sound</a></h2>
 <div>
 
@@ -192,9 +198,9 @@ Here you make audio_nature a positional sound that comes from a certain place. F
 
 Let&#039;s have a closer look at <code>initKeys()</code>: As you learned in previous tutorials, you use the <code>inputManager</code> to respond to user input. Here you add a mapping for a left mouse button click, and name this new action <code>Shoot</code>.
 </p>
-<pre>  /** Declaring &quot;Shoot&quot; action, mapping it to a trigger (mouse click). */
+<pre>  /** Declaring &quot;Shoot&quot; action, mapping it to a trigger (mouse left click). */
   private void initKeys&#40;&#41; &#123;
-    inputManager.addMapping&#40;&quot;Shoot&quot;, new MouseButtonTrigger&#40;0&#41;&#41;;
+    inputManager.addMapping&#40;&quot;Shoot&quot;, new MouseButtonTrigger&#40;MouseInput.BUTTON_LEFT&#41;&#41;;
     inputManager.addListener&#40;actionListener, &quot;Shoot&quot;&#41;;
   &#125;</pre>
 
@@ -213,10 +219,11 @@ Setting up the ActionListener should also be familiar from previous tutorials. Y
 
 <p>
 Since you want to be able to shoot fast repeatedly, so you do not want to wait for the previous gunshot sound to end before the next one can start. This is why you play this sound using the <code>playInstance()</code> method. This means that every click starts a new instance of the sound, so two instances can overlap. You set this sound not to loop, so each instance only plays once. As you would expect it of a gunshot.
+
 </p>
 
 </div>
-<!-- EDIT5 SECTION "Triggering Sound" [6948-8412] -->
+<!-- EDIT5 SECTION "Triggering Sound" [7175-8664] -->
 <h2><a>Ambient or Situational?</a></h2>
 <div>
 
@@ -265,7 +272,7 @@ Apart from the looping boolean, another difference is where <code>play().playIns
 </ul>
 
 </div>
-<!-- EDIT6 SECTION "Ambient or Situational?" [8413-9643] -->
+<!-- EDIT6 SECTION "Ambient or Situational?" [8665-9895] -->
 <h2><a>Buffered or Streaming?</a></h2>
 <div>
 
@@ -274,7 +281,7 @@ Apart from the looping boolean, another difference is where <code>play().playIns
 The Boolean in the AudioNode constructor defines whether the audio is buffered (false) or streamed (true). For example:
 
 </p>
-<pre>audio_nature = new AudioNode&#40;assetManager, &quot;Sound/Effects/Gun.wav&quot;, false&#41;; // buffered
+<pre>audio_gunshot = new AudioNode&#40;assetManager, &quot;Sound/Effects/Gun.wav&quot;, false&#41;; // buffered
 ...
 audio_nature = new AudioNode&#40;assetManager, &quot;Sound/Environment/Nature.ogg&quot;, true&#41;; // streamed </pre>
 
@@ -288,7 +295,7 @@ Note that streamed sounds can not loop (i.e. setLooping will not work as you exp
 </p>
 
 </div>
-<!-- EDIT7 SECTION "Buffered or Streaming?" [9644-10225] -->
+<!-- EDIT7 SECTION "Buffered or Streaming?" [9896-10478] -->
 <h2><a>Play() or PlayInstance()?</a></h2>
 <div>
 <div><table>
@@ -305,9 +312,9 @@ Note that streamed sounds can not loop (i.e. setLooping will not work as you exp
 		<td>The same sound cannot play twice at the same time.</td><td>The same sounds can play multiple times and overlap.</td>
 	</tr>
 </table></div>
-<!-- EDIT9 TABLE [10265-10509] -->
+<!-- EDIT9 TABLE [10518-10762] -->
 </div>
-<!-- EDIT8 SECTION "Play() or PlayInstance()?" [10226-10510] -->
+<!-- EDIT8 SECTION "Play() or PlayInstance()?" [10479-10763] -->
 <h2><a>Your Ear in the Scene</a></h2>
 <div>
 
@@ -329,7 +336,7 @@ If you don&#039;t do that, the results of 3D audio will be quite random.
 </p>
 
 </div>
-<!-- EDIT10 SECTION "Your Ear in the Scene" [10511-11213] -->
+<!-- EDIT10 SECTION "Your Ear in the Scene" [10764-11466] -->
 <h2><a>Global, Directional, Positional?</a></h2>
 <div>
 
@@ -356,7 +363,7 @@ In short, you must choose in every situation whether it makes sense for a sound
 </p>
 
 </div>
-<!-- EDIT11 SECTION "Global, Directional, Positional?" [11214-12570] -->
+<!-- EDIT11 SECTION "Global, Directional, Positional?" [11467-12823] -->
 <h2><a>Conclusion</a></h2>
 <div>
 
@@ -391,5 +398,5 @@ See also:
 </span></div>
 
 </div>
-<!-- EDIT12 SECTION "Conclusion" [12571-] -->
+<!-- EDIT12 SECTION "Conclusion" [12824-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:beginner:hello_audio?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/beginner/hello_collision.html

@@ -69,6 +69,11 @@ public class HelloCollision extends SimpleApplication
   private CharacterControl player;
   private Vector3f walkDirection = new Vector3f();
   private boolean left = false, right = false, up = false, down = false;
+ 
+  //Temporary vectors used on each frame.
+  //They here to avoid instanciating new vectors on each frame
+  private Vector3f camDir = new Vector3f();
+  private Vector3f camLeft = new Vector3f();
  
   public static void main(String[] args) {
     HelloCollision app = new HelloCollision();
@@ -111,7 +116,7 @@ public class HelloCollision extends SimpleApplication
     player.setGravity(30);
     player.setPhysicsLocation(new Vector3f(0, 10, 0));
  
-    // We attach the scene and the player to the rootNode and the physics space,
+    // We attach the scene and the player to the rootnode and the physics space,
     // to make them appear in the game world.
     rootNode.attachChild(sceneModel);
     bulletAppState.getPhysicsSpace().add(landscape);
@@ -147,17 +152,17 @@ public class HelloCollision extends SimpleApplication
  
   <span>/** These are our custom actions triggered by key presses.
    * We do not walk yet, we just keep track of the direction the user pressed. */</span>
-  public void onAction&#40;String binding, boolean value, float tpf&#41; &#123;
+  public void onAction&#40;String binding, boolean isPressed, float tpf&#41; &#123;
     if &#40;binding.equals&#40;&quot;Left&quot;&#41;&#41; &#123;
-      left = value;
+      left = isPressed;
     &#125; else if &#40;binding.equals&#40;&quot;Right&quot;&#41;&#41; &#123;
-      right = value;
+      right= isPressed;
     &#125; else if &#40;binding.equals&#40;&quot;Up&quot;&#41;&#41; &#123;
-      up = value;
+      up = isPressed;
     &#125; else if &#40;binding.equals&#40;&quot;Down&quot;&#41;&#41; &#123;
-      down = value;
+      down = isPressed;
     &#125; else if &#40;binding.equals&#40;&quot;Jump&quot;&#41;&#41; &#123;
-      player.jump&#40;&#41;;
+      if &#40;isPressed&#41; &#123; player.jump&#40;&#41;; &#125;
     &#125;
   &#125;
 &nbsp;
@@ -169,25 +174,34 @@ public class HelloCollision extends SimpleApplication
    * We also make sure here that the camera moves with player.
    */</span>
   @Override
-  public void simpleUpdate&#40;float tpf&#41; &#123;
-    Vector3f camDir = cam.getDirection&#40;&#41;.clone&#40;&#41;.multLocal&#40;0.6f&#41;;
-    Vector3f camLeft = cam.getLeft&#40;&#41;.clone&#40;&#41;.multLocal&#40;0.4f&#41;;
-    walkDirection.set&#40;0, 0, 0&#41;;
-    if &#40;left&#41;  &#123; walkDirection.addLocal&#40;camLeft&#41;; &#125;
-    if &#40;right&#41; &#123; walkDirection.addLocal&#40;camLeft.negate&#40;&#41;&#41;; &#125;
-    if &#40;up&#41;    &#123; walkDirection.addLocal&#40;camDir&#41;; &#125;
-    if &#40;down&#41;  &#123; walkDirection.addLocal&#40;camDir.negate&#40;&#41;&#41;; &#125;
-    player.setWalkDirection&#40;walkDirection&#41;;
-    cam.setLocation&#40;player.getPhysicsLocation&#40;&#41;&#41;;
-  &#125;
+    public void simpleUpdate&#40;float tpf&#41; &#123;
+        camDir.set&#40;cam.getDirection&#40;&#41;&#41;.multLocal&#40;0.6f&#41;;
+        camLeft.set&#40;cam.getLeft&#40;&#41;&#41;.multLocal&#40;0.4f&#41;;
+        walkDirection.set&#40;0, 0, 0&#41;;
+        if &#40;left&#41; &#123;
+            walkDirection.addLocal&#40;camLeft&#41;;
+        &#125;
+        if &#40;right&#41; &#123;
+            walkDirection.addLocal&#40;camLeft.negate&#40;&#41;&#41;;
+        &#125;
+        if &#40;up&#41; &#123;
+            walkDirection.addLocal&#40;camDir&#41;;
+        &#125;
+        if &#40;down&#41; &#123;
+            walkDirection.addLocal&#40;camDir.negate&#40;&#41;&#41;;
+        &#125;
+        player.setWalkDirection&#40;walkDirection&#41;;
+        cam.setLocation&#40;player.getPhysicsLocation&#40;&#41;&#41;;
+    &#125;
 &#125;</pre>
 
 <p>
 Run the sample. You should see a town square with houses and a monument. Use the WASD keys and the mouse to navigate around with a first-person perspective. Run forward and jump by pressing W and Space. Note how you step over the sidewalk, and up the steps to the monument. You can walk in the alleys between the houses, but the walls are solid. Don&#039;t walk over the edge of the world! <img src="/wiki/lib/images/smileys/icon_smile.gif" class="middle" alt=":-)" />
+
 </p>
 
 </div>
-<!-- EDIT2 SECTION "Sample Code" [596-7019] -->
+<!-- EDIT2 SECTION "Sample Code" [596-7341] -->
 <h2><a>Understanding the Code</a></h2>
 <div>
 
@@ -206,7 +220,12 @@ You already know that SimpleApplication is the base class for all jME3 games. Yo
   private RigidBodyControl landscape;
   private CharacterControl player;
   private Vector3f walkDirection = new Vector3f&#40;&#41;;
-  private boolean left = false, right = false, up = false, down = false;</pre>
+  private boolean left = false, right = false, up = false, down = false;
+&nbsp;
+  //Temporary vectors used on each frame.
+  //They here to avoid instanciating new vectors on each frame
+  private Vector3f camDir = new Vector3f&#40;&#41;;
+  private Vector3f camLeft = new Vector3f&#40;&#41;;</pre>
 
 <p>
 You initialize a few private fields:
@@ -222,15 +241,18 @@ You initialize a few private fields:
 </li>
 <li><div> The fields <code>walkDirection</code> and the four Booleans are used for physics-controlled navigation.</div>
 </li>
+<li><div> camDir and camLeft are temporary vectors used later when computing the walkingDirection from the cam position and rotation</div>
+</li>
 </ul>
 
 <p>
 
 Let&#039;s have a look at all the details:
+
 </p>
 
 </div>
-<!-- EDIT3 SECTION "Understanding the Code" [7020-8244] -->
+<!-- EDIT3 SECTION "Understanding the Code" [7342-8887] -->
 <h2><a>Initializing the Game</a></h2>
 <div>
 
@@ -254,7 +276,7 @@ As usual, you initialize the game in the <code>simpleInitApp()</code> method.
 </ol>
 
 </div>
-<!-- EDIT4 SECTION "Initializing the Game" [8245-8841] -->
+<!-- EDIT4 SECTION "Initializing the Game" [8888-9484] -->
 <h3><a>The Physics-Controlled Scene</a></h3>
 <div>
 
@@ -301,7 +323,7 @@ To use collision detection, you add a RigidBodyControl to the <code>sceneModel</
 </p>
 
 </div>
-<!-- EDIT5 SECTION "The Physics-Controlled Scene" [8842-10815] -->
+<!-- EDIT5 SECTION "The Physics-Controlled Scene" [9485-11458] -->
 <h3><a>The Physics-Controlled Player</a></h3>
 <div>
 
@@ -353,7 +375,7 @@ Finally we put the player in its starting position and update its state ??? reme
 </p>
 
 </div>
-<!-- EDIT6 SECTION "The Physics-Controlled Player" [10816-13580] -->
+<!-- EDIT6 SECTION "The Physics-Controlled Player" [11459-14223] -->
 <h3><a>PhysicsSpace</a></h3>
 <div>
 
@@ -369,7 +391,7 @@ The invisible body of the character just sits there on the physical floor. It ca
 </p>
 
 </div>
-<!-- EDIT7 SECTION "PhysicsSpace" [13581-13982] -->
+<!-- EDIT7 SECTION "PhysicsSpace" [14224-14625] -->
 <h2><a>Navigation</a></h2>
 <div>
 
@@ -387,7 +409,7 @@ In short, you must re-define the flyCam&#039;s navigational key mappings to use
 </p>
 
 </div>
-<!-- EDIT8 SECTION "Navigation" [13983-14930] -->
+<!-- EDIT8 SECTION "Navigation" [14626-15573] -->
 <h3><a>1. inputManager</a></h3>
 <div>
 
@@ -413,7 +435,7 @@ You can move this block of code into an auxiliary method <code>setupKeys()</code
 </p>
 
 </div>
-<!-- EDIT9 SECTION "1. inputManager" [14931-15841] -->
+<!-- EDIT9 SECTION "1. inputManager" [15574-16484] -->
 <h3><a>2. onAction()</a></h3>
 <div>
 
@@ -444,7 +466,7 @@ For all other directions: Every time the user presses one of the WASD keys, you
 </p>
 
 </div>
-<!-- EDIT10 SECTION "2. onAction()" [15842-17258] -->
+<!-- EDIT10 SECTION "2. onAction()" [16485-17901] -->
 <h3><a>3. setWalkDirection()</a></h3>
 <div>
 
@@ -456,17 +478,25 @@ Previously in the <code>onAction()</code> method, you have collected the info in
 <p>
 This last and most important code snippet goes into the <code>simpleUpdate()</code> method.
 </p>
-<pre>  public void simpleUpdate&#40;float tpf&#41; &#123;
-    Vector3f camDir = cam.getDirection&#40;&#41;.clone&#40;&#41;.multLocal&#40;0.6f&#41;;
-    Vector3f camLeft = cam.getLeft&#40;&#41;.clone&#40;&#41;.multLocal&#40;0.4f&#41;;
-    walkDirection.set&#40;0, 0, 0&#41;;
-    if &#40;left&#41;  &#123; walkDirection.addLocal&#40;camLeft&#41;; &#125;
-    if &#40;right&#41; &#123; walkDirection.addLocal&#40;camLeft.negate&#40;&#41;&#41;; &#125;
-    if &#40;up&#41;    &#123; walkDirection.addLocal&#40;camDir&#41;; &#125;
-    if &#40;down&#41;  &#123; walkDirection.addLocal&#40;camDir.negate&#40;&#41;&#41;; &#125;
-    player.setWalkDirection&#40;walkDirection&#41;;
-    cam.setLocation&#40;player.getPhysicsLocation&#40;&#41;&#41;;
-  &#125;</pre>
+<pre> public void simpleUpdate&#40;float tpf&#41; &#123;
+        camDir.set&#40;cam.getDirection&#40;&#41;&#41;.multLocal&#40;0.6f&#41;;
+        camLeft.set&#40;cam.getLeft&#40;&#41;&#41;.multLocal&#40;0.4f&#41;;
+        walkDirection.set&#40;0, 0, 0&#41;;
+        if &#40;left&#41; &#123;
+            walkDirection.addLocal&#40;camLeft&#41;;
+        &#125;
+        if &#40;right&#41; &#123;
+            walkDirection.addLocal&#40;camLeft.negate&#40;&#41;&#41;;
+        &#125;
+        if &#40;up&#41; &#123;
+            walkDirection.addLocal&#40;camDir&#41;;
+        &#125;
+        if &#40;down&#41; &#123;
+            walkDirection.addLocal&#40;camDir.negate&#40;&#41;&#41;;
+        &#125;
+        player.setWalkDirection&#40;walkDirection&#41;;
+        cam.setLocation&#40;player.getPhysicsLocation&#40;&#41;&#41;;
+    &#125;</pre>
 
 <p>
 This is how the walking is triggered:
@@ -491,10 +521,11 @@ This is how the walking is triggered:
 <p>
 
 <strong>Important:</strong> Again, do not use <code>setLocalTranslation()</code> to walk the player around. You will get it stuck by overlapping with another physical object. You can put the player in a start position with <code>setPhysicalLocation()</code> if you make sure to place it a bit above the floor and away from obstacles.
+
 </p>
 
 </div>
-<!-- EDIT11 SECTION "3. setWalkDirection()" [17259-19294] -->
+<!-- EDIT11 SECTION "3. setWalkDirection()" [17902-20020] -->
 <h2><a>Conclusion</a></h2>
 <div>
 
@@ -535,5 +566,5 @@ Related info:
 </span></div>
 
 </div>
-<!-- EDIT12 SECTION "Conclusion" [19295-] -->
+<!-- EDIT12 SECTION "Conclusion" [20021-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:beginner:hello_collision?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/beginner/hello_input_system.html

@@ -65,8 +65,8 @@ public class HelloInput extends SimpleApplication {
     inputManager.addMapping("Rotate", new KeyTrigger(KeyInput.KEY_SPACE),
                                       new MouseButtonTrigger(MouseInput.BUTTON_LEFT));
     // Add the names to the action listener.
-    inputManager.addListener(actionListener, new String[]{"Pause"});
-    inputManager.addListener(analogListener, new String[]{"Left", "Right", "Rotate"});
+    inputManager.addListener(actionListener,"Pause");
+    inputManager.addListener(analogListener,"Left", "Right", "Rotate");
  
   }
  
@@ -112,7 +112,7 @@ Build and run the example.
 </ul>
 
 </div>
-<!-- EDIT2 SECTION "Sample Code" [634-3678] -->
+<!-- EDIT2 SECTION "Sample Code" [634-3651] -->
 <h2><a>Defining Mappings and Triggers</a></h2>
 <div>
 
@@ -164,15 +164,16 @@ Now you need to register your trigger mappings.
 </li>
 </ol>
 <pre>    // Add the names to the action listener.
-    inputManager.addListener&#40;actionListener, new String&#91;&#93;&#123;&quot;Pause&quot;&#125;&#41;;
-    inputManager.addListener&#40;analogListener, new String&#91;&#93;&#123;&quot;Left&quot;, &quot;Right&quot;, &quot;Rotate&quot;&#125;&#41;;</pre>
+    inputManager.addListener&#40;actionListener,&quot;Pause&quot;&#41;;
+    inputManager.addListener&#40;analogListener,&quot;Left&quot;, &quot;Right&quot;, &quot;Rotate&quot;&#41;;</pre>
 
 <p>
 This code goes into the <code>simpleInitApp()</code> method. But since we will likely add many keybindings, we extract these lines and wrap them in an auxiliary method, <code>initKeys()</code>. The <code>initKeys()</code> method is not part of the Input Controls interface ??? you can name it whatever you like. Just don&#039;t forget to call your method from the <code>initSimpleApp()</code> method.
+
 </p>
 
 </div>
-<!-- EDIT3 SECTION "Defining Mappings and Triggers" [3679-5893] -->
+<!-- EDIT3 SECTION "Defining Mappings and Triggers" [3652-5835] -->
 <h2><a>Implementing the Actions</a></h2>
 <div>
 
@@ -268,7 +269,7 @@ It&#039;s okay to use only one of the two Listeners, and not implement the other
 </p>
 
 </div>
-<!-- EDIT4 SECTION "Implementing the Actions" [5894-9012] -->
+<!-- EDIT4 SECTION "Implementing the Actions" [5836-8954] -->
 <h2><a>Analog, Pressed, or Released?</a></h2>
 <div>
 
@@ -325,7 +326,7 @@ Mappings registered to the <strong>ActionListener</strong> are digital either-or
       &#125;</pre>
 
 </div>
-<!-- EDIT5 SECTION "Analog, Pressed, or Released?" [9013-11037] -->
+<!-- EDIT5 SECTION "Analog, Pressed, or Released?" [8955-10979] -->
 <h2><a>Table of Triggers</a></h2>
 <div>
 
@@ -361,14 +362,14 @@ You can find the list of input constants in the files <code>src/core/com/jme3/in
 KeyTrigger(KeyInput.KEY_LEFT), KeyTrigger(KeyInput.KEY_RIGHT) </td>
 	</tr>
 </table></div>
-<!-- EDIT7 TABLE [11270-11866] -->
+<!-- EDIT7 TABLE [11212-11808] -->
 <p>
 
 <strong>Tip:</strong> If you don&#039;t recall an input constant during development, you benefit from an IDE&#039;s code completion functionality: Place the caret after e.g. <code>KeyInput.|</code> and trigger code completion to select possible input identifiers.
 </p>
 
 </div>
-<!-- EDIT6 SECTION "Table of Triggers" [11038-12100] -->
+<!-- EDIT6 SECTION "Table of Triggers" [10980-12042] -->
 <h2><a>Exercises</a></h2>
 <div>
 <ol>
@@ -396,7 +397,7 @@ inputManager.addMapping&#40;&quot;Pause&quot;,  new KeyTrigger&#40;usersPauseKey
 </p>
 
 </div>
-<!-- EDIT8 SECTION "Exercises" [12101-12785] -->
+<!-- EDIT8 SECTION "Exercises" [12043-12727] -->
 <h2><a>Conclusion</a></h2>
 <div>
 
@@ -418,5 +419,5 @@ Now you can already write a little interactive game! But wouldn&#039;t it be coo
 </span></div>
 
 </div>
-<!-- EDIT9 SECTION "Conclusion" [12786-] -->
+<!-- EDIT9 SECTION "Conclusion" [12728-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:beginner:hello_input_system?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/beginner/hello_main_event_loop.html

@@ -21,12 +21,12 @@ Now that you know how to load assets, such as 3D models, you want to implement s
 import com.jme3.app.SimpleApplication;
 import com.jme3.material.Material;
 import com.jme3.math.ColorRGBA;
-import com.jme3.math.Vector3f;
 import com.jme3.scene.Geometry;
 import com.jme3.scene.shape.Box;
  
-<span>/** Sample 4 - how to trigger repeating actions from the main update loop.
- * In this example, we make the player character rotate. */</span>
+<span>/** Sample 4 - how to trigger repeating actions from the main event loop.
+ * In this example, you use the loop to make the player character 
+ * rotate continuously. */</span>
 public class HelloLoop extends SimpleApplication &#123;
 &nbsp;
     public static void main&#40;String&#91;&#93; args&#41;&#123;
@@ -38,8 +38,8 @@ public class HelloLoop extends SimpleApplication &#123;
 &nbsp;
     @Override
     public void simpleInitApp&#40;&#41; &#123;
-&nbsp;
-        Box b = new Box&#40;Vector3f.ZERO, 1, 1, 1&#41;;
+        /** this blue box is our player character */
+        Box b = new Box&#40;1, 1, 1&#41;;
         player = new Geometry&#40;&quot;blue cube&quot;, b&#41;;
         Material mat = new Material&#40;assetManager,
           &quot;Common/MatDefs/Misc/Unshaded.j3md&quot;&#41;;
@@ -48,20 +48,21 @@ public class HelloLoop extends SimpleApplication &#123;
         rootNode.attachChild&#40;player&#41;;
     &#125;
 &nbsp;
-    /* This is the update loop */
+    /* Use the main event loop to trigger repeating actions. */
     @Override
     public void simpleUpdate&#40;float tpf&#41; &#123;
-        // make the player rotate
+        // make the player rotate:
         player.rotate&#40;0, 2*tpf, 0&#41;; 
     &#125;
 &#125;</pre>
 
 <p>
 Build and run the file: You see a constantly rotating cube. 
+
 </p>
 
 </div>
-<!-- EDIT2 SECTION "Code Sample" [405-1613] -->
+<!-- EDIT2 SECTION "Code Sample" [405-1682] -->
 <h2><a>Understanding the Code</a></h2>
 <div>
 
@@ -83,7 +84,7 @@ Now have a closer look at the <code>simpleUpdate()</code> method ??? this is the
 </ul>
 
 </div>
-<!-- EDIT3 SECTION "Understanding the Code" [1614-2397] -->
+<!-- EDIT3 SECTION "Understanding the Code" [1683-2466] -->
 <h2><a>Using the Update Loop</a></h2>
 <div>
 
@@ -108,38 +109,39 @@ A rotating object is just a simple example. In the update loop, you typically ha
 </ul>
 
 </div>
-<!-- EDIT4 SECTION "Using the Update Loop" [2398-3232] -->
+<!-- EDIT4 SECTION "Using the Update Loop" [2467-3301] -->
 <h2><a>Init - Update - Render</a></h2>
 <div>
 
 <p>
 
-Note the contrast:
+Note the the three phases of every game:
 </p>
 <ul>
-<li><div> The <code>simpleInitApp()</code> method is executed only once, right at the beginning; </div>
+<li><div> <strong>Init:</strong> The <code>simpleInitApp()</code> method is executed only <em>once</em>, right at the beginning; </div>
 </li>
-<li><div> The <code>simpleUpdate()</code> method runs repeatedly, during the game. </div>
+<li><div> <strong>Update:</strong> The <code>simpleUpdate()</code> method runs <em>repeatedly</em>, during the game. </div>
 </li>
-<li><div> After every update, the jMonkeyEngine automatically redraws (<code>renders</code>) the screen for you!</div>
+<li><div> <strong>Render:</strong> After every update, the jMonkeyEngine <em>automatically</em> redraws (<code>renders</code>) the screen for you.</div>
 </li>
 </ul>
 
 <p>
 
-Since rendering is automatic, initialization and updating are the two most important concepts in a SimpleApplication for you right now. These methods are where you load and create game data (once), and (repeatedly) change their properties to update the game state:
+Since rendering is automatic, initialization and updating are the two most important concepts in a SimpleApplication-based game for you:
 </p>
 <ul>
-<li><div> <code>simpleInitApp()</code> is the application&#039;s &quot;first breath&quot;.</div>
+<li><div> The <code>simpleInitApp()</code> method is the application&#039;s &quot;first breath&quot;. <br/>
+Here you load and create game data (once).</div>
 </li>
-<li><div> <code>simpleUpdate()</code> is the application&#039;s heartbeat. <br/>
-The update time unit is called <code>ticks</code>.</div>
+<li><div> The <code>simpleUpdate()</code> method is the application&#039;s &quot;heartbeat&quot; (the time unit is called <code>ticks</code>). <br/>
+Here you change their properties to update the game state (repeatedly).</div>
 </li>
 </ul>
 
 <p>
 
-<p><div>Everything in a game happens either during initialization or during the update loop. This means that these two methods grow very long over time. There are two strategies how experienced developers spread out their init and update code over several Java classes:
+<p><div>Everything in a game happens either during initialization, or during the update loop. This means that these two methods grow very long over time. Follwo these two strategies to spread out init and update code over several modular Java classes:
 </p>
 <ul>
 <li><div> Move code blocks from the simpleInitApp() method to <a href="/com/jme3/gde/docs/jme3/advanced/application_states.html">AppStates</a>.</div>
@@ -155,7 +157,7 @@ Keep this in mind for later when your application grows.
 </p>
 
 </div>
-<!-- EDIT5 SECTION "Init - Update - Render" [3233-4502] -->
+<!-- EDIT5 SECTION "Init - Update - Render" [3302-4629] -->
 <h2><a>Exercises</a></h2>
 <div>
 
@@ -189,7 +191,7 @@ Look back at the <a href="/com/jme3/gde/docs/jme3/beginner/hello_node.html">Hell
 </p>
 
 </div>
-<!-- EDIT6 SECTION "Exercises" [4503-5274] -->
+<!-- EDIT6 SECTION "Exercises" [4630-5401] -->
 <h2><a>Conclusion</a></h2>
 <div>
 
@@ -221,5 +223,5 @@ See also:
 </span></div>
 
 </div>
-<!-- EDIT7 SECTION "Conclusion" [5275-] -->
+<!-- EDIT7 SECTION "Conclusion" [5402-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:beginner:hello_main_event_loop?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/beginner/hello_material.html

@@ -14,13 +14,13 @@ The term Material includes everything that influences what the surface of a 3D m
 </p>
 
 <p>
+
 <p><div>To use the example assets in a new jMonkeyEngine <acronym title="Software Development Kit">SDK</acronym> project, right-click your project, select &quot;Properties&quot;, go to &quot;Libraries&quot;, press &quot;Add Library&quot; and add the &quot;jme3-test-data&quot; library.
 </div></p>
-
 </p>
 
 </div>
-<!-- EDIT1 SECTION "jMonkeyEngine 3 Tutorial (6) - Hello Materials" [1-713] -->
+<!-- EDIT1 SECTION "jMonkeyEngine 3 Tutorial (6) - Hello Materials" [1-715] -->
 <h2><a>Sample Code</a></h2>
 <div>
 <pre>package jme3test.helloworld;
@@ -31,18 +31,17 @@ import com.jme3.material.Material;
 import com.jme3.material.RenderState.BlendMode;
 import com.jme3.math.ColorRGBA;
 import com.jme3.math.Vector3f;
+import com.jme3.renderer.queue.RenderQueue.Bucket;
 import com.jme3.scene.Geometry;
 import com.jme3.scene.shape.Box;
 import com.jme3.scene.shape.Sphere;
 import com.jme3.texture.Texture;
 import com.jme3.util.TangentBinormalGenerator;
-import com.jme3.renderer.queue.RenderQueue.Bucket;
 &nbsp;
 <span>/** Sample 6 - how to give an object's surface a material and texture.
- * How to make objects transparent, or let colors &quot;leak&quot; through partially
- * transparent textures. How to make bumpy and shiny surfaces.  */</span>
-&nbsp;
+ * How to make objects transparent. How to make bumpy and shiny surfaces.  */</span>
 public class HelloMaterial extends SimpleApplication &#123;
+&nbsp;
   public static void main&#40;String&#91;&#93; args&#41; &#123;
     HelloMaterial app = new HelloMaterial&#40;&#41;;
     app.start&#40;&#41;;
@@ -50,58 +49,57 @@ public class HelloMaterial extends SimpleApplication &#123;
 &nbsp;
   @Override
   public void simpleInitApp&#40;&#41; &#123;
+&nbsp;
     /** A simple textured cube -- in good MIP map quality. */
-    Box boxshape1 = new Box&#40;new Vector3f&#40;-3f,1.1f,0f&#41;, 1f,1f,1f&#41;;
-    Geometry cube = new Geometry&#40;&quot;My Textured Box&quot;, boxshape1&#41;;
-    Material mat_stl = new Material&#40;assetManager, &quot;Common/MatDefs/Misc/Unshaded.j3md&quot;&#41;;
-    Texture tex_ml = assetManager.loadTexture&#40;&quot;Interface/Logo/Monkey.jpg&quot;&#41;;
-    mat_stl.setTexture&#40;&quot;ColorMap&quot;, tex_ml&#41;;
-    cube.setMaterial&#40;mat_stl&#41;;
-    rootNode.attachChild&#40;cube&#41;;
+    Box cube1Mesh = new Box&#40; 1f,1f,1f&#41;;
+    Geometry cube1Geo = new Geometry&#40;&quot;My Textured Box&quot;, cube1Mesh&#41;;
+    cube1Geo.setLocalTranslation&#40;new Vector3f&#40;-3f,1.1f,0f&#41;&#41;;
+    Material cube1Mat = new Material&#40;assetManager, 
+        &quot;Common/MatDefs/Misc/Unshaded.j3md&quot;&#41;;
+    Texture cube1Tex = assetManager.loadTexture&#40;
+        &quot;Interface/Logo/Monkey.jpg&quot;&#41;;
+    cube1Mat.setTexture&#40;&quot;ColorMap&quot;, cube1Tex&#41;;
+    cube1Geo.setMaterial&#40;cube1Mat&#41;;
+    rootNode.attachChild&#40;cube1Geo&#41;;
 &nbsp;
     /** A translucent/transparent texture, similar to a window frame. */
-    Box boxshape3 = new Box&#40;new Vector3f&#40;0f,0f,0f&#41;, 1f,1f,0.01f&#41;;
-    Geometry window_frame = new Geometry&#40;&quot;window frame&quot;, boxshape3&#41;;
-    Material mat_tt = new Material&#40;assetManager, &quot;Common/MatDefs/Misc/Unshaded.j3md&quot;&#41;;
-    mat_tt.setTexture&#40;&quot;ColorMap&quot;, assetManager.loadTexture&#40;&quot;Textures/ColoredTex/Monkey.png&quot;&#41;&#41;;
-    mat_tt.getAdditionalRenderState&#40;&#41;.setBlendMode&#40;BlendMode.Alpha&#41;;
-    window_frame.setMaterial&#40;mat_tt&#41;;
-&nbsp;
-    /** Objects with transparency need to be in the render bucket for transparent objects: */
-    window_frame.setQueueBucket&#40;Bucket.Transparent&#41;;
-    rootNode.attachChild&#40;window_frame&#41;;
-&nbsp;
-    /** A cube with base color &quot;leaking&quot; through a partially transparent texture */
-    Box boxshape4 = new Box&#40;new Vector3f&#40;3f,-1f,0f&#41;, 1f,1f,1f&#41;;
-    Geometry cube_leak = new Geometry&#40;&quot;Leak-through color cube&quot;, boxshape4&#41;;
-    Material mat_tl = new Material&#40;assetManager, &quot;Common/MatDefs/Misc/Unshaded.j3md&quot;&#41;;
-    mat_tl.setTexture&#40;&quot;ColorMap&quot;, assetManager.loadTexture&#40;&quot;Textures/ColoredTex/Monkey.png&quot;&#41;&#41;;
-    mat_tl.setColor&#40;&quot;Color&quot;, new ColorRGBA&#40;1f,0f,1f, 1f&#41;&#41;; // purple
-    cube_leak.setMaterial&#40;mat_tl&#41;;
-    rootNode.attachChild&#40;cube_leak&#41;;
+    Box cube2Mesh = new Box&#40; 1f,1f,0.01f&#41;;
+    Geometry cube2Geo = new Geometry&#40;&quot;window frame&quot;, cube2Mesh&#41;;
+    Material cube2Mat = new Material&#40;assetManager, 
+        &quot;Common/MatDefs/Misc/Unshaded.j3md&quot;&#41;;
+    cube2Mat.setTexture&#40;&quot;ColorMap&quot;, 
+        assetManager.loadTexture&#40;&quot;Textures/ColoredTex/Monkey.png&quot;&#41;&#41;;
+    cube2Mat.getAdditionalRenderState&#40;&#41;.setBlendMode&#40;BlendMode.Alpha&#41;;
+    cube2Geo.setQueueBucket&#40;Bucket.Transparent&#41;;
+    cube2Geo.setMaterial&#40;cube2Mat&#41;;
+    rootNode.attachChild&#40;cube2Geo&#41;;
 &nbsp;
-    /** A bumpy rock with a shiny light effect */
-    Sphere rock = new Sphere&#40;32,32, 2f&#41;;
-    Geometry shiny_rock = new Geometry&#40;&quot;Shiny rock&quot;, rock&#41;;
-    rock.setTextureMode&#40;Sphere.TextureMode.Projected&#41;; // better quality on spheres
-    TangentBinormalGenerator.generate&#40;rock&#41;;           // for lighting effect
-    Material mat_lit = new Material&#40;assetManager, &quot;Common/MatDefs/Light/Lighting.j3md&quot;&#41;;
-    mat_lit.setTexture&#40;&quot;DiffuseMap&quot;, assetManager.loadTexture&#40;&quot;Textures/Terrain/Pond/Pond.jpg&quot;&#41;&#41;;
-    mat_lit.setTexture&#40;&quot;NormalMap&quot;, assetManager.loadTexture&#40;&quot;Textures/Terrain/Pond/Pond_normal.png&quot;&#41;&#41;;
-    mat_lit.setBoolean&#40;&quot;UseMaterialColors&quot;,true&#41;;    
-    mat_lit.setColor&#40;&quot;Specular&quot;,ColorRGBA.White&#41;;
-    mat_lit.setColor&#40;&quot;Diffuse&quot;,ColorRGBA.White&#41;;
-    mat_lit.setFloat&#40;&quot;Shininess&quot;, 5f&#41;; // [1,128]    
-    shiny_rock.setMaterial&#40;mat_lit&#41;;
-    shiny_rock.setLocalTranslation&#40;0,2,-2&#41;; // Move it a bit
-    shiny_rock.rotate&#40;1.6f, 0, 0&#41;;          // Rotate it a bit
-    rootNode.attachChild&#40;shiny_rock&#41;;
+    /** A bumpy rock with a shiny light effect.*/
+    Sphere sphereMesh = new Sphere&#40;32,32, 2f&#41;;
+    Geometry sphereGeo = new Geometry&#40;&quot;Shiny rock&quot;, sphereMesh&#41;;
+    sphereMesh.setTextureMode&#40;Sphere.TextureMode.Projected&#41;; // better quality on spheres
+    TangentBinormalGenerator.generate&#40;sphereMesh&#41;;           // for lighting effect
+    Material sphereMat = new Material&#40;assetManager, 
+        &quot;Common/MatDefs/Light/Lighting.j3md&quot;&#41;;
+    sphereMat.setTexture&#40;&quot;DiffuseMap&quot;, 
+        assetManager.loadTexture&#40;&quot;Textures/Terrain/Pond/Pond.jpg&quot;&#41;&#41;;
+    sphereMat.setTexture&#40;&quot;NormalMap&quot;, 
+        assetManager.loadTexture&#40;&quot;Textures/Terrain/Pond/Pond_normal.png&quot;&#41;&#41;;
+    sphereMat.setBoolean&#40;&quot;UseMaterialColors&quot;,true&#41;;    
+    sphereMat.setColor&#40;&quot;Diffuse&quot;,ColorRGBA.White&#41;;
+    sphereMat.setColor&#40;&quot;Specular&quot;,ColorRGBA.White&#41;;
+    sphereMat.setFloat&#40;&quot;Shininess&quot;, 64f&#41;;  // [0,128]
+    sphereGeo.setMaterial&#40;sphereMat&#41;;
+    sphereGeo.setLocalTranslation&#40;0,2,-2&#41;; // Move it a bit
+    sphereGeo.rotate&#40;1.6f, 0, 0&#41;;          // Rotate it a bit
+    rootNode.attachChild&#40;sphereGeo&#41;;
 &nbsp;
     /** Must add a light to make the lit object visible! */
     DirectionalLight sun = new DirectionalLight&#40;&#41;;
     sun.setDirection&#40;new Vector3f&#40;1,0,-2&#41;.normalizeLocal&#40;&#41;&#41;;
     sun.setColor&#40;ColorRGBA.White&#41;;
     rootNode.addLight&#40;sun&#41;;
+&nbsp;
   &#125;
 &#125;</pre>
 
@@ -111,9 +109,7 @@ You should see
 <ul>
 <li><div> Left ??? A cube with a brown monkey texture.</div>
 </li>
-<li><div> Middle ??? A translucent monkey picture in front of a shiny rock.</div>
-</li>
-<li><div> Right ??? A cube with a purple monkey texture.</div>
+<li><div> Right ??? A translucent monkey picture in front of a shiny bumpy rock.</div>
 </li>
 </ul>
 
@@ -122,7 +118,7 @@ Move around with the WASD keys to have a closer look at the translucency, and th
 </p>
 
 </div>
-<!-- EDIT2 SECTION "Sample Code" [714-4923] -->
+<!-- EDIT2 SECTION "Sample Code" [716-4277] -->
 <h2><a>Simple Unshaded Texture</a></h2>
 <div>
 
@@ -130,80 +126,89 @@ Move around with the WASD keys to have a closer look at the translucency, and th
 
 Typically you want to give objects in your scene textures: It can be rock, grass, brick, wood, water, metal, paper??? A texture is a normal image file in <acronym title="Joint Photographics Experts Group">JPG</acronym> or <acronym title="Portable Network Graphics">PNG</acronym> format. In this example, you create a box with a simple unshaded Monkey texture as material.
 </p>
-<pre>    /** A simple textured cube. */
-    Box boxshape1 = new Box&#40;new Vector3f&#40;-3f,1.1f,0f&#41;, 1f,1f,1f&#41;;
-    Geometry cube = new Geometry&#40;&quot;My Textured Box&quot;, boxshape1&#41;;
-    Material mat_stl = new Material&#40;assetManager, 
+<pre>    /** A simple textured cube -- in good MIP map quality. */
+    Box cube1Mesh = new Box&#40; 1f,1f,1f&#41;;
+    Geometry cube1Geo = new Geometry&#40;&quot;My Textured Box&quot;, cube1Mesh&#41;;
+    cube1Geo.setLocalTranslation&#40;new Vector3f&#40;-3f,1.1f,0f&#41;&#41;;
+    Material cube1Mat = new Material&#40;assetManager, 
         &quot;Common/MatDefs/Misc/Unshaded.j3md&quot;&#41;;
-    Texture tex_ml = assetManager.loadTexture&#40;&quot;Interface/Logo/Monkey.jpg&quot;&#41;;
-    mat_stl.setTexture&#40;&quot;ColorMap&quot;, tex_ml&#41;;
-    cube.setMaterial&#40;mat_stl&#41;;
-    rootNode.attachChild&#40;cube&#41;;</pre>
+    Texture cube1Tex = assetManager.loadTexture&#40;
+        &quot;Interface/Logo/Monkey.jpg&quot;&#41;;
+    cube1Mat.setTexture&#40;&quot;ColorMap&quot;, cube1Tex&#41;;
+    cube1Geo.setMaterial&#40;cube1Mat&#41;;
+    rootNode.attachChild&#40;cube1Geo&#41;;</pre>
 
 <p>
-Here is what we did:
+Here is what we did: to create a textured box:
 </p>
 <ol>
-<li><div> Create a Geometry from a Box mesh. Let&#039;s call it <code>cube</code>.</div>
+<li><div> Create a Geometry <code>cube1Geo</code> from a Box mesh <code>cube1Mesh</code>. </div>
+</li>
+<li><div> Create a Material <code>cube1Mat</code> based on jME3&#039;s default <code>Unshaded.j3md</code> material definition.</div>
 </li>
-<li><div> Create a Material based on jME3&#039;s default <code>Unshaded.j3md</code> material definition.</div>
+<li><div> Create a texture <code>cube1Tex</code> from the <code>Monkey.jpg</code> file in the <code>assets/Interface/Logo/</code> directory of the project. </div>
 </li>
-<li><div> Create a texture from the <code>Monkey.jpg</code> file and load it into the material. <br/>
-The ColorMap is the typical material layer where textures go.</div>
+<li><div> Load the texture <code>cube1Tex</code> into the <code>ColorMap</code> layer of the material <code>cube1Mat</code>. </div>
 </li>
 <li><div> Apply the material to the cube, and attach the cube to the rootnode.</div>
 </li>
 </ol>
 
 </div>
-<!-- EDIT3 SECTION "Simple Unshaded Texture" [4924-6074] -->
+<!-- EDIT3 SECTION "Simple Unshaded Texture" [4278-5632] -->
 <h2><a>Transparent Unshaded Texture</a></h2>
 <div>
 
 <p>
 
-<code>Monkey.png</code> is the same texture as <code>Monkey.jpg</code>, but with an added alpha channel. The alpha channel allows you to specify which areas of the texture you want to be opaque or transparent: Black areas remain opaque, gray areas become translucent, and white areas become transparent. 
+<code>Monkey.png</code> is the same texture as <code>Monkey.jpg</code>, but with an added alpha channel. The alpha channel allows you to specify which areas of the texture you want to be opaque or transparent: Black areas of the alpha channel remain opaque, gray areas become translucent, and white areas become transparent. 
 </p>
 
 <p>
 For a partially translucent/transparent texture, you need:
 </p>
 <ul>
-<li><div> A texture with alpha channel</div>
+<li><div> A Texture with alpha channel</div>
 </li>
-<li><div> A Texture blend mode of <code>BlendMode.Alpha</code></div>
+<li><div> A Texture with blend mode of <code>BlendMode.Alpha</code></div>
 </li>
-<li><div> A geometry in the <code>Bucket.Transparent</code> render bucket.  This bucket ensures that the translucent object is drawn on top of objects behind it, and they show up correctly under the translucent parts. (For non-translucent objects the drawing order is not so important, because the z-buffer keeps track of whether a pixel is behind something else or not, and the color of a pixel doesn&#039;t depend on the pixels under it, this is why opaque Geometries can be drawn in any order.)</div>
+<li><div> A Geometry in the <code>Bucket.Transparent</code> render bucket.  <br/>
+This bucket ensures that the transparent object is drawn on top of objects behind it, and they show up correctly under the transparent parts. </div>
 </li>
 </ul>
-<pre>    /** A translucent/transparent texture. */
-    Box boxshape3 = new Box&#40;new Vector3f&#40;0f,0f,0f&#41;, 1f,1f,0.01f&#41;;
-    Geometry seethrough = new Geometry&#40;&quot;see-through box&quot;, boxshape3&#41;;
-    Material mat_tt = new Material&#40;assetManager, &quot;Common/MatDefs/Misc/Unshaded.j3md&quot;&#41;;
-    mat_tt.setTexture&#40;&quot;ColorMap&quot;, assetManager.loadTexture&#40;&quot;Textures/ColoredTex/Monkey.png&quot;&#41;&#41;;
-    mat_tt.getAdditionalRenderState&#40;&#41;.setBlendMode&#40;BlendMode.Alpha&#41;; // activate transparency
-    seethrough.setMaterial&#40;mat_tt&#41;;
-    seethrough.setQueueBucket&#40;Bucket.Transparent&#41;;
-    rootNode.attachChild&#40;seethrough&#41;;</pre>
+<pre>    /** A translucent/transparent texture, similar to a window frame. */
+    Box cube2Mesh = new Box&#40; 1f,1f,0.01f&#41;;
+    Geometry cube2Geo = new Geometry&#40;&quot;window frame&quot;, cube2Mesh&#41;;
+    Material cube2Mat = new Material&#40;assetManager, 
+    &quot;Common/MatDefs/Misc/Unshaded.j3md&quot;&#41;;
+    cube2Mat.setTexture&#40;&quot;ColorMap&quot;, 
+        assetManager.loadTexture&#40;&quot;Textures/ColoredTex/Monkey.png&quot;&#41;&#41;;
+    cube2Mat.getAdditionalRenderState&#40;&#41;.setBlendMode&#40;BlendMode.Alpha&#41;;  // !
+    cube2Geo.setQueueBucket&#40;Bucket.Transparent&#41;;                        // !
+    cube2Geo.setMaterial&#40;cube2Mat&#41;;
+    rootNode.attachChild&#40;cube2Geo&#41;;</pre>
+
+<p>
+For non-transparent objects, the drawing order is not so important, because the z-buffer already keeps track of whether a pixel is behind something else or not, and the color of an opaque pixel doesn&#039;t depend on the pixels under it, this is why opaque Geometries can be drawn in any order.
+</p>
 
 <p>
-What you did is the same as before, with only one added step for the transparency.
+What you did for the transparent texture is the same as before, with only one added step for the transparency.
 </p>
 <ol>
-<li><div> Create a Geometry from a mesh. This Geometry is flat upright box.</div>
+<li><div> Create a Geometry <code>cube2Geo</code> from a Box mesh <code>cube2Mesh</code>. This Box Geometry is flat upright box (because z=0.01f).</div>
 </li>
-<li><div> Create a Material based on jME3&#039;s default <code>Unshaded.j3md</code> material definition.</div>
+<li><div> Create a Material <code>cube2Mat</code> based on jME3&#039;s default <code>Unshaded.j3md</code> material definition.</div>
 </li>
-<li><div> Create a texture from the <code>Monkey.png</code> file and load it into the material. <br/>
-The ColorMap is the material layer where textures go. This <acronym title="Portable Network Graphics">PNG</acronym> file must have an alpha layer.</div>
+<li><div> Create a texture <code>cube2Tex</code> from the <code>Monkey.png</code> file in the <code>assets/Textures/ColoredTex/</code> directory of the project. This <acronym title="Portable Network Graphics">PNG</acronym> file must have an alpha layer.</div>
 </li>
-<li><div> Activate transparency in the material by setting the blend mode to Alpha!</div>
+<li><div> <strong>Activate transparency in the material by setting the blend mode to Alpha.</strong></div>
 </li>
-<li><div> Apply the material to the Geometry.</div>
+<li><div> <strong>Set the QueueBucket of the Geometry to <code>Bucket.Transparent</code>.</strong></div>
 </li>
-<li><div> Set the QueueBucket of the Geometry to <code>Bucket.Transparent</code>.</div>
+<li><div> Load the texture <code>cube2Tex</code> into the <code>ColorMap</code> layer of the material <code>cube2Mat</code>.</div>
 </li>
-<li><div> Attach the cube to the rootnode.</div>
+<li><div> Apply the material to the cube, and attach the cube to the rootnode.</div>
 </li>
 </ol>
 
@@ -213,59 +218,62 @@ The ColorMap is the material layer where textures go. This <acronym title="Porta
 </p>
 
 </div>
-<!-- EDIT4 SECTION "Transparent Unshaded Texture" [6075-8376] -->
+<!-- EDIT4 SECTION "Transparent Unshaded Texture" [5633-8184] -->
 <h2><a>Shininess and Bumpiness</a></h2>
 <div>
 
 <p>
 
-But textures are not all. Have a close look at the shiny sphere ??? you cannot get such a nice bumpy material with just a texture. JME3 also supports so-called Phong-illuminated materials:
+But textures are not all. Have a close look at the shiny sphere ??? you cannot get such a nice bumpy material with just a plain texture. You see that JME3 also supports so-called Phong-illuminated materials:
 </p>
 
 <p>
-In a lit material, the standard texture layer is refered to as <em>Diffuse Map</em>, any material can use this layer. A lit material can additionally have lighting effects such as <em>Shininess</em> used together with the <em>Specular Map</em> layer, and even a realistically bumpy or cracked surface with help of the <em>Normal Map</em> layer.
+In a lit material, the standard texture layer is refered to as <em>DiffuseMap</em>, any material can use this layer. A lit material can additionally have lighting effects such as <em>Shininess</em> used together with the <em>SpecularMap</em> layer and <em>Specular</em> color. And you can even get a realistically bumpy or cracked surface with help of the <em>NormalMap</em> layer.
 </p>
 
 <p>
 Let&#039;s have a look at the part of the code example where you create the shiny bumpy rock.
 </p>
 <ol>
-<li><div> Create a Geometry from a Sphere shape. Note that this shape is a normal smooth sphere mesh. <pre>    Sphere rock = new Sphere&#40;32,32, 2f&#41;;
-    Geometry shiny_rock = new Geometry&#40;&quot;Shiny rock&quot;, rock&#41;;</pre>
+<li><div> Create a Geometry from a Sphere shape. Note that this shape is a normal smooth sphere mesh. <pre>    Sphere sphereMesh = new Sphere&#40;32,32, 2f&#41;;
+    Geometry sphereGeo = new Geometry&#40;&quot;Shiny rock&quot;, sphereMesh&#41;;</pre>
 </div>
 <ol>
-<li><div> (Only for Spheres) Change the sphere&#039;s TextureMode to make the square texture project better onto the sphere.<pre>    rock.setTextureMode&#40;Sphere.TextureMode.Projected&#41;; </pre>
+<li><div> (Only for Spheres) Change the sphere&#039;s TextureMode to make the square texture project better onto the sphere.<pre>    sphereMesh.setTextureMode&#40;Sphere.TextureMode.Projected&#41;;</pre>
 </div>
 </li>
-<li><div> You generate TangentBinormals for the sphere mesh so you can use the NormalMap layer of the texture.<pre>    TangentBinormalGenerator.generate&#40;rock&#41;;</pre>
+<li><div> You must generate TangentBinormals for the mesh so you can use the NormalMap layer of the texture.<pre>    TangentBinormalGenerator.generate&#40;sphereMesh&#41;;</pre>
 </div>
 </li>
 </ol>
 </li>
-<li><div> Create a material based on the <code>Lighting.j3md</code> default material.<pre>    Material mat_lit = new Material&#40;assetManager, 
-    &quot;Common/MatDefs/Light/Lighting.j3md&quot;&#41;;</pre>
+<li><div> Create a material based on the <code>Lighting.j3md</code> default material.<pre>    Material sphereMat = new Material&#40;assetManager, 
+        &quot;Common/MatDefs/Light/Lighting.j3md&quot;&#41;;</pre>
 </div>
 <ol>
 <li><div> Set a standard rocky texture in the <code>DiffuseMap</code> layer. <br/>
-<img src="/wiki/lib/exe/fetch.php"><pre>    mat_lit.setTexture&#40;&quot;DiffuseMap&quot;, assetManager.loadTexture&#40;
-    &quot;Textures/Terrain/Pond/Pond.jpg&quot;&#41;&#41;;</pre>
+<img src="/wiki/lib/exe/fetch.php"><pre>    sphereMat.setTexture&#40;&quot;DiffuseMap&quot;, 
+        assetManager.loadTexture&#40;&quot;Textures/Terrain/Pond/Pond.jpg&quot;&#41;&#41;;</pre>
 </div>
 </li>
-<li><div> Set the <code>NormalMap</code> layer that contains the bumpiness. The NormalMap was generated for this particular DiffuseMap with a special tool (e.g. Blender). <img src="/wiki/lib/exe/fetch.php"> <pre>    mat_lit.setTexture&#40;&quot;NormalMap&quot;, assetManager.loadTexture&#40;
-    &quot;Textures/Terrain/Pond/Pond_normal.png&quot;&#41;&#41;;</pre>
+<li><div> Set the <code>NormalMap</code> layer that contains the bumpiness. The NormalMap was generated for this particular DiffuseMap with a special tool (e.g. Blender). <img src="/wiki/lib/exe/fetch.php"> <pre>    sphereMat.setTexture&#40;&quot;NormalMap&quot;, 
+        assetManager.loadTexture&#40;&quot;Textures/Terrain/Pond/Pond_normal.png&quot;&#41;&#41;;</pre>
 </div>
 </li>
-<li><div> Set the Material&#039;s Shininess to a value between 1 and 128. For a rock, a low fuzzy shininess is appropriate. <pre>    mat_lit.setFloat&#40;&quot;Shininess&quot;, 5f&#41;; // [1,128]</pre>
+<li><div> Set the Material&#039;s Shininess to a value between 1 and 128. For a rock, a low fuzzy shininess is appropriate. Use material colors to define the shiny Specular color. <pre>    sphereMat.setBoolean&#40;&quot;UseMaterialColors&quot;,true&#41;;    
+    sphereMat.setColor&#40;&quot;Diffuse&quot;,ColorRGBA.White&#41;;  // minimum material color
+    sphereMat.setColor&#40;&quot;Specular&quot;,ColorRGBA.White&#41;; // for shininess
+    sphereMat.setFloat&#40;&quot;Shininess&quot;, 64f&#41;; // [1,128] for shininess</pre>
 </div>
 </li>
 </ol>
 </li>
-<li><div> Assign your newly created material to the Geometry.<pre>    shiny_rock.setMaterial&#40;mat_lit&#41;;</pre>
+<li><div> Assign your newly created material to the Geometry.<pre>    sphereGeo.setMaterial&#40;sphereMat&#41;;</pre>
 </div>
 </li>
-<li><div> Let&#039;s move and rotate the geometry a bit to position it better. <pre>    shiny_rock.setLocalTranslation&#40;0,2,-2&#41;; // Move it a bit
-    shiny_rock.rotate&#40;1.6f, 0, 0&#41;;          // Rotate it a bit
-    rootNode.attachChild&#40;shiny_rock&#41;;</pre>
+<li><div> Let&#039;s move and rotate the geometry a bit to position it better. <pre>    sphereGeo.setLocalTranslation&#40;0,2,-2&#41;; // Move it a bit
+    sphereGeo.rotate&#40;1.6f, 0, 0&#41;;          // Rotate it a bit
+    rootNode.attachChild&#40;sphereGeo&#41;;</pre>
 </div>
 </li>
 </ol>
@@ -280,7 +288,7 @@ Remember that any Lighting.j3md-based material requires a light source, as shown
 </p>
 
 </div>
-<!-- EDIT5 SECTION "Shininess and Bumpiness" [8377-11260] -->
+<!-- EDIT5 SECTION "Shininess and Bumpiness" [8185-11426] -->
 <h2><a>Default Material Definitions</a></h2>
 <div>
 
@@ -305,59 +313,70 @@ DiffuseMap, NormalMap, SpecularMap : Texture2D <br/>
 Shininess : Float </td>
 	</tr>
 </table></div>
-<!-- EDIT7 TABLE [11400-11870] -->
+<!-- EDIT7 TABLE [11566-12036] -->
 <p>
 
 For a game, you create custom Materials based on these existing MaterialDefintions ??? as you have just seen in the example with the shiny rock&#039;s material.
 </p>
 
 </div>
-<!-- EDIT6 SECTION "Default Material Definitions" [11261-12027] -->
+<!-- EDIT6 SECTION "Default Material Definitions" [11427-12193] -->
 <h2><a>Exercises</a></h2>
 <div>
 
 </div>
-<!-- EDIT8 SECTION "Exercises" [12028-12050] -->
+<!-- EDIT8 SECTION "Exercises" [12194-12216] -->
 <h3><a>Exercise 1: Custom .j3m Material</a></h3>
 <div>
 
 <p>
 
-Look at the purple leak-through sample above again. It takes four lines to create and set the Material.
+Look at the shiny rocky sphere above again. It takes several lines to create and set the Material.
 </p>
 <ul>
-<li><div> Note how it loads the <code>Unshaded.j3md</code> Material definition.</div>
+<li><div> Note how it loads the <code>Lighting.j3md</code> Material definition.</div>
 </li>
-<li><div> Note how it sets the <code>Color</code> parameter to purple (<code>new ColorRGBA(1f,0f,1f,1f)</code>).</div>
+<li><div> Note how it sets the <code>DiffuseMap</code> and <code>NormalMap</code> to a texture path.</div>
 </li>
-<li><div> Note how it sets the <code>ColorMap</code> to a texture path.</div>
+<li><div> Note how it activates <code>UseMaterialColors</code> and sets <code>Specular</code> and <code>Diffuse</code> to 4 float values (RGBA color).</div>
+</li>
+<li><div> Note how it sets <code>Shininess</code> to 64.</div>
 </li>
 </ul>
 
 <p>
+
 If you want to use one custom material for several models, you can store it in a .j3m file, and save a few lines of code every time. 
+</p>
+
+<p>
 You create a j3m file as follows:
 </p>
 <ol>
-<li><div> Create a file <code>assets/Materials/LeakThrough.j3m</code> in your project directory, with the following content:<pre>Material Leak Through : Common/MatDefs/Misc/Unshaded.j3md {
+<li><div> Create a plain text file <code>assets/Materials/MyCustomMaterial.j3m</code> in your project directory, with the following content:<pre>Material My shiny custom material : Common/MatDefs/Light/Lighting.j3md {
      MaterialParameters {
-         Color : 1 0 1 1
-         ColorMap : Flip Textures/ColoredTex/Monkey.png
+        DiffuseMap : Textures/Terrain/Pond/Pond.jpg
+        NormalMap : Textures/Terrain/Pond/Pond_normal.png
+        UseMaterialColors : true
+        Specular : 1.0 1.0 1.0 1.0
+        Diffuse : 1.0 1.0 1.0 1.0
+        Shininess : 64.0
      }
 }</pre>
 </div>
 <ul>
 <li><div> Note that <code>Material</code> is a fixed keyword.</div>
 </li>
-<li><div> Note that <code>Leak Through</code> is a String that you can choose to name the material.</div>
+<li><div> Note that <code>My shiny custom material</code> is a String that you can choose to describe the material.</div>
 </li>
-<li><div> Note how the code sets the same three properties, Color, ColorMap, and Unshaded.j3md.</div>
+<li><div> Note how the code sets all the same properties as before! </div>
 </li>
 </ul>
 </li>
-<li><div> In the code sample, comment out the three lines with <code>mat_tl</code> in them.</div>
+<li><div> In the code sample, comment out the eight lines that have <code>sphereMat</code> in them.</div>
 </li>
-<li><div> Below them, add the following line: <pre>cube_leak.setMaterial&#40;&#40;Material&#41; assetManager.loadMaterial&#40; &quot;Materials/LeakThrough.j3m&quot;&#41;&#41;;</pre>
+<li><div> Below this line, add the following line: <pre>sphereGeo.setMaterial&#40;&#40;Material&#41; assetManager.loadMaterial&#40; 
+    &quot;Materials/MyCustomMaterial.j3m&quot;&#41;&#41;;</pre>
 </div>
 </li>
 <li><div> Run the app. The result is the same.</div>
@@ -366,11 +385,11 @@ You create a j3m file as follows:
 
 <p>
 
-Using this new custom material <code>LeakThrough.j3m</code> only takes one line. You have replaced the three lines of an on-the-fly material definition with one line that loads a custom material from a file. This method is very handy if you use the same material often.
+Using this new custom material <code>MyCustomMaterial.j3m</code> only takes one line. You have replaced the eight lines of an on-the-fly material definition with one line that loads a custom material from a file. Using .j3m files is very handy if you use the same material often. 
 </p>
 
 </div>
-<!-- EDIT9 SECTION "Exercise 1: Custom .j3m Material" [12051-13637] -->
+<!-- EDIT9 SECTION "Exercise 1: Custom .j3m Material" [12217-14101] -->
 <h3><a>Exercise 2: Bumpiness and Shininess</a></h3>
 <div>
 
@@ -400,7 +419,7 @@ Go back to the bumpy rock sample above:
 </ol>
 
 </div>
-<!-- EDIT10 SECTION "Exercise 2: Bumpiness and Shininess" [13638-14065] -->
+<!-- EDIT10 SECTION "Exercise 2: Bumpiness and Shininess" [14102-14529] -->
 <h2><a>Conclusion</a></h2>
 <div>
 
@@ -450,5 +469,5 @@ See also
 </span></div>
 
 </div>
-<!-- EDIT11 SECTION "Conclusion" [14066-] -->
+<!-- EDIT11 SECTION "Conclusion" [14530-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:beginner:hello_material?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/beginner/hello_node.html

@@ -44,16 +44,15 @@ You will learn that the scene graph represents the 3D world, and why the rootNod
  
 import com.jme3.app.SimpleApplication;
 import com.jme3.material.Material;
+import com.jme3.math.ColorRGBA;
 import com.jme3.math.Vector3f;
 import com.jme3.scene.Geometry;
-import com.jme3.scene.shape.Box;
-import com.jme3.math.ColorRGBA;
 import com.jme3.scene.Node;
+import com.jme3.scene.shape.Box;
  
 <span>/** Sample 2 - How to use nodes as handles to manipulate objects in the scene.
  * You can rotate, translate, and scale objects by manipulating their parent nodes.
  * The Root Node is special: Only what is attached to the Root Node appears in the scene. */</span>
-&nbsp;
 public class HelloNode extends SimpleApplication &#123;
 &nbsp;
     public static void main&#40;String&#91;&#93; args&#41;&#123;
@@ -65,28 +64,28 @@ public class HelloNode extends SimpleApplication &#123;
     public void simpleInitApp&#40;&#41; &#123;
 &nbsp;
         /** create a blue box at coordinates (1,-1,1) */
-        Box box1 = new Box&#40; Vector3f.ZERO, 1,1,1&#41;;
+        Box box1 = new Box&#40;1,1,1&#41;;
         Geometry blue = new Geometry&#40;&quot;Box&quot;, box1&#41;;
+        blue.setLocalTranslation&#40;new Vector3f&#40;1,-1,1&#41;&#41;;
         Material mat1 = new Material&#40;assetManager, 
                 &quot;Common/MatDefs/Misc/Unshaded.j3md&quot;&#41;;
         mat1.setColor&#40;&quot;Color&quot;, ColorRGBA.Blue&#41;;
         blue.setMaterial&#40;mat1&#41;;
-        blue.move&#40;1,-1,1&#41;;
 &nbsp;
         /** create a red box straight above the blue one at (1,3,1) */
-        Box box2 = new Box&#40; Vector3f.ZERO, 1,1,1&#41;;
+        Box box2 = new Box&#40;1,1,1&#41;;      
         Geometry red = new Geometry&#40;&quot;Box&quot;, box2&#41;;
+        red.setLocalTranslation&#40;new Vector3f&#40;1,3,1&#41;&#41;;
         Material mat2 = new Material&#40;assetManager, 
                 &quot;Common/MatDefs/Misc/Unshaded.j3md&quot;&#41;;
         mat2.setColor&#40;&quot;Color&quot;, ColorRGBA.Red&#41;;
         red.setMaterial&#40;mat2&#41;;
-        red.move&#40;1,3,1&#41;;
 &nbsp;
         /** Create a pivot node at (0,0,0) and attach it to the root node */
         Node pivot = new Node&#40;&quot;pivot&quot;&#41;;
         rootNode.attachChild&#40;pivot&#41;; // put this node in the scene
 &nbsp;
-        /** Attach the two boxes to the *pivot* node. */
+        /** Attach the two boxes to the *pivot* node. (And transitively to the root node.) */
         pivot.attachChild&#40;blue&#41;;
         pivot.attachChild&#40;red&#41;;
         /** Rotate the pivot node: Note that both boxes have rotated! */
@@ -99,7 +98,7 @@ Build and run the code sample. You should see two colored boxes tilted at the sa
 </p>
 
 </div>
-<!-- EDIT2 SECTION "Code Sample" [997-3048] -->
+<!-- EDIT2 SECTION "Code Sample" [997-3108] -->
 <h2><a>Understanding the Terminology</a></h2>
 <div>
 
@@ -128,7 +127,7 @@ In this tutorial, you learn some new terms:
 		<td>Position/move, turn, or resize an object</td><td>Translate, or rotate, or scale an object = transform an object.</td>
 	</tr>
 </table></div>
-<!-- EDIT4 TABLE [3137-3561] -->
+<!-- EDIT4 TABLE [3197-3621] -->
 <p>
 
 Every JME3 application has a rootNode: Your game automatically inherits the <code>rootNode</code> object from SimpleApplication. Everything attached to the rootNode is part of the scene graph. The elements of the scene graph are Spatials.
@@ -155,9 +154,9 @@ Every JME3 application has a rootNode: Your game automatically inherits the <cod
 		<th> Examples: </th><td> A box, a sphere, a player, a building, a piece of terrain, a vehicle, missiles, NPCs, etc??? </td><td> The <code>rootNode</code>, a floor node grouping several terrains, a custom vehicle-with-passengers node, a player-with-weapon node, an audio node, etc??? </td>
 	</tr>
 </table></div>
-<!-- EDIT5 TABLE [3977-4470] -->
+<!-- EDIT5 TABLE [4037-4530] -->
 </div>
-<!-- EDIT3 SECTION "Understanding the Terminology" [3049-4471] -->
+<!-- EDIT3 SECTION "Understanding the Terminology" [3109-4531] -->
 <h2><a>Understanding the Code</a></h2>
 <div>
 
@@ -171,19 +170,18 @@ What happens in the code snippet? You use the <code>simpleInitApp()</code> metho
 <ul>
 <li><div> Create a Box shape with extents of (1,1,1), that makes the box 2x2x2 world units big.</div>
 </li>
-<li><div> Position the box at (1,-1,1) using the move() method. (Don&#039;t change the Vector3f.ZERO unless you want to change the center of rotation)</div>
+<li><div> Position the box at (1,-1,1) using the setLocalTranslation() method.</div>
 </li>
 <li><div> Wrap the Box shape into a Geometry.</div>
 </li>
 <li><div> Create a blue material. </div>
 </li>
-<li><div> Apply the blue material to the Box Geometry. <pre>    Box box1 = new Box&#40; Vector3f.ZERO, 1,1,1&#41;;
+<li><div> Apply the blue material to the Box Geometry. <pre>    Box box1 = new Box&#40;1,1,1&#41;;
     Geometry blue = new Geometry&#40;&quot;Box&quot;, box1&#41;;
-    Material mat1 = new Material&#40;assetManager,
-      &quot;Common/MatDefs/Misc/Unshaded.j3md&quot;&#41;;
+    blue.setLocalTranslation&#40;new Vector3f&#40;1,-1,1&#41;&#41;;
+    Material mat1 = new Material&#40;assetManager,&quot;Common/MatDefs/Misc/Unshaded.j3md&quot;&#41;;
     mat1.setColor&#40;&quot;Color&quot;, ColorRGBA.Blue&#41;;
-    blue.setMaterial&#40;mat1&#41;;
-    blue.move&#40;1,-1,1&#41;;</pre>
+    blue.setMaterial&#40;mat1&#41;;</pre>
 </div>
 </li>
 </ul>
@@ -198,13 +196,13 @@ What happens in the code snippet? You use the <code>simpleInitApp()</code> metho
 </li>
 <li><div> Create a red material. </div>
 </li>
-<li><div> Apply the red material to the Box Geometry. <pre>    Box box2 = new Box&#40; Vector3f.ZERO, 1,1,1&#41;;
+<li><div> Apply the red material to the Box Geometry. <pre>    Box box2 = new Box&#40;1,1,1&#41;;
     Geometry red = new Geometry&#40;&quot;Box&quot;, box2&#41;;
+    red.setLocalTranslation&#40;new Vector3f&#40;1,3,1&#41;&#41;;
     Material mat2 = new Material&#40;assetManager,
       &quot;Common/MatDefs/Misc/Unshaded.j3md&quot;&#41;;
     mat2.setColor&#40;&quot;Color&quot;, ColorRGBA.Red&#41;;
-    red.setMaterial&#40;mat2&#41;;
-    red.move&#40;1,3,1&#41;;</pre>
+    red.setMaterial&#40;mat2&#41;;</pre>
 </div>
 </li>
 </ul>
@@ -245,7 +243,7 @@ If you run the app with only the code up to here, you see two cubes: A red cube
 </ol>
 
 </div>
-<!-- EDIT6 SECTION "Understanding the Code" [4472-6874] -->
+<!-- EDIT6 SECTION "Understanding the Code" [4532-6885] -->
 <h3><a>What is a Pivot Node?</a></h3>
 <div>
 
@@ -264,7 +262,7 @@ You can transform (e.g. rotate) Geometries around their own center, or around a
 </ul>
 
 </div>
-<!-- EDIT7 SECTION "What is a Pivot Node?" [6875-8197] -->
+<!-- EDIT7 SECTION "What is a Pivot Node?" [6886-8208] -->
 <h2><a>How do I Populate the Scenegraph?</a></h2>
 <div>
 <div><table>
@@ -298,9 +296,9 @@ thing.setMaterial&#40;mat&#41;;</pre>
 		<td> Specify what should be loaded at the start </td><td> Everything you initialize and attach to the <code>rootNode</code> in the <code>simpleInitApp()</code> method is part of the scene at the start of the game. </td>
 	</tr>
 </table></div>
-<!-- EDIT9 TABLE [8245-9538] -->
+<!-- EDIT9 TABLE [8256-9549] -->
 </div>
-<!-- EDIT8 SECTION "How do I Populate the Scenegraph?" [8198-9539] -->
+<!-- EDIT8 SECTION "How do I Populate the Scenegraph?" [8209-9550] -->
 <h2><a>How do I Transform Spatials?</a></h2>
 <div>
 
@@ -324,7 +322,7 @@ To move a Spatial <em>to</em> specific coordinates, such as (0,40.2f,-2), use: <
 </td><td>+right -left</td><td>+up -down</td><td>+forward -backward</td>
 	</tr>
 </table></div>
-<!-- EDIT11 TABLE [9663-10179] --><div><table>
+<!-- EDIT11 TABLE [9674-10190] --><div><table>
 	<tr>
 		<th> Scaling resizes Spatials </th><th> X-axis </th><th> Y-axis </th><th> Z-axis </th>
 	</tr>
@@ -336,7 +334,7 @@ To scale a Spatial 10 times longer, one tenth the height, and keep the same widt
 </td><td>length</td><td>height</td><td>width</td>
 	</tr>
 </table></div>
-<!-- EDIT12 TABLE [10181-10670] --><div><table>
+<!-- EDIT12 TABLE [10192-10681] --><div><table>
 	<tr>
 		<th> Rotation turns Spatials </th><th> X-axis </th><th> Y-axis </th><th> Z-axis </th>
 	</tr>
@@ -352,9 +350,9 @@ To roll an object 180?? around the z axis: <pre>thing.rotate&#40; 0f , 0f , 180*
 </td><td>pitch = nodding your head</td><td>yaw = shaking your head</td><td>roll = cocking your head</td>
 	</tr>
 </table></div>
-<!-- EDIT13 TABLE [10672-11453] -->
+<!-- EDIT13 TABLE [10683-11464] -->
 </div>
-<!-- EDIT10 SECTION "How do I Transform Spatials?" [9540-11454] -->
+<!-- EDIT10 SECTION "How do I Transform Spatials?" [9551-11465] -->
 <h2><a>How do I Troubleshoot Spatials?</a></h2>
 <div>
 
@@ -371,7 +369,7 @@ If you get unexpected results, check whether you made the following common mista
 		<td> A created Geometry does not appear in the scene. </td><td> Have you attached it to (a node that is attached to) the rootNode? <br/>
 Does it have a Material? <br/>
 What is its translation (position)? Is it behind the camera or covered up by another Geometry? <br/>
-Is it to tiny or too gigantic to see? <br/>
+Is it too tiny or too gigantic to see? <br/>
 Is it too far from the camera? (Try <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://jmonkeyengine.org/javadoc/com/jme3/renderer/Camera.html#setFrustumFar%28float%29"><param name="text" value="<html><u>cam.setFrustumFar</u></html>"><param name="textColor" value="blue"></object>(111111f); to see further) </td>
 	</tr>
 	<tr>
@@ -384,9 +382,9 @@ Did you rotate around the right axis? </td>
 		<td> A Geometry has an unexpected Color or Material. </td><td> Did you reuse a Material from another Geometry and have inadvertently changed its properties? (If so, consider cloning it: mat2 = mat.clone(); )  </td>
 	</tr>
 </table></div>
-<!-- EDIT15 TABLE [11586-12644] -->
+<!-- EDIT15 TABLE [11597-12656] -->
 </div>
-<!-- EDIT14 SECTION "How do I Troubleshoot Spatials?" [11455-12645] -->
+<!-- EDIT14 SECTION "How do I Troubleshoot Spatials?" [11466-12657] -->
 <h2><a>How do I Add Custom Data to Spatials?</a></h2>
 <div>
 
@@ -419,7 +417,7 @@ By using different Strings keys (here the key is <code>pivot id</code>), you can
 </p>
 
 </div>
-<!-- EDIT16 SECTION "How do I Add Custom Data to Spatials?" [12646-14099] -->
+<!-- EDIT16 SECTION "How do I Add Custom Data to Spatials?" [12658-14111] -->
 <h2><a>Conclusion</a></h2>
 <div>
 
@@ -445,5 +443,5 @@ Since standard shapes like spheres and boxes get old fast, continue with the nex
 </span></div>
 
 </div>
-<!-- EDIT17 SECTION "Conclusion" [14100-] -->
+<!-- EDIT17 SECTION "Conclusion" [14112-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:beginner:hello_node?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/beginner/hello_physics.html

@@ -109,10 +109,10 @@ public class HelloPhysics extends SimpleApplication {
     sphere = new Sphere(32, 32, 0.4f, true, false);
     sphere.setTextureMode(TextureMode.Projected);
     /** Initialize the brick geometry */
-    box = new Box(Vector3f.ZERO, brickLength, brickHeight, brickWidth);
+    box = new Box(brickLength, brickHeight, brickWidth);
     box.scaleTextureCoordinates(new Vector2f(1f, .5f));
     /** Initialize the floor geometry */
-    floor = new Box(Vector3f.ZERO, 10f, 0.1f, 5f);
+    floor = new Box(10f, 0.1f, 5f);
     floor.scaleTextureCoordinates(new Vector2f(3, 6));
   }
  
@@ -251,7 +251,7 @@ You should see a brick wall. Click to shoot cannon balls. Watch the bricks fall
 </p>
 
 </div>
-<!-- EDIT2 SECTION "Sample Code" [1379-8764] -->
+<!-- EDIT2 SECTION "Sample Code" [1379-8734] -->
 <h2><a>A Basic Physics Application</a></h2>
 <div>
 
@@ -279,12 +279,12 @@ The BulletAppState gives the game access to a PhysicsSpace. The PhysicsSpace let
 </p>
 
 </div>
-<!-- EDIT3 SECTION "A Basic Physics Application" [8765-9748] -->
+<!-- EDIT3 SECTION "A Basic Physics Application" [8735-9718] -->
 <h2><a>Creating Bricks and Cannon Balls</a></h2>
 <div>
 
 </div>
-<!-- EDIT4 SECTION "Creating Bricks and Cannon Balls" [9749-9794] -->
+<!-- EDIT4 SECTION "Creating Bricks and Cannon Balls" [9719-9764] -->
 <h3><a>Geometries</a></h3>
 <div>
 
@@ -305,15 +305,15 @@ In this &quot;shoot at the wall&quot; example, you use Geometries such as cannon
     sphere = new Sphere&#40;32, 32, 0.4f, true, false&#41;;
     sphere.setTextureMode&#40;TextureMode.Projected&#41;;
     /** Initialize the brick geometry */
-    box = new Box&#40;Vector3f.ZERO, brickLength, brickHeight, brickWidth&#41;;
+    box = new Box&#40;brickLength, brickHeight, brickWidth&#41;;
     box.scaleTextureCoordinates&#40;new Vector2f&#40;1f, .5f&#41;&#41;;
     /** Initialize the floor geometry */
-    floor = new Box&#40;Vector3f.ZERO, 10f, 0.1f, 5f&#41;;
+    floor = new Box&#40;10f, 0.1f, 5f&#41;;
     floor.scaleTextureCoordinates&#40;new Vector2f&#40;3, 6&#41;&#41;;
   &#125;</pre>
 
 </div>
-<!-- EDIT5 SECTION "Geometries" [9795-10890] -->
+<!-- EDIT5 SECTION "Geometries" [9765-10830] -->
 <h3><a>RigidBodyControl: Brick</a></h3>
 <div>
 
@@ -375,7 +375,7 @@ This code sample does the following:
 </ol>
 
 </div>
-<!-- EDIT6 SECTION "RigidBodyControl: Brick" [10891-12413] -->
+<!-- EDIT6 SECTION "RigidBodyControl: Brick" [10831-12353] -->
 <h3><a>RigidBodyControl: Cannonball</a></h3>
 <div>
 
@@ -438,7 +438,7 @@ Since you are shooting cannon balls, the last line accelerates the ball in the d
 </p>
 
 </div>
-<!-- EDIT7 SECTION "RigidBodyControl: Cannonball" [12414-14010] -->
+<!-- EDIT7 SECTION "RigidBodyControl: Cannonball" [12354-13950] -->
 <h3><a>RigidBodyControl: Floor</a></h3>
 <div>
 
@@ -493,7 +493,7 @@ This code sample does the following:
 </ol>
 
 </div>
-<!-- EDIT8 SECTION "RigidBodyControl: Floor" [14011-15435] -->
+<!-- EDIT8 SECTION "RigidBodyControl: Floor" [13951-15375] -->
 <h2><a>Creating the Scene</a></h2>
 <div>
 
@@ -518,7 +518,7 @@ These methods are each called once from the <code>simpleInitApp()</code> method
 </p>
 
 </div>
-<!-- EDIT9 SECTION "Creating the Scene" [15436-16264] -->
+<!-- EDIT9 SECTION "Creating the Scene" [15376-16204] -->
 <h2><a>The Cannon Ball Shooting Action</a></h2>
 <div>
 
@@ -548,7 +548,7 @@ In the moment the cannonball appears in the scene, it flies off with the velocit
 </p>
 
 </div>
-<!-- EDIT10 SECTION "The Cannon Ball Shooting Action" [16265-17305] -->
+<!-- EDIT10 SECTION "The Cannon Ball Shooting Action" [16205-17245] -->
 <h2><a>Moving a Physical Spatial</a></h2>
 <div>
 
@@ -575,12 +575,12 @@ Learn more about static versus kinematic versus dynamic in the <a href="/com/jme
 </p>
 
 </div>
-<!-- EDIT11 SECTION "Moving a Physical Spatial" [17306-18275] -->
+<!-- EDIT11 SECTION "Moving a Physical Spatial" [17246-18215] -->
 <h2><a>Excercises</a></h2>
 <div>
 
 </div>
-<!-- EDIT12 SECTION "Excercises" [18276-18299] -->
+<!-- EDIT12 SECTION "Excercises" [18216-18239] -->
 <h3><a>Exercise 1: Debug Shapes</a></h3>
 <div>
 
@@ -597,7 +597,7 @@ Now you see the collisionShapes of the bricks and spheres, and the floor highlig
 </p>
 
 </div>
-<!-- EDIT13 SECTION "Exercise 1: Debug Shapes" [18300-18565] -->
+<!-- EDIT13 SECTION "Exercise 1: Debug Shapes" [18240-18505] -->
 <h3><a>Exercise 2: No Mo&#039; Static</a></h3>
 <div>
 
@@ -607,7 +607,7 @@ What happens if you give a static node, such as the floor, a mass of more than 0
 </p>
 
 </div>
-<!-- EDIT14 SECTION "Exercise 2: No Mo' Static" [18566-18686] -->
+<!-- EDIT14 SECTION "Exercise 2: No Mo' Static" [18506-18626] -->
 <h3><a>Exercise 3: Behind the Curtain</a></h3>
 <div>
 
@@ -625,7 +625,7 @@ Using physics everywhere in a game sounds like a cool idea, but it is easily ove
 </p>
 
 </div>
-<!-- EDIT15 SECTION "Exercise 3: Behind the Curtain" [18687-19692] -->
+<!-- EDIT15 SECTION "Exercise 3: Behind the Curtain" [18627-19632] -->
 <h2><a>Conclusion</a></h2>
 <div>
 
@@ -649,5 +649,5 @@ You have learned how to activate the jBullet PhysicsSpace in an application by a
 </span></div>
 
 </div>
-<!-- EDIT16 SECTION "Conclusion" [19693-] -->
+<!-- EDIT16 SECTION "Conclusion" [19633-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:beginner:hello_physics?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/beginner/hello_picking.html

@@ -39,12 +39,14 @@ import com.jme3.input.MouseInput;
 import com.jme3.input.controls.ActionListener;
 import com.jme3.input.controls.KeyTrigger;
 import com.jme3.input.controls.MouseButtonTrigger;
+import com.jme3.light.DirectionalLight;
 import com.jme3.material.Material;
 import com.jme3.math.ColorRGBA;
 import com.jme3.math.Ray;
 import com.jme3.math.Vector3f;
 import com.jme3.scene.Geometry;
 import com.jme3.scene.Node;
+import com.jme3.scene.Spatial;
 import com.jme3.scene.shape.Box;
 import com.jme3.scene.shape.Sphere;
  
@@ -56,8 +58,8 @@ public class HelloPicking extends SimpleApplication {
     HelloPicking app = new HelloPicking();
     app.start();
   }
-  Node shootables;
-  Geometry mark;
+  private Node shootables;
+  private Geometry mark;
  
   @Override
   public void simpleInitApp() {
@@ -73,6 +75,7 @@ public class HelloPicking extends SimpleApplication {
     shootables.attachChild(makeCube("the Sheriff", 0f, 1f, -2f));
     shootables.attachChild(makeCube("the Deputy", 1f, 0f, -4f));
     shootables.attachChild(makeFloor());
+    shootables.attachChild(makeCharacter());
   }
  
   /** Declaring the "Shoot" action and mapping to its triggers. */
@@ -120,8 +123,9 @@ public class HelloPicking extends SimpleApplication {
  
   /** A cube object for target practice */
   protected Geometry makeCube(String name, float x, float y, float z) {
-    Box box = new Box(new Vector3f(x, y, z), 1, 1, 1);
+    Box box = new Box(1, 1, 1);
     Geometry cube = new Geometry(name, box);
+    cube.setLocalTranslation(x, y, z);
     Material mat1 = new Material(assetManager, "Common/MatDefs/Misc/Unshaded.j3md");
     mat1.setColor("Color", ColorRGBA.randomColor());
     cube.setMaterial(mat1);
@@ -130,8 +134,9 @@ public class HelloPicking extends SimpleApplication {
  
   /** A floor to show that the "shot" can go through several objects. */
   protected Geometry makeFloor() {
-    Box box = new Box(new Vector3f(0, -4, -5), 15, .2f, 15);
+    Box box = new Box(15, .2f, 15);
     Geometry floor = new Geometry("the Floor", box);
+    floor.setLocalTranslation(0, -4, -5);
     Material mat1 = new Material(assetManager, "Common/MatDefs/Misc/Unshaded.j3md");
     mat1.setColor("Color", ColorRGBA.Gray);
     floor.setMaterial(mat1);
@@ -149,16 +154,28 @@ public class HelloPicking extends SimpleApplication {
  
   /** A centred plus sign to help the player aim. */
   protected void initCrossHairs() {
-    guiNode.detachAllChildren();
+    setDisplayStatView(false);
     guiFont = assetManager.loadFont("Interface/Fonts/Default.fnt");
     BitmapText ch = new BitmapText(guiFont, false);
     ch.setSize(guiFont.getCharSet().getRenderedSize() * 2);
     ch.setText("+"); // crosshairs
     ch.setLocalTranslation( // center
-      settings.getWidth() / 2 - guiFont.getCharSet().getRenderedSize() / 3 * 2,
-      settings.getHeight() / 2 + ch.getLineHeight() / 2, 0);
+      settings.getWidth() / 2 - ch.getLineWidth()/2, settings.getHeight() / 2 + ch.getLineHeight()/2, 0);
     guiNode.attachChild(ch);
   }
+ 
+  protected Spatial makeCharacter() {
+    // load a character from jme3test-test-data
+    Spatial golem = assetManager.loadModel("Models/Oto/Oto.mesh.xml");
+    golem.scale(0.5f);
+    golem.setLocalTranslation(-1.0f, -1.5f, -0.6f);
+ 
+    // We must add a light to make the model visible
+    DirectionalLight sun = new DirectionalLight();
+    sun.setDirection(new Vector3f(-0.1f, -0.7f, -1.0f));
+    golem.addLight(sun);
+    return golem;
+  }
 &#125;</pre>
 
 <p>
@@ -167,10 +184,11 @@ You should see four colored cubes floating over a gray floor, and cross-hairs. A
 
 <p>
 Keep an eye on the application&#039;s output stream, it will give you more details: The name of the mesh that was hit, the coordinates of the hit, and the distance.
+
 </p>
 
 </div>
-<!-- EDIT2 SECTION "Sample Code" [992-6844] -->
+<!-- EDIT2 SECTION "Sample Code" [992-7402] -->
 <h2><a>Understanding the Helper Methods</a></h2>
 <div>
 
@@ -204,7 +222,7 @@ In this example, we attached all &quot;shootable&quot; objects to one custom nod
 </p>
 
 </div>
-<!-- EDIT3 SECTION "Understanding the Helper Methods" [6845-7885] -->
+<!-- EDIT3 SECTION "Understanding the Helper Methods" [7403-8443] -->
 <h2><a>Understanding Ray Casting for Hit Testing</a></h2>
 <div>
 
@@ -236,12 +254,12 @@ Here is our simple ray casting algorithm for picking objects:
 </ol>
 
 </div>
-<!-- EDIT4 SECTION "Understanding Ray Casting for Hit Testing" [7886-8728] -->
+<!-- EDIT4 SECTION "Understanding Ray Casting for Hit Testing" [8444-9286] -->
 <h2><a>Implementing Hit Testing</a></h2>
 <div>
 
 </div>
-<!-- EDIT5 SECTION "Implementing Hit Testing" [8729-8766] -->
+<!-- EDIT5 SECTION "Implementing Hit Testing" [9287-9324] -->
 <h3><a>Loading the scene</a></h3>
 <div>
 
@@ -269,7 +287,7 @@ First initialize some shootable nodes and attach them to the scene. You will use
   &#125;</pre>
 
 </div>
-<!-- EDIT6 SECTION "Loading the scene" [8767-9453] -->
+<!-- EDIT6 SECTION "Loading the scene" [9325-10011] -->
 <h3><a>Setting Up the Input Listener</a></h3>
 <div>
 
@@ -282,12 +300,12 @@ Next you declare the shooting action. It can be triggered either by clicking, or
   private void initKeys&#40;&#41; &#123;
     inputManager.addMapping&#40;&quot;Shoot&quot;,      // Declare...
       new KeyTrigger&#40;KeyInput.KEY_SPACE&#41;, // trigger 1: spacebar, or
-      new MouseButtonTrigger&#40;0&#41;&#41;;         // trigger 2: left-button click
+      new MouseButtonTrigger&#40;MouseInput.BUTTON_LEFT&#41;&#41;;         // trigger 2: left-button click
     inputManager.addListener&#40;actionListener, &quot;Shoot&quot;&#41;; // ... and add.
   &#125;</pre>
 
 </div>
-<!-- EDIT7 SECTION "Setting Up the Input Listener" [9454-10074] -->
+<!-- EDIT7 SECTION "Setting Up the Input Listener" [10012-10652] -->
 <h3><a>Picking Action Using Crosshairs</a></h3>
 <div>
 
@@ -353,7 +371,7 @@ Note how it prints a lot of output to show you which hits were registered.
 </p>
 
 </div>
-<!-- EDIT8 SECTION "Picking Action Using Crosshairs" [10075-12848] -->
+<!-- EDIT8 SECTION "Picking Action Using Crosshairs" [10653-13426] -->
 <h3><a>Picking Action Using Mouse Pointer</a></h3>
 <div>
 
@@ -394,7 +412,7 @@ Note that since you now use the mouse for picking, you can no longer use it to r
 </p>
 
 </div>
-<!-- EDIT9 SECTION "Picking Action Using Mouse Pointer" [12849-14285] -->
+<!-- EDIT9 SECTION "Picking Action Using Mouse Pointer" [13427-14863] -->
 <h2><a>Exercises</a></h2>
 <div>
 
@@ -405,7 +423,7 @@ Modify the code sample to solve these exercises:
 </p>
 
 </div>
-<!-- EDIT10 SECTION "Exercises" [14286-14457] -->
+<!-- EDIT10 SECTION "Exercises" [14864-15035] -->
 <h3><a>Exercise 1: Magic Spell</a></h3>
 <div>
 
@@ -432,7 +450,7 @@ Here are some tips:
 </ol>
 
 </div>
-<!-- EDIT11 SECTION "Exercise 1: Magic Spell" [14458-14990] -->
+<!-- EDIT11 SECTION "Exercise 1: Magic Spell" [15036-15568] -->
 <h3><a>Exercise 2: Shoot a Character</a></h3>
 <div>
 
@@ -448,7 +466,7 @@ Shooting boxes isn&#039;t very exciting ??? can you add code that loads and posi
 </ul>
 
 </div>
-<!-- EDIT12 SECTION "Exercise 2: Shoot a Character" [14991-15329] -->
+<!-- EDIT12 SECTION "Exercise 2: Shoot a Character" [15569-15907] -->
 <h3><a>Exercise 3: Pick up into Inventory</a></h3>
 <div>
 
@@ -482,7 +500,7 @@ Change the code as follows to simulate the player picking up objects into the in
 </p>
 
 </div>
-<!-- EDIT13 SECTION "Exercise 3: Pick up into Inventory" [15330-16463] -->
+<!-- EDIT13 SECTION "Exercise 3: Pick up into Inventory" [15908-17041] -->
 <h2><a>Conclusion</a></h2>
 <div>
 
@@ -533,5 +551,5 @@ See also:
 </span></div>
 
 </div>
-<!-- EDIT14 SECTION "Conclusion" [16464-] -->
+<!-- EDIT14 SECTION "Conclusion" [17042-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:beginner:hello_picking?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/beginner/hello_simpleapplication.html

@@ -56,7 +56,7 @@ If you have questions, read more about <a href="/com/jme3/gde/docs/sdk/project_c
 
 </div>
 <!-- EDIT2 SECTION "Create a Project" [727-1588] -->
-<h2><a>Write a SimpleApplication</a></h2>
+<h2><a>Extend SimpleApplication</a></h2>
 <div>
 
 <p>
@@ -85,7 +85,7 @@ The <acronym title="Software Development Kit">SDK</acronym> creates the file Hel
 </p>
 
 </div>
-<!-- EDIT3 SECTION "Write a SimpleApplication" [1589-2061] -->
+<!-- EDIT3 SECTION "Extend SimpleApplication" [1589-2060] -->
 <h2><a>Sample Code</a></h2>
 <div>
 
@@ -114,7 +114,7 @@ public class HelloJME3 extends SimpleApplication &#123;
 &nbsp;
     @Override
     public void simpleInitApp&#40;&#41; &#123;
-        Box b = new Box&#40;Vector3f.ZERO, 1, 1, 1&#41;; // create cube shape at the origin
+        Box b = new Box&#40;1, 1, 1&#41;; // create cube shape
         Geometry geom = new Geometry&#40;&quot;Box&quot;, b&#41;;  // create cube geometry from the shape
         Material mat = new Material&#40;assetManager,
           &quot;Common/MatDefs/Misc/Unshaded.j3md&quot;&#41;;  // create a simple material
@@ -143,7 +143,7 @@ Congratulations! Now let&#039;s find out how it works!
 </p>
 
 </div>
-<!-- EDIT4 SECTION "Sample Code" [2062-3976] -->
+<!-- EDIT4 SECTION "Sample Code" [2061-3946] -->
 <h2><a>Understanding the Code</a></h2>
 <div>
 
@@ -153,20 +153,20 @@ The code above has initialized the scene, and started the application.
 </p>
 
 </div>
-<!-- EDIT5 SECTION "Understanding the Code" [3977-4084] -->
+<!-- EDIT5 SECTION "Understanding the Code" [3947-4054] -->
 <h3><a>Start the SimpleApplication</a></h3>
 <div>
 
 <p>
 
-Look at the first line. The HelloJME3.java class extends <code>com.jme3.app.SimpleApplication</code>. 
+Look at the first line. Your HelloJME3.java class extends <code>com.jme3.app.SimpleApplication</code>. 
 </p>
 <pre>public class HelloJME3 extends SimpleApplication &#123;
   // your code...
 &#125;</pre>
 
 <p>
-Every JME3 game is an instance of <code>com.jme3.app.SimpleApplication</code>. The SimpleApplication class manages your 3D scene graph and automatically draws it to the screen ??? that is, in short, what a game engine does for you! 
+Every JME3 game is an instance of the <code>com.jme3.app.SimpleApplication</code> class. The SimpleApplication class is the simplest example of an application: It manages a 3D scene graph, checks for user input, updates the game state, and automatically draws the scene to the screen. These are the core features of a game engine. You extend this simple application and customize it to create your game.
 </p>
 
 <p>
@@ -184,11 +184,11 @@ You start every JME3 game from the main() method, as every standard Java applica
     &#125;</pre>
 
 <p>
-This code opens your application window. Let&#039;s learn how you put something into the window next.
+The <code>app.start();</code> line opens the application window. Let&#039;s learn how you put something into this window (the scene) next.
 </p>
 
 </div>
-<!-- EDIT6 SECTION "Start the SimpleApplication" [4085-5044] -->
+<!-- EDIT6 SECTION "Start the SimpleApplication" [4055-5215] -->
 <h3><a>Understanding the Terminology</a></h3>
 <div>
 <div><table>
@@ -211,14 +211,14 @@ This code opens your application window. Let&#039;s learn how you put something
 		<td>You want the cube to appear in the center.</td><td>I create the Box at the origin = at <code>Vector3f.ZERO</code>.</td>
 	</tr>
 </table></div>
-<!-- EDIT8 TABLE [5086-5559] -->
+<!-- EDIT8 TABLE [5257-5730] -->
 <p>
 
 If you are unfamiliar with the vocabulary, read more about <a href="/com/jme3/gde/docs/jme3/the_scene_graph.html">the Scene Graph</a> here.
 </p>
 
 </div>
-<!-- EDIT7 SECTION "Understanding the Terminology" [5045-5652] -->
+<!-- EDIT7 SECTION "Understanding the Terminology" [5216-5823] -->
 <h3><a>Initialize the Scene</a></h3>
 <div>
 
@@ -234,7 +234,7 @@ Look at rest of the code sample. The <code>simpleInitApp()</code> method is auto
 The initialization code of a blue cube looks as follows:
 </p>
 <pre>    public void simpleInitApp&#40;&#41; &#123;
-        Box b = new Box&#40;Vector3f.ZERO, 1, 1, 1&#41;; // create a 1x1x1 box shape at the origin
+        Box b = new Box&#40;1, 1, 1&#41;; // create a 1x1x1 box shape
         Geometry geom = new Geometry&#40;&quot;Box&quot;, b&#41;;  // create a cube geometry from the box shape
         Material mat = new Material&#40;assetManager,
           &quot;Common/MatDefs/Misc/Unshaded.j3md&quot;&#41;;  // create a simple material
@@ -288,7 +288,7 @@ A typical JME3 game has the following initialization process:
 </ol>
 
 </div>
-<!-- EDIT9 SECTION "Initialize the Scene" [5653-7652] -->
+<!-- EDIT9 SECTION "Initialize the Scene" [5824-7794] -->
 <h2><a>Conclusion</a></h2>
 <div>
 
@@ -349,5 +349,5 @@ See also:
 </span></div>
 
 </div>
-<!-- EDIT10 SECTION "Conclusion" [7653-] -->
+<!-- EDIT10 SECTION "Conclusion" [7795-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:beginner:hello_simpleapplication?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/build_jme3_sources_with_netbeans.html

@@ -4,7 +4,7 @@
 
 <p>
 
-You are welcome to try out the new jME3, and contribute patches and features! This document shows how to download, set up, build, and run the latest development version from the sources. (As of Spring 2010, we are in alpha.) These instructions work in NetBeans IDE 6 or better.
+You are welcome to try out the new jME3, and contribute patches and features! This document shows how to download, set up, build, and run the latest development version from the sources. These instructions work in NetBeans IDE 6 or better.
 </p>
 
 <p>
@@ -12,7 +12,7 @@ Note: In the following, always replace &quot;~&quot; with the path to your home
 </p>
 
 </div>
-<!-- EDIT1 SECTION "Setting up JME3 in Netbeans 6+" [1-407] -->
+<!-- EDIT1 SECTION "Setting up JME3 in Netbeans 6+" [1-369] -->
 <h2><a>Downloading the Sources</a></h2>
 <div>
 
@@ -51,59 +51,85 @@ The jme3 project opens in the Project window. It already includes a working ANT
 
 <p>
 Look into the Libraries node and confirm that the project depends on the following libraries in the classpath:
+
 </p>
-<pre>jME3-natives-joal.jar	lwjgl.jar       gluegen-rt.jar
-jME3-lwjgl-natives.jar	jinput.jar	swing-layout-1.0.4.jar
-j-ogg-oggd.jar	        vecmath.jar     stack-alloc.jar
-j-ogg-vorbisd.jar       asm-all-3.1.jar jbullet.jar	         
-jheora-jst-debug-0.6.0.jar              xmlpull.xpp3-1.1.4c.jar
-nifty*.jar                              eventbus-1.4.jar</pre>
+<ul>
+<li><div> j-ogg-oggd.jar        </div>
+</li>
+<li><div> j-ogg-vorbisd.jar       </div>
+</li>
+<li><div> jbullet.jar	         </div>
+</li>
+<li><div> stack-alloc.jar</div>
+</li>
+<li><div> vecmath.jar     </div>
+</li>
+<li><div> lwjgl.jar       </div>
+</li>
+<li><div> jME3-lwjgl-natives.jar	</div>
+</li>
+<li><div> jinput.jar	</div>
+</li>
+<li><div> eventbus.jar</div>
+</li>
+<li><div> nifty-default-controls.jar                              </div>
+</li>
+<li><div> nifty-examples.jar                              </div>
+</li>
+<li><div> nifty-style-black.jar                              </div>
+</li>
+<li><div> nifty.jar</div>
+</li>
+<li><div> jglfont-core.jar                              </div>
+</li>
+<li><div> xmlpull-xpp3.jar</div>
+</li>
+<li><div> android.jar</div>
+</li>
+<li><div> jME3-bullet-natives.jar</div>
+</li>
+<li><div> gluegen-rt.jar</div>
+</li>
+<li><div> joal.jar</div>
+</li>
+<li><div> jogl-all.jar</div>
+</li>
+<li><div> jME3-natives-joal.jar</div>
+</li>
+<li><div> jME3-openal-soft-natives-android.jar</div>
+</li>
+</ul>
 
 <p>
+
 For a detailed description of the separate jar files see <a href="/com/jme3/gde/docs/jme3/jme3_source_structure#structure_of_jmonkeyengine3_jars.html">this list</a>.
 </p>
 
 </div>
-<!-- EDIT2 SECTION "Downloading the Sources" [408-1785] -->
-<h2><a>Build and Run</a></h2>
+<!-- EDIT2 SECTION "Downloading the Sources" [370-2005] -->
+<h2><a>Build the Project and Run a Sample App</a></h2>
 <div>
-
-<p>
-
-That&#039;s it!
-</p>
 <ol>
 <li><div> Right-click the jme3 project node and &quot;Clean and Build&quot; the project.</div>
 </li>
-<li><div> In the Projects window, browse to the <code>src/test/jme3test</code> folder. </div>
+<li><div> In the Projects window, open the <code>Test</code> folder which contains the sample apps.</div>
+</li>
+<li><div> Every file with a Main class (for example <code>jme3test.model/TestHoverTank.java</code> or <code>jme3test.game/CubeField.java</code>) is an app.</div>
 </li>
-<li><div> Right-click e.g. the file <code>src/test/jme3test/model/TestHoverTank.java</code> and choose &quot;Run&quot; to run a sample. </div>
+<li><div> Right-click a sample app and choose &quot;Run File&quot; (Shift-F6).</div>
+</li>
+<li><div> Generally in sample apps:</div>
 <ol>
-<li><div> In the sample application, use the mouse and the AWSD keys to move around the test object.</div>
+<li><div> the mouse and the WASD keys control movement</div>
 </li>
-<li><div> Press escape to quit the sample application.</div>
+<li><div> the Esc key exits the application</div>
 </li>
 </ol>
 </li>
 </ol>
 
-<p>
-
-Sample code for cool features is in the <code>src/test/jme3test</code> folder. A sample game can be found in <code>src/games/jme3game/cubefield/CubeField.java</code>.
-</p>
-
-<p>
-Tips:
-</p>
-<ul>
-<li><div> To run runnable classes from the Projects window, right-click and choose Run.</div>
-</li>
-<li><div> To run any runnable class that is open in the editor, press shift-F6.</div>
-</li>
-</ul>
-
 </div>
-<!-- EDIT3 SECTION "Build and Run" [1786-2545] -->
+<!-- EDIT3 SECTION "Build the Project and Run a Sample App" [2006-2531] -->
 <h2><a>Optional: Javadoc Popups and Source Navigation in NetBeans</a></h2>
 <div>
 
@@ -159,5 +185,5 @@ Sources used: <object classid="java:org.netbeans.modules.javahelp.BrowserDisplay
 </span></div>
 
 </div>
-<!-- EDIT4 SECTION "Optional: Javadoc Popups and Source Navigation in NetBeans" [2546-] -->
+<!-- EDIT4 SECTION "Optional: Javadoc Popups and Source Navigation in NetBeans" [2532-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:build_jme3_sources_with_netbeans?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/external/blender.html

@@ -282,8 +282,54 @@ Models for live rendering should have a low polygon count. To increase the perce
 </div></p>
 </p>
 
+<p>
+<p><div>Be careful: The steps above lead to terrible normal maps - use this procedure instead:
+</div></p>
+</p>
+<ul>
+<li><div> uncheck &quot;[ ] Bake from Multires&quot;</div>
+</li>
+<li><div> switch to object mode</div>
+</li>
+<li><div> make a copy of your mesh (SHIFT+D)</div>
+</li>
+<li><div> remove the Multires modifier from the copied model</div>
+</li>
+<li><div> remove any materials from the copied model</div>
+</li>
+<li><div> remove the armature modifier from the copied model</div>
+</li>
+<li><div> select the original (highres) model</div>
+</li>
+<li><div> go into pose mode, clear any pose transformations</div>
+</li>
+<li><div> the highres and lowres models should be on top of each other now</div>
+</li>
+<li><div> select the original (highres) model</div>
+</li>
+<li><div> hold SHIFT and select the copied (lowres) model</div>
+</li>
+<li><div> in the properties menu go to render</div>
+</li>
+<li><div> use Bake &gt; Normal</div>
+</li>
+<li><div> check &quot;[x] Selected to Active&quot;</div>
+</li>
+<li><div> use a reasonably high value for &quot;Margin&quot; (4+ pixels at least for 1024x1024 maps)</div>
+</li>
+<li><div> don&#039;t forget to safe the normal map image</div>
+</li>
+</ul>
+
+<p>
+
+<p><div>Be careful: in the Outliner the camera symbol (Restrict Render) must be on!
+</div></p>
+
+</p>
+
 </div>
-<!-- EDIT8 SECTION "Blender modeling lowPoly & highPoly" [7640-8762] -->
+<!-- EDIT8 SECTION "Blender modeling lowPoly & highPoly" [7640-9694] -->
 <h3><a>Fixing the normal colors in Blender</a></h3>
 <div>
 
@@ -328,7 +374,7 @@ To do this, go to the Blender Node Window
 </ul>
 
 </div>
-<!-- EDIT9 SECTION "Fixing the normal colors in Blender" [8763-9572] -->
+<!-- EDIT9 SECTION "Fixing the normal colors in Blender" [9695-10504] -->
 <h2><a>LightMap baking</a></h2>
 <div>
 
@@ -338,7 +384,7 @@ The goal of this tutorial is to explain briefly how to bake light map in blender
 </p>
 
 </div>
-<!-- EDIT10 SECTION "LightMap baking" [9573-9774] -->
+<!-- EDIT10 SECTION "LightMap baking" [10505-10706] -->
 <h3><a>Blender modeling + texturing</a></h3>
 <div>
 <ul>
@@ -387,7 +433,7 @@ The goal of this tutorial is to explain briefly how to bake light map in blender
 </ul>
 
 </div>
-<!-- EDIT11 SECTION "Blender modeling + texturing" [9775-10909] -->
+<!-- EDIT11 SECTION "Blender modeling + texturing" [10707-11841] -->
 <h3><a>Importing the model in the SDK and creating the appropriate material</a></h3>
 <div>
 
@@ -424,7 +470,27 @@ The blend file, the ogre xml files and the textures can be found in the download
 </p>
 
 </div>
-<!-- EDIT12 SECTION "Importing the model in the SDK and creating the appropriate material" [10910-11654] -->
+<!-- EDIT12 SECTION "Importing the model in the SDK and creating the appropriate material" [11842-12586] -->
+<h2><a>Modelling racing tracks and cars</a></h2>
+<div>
+
+<p>
+Follow the link below to a pdf tutorial by rhymez where I guide you to modelling a car and importing it to the jMonkeyengine correctly and edit it in the vehicle editor.Plus how to model a simple racing track.
+<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://www.indiedb.com/games/street-rally-3d/downloads/modelling-in-blender-to-the-jmonkeyengine"><param name="text" value="<html><u>http://www.indiedb.com/games/street-rally-3d/downloads/modelling-in-blender-to-the-jmonkeyengine</u></html>"><param name="textColor" value="blue"></object>
+</p>
+
+</div>
+<!-- EDIT13 SECTION "Modelling racing tracks and cars" [12587-12943] -->
+<h2><a>Optimizing Models for 3D games</a></h2>
+<div>
+
+<p>
+Follow the link below to a pdf tutorial by rhymez where I guide you on how you can optimize your models for faster rendering.
+<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://www.indiedb.com/games/street-rally-3d/downloads/optimizing-3d-models-for-games"><param name="text" value="<html><u>http://www.indiedb.com/games/street-rally-3d/downloads/optimizing-3d-models-for-games</u></html>"><param name="textColor" value="blue"></object>
+</p>
+
+</div>
+<!-- EDIT14 SECTION "Optimizing Models for 3D games" [12944-13203] -->
 <h2><a>SkyBox baking</a></h2>
 <div>
 
@@ -548,10 +614,12 @@ If you want to do it from code, here is an example:
 </p>
 
 </div>
-<!-- EDIT13 SECTION "SkyBox baking" [11655-16338] -->
+<!-- EDIT15 SECTION "SkyBox baking" [13204-17887] -->
 <h3><a>Further reading</a></h3>
 <div>
 <ul>
+<li><div> <a href="/com/jme3/gde/docs/jme3/external/blender-example.html">Warg - from cube to animated and textured game model Example</a></div>
+</li>
 <li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://jmonkeyengine.org/wiki/doku.php/jme3:advanced:sky"><param name="text" value="<html><u>http://jmonkeyengine.org/wiki/doku.php/jme3:advanced:sky</u></html>"><param name="textColor" value="blue"></object></div>
 </li>
 <li><div> <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://jmonkeyengine.org/groups/contribution-depot-jme3/forum/topic/jmonkeyengine-tutorial-how-to-create-skymaps-using-blender/"><param name="text" value="<html><u>http://jmonkeyengine.org/groups/contribution-depot-jme3/forum/topic/jmonkeyengine-tutorial-how-to-create-skymaps-using-blender/</u></html>"><param name="textColor" value="blue"></object></div>
@@ -559,5 +627,5 @@ If you want to do it from code, here is an example:
 </ul>
 
 </div>
-<!-- EDIT14 SECTION "Further reading" [16339-] -->
+<!-- EDIT16 SECTION "Further reading" [17888-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:external:blender?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/faq.html

@@ -43,14 +43,14 @@ Yes! Actually, you MUST customize it! For your own games, you always create a cu
 <div>
 
 <p>
-You should break app your application logic into components by spreading it out over individual AppStates. AppStates can be attached to and detached from the game. AppStates have access to all objects (rootNode, PhysicsSpace, inputManager, etc) and methods in your main application. So each AppState can bring its own subset of input handlers, <acronym title="Graphical User Interface">GUI</acronym> nodes, spatial nodes, and even its own subset of game mechanics in the update() loop.
+You should break down your application logic into components by spreading it out over individual AppStates. AppStates can be attached to and detached from the game. AppStates have access to all objects (rootNode, PhysicsSpace, inputManager, etc) and methods in your main application. So each AppState can bring its own subset of input handlers, <acronym title="Graphical User Interface">GUI</acronym> nodes, spatial nodes, and even its own subset of game mechanics in the update() loop.
 <br/>
 <strong>Learn more:</strong> <a href="/com/jme3/gde/docs/jme3/advanced/application_states.html">Application States</a>.
 
 </p>
 
 </div>
-<!-- EDIT6 SECTION "How can I switch between screens or states?" [1260-1804] -->
+<!-- EDIT6 SECTION "How can I switch between screens or states?" [1260-1805] -->
 <h3><a>How do I pause/unpause a game?</a></h3>
 <div>
 
@@ -62,7 +62,7 @@ You split up your application into several AppStates and implement the setEnable
 </p>
 
 </div>
-<!-- EDIT7 SECTION "How do I pause/unpause a game?" [1805-2410] -->
+<!-- EDIT7 SECTION "How do I pause/unpause a game?" [1806-2411] -->
 <h3><a>How do I disable logger output to the console?</a></h3>
 <div>
 
@@ -86,19 +86,19 @@ For the release, switch the severity level of the default logger to print only S
 </p>
 
 </div>
-<!-- EDIT8 SECTION "How do I disable logger output to the console?" [2411-2897] -->
+<!-- EDIT8 SECTION "How do I disable logger output to the console?" [2412-2898] -->
 <h3><a>Why does the executable crash with &quot;Cannot locate resource&quot;?</a></h3>
 <div>
 
 <p>
-Make sure to only load() models converted to .j3o binary format, not the original Ogre or Wavefront formats. If you load assets from zip files, make sure to ammend the build script to copy them ito the build.
+Make sure to only load() models converted to .j3o binary format, not the original Ogre or Wavefront formats. If you load assets from zip files, make sure to ammend the build script to copy them to the build directory.
 <br/>
 <strong>Learn more:</strong> <a href="/com/jme3/gde/docs/jme3/advanced/asset_manager.html">Asset Manager</a>
 
 </p>
 
 </div>
-<!-- EDIT9 SECTION "Why does the executable crash with Cannot locate resource?" [2898-3228] -->
+<!-- EDIT9 SECTION "Why does the executable crash with Cannot locate resource?" [2899-3238] -->
 <h3><a>What is java.lang.LinkageError: Version mismatch?</a></h3>
 <div>
 
@@ -110,12 +110,12 @@ To fix this, search for .dll (Windows), .jnilib (Mac), and .so (Linux) files for
 </p>
 
 </div>
-<!-- EDIT10 SECTION "What is java.lang.LinkageError: Version mismatch?" [3229-4612] -->
+<!-- EDIT10 SECTION "What is java.lang.LinkageError: Version mismatch?" [3239-4622] -->
 <h2><a>I want to load my scene</a></h2>
 <div>
 
 </div>
-<!-- EDIT11 SECTION "I want to load my scene" [4613-4648] -->
+<!-- EDIT11 SECTION "I want to load my scene" [4623-4658] -->
 <h3><a>How do I make objects appear / disappear in the 3D scene?</a></h3>
 <div>
 
@@ -132,7 +132,7 @@ To make a spatial appear in the scene, you attach it to the rootNode (or to a no
 </p>
 
 </div>
-<!-- EDIT12 SECTION "How do I make objects appear / disappear in the 3D scene?" [4649-5425] -->
+<!-- EDIT12 SECTION "How do I make objects appear / disappear in the 3D scene?" [4659-5435] -->
 <h3><a>Why do I get AssetNotFoundException when loading X ?</a></h3>
 <div>
 
@@ -159,7 +159,7 @@ Note that you should not register every single folder containing a texture as th
 </p>
 
 </div>
-<!-- EDIT13 SECTION "Why do I get AssetNotFoundException when loading X ?" [5426-6474] -->
+<!-- EDIT13 SECTION "Why do I get AssetNotFoundException when loading X ?" [5436-6484] -->
 <h3><a>How do I Create 3-D models, textures, sounds?</a></h3>
 <div>
 
@@ -175,7 +175,7 @@ You create sounds in an audio editor, for example, Audacity, and export them as
 </p>
 
 </div>
-<!-- EDIT14 SECTION "How do I Create 3-D models, textures, sounds?" [6475-7472] -->
+<!-- EDIT14 SECTION "How do I Create 3-D models, textures, sounds?" [6485-7482] -->
 <h3><a>How do I load a 3-D model into the scene?</a></h3>
 <div>
 
@@ -195,7 +195,7 @@ Spatial ninja = assetManager.loadModel&#40;&quot;Models/Ninja/Ninja.j3o&quot;&#4
 </p>
 
 </div>
-<!-- EDIT15 SECTION "How do I load a 3-D model into the scene?" [7473-8678] -->
+<!-- EDIT15 SECTION "How do I load a 3-D model into the scene?" [7483-8688] -->
 <h3><a>How do initialize the scene?</a></h3>
 <div>
 
@@ -206,12 +206,12 @@ Use the simpleInitApp() method in SimpleApplication (or initApp() in Application
 </p>
 
 </div>
-<!-- EDIT16 SECTION "How do initialize the scene?" [8679-9011] -->
+<!-- EDIT16 SECTION "How do initialize the scene?" [8689-9021] -->
 <h2><a>I want to transform objects in the scene</a></h2>
 <div>
 
 </div>
-<!-- EDIT17 SECTION "I want to transform objects in the scene" [9012-9064] -->
+<!-- EDIT17 SECTION "I want to transform objects in the scene" [9022-9074] -->
 <h3><a>How do I move or turn or resize a spatial?</a></h3>
 <div>
 
@@ -227,7 +227,7 @@ To move or turn or resize a spatial you use transformations. You can concatenate
 </p>
 
 </div>
-<!-- EDIT18 SECTION "How do I move or turn or resize a spatial?" [9065-9646] -->
+<!-- EDIT18 SECTION "How do I move or turn or resize a spatial?" [9075-9656] -->
 <h3><a>How do I make a spatial move by itself?</a></h3>
 <div>
 
@@ -240,7 +240,7 @@ Change the geometry&#039;s translation (position) live in the update loop using
 </p>
 
 </div>
-<!-- EDIT19 SECTION "How do I make a spatial move by itself?" [9647-10510] -->
+<!-- EDIT19 SECTION "How do I make a spatial move by itself?" [9657-10520] -->
 <h3><a>How do I access a named sub-mesh in Model?</a></h3>
 <div>
 <pre>Geometry result = spatial.getName&#40;&#41;.startsWith&#40;name&#41;;</pre>
@@ -251,7 +251,7 @@ Change the geometry&#039;s translation (position) live in the update loop using
 </p>
 
 </div>
-<!-- EDIT20 SECTION "How do I access a named sub-mesh in Model?" [10511-10678] -->
+<!-- EDIT20 SECTION "How do I access a named sub-mesh in Model?" [10521-10688] -->
 <h3><a>How do I make procedural or custom shapes?</a></h3>
 <div>
 
@@ -262,12 +262,12 @@ You can programmatically create com.jme3.scene.Mesh&#039;es.
 </p>
 
 </div>
-<!-- EDIT21 SECTION "How do I make procedural or custom shapes?" [10679-10839] -->
+<!-- EDIT21 SECTION "How do I make procedural or custom shapes?" [10689-10849] -->
 <h2><a>I want to change the surface of objects in the scene</a></h2>
 <div>
 
 </div>
-<!-- EDIT22 SECTION "I want to change the surface of objects in the scene" [10840-10904] -->
+<!-- EDIT22 SECTION "I want to change the surface of objects in the scene" [10850-10914] -->
 <h3><a>Why is my UV wrapping / texture appearance all wrong?</a></h3>
 <div>
 
@@ -285,7 +285,7 @@ You can set the boolean value in the constructor of TextureKey to flipped or not
 <pre>  material.setTexture&#40;&quot;ColorMap&quot;, this.assetManager.loadTexture&#40;new TextureKey&#40;&quot;myTexture.jpg&quot;, false&#41;&#41;&#41;;</pre>
 
 </div>
-<!-- EDIT23 SECTION "Why is my UV wrapping / texture appearance all wrong?" [10905-11454] -->
+<!-- EDIT23 SECTION "Why is my UV wrapping / texture appearance all wrong?" [10915-11464] -->
 <h3><a>How do I scale, mirror, or wrap a texture?</a></h3>
 <div>
 
@@ -303,7 +303,7 @@ You can choose among various <code>com.jme3.texture.Texture.WrapMode</code>s for
 <pre>material.getTextureParam&#40;&quot;DiffuseMap&quot;&#41;.getTextureValue&#40;&#41;.setWrap&#40;WrapMode.Repeat&#41;;</pre>
 
 </div>
-<!-- EDIT24 SECTION "How do I scale, mirror, or wrap a texture?" [11455-11996] -->
+<!-- EDIT24 SECTION "How do I scale, mirror, or wrap a texture?" [11465-12006] -->
 <h3><a>How do I change color or shininess of an material?</a></h3>
 <div>
 
@@ -316,7 +316,7 @@ Use the AssetManager to load Materials, and change material settings.
 </p>
 
 </div>
-<!-- EDIT25 SECTION "How do I change color or shininess of an material?" [11997-12584] -->
+<!-- EDIT25 SECTION "How do I change color or shininess of an material?" [12007-12594] -->
 <h3><a>How do I make a surface wood, stone, metal, etc?</a></h3>
 <div>
 
@@ -329,7 +329,7 @@ Create Textures as image files. Use the AssetManager to load a Material and use
 </p>
 
 </div>
-<!-- EDIT26 SECTION "How do I make a surface wood, stone, metal, etc?" [12585-13358] -->
+<!-- EDIT26 SECTION "How do I make a surface wood, stone, metal, etc?" [12595-13368] -->
 <h3><a>Why are materials too bright, too dark, or flickering?</a></h3>
 <div>
 
@@ -338,7 +338,7 @@ If you use a lit material (based on Lighting.j3md) then you must attach a light
 </p>
 
 </div>
-<!-- EDIT27 SECTION "Why are materials too bright, too dark, or flickering?" [13359-14172] -->
+<!-- EDIT27 SECTION "Why are materials too bright, too dark, or flickering?" [13369-14182] -->
 <h3><a>How do I make geometries cast a shadow?</a></h3>
 <div>
 
@@ -351,7 +351,7 @@ Use com.jme3.shadow.BasicShadowRenderer together with com.jme3.light.Directional
 </p>
 
 </div>
-<!-- EDIT28 SECTION "How do I make geometries cast a shadow?" [14173-14681] -->
+<!-- EDIT28 SECTION "How do I make geometries cast a shadow?" [14183-14691] -->
 <h3><a>How do I make materials transparent?</a></h3>
 <div>
 
@@ -367,7 +367,7 @@ Assign a texture with an alpha channel to a Material and set the Material&#039;s
 </p>
 
 </div>
-<!-- EDIT29 SECTION "How do I make materials transparent?" [14682-15118] -->
+<!-- EDIT29 SECTION "How do I make materials transparent?" [14692-15128] -->
 <h3><a>How do I force or disable culling?</a></h3>
 <div>
 
@@ -391,7 +391,7 @@ You can also deactivate the <code>com.jme3.scene.Spatial.CullHint</code> of a wh
 </p>
 
 </div>
-<!-- EDIT30 SECTION "How do I force or disable culling?" [15119-15667] -->
+<!-- EDIT30 SECTION "How do I force or disable culling?" [15129-15677] -->
 <h3><a>Can I draw only an outline of the scene?</a></h3>
 <div>
 
@@ -407,12 +407,12 @@ Add a renders state to the material&#039;s and activate <code>Wireframe</code>.
 </p>
 
 </div>
-<!-- EDIT31 SECTION "Can I draw only an outline of the scene?" [15668-15904] -->
+<!-- EDIT31 SECTION "Can I draw only an outline of the scene?" [15678-15914] -->
 <h2><a>I want to control the camera</a></h2>
 <div>
 
 </div>
-<!-- EDIT32 SECTION "I want to control the camera" [15905-15945] -->
+<!-- EDIT32 SECTION "I want to control the camera" [15915-15955] -->
 <h3><a>How do I switch between third-person and first-person view ?</a></h3>
 <div>
 
@@ -434,18 +434,18 @@ chaseCam = new ChaseCamera&#40;cam, spatial, inputManager&#41;;</pre>
 </ul>
 
 </div>
-<!-- EDIT33 SECTION "How do I switch between third-person and first-person view ?" [15946-17002] -->
+<!-- EDIT33 SECTION "How do I switch between third-person and first-person view ?" [15956-17012] -->
 <h3><a>How do I increase camera speed?</a></h3>
 <div>
 <pre>flyCam.setMoveSpeed&#40;50f&#41;;</pre>
 
 </div>
-<!-- EDIT34 SECTION "How do I increase camera speed?" [17003-17089] -->
+<!-- EDIT34 SECTION "How do I increase camera speed?" [17013-17099] -->
 <h2><a>Actions, Interactions, Physics</a></h2>
 <div>
 
 </div>
-<!-- EDIT35 SECTION "Actions, Interactions, Physics" [17090-17132] -->
+<!-- EDIT35 SECTION "Actions, Interactions, Physics" [17100-17142] -->
 <h3><a>How do I implement game logic / game mechanics?</a></h3>
 <div>
 
@@ -456,7 +456,7 @@ Use Controls to define the behaviour of types of Spatials. Use Application State
 </p>
 
 </div>
-<!-- EDIT36 SECTION "How do I implement game logic / game mechanics?" [17133-17694] -->
+<!-- EDIT36 SECTION "How do I implement game logic / game mechanics?" [17143-17704] -->
 <h3><a>How do I let players interact via keyboard?</a></h3>
 <div>
 
@@ -467,7 +467,7 @@ Use com.jme3.input.KeyInput and a Input Listener.
 </p>
 
 </div>
-<!-- EDIT37 SECTION "How do I let players interact via keyboard?" [17695-17902] -->
+<!-- EDIT37 SECTION "How do I let players interact via keyboard?" [17705-17912] -->
 <h3><a>How do I let players interact by clicking?</a></h3>
 <div>
 
@@ -480,7 +480,7 @@ Players typically click the mouse to pick up objects, to open doors, to shoot a
 </p>
 
 </div>
-<!-- EDIT38 SECTION "How do I let players interact by clicking?" [17903-18727] -->
+<!-- EDIT38 SECTION "How do I let players interact by clicking?" [17913-18737] -->
 <h3><a>How do I animate characters?</a></h3>
 <div>
 
@@ -493,7 +493,7 @@ Create an animated OgreMesh model with bones in a 3-D mesh editor (e.g. Blender)
 </p>
 
 </div>
-<!-- EDIT39 SECTION "How do I animate characters?" [18728-19199] -->
+<!-- EDIT39 SECTION "How do I animate characters?" [18738-19209] -->
 <h3><a>How do I keep players from falling through walls and floors?</a></h3>
 <div>
 
@@ -504,7 +504,7 @@ Use collision detection. The most common solution is to use jme&#039;s physics i
 </p>
 
 </div>
-<!-- EDIT40 SECTION "How do I keep players from falling through walls and floors?" [19200-19562] -->
+<!-- EDIT40 SECTION "How do I keep players from falling through walls and floors?" [19210-19572] -->
 <h3><a>How do I make balls/wheels/etc bounce and roll?</a></h3>
 <div>
 
@@ -517,7 +517,7 @@ Add physics controls to Spatials and give them spherical or cylindrical bounding
 </p>
 
 </div>
-<!-- EDIT41 SECTION "How do I make balls/wheels/etc bounce and roll?" [19563-20160] -->
+<!-- EDIT41 SECTION "How do I make balls/wheels/etc bounce and roll?" [19573-20170] -->
 <h3><a>How do I debug weird Physics behaviour?</a></h3>
 <div>
 
@@ -527,12 +527,12 @@ Maybe your collision shapes overlap ??? or they are not where you think they are
 <pre>bulletAppState.getPhysicsSpace&#40;&#41;.enableDebug&#40;assetManager&#41;;</pre>
 
 </div>
-<!-- EDIT42 SECTION "How do I debug weird Physics behaviour?" [20161-20474] -->
+<!-- EDIT42 SECTION "How do I debug weird Physics behaviour?" [20171-20484] -->
 <h3><a>How do I make a walking character?</a></h3>
 <div>
 
 <p>
-You can use jBullet&#039;s CharacterControl that locks a physical object upright, so it does not tip over when moving/walking (as tall physical objects are wont to do).
+You can use jBullet&#039;s CharacterControl that locks a physical object upright, so it does not tip over when moving/walking (as tall physical objects are typically wanted to).
 <br/>
 <strong>Learn more:</strong> CharacterControl
 <br/>
@@ -540,7 +540,7 @@ Code samples: <object classid="java:org.netbeans.modules.javahelp.BrowserDisplay
 </p>
 
 </div>
-<!-- EDIT43 SECTION "How do I make a walking character?" [20475-21033] -->
+<!-- EDIT43 SECTION "How do I make a walking character?" [20485-21052] -->
 <h3><a>How do I steer vehicles?</a></h3>
 <div>
 
@@ -553,7 +553,7 @@ Code samples: <object classid="java:org.netbeans.modules.javahelp.BrowserDisplay
 </p>
 
 </div>
-<!-- EDIT44 SECTION "How do I steer vehicles?" [21034-21401] -->
+<!-- EDIT44 SECTION "How do I steer vehicles?" [21053-21420] -->
 <h3><a>Can objects swing like a pendulums, chains, ropebridges?</a></h3>
 <div>
 
@@ -565,12 +565,12 @@ Use a PhysicsControl&#039;s hinges and joints.
 </p>
 
 </div>
-<!-- EDIT45 SECTION "Can objects swing like a pendulums, chains, ropebridges?" [21402-21802] -->
+<!-- EDIT45 SECTION "Can objects swing like a pendulums, chains, ropebridges?" [21421-21821] -->
 <h2><a>Default GUI Display</a></h2>
 <div>
 
 </div>
-<!-- EDIT46 SECTION "Default GUI Display" [21803-21834] -->
+<!-- EDIT46 SECTION "Default GUI Display" [21822-21853] -->
 <h3><a>What are these FPS/Objects/Vertices/Triangles statistics?</a></h3>
 <div>
 
@@ -582,7 +582,7 @@ At the bottom left of every default SimpleGame, you see the <a href="/com/jme3/g
 </p>
 
 </div>
-<!-- EDIT47 SECTION "What are these FPS/Objects/Vertices/Triangles statistics?" [21835-22362] -->
+<!-- EDIT47 SECTION "What are these FPS/Objects/Vertices/Triangles statistics?" [21854-22381] -->
 <h3><a>How do I get rid of the FPS/Objects statistics?</a></h3>
 <div>
 
@@ -601,7 +601,7 @@ setDisplayStatView(false); // to hide the statistics </pre>
 </p>
 
 </div>
-<!-- EDIT48 SECTION "How do I get rid of the FPS/Objects statistics?" [22363-22627] -->
+<!-- EDIT48 SECTION "How do I get rid of the FPS/Objects statistics?" [22382-22646] -->
 <h3><a>How do I display score, health, mini-maps, status icons?</a></h3>
 <div>
 
@@ -614,7 +614,7 @@ Attach text and pictures to the orthogonal <code>guiNode</code> to create a head
 </p>
 
 </div>
-<!-- EDIT49 SECTION "How do I display score, health, mini-maps, status icons?" [22628-23220] -->
+<!-- EDIT49 SECTION "How do I display score, health, mini-maps, status icons?" [22647-23239] -->
 <h3><a>How do I display buttons and UI controls?</a></h3>
 <div>
 
@@ -627,7 +627,7 @@ Sample Code: <object classid="java:org.netbeans.modules.javahelp.BrowserDisplaye
 </p>
 
 </div>
-<!-- EDIT50 SECTION "How do I display buttons and UI controls?" [23221-23665] -->
+<!-- EDIT50 SECTION "How do I display buttons and UI controls?" [23240-23684] -->
 <h3><a>How do i display a loading screen?</a></h3>
 <div>
 
@@ -638,12 +638,12 @@ Instead of having a frozen frame while your games loads, you can have a loading
 </p>
 
 </div>
-<!-- EDIT51 SECTION "How do i display a loading screen?" [23666-23882] -->
+<!-- EDIT51 SECTION "How do i display a loading screen?" [23685-23901] -->
 <h2><a>Nifty GUI</a></h2>
 <div>
 
 </div>
-<!-- EDIT52 SECTION "Nifty GUI" [23883-23904] -->
+<!-- EDIT52 SECTION "Nifty GUI" [23902-23923] -->
 <h3><a>I get NoSuchElementException when adding controls (buttons etc)!</a></h3>
 <div>
 
@@ -654,7 +654,7 @@ Verify that you include a controls definition file link in your <acronym title="
 <pre><span>&lt;useControls filename=&quot;nifty-default-controls.xml&quot;/&gt;</span></pre>
 
 </div>
-<!-- EDIT53 SECTION "I get NoSuchElementException when adding controls (buttons etc)!" [23905-24140] -->
+<!-- EDIT53 SECTION "I get NoSuchElementException when adding controls (buttons etc)!" [23924-24159] -->
 <h3><a>Where can I find example code of Nifty GUI&#039;s XML and Java classes?</a></h3>
 <div>
 
@@ -663,7 +663,7 @@ Verify that you include a controls definition file link in your <acronym title="
 </p>
 
 </div>
-<!-- EDIT54 SECTION "Where can I find example code of Nifty GUI's XML and Java classes?" [24141-24303] -->
+<!-- EDIT54 SECTION "Where can I find example code of Nifty GUI's XML and Java classes?" [24160-24322] -->
 <h3><a>Is there Java Doc for Nifty GUI?</a></h3>
 <div>
 
@@ -672,12 +672,12 @@ Verify that you include a controls definition file link in your <acronym title="
 </p>
 
 </div>
-<!-- EDIT55 SECTION "Is there Java Doc for Nifty GUI?" [24304-24429] -->
+<!-- EDIT55 SECTION "Is there Java Doc for Nifty GUI?" [24323-24448] -->
 <h2><a>I want to create an environment with sounds, effects, and landscapes</a></h2>
 <div>
 
 </div>
-<!-- EDIT56 SECTION "I want to create an environment with sounds, effects, and landscapes" [24430-24510] -->
+<!-- EDIT56 SECTION "I want to create an environment with sounds, effects, and landscapes" [24449-24529] -->
 <h3><a>How do I play sounds and noises?</a></h3>
 <div>
 
@@ -690,7 +690,7 @@ Use AudioRenderer, Listener, and AudioNode from com.jme3.audio.*.
 </p>
 
 </div>
-<!-- EDIT57 SECTION "How do I play sounds and noises?" [24511-24814] -->
+<!-- EDIT57 SECTION "How do I play sounds and noises?" [24530-24833] -->
 <h3><a>How do I make fire, smoke, explosions, swarms, magic spells?</a></h3>
 <div>
 
@@ -703,7 +703,7 @@ For swarm like effects you use particle emitters.
 </p>
 
 </div>
-<!-- EDIT58 SECTION "How do I make fire, smoke, explosions, swarms, magic spells?" [24815-25470] -->
+<!-- EDIT58 SECTION "How do I make fire, smoke, explosions, swarms, magic spells?" [24834-25489] -->
 <h3><a>How do I make water, waves, reflections?</a></h3>
 <div>
 
@@ -716,7 +716,7 @@ Use a special post-processor renderer from com.jme3.water.*.
 </p>
 
 </div>
-<!-- EDIT59 SECTION "How do I make water, waves, reflections?" [25471-26231] -->
+<!-- EDIT59 SECTION "How do I make water, waves, reflections?" [25490-26250] -->
 <h3><a>How do I make fog, bloom, blur, light scattering?</a></h3>
 <div>
 
@@ -727,7 +727,7 @@ Use special post-processor renderers from com.jme3.post.*.
 </p>
 
 </div>
-<!-- EDIT60 SECTION "How do I make fog, bloom, blur, light scattering?" [26232-26406] -->
+<!-- EDIT60 SECTION "How do I make fog, bloom, blur, light scattering?" [26251-26425] -->
 <h3><a>How do I generate a terrain?</a></h3>
 <div>
 
@@ -740,7 +740,7 @@ Use com.jme3.terrain.*. The JMonkeyEngine also provides you with a Terrain Edito
 </p>
 
 </div>
-<!-- EDIT61 SECTION "How do I generate a terrain?" [26407-26790] -->
+<!-- EDIT61 SECTION "How do I generate a terrain?" [26426-26809] -->
 <h3><a>How do I make a sky?</a></h3>
 <div>
 
@@ -758,12 +758,12 @@ skyGeo.setQueueBucket&#40;Bucket.Sky&#41; </pre>
 </p>
 
 </div>
-<!-- EDIT62 SECTION "How do I make a sky?" [26791-27170] -->
+<!-- EDIT62 SECTION "How do I make a sky?" [26810-27189] -->
 <h2><a>I want to access to back-end properties</a></h2>
 <div>
 
 </div>
-<!-- EDIT63 SECTION "I want to access to back-end properties" [27171-27222] -->
+<!-- EDIT63 SECTION "I want to access to back-end properties" [27190-27241] -->
 <h3><a>How do I read out graphic card capabilities?</a></h3>
 <div>
 
@@ -775,12 +775,12 @@ If your game is heavily using features that older cards do not support, you can
 Logger.getLogger&#40;HelloJME3.class.getName&#40;&#41;&#41;.log&#40;Level.INFO, &quot;Capabilities: {0}&quot;, caps.toString&#40;&#41;&#41;;</pre>
 
 </div>
-<!-- EDIT64 SECTION "How do I read out graphic card capabilities?" [27223-27658] -->
+<!-- EDIT64 SECTION "How do I read out graphic card capabilities?" [27242-27677] -->
 <h3><a>How do I Run jMonkeyEngine 3 with OpenGL1?</a></h3>
 <div>
 
 <p>
-In you game, add 
+In your game, add 
 </p>
 <pre>settings.setRenderer&#40;AppSettings.LWJGL_OPENGL1&#41;</pre>
 
@@ -792,7 +792,7 @@ For the jMonkeyEngine <acronym title="Software Development Kit">SDK</acronym> it
 </p>
 
 </div>
-<!-- EDIT65 SECTION "How do I Run jMonkeyEngine 3 with OpenGL1?" [27659-27938] -->
+<!-- EDIT65 SECTION "How do I Run jMonkeyEngine 3 with OpenGL1?" [27678-27958] -->
 <h3><a>How do I optimize the heck out of the Scene Graph?</a></h3>
 <div>
 
@@ -809,7 +809,7 @@ Batching means that all Geometries with the same Material are combined into one
 </p>
 
 </div>
-<!-- EDIT66 SECTION "How do I optimize the heck out of the Scene Graph?" [27939-28408] -->
+<!-- EDIT66 SECTION "How do I optimize the heck out of the Scene Graph?" [27959-28428] -->
 <h3><a>How do I prevent users from unzipping my JAR?</a></h3>
 <div>
 
@@ -819,12 +819,12 @@ Add an <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><pa
 </p>
 
 </div>
-<!-- EDIT67 SECTION "How do I prevent users from unzipping my JAR?" [28409-28658] -->
+<!-- EDIT67 SECTION "How do I prevent users from unzipping my JAR?" [28429-28678] -->
 <h2><a>I want to do maths</a></h2>
 <div>
 
 </div>
-<!-- EDIT68 SECTION "I want to do maths" [28659-28689] -->
+<!-- EDIT68 SECTION "I want to do maths" [28679-28709] -->
 <h3><a>What does addLocal() / multLocal() etc mean?</a></h3>
 <div>
 
@@ -877,7 +877,7 @@ Many maths functions (mult(), add(), subtract(), etc) come as local and a non-lo
 </ol>
 
 </div>
-<!-- EDIT69 SECTION "What does addLocal() / multLocal() etc mean?" [28690-30051] -->
+<!-- EDIT69 SECTION "What does addLocal() / multLocal() etc mean?" [28710-30071] -->
 <h3><a>What is the difference between World and Local coordinates?</a></h3>
 <div>
 
@@ -887,7 +887,7 @@ World coordinates of a Spatial are its absolute coordinates in the 3D scene (thi
 </p>
 
 </div>
-<!-- EDIT70 SECTION "What is the difference between World and Local coordinates?" [30052-30361] -->
+<!-- EDIT70 SECTION "What is the difference between World and Local coordinates?" [30072-30381] -->
 <h3><a>How do I convert Degrees to Radians?</a></h3>
 <div>
 
@@ -901,5 +901,5 @@ Multiply degree value by FastMath.DEG_TO_RAD to convert it to radians.
 </span></div>
 
 </div>
-<!-- EDIT71 SECTION "How do I convert Degrees to Radians?" [30362-] -->
+<!-- EDIT71 SECTION "How do I convert Degrees to Radians?" [30382-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:faq?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/intermediate/appsettings.html

@@ -8,7 +8,7 @@ Every class that extends jme3.app.SimpleApplication has properties that can be c
 </p>
 
 <p>
-<p><div>Configure application settings in <code>main()</code>, before you call <code>app.start()</code> on the application object. If you change display settings during runtime, for eyample in <code>simpleInitApp()</code>, you must call <code>app.restart()</code> to make them take effect.
+<p><div>Configure application settings in <code>main()</code>, before you call <code>app.start()</code> on the application object. If you change display settings during runtime, for example in <code>simpleInitApp()</code>, you must call <code>app.restart()</code> to make them take effect.
 </div></p>
 </p>
 
@@ -47,14 +47,14 @@ This example toggles the settings to fullscreen while the game is already runnin
   int i=0; // note: there are usually several, let's pick the first
   settings.setResolution&#40;modes&#91;i&#93;.getWidth&#40;&#41;,modes&#91;i&#93;.getHeight&#40;&#41;&#41;;
   settings.setFrequency&#40;modes&#91;i&#93;.getRefreshRate&#40;&#41;&#41;;
-  settings.setDepthBits&#40;modes&#91;i&#93;.getBitDepth&#40;&#41;&#41;;
+  settings.setBitsPerPixel&#40;modes&#91;i&#93;.getBitDepth&#40;&#41;&#41;;
   settings.setFullscreen&#40;device.isFullScreenSupported&#40;&#41;&#41;;
   app.setSettings&#40;settings&#41;;
   app.restart&#40;&#41;; // restart the context to apply changes
 &#125;</pre>
 
 </div>
-<!-- EDIT2 SECTION "Code Samples" [559-2059] -->
+<!-- EDIT2 SECTION "Code Samples" [559-2062] -->
 <h2><a>Properties</a></h2>
 <div>
 <div><table>
@@ -94,7 +94,7 @@ Set VSync to false to deactivate vertical syncing (faster, but possible page tea
 60 fps</td>
 	</tr>
 </table></div>
-<!-- EDIT4 TABLE [2084-4305] --><div><table>
+<!-- EDIT4 TABLE [2087-4308] --><div><table>
 	<tr>
 		<th>Settings Property (Input)</th><th>Description</th><th>Default</th>
 	</tr>
@@ -111,7 +111,7 @@ Set VSync to false to deactivate vertical syncing (faster, but possible page tea
 		<td>setEmulateMouseFlipAxis(true,true)</td><td>Flips the X or Y (or both) axes for the emulated mouse. Set the first parameter to true to flip the x axis, and the second to flip the y axis.</td><td>false,false</td>
 	</tr>
 </table></div>
-<!-- EDIT5 TABLE [4307-5021] --><div><table>
+<!-- EDIT5 TABLE [4310-5024] --><div><table>
 	<tr>
 		<th>Settings Property (Audio)</th><th>Description</th><th>Default</th>
 	</tr>
@@ -122,7 +122,7 @@ Set VSync to false to deactivate vertical syncing (faster, but possible page tea
 		<td>setStereo3D(true)</td><td>Enable 3D stereo. This feature requires hardware support from the GPU driver. See <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://en.wikipedia.org/wiki/Quad_buffering"><param name="text" value="<html><u>Quad Buffering</u></html>"><param name="textColor" value="blue"></object>. Currently, your everday user&#039;s hardware does not support this, so you can ignore it for now.</td><td>false</td>
 	</tr>
 </table></div>
-<!-- EDIT6 TABLE [5023-5447] --><div><table>
+<!-- EDIT6 TABLE [5026-5450] --><div><table>
 	<tr>
 		<th>Settings Property (Branding)</th><th>Description</th><th>Default</th>
 	</tr>
@@ -137,7 +137,7 @@ ImageIO.read(new File(&quot;&quot;)), ???});</td><td>This specifies the little a
 		<td>setSettingsDialogImage(&quot;Interface/mysplashscreen.png&quot;)</td><td>A custom splashscreen image in the <code>assets/Interface</code> directory which is displayed when the settings dialog is shown.</td><td>&quot;/com/jme3/app/Monkey.png&quot;</td>
 	</tr>
 </table></div>
-<!-- EDIT7 TABLE [5449-6156] -->
+<!-- EDIT7 TABLE [5452-6159] -->
 <p>
 
 <p><div>You can use <code>app.setShowSettings(true);</code> and <code>setSettingsDialogImage(&quot;Interface/mysplashscreen.png&quot;)</code> to present the user with jme3&#039;s default display settings dialog when starting the game. Use <code>app.setShowSettings(false);</code> to hide the default settings screen. Set this boolean before calling <code>app.start()</code> on the SimpleApplication.
@@ -145,7 +145,7 @@ ImageIO.read(new File(&quot;&quot;)), ???});</td><td>This specifies the little a
 </p>
 
 </div>
-<!-- EDIT3 SECTION "Properties" [2060-6516] -->
+<!-- EDIT3 SECTION "Properties" [2063-6519] -->
 <h2><a>Toggling and Activating Settings</a></h2>
 <div>
 <div><table>
@@ -165,9 +165,9 @@ ImageIO.read(new File(&quot;&quot;)), ???});</td><td>This specifies the little a
 		<td>app.restart()</td><td>Restart()ing a running game restarts the game context and applies the updated settings object. (This does not restart or reinitialize the whole game.)</td>
 	</tr>
 </table></div>
-<!-- EDIT9 TABLE [6563-7444] -->
+<!-- EDIT9 TABLE [6566-7447] -->
 </div>
-<!-- EDIT8 SECTION "Toggling and Activating Settings" [6517-7445] -->
+<!-- EDIT8 SECTION "Toggling and Activating Settings" [6520-7448] -->
 <h2><a>Saving and Loading Settings</a></h2>
 <div>
 
@@ -207,5 +207,5 @@ Provide the unique name of your jME3 application as the String argument. For exa
 </ul>
 
 </div>
-<!-- EDIT10 SECTION "Saving and Loading Settings" [7446-] -->
+<!-- EDIT10 SECTION "Saving and Loading Settings" [7449-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:intermediate:appsettings?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/intermediate/best_practices.html

@@ -158,7 +158,7 @@ Whether you work in a team or alone, keeping a version controlled repository of
 <ul>
 <li><div> Treat commit messages as messages to your future self. &quot;Made some changes&quot; is <em>not</em> a commit message.</div>
 </li>
-<li><div> The jMonkeyEngine <acronym title="Software Development Kit">SDK</acronym> supports Subversion, Mercurial, and <acronym title="Concurrent Versions System">CVS</acronym>. <br/>
+<li><div> The jMonkeyEngine <acronym title="Software Development Kit">SDK</acronym> supports Subversion, Mercurial, and Git. <br/>
 If you don&#039;t know which to choose, Subversion is a good choice for starters.</div>
 </li>
 <li><div> Set up your own local server, or get free remote hosting space from various open-source dev portals like <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://sourceforge.net/"><param name="text" value="<html><u>Sourceforge</u></html>"><param name="textColor" value="blue"></object>, <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="https://github.com/"><param name="text" value="<html><u>Github</u></html>"><param name="textColor" value="blue"></object>, <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="https://bitbucket.org/"><param name="text" value="<html><u>bitbucket</u></html>"><param name="textColor" value="blue"></object> (supports private projects), <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="http://home.java.net/create-project"><param name="text" value="<html><u>Java.net</u></html>"><param name="textColor" value="blue"></object>, <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param name="content" value="https://code.google.com"><param name="text" value="<html><u>Google Code</u></html>"><param name="textColor" value="blue"></object>???</div>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/intermediate/how_to_use_materials.html

@@ -294,7 +294,7 @@ To make a Geometry transparent or translucent:
 </div>
 </li>
 <li><div> Put the Geometry (not the Material!) in the appropriate render queue bucket. <br/>
-Objects in the translucent bucket (e.g. particles) are not affected by SceneProcessors (e.g. shadows). Obejcts in the transparent bucket (e.g. foliage) are affected by SceneProcessors (e.g. shadows).</div>
+Objects in the translucent bucket (e.g. particles) are not affected by SceneProcessors (e.g. shadows). Objects in the transparent bucket (e.g. foliage) are affected by SceneProcessors (e.g. shadows).</div>
 <ul>
 <li><div> <pre>geo.setQueueBucket&#40;Bucket.Translucent&#41;; </pre>
 </div>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/intermediate/math.html

@@ -109,7 +109,7 @@ float z = FastMath.sin(phi)*r;</td>
 </table></div>
 <!-- EDIT4 TABLE [1461-2555] -->
 </div>
-<!-- EDIT2 SECTION "Formulas" [32-2557] -->
+<!-- EDIT2 SECTION "Formulas" [32-2556] -->
 <h2><a>Local vs Non-local methods?</a></h2>
 <div>
 <ul>
@@ -122,5 +122,5 @@ float z = FastMath.sin(phi)*r;</td>
 </ul>
 
 </div>
-<!-- EDIT5 SECTION "Local vs Non-local methods?" [2558-] -->
+<!-- EDIT5 SECTION "Local vs Non-local methods?" [2557-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:intermediate:math?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/intermediate/multi-media_asset_pipeline.html

@@ -20,7 +20,7 @@ Assets are files that are not code. Your multi-media assets includes, for exampl
 		<th>DO</th><th>DON&#039;T</th>
 	</tr>
 	<tr>
-		<td> Save original models plus textures into <code>assets/Textures</code>. </td><td> Don&#039;t leave textures or models in a folder outside your JME project: The game cannot load or reference them from there. </td>
+		<td> Import original models plus textures into <code>assets/Textures</code>. </td><td> Don&#039;t leave textures or models in a folder outside your JME project: The game cannot load or reference them from there. </td>
 	</tr>
 	<tr>
 		<td> Save sounds into <code>assets/Sounds</code>. </td><td> Don&#039;t leave audio files in a folder outside your JME project: The game cannot load or reference them from there. </td>
@@ -41,14 +41,14 @@ Assets are files that are not code. Your multi-media assets includes, for exampl
 		<td>Agree on naming schemes and folder schemes with your artists early on to avoid confusion. E.g. keep naming schemes for bones and certain model parts. Try to keep your assets folder clean, its like your codes class structure.</td><td>Don&#039;t mindlessly import downloaded models and other assets into your project without keeping a structure and knowing the files work. You can reimport, delete junk.</td>
 	</tr>
 </table></div>
-<!-- EDIT2 TABLE [623-2089] -->
+<!-- EDIT2 TABLE [623-2091] -->
 <p>
 
 Read on for details.
 </p>
 
 </div>
-<!-- EDIT1 SECTION "Multi-Media Asset Pipeline" [1-2112] -->
+<!-- EDIT1 SECTION "Multi-Media Asset Pipeline" [1-2114] -->
 <h2><a>Use The Assets Folder</a></h2>
 <div>
 
@@ -59,7 +59,7 @@ Store your assets in subfolders of your project&#039;s <code>assets</code> direc
 <pre>jMonkeyProjects/MyGame/assets/Interface/ # .font, .jpg, .png, .xml
 jMonkeyProjects/MyGame/assets/MatDefs/   # .j3md
 jMonkeyProjects/MyGame/assets/Materials/ # .j3m
-jMonkeyProjects/MyGame/assets/Models/    # .j3o
+jMonkeyProjects/MyGame/assets/Models/    # .blend, .j3o
 jMonkeyProjects/MyGame/assets/Scenes/    # .j3o
 jMonkeyProjects/MyGame/assets/Shaders/   # .j3f, .vert, .frag
 jMonkeyProjects/MyGame/assets/Sounds/    # .ogg, .wav
@@ -105,7 +105,7 @@ See also:
 </ul>
 
 </div>
-<!-- EDIT3 SECTION "Use The Assets Folder" [2113-3997] -->
+<!-- EDIT3 SECTION "Use The Assets Folder" [2115-4007] -->
 <h2><a>Create Textures and Materials</a></h2>
 <div>
 
@@ -140,7 +140,7 @@ Storing the textures inside your project directory is necessary for the paths in
 </p>
 
 </div>
-<!-- EDIT4 SECTION "Create Textures and Materials" [3998-5259] -->
+<!-- EDIT4 SECTION "Create Textures and Materials" [4008-5269] -->
 <h2><a>Create 3D Models</a></h2>
 <div>
 
@@ -189,7 +189,7 @@ See also: <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
 </p>
 
 </div>
-<!-- EDIT5 SECTION "Create 3D Models" [5260-7588] -->
+<!-- EDIT5 SECTION "Create 3D Models" [5270-7598] -->
 <h2><a>Convert 3D Models to .j3o Format</a></h2>
 <div>
 
@@ -216,7 +216,7 @@ This process ensures that the texture paths are correct, and it also keeps your
 </p>
 
 </div>
-<!-- EDIT6 SECTION "Convert 3D Models to .j3o Format" [7589-8388] -->
+<!-- EDIT6 SECTION "Convert 3D Models to .j3o Format" [7599-8398] -->
 <h3><a>Must I convert to .j3o? Yes!</a></h3>
 <div>
 
@@ -245,7 +245,7 @@ Use Java commands, or use the <a href="/com/jme3/gde/docs/sdk/scene_composer.htm
 </p>
 
 </div>
-<!-- EDIT7 SECTION "Must I convert to .j3o? Yes!" [8389-9851] -->
+<!-- EDIT7 SECTION "Must I convert to .j3o? Yes!" [8399-9861] -->
 <h2><a>See Also</a></h2>
 <div>
 <ul>
@@ -264,5 +264,5 @@ Use Java commands, or use the <a href="/com/jme3/gde/docs/sdk/scene_composer.htm
 </span></div>
 
 </div>
-<!-- EDIT8 SECTION "See Also" [9852-] -->
+<!-- EDIT8 SECTION "See Also" [9862-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:intermediate:multi-media_asset_pipeline?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/intermediate/optimization.html

@@ -45,15 +45,41 @@ You can optimize nodes using the SceneComposer in the <acronym title="Software D
 
 <p>
 
-When you use math operations like <code>vectorA.mult(vectorB);</code>, they create new objects for the result. These objects have to be garbage collected when you don&#039;t use them anymore. 
+Different Java implementations use different garbage collection algorithms, so depending on the platforms you target, different advice applies.
 </p>
 
 <p>
-Check your math operations for opportunities to use the <em>local</em> version of the math operations, e.g. <code>vectorA.multLocal(vectorB)</code>. Local methods store the result in vectorA and do not create a new object. Use local methods if you do not need to keep the previous vectorA.
+The major variants are Oracle&#039;s JRE, old (pre-Gingerbread) Androids, and newer (Gingerbread or later) Androids.
+</p>
+
+<p>
+Oracle&#039;s JRE is a copying collector. This means that it does not need to do any work for objects that have become unreachable, it just keeps copying live objects to new memory areas and recycles the now-unused area as a whole.
+Older objects are copied less often, so the garbage collection overhead is roughly proportional to the rate at which your code creates new objects that survive for, say, more than a minute.
+</p>
+
+<p>
+Gingerbread and newer Androids use a garbage collector that does some optimization tricks with local variables, but you should avoid creating and forgetting lots of objects in the scene graph.
+</p>
+
+<p>
+Older Androids use a very naive garbage collector that needs to do real work for every object, both during creation and during collection. Creating local variables can build up a heap of work, particularly if the function is called often.
+</p>
+
+<p>
+To avoid creating a temporary object, use <em>local methods</em> to overwrite the contents of an existing object instead of creating a new temporary object for the result.
+</p>
+
+<p>
+E.g. when you use math operations like <code>vectorA.mult(vectorB);</code>, they create new objects for the result.
+</p>
+
+<p>
+Check your math operations for opportunities to use the <em>local</em> version of the math operations, e.g. <code>vectorA.multLocal(vectorB)</code>. Local methods store the result in vectorA and do not create a new object.
+
 </p>
 
 </div>
-<!-- EDIT3 SECTION "Avoid creating new objects" [1394-1890] -->
+<!-- EDIT3 SECTION "Avoid creating new objects" [1394-3028] -->
 <h2><a>Avoid large objects in physics</a></h2>
 <div>
 
@@ -63,7 +89,7 @@ To offload much computation to the less CPU intense physics broadphase collision
 </p>
 
 </div>
-<!-- EDIT4 SECTION "Avoid large objects in physics" [1891-2295] -->
+<!-- EDIT4 SECTION "Avoid large objects in physics" [3029-3433] -->
 <h2><a>Check the Statistics</a></h2>
 <div>
 
@@ -94,5 +120,5 @@ Generally jME3 is well optimized and optimizes these things correctly. Read <a h
 </span></div>
 
 </div>
-<!-- EDIT5 SECTION "Check the Statistics" [2296-] -->
+<!-- EDIT5 SECTION "Check the Statistics" [3434-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:intermediate:optimization?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/ios.html

@@ -6,17 +6,23 @@
 To use iOS deployment you need a computer running MacOSX and a version of Xcode 4.0+ installed. To deploy to a device or the Apple App Store, you need an Apple developer account.
 </p>
 
+<p>
+<p><div>Note that at the moment iOS deployment is in alpha state.
+</div></p>
+</p>
+
 <p>
 iOS deployment works via cross-compilation to native iOS ARM code, there is no virtual machine running on the device. The Avian JVM supports this feature while maintaining general compatibility to OpenJDK and JNI for native access. The minimum compatible iOS deployment target is 4.3.
 </p>
 
 <p>
-<p><div>Note that at the moment this option is in pre-alpha state and the system runs on a null renderer. This means there is no visual or audio output. You can however use the current system to explore the options and test cross-compiling your applications.
+<p><div>To install the iOS deployment plugin, go to Tools???Plugins and under &quot;Available plugins&quot; select the &quot;iOS Support&quot; plugin.
 </div></p>
+
 </p>
 
 </div>
-<!-- EDIT1 SECTION "iOS Deployment" [1-764] -->
+<!-- EDIT1 SECTION "iOS Deployment" [1-710] -->
 <h3><a>Enabling iOS deployment</a></h3>
 <div>
 
@@ -39,7 +45,7 @@ After enabling deployment, a new <code>ios</code> directory is created in the pr
 </p>
 
 </div>
-<!-- EDIT2 SECTION "Enabling iOS deployment" [765-1685] -->
+<!-- EDIT2 SECTION "Enabling iOS deployment" [711-1631] -->
 <h3><a>Building the iOS binaries</a></h3>
 <div>
 
@@ -56,7 +62,7 @@ After the iOS classpath has been created the avian compiler is used to create a
 </p>
 
 </div>
-<!-- EDIT3 SECTION "Building the iOS binaries" [1686-2507] -->
+<!-- EDIT3 SECTION "Building the iOS binaries" [1632-2453] -->
 <h3><a>Running and deploying the application</a></h3>
 <div>
 
@@ -68,7 +74,7 @@ To run the application, open the Xcode project under <code>ios/project</code> in
 </p>
 
 </div>
-<!-- EDIT4 SECTION "Running and deploying the application" [2508-2996] -->
+<!-- EDIT4 SECTION "Running and deploying the application" [2454-2942] -->
 <h3><a>Creating native and java code for iOS</a></h3>
 <div>
 
@@ -97,5 +103,5 @@ Java code for iOS should be in the <code>ios/src</code> folder as well for clean
 </span></div>
 
 </div>
-<!-- EDIT5 SECTION "Creating native and java code for iOS" [2997-] -->
+<!-- EDIT5 SECTION "Creating native and java code for iOS" [2943-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:ios?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/math.html

@@ -44,6 +44,30 @@ The definition of a coordinate system is defined in jME by the properties sent t
 
 </div>
 <!-- EDIT3 SECTION "Definition" [993-1806] -->
+<h3><a>Homogenous coordinates</a></h3>
+<div>
+
+<p>
+
+Homogenous coordinates have an additional <em>W</em> value tacked on to the end. The XYZ values are to be divided by W to give the true coordinates.
+</p>
+
+<p>
+This has several advantages, one technical, some relevant to application programmers:
+</p>
+
+<p>
+Technically, it simplifies some formulae used inside the vector math. For example, some operations need to apply the same factor to the XYZ coordinates. Chain multiple operations of that kind (and vector math tends to do that), and you can save a lot of multiplications by simply keeping the scaling factor around and doing the multiplication to XYZ at the end of the pipeline, in the 3D card (which does accept homogenous coordinates).
+It also simplifies some formulae, in particular anything that is related to rotations.
+</p>
+
+<p>
+For application programmers, this means you can express infinitely long vectors that still have a direction - these tend to be used in lighting. Just use a W value of 0.0.
+
+</p>
+
+</div>
+<!-- EDIT4 SECTION "Homogenous coordinates" [1807-2767] -->
 <h2><a>Transformations</a></h2>
 <div>
 
@@ -53,7 +77,7 @@ Transformations define an operation that converts points from one coordinate sys
 </p>
 
 </div>
-<!-- EDIT4 SECTION "Transformations" [1807-2199] -->
+<!-- EDIT5 SECTION "Transformations" [2768-3160] -->
 <h2><a>Visibility Determination</a></h2>
 <div>
 
@@ -63,17 +87,17 @@ Visibility Determination concerns itself with minimizing the amount of data that
 </p>
 
 </div>
-<!-- EDIT5 SECTION "Visibility Determination" [2200-2972] -->
+<!-- EDIT6 SECTION "Visibility Determination" [3161-3933] -->
 <h1><a>Fundamental Types</a></h1>
 <div>
 
 </div>
-<!-- EDIT6 SECTION "Fundamental Types" [2973-3005] -->
+<!-- EDIT7 SECTION "Fundamental Types" [3934-3966] -->
 <h2><a>ColorRGBA</a></h2>
 <div>
 
 </div>
-<!-- EDIT7 SECTION "ColorRGBA" [3006-3026] -->
+<!-- EDIT8 SECTION "ColorRGBA" [3967-3987] -->
 <h3><a>Definition</a></h3>
 <div>
 
@@ -87,7 +111,7 @@ ColorRGBA defines a color value in the jME library. The color value is made of t
 </p>
 
 </div>
-<!-- EDIT8 SECTION "Definition" [3027-3498] -->
+<!-- EDIT9 SECTION "Definition" [3988-4459] -->
 <h3><a>jME Class</a></h3>
 <div>
 
@@ -109,7 +133,7 @@ ColorRGBA will also handle interpolation between two colors. Given a second colo
 </p>
 
 </div>
-<!-- EDIT9 SECTION "jME Class" [3499-3973] -->
+<!-- EDIT10 SECTION "jME Class" [4460-4934] -->
 <h2><a>Matrix</a></h2>
 <div>
 
@@ -121,7 +145,7 @@ and <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param
 </p>
 
 </div>
-<!-- EDIT10 SECTION "Matrix" [3974-4164] -->
+<!-- EDIT11 SECTION "Matrix" [4935-5125] -->
 <h3><a>Definition</a></h3>
 <div>
 
@@ -148,7 +172,7 @@ There are a few special matrices:
 		<td>0</td><td>0</td><td>0</td>
 	</tr>
 </table></div>
-<!-- EDIT12 TABLE [4484-4507] -->
+<!-- EDIT13 TABLE [5445-5468] -->
 <p>
 
 The <em>Identity Matrix</em> is the matrix with 1 on the diagonal entries and 0 for all other entries. 
@@ -164,7 +188,7 @@ The <em>Identity Matrix</em> is the matrix with 1 on the diagonal entries and 0
 		<td>0</td><td>0</td><td>1</td>
 	</tr>
 </table></div>
-<!-- EDIT13 TABLE [4608-4631] -->
+<!-- EDIT14 TABLE [5569-5592] -->
 <p>
 
 A Matrix is <em>invertible</em> if there is a matrix <em>M<sup>-1</sup></em> where <em>MM<sup>-1</sup> = M<sup>-1</sup>M = I</em>. 
@@ -185,7 +209,7 @@ The <em>transpose</em> of a matrix <em>M = [m<sub>ij</sub>]</em> is <em>M<sup>T<
 		<td>3</td><td>3</td><td>3</td><td>    </td><td>1</td><td>2</td><td>3</td>
 	</tr>
 </table></div>
-<!-- EDIT14 TABLE [4922-4988] -->
+<!-- EDIT15 TABLE [5883-5949] -->
 <p>
 
 A Matrix is symmetric if <em>M</em> = <em>M<sup>T</sup></em>. 
@@ -201,7 +225,7 @@ A Matrix is symmetric if <em>M</em> = <em>M<sup>T</sup></em>.
 		<td>B</td><td>C</td><td>X</td>
 	</tr>
 </table></div>
-<!-- EDIT15 TABLE [5043-5068] -->
+<!-- EDIT16 TABLE [6004-6029] -->
 <p>
 Where X, A, B, and C equal numbers 
 </p>
@@ -211,7 +235,7 @@ jME includes two types of Matrix classes: Matrix3f and Matrix4f. Matrix3f is a 3
 </p>
 
 </div>
-<!-- EDIT11 SECTION "Definition" [4165-5330] -->
+<!-- EDIT12 SECTION "Definition" [5126-6291] -->
 <h3><a>Transformations</a></h3>
 <div>
 
@@ -251,7 +275,7 @@ A <em>rotation matrix</em> requires that the transpose and inverse are the same
 		<td>u<sub>1</sub></td><td>-u<sub>0</sub></td><td>0</td>
 	</tr>
 </table></div>
-<!-- EDIT17 TABLE [6022-6120] -->
+<!-- EDIT18 TABLE [6983-7081] -->
 </div>
 
 <h4><a>Translation</a></h4>
@@ -270,14 +294,14 @@ Translation requires a 4x4 matrix, where the vector (x,y,z) is mapped to (x,y,z,
 		<td>S<sup>T</sup></td><td>1</td>
 	</tr>
 </table></div>
-<!-- EDIT18 TABLE [6292-6315] -->
+<!-- EDIT19 TABLE [7253-7276] -->
 <p>
 
 where M is the 3x3 matrix (containing any rotation/scale information), T is the translation vector and S<sup>T</sup> is the transpose Vector of T. 1 is just a constant.
 </p>
 
 </div>
-<!-- EDIT16 SECTION "Transformations" [5331-6487] -->
+<!-- EDIT17 SECTION "Transformations" [6292-7448] -->
 <h3><a>jME Class</a></h3>
 <div>
 
@@ -291,7 +315,7 @@ Most methods are straight forward, and I will leave documentation to the Javadoc
 </p>
 
 </div>
-<!-- EDIT19 SECTION "jME Class" [6488-6730] -->
+<!-- EDIT20 SECTION "jME Class" [7449-7691] -->
 <h2><a>Vector</a></h2>
 <div>
 
@@ -303,7 +327,7 @@ and <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param
 </p>
 
 </div>
-<!-- EDIT20 SECTION "Vector" [6731-6921] -->
+<!-- EDIT21 SECTION "Vector" [7692-7882] -->
 <h3><a>Definition</a></h3>
 <div>
 
@@ -321,7 +345,7 @@ We have two Vectors (2f and 3f) meaning we have tuples of 2 float values or 3 fl
 </p>
 
 </div>
-<!-- EDIT21 SECTION "Definition" [6922-7346] -->
+<!-- EDIT22 SECTION "Definition" [7883-8307] -->
 <h3><a>Operations</a></h3>
 <div>
 
@@ -411,7 +435,7 @@ Vector3f and Vector2f store their values (x, y, z) and (x, y) respectively as fl
 </p>
 
 </div>
-<!-- EDIT22 SECTION "Operations" [7347-9282] -->
+<!-- EDIT23 SECTION "Operations" [8308-10243] -->
 <h2><a>Quaternion</a></h2>
 <div>
 
@@ -421,7 +445,7 @@ See <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param
 </p>
 
 </div>
-<!-- EDIT23 SECTION "Quaternion" [9283-9395] -->
+<!-- EDIT24 SECTION "Quaternion" [10244-10356] -->
 <h3><a>Definition</a></h3>
 <div>
 
@@ -485,7 +509,7 @@ These basic operations allow us to convert various rotation representations to Q
 </p>
 
 </div>
-<!-- EDIT24 SECTION "Definition" [9396-11564] -->
+<!-- EDIT25 SECTION "Definition" [10357-12525] -->
 <h3><a>Angle Axis</a></h3>
 <div>
 
@@ -505,7 +529,7 @@ float angle = 3.14f;
 s.getLocalRotation&#40;&#41;.fromAngleAxis&#40;angle, axis&#41;;</pre>
 
 </div>
-<!-- EDIT25 SECTION "Angle Axis" [11565-12330] -->
+<!-- EDIT26 SECTION "Angle Axis" [12526-13291] -->
 <h3><a>Three Angles</a></h3>
 <div>
 
@@ -523,7 +547,7 @@ float&#91;&#93; angles = &#123;1, 3, 0&#125;;
 s.getLocalRotation&#40;&#41;.fromAngles&#40;angles&#41;;</pre>
 
 </div>
-<!-- EDIT26 SECTION "Three Angles" [12331-12880] -->
+<!-- EDIT27 SECTION "Three Angles" [13292-13841] -->
 <h3><a>Three Axes</a></h3>
 <div>
 
@@ -545,7 +569,7 @@ axes&#91;2&#93; = new Vector3f&#40;0, 0.5f, 0.5f&#41;; //dir
 s.getLocalRotation&#40;&#41;.fromAxes&#40;axes&#41;;</pre>
 
 </div>
-<!-- EDIT27 SECTION "Three Axes" [12881-13627] -->
+<!-- EDIT28 SECTION "Three Axes" [13842-14588] -->
 <h3><a>Rotation Matrix</a></h3>
 <div>
 
@@ -570,7 +594,7 @@ As you can see there are many ways to build a Quaternion. This allows you to wor
 </p>
 
 </div>
-<!-- EDIT28 SECTION "Rotation Matrix" [13628-14532] -->
+<!-- EDIT29 SECTION "Rotation Matrix" [14589-15493] -->
 <h3><a>Slerp</a></h3>
 <div>
 
@@ -590,7 +614,7 @@ Quaternion q2;
 Quaternion q3 = q1.slerp&#40;q2, 0.5f&#41;;</pre>
 
 </div>
-<!-- EDIT29 SECTION "Slerp" [14533-15170] -->
+<!-- EDIT30 SECTION "Slerp" [15494-16131] -->
 <h3><a>Multiplication</a></h3>
 <div>
 
@@ -608,7 +632,7 @@ Vector3f myVector = new Vector3f&#40;0,0,-1&#41;;
 myRotation.multLocal&#40;myVector&#41;;</pre>
 
 </div>
-<!-- EDIT30 SECTION "Multiplication" [15171-15645] -->
+<!-- EDIT31 SECTION "Multiplication" [16132-16606] -->
 <h1><a>Utility Classes</a></h1>
 <div>
 
@@ -618,7 +642,7 @@ Along with the base Math classes, jME provides a number of Math classes to make
 </p>
 
 </div>
-<!-- EDIT31 SECTION "Utility Classes" [15646-15921] -->
+<!-- EDIT32 SECTION "Utility Classes" [16607-16882] -->
 <h2><a>Fast Math</a></h2>
 <div>
 
@@ -628,7 +652,7 @@ See <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param
 </p>
 
 </div>
-<!-- EDIT32 SECTION "Fast Math" [15922-16028] -->
+<!-- EDIT33 SECTION "Fast Math" [16883-16989] -->
 <h3><a>Definition</a></h3>
 <div>
 
@@ -638,7 +662,7 @@ FastMath provides a number of convience methods, and where possible faster versi
 </p>
 
 </div>
-<!-- EDIT33 SECTION "Definition" [16029-16182] -->
+<!-- EDIT34 SECTION "Definition" [16990-17143] -->
 <h3><a>Usage</a></h3>
 <div>
 
@@ -729,7 +753,7 @@ There are five major categories of functions that FastMath provides.
 </ul>
 
 </div>
-<!-- EDIT34 SECTION "Usage" [16183-18604] -->
+<!-- EDIT35 SECTION "Usage" [17144-19565] -->
 <h2><a>Line</a></h2>
 <div>
 
@@ -739,7 +763,7 @@ See <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param
 </p>
 
 </div>
-<!-- EDIT35 SECTION "Line" [18605-18698] -->
+<!-- EDIT36 SECTION "Line" [19566-19659] -->
 <h3><a>Definition</a></h3>
 <div>
 
@@ -749,7 +773,7 @@ A line is a straight one-dimensional figure having no thickness and extending in
 </p>
 
 </div>
-<!-- EDIT36 SECTION "Definition" [18699-18912] -->
+<!-- EDIT37 SECTION "Definition" [19660-19873] -->
 <h3><a>Usage</a></h3>
 <div>
 
@@ -763,14 +787,14 @@ jME defines a Line class that is defined by an origin and direction. In reality,
 </p>
 
 </div>
-<!-- EDIT37 SECTION "Usage" [18913-19251] -->
+<!-- EDIT38 SECTION "Usage" [19874-20212] -->
 <h3><a>Example 1 - Find a Random Point on a Line</a></h3>
 <div>
 <pre>Line l = new Line&#40;new Vector3f&#40;0,1,0&#41;, new Vector3f&#40;3,2,1&#41;&#41;;
 Vector3f randomPoint = l.random&#40;&#41;;</pre>
 
 </div>
-<!-- EDIT38 SECTION "Example 1 - Find a Random Point on a Line" [19252-19419] -->
+<!-- EDIT39 SECTION "Example 1 - Find a Random Point on a Line" [20213-20380] -->
 <h2><a>Plane</a></h2>
 <div>
 
@@ -780,7 +804,7 @@ See <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param
 </p>
 
 </div>
-<!-- EDIT39 SECTION "Plane" [19420-19516] -->
+<!-- EDIT40 SECTION "Plane" [20381-20477] -->
 <h3><a>Definition</a></h3>
 <div>
 
@@ -814,7 +838,7 @@ This gives us the general equation: (ax + by + cz + d = 0)
 </p>
 
 </div>
-<!-- EDIT40 SECTION "Definition" [19517-20211] -->
+<!-- EDIT41 SECTION "Definition" [20478-21172] -->
 <h3><a>Usage in jME</a></h3>
 <div>
 
@@ -846,7 +870,7 @@ These values are returned on a call to <code>whichSide</code>.
 </p>
 
 </div>
-<!-- EDIT41 SECTION "Usage in jME" [20212-20930] -->
+<!-- EDIT42 SECTION "Usage in jME" [21173-21891] -->
 <h3><a>Example 1 - Determining if a Point is On the Positive Side of a Plane</a></h3>
 <div>
 <pre>Vector3f normal = new Vector3f&#40;0,1,0&#41;;
@@ -860,7 +884,7 @@ if&#40;side == Plane.NO_SIDE&#41; &#123;
 &#125;</pre>
 
 </div>
-<!-- EDIT42 SECTION "Example 1 - Determining if a Point is On the Positive Side of a Plane" [20931-21305] -->
+<!-- EDIT43 SECTION "Example 1 - Determining if a Point is On the Positive Side of a Plane" [21892-22266] -->
 <h3><a>Example 2 - For the Layperson</a></h3>
 <div>
 
@@ -932,7 +956,7 @@ public class TestPlanes
 &#125;</pre>
 
 </div>
-<!-- EDIT43 SECTION "Example 2 - For the Layperson" [21306-23943] -->
+<!-- EDIT44 SECTION "Example 2 - For the Layperson" [22267-24904] -->
 <h2><a>Ray</a></h2>
 <div>
 
@@ -942,7 +966,7 @@ See <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param
 </p>
 
 </div>
-<!-- EDIT44 SECTION "Ray" [23944-24034] -->
+<!-- EDIT45 SECTION "Ray" [24905-24995] -->
 <h3><a>Definition</a></h3>
 <div>
 
@@ -956,13 +980,13 @@ This Ray is used extensively in jME for <a href="/com/jme3/gde/docs/jme3/picking
 </p>
 
 </div>
-<!-- EDIT45 SECTION "Definition" [24035-24401] -->
+<!-- EDIT46 SECTION "Definition" [24996-25362] -->
 <h3><a>Example 1 - Create a Ray That Represents Where the Camera is Looking</a></h3>
 <div>
 <pre>Ray ray = new Ray&#40;cam.getLocation&#40;&#41;, cam.getDirection&#40;&#41;&#41;;</pre>
 
 </div>
-<!-- EDIT46 SECTION "Example 1 - Create a Ray That Represents Where the Camera is Looking" [24402-24558] -->
+<!-- EDIT47 SECTION "Example 1 - Create a Ray That Represents Where the Camera is Looking" [25363-25519] -->
 <h2><a>Rectangle</a></h2>
 <div>
 
@@ -972,7 +996,7 @@ See <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param
 </p>
 
 </div>
-<!-- EDIT47 SECTION "Rectangle" [24559-24667] -->
+<!-- EDIT48 SECTION "Rectangle" [25520-25628] -->
 <h3><a>Definition</a></h3>
 <div>
 
@@ -982,7 +1006,7 @@ Rectangle defines a finite plane within three dimensional space that is specifie
 </p>
 
 </div>
-<!-- EDIT48 SECTION "Definition" [24668-24896] -->
+<!-- EDIT49 SECTION "Definition" [25629-25857] -->
 <h3><a>jME Usage</a></h3>
 <div>
 
@@ -992,7 +1016,7 @@ Rectangle is a straight forward data class that simply maintains values that def
 </p>
 
 </div>
-<!-- EDIT49 SECTION "jME Usage" [24897-25211] -->
+<!-- EDIT50 SECTION "jME Usage" [25858-26172] -->
 <h3><a>Example 1 : Define a Rectangle and Get a Point From It</a></h3>
 <div>
 <pre>Vector3f v1 = new Vector3f&#40;1,0,0&#41;;
@@ -1002,7 +1026,7 @@ Rectangle r = new Rectangle&#40;v1, v2, v3&#41;;
 Vector3f point = r.random&#40;&#41;;</pre>
 
 </div>
-<!-- EDIT50 SECTION "Example 1 : Define a Rectangle and Get a Point From It" [25212-25471] -->
+<!-- EDIT51 SECTION "Example 1 : Define a Rectangle and Get a Point From It" [26173-26432] -->
 <h2><a>Triangle</a></h2>
 <div>
 
@@ -1012,7 +1036,7 @@ See <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"><param
 </p>
 
 </div>
-<!-- EDIT51 SECTION "Triangle" [25472-25577] -->
+<!-- EDIT52 SECTION "Triangle" [26433-26538] -->
 <h3><a>Definition</a></h3>
 <div>
 
@@ -1022,7 +1046,7 @@ A triangle is a 3-sided polygon. Every triangle has three sides and three angles
 </p>
 
 </div>
-<!-- EDIT52 SECTION "Definition" [25578-25991] -->
+<!-- EDIT53 SECTION "Definition" [26539-26952] -->
 <h3><a>Usage</a></h3>
 <div>
 
@@ -1032,7 +1056,7 @@ jME&#039;s Triangle class is a simple data class. It contains three <a href="/co
 </p>
 
 </div>
-<!-- EDIT53 SECTION "Usage" [25992-26318] -->
+<!-- EDIT54 SECTION "Usage" [26953-27279] -->
 <h3><a>Example 1 - Creating a Triangle</a></h3>
 <div>
 <pre>//the three points that make up the triangle
@@ -1042,12 +1066,12 @@ Vector3f p3 = new Vector3f&#40;0,1,1&#41;;
 Triangle t = new Triangle&#40;p1, p2, p3&#41;;</pre>
 
 </div>
-<!-- EDIT54 SECTION "Example 1 - Creating a Triangle" [26319-26569] -->
+<!-- EDIT55 SECTION "Example 1 - Creating a Triangle" [27280-27530] -->
 <h1><a>Tips and Tricks</a></h1>
 <div>
 
 </div>
-<!-- EDIT55 SECTION "Tips and Tricks" [26570-26600] -->
+<!-- EDIT56 SECTION "Tips and Tricks" [27531-27561] -->
 <h2><a>How do I get height/width of a spatial?</a></h2>
 <div>
 
@@ -1062,13 +1086,13 @@ float y = &#40; &#40;BoundingBox&#41;spatial.getWorldBound&#40;&#41;&#41;.getYEx
 float z = &#40; &#40;BoundingBox&#41;spatial.getWorldBound&#40;&#41;&#41;.getZExtent&#40;&#41;;</pre>
 
 </div>
-<!-- EDIT56 SECTION "How do I get height/width of a spatial?" [26601-27031] -->
+<!-- EDIT57 SECTION "How do I get height/width of a spatial?" [27562-27992] -->
 <h2><a>How do I position the center of a Geomtry?</a></h2>
 <div>
 <pre>geo.center&#40;&#41;.move&#40;pos&#41;;</pre>
 
 </div>
-<!-- EDIT57 SECTION "How do I position the center of a Geomtry?" [27032-27131] -->
+<!-- EDIT58 SECTION "How do I position the center of a Geomtry?" [27993-28092] -->
 <h3><a>See Also</a></h3>
 <div>
 <ul>
@@ -1079,5 +1103,5 @@ float z = &#40; &#40;BoundingBox&#41;spatial.getWorldBound&#40;&#41;&#41;.getZEx
 </ul>
 
 </div>
-<!-- EDIT58 SECTION "See Also" [27132-] -->
+<!-- EDIT59 SECTION "See Also" [28093-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:math?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/jme3/terminology.html

@@ -352,11 +352,11 @@ See also: <a href="/com/jme3/gde/docs/jme3/advanced/water.html">Water</a>.
 
 <p>
 
-MIP Map means that you provide one texture in two or three resolutions in one file (MIP = &quot;multum in parvo&quot; = &quot;many in one&quot;). Depending on how close (or far) the camera is, the engine automatically renders a more (or less) detailed texture for the object. Thus objects look smooth from close up, but don&#039;t waste resources with unspottable details when far away. Good for everything, but requires more time to create and more space to store textures. If you don&#039;t provide custom ones, the jMonkeyEngine creates basic MIP maps automatically as an optimization.
+MIP Map means that you provide one texture in two or three resolutions in one file (MIP = &quot;multum in parvo&quot; = &quot;many in one&quot;). Depending on how close (or far) the camera is, the engine automatically renders a more (or less) detailed texture for the object. Thus objects look detailed at close up, but also look good when viewed from far away. Good for everything, but requires more time to create and more space to store textures. If you don&#039;t provide custom ones, the jMonkeyEngine creates basic MIP maps automatically as an optimization.
 </p>
 
 </div>
-<!-- EDIT23 SECTION "MIP Map Texture" [10812-11398] -->
+<!-- EDIT23 SECTION "MIP Map Texture" [10812-11378] -->
 <h2><a>Procedural Textures</a></h2>
 <div>
 
@@ -374,7 +374,7 @@ See also: <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
 </p>
 
 </div>
-<!-- EDIT24 SECTION "Procedural Textures" [11399-12305] -->
+<!-- EDIT24 SECTION "Procedural Textures" [11379-12285] -->
 <h1><a>Animation</a></h1>
 <div>
 
@@ -388,7 +388,7 @@ Unless you animate a 3D cartoon, realism of animated characters is generally a p
 </p>
 
 </div>
-<!-- EDIT25 SECTION "Animation" [12306-12902] -->
+<!-- EDIT25 SECTION "Animation" [12286-12882] -->
 <h2><a>Rigging and Skinning</a></h2>
 <div>
 
@@ -458,7 +458,7 @@ E.g. when the thigh bone moves, the leg is fully affected, the hips joints less
 </p>
 
 </div>
-<!-- EDIT26 SECTION "Rigging and Skinning" [12903-15439] -->
+<!-- EDIT26 SECTION "Rigging and Skinning" [12883-15419] -->
 <h2><a>Kinematics</a></h2>
 <div>
 <ul>
@@ -469,7 +469,7 @@ E.g. when the thigh bone moves, the leg is fully affected, the hips joints less
 </ul>
 
 </div>
-<!-- EDIT27 SECTION "Kinematics" [15440-15704] -->
+<!-- EDIT27 SECTION "Kinematics" [15420-15684] -->
 <h2><a>Controller and Channel</a></h2>
 <div>
 
@@ -478,7 +478,7 @@ In the JME3 application, you register animated models to the Animation Controlle
 </p>
 
 </div>
-<!-- EDIT28 SECTION "Controller and Channel" [15705-16073] -->
+<!-- EDIT28 SECTION "Controller and Channel" [15685-16053] -->
 <h1><a>Artificial Intelligence (AI)</a></h1>
 <div>
 
@@ -529,7 +529,7 @@ There are lots of resources explaining interesting AI algorithms:
 </ul>
 
 </div>
-<!-- EDIT29 SECTION "Artificial Intelligence (AI)" [16074-19559] -->
+<!-- EDIT29 SECTION "Artificial Intelligence (AI)" [16054-19539] -->
 <h1><a>Math</a></h1>
 <div>
 
@@ -538,7 +538,7 @@ There are lots of resources explaining interesting AI algorithms:
 </p>
 
 </div>
-<!-- EDIT30 SECTION "Math" [19560-19633] -->
+<!-- EDIT30 SECTION "Math" [19540-19613] -->
 <h2><a>Coordinates</a></h2>
 <div>
 
@@ -549,7 +549,7 @@ In contrast to a vector (which looks similar), a coordinate is a location, not a
 </p>
 
 </div>
-<!-- EDIT31 SECTION "Coordinates" [19634-20023] -->
+<!-- EDIT31 SECTION "Coordinates" [19614-20003] -->
 <h3><a>The Origin</a></h3>
 <div>
 
@@ -563,7 +563,7 @@ The origin is the central point in the 3D world, where the three axes meet. It&#
 </p>
 
 </div>
-<!-- EDIT32 SECTION "The Origin" [20024-20228] -->
+<!-- EDIT32 SECTION "The Origin" [20004-20208] -->
 <h2><a>Vectors</a></h2>
 <div>
 
@@ -579,7 +579,7 @@ A vector has a length and a direction, like an arrow in 3D space. A vector start
 Vector3f v = new Vector3f&#40; 8f , 0f , 33f &#41;.add&#40;new Vector3f&#40; 0f , -2f , -2f &#41;&#41;; // starts at (8,-2,31)</pre>
 
 </div>
-<!-- EDIT33 SECTION "Vectors" [20229-20679] -->
+<!-- EDIT33 SECTION "Vectors" [20209-20659] -->
 <h3><a>Unit Vectors</a></h3>
 <div>
 
@@ -603,7 +603,7 @@ Negate the vegator to change its direction, e.g. (-1, 0, 0) = left.
 </p>
 
 </div>
-<!-- EDIT34 SECTION "Unit Vectors" [20680-21178] -->
+<!-- EDIT34 SECTION "Unit Vectors" [20660-21158] -->
 <h3><a>Normalized Vectors</a></h3>
 <div>
 
@@ -618,7 +618,7 @@ When you normalize a vector, it still has the same direction, but you lose the i
 </p>
 
 </div>
-<!-- EDIT35 SECTION "Normalized Vectors" [21179-21522] -->
+<!-- EDIT35 SECTION "Normalized Vectors" [21159-21502] -->
 <h3><a>Surface Normal Vectors</a></h3>
 <div>
 
@@ -630,7 +630,7 @@ You calculate the Surface Normal by calculating the cross product.
 </p>
 
 </div>
-<!-- EDIT36 SECTION "Surface Normal Vectors" [21523-21735] -->
+<!-- EDIT36 SECTION "Surface Normal Vectors" [21503-21715] -->
 <h3><a>Cross Product</a></h3>
 <div>
 
@@ -647,7 +647,7 @@ In 3D space, speaking of an orthogonal only makes sense with respect to a plane.
 </p>
 
 </div>
-<!-- EDIT37 SECTION "Cross Product" [21736-22446] -->
+<!-- EDIT37 SECTION "Cross Product" [21716-22426] -->
 <h3><a>Transformation</a></h3>
 <div>
 
@@ -661,7 +661,7 @@ Examples: Falling and rotating bricks in 3D Tetris.
 </p>
 
 </div>
-<!-- EDIT38 SECTION "Transformation" [22447-22711] -->
+<!-- EDIT38 SECTION "Transformation" [22427-22691] -->
 <h3><a>Slerp</a></h3>
 <div>
 
@@ -679,7 +679,7 @@ Example: A burning meteorite Geometry slerps from &quot;position p1, rotation r1
 </p>
 
 </div>
-<!-- EDIT39 SECTION "Slerp" [22712-23481] -->
+<!-- EDIT39 SECTION "Slerp" [22692-23461] -->
 <h1><a>Game Developer Jargon</a></h1>
 <div>
 <ul>
@@ -688,7 +688,7 @@ Example: A burning meteorite Geometry slerps from &quot;position p1, rotation r1
 </ul>
 
 </div>
-<!-- EDIT40 SECTION "Game Developer Jargon" [23482-23645] -->
+<!-- EDIT40 SECTION "Game Developer Jargon" [23462-23625] -->
 <h1><a>3D graphics Terminology Wiki book</a></h1>
 <div>
 <ul>
@@ -697,5 +697,5 @@ Example: A burning meteorite Geometry slerps from &quot;position p1, rotation r1
 </ul>
 
 </div>
-<!-- EDIT41 SECTION "3D graphics Terminology Wiki book" [23646-] -->
+<!-- EDIT41 SECTION "3D graphics Terminology Wiki book" [23626-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/jme3:terminology?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/sdk/application_deployment.html

@@ -15,10 +15,12 @@ After you have written and tested your game, you want to brand it and distribute
 </li>
 <li><div> Android mobile device (.APK)</div>
 </li>
+<li><div> iOS mobile device (XCode project)</div>
+</li>
 </ul>
 
 </div>
-<!-- EDIT1 SECTION "jMonkeyEngine SDK: Application Deployment" [1-417] -->
+<!-- EDIT1 SECTION "jMonkeyEngine SDK: Application Deployment" [1-455] -->
 <h2><a>Requirements</a></h2>
 <div>
 
@@ -28,7 +30,7 @@ Since JAR files are platform independent, your customers can play your jMonkeyEn
 </p>
 
 </div>
-<!-- EDIT2 SECTION "Requirements" [418-719] -->
+<!-- EDIT2 SECTION "Requirements" [456-757] -->
 <h2><a>Branding</a></h2>
 <div>
 
@@ -72,7 +74,7 @@ TODO: where does this info actually show up?
 </p>
 
 </div>
-<!-- EDIT3 SECTION "Branding" [720-1444] -->
+<!-- EDIT3 SECTION "Branding" [758-1482] -->
 <h2><a>Creating the Distributable</a></h2>
 <div>
 
@@ -90,7 +92,7 @@ Here are your deployment options in detail:
 </p>
 
 </div>
-<!-- EDIT4 SECTION "Creating the Distributable" [1445-1988] -->
+<!-- EDIT4 SECTION "Creating the Distributable" [1483-2026] -->
 <h3><a>Desktop Application (JAR)</a></h3>
 <div>
 
@@ -118,7 +120,7 @@ Most operating systems execute a JAR when users double-click on it, but you can
 </p>
 
 </div>
-<!-- EDIT5 SECTION "Desktop Application (JAR)" [1989-2865] -->
+<!-- EDIT5 SECTION "Desktop Application (JAR)" [2027-2903] -->
 <h3><a>Desktop Executables (.EXE, .APP, .JAR)</a></h3>
 <div>
 
@@ -144,7 +146,7 @@ When you build your project, zip files for each selected platform will be create
 </p>
 
 </div>
-<!-- EDIT6 SECTION "Desktop Executables (.EXE, .APP, .JAR)" [2866-3799] -->
+<!-- EDIT6 SECTION "Desktop Executables (.EXE, .APP, .JAR)" [2904-3837] -->
 <h3><a>Web Start (.JNLP)</a></h3>
 <div>
 
@@ -181,7 +183,7 @@ Also, see this <object classid="java:org.netbeans.modules.javahelp.BrowserDispla
 </p>
 
 </div>
-<!-- EDIT7 SECTION "Web Start (.JNLP)" [3800-5403] -->
+<!-- EDIT7 SECTION "Web Start (.JNLP)" [3838-5441] -->
 <h3><a>Browser Applet</a></h3>
 <div>
 
@@ -246,7 +248,7 @@ The <code>dist/Applet</code> directory now contains all the files necessary for
 </ul>
 
 </div>
-<!-- EDIT8 SECTION "Browser Applet" [5404-7168] -->
+<!-- EDIT8 SECTION "Browser Applet" [5442-7206] -->
 <h3><a>Android Mobile Device</a></h3>
 <div>
 
@@ -260,13 +262,13 @@ Learn more about <a href="/com/jme3/gde/docs/jme3/android.html">Android Support<
 </p>
 
 </div>
-<!-- EDIT9 SECTION "Android Mobile Device" [7169-7347] -->
+<!-- EDIT9 SECTION "Android Mobile Device" [7207-7385] -->
 <h3><a>iOS Device</a></h3>
 <div>
 
 <p>
 
-You can set the jMonkeyEngine <acronym title="Software Development Kit">SDK</acronym> to build an executable for iOS platforms. Mac support is work in progress. 
+You can set the jMonkeyEngine <acronym title="Software Development Kit">SDK</acronym> to build an executable for iOS platforms. A Mac with XCode installed is needed.
 </p>
 
 <p>
@@ -274,7 +276,7 @@ Learn more about <a href="/com/jme3/gde/docs/jme3/ios.html">iOS Support</a> here
 </p>
 
 </div>
-<!-- EDIT10 SECTION "iOS Device" [7348-7529] -->
+<!-- EDIT10 SECTION "iOS Device" [7386-7571] -->
 <h2><a>Tip: Switching Build Configurations</a></h2>
 <div>
 
@@ -299,7 +301,7 @@ Now you can use the <code>Set Project Configuration</code> popup menu to switch
 </p>
 
 </div>
-<!-- EDIT11 SECTION "Tip: Switching Build Configurations" [7530-8305] -->
+<!-- EDIT11 SECTION "Tip: Switching Build Configurations" [7572-8347] -->
 <h2><a>Tip: Reduce Distribution File Size</a></h2>
 <div>
 
@@ -342,5 +344,5 @@ jme3-libraries-gui, jme3-libraries-physics, jme3-libraries-video, etc.</div>
 </span></div>
 
 </div>
-<!-- EDIT12 SECTION "Tip: Reduce Distribution File Size" [8306-] -->
+<!-- EDIT12 SECTION "Tip: Reduce Distribution File Size" [8348-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/sdk:application_deployment?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/sdk/blender.html

@@ -158,15 +158,23 @@ By default a BlenderModelLoader is registered with your assetManager to load ble
 </li>
 </ul>
 </li>
+<li><div> Importing sky</div>
+<ul>
+<li><div> loading world&#039;s horizon color as a background color if no sky type is used</div>
+</li>
+<li><div> loading sky without the texture</div>
+</li>
+<li><div> loading textured sky (including both generated and normal textures)</div>
+</li>
+</ul>
+</li>
 </ol>
 
 </div>
-<!-- EDIT4 SECTION "Currently supported features" [1229-4399] -->
+<!-- EDIT4 SECTION "Currently supported features" [1229-4610] -->
 <h2><a>Planned features.</a></h2>
 <div>
 <ol>
-<li><div> Loading sky.</div>
-</li>
 <li><div> Full support for scale and offset in texture input mapping.</div>
 </li>
 <li><div> Full support for bone and object constraints.</div>
@@ -180,7 +188,7 @@ By default a BlenderModelLoader is registered with your assetManager to load ble
 </ol>
 
 </div>
-<!-- EDIT5 SECTION "Planned features." [4400-4660] -->
+<!-- EDIT5 SECTION "Planned features." [4611-4854] -->
 <h2><a>Known bugs/problems.</a></h2>
 <div>
 <ol>
@@ -191,7 +199,7 @@ By default a BlenderModelLoader is registered with your assetManager to load ble
 </ol>
 
 </div>
-<!-- EDIT6 SECTION "Known bugs/problems." [4661-5067] -->
+<!-- EDIT6 SECTION "Known bugs/problems." [4855-5261] -->
 <h2><a>Using BlenderLoader instead of BlenderModelLoader</a></h2>
 <div>
 
@@ -252,7 +260,7 @@ You can use ModelKey as well. This will give the same result as using default Bl
 </p>
 
 </div>
-<!-- EDIT7 SECTION "Using BlenderLoader instead of BlenderModelLoader" [5068-6804] -->
+<!-- EDIT7 SECTION "Using BlenderLoader instead of BlenderModelLoader" [5262-6998] -->
 <h2><a>How does it work?</a></h2>
 <div>
 
@@ -298,7 +306,7 @@ Here is the list of how blender features are mapped into jme.
 		<td>Surface	</td><td>Node </td><td>The surface is transformed to the proper mesh</td>
 	</tr>
 </table></div>
-<!-- EDIT9 TABLE [7278-7629] -->
+<!-- EDIT9 TABLE [7472-7823] -->
 <p>
 
 Using BlenderLoader can allow you to use blend file as your local assets repository.
@@ -308,7 +316,7 @@ Probably versions before 2.49 will work pretty well too, but I never checked tha
 </p>
 
 </div>
-<!-- EDIT8 SECTION "How does it work?" [6805-7964] -->
+<!-- EDIT8 SECTION "How does it work?" [6999-8158] -->
 <h2><a>Notes</a></h2>
 <div>
 
@@ -321,6 +329,15 @@ Hope I will meet your expectations.
 Be mindful of the result model vertices amount. The best results are achieved when the model is smooth and has no texture. Then the vertex amount is equal to the vertex amount in blender. If the model is not smooth or has a generated texture applied then the amount of vertices is 3 times larger than mesh&#039;s triangles amount. If a 2d texture is applied with UV mapping then the vertex count will vary depending on how much the UV map is fragmented.
 </p>
 
+<p>
+When using polygon meshes in blender 2.5 and newer, better add and apply the triangulation modifier (if available in your version) or save the file with convertion from polygons to triangles.
+Even though the importer supports loading of polygons as the mesh faces, if your face isn&#039;t convex, the results might contain errors.
+</p>
+
+<p>
+Not all modifiers are supported. If your model has modifiers and looks not the way you want in the jme scene - try to apply them and load again.
+</p>
+
 <p>
 Cheers,
 Marcin Roguski (Kaelthas)
@@ -349,5 +366,5 @@ See also:
 </span></div>
 
 </div>
-<!-- EDIT10 SECTION "Notes" [7965-] -->
+<!-- EDIT10 SECTION "Notes" [8159-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/sdk:blender?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/sdk/development.html

@@ -78,6 +78,26 @@ If you feel like you want to make an addition to jMonkeyEngine <acronym title="S
 
 </div>
 
+<h4><a>Teminology used here</a></h4>
+<div>
+<ul>
+<li><div> A ???plugin??? is anything you can tick in the plugin manager of the <acronym title="Software Development Kit">SDK</acronym>. It can contain editors, simple ???Java SE Libraries??? that you can add to your projects as jar files and other things like project templates etc.</div>
+</li>
+<li><div> A ???module??? is the project type that allows you to create plugins, strictly speaking all plugins are modules but there can be modules that are never shown in the plugin list and only exist as dependencies of other modules.</div>
+</li>
+<li><div> A ???library??? is an entry for a jar file (and optionally sources and javadocs) which can be added to a <acronym title="Software Development Kit">SDK</acronym> project to be used and distributed with it</div>
+</li>
+<li><div> An ???extension??? is a generic name for stuff that extends the jME engine, like pathfinding algorithms or anything that can be used at the game runtime..</div>
+</li>
+</ul>
+
+<p>
+
+So if you have some cool code that others can use in their games too, you would make your extension a library by creating a module that the users can download as a plugin :)
+</p>
+
+</div>
+
 <h4><a>Handy things in jMonkeyEngine SDK Core</a></h4>
 <div>
 <ul>

sdk/jme3-documentation/src/com/jme3/gde/docs/sdk/material_editing.html

@@ -112,7 +112,7 @@ Or in your Java code
 <li><div> Use a loader and a setter to assign the material to a Geometry</div>
 </li>
 </ul>
-<pre>mywall.setMaterial&#40;assetManager.loadAsset&#40; &quot;Materials/mat_wall.j3m&quot;&#41;&#41;;</pre>
+<pre>mywall.setMaterial&#40;assetManager.loadMaterial&#40; &quot;Materials/mat_wall.j3m&quot;&#41;&#41;;</pre>
 <hr />
 
 <p>

sdk/jme3-documentation/src/com/jme3/gde/docs/sdk/scene_explorer.html

@@ -30,11 +30,11 @@ The SceneExplorer displays Nodes in a tree that represents the tree of Spatials
 </p>
 
 <p>
-You open the SceneExplorer by viewing a model (j3o file or other) in the jMonkeyEngine <acronym title="Software Development Kit">SDK</acronym>.
+SceneExplorer works in conjunction with SceneComposer, the default editor for J3O files in the jMonkeyEngine IDE.  If SceneExplorer doesn&#039;t appear when you select &quot;Edit in SceneComposer&quot;, choose Window ??? SceneExplorer from the menu bar to reveal the window.
 </p>
 
 </div>
-<!-- EDIT3 SECTION "Using the SceneExplorer" [478-780] -->
+<!-- EDIT3 SECTION "Using the SceneExplorer" [478-947] -->
 <h3><a>Editing Objects in the scene</a></h3>
 <div>
 <ol>
@@ -47,7 +47,7 @@ You open the SceneExplorer by viewing a model (j3o file or other) in the jMonkey
 </ol>
 
 </div>
-<!-- EDIT4 SECTION "Editing Objects in the scene" [781-1085] -->
+<!-- EDIT4 SECTION "Editing Objects in the scene" [948-1252] -->
 <h3><a>Reorganizing Objects in the scene</a></h3>
 <div>
 <ol>
@@ -58,7 +58,7 @@ You open the SceneExplorer by viewing a model (j3o file or other) in the jMonkey
 </ol>
 
 </div>
-<!-- EDIT5 SECTION "Reorganizing Objects in the scene" [1086-1348] -->
+<!-- EDIT5 SECTION "Reorganizing Objects in the scene" [1253-1515] -->
 <h3><a>Adding Objects to the scene</a></h3>
 <div>
 
@@ -75,5 +75,5 @@ Right-click a Spatial or Node in the SceneExplorer to add other Spatials like Pa
 </span></div>
 
 </div>
-<!-- EDIT6 SECTION "Adding Objects to the scene" [1349-] -->
+<!-- EDIT6 SECTION "Adding Objects to the scene" [1516-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/sdk:scene_explorer?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/sdk/troubleshooting.html

@@ -4,30 +4,6 @@
 
 </div>
 <!-- EDIT1 SECTION "Troubleshooting jMonkeyEngine3 SDK" [1-47] -->
-<h3><a>Specifying the JDK location</a></h3>
-<div>
-
-<p>
-
-You should install the <acronym title="Java Development Kit">JDK</acronym> (the one from Oracle, not OpenJDK) first, and then the jMonkey <acronym title="Software Development Kit">SDK</acronym>. If jMonkeyEngine <acronym title="Software Development Kit">SDK</acronym> cannot find a valid <acronym title="Java Development Kit">JDK</acronym> although you have it installed, then you have to specify the location manually.
-
-</p>
-<ol>
-<li><div> Go to your jMonkeyEngine <acronym title="Software Development Kit">SDK</acronym> installation directory. <br/>
-Mac users right-click jMonkeyApplication.app (which actually is a directory) in the Finder and select &quot;Show package contents&quot;. </div>
-</li>
-<li><div> Navigate to the <code>etc</code> directory. <br/>
-Mac users navigate to <code>Contents/Resources/jmonkeyplatform/etc/</code>.</div>
-</li>
-<li><div> Open the file <code>jmonkeyplatform.conf</code> in a text editor.</div>
-</li>
-<li><div> Uncomment the following line and enter the path to the <acronym title="Java Development Kit">JDK</acronym>: <pre>jdkhome=&quot;/path/to/jdk&quot;</pre>
-</div>
-</li>
-</ol>
-
-</div>
-<!-- EDIT2 SECTION "Specifying the JDK location" [48-766] -->
 <h3><a>Graphics Card Driver</a></h3>
 <div>
 
@@ -37,7 +13,7 @@ Mac users navigate to <code>Contents/Resources/jmonkeyplatform/etc/</code>.</div
 </p>
 
 </div>
-<!-- EDIT3 SECTION "Graphics Card Driver" [767-1020] -->
+<!-- EDIT2 SECTION "Graphics Card Driver" [48-301] -->
 <h3><a>Stability / Graphics issues</a></h3>
 <div>
 
@@ -80,7 +56,7 @@ Compiz on Linux might cause issues, if you set its rendering quality to &quot;me
 </p>
 
 </div>
-<!-- EDIT4 SECTION "Stability / Graphics issues" [1021-2353] -->
+<!-- EDIT3 SECTION "Stability / Graphics issues" [302-1634] -->
 <h3><a>Updating problems</a></h3>
 <div>
 
@@ -89,7 +65,7 @@ If you have problems updating the <acronym title="Software Development Kit">SDK<
 </p>
 
 </div>
-<!-- EDIT5 SECTION "Updating problems" [2354-2601] -->
+<!-- EDIT4 SECTION "Updating problems" [1635-1882] -->
 <h3><a>Preferences and Settings</a></h3>
 <div>
 
@@ -108,7 +84,7 @@ To completely remove and/or reinstall the <acronym title="Software Development K
 </ul>
 
 </div>
-<!-- EDIT6 SECTION "Preferences and Settings" [2602-3090] -->
+<!-- EDIT5 SECTION "Preferences and Settings" [1883-2371] -->
 <h3><a>Log</a></h3>
 <div>
 
@@ -117,7 +93,7 @@ To see or post the error output of the <acronym title="Software Development Kit"
 </p>
 
 </div>
-<!-- EDIT7 SECTION "Log" [3091-3280] -->
+<!-- EDIT6 SECTION "Log" [2372-2561] -->
 <h3><a>Getting error messages and reporting issues</a></h3>
 <div>
 
@@ -126,7 +102,31 @@ When an exception happens in the <acronym title="Software Development Kit">SDK</
 </p>
 
 </div>
-<!-- EDIT8 SECTION "Getting error messages and reporting issues" [3281-3670] -->
+<!-- EDIT7 SECTION "Getting error messages and reporting issues" [2562-2951] -->
+<h3><a>Specifying the JDK location</a></h3>
+<div>
+
+<p>
+
+You can install another <acronym title="Java Development Kit">JDK</acronym> for use with the jMonkey <acronym title="Software Development Kit">SDK</acronym>. You then have to specify the location manually.
+
+</p>
+<ol>
+<li><div> Go to your jMonkeyEngine <acronym title="Software Development Kit">SDK</acronym> installation directory. <br/>
+Mac users right-click jMonkeyApplication.app (which actually is a directory) in the Finder and select &quot;Show package contents&quot;. </div>
+</li>
+<li><div> Navigate to the <code>etc</code> directory. <br/>
+Mac users navigate to <code>Contents/Resources/jmonkeyplatform/etc/</code>.</div>
+</li>
+<li><div> Open the file <code>jmonkeyplatform.conf</code> in a text editor.</div>
+</li>
+<li><div> Uncomment the following line and enter the path to the <acronym title="Java Development Kit">JDK</acronym>: <pre>jdkhome=&quot;/path/to/jdk&quot;</pre>
+</div>
+</li>
+</ol>
+
+</div>
+<!-- EDIT8 SECTION "Specifying the JDK location" [2952-3556] -->
 <h3><a>Known Issues</a></h3>
 <div>
 
@@ -142,5 +142,5 @@ For a list of known issues and possible workarounds see the following link:
 </span></div>
 
 </div>
-<!-- EDIT9 SECTION "Known Issues" [3671-] -->
+<!-- EDIT9 SECTION "Known Issues" [3557-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/sdk:troubleshooting?do=export_xhtmlbody">view online version</a></em></p>

sdk/jme3-documentation/src/com/jme3/gde/docs/sdk/version_control.html

@@ -4,7 +4,7 @@
 
 <p>
 
-Whether you work in a development team or alone: File versioning is a handy method to keep your code consistent, compare files line-by-line, and even roll back unwanted changes. This documentation shows you how to make the most of the <acronym title="Software Development Kit">SDK</acronym>&#039;s integrated version control features for Subversion, Mercurial, and <acronym title="Concurrent Versions System">CVS</acronym>.
+Whether you work in a development team or alone: File versioning is a handy method to keep your code consistent, compare files line-by-line, and even roll back unwanted changes. This documentation shows you how to make the most of the <acronym title="Software Development Kit">SDK</acronym>&#039;s integrated version control features for Subversion, Mercurial, and Git.
 </p>
 
 <p>
@@ -31,7 +31,7 @@ Note: Since the jMonkeyEngine <acronym title="Software Development Kit">SDK</acr
 
 <p>
 
-The jMonkeyEngine <acronym title="Software Development Kit">SDK</acronym> supports various Version Control Systems such as Subversion, Mercurial, and <acronym title="Concurrent Versions System">CVS</acronym>. No matter which of them you use, they all share a common user interface.
+The jMonkeyEngine <acronym title="Software Development Kit">SDK</acronym> supports various Version Control Systems such as Subversion, Mercurial, and Git. No matter which of them you use, they all share a common user interface.
 </p>
 
 <p>
@@ -50,7 +50,7 @@ Requirements:
 <ul>
 <li><div> You must have a project that you want to version. </div>
 </li>
-<li><div> You must have version control software installed (Subversion, Mercurial, or <acronym title="Concurrent Versions System">CVS</acronym>) and have initialized a repository.</div>
+<li><div> You must have version control software installed (Subversion, Mercurial, or Git) and have initialized a repository.</div>
 <ul>
 <li><div> Tip: For Subversion, for example, the init command looks like this example: <code>svnadmin create /home/joe/jMonkeyProjects/MyGame</code></div>
 </li>
@@ -70,7 +70,7 @@ Now you create a repository to store your project&#039;s files.
 
 </p>
 <ol>
-<li><div> In the jMonkeyEngine <acronym title="Software Development Kit">SDK</acronym>, right-click the project in the Projects window and choose Versioning &gt; Import Into <acronym title="Concurrent Versions System">CVS</acronym>/Subversion Repository (or initialize Mercurial Project, respectively). </div>
+<li><div> In the jMonkeyEngine <acronym title="Software Development Kit">SDK</acronym>, right-click the project in the Projects window and choose Versioning &gt; Import Into Subversion Repository (or initialize Mercurial Project, etc, respectively). </div>
 <ul>
 <li><div> Tip: If you haven&#039;t evaluated yet which system to choose, start with Subversion for now.</div>
 </li>
@@ -81,7 +81,7 @@ Now you create a repository to store your project&#039;s files.
 </ol>
 
 </div>
-<!-- EDIT3 SECTION "Creating a Repository (Upload)" [1376-2438] -->
+<!-- EDIT3 SECTION "Creating a Repository (Upload)" [1376-2439] -->
 <h2><a>Checking Out a Repository (Download)</a></h2>
 <div>
 
@@ -91,7 +91,7 @@ You and your team mates check out (download) the repository to their individual
 
 </p>
 <ol>
-<li><div> Go to the Team menu and choose Subversion &gt; Checkout (or <acronym title="Concurrent Versions System">CVS</acronym>/Mercurial&gt;Checkout respectively)</div>
+<li><div> Go to the Team menu and choose Subversion &gt; Checkout (or Git or Mercurial respectively)</div>
 </li>
 <li><div> Fill in your repo data into the wizard and click Finish.</div>
 <ul>
@@ -117,7 +117,7 @@ Of course you can also check out existing repositories and access code from othe
 </p>
 
 </div>
-<!-- EDIT4 SECTION "Checking Out a Repository (Download)" [2439-3412] -->
+<!-- EDIT4 SECTION "Checking Out a Repository (Download)" [2440-3407] -->
 <h2><a>Updating and Committing Changes (Send and Receive)</a></h2>
 <div>
 
@@ -156,7 +156,7 @@ Receiving the latest changes from the team&#039;s repository is referred to as <
 </ol>
 
 </div>
-<!-- EDIT5 SECTION "Updating and Committing Changes (Send and Receive)" [3413-4661] -->
+<!-- EDIT5 SECTION "Updating and Committing Changes (Send and Receive)" [3408-4656] -->
 <h2><a>Comparing and Reverting Changes</a></h2>
 <div>
 <ul>
@@ -187,7 +187,7 @@ Receiving the latest changes from the team&#039;s repository is referred to as <
 </ul>
 
 </div>
-<!-- EDIT6 SECTION "Comparing and Reverting Changes" [4662-5453] -->
+<!-- EDIT6 SECTION "Comparing and Reverting Changes" [4657-5448] -->
 <h2><a>No Version Control? Local History!</a></h2>
 <div>
 
@@ -221,5 +221,5 @@ See also:
 </span></div>
 
 </div>
-<!-- EDIT7 SECTION "No Version Control? Local History!" [5454-] -->
+<!-- EDIT7 SECTION "No Version Control? Local History!" [5449-] -->
 <p><em><a href="http://hub.jmonkeyengine.org/wiki/doku.php/sdk:version_control?do=export_xhtmlbody">view online version</a></em></p>

sdk/nbproject/project.properties

@@ -6,7 +6,7 @@ app.icon.icns=jmonkeyplatform.icns
 #version name used for application and settings folder, no spaces!
 app.version=3.0
 #version number used for plugins, only 3 numbers (e.g. 3.1.3)
-plugins.version=3.0.5
+plugins.version=3.0.6
 #used netbeans platform
 netbeans.platform.url=http://download.netbeans.org/netbeans/7.3.1/final/zip/netbeans-7.3.1-201306052037-javase.zip
 #command line args