Browse Source

Update 3d_models.adoc

Added Blender buffer clearing.
mitm001 8 years ago
parent
commit
4fb8471e18
1 changed files with 33 additions and 1 deletions
  1. 33 1
      src/docs/asciidoc/jme3/advanced/3d_models.adoc

+ 33 - 1
src/docs/asciidoc/jme3/advanced/3d_models.adoc

@@ -16,7 +16,7 @@ Like <<jme3/advanced/shape#,Shape>>s, 3D models are also made up of <<jme3/advan
 To use 3D models in a jME3 application:
 
 .  Export the 3D model in Ogre XML or Wavefront OBJ format. Export Scenes as Ogre DotScene format.
-.  Save the files into a sub-directory of your jME3 `Project Assets` directory.
+.  Save the files into a sub-directory of your jME3 `Assets` directory.
 .  In your code, you use the <<jme3/advanced/asset_manager#,Asset Manager>> to load models as <<jme3/advanced/spatial#,Spatial>>s into a jME application.
 +
 [source,java]
@@ -63,3 +63,35 @@ To export your models as Ogre XML meshes with materials:
 .  Click Export Ogre.
 
 You can now use the <<sdk#,jMonkeyEngine SDK>> to <<sdk/model_loader_and_viewer#,load and view models>>. You can <<sdk/scene_composer#,create scenes>> from them and write code that loads them into your application. 
+
+
+== Blender Buffer Clearing
+
+
+Before exporting your Blender models, its is recommended that you clean the buffers of any un-needed `Action`, `Material`, `Texture` or `UV Images`. This is a straight forward process that only takes a few minutes. Failure to do so can lead you into a morasse of problems, like having more than one AnimControl, duplicate materials and textures, wasted space from worthless images, just to mention a few potential troubles.
+
+You clear the Blender `Material`, `Texture`, `UV Image` buffers as follows:
+
+.  Select the btn:[Browse] button located next to the material, texture or UV Image name to load the item to be cleared.
+.  While holding kbd:[Shift] down, click the btn:[X] button, also known as the btn:[Unlink datablock] button, located next to the loaded item. A item that is unlinked will show a `0` before it when viewed by selecting the btn:[Browse] button and will not be saved if you exit Blender.
+.  Save your file.
+.  From the `Info` header select `menu:File[Open Recent > Your Saved File]`, to close and re-open your file.
+
+The exception to this rule is the `Linked Action` buffer, for animations, located in the `Dope Sheet Editor`. 
+
+To clear this buffer:
+
+.  In the `Dope Sheet Editor`, change the context to `Action Editor`.
+.  Click the `Action to be linked` button and select the action you want cleared.
+.  Deselect the btn:[F] button to prevent it from saving.
+.  Change the editor type from `Dope Sheet` to `NLA Editor`. You will see the action listed.
+.  Click the btn:[Double Down Arrow] button next to the action to push it into the stack.
+.  Click the small start next to the track name.
+.  With the mouse inside the `NLA Track List`,  press kbd:[X] to delete both the track and strip.
+.  Save your file.
+.  From the `Info` header, select `menu:File[Open Recent > Your Saved File]`.
+.  Save your file again.
+.  From the `Info` header, select `menu:File[Open Recent > Your Saved File]` again.
+.  Change back to the `Dope Sheet Editor`.
+.  Click the btn:[Browse Action to be linked] button and you will see only the baked action remains and the buffer is now clear of unwanted actions. Select your action.
+.  Save your file.