Changes between Version 57 and Version 58 of content/LevelHowTo

Timestamp:

Sep 7, 2015, 2:23:50 PM (10 years ago)

Author:

fvultier

Comment:

—

content/LevelHowTo

@@ -202 +202 @@
 Have a look at "asteroids.oxw" and "theTimeMachine.oxw", to see how to make ForceFields visible in the level.
 
-== Space boundaries ==
+== SpaceBoundaries ==
 If you want to restrict the position of pawns to certain areas, space boundaries may be useful. They are commonly used to avoid that a Pawn leaves the level.
 {{{
@@ -209 +209 @@
 }}}
 
-Have a look at "myTestLevel.oxw" and "SpaceBoundaries.h", to see how space boundaries hork in detail.
+Have a look at "myTestLevel.oxw" and "SpaceBoundaries.h", to see how space boundaries work in detail.
+
+== Portals ==
+Portals allow to teleport through space.
+First you need to place at least two PortalEndPoint. Give each end point a unique id using e.g. id=1. Then you need the PortalLink class to define which PortalEndPoint is connected to which other PortalEndPoint.
+The attribute target of a PortalEndPoint may be used to restrict the classes that can use the PortalEndPoint. By default all Pawn instances can use it. By typeing target="MobileEntity" all MobileEntity instances can use the PortalEndPoint.
+The templates in the example below only hve the purpose to make the end points visible. Use the design attribute of a PortalEndPoint to automatically apply the specified template to it.
+{{{
+#!xml
+<Template name=PortalDefault>
+    <PortalEndPoint>
+        <attached>
+            <Billboard material="Portals/Default" />
+        </attached>
+    </PortalEndPoint>
+</Template>
+
+<Template name=PortalBig>
+    <PortalEndPoint>
+        <attached>
+            <Billboard material="Portals/Big" />
+        </attached>
+    </PortalEndPoint>
+</Template>
+
+<PortalEndPoint position="0,0,0" id="1" distance="40" target="Pawn" design="PortalDefault"/>
+<PortalEndPoint position="-100,0,0" id="2" distance="40" target="MobileEntity" design="PortalBig"/>
+<PortalLink fromID="1" toID="2" />
+<PortalLink fromID="2" toID="1" />
+}}}
+
+Have a look at "Portals.dox", "portals.oxw", "PortalLink.h" and "PortalEndPoint.h", to see how portals work in detail.
 
 == Lua ==