I love the smell of UnrealEd crashing in the morning. – tarquin

Difference between revisions of "UE2:Mover states (UT2004)"

From Unreal Wiki, The Unreal Engine Documentation Site
Jump to: navigation, search
(Auto-generated page)
 
(grouped selectable states and added state descriptions)
Line 5: Line 5:
 
| parent2 = Object
 
| parent2 = Object
 
}}
 
}}
{{autogenerated}}
+
The different states of a mover control, how the mover is activated.
==States==
+
 
 +
==Selectable initial states==
 +
One of the following states should be selected as the {{tl|InitialState||Actor properties}} of the mover.
 +
 
 
===BumpButton===
 
===BumpButton===
<!-- enter state description -->
+
Open when bumped, close when reset.
 +
 
 +
Unlike {{tl|BumbOpenTimed}}, the mover will to the {{tl|WasBumpButton}} state instead of closing again. Only when the mover is reset, e.g. at the end of an Assault or Onslaught round, it will return to its initial position.
  
 
====BumpButton.BeginEvent====
 
====BumpButton.BeginEvent====
Line 32: Line 37:
  
 
===BumpOpenTimed===
 
===BumpOpenTimed===
<!-- enter state description -->
+
Open when bumped, wait, then close. This is the default state. Note that {{tl|StandOpenTimed}} works better for "automatic" elevators.
  
 
'''Extends:''' {{tl|OpenTimedMover}}
 
'''Extends:''' {{tl|OpenTimedMover}}
Line 58: Line 63:
  
 
===ConstantLoop===
 
===ConstantLoop===
<!-- enter state description -->
+
The mover loops through its key frames right away. Depending on the value of {{tl|bOscillatingLoop||Mover properties}}, it either goes forward and reversed when the last key is reached (''True'') or directly moves from the last to the first key. (''False'')
  
 
====ConstantLoop.BeginState====
 
====ConstantLoop.BeginState====
Line 75: Line 80:
  
 
===LeadInOutLooper===
 
===LeadInOutLooper===
<!-- enter state description -->
+
Similar to {{tl|ConstantLoop}}, except that key 0 serves as idle position. When the mover is triggered, it moves to key 1 and loops the remaining keys. Depending on the value of {{tl|bOscillatingLoop||Mover properties}}, it either goes forward and reversed when the last key is reached (''True'') or directly moves from the last to the first loop key, i.e. key 1. (''False'') When the mover is triggered again, it goes directly back to key 0.
  
 
====LeadInOutLooper.BeginState====
 
====LeadInOutLooper.BeginState====
Line 92: Line 97:
  
 
====LeadInOutLooper.Trigger====
 
====LeadInOutLooper.Trigger====
{{code|event '''Trigger''' ({{cl|Actor}}&nbsp;'''Other''', {{cl|Pawn}}&nbsp;'''EventInstigator''')}}
 
 
'''Overrides:''' {{tl|Trigger|Actor|events}} ''(global)''
 
 
<!-- enter function description -->
 
 
===LeadInOutLooping===
 
<!-- enter state description -->
 
 
====LeadInOutLooping.KeyFrameReached====
 
{{code|event '''KeyFrameReached''' ()}}
 
 
'''Overrides:''' {{tl|KeyFrameReached||Mover}} ''(global)''
 
 
<!-- enter event description -->
 
 
====LeadInOutLooping.Trigger====
 
 
{{code|event '''Trigger''' ({{cl|Actor}}&nbsp;'''Other''', {{cl|Pawn}}&nbsp;'''EventInstigator''')}}
 
{{code|event '''Trigger''' ({{cl|Actor}}&nbsp;'''Other''', {{cl|Pawn}}&nbsp;'''EventInstigator''')}}
  
Line 116: Line 104:
  
 
===LoopMove===
 
===LoopMove===
<!-- enter state description -->
+
Loops through its keys if triggered, stops at the next key if untriggered.
  
 
====LoopMove.BeginState====
 
====LoopMove.BeginState====
Line 150: Line 138:
  
 
'''Overrides:''' {{tl|SelfTriggered||Mover}} ''(global)''
 
'''Overrides:''' {{tl|SelfTriggered||Mover}} ''(global)''
 
<!-- enter function description -->
 
 
===OpenTimedMover===
 
<!-- enter state description -->
 
 
====OpenTimedMover.BeginState====
 
{{code|event '''BeginState''' ()}}
 
 
'''Overrides:''' {{tl|BeginState|Object}} ''(global)''
 
 
<!-- enter function description -->
 
 
====OpenTimedMover.Reset====
 
{{code|function '''Reset''' ()}}
 
 
'''Overrides:''' {{tl|Reset||Mover}} ''(global)''
 
 
<!-- enter function description -->
 
 
====OpenTimedMover.ShouldReTrigger====
 
{{code|function [[bool]]&nbsp;'''ShouldReTrigger''' ()}}
 
  
 
<!-- enter function description -->
 
<!-- enter function description -->
  
 
===RotatingMover===
 
===RotatingMover===
<!-- enter state description -->
+
A simple rotating state. Most useful for slaves of open-timed movers as it will start rotating if the master mover starts opening, stop rotating when the master has opened and reverse the rotation direction when the master closes again.
  
 
====RotatingMover.BeginState====
 
====RotatingMover.BeginState====
Line 200: Line 166:
  
 
===StandOpenTimed===
 
===StandOpenTimed===
<!-- enter state description -->
+
Open when stood on, wait, then close. The most-used state for automatic elevators.
  
 
'''Extends:''' {{tl|OpenTimedMover}}
 
'''Extends:''' {{tl|OpenTimedMover}}
Line 238: Line 204:
  
 
===TriggerAdvance===
 
===TriggerAdvance===
<!-- enter state description -->
+
Open when triggered, stop when untriggered, close when reset.
 +
 
 +
This is mostly used in Assault maps for doors and levers that slowly open/activate while a player is nearby. Player proximity is not checked by the mover itself, but by a {{cl|Trigger}} or other triggering/untriggering actor. The mover will only return to its initial position if it is reset, e.g. at the start of a new Assault or Onslaught round.
  
 
====TriggerAdvance.BeginState====
 
====TriggerAdvance.BeginState====
Line 283: Line 251:
  
 
===TriggerControl===
 
===TriggerControl===
<!-- enter state description -->
+
Open when triggered, close when get untriggered.
 +
 
 +
Like {{tl|TriggerAdvance}}, this state requires a {{cl|Trigger}} or other triggering/untriggering actor. Can be used e.g. for doors that stay open while a player is nearby.
  
 
====TriggerControl.BeginState====
 
====TriggerControl.BeginState====
Line 321: Line 291:
  
 
===TriggerOpenTimed===
 
===TriggerOpenTimed===
<!-- enter state description -->
+
When triggered, open, wait, then close.
 +
 
 +
Used for special doors that only stay open for a certain time but shouldn't react to player bumping. This state is also recommended for {{tl|bDamageTriggered||Mover properties}} movers.
  
 
'''Extends:''' {{tl|OpenTimedMover}}
 
'''Extends:''' {{tl|OpenTimedMover}}
Line 354: Line 326:
  
 
===TriggerPound===
 
===TriggerPound===
<!-- enter state description -->
+
Starts opening and closing when triggered. Stops when closed after untriggering.
  
 
====TriggerPound.BeginState====
 
====TriggerPound.BeginState====
Line 392: Line 364:
  
 
===TriggerToggle===
 
===TriggerToggle===
<!-- enter state description -->
+
Opens when triggered, closes when triggered again.
  
 
====TriggerToggle.Trigger====
 
====TriggerToggle.Trigger====
Line 412: Line 384:
  
 
'''Overrides:''' {{tl|SelfTriggered||Mover}} ''(global)''
 
'''Overrides:''' {{tl|SelfTriggered||Mover}} ''(global)''
 +
 +
<!-- enter function description -->
 +
 +
==Internal states==
 +
These are secondary states the mover will switch to in certain situations. Some of them also serve as base for other states with similar behavior.
 +
 +
===LeadInOutLooping===
 +
Active state for {{tl|LeadInOutLooper}}.
 +
 +
====LeadInOutLooping.KeyFrameReached====
 +
{{code|event '''KeyFrameReached''' ()}}
 +
 +
'''Overrides:''' {{tl|KeyFrameReached||Mover}} ''(global)''
 +
 +
Moves to the next key in sequence.
 +
 +
====LeadInOutLooping.Trigger====
 +
{{code|event '''Trigger''' ({{cl|Actor}}&nbsp;'''Other''', {{cl|Pawn}}&nbsp;'''EventInstigator''')}}
 +
 +
'''Overrides:''' {{tl|Trigger|Actor|events}} ''(global)''
 +
 +
Moves to key 0, then returns to {{tl|LeadInOutLooper}} state.
 +
 +
===OpenTimedMover===
 +
Base state for {{tl|BumpOpenTimed}}, {{tl|StandOpenTimed}} and {{tl|TriggerOpenTimed}} mover.
 +
 +
====OpenTimedMover.BeginState====
 +
{{code|event '''BeginState''' ()}}
 +
 +
'''Overrides:''' {{tl|BeginState|Object}} ''(global)''
 +
 +
<!-- enter function description -->
 +
 +
====OpenTimedMover.Reset====
 +
{{code|function '''Reset''' ()}}
 +
 +
'''Overrides:''' {{tl|Reset||Mover}} ''(global)''
 +
 +
<!-- enter function description -->
 +
 +
====OpenTimedMover.ShouldReTrigger====
 +
{{code|function [[bool]]&nbsp;'''ShouldReTrigger''' ()}}
  
 
<!-- enter function description -->
 
<!-- enter function description -->
  
 
===WasBumpButton===
 
===WasBumpButton===
<!-- enter state description -->
+
Disabled state for {{tl|BumpButton}} mover.
  
 
====WasBumpButton.Reset====
 
====WasBumpButton.Reset====
Line 423: Line 437:
 
'''Overrides:''' {{tl|Reset||Mover}} ''(global)''
 
'''Overrides:''' {{tl|Reset||Mover}} ''(global)''
  
<!-- enter function description -->
+
Returns to {{tl|BumpButton}} state.
  
 
===WasOpenTimedMover===
 
===WasOpenTimedMover===
<!-- enter state description -->
+
Disabled state for trigger-once {{tl|BumpOpenTimed}}, {{tl|StandOpenTimed}} and {{tl|TriggerOpenTimed}} movers.
  
 
====WasOpenTimedMover.Reset====
 
====WasOpenTimedMover.Reset====
Line 433: Line 447:
 
'''Overrides:''' {{tl|Reset||Mover}} ''(global)''
 
'''Overrides:''' {{tl|Reset||Mover}} ''(global)''
  
<!-- enter function description -->
+
Returns to the original open-timed state.
  
 
===WasTriggerAdvance===
 
===WasTriggerAdvance===
<!-- enter state description -->
+
Final state of fully-opened {{tl|TriggerAdvance}} mover.
  
 
====WasTriggerAdvance.Reset====
 
====WasTriggerAdvance.Reset====
Line 443: Line 457:
 
'''Overrides:''' {{tl|Reset||Mover}} ''(global)''
 
'''Overrides:''' {{tl|Reset||Mover}} ''(global)''
  
<!-- enter function description -->
+
Returns to {{tl|TriggerAdvance}} state.
  
 
====WasTriggerAdvance.SelfTriggered====
 
====WasTriggerAdvance.SelfTriggered====
Line 453: Line 467:
  
 
===WasTriggerControl===
 
===WasTriggerControl===
<!-- enter state description -->
+
Final state of fully-opened trigger-once {{tl|TriggerControl}} mover.
  
 
====WasTriggerControl.Reset====
 
====WasTriggerControl.Reset====
Line 460: Line 474:
 
'''Overrides:''' {{tl|Reset||Mover}} ''(global)''
 
'''Overrides:''' {{tl|Reset||Mover}} ''(global)''
  
<!-- enter function description -->
+
Returns to {{tl|TriggerControl}} state.
  
 
====WasTriggerControl.SelfTriggered====
 
====WasTriggerControl.SelfTriggered====
Line 470: Line 484:
  
 
===WasTriggerPound===
 
===WasTriggerPound===
<!-- enter state description -->
+
Disabled state of trigger-once {{tl|TriggerPound}} mover that opened and closed once.
  
 
====WasTriggerPound.Reset====
 
====WasTriggerPound.Reset====
Line 477: Line 491:
 
'''Overrides:''' {{tl|Reset||Mover}} ''(global)''
 
'''Overrides:''' {{tl|Reset||Mover}} ''(global)''
  
<!-- enter function description -->
+
Returns to {{tl|TriggerPound}} state.

Revision as of 16:27, 12 December 2008

UT2004 Object >> Actor >> Mover (states)

Contents

Mover states in other games:
UT2003
Other member categories for this class:
properties

The different states of a mover control, how the mover is activated.

Selectable initial states

One of the following states should be selected as the InitialState of the mover.

BumpButton

Open when bumped, close when reset.

Unlike BumbOpenTimed, the mover will to the WasBumpButton state instead of closing again. Only when the mover is reset, e.g. at the end of an Assault or Onslaught round, it will return to its initial position.

BumpButton.BeginEvent

event BeginEvent ()

Overrides: Actor.BeginEvent (global)


BumpButton.Bump

event Bump (Actor Other)

Overrides: Bump (global)


BumpButton.EndEvent

event EndEvent ()

Overrides: Actor.EndEvent (global)


BumpOpenTimed

Open when bumped, wait, then close. This is the default state. Note that StandOpenTimed works better for "automatic" elevators.

Extends: OpenTimedMover

BumpOpenTimed.Bump

event Bump (Actor Other)

Overrides: Bump (global)


BumpOpenTimed.DisableTrigger

function DisableTrigger ()

Overrides: DisableTrigger (global)


BumpOpenTimed.EnableTrigger

function EnableTrigger ()

Overrides: EnableTrigger (global)


ConstantLoop

The mover loops through its key frames right away. Depending on the value of bOscillatingLoop, it either goes forward and reversed when the last key is reached (True) or directly moves from the last to the first key. (False)

ConstantLoop.BeginState

event BeginState ()

Overrides: Object.BeginState (global)


ConstantLoop.KeyFrameReached

event KeyFrameReached ()

Overrides: KeyFrameReached (global)


LeadInOutLooper

Similar to ConstantLoop, except that key 0 serves as idle position. When the mover is triggered, it moves to key 1 and loops the remaining keys. Depending on the value of bOscillatingLoop, it either goes forward and reversed when the last key is reached (True) or directly moves from the last to the first loop key, i.e. key 1. (False) When the mover is triggered again, it goes directly back to key 0.

LeadInOutLooper.BeginState

event BeginState ()

Overrides: Object.BeginState (global)


LeadInOutLooper.KeyFrameReached

event KeyFrameReached ()

Overrides: KeyFrameReached (global)


LeadInOutLooper.Trigger

event Trigger (Actor Other, Pawn EventInstigator)

Overrides: Actor.Trigger (global)


LoopMove

Loops through its keys if triggered, stops at the next key if untriggered.

LoopMove.BeginState

event BeginState ()

Overrides: Object.BeginState (global)


LoopMove.KeyFrameReached

event KeyFrameReached ()

Overrides: KeyFrameReached (global)


LoopMove.Trigger

event Trigger (Actor Other, Pawn EventInstigator)

Overrides: Actor.Trigger (global)


LoopMove.UnTrigger

event UnTrigger (Actor Other, Pawn EventInstigator)

Overrides: Actor.UnTrigger (global)


LoopMove.SelfTriggered

function bool SelfTriggered ()

Overrides: SelfTriggered (global)


RotatingMover

A simple rotating state. Most useful for slaves of open-timed movers as it will start rotating if the master mover starts opening, stop rotating when the master has opened and reverse the rotation direction when the master closes again.

RotatingMover.BeginState

simulated event BeginState ()

Overrides: Object.BeginState (global)


RotatingMover.BaseFinished

simulated function BaseFinished ()

Overrides: BaseFinished (global)


RotatingMover.BaseStarted

simulated function BaseStarted ()

Overrides: BaseStarted (global)


StandOpenTimed

Open when stood on, wait, then close. The most-used state for automatic elevators.

Extends: OpenTimedMover

StandOpenTimed.Attach

event Attach (Actor Other)

Overrides: Actor.Attach (global)


StandOpenTimed.CanTrigger

function bool CanTrigger (Actor Other)


StandOpenTimed.DisableTrigger

function DisableTrigger ()

Overrides: DisableTrigger (global)


StandOpenTimed.EnableTrigger

function EnableTrigger ()

Overrides: EnableTrigger (global)


StandOpenTimed.ShouldReTrigger

function bool ShouldReTrigger ()

Overrides: OpenTimedMover.ShouldReTrigger


TriggerAdvance

Open when triggered, stop when untriggered, close when reset.

This is mostly used in Assault maps for doors and levers that slowly open/activate while a player is nearby. Player proximity is not checked by the mover itself, but by a Trigger or other triggering/untriggering actor. The mover will only return to its initial position if it is reset, e.g. at the start of a new Assault or Onslaught round.

TriggerAdvance.BeginState

event BeginState ()

Overrides: Object.BeginState (global)


TriggerAdvance.EndState

event EndState ()

Overrides: Object.EndState (global)


TriggerAdvance.Trigger

event Trigger (Actor Other, Pawn EventInstigator)

Overrides: Actor.Trigger (global)


TriggerAdvance.UnTrigger

event UnTrigger (Actor Other, Pawn EventInstigator)

Overrides: Actor.UnTrigger (global)


TriggerAdvance.Reset

function Reset ()

Overrides: Reset (global)


TriggerAdvance.SelfTriggered

function bool SelfTriggered ()

Overrides: SelfTriggered (global)


TriggerControl

Open when triggered, close when get untriggered.

Like TriggerAdvance, this state requires a Trigger or other triggering/untriggering actor. Can be used e.g. for doors that stay open while a player is nearby.

TriggerControl.BeginState

event BeginState ()

Overrides: Object.BeginState (global)


TriggerControl.Trigger

event Trigger (Actor Other, Pawn EventInstigator)

Overrides: Actor.Trigger (global)


TriggerControl.UnTrigger

event UnTrigger (Actor Other, Pawn EventInstigator)

Overrides: Actor.UnTrigger (global)


TriggerControl.Reset

function Reset ()

Overrides: Reset (global)


TriggerControl.SelfTriggered

function bool SelfTriggered ()

Overrides: SelfTriggered (global)


TriggerOpenTimed

When triggered, open, wait, then close.

Used for special doors that only stay open for a certain time but shouldn't react to player bumping. This state is also recommended for bDamageTriggered movers.

Extends: OpenTimedMover

TriggerOpenTimed.Trigger

event Trigger (Actor Other, Pawn EventInstigator)

Overrides: Actor.Trigger (global)


TriggerOpenTimed.DisableTrigger

function DisableTrigger ()

Overrides: DisableTrigger (global)


TriggerOpenTimed.EnableTrigger

function EnableTrigger ()

Overrides: EnableTrigger (global)


TriggerOpenTimed.SelfTriggered

function bool SelfTriggered ()

Overrides: SelfTriggered (global)


TriggerPound

Starts opening and closing when triggered. Stops when closed after untriggering.

TriggerPound.BeginState

event BeginState ()

Overrides: Object.BeginState (global)


TriggerPound.Trigger

event Trigger (Actor Other, Pawn EventInstigator)

Overrides: Actor.Trigger (global)


TriggerPound.UnTrigger

event UnTrigger (Actor Other, Pawn EventInstigator)

Overrides: Actor.UnTrigger (global)


TriggerPound.Reset

function Reset ()

Overrides: Reset (global)


TriggerPound.SelfTriggered

function bool SelfTriggered ()

Overrides: SelfTriggered (global)


TriggerToggle

Opens when triggered, closes when triggered again.

TriggerToggle.Trigger

event Trigger (Actor Other, Pawn EventInstigator)

Overrides: Actor.Trigger (global)


TriggerToggle.Reset

function Reset ()

Overrides: Reset (global)


TriggerToggle.SelfTriggered

function bool SelfTriggered ()

Overrides: SelfTriggered (global)


Internal states

These are secondary states the mover will switch to in certain situations. Some of them also serve as base for other states with similar behavior.

LeadInOutLooping

Active state for LeadInOutLooper.

LeadInOutLooping.KeyFrameReached

event KeyFrameReached ()

Overrides: KeyFrameReached (global)

Moves to the next key in sequence.

LeadInOutLooping.Trigger

event Trigger (Actor Other, Pawn EventInstigator)

Overrides: Actor.Trigger (global)

Moves to key 0, then returns to LeadInOutLooper state.

OpenTimedMover

Base state for BumpOpenTimed, StandOpenTimed and TriggerOpenTimed mover.

OpenTimedMover.BeginState

event BeginState ()

Overrides: Object.BeginState (global)


OpenTimedMover.Reset

function Reset ()

Overrides: Reset (global)


OpenTimedMover.ShouldReTrigger

function bool ShouldReTrigger ()


WasBumpButton

Disabled state for BumpButton mover.

WasBumpButton.Reset

function Reset ()

Overrides: Reset (global)

Returns to BumpButton state.

WasOpenTimedMover

Disabled state for trigger-once BumpOpenTimed, StandOpenTimed and TriggerOpenTimed movers.

WasOpenTimedMover.Reset

function Reset ()

Overrides: Reset (global)

Returns to the original open-timed state.

WasTriggerAdvance

Final state of fully-opened TriggerAdvance mover.

WasTriggerAdvance.Reset

function Reset ()

Overrides: Reset (global)

Returns to TriggerAdvance state.

WasTriggerAdvance.SelfTriggered

function bool SelfTriggered ()

Overrides: SelfTriggered (global)


WasTriggerControl

Final state of fully-opened trigger-once TriggerControl mover.

WasTriggerControl.Reset

function Reset ()

Overrides: Reset (global)

Returns to TriggerControl state.

WasTriggerControl.SelfTriggered

function bool SelfTriggered ()

Overrides: SelfTriggered (global)


WasTriggerPound

Disabled state of trigger-once TriggerPound mover that opened and closed once.

WasTriggerPound.Reset

function Reset ()

Overrides: Reset (global)

Returns to TriggerPound state.