Fixed broken links and updated to asciidoctor standards.

src/docs/asciidoc/jme3/advanced/level_of_detail.adoc

@@ -4,6 +4,8 @@
 :revdate: 2016/03/17 20:48
 :relfileprefix: ../../
 :imagesdir: ../..
+:experimental:
+:uri-jme3: https://github.com/jMonkeyEngine/jmonkeyengine/blob/master
 ifdef::env-github,env-browser[:outfilesuffix: .adoc]
 
 
@@ -11,9 +13,9 @@ A mesh with a high level of detail has lots of polygons and looks good close up.
 
 One solution for this problem is to use high-detail meshes for objects close to the camera, and low-detail meshes for objects far from the camera. As the player moves through the scene, you must keep replacing close objects by more detailed meshes, and far objects by less detailed meshes. The goal is to keep few high-quality slow-rendering objects in the foreground, and many low-quality fast-rendering objects in the background. (Experienced users can compare this approach to <<jme3/advanced/terrain#,JME's TerraMonkey terrain system>>, which internally uses the specialized GeoMipMapping algorithm to generate a terrain's Levels of Detail.)
 
-You see now why you may want to be able to generate Levels of Detail for complex Geometries automatically. JME3 supports a Java implementation of the Ogre engine's LOD generator (originally by Péter Szücs and Stan Melax): You use link:https://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/tools/jme3tools/optimize/LodGenerator.java[jme3tools.optimize.LodGenerator] in conjunction with link:https://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/core/com/jme3/scene/control/LodControl.java[com.jme3.scene.control.LodControl].
+You see now why you may want to be able to generate Levels of Detail for complex Geometries automatically. JME3 supports a Java implementation of the Ogre engine's LOD generator (originally by Péter Szücs and Stan Melax): You use link:{uri-jme3}/jme3-core/src/tools/java/jme3tools/optimize/LodGenerator.java[jme3tools.optimize.LodGenerator] in conjunction with link:{uri-jme3}/jme3-core/src/main/java/com/jme3/scene/control/LodControl.java[com.jme3.scene.control.LodControl].
 
-For a demo, run link:http://code.google.com/p/jmonkeyengine/source/browse/trunk/engine/src/test/jme3test/stress/TestLodGeneration.java[TestLodGeneration.java] from <<sdk/sample_code#,JmeTests>>, then press +/- and spacebar to experiment. The following screenshots show a monkey model with three reduced Levels of Detail:
+For a demo, run link:{uri-jme3}/jme3-examples/src/main/java/jme3test/stress/TestLodGeneration.java[TestLodGeneration.java] from <<sdk/sample_code#,JmeTests>>, then press +/- and spacebar to experiment. The following screenshots show a monkey model with three reduced Levels of Detail:
 
 image::jme3/advanced/jmonkey-lod.gif[jmonkey-lod.gif,width="",height="",align="center"]
 
@@ -31,7 +33,7 @@ To activate this optimization:
 == Pick Reduction Methods and Values
 
 There are several reduction methods to generate a low-polygon version from a high-polygon model. Don't worry, the reduction does not modify the original model.
-[cols="3", options="header"]
+[cols="35,55,10", options="header"]
 |===
 
 a|Reduction Method
@@ -68,22 +70,27 @@ You must generate and cache several LODs for each mesh, ranging from many to few
 The SDK contains a user-friendly interface to generate LODs for a model (.j3o file).
 
 .  Open the Projects or Files window.
-.  Select the .j3o file in the Project Assets &gt; Models directory.
-.  Choose Window&gt;SceneExplorer if the SceneExplorer is not open. Info about the selected model is now displayed in the SceneExplorer.
-.  Right-click the model in SceneExplorer. Choose the “Tools &gt; Generate Levels of Detail menu. +
-image:jme3/advanced/jme-sdk-generate-lod-menu.png[The &quot;Tools&gt;Generate LOD&quot; context menu in the SceneExplorer,width="300",height="180"]
-.  The “Generate LOD settings wizard opens: +
-image:jme3/advanced/jme-sdk-generate-lod-window.png[The &quot;Generate LOD&quot; settings wizard,width="300",height="150"]
-.  Choose a reduction method and reduction values for one or more levels. +
-Tip: Enter higher reduction values for higher levels.
-.  Click Finish to generate the LODs for this model.
+.  Select the .j3o file in the `Project Assets/Models` directory.
+.  Choose `menu:Window[Edit in SceneExplorer]` if the SceneExplorer is not open. Info about the selected model is now displayed in the SceneExplorer.
+.  btn:[RMB] select the model in SceneExplorer. Choose the `menu:Tools[Generate Levels of Detail]` menu. +
+image:jme3/advanced/jme-sdk-generate-lod-menu.png[The Tools Generate LOD context menu in the SceneExplorer,width="300",height="180"]
+.  The `Generate LOD` settings wizard opens: +
+image:jme3/advanced/jme-sdk-generate-lod-window.png[The Generate LOD settings wizard,width="300",height="150"]
+.  Choose a reduction method and reduction values for one or more levels. 
++
+[TIP]
+====
+Enter higher reduction values for higher levels.
+====
+
+.  Click btn:[Finish] to generate the LODs for this model.
 
 The LODs are saved in the .j3o model file.
 
 
 [TIP]
 ====
-Choose Window>Properties if the Properties window is not open. Choose the generated LODs from the dropdown in the Properties window, and verify their quality in the SceneComposer.
+Choose `menu:Window[Properties]` if the Properties window is not open. Choose the generated LODs from the dropdown in the Properties window, and verify their quality in the SceneComposer.
 ====
 
 
@@ -128,7 +135,7 @@ The LodControl internally gets the camera from the game's viewport to calculate
 
 
 == Impact on Quality and Speed
-[cols="5", options="header"]
+[cols="10,45,15,15,15", options="header"]
 |===
 
 a|Level number
@@ -137,16 +144,15 @@ a|Distance
 a|Rendering Speed
 a|Rendering Quality
 
-a|“Level 0
+a|Level 0
 a|The original mesh is used automatically for close-ups, and it's the default if no LODs have been generated.
 a|Closest
 a|Slowest.
 a|Best.
 
-a|“Level 1 +
-“Level 2 +
-“Level 3 +
-…
+a|Level 1 +
+Level 2 +
+Level 3
 a|If you generated LODs, JME3 uses them automatically as soon as the object moves into the background.
 a|The higher the level, +
 the further away.
@@ -160,7 +166,7 @@ the lower the quality.
 
 == See also
 
-*  link:http://hub.jmonkeyengine.org/forum/topic/brand-new-lod-generator/[http://hub.jmonkeyengine.org/forum/topic/brand-new-lod-generator/]
+*  link:https://hub.jmonkeyengine.org/t/brand-new-lod-generator/26341[https://hub.jmonkeyengine.org/t/brand-new-lod-generator/26341]
 *  link:https://github.com/worldforge/ember/tree/master/src/components/ogre/lod[https://github.com/worldforge/ember/tree/master/src/components/ogre/lod]
 *  link:http://www.melax.com/polychop[http://www.melax.com/polychop]
 *  link:http://sajty.elementfx.com/progressivemesh/GSoC2012.pdf[http://sajty.elementfx.com/progressivemesh/GSoC2012.pdf]