From Blue Mars Developer Guidebook
The AREscalator entity smoothly moves the local avatar in a straight line along with the animated elevator steps. For viewing other clients' avatars riding the elevator, the standard once-per-second avatar position updating is currently used. If the default escalator model is not used and the dimensions of your model differ from the default model, you can use TagPoints to specify the beginning and ending positions of the escalator, as described below.
- file escalator model, an animated .cga
- use our default or supply your own
- float multiplier of the default animation speed
- use a negative value to reverse direction (for a down escalator)
- WalkAwayRotMin, WalkAwayRotMax
- float degrees; the random walk-away point will be picked between Min and Max degrees with respect to the direction of the escalator
- WalkAwayDistMin, WalkAwayDistMax
- float meters; the random walk-away point will be picked between Min and Max meters from the end of the escalator
- using the default values of these properties delimits the walk-away area to a distance of 4 to 7 meters, between 15 degrees to the left and 15 degrees to the right of walking straight away
Custom escalator dimensions require TagPoints to specify the beginning and ending positions of the escalator. They should be set up to form a straight line for the avatar to follow along the animated stairs, which may take some testing and adjusting (if the line is too low, the avatar's knees will bend and if it's too high the avatar will be floating).
- string name of the TagPoint which marks the beginning of the escalator (picture above, TagPoint1)
- For an up escalator, this will be at the bottom. For a down escalator, this will be at the top.
- string name of the TagPoint which marks the end of the escalator. For an up escalator, this will be at the top. For a down escalator, this will be at the bottom.
- bool determines whether to use TagPoint_begin and TagPoint_end to specify the beginning and end of the escalator
- These custom properties should be used for a model of different dimensions than the Beach City escalator
1. Place an AREscalator entity in the level from the RollupBar, pictured above
2. Setup a trigger entity by placing either of these entities:
- an ARAvatarTrigger near the beginning of the escalator (with the OnlyLocalAvatar Property set to true) - an avatar will start riding the escalator upon walking into this area
- or, a selectable ARItem - an avatar will start riding the escalator upon clicking the item
3. Setup an event to trigger the escalator in the FlowGraph - activate the AREscalator's Enter input
- connect the ARAvatarTrigger's Enter output to the AREscalator's Enter input
- or, connect the ARItem's Select output to the AREscalator's Enter input
- starts moving the local avatar along the animated escalator (after checking if the local avatar entity matches the entity sent to the input node)
- causes the local avatar to jump to the end of the escalator and exit
- output is activated upon reaching the top of the escalator and exiting