expectedDestination: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
No edit summary
 
(65 intermediate revisions by 11 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma |= Game name
|game1= arma1
|version1= 1.00


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


| Return expected destination of unit as an array with format: [ [[Position]], planningMode, forceReplan]. |= Description
|game3= arma2oa
____________________________________________________________________________________________
|version3= 1.50


| [[Array]] <nowiki>=</nowiki> '''expectedDestination''' [[Object#Person|Person]] |= Syntax
|game4= tkoh
|version4= 1.00


|p1= [[Object#Person|Person]]  |= Parameter 1
|game5= arma3
|version5= 0.50


| [[Array]] |= Return value
|arg= local
____________________________________________________________________________________________


| [[setDestination]] |= See also
|gr1= Unit Control
|gr2= AI Behaviour


}}
|descr= Return expected destination of unit as an array.
 
|s1= [[expectedDestination]] person
 
|p1= person: [[Object]]
 
|r1= [[Array]] in format [destination, planningMode, forceReplan] where:
* destination: [[Array]] format [[PositionAGL]]
* planningMode: [[String]] - can be one of:
** "DoNotPlan" - used when not moving
** "DoNotPlanFormation" - used in formation when simple path testing is used
** "LEADER PLANNED" - used for formation leader (full path finding used)
** "LEADER DIRECT" - used for DirectGo (like getin, supply)
** "FORMATION PLANNED" - used in formation when full path finding is used
** "VEHICLE PLANNED" - used for vehicle driver
* forceReplan: [[Boolean]] -  specifies if path replanning was forced (through [[setDestination]])


<h3 style="display:none">Notes</h3>
|x1= <sqf>_data = expectedDestination player;</sqf>
<dl class="command_description">
<!-- Note Section BEGIN -->
<dd class="notedate">Posted on 16:24, 3 March 2007 (CET)</dd> <dt class="note>'''[[User:Donnervogel|Donnervogel]]'''</dt><dd class="note">For AI units I have found the following values: ''planningMode'' is "LEADER PLANNED" when the unit is ordered by the group leader to go somewhere or if the unit is the group leader and it follows a waypoint. Otherwise ''planningMode'' it is "DoNotPlan". Units moving in formation have "DoNotPlan" as long as they don't receive orders by the group leader. Units also have "DoNotPlan" when they don't move. Units executing special formation tasks like engaging or return to formation have "FORMATION PLANNED" as long they haven't fulfilled the task.</dd>
<!-- Note Section END -->
</dl>


<h3 style="display:none">Bottom Section</h3>
|seealso= [[setDestination]] [[getUnitState]]
}}


[[Category:Scripting Commands|EXPECTEDDESTINATION]]
{{Note
[[Category:Scripting Commands ArmA|EXPECTEDDESTINATION]]
|user= Donnervogel
[[Category:Command_Group:_Object_Information|{{uc:{{PAGENAME}}}}]]
|timestamp= 20070303162400
|text= For AI units I have found the following values: ''planningMode'' is "LEADER PLANNED" when the unit is ordered by the group leader to go somewhere or if the unit is the group leader and it follows a waypoint. Otherwise ''planningMode'' it is "DoNotPlan". Units moving in formation have "DoNotPlan" as long as they don't receive orders by the group leader. Units also have "DoNotPlan" when they don't move. Units executing special formation tasks like engaging or return to formation have "FORMATION PLANNED" as long they have not fulfilled the task.
}}

Latest revision as of 14:16, 22 October 2024

Hover & click on the images for description

Description

Description:
Return expected destination of unit as an array.
Groups:
Unit ControlAI Behaviour

Syntax

Syntax:
expectedDestination person
Parameters:
person: Object
Return Value:
Array in format [destination, planningMode, forceReplan] where:
  • destination: Array format PositionAGL
  • planningMode: String - can be one of:
    • "DoNotPlan" - used when not moving
    • "DoNotPlanFormation" - used in formation when simple path testing is used
    • "LEADER PLANNED" - used for formation leader (full path finding used)
    • "LEADER DIRECT" - used for DirectGo (like getin, supply)
    • "FORMATION PLANNED" - used in formation when full path finding is used
    • "VEHICLE PLANNED" - used for vehicle driver
  • forceReplan: Boolean - specifies if path replanning was forced (through setDestination)

Examples

Example 1:
_data = expectedDestination player;

Additional Information

See also:
setDestination getUnitState

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
Donnervogel - c
Posted on Mar 03, 2007 - 16:24 (UTC)
For AI units I have found the following values: planningMode is "LEADER PLANNED" when the unit is ordered by the group leader to go somewhere or if the unit is the group leader and it follows a waypoint. Otherwise planningMode it is "DoNotPlan". Units moving in formation have "DoNotPlan" as long as they don't receive orders by the group leader. Units also have "DoNotPlan" when they don't move. Units executing special formation tasks like engaging or return to formation have "FORMATION PLANNED" as long they have not fulfilled the task.