animateBay: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\{\{( *)Informative( *)\|" to "{{$1Feature$2|$2Informative$2|")
m (Some wiki formatting)
 
(21 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| arma3
|game1= arma3
|version1= 1.70


|1.70
|eff= local


|eff= local
|arg= global
|arg= global


|gr1= Animations
|gr1= Animations
|gr2= Vehicle Loadouts
|gr2= Vehicle Loadouts


|Force animation of bay to given state, -1 for reset to engine handling, can cause weapon inoperative, because weapon is released when bay state <nowiki>=</nowiki>1.
|descr= Forces animation of bay to given state, -1 for reset to engine handling, can cause weapon inoperative, because weapon is released when bay state == 1.
<br><br>{{Feature | Informative | While there is no getter to read the animation phase of the given bay, [[animationPhase]] command can be used with the individual bay door name from [[animationNames]] as a workaround. For example for UCAV Sentinel <tt>ucav [[animateBay]] [1, 1]</tt> could be checked with <tt>ucav [[animationPhase]] "weapons_bay_l_1"</tt> or <tt>ucav [[animationPhase]] "weapons_bay_l_2"</tt>}}
{{Feature|informative|
While there is no getter to read the animation phase of the given bay, the [[animationPhase]] command can be used with the individual bay door name from [[animationNames]] as a workaround (See {{Link|#Example 3}}).
}}


| vehicle '''animateBay''' [bay, animphase, instant]
|s1= vehicle [[animateBay]] [bay, animphase, instant]


|p1= vehicle: [[Object]]
|p1= vehicle: [[Object]]
|p2= [bay, animphase, instant] : [[Array]]
|p3= bay: [[Number]] - bay index (index starts from 1 and different from pylon index)
|p4= animphase: [[Number]] - animation phase (0...1)
|p5= instant (Optional): [[Boolean]] - animate immediately


| [[Nothing]]
|p2= bay: [[Number]] - bay index (index starts from 1 and different from pylon index)


|x1= <code>[[vehicle]] [[player]] [[animateBay]] [1, 0.5];</code>
|p4= animphase: [[Number]] - animation phase in range 0..1
|x2= <code>[[vehicle]] [[player]] [[animateBay]] [1, 1, [[true]]];</code>


| [[Arma 3 Vehicle Loadouts]],[[getCompatiblePylonMagazines]],[[getPylonMagazines]],[[setAmmoOnPylon]],[[ammoOnPylon]],[[animatePylon]],[[setPylonsPriority]],[[setPylonLoadout]]
|p5= instant: [[Boolean]] - (Optional, default [[false]]) animate immediately
}}
 
|r1= [[Nothing]]
 
|x1= <sqf>vehicle player animateBay [1, 0.5];</sqf>
 
|x2= <sqf>vehicle player animateBay [1, 1, true];</sqf>


|x3= Getter example, here for the UCAV Sentinel:<sqf>
ucav animateBay [1, 1];
// can be checked with
ucav animationPhase "weapons_bay_l_1";
// or
ucav animationPhase "weapons_bay_l_2";
</sqf>


<dl class="command_description">
</dl>


{{GameCategory|arma3|New Scripting Commands}}
|seealso= [[Arma 3: Vehicle Loadouts]] [[getCompatiblePylonMagazines]] [[getPylonMagazines]] [[setAmmoOnPylon]] [[ammoOnPylon]] [[animatePylon]] [[setPylonsPriority]] [[setPylonLoadout]]
{{GameCategory|arma3|Scripting Commands}}
}}
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 11:17, 8 November 2023

Hover & click on the images for description

Description

Description:
Forces animation of bay to given state, -1 for reset to engine handling, can cause weapon inoperative, because weapon is released when bay state == 1.
While there is no getter to read the animation phase of the given bay, the animationPhase command can be used with the individual bay door name from animationNames as a workaround (See Example 3).
Groups:
AnimationsVehicle Loadouts

Syntax

Syntax:
vehicle animateBay [bay, animphase, instant]
Parameters:
vehicle: Object
bay: Number - bay index (index starts from 1 and different from pylon index)
animphase: Number - animation phase in range 0..1
instant: Boolean - (Optional, default false) animate immediately
Return Value:
Nothing

Examples

Example 1:
vehicle player animateBay [1, 0.5];
Example 2:
vehicle player animateBay [1, 1, true];
Example 3:
Getter example, here for the UCAV Sentinel:
ucav animateBay [1, 1]; // can be checked with ucav animationPhase "weapons_bay_l_1"; // or ucav animationPhase "weapons_bay_l_2";

Additional Information

See also:
Arma 3: Vehicle Loadouts getCompatiblePylonMagazines getPylonMagazines setAmmoOnPylon ammoOnPylon animatePylon setPylonsPriority setPylonLoadout

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