deleteWaypoint: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " |r1=[[" to " |r1= [[")
m (Add forEachReversed example)
 
(50 intermediate revisions by the same user not shown)
Line 26: Line 26:


|descr= Removes the specified waypoint.
|descr= Removes the specified waypoint.
{{Feature | Informative |
{{Feature|informative|
* When a waypoint is deleted, all other [[group]] [[waypoints]] are immediately re-indexed. See '''[[#Examples|Example 2]]''' for a deletion of all group's waypoints.
* When a waypoint is deleted, all other [[group]] [[waypoints]] are immediately re-indexed. See {{Link|#Example 2}} for a deletion of all group's waypoints.
* Deleting a group's [[currentWaypoint|current waypoint]] will ''not'' stop the group on its tracks.}}
* Deleting a group's [[currentWaypoint|current waypoint]] will ''not'' stop the group on its tracks.
}}


|s1= [[deleteWaypoint]] [group, index]
|s1= [[deleteWaypoint]] [group, index]


|p1= [group, index]: [[Array]]
|p1= group: [[Group]]
 
|p2= group: [[Group]]


|p3= index: [[Number]]
|p2= index: [[Number]]


|r1= [[Nothing]]
|r1= [[Nothing]]


|x1= <code>[[deleteWaypoint]] [_grp, 2];</code>
|x1= <sqf>deleteWaypoint [_grp, 2];</sqf>


|x2= Because waypoints get immediately re-indexed when one gets deleted, delete them from last to first:
|x2= Because waypoints get immediately re-indexed when one gets deleted, delete them from last to first:
<code>[[private]] _group = [[group]] _unit;
<sqf>
[[for]] "_i" [[from]] [[count]] [[waypoints]] _group - 1 [[to]] 0 [[step]] -1 [[do]]
private _group = group _unit;
for "_i" from (count waypoints _group - 1) to 0 step -1 do
{
deleteWaypoint [_group, _i];
};
</sqf>
or always delete the first one (if you want to delete them all)
<sqf>
private _group = group _unit;
for "_i" from 0 to (count waypoints _group - 1) do
{
{
[[deleteWaypoint]] [_group, _i];
deleteWaypoint [_group, 0];
};</code>
};
</sqf>
or use [[forEachReversed]]:
<sqf>
{ deleteWaypoint _x } forEachReversed waypoints _group; // Arma 3 v2.14+ only
</sqf>


|seealso= [[waypoints]], [[copyWaypoints]], [[setCurrentWaypoint]], [[setWaypointBehaviour]], [[setWaypointCombatMode]], [[setWaypointCompletionRadius]], [[setWaypointDescription]], [[setWaypointFormation]], [[setWaypointHousePosition]], [[setWaypointPosition]], [[setWaypointScript]], [[setWaypointSpeed]], [[setWaypointStatements]], [[setWaypointTimeout]], [[setWaypointType]], [[setWaypointVisible]], [[waypointAttachVehicle]], [[waypointAttachedVehicle]], [[setWaypointLoiterRadius]], [[waypointLoiterRadius]], [[addWaypoint]], [[setWaypointLoiterType]], [[waypointSpeed]]
|seealso= [[waypoints]] [[setCurrentWaypoint]] [[setWaypointPosition]] [[setWaypointScript]] [[setWaypointStatements]] [[setWaypointType]] [[addWaypoint]]
}}
}}


<dl class="command_description">
{{Note
|user= Saintolaf
|timestamp= 20080101074800
|text= In order to change the behavior of a unit currently following some waypoints, it is not enough to use [[deleteWaypoint]].
To achieve the wanted effect, you should rather use [[setWPPos]] to the unit's current position (thereby stopping the unit), and (after a small delay) use [[deleteWaypoint]] to remove the next [[waypoints]].
}}


<dt><dt>
{{Note
<dd class="notedate">Posted on 1 Feb, 2008 - 07:48</dd>
|user= VictorFarbau
<dt class="note">[[User:Saintolaf|Saintolaf]]</dt>
|timestamp= 20081115133700
<dd class="note">
|text= Another (more foolproof) method to avoid the problem of non-deleteable waypoints is to introduce another group ([[createGroup]]) and [[join]] all units of the present group. A new group will start without any preset waypoints so you can start setting new WPs all over again.
In order to change the behavior of a unit currently following some waypoints, it is not enough to use [[deleteWaypoint]].
To achieve the wanted effect, you should rather use [[setWPPos]] to the unit's current position (thereby stopping the unit), and (after a small delay) use [[deleteWaypoint]] to remove the next [[waypoints]].
<dt><dt>
<dd class="notedate">Posted on 15 Nov, 2008 - 13:37</dd>
<dt class="note">[[User:VictorFarbau|VictorFarbau]]</dt>
<dd class="note">
Another (more foolproof) method to avoid the problem of non-deleteable waypoints is to introduce another group ([[createGroup]]) and [[join]] all units of the present group. A new group will start without any preset waypoints so you can start setting new WPs all over again.
Old group is "_combatGroup", new group is "_combatGroup2"
Old group is "_combatGroup", new group is "_combatGroup2"
<code>_combatGroup2 = [[createGroup]] [[east]];
<sqf>
{ [_x] [[joinSilent]] _combatGroup2 } [[forEach]] ([[units]] _combatGroup);
_combatGroup2 = createGroup east;
_combatGroup2 [[addWaypoint]] [<nowiki/>[[getPos]] [[player]], 25];</code>
{ [_x] joinSilent _combatGroup2 } forEach (units _combatGroup);
 
_combatGroup2 addWaypoint [getPos player, 25];
</dl>
</sqf>
}}


{{Note
|user= Mr H.
|timestamp= 20191117165200
|text= To have the unit stop on the spot you need to set its current waypoint where it is and add a little delay, as stated above by [[User|Saintolaf]] so:


<dl class="command_description">
<sqf>
 
group _unit spawn
<dt></dt>
<dd class="notedate">Posted on November 17, 2019 - 16:52 (UTC)</dd>
<dt class="note">[[User:Mr H.|Mr H.]]</dt>
<dd class="note">
To have the unit stop on the spot you need to set its current waypoint where it is and add a little delay, as stated above by [[User|Saintolaf]] so:
 
<code>[[group]] _unit [[spawn]]
{
{
[_this, (currentWaypoint _this)] [[setWaypointPosition]] [<nowiki/>[[getPosASL]] (([[units]] _this) [[select]] 0), -1];
[_this, currentWaypoint _this] setWaypointPosition [getPosASL ((units _this) select 0), -1];
[[sleep]] 0.1;
sleep 0.1;
[[for]] "_i" from [[count]] [[waypoints]] [[Magic Variables#this|_this]] - 1 [[to]] 0 [[step]] -1 [[do]]
for "_i" from count waypoints _this - 1 to 0 step -1 do  
{
{
[[deleteWaypoint]] [<nowiki/>[[Magic Variables#this|_this]], _i];
deleteWaypoint [_this, _i];
};
};
};
};
</code>
</sqf>
Will stop the group where it is and delete its waypoints.
Will stop the group where it is and delete its waypoints.
</dd>
}}
 
</dl>

Latest revision as of 18:09, 27 April 2023

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

Description

Description:
Removes the specified waypoint.
ⓘ
  • When a waypoint is deleted, all other group waypoints are immediately re-indexed. See Example 2 for a deletion of all group's waypoints.
  • Deleting a group's current waypoint will not stop the group on its tracks.
Groups:
Waypoints

Syntax

Syntax:
deleteWaypoint [group, index]
Parameters:
group: Group
index: Number
Return Value:
Nothing

Examples

Example 1:
deleteWaypoint [_grp, 2];
Example 2:
Because waypoints get immediately re-indexed when one gets deleted, delete them from last to first:
private _group = group _unit; for "_i" from (count waypoints _group - 1) to 0 step -1 do { deleteWaypoint [_group, _i]; };
or always delete the first one (if you want to delete them all)
private _group = group _unit; for "_i" from 0 to (count waypoints _group - 1) do { deleteWaypoint [_group, 0]; };
or use forEachReversed:
{ deleteWaypoint _x } forEachReversed waypoints _group; // Arma 3 v2.14+ only

Additional Information

See also:
waypoints setCurrentWaypoint setWaypointPosition setWaypointScript setWaypointStatements setWaypointType addWaypoint

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
Saintolaf - c
Posted on Jan 01, 2008 - 07:48 (UTC)
In order to change the behavior of a unit currently following some waypoints, it is not enough to use deleteWaypoint. To achieve the wanted effect, you should rather use setWPPos to the unit's current position (thereby stopping the unit), and (after a small delay) use deleteWaypoint to remove the next waypoints.
VictorFarbau - c
Posted on Nov 15, 2008 - 13:37 (UTC)
Another (more foolproof) method to avoid the problem of non-deleteable waypoints is to introduce another group (createGroup) and join all units of the present group. A new group will start without any preset waypoints so you can start setting new WPs all over again. Old group is "_combatGroup", new group is "_combatGroup2"
_combatGroup2 = createGroup east; { [_x] joinSilent _combatGroup2 } forEach (units _combatGroup); _combatGroup2 addWaypoint [getPos player, 25];
Mr H. - c
Posted on Nov 17, 2019 - 16:52 (UTC)
To have the unit stop on the spot you need to set its current waypoint where it is and add a little delay, as stated above by Saintolaf so:
group _unit spawn { [_this, currentWaypoint _this] setWaypointPosition [getPosASL ((units _this) select 0), -1]; sleep 0.1; for "_i" from count waypoints _this - 1 to 0 step -1 do { deleteWaypoint [_this, _i]; }; };
Will stop the group where it is and delete its waypoints.
Retrieved from "https://community.bistudio.com/wiki?title=deleteWaypoint&oldid=339202"