currentWaypoint: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "|=GROUP1" to "|GROUP1=")
m (Some wiki formatting)
 
(24 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma2 |Game name=
|game1= arma2
|version1= 1.00


|1.00|Game version=
|game2= arma2oa
|version2= 1.50


|gr1= Waypoints |GROUP1=
|game3= tkoh
____________________________________________________________________________________________
|version3= 1.00


| Returns the '''index''' of the current waypoint contrary to misleading name.
|game4= arma3
|version4= 0.50
 
|gr1= Waypoints
 
|descr= Returns the ''index'' of the current waypoint ('''not''' the waypoint in [[Waypoint|Waypoint Array]] format).


To determine the validity of the index, compare it to the waypoints count.
To determine the validity of the index, compare it to the waypoints count.


If all waypoints are 'completed', then the index is 1 greater than the last valid index.
If all waypoints are completed, then the index is 1 greater than the last valid index.


If there are no waypoints, then the index is 0.
If there are no waypoints, then the index is 0.


By default, a group has 1 waypoint at their starting position, which is considered completed and so the currentWaypoint is 1.
By default, a group has one waypoint at their starting position, which is considered completed so the currentWaypoint is 1.
|DESCRIPTION=
____________________________________________________________________________________________
 
| '''currentWaypoint''' groupName |SYNTAX=
 
|p1= groupName: [[Group]]  |PARAMETER1=


|p2= |PARAMETER2=  
|s1= [[currentWaypoint]] groupName


|p3= |PARAMETER3=  
|p1= groupName: [[Group]]


| [[Number]] - the index of current waypoint|RETURNVALUE=
|r1= [[Number]] - index of the current waypoint


|x1= <sqf>_index = currentWaypoint group player;</sqf>


|x1= <code>_index = [[currentWaypoint]] [[group]] [[player]];</code>|EXAMPLE1=
|seealso= [[waypoints]] [[setCurrentWaypoint]]
 
____________________________________________________________________________________________
 
| [[waypoints]], [[deleteWaypoint]], [[copyWaypoints]], [[setCurrentWaypoint]], [[setWaypointBehaviour]], [[setWaypointCombatMode]], [[setWaypointCompletionRadius]], [[setWaypointDescription]], [[setWaypointFormation]], [[setWaypointHousePosition]], [[setWaypointPosition]], [[setWaypointScript]], [[setWaypointSpeed]], [[setWaypointStatements]], [[setWaypointTimeout]], [[setWaypointType]], [[setWaypointVisible]], [[waypointAttachVehicle]], [[waypointAttachedVehicle]], [[setWaypointLoiterRadius]], [[waypointLoiterRadius]], [[addWaypoint]], [[setWaypointLoiterType]], [[waypointSpeed]], [[setWPPos]], [[waypointName]] |SEEALSO=
 
|  |MPBEHAVIOUR=
____________________________________________________________________________________________
}}
}}
<h3 style='display:none'>Notes</h3>
<dl class='command_description'>
<!-- Note Section BEGIN -->
<!-- Note Section END -->
</dl>
<h3 style='display:none'>Bottom Section</h3>
[[Category:Scripting Commands Arma 2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 11:42, 5 May 2024

Hover & click on the images for description

Description

Description:
Returns the index of the current waypoint (not the waypoint in Waypoint Array format). To determine the validity of the index, compare it to the waypoints count. If all waypoints are completed, then the index is 1 greater than the last valid index. If there are no waypoints, then the index is 0. By default, a group has one waypoint at their starting position, which is considered completed so the currentWaypoint is 1.
Groups:
Waypoints

Syntax

Syntax:
currentWaypoint groupName
Parameters:
groupName: Group
Return Value:
Number - index of the current waypoint

Examples

Example 1:
_index = currentWaypoint group player;

Additional Information

See also:
waypoints setCurrentWaypoint

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