jMonkeyEngine 3 Tutorial (2) - Hello Node

Пример кода

package jme3test.helloworld;
 
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.Node;
import com.jme3.scene.shape.Box;
 
/** Пример 2 - использование узлов (nodes) для манипуляции объектами на сцене.
 * Можно поворачивать, перемещать и масштабировать объекты, изменяя их родительские узлы (parent nodes).
 * Корневой узел (Root Node) это особый узел: на сцене отображается только то, что прикреплено к корневому узлу. */
public class HelloNode extends SimpleApplication {
 
    public static void main(String[] args){
        HelloNode app = new HelloNode();
        app.start();
    }
 
    @Override
    public void simpleInitApp() {
 
        /** создаем синий куб в координатах (1,-1,1) */
        Box box1 = new Box(1,1,1);
        Geometry blue = new Geometry("Box", box1);
        blue.setLocalTranslation(new Vector3f(1,-1,1));
        Material mat1 = new Material(assetManager, 
                "Common/MatDefs/Misc/Unshaded.j3md");
        mat1.setColor("Color", ColorRGBA.Blue);
        blue.setMaterial(mat1);
 
        /** создаем красный куб в координатах (1,3,1) прямо над синим */
        Box box2 = new Box(1,1,1);      
        Geometry red = new Geometry("Box", box2);
        red.setLocalTranslation(new Vector3f(1,3,1));
        Material mat2 = new Material(assetManager, 
                "Common/MatDefs/Misc/Unshaded.j3md");
        mat2.setColor("Color", ColorRGBA.Red);
        red.setMaterial(mat2);
 
        /** создаем узел (node) под названием pivot в координатах (0,0,0) и прикрепляем его к rootNode */
        Node pivot = new Node("pivot");
        rootNode.attachChild(pivot); // добавляем узел на сцену
 
        /** Прикрепляем кубы к узлу pivot, а значит и к rootNode (транзитивность в действии). */
        pivot.attachChild(blue);
        pivot.attachChild(red);
        /** поворачиваем узел pivot и обращаем внимание что при этом повернутся оба куба.*/
        pivot.rotate(.4f,.4f,0f);
    }
}

Усваиваем терминологию

Разбираем код

Создание геометрии для первого куба.

    Box box1 = new Box(1,1,1);
    Geometry blue = new Geometry("Box", box1);
    blue.setLocalTranslation(new Vector3f(1,-1,1));
    Material mat1 = new Material(assetManager,"Common/MatDefs/Misc/Unshaded.j3md");
    mat1.setColor("Color", ColorRGBA.Blue);
    blue.setMaterial(mat1);

Создание геометрии для второго куба.

    Box box2 = new Box(1,1,1);
    Geometry red = new Geometry("Box", box2);
    red.setLocalTranslation(new Vector3f(1,3,1));
    Material mat2 = new Material(assetManager,
      "Common/MatDefs/Misc/Unshaded.j3md");
    mat2.setColor("Color", ColorRGBA.Red);
    red.setMaterial(mat2);

Создание узла (node) pivot

        Node pivot = new Node("pivot");
        rootNode.attachChild(pivot);

Прикрепление двух кубов к узлу(node) pivot

        pivot.attachChild(blue);
        pivot.attachChild(red);

Поворот узла(node) pivot.

        pivot.rotate( 0.4f , 0.4f , 0.0f );

Подробнее о точках поворота (pivot node)

Заполнение сцены (примеры)

Создание пространственного объекта (spatial)

Box mesh = new Box(Vector3f.ZERO, 1, 1, 1);
Geometry thing = new Geometry("thing", mesh); 
Material mat = new Material(assetManager,
   "Common/MatDefs/Misc/ShowNormals.j3md");
thing.setMaterial(mat);

Отображение объекта на сцене

rootNode.attachChild(thing);

Удаление объекта со сцены

rootNode.detachChild(thing);

rootNode.detachAllChildren();

thing.removeFromParent();

Поиск объекта по имени, id, позиции в иерархии.

Spatial thing = rootNode.getChild("thing");

Spatial twentyThird = rootNode.getChild(22);

Spatial parent = myNode.getParent();

Начальная загрузка сцены

Трансформация пространственных объектов (​Spatials)

Translation

thing.setLocalTranslation( new Vector3f( 0.0f, 40.2f, -2.0f ) );

thing.move( 0.0f, 40.2f, -2.0f );

Scaling

thing.scale( 10.0f, 0.1f, 1.0f );
thing.setLocalScale( 10.0f, 0.1f, 1.0f );

Rotation

thing.rotate( 0f , 0f , 180*FastMath.DEG_TO_RAD );

thing.setLocalRotation( 
  new Quaternion().fromAngleAxis(180*FastMath.DEG_TO_RAD, new Vector3f(1,0,0)));

Решение проблем с пространственными объектами (​Spatials)

Геометрия не появляется на сцене

Поворот пространственного объекта(spatial) дает неожиданные результаты

Геометрия отображается с неожиданным цветом или материалом

Добавление пользовательских данных к пространственным объектам (​Spatials)

pivot.setUserData( "pivot id", 42 );

int id = pivot.getUserData( "pivot id" ); 

Заключение