java
/
jMonkeyEngine-wiki
огледало от https://github.com/jMonkeyEngine/wiki.git


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233
							<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]--><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="Asciidoctor 1.5.4"><meta name="keywords" content="documentation, sdk, scene, node, asset, light, effect"><title>jMonkeyEngine SDK: Scene Composer</title><link rel="stylesheet" href="./asciidoctor.css">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.5.0/css/font-awesome.min.css">
<link rel="stylesheet" href="./coderay-asciidoctor.css"><link rel="stylesheet" href="https://cdn.jsdelivr.net/docsearch.js/2/docsearch.min.css"><link rel="stylesheet" href="/home/travis/build/jMonkeyEngine/wiki/build/asciidoc/html5/sdk/twemoji-awesome.css"></head><body class="article toc2 toc-left"><div id="header"><div id="toolbar"><a href="https://github.com/jMonkeyEngine/wiki/edit/master/src/docs/asciidoc/sdk/scene_composer.adoc"><i class="fa fa-pencil-square" aria-hidden="true"></i></a><a href="https://github.com/jMonkeyEngine/wiki/new/master/src/docs/asciidoc/sdk/"><i class="fa fa-plus-square" aria-hidden="true"></i></a><input dir="auto" style="position: relative; vertical-align: top;" spellcheck="false" autocomplete="off" class="searchbox__input aa-input" id="doc-search" name="search" placeholder="Search in the doc" required="required" type="search"></div><h1>jMonkeyEngine SDK: Scene Composer</h1><div class="details"><span class="author" id="author"></span><br><span id="revnumber">version ,</span> <span id="revdate">2016/03/17 20:48</span></div><div id="toc" class="toc2"><div id="toctitle">Table of Contents</div><ul class="sectlevel1"><li><a href="#mouse-cursor-controls">Mouse/Cursor Controls</a></li><li><a href="#creating-a-scene-file">Creating a scene file</a></li><li><a href="#loading-the-scene">Loading the scene</a></li><li><a href="#adding-light-to-the-scene">Adding light to the scene</a></li><li><a href="#adding-effects-etc-to-the-scene">Adding effects etc. to the scene</a></li><li><a href="#adding-models-to-the-scene">Adding Models to the scene</a></li><li><a href="#linking-models-to-the-scene">Linking Models to the scene</a></li><li><a href="#saving-the-scene">Saving the Scene</a></li></ul></div></div><div id="content"><div id="preamble"><div class="sectionbody"><div class="paragraph"><p>SceneComposer allows you to edit scenes stored in j3o files and add content or modify existing content. Please note that the Scene Composer and Explorer are a work in progress and will provide more powerful functions in the future. Also other plugins will allow creation of more specific game type scenes in jMonkeyEngine SDK.</p></div>
<div class="paragraph"><p>Most buttons in the SceneComposer have tooltips that appear when you hover the mouse over the button for a short while.</p></div></div></div>
<div class="sect1"><h2 id="mouse-cursor-controls">Mouse/Cursor Controls</h2><div class="sectionbody"><div class="ulist"><ul><li><p>Left-click and drag to rotate the camera around the cam center</p></li><li><p>Right-click and drag to move the cam center</p></li><li><p>Scoll the mouse wheel to zoom in/out the cam center</p></li><li><p>Left-click a geometry to select it</p></li><li><p>Right-click a geometry to place the cursor</p></li></ul></div>
<div class="paragraph"><p>In the SceneComposer toolbar are buttons to snap the camera to the cursor, snap the cursor to the selection and etc.</p></div></div></div>
<div class="sect1"><h2 id="creating-a-scene-file">Creating a scene file</h2><div class="sectionbody"><div class="paragraph"><p>The jMonkeyEngine SDK stores the scene in a j3o file, this binary file contains the whole scenegraph including all settings for spatials, materials, physics, effects etc. Textures are not stored in the j3o file but as absolute locators to the textures.</p></div>
<div class="paragraph"><p>To create a blank scene file do the following:</p></div>
<div class="olist arabic"><ol class="arabic"><li><p>Right click the “Scenes folder in your Project Assets and select “New→Other</p></li><li><p>Select “Scene to the left then select “Empty jME3 Scene and press “Next</p></li><li><p>Enter a file name for your scene like “MyScene and press “OK</p></li></ol></div></div></div>
<div class="sect1"><h2 id="loading-the-scene">Loading the scene</h2><div class="sectionbody"><div class="imageblock right"><div class="content"><img src="../sdk/jmonkeyplatform-docu-2.png" alt="jmonkeyplatform-docu-2.png" width="421" height="298"></div></div>
<div class="paragraph"><p>To open a scene</p></div>
<div class="olist arabic"><ol class="arabic"><li><p>In the Project Explorer, right-click the *.j3o file of the scene</p></li><li><p>Choose “Open in SceneComposer</p></li></ol></div>
<div class="paragraph"><p>Now the SceneComposer window opens at the bottom and displays the scene in the SceneViewer. The SceneExplorer displays the contained scene graph as a tree and when selecting a node, you can edit the properties of the corresponding scene graph object in the Properties window.</p></div>
<div class="paragraph"><p>For now, you only see the cursor in the SceneViewer and a single node (the root node of the scene) in the SceneExplorer.</p></div></div></div>
<div class="sect1"><h2 id="adding-light-to-the-scene">Adding light to the scene</h2><div class="sectionbody"><div class="olist arabic"><ol class="arabic"><li><p>Select the root node in the SceneExplorer</p></li><li><p>Select “Directional Light in the SceneComposer window</p></li><li><p>Press the “+ button in the SceneComposer window</p></li></ol></div>
<div class="paragraph"><p>A directional light has been added to your scene, you can see it in the SceneExplorer.</p></div></div></div>
<div class="sect1"><h2 id="adding-effects-etc-to-the-scene">Adding effects etc. to the scene</h2><div class="sectionbody"><div class="paragraph"><p>You can add a variety of special objects with the SceneComposer, including lights, effects, audio etc.</p></div>
<div class="olist arabic"><ol class="arabic"><li><p>Select root Node in the SceneExplorer</p></li><li><p>Select the object type in the list displayed in the SceneComposer window</p></li><li><p>Press the “+ cursor button in the SceneComposer window</p></li></ol></div></div></div>
<div class="sect1"><h2 id="adding-models-to-the-scene">Adding Models to the scene</h2><div class="sectionbody"><div style="text-align: right;" class="imageblock right"><div class="content"><img src="../sdk/jmonkeyplatform-docu-3.png" alt="jmonkeyplatform-docu-3.png" width="421" height="298"></div></div>
<div class="paragraph"><p>You can directly import 3d models to your scene so that they will be part of your scene file. To be able to import for example an OgreXML file, first export it from your 3D editor to a separate folder in the assets folder of your project (e.g. assets/Models/MyModel/).</p></div>
<div class="olist arabic"><ol class="arabic"><li><p>Place the SceneComposer cursor where you want the model to be</p></li><li><p>Select the parent Node for the model in the SceneExplorer</p></li><li><p>In the Project Explorer right-click the model file you want to import</p></li><li><p>Choose “Add to SceneComposer</p></li></ol></div>
<div class="paragraph"><p>Note that when importing a model the texture paths are stored absolute, so the folder you import the model from will later only be a textures folder because the original model file is not included in the release.</p></div>
<div class="paragraph"><p>Also note that when adding models this way, changes in the original model file will not be reflected in the scene file as its a complete copy of the original file. If you change the original model, delete the models node from the scene and import it again.</p></div></div></div>
<div class="sect1"><h2 id="linking-models-to-the-scene">Linking Models to the scene</h2><div class="sectionbody"><div class="paragraph"><p>You can also link models/objects into your scene, this way they are reloaded dynamically from the other/original file.</p></div>
<div class="olist arabic"><ol class="arabic"><li><p>Place the SceneComposer cursor where you want the model to be</p></li><li><p>Select the parent Node for the model in the SceneExplorer</p></li><li><p>In the Project Explorer right-click the model file you want to link</p></li><li><p>Choose “Link in SceneComposer</p></li></ol></div>
<div class="paragraph"><p>Note that when linking objects this way, you cannot edit them as part of the scene. To change the model you have to change the original j3o file.</p></div>
<div class="paragraph"><p>Also note that although it its possible to directly link external model files (OgreXML, OBJ etc.), this is not recommended. Convert the original file to a j3o file by right-clicking it and selecting “Convert to jME Binary before linking it. This is required because the original model files are not included in the release version of the application.</p></div></div></div>
<div class="sect1"><h2 id="saving-the-scene">Saving the Scene</h2><div class="sectionbody"><div class="paragraph"><p>When a scene has been changed, press the “save button in the main toolbar or press [Ctrl-S] / [Apple-S] to save it.</p></div></div></div></div><div id="footer"><div id="footer-text">Version <br>Last updated 2019-12-19 19:32:51 +00:00</div></div><script type="text/javascript" src="https://cdn.jsdelivr.net/docsearch.js/2/docsearch.min.js"></script><script>docsearch({
  apiKey: 'a736b6d93de805e26ec2f49b55013fbd',
  indexName: 'jmonkeyengine',
  inputSelector: '#doc-search',
  debug: false // Set debug to true if you want to inspect the dropdown
});</script></body></html>