Changes between Version 60 and Version 61 of content/LevelHowTo

Timestamp:

Sep 8, 2015, 5:37:04 PM (9 years ago)

Author:

fvultier

Comment:

—

content/LevelHowTo

@@ -147 +147 @@
 }}}
 
+== WaypointController ==
+So far we used only the classes StaticEntity and MovableEntity. There is another important WorldEntity derivative you should know: the ControllableEntity. A ControllableEntity is controlled by a controller (an instance of the class Controller). This controller executes steering commands on the ControllableEntity.
+By using Controller and ControllableEntity you can create objects that move in the space along any path you like.
+The simplest case of a Controller is the WaypointController:
+{{{
+#!xml
+<SpaceShip position="300,0,0" lookat="0,0,0" team=3>
+    <templates>
+        <Template link=spaceshipescort />
+    </templates>
+    <controller>
+        <WaypointPatrolController accuracy=10 team=3>
+            <waypoints>
+                <Model mesh="cube.mesh" scale=8 position="300,0,0" />
+                <Model mesh="cube.mesh" scale=8 position="300,500,0" />
+                <Model mesh="cube.mesh" scale=8 position="0,500,0" />
+                <StaticEntity position="0,0,0" />
+            </waypoints>
+        </WaypointPatrolController>
+    </controller>
+</SpaceShip>
+}}}
+In this example the SpaceShip (The SpaceShip class is a derivative of the ControllableEntity class) is controlled by a WaypointController. The ship will fly from its starting position to the first cube. There it will change its direction and fly to the second cube ... When the SpaceShip arrived at the last waypoint in the list it will continue at the top of the list again.
+If you want the waypoints to be invisible just replace Model by StaticEntity as done for the last waypoint in the list above.
+
+Take a look at the "waypoints.oxw" level to learn more about the WaypointController.
+
 == [http://www.orxonox.net/doxygen/classorxonox_1_1_pickup_spawner.html Pickups]  ==
 Pickups give a player a temporary bonus when collecting it. Bonuses are invisibility, health, boost,  shield, a drone, ...
@@ -217 +244 @@
 
 Have a look at "myTestLevel.oxw" and "SpaceBoundaries.h", to see how space boundaries work in detail.
+
+== Planets ==
+Planets are a nice addition to many levels. Use the Planet class to add a planet to a level.
+{{{
+#!xml
+<Planet
+      position="10000,0,0"
+      scale="100"
+      collisionType="dynamic"
+      linearDamping="0.8"
+      angularDamping="0"
+      mass="5000000"
+      pitch="0"
+      mesh="planets/muunilinst.mesh"
+      atmosphere="atmosphere1"
+      rotationaxis="1,0,0"
+      rotationrate="1.0"
+      atmospheresize="80.0f"
+      imagesize="1024.0f"
+      collisiondamage = 2
+      enablecollisiondamage = true
+    >
+    <attached>
+        <ForceField position="0,0,0" mode="sphere" diameter="1000" velocity="-500" />
+    </attached>
+    <collisionShapes>
+        <SphereCollisionShape radius="100" position="0,0,0" />
+    </collisionShapes>
+</Planet>
+}}}
+
+Notice that in this example there is a force field attached to the planet to simulate gravitation. The planet also has a collision shape.
+Have a look at "planets.oxw" and "Planet.h", to see how planets work in detail.
 
 == Portals ==