setFormDir: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (Text replacement - "<sqf>([^↵][^<]*↵[^<]*)<\/sqf>" to "<sqf> $1 </sqf>")
 
(58 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| ofp |= Game name
|game1= ofp
|version1= 1.00


|1.00|= Game version
|game2= ofpe
____________________________________________________________________________________________
|version2= 1.00


| Set group formation heading. Accepted heading range is 0 to 360. Formation is facing this direction unless enemy is seen. When group is moving, this value is overriden by movement direction. |= Description
|game3= arma1
____________________________________________________________________________________________
|version3= 1.00


| group '''setFormDir''' heading |= Syntax
|game4= arma2
|version4= 1.00


|p1= group: [[Object]] or [[Group]] |= Parameter 1
|game5= arma2oa
|version5= 1.50


|p2= heading: [[Number]] |= Parameter 2
|game6= tkoh
|version6= 1.00


| [[Nothing]] |= Return value
|game7= arma3
____________________________________________________________________________________________
|version7= 0.50
 
|x1= <code>_group1 [[setFormDir]] 180;</code> |= Example 1
|x2= <code>_unit1 [[setFormDir]] [[random]] 360;</code> |= Example 2


|x3= <code>//center the main turret
|arg= local
([[group]] BIS_Crew1) [[setFormDir]] ([[getDir]] BIS_Armor);
([[group]] BIS_Crew2) [[setFormDir]] ([[getDir]] BIS_Armor);</code> |= Example 3
____________________________________________________________________________________________


| [[setDir]] |= See also
|eff= global


}}
|gr1= Groups
 
|descr= Sets group formation heading. Accepted heading range is 0 to 360. Formation is facing this direction unless enemy is seen. When group is moving, this value is overridden by movement direction. If the new direction is noticeably different from the old direction (approx +/- 15 degrees), units will change positions changing [[formationDirection]].
 
|s1= group [[setFormDir]] heading
 
|p1= group: [[Object]] or [[Group]]
 
|p2= heading: [[Number]]
 
|r1= [[Nothing]]
 
|x1= <sqf>_group1 setFormDir 180;</sqf>


<h3 style="display:none">Notes</h3>
|x2= <sqf>_unit1 setFormDir random 360;</sqf>
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
|x3= <sqf>
</dl>
//center the main turret
(group BIS_Crew1) setFormDir (getDir BIS_Armor);
</sqf>


<h3 style="display:none">Bottom Section</h3>
|seealso= [[setDir]] [[setVectorDir]] [[setVectorDirAndUp]] [[resetSubgroupDirection]] [[formation]] [[formationLeader]] [[formationMembers]] [[formationTask]] [[formationDirection]] [[formationPosition]]
[[Category:Scripting Commands|SETFORMDIR]]
}}
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.96|SETFORMDIR]]
[[Category:Scripting Commands OFP 1.46|SETFORMDIR]]
[[Category:Scripting Commands ArmA|SETFORMDIR]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]


<!-- CONTINUE Notes -->
<dl class="command_description">
<dl class="command_description">
<dd class="notedate">Posted on November 22, 2014 - 20:03 (UTC)</dd>
 
<dt class="note">[[User:Killzone Kid|Killzone Kid]]</dt>
<dt></dt>
<dd class="notedate">Posted on 2014-11-22 - 20:03 (UTC)</dd>
<dt class="note">[[User:Killzone_Kid|Killzone_Kid]]</dt>
<dd class="note">
<dd class="note">
When applied to AI, [[setFormDir]] will set unit formation direction, which in turn will force unit to change direction to match formation direction, however unit will stop turning as soon as unit direction is +/- 30 degrees of the formation direction. To precisely match formation direction, additional [[setDir]] is required:
When applied to AI, [[setFormDir]] will set unit formation direction, which in turn will force unit to change direction to match formation direction, however unit will stop turning as soon as unit direction is +/- 30 degrees of the formation direction. To precisely match formation direction, additional [[setDir]] is required:
<code>_unit [[setFormDir]] 45;
<sqf>
_unit [[setDir]] 45;
_unit setFormDir 45;
[[hint]] [[str]] [[direction]] _unit; //45</code>  
_unit setDir 45;
hint str direction _unit; //45
</sqf>  


</dd>
</dd>
</dl>
<!-- DISCONTINUE Notes -->


<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on December 8, 2014 - 04:51 (UTC)</dd>
<dt class="note">[[User:DreadedEntity|DreadedEntity]]</dt>
<dd class="note">
To add to Killzone Kid's note, that only applies to groups consisting of a single unit. This is [http://feedback.arma3.com/view.php?id=21792#c84966 intended behavior]. See my comment below the linked post for a single-unit workaround.
</dd>
</dl>
</dl>
<!-- DISCONTINUE Notes -->

Latest revision as of 19:42, 3 September 2024

Logo A0.png1.00ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
LALocalGEGlobal
Hover & click on the images for description

Description

Description:
Sets group formation heading. Accepted heading range is 0 to 360. Formation is facing this direction unless enemy is seen. When group is moving, this value is overridden by movement direction. If the new direction is noticeably different from the old direction (approx +/- 15 degrees), units will change positions changing formationDirection.
Groups:
Groups

Syntax

Syntax:
group setFormDir heading
Parameters:
group: Object or Group
heading: Number
Return Value:
Nothing

Examples

Example 1:
_group1 setFormDir 180;
Example 2:
_unit1 setFormDir random 360;
Example 3:
//center the main turret (group BIS_Crew1) setFormDir (getDir BIS_Armor);

Additional Information

See also:
setDir setVectorDir setVectorDirAndUp resetSubgroupDirection formation formationLeader formationMembers formationTask formationDirection formationPosition

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 2014-11-22 - 20:03 (UTC)
Killzone_Kid
When applied to AI, setFormDir will set unit formation direction, which in turn will force unit to change direction to match formation direction, however unit will stop turning as soon as unit direction is +/- 30 degrees of the formation direction. To precisely match formation direction, additional setDir is required:
_unit setFormDir 45; _unit setDir 45; hint str direction _unit; //45
Retrieved from "https://community.bistudio.com/wiki?title=setFormDir&oldid=369299"