BIS fnc animateFlag: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "<code>(\[[a-zA-Z0-9_, ]*\] )?\[\[(call|spawn)\]\] \[\[(BI[NS]\_fnc\_[a-zA-Z0-9_]+)\]\];?<\/code>" to "<sqf>$1$2 $3;</sqf>")
m (Some wiki formatting)
Line 30: Line 30:
|x1= <sqf>[flag1, 0] call BIS_fnc_animateFlag;</sqf>
|x1= <sqf>[flag1, 0] call BIS_fnc_animateFlag;</sqf>


|x2= <code>{{cc|Adding the "FlagAnimationDone" EH}}
|x2= <sqf>
[[private]] _eh = [<yourflag>, "FlagAnimationDone", { {{codecomment|/* your code */}} }] [[call]] [[BIS_fnc_addScriptedEventHandler]];</code>
// Adding the "FlagAnimationDone" EH
private _eh = [<yourflag>, "FlagAnimationDone", { /* your code */ }] call BIS_fnc_addScriptedEventHandler;
</sqf>


|seealso= [[flag]] [[flagOwner]], [[setFlagOwner]], [[setFlagSide]], [[setFlagTexture]], [[flagSide]], [[flagTexture]], [[setFlagAnimationPhase]], [[flagAnimationPhase]], [[Arma 3: Flag Textures]]
|seealso= [[flag]] [[flagOwner]], [[setFlagOwner]], [[setFlagSide]], [[setFlagTexture]], [[flagSide]], [[flagTexture]], [[setFlagAnimationPhase]], [[flagAnimationPhase]], [[Arma 3: Flag Textures]]
Line 38: Line 40:
<dl class="command_description">
<dl class="command_description">


<dt></dt>
{{Note
<dd class="notedate">Posted on December 12, 2016 - 20:02 (UTC)</dd>
|user= Killzone_Kid
<dt class="note">[[User:Killzone Kid|Killzone Kid]]</dt>
|timestamp= 20161212200200
<dd class="note"><code>{{cc|Flag Demo (https://www.youtube.com/watch?v{{=}}sJtQfRML0cc)}}
|text= Flag Demo (https://www.youtube.com/watch?v=sJtQfRML0cc)
 
<sqf>
fnc_addFlagAction =
fnc_addFlagAction =
{
{
_this [[addAction]]
_this addAction
[
[
"Pull The Cord",
"Pull The Cord",
{
{
[[player]] [[playAction]] "PutDown";
player playAction "PutDown";
[[sleep]] 0.5;
sleep 0.5;
[_this [[select]] 0, [[flagAnimationPhase]] (_this [[select]] 0) + 0.2, 0.2] [[call]] [[BIS_fnc_animateFlag]];
[_this select 0, flagAnimationPhase (_this select 0) + 0.2, 0.2] call BIS_fnc_animateFlag;
_this [[select]] 0 [[removeAction]] (_this [[select]] 2);
_this select 0 removeAction (_this select 2);
},
},
"",
"",
10,
10,
[[true]],
true,
[[true]],
true,
"",
"",
"_this [[distance2D]] _target < 2"
"_this distance2D _target < 2"
];
];
};
};


[[private]] _flag = [[createVehicle]] ["Flag_BI_F", [[player]] [[getRelPos]] [10, 0], [], 0, "CAN_COLLIDE"];
private _flag = createVehicle ["Flag_BI_F", player getRelPos [10, 0], [], 0, "CAN_COLLIDE"];
[_flag, 0, [[true]]] [[call]] [[BIS_fnc_animateFlag]];
[_flag, 0, true] call BIS_fnc_animateFlag;
_flag [[call]] fnc_addFlagAction;
_flag call fnc_addFlagAction;


[
[
Line 71: Line 73:
"FlagAnimationDone",
"FlagAnimationDone",
{
{
[[if]] (_this [[select]] 1 > 0.9) [[exitWith]]
if (_this select 1 > 0.9) exitWith
{
{
[_this [[select]] 0, "FlagAnimationDone"] [[call]] [[BIS_fnc_removeAllScriptedEventHandlers]];
[_this select 0, "FlagAnimationDone"] call BIS_fnc_removeAllScriptedEventHandlers;
[[removeAllActions]] (_this [[select]] 0);
removeAllActions (_this select 0);
};
};
_this [[select]] 0 [[call]] fnc_addFlagAction;
_this select 0 call fnc_addFlagAction;
}
}
]
]
[[call]] [[BIS_fnc_addScriptedEventHandler]];
call BIS_fnc_addScriptedEventHandler;
</code>
</sqf>
 
}}
</dd>
 
</dl>

Revision as of 20:56, 13 May 2022

Arma 3 logo black.png1.68
GAGlobalGEGlobal
Hover & click on the images for description

Description

Description:
Smoothly animates given flag from current position on the flag pole to the given position. When flag animation is done, the scripted event handler "FlagAnimationDone" is called.
⚠
Never place this function into an object's init field.
Execution:
call
Multiplayer:
The effect is global, MP compatible and its effect is persistent.
Groups:
Object Manipulation

Syntax

Syntax:
[flag, phase, instant] call BIS_fnc_animateFlag
Parameters:
flag: Object - flag object of the type "FlagCarrier"
phase: Number - desired animation phase 0...1 (0 - bottom of the flag pole, 1 - top of the flag pole)
instant (Optional, default false):
  • Boolean - when true, animation is instant ("FlagAnimationDone" EH is not called in this case)
  • Number - animation duration multiplier
Return Value:
Nothing

Examples

Example 1:
[flag1, 0] call BIS_fnc_animateFlag;
Example 2:
// Adding the "FlagAnimationDone" EH private _eh = [<yourflag>, "FlagAnimationDone", { /* your code */ }] call BIS_fnc_addScriptedEventHandler;

Additional Information

See also:
flag flagOwnersetFlagOwnersetFlagSidesetFlagTextureflagSideflagTexturesetFlagAnimationPhaseflagAnimationPhaseArma 3: Flag Textures

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
Killzone_Kid - c
Posted on Dec 12, 2016 - 20:02 (UTC)
Flag Demo (https://www.youtube.com/watch?v=sJtQfRML0cc)
fnc_addFlagAction = { _this addAction [ "Pull The Cord", { player playAction "PutDown"; sleep 0.5; [_this select 0, flagAnimationPhase (_this select 0) + 0.2, 0.2] call BIS_fnc_animateFlag; _this select 0 removeAction (_this select 2); }, "", 10, true, true, "", "_this distance2D _target < 2" ]; }; private _flag = createVehicle ["Flag_BI_F", player getRelPos [10, 0], [], 0, "CAN_COLLIDE"]; [_flag, 0, true] call BIS_fnc_animateFlag; _flag call fnc_addFlagAction; [ _flag, "FlagAnimationDone", { if (_this select 1 > 0.9) exitWith { [_this select 0, "FlagAnimationDone"] call BIS_fnc_removeAllScriptedEventHandlers; removeAllActions (_this select 0); }; _this select 0 call fnc_addFlagAction; } ] call BIS_fnc_addScriptedEventHandler;
Retrieved from "https://community.bistudio.com/wiki?title=BIS_fnc_animateFlag&oldid=321360"