switchMove: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
Lou Montana (talk | contribs) m (Some wiki formatting) |
||
| Line 33: | Line 33: | ||
If an invalid animation is provided, the unit's animations will be reset but no new animation will be played (see {{HashLink|#Example 3}}). | If an invalid animation is provided, the unit's animations will be reset but no new animation will be played (see {{HashLink|#Example 3}}). | ||
{{Feature | | {{Feature|informative|It is a good practice to always use [[playMoveNow]] after [[switchMove]] to make sure the animation plays correctly: | ||
<sqf> | <sqf> | ||
_unit switchMove "myMove"; | _unit switchMove "myMove"; | ||
| Line 40: | Line 40: | ||
}} | }} | ||
|mp= This command has global effect when executed locally to the unit and will | |mp= This command has a global effect when executed locally to the unit and will synchronise properly for JIP. In this case the animation on the executing machine is immediate while on remote machines it will be transitional. In order for the animation to change immediately on every PC in multiplayer, use global remote execution (see {{HashLink|#Example 2}}). When the argument is remote, the animation change on the executing PC is only temporary. | ||
|s1= person [[switchMove]] moveName | |s1= person [[switchMove]] moveName | ||
| Line 54: | Line 54: | ||
|x2= Sit player immediately and globally: | |x2= Sit player immediately and globally: | ||
<sqf>[player, "AmovPsitMstpSlowWrflDnon"] remoteExec ["switchMove" | <sqf>[player, "AmovPsitMstpSlowWrflDnon"] remoteExec ["switchMove"];</sqf> | ||
|x3= Resets unit's animation: | |x3= Resets unit's animation: | ||
| Line 62: | Line 62: | ||
}} | }} | ||
{{Note | |||
|user= Hurricane | |||
|timestamp= 20070325234800 | |||
|text= In some cases the movement won't stay. I.e. AI hostages that put their hands behind their heads (_hostage [[switchMove]] "AmovPercMstpSsurWnonDnon") won't hold their hands up, unless you first use [[disableAI]] "autoTarget" on them. They mostly put their hands down because they 'noticed' unknown objects. | |||
}} | |||
{{Note | |||
|user= Killswitch | |||
|timestamp= 20080803224300 | |||
|text= This command will not cause an [[ArmA:_Event_Handlers#AnimChanged|AnimChanged]] or [[ArmA:_Event_Handlers#AnimDone|AnimDone]] event. However, [[playMove]] will. | |||
}} | |||
{{Note | |||
|user= AgentRevolution | |||
|timestamp= 20161112201100 | |||
|text= When using this command on the [[player]] unit outside [[Scheduler#Unscheduled_Environment|unscheduled]] UI contexts, it will cause a minor camera glitch for a single frame.<br> | |||
When using this command on the [[player]] unit outside [[Scheduler#Unscheduled_Environment|unscheduled]] UI contexts, it will cause a minor camera glitch for a single frame.<br> | |||
For example, [[Arma 3: Mission Event Handlers#Draw3D|Draw3D]] and [[displayAddEventHandler|KeyDown]] are UI contexts and so are not affected by the glitch, but [[Arma 3: Mission Event Handlers#EachFrame|EachFrame]] and [[Scheduler#Scheduled_Environment|scheduled]] scripts are not UI contexts and are affected by the glitch. | For example, [[Arma 3: Mission Event Handlers#Draw3D|Draw3D]] and [[displayAddEventHandler|KeyDown]] are UI contexts and so are not affected by the glitch, but [[Arma 3: Mission Event Handlers#EachFrame|EachFrame]] and [[Scheduler#Scheduled_Environment|scheduled]] scripts are not UI contexts and are affected by the glitch. | ||
}} | |||
{{Note | |||
|user= Leopard20 | |||
|timestamp= 20210808155900 | |||
|text= If the animation you're trying to use with this command has no connection/interpolation to the unit's base animation (usually "AmovPercMstpSrasWrflDnon"), the move might not play using [[switchMove]] alone. In such cases you have to do this: | |||
If the animation you're trying to use with this command has no connection/interpolation to the unit's base animation (usually "AmovPercMstpSrasWrflDnon"), the move might not play using [[switchMove]] alone. In such cases you have to do this: | |||
<sqf>_unit switchMove _move; _unit playMoveNow _move;</sqf> | <sqf>_unit switchMove _move; _unit playMoveNow _move;</sqf> | ||
This must run in | This must run in '''[[Scheduler|unscheduled environment]]''' (see [[isNil]]) | ||
}} | |||
Revision as of 10:25, 25 August 2022
Description
- Description:
- Immediately applies given animation to the unit. For a smooth transition from the current animation, use playMove.
This command first resets the unit's animation states (including aiming state, gesture state, etc.) then puts the unit in the first frame of the animation (therefore showing no transition). If an invalid animation is provided, the unit's animations will be reset but no new animation will be played (see Example 3).
- Multiplayer:
- This command has a global effect when executed locally to the unit and will synchronise properly for JIP. In this case the animation on the executing machine is immediate while on remote machines it will be transitional. In order for the animation to change immediately on every PC in multiplayer, use global remote execution (see Example 2). When the argument is remote, the animation change on the executing PC is only temporary.
- Groups:
- Animations
Syntax
- Syntax:
- person switchMove moveName
- Parameters:
- person: Object - unit
- moveName: String - animation state (see animationState)
- Return Value:
- Nothing
Examples
- Example 1:
- Prone:
- Example 2:
- Sit player immediately and globally:
- Example 3:
- Resets unit's animation:
_unit switchMove "";
Additional Information
- See also:
- playMove playMoveNow switchAction playAction playActionNow
Notes
-
Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
- Posted on Mar 25, 2007 - 23:48 (UTC)
- In some cases the movement won't stay. I.e. AI hostages that put their hands behind their heads (_hostage switchMove "AmovPercMstpSsurWnonDnon") won't hold their hands up, unless you first use disableAI "autoTarget" on them. They mostly put their hands down because they 'noticed' unknown objects.
- Posted on Aug 03, 2008 - 22:43 (UTC)
- This command will not cause an AnimChanged or AnimDone event. However, playMove will.
- Posted on Nov 12, 2016 - 20:11 (UTC)
-
When using this command on the player unit outside unscheduled UI contexts, it will cause a minor camera glitch for a single frame.
For example, Draw3D and KeyDown are UI contexts and so are not affected by the glitch, but EachFrame and scheduled scripts are not UI contexts and are affected by the glitch.
- Posted on Aug 08, 2021 - 15:59 (UTC)
-
If the animation you're trying to use with this command has no connection/interpolation to the unit's base animation (usually "AmovPercMstpSrasWrflDnon"), the move might not play using switchMove alone. In such cases you have to do this:
This must run in unscheduled environment (see isNil)
Categories:
- Scripting Commands
- Introduced with Operation Flashpoint version 1.00
- Operation Flashpoint: New Scripting Commands
- Operation Flashpoint: Scripting Commands
- Operation Flashpoint: Elite: Scripting Commands
- ArmA: Armed Assault: Scripting Commands
- Arma 2: Scripting Commands
- Arma 2: Operation Arrowhead: Scripting Commands
- Take On Helicopters: Scripting Commands
- Arma 3: Scripting Commands
- Command Group: Animations
- Scripting Commands: Global Effect