Changes between Version 69 and Version 70 of content/LevelHowTo

Timestamp:

Nov 2, 2015, 11:06:38 PM (8 years ago)

Author:

fvultier

Comment:

—

content/LevelHowTo

@@ -89 +89 @@
 The StaticEntity defines the model's place and orientation (and some other values). The Model (a cube) is attached to the StaticEntity. With the proper sized collisionshape attached to the StaticEntity you have a "solid" cube. Without a collisionshape, the cube wouldn't be solid and your spaceship could just fly through it. This exampe is quite useful, since you usually can't see a collisionshape's size. If you combine an invisible collisionshape with a fitting model you can see where a collisionshape is for testing purposes. In this special case both the '''scale3D''' and the '''halfExtents''' parameters are identical. To make the collisionshapes visible in the game type "debugDrawPhysics true" in the ingame console.
 
+== Models ==
+A level depends on its models. All finished models are stored in __../data_extern/models__. If you want to view most models in the '''Gallery''' level.
+At the moment we have several asteroids, spaceships, a satellite, two different space stations and some smaller models.
+For test purposes you can use simple models like the cube or the sphere:
+{{{
+#!xml
+<Model mesh="cube.mesh" position="0,0,0" scale=10 />
+<Model mesh="sphere.mesh" position="100,0,0" scale3d="10,20,20" />
+}}}
+The attribute "scale" applies a uniform scale in all directions. By using the attribute "scale3d" you can define different scaling factors for the x-, y- and z-directions.
+
 == MovableEntity - Let's get the world moving ==
 Worldentities can be attached to other worldentities. If you want a model to move in circles, you can create a MovableEntity that rotates and a StaticEntity attached to it. The model that should be rotating is attached to the StaticEntity.
@@ -109 +120 @@
 </MovableEntity>
 }}}
-Note that in this example the Model is created by a lua script that is called in a lua tag. Lua is a scripting language that is a very powerful tool for level design.
-
-== Models ==
-A level depends on its models. All finished models are stored in __../data_extern/models__. If you want to view most models in the '''Gallery''' level.
-At the moment we have several asteroids, spaceships, a satellite, two different space stations and some smaller models.
-For test purposes you can use simple models like the cube or the sphere:
-{{{
-#!xml
-<Model mesh="cube.mesh" position="0,0,0" scale=10 />
-<Model mesh="sphere.mesh" position="100,0,0" scale3d="10,20,20" />
-}}}
-The attribute "scale" applies a uniform scale in all directions. By using the attribute "scale3d" you can define different scaling factors for the x-, y- and z-directions.
+Note that in this example the Model is created by a lua script that is called in a lua tag. Lua is a scripting language that is a very powerful tool for level design. Later in this tutorial you will learn more about lua. Here is anouther example about the MovableEntity class:
+{{{
+#!xml
+<MovableEntity position="0,0,0" rotationrate="45" rotationaxis="0,0,1">
+    <attached>
+        <Model position="0,0,0" mesh="cube.mesh" scale3D="2,2,20" />
+        <MovableEntity position="0,0,0" rotationrate="180" rotationaxis="0,1,0">
+            <attached>
+                <Model position="0,0,0" mesh="sphere.mesh" scale3D="1,1,10" />
+            </attached>
+        </MovableEntity>
+    </attached>
+</MovableEntity>
+}}}
+The first MovableEntity rotates slowly around the z-axis. It has a model of a cube and another MovableEntity attached to it. This second MovableEntity rotates fast around the y-axis. Notice that the first MovableEntity rotates around the global z-axis of the Scene, but the second MovableEntity rotates around the y-axis of its local coordinate system which is relative to its parent (=the first MovableEntity)
+Inside the second MovableEntity there is another Model attached. Every Model is a StaticEntity. So here he have a nesting of WorldEntities with three layers.
+The following example shows how to use a MovableEntity to perform a linear movement.
+{{{
+#!xml
+<MovableEntity position="100,0,0" velocity="0,0,10">
+    <attached>
+        <Model position="0,0,0" mesh="cube.mesh" scale3D="2,2,20" />
+        <MovableEntity position="0,0,0" rotationrate="180" rotationaxis="0,1,0">
+            <attached>
+                <Model position="0,0,0" mesh="sphere.mesh" scale3D="1,1,10" />
+            </attached>
+        </MovableEntity>
+    </attached>
+</MovableEntity>
+}}}
+Linear movement and rotation can also be combined by setting all three parameters (velocity, rotationaxis and rotationrate).
+You might noticed that it is possible to fly through the models. This is because the MovablEntities have no physics. Lets change that:
+{{{
+#!xml
+<MovableEntity position="0,0,0" rotationrate="90" rotationaxis="0,0,1" collisionType="dynamic" mass=10>
+    <attached>
+        <Model position="0,0,0" mesh="cube.mesh" scale3D="40,4,4" />
+    </attached>
+    <collisionShapes>
+        <BoxCollisionShape position="0,0,0" halfExtents="40,4,4" />
+    </collisionShapes>    
+</MovableEntity>
+}}}
+Never forget to change the collisionType to dynamic. Otherwise the collision shapes are useless.
+
+In the next example the rotating MovableEntity damages your spaceship if you touch it.
+{{{
+#!xml
+<MovableEntity position="0,0,0" rotationrate="90" rotationaxis="0,0,1" collisionType="dynamic" mass=1000 collisiondamage=0.02 enablecollisiondamage=true>
+    <attached>
+        <Model position="0,0,0" mesh="cube.mesh" scale3D="40,4,4" />
+    </attached>
+    <collisionShapes>
+        <BoxCollisionShape position="0,0,0" halfExtents="40,4,4" />
+    </collisionShapes>    
+</MovableEntity>
+}}}
+You always need to set both the collisiondamage and the enablecollisiondamage attribute.
 
 == Spawnpoints ==