allMapMarkers: Difference between revisions

Latest revision as of 19:05, 17 February 2024

0.50

Hover & click on the images for description

Description

Description:

Returns all map marker names, including user-placed markers.

ⓘ

1.58 User-defined markers have the following name format: _USER_DEFINED #<PlayerID>/<MarkerID>/<ChannelID>, where:
- <PlayerID> - unique network id of the player in String format, also available as String in the 6th param in "PlayerConnected" and "PlayerDisconnected" Event Handlers
- <MarkerID> - an incrementing marker counter id
- <ChannelID> - id of the chat channel in which the marker was placed (see currentChannel)
To obtain the custom waypoint's (set with ⇧ Shift + ) position, see customWaypointPosition.

Groups:

Markers

Syntax

Syntax:: allMapMarkers
Return Value:: Array of Strings

Examples

Example 1:: _markers = allMapMarkers; // returns e.g ["marker1", "_USER_DEFINED #2/0"]
Example 2:: { private "_a"; _a = toArray _x; _a resize 15; if (toString _a == "_USER_DEFINED #") then // or if (_x select [0, 15] == "_USER_DEFINED #") since Arma 3 v1.28 { deleteMarker _x; }; } forEach allMapMarkers;
Example 3:: if (_someString in allMapMarkers) then { hint (_someString + " is an existing marker"); };

Additional Information

See also:: createMarker deleteMarker customWaypointPosition

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

@@ Line 1: / Line 1: @@
 {{RV|type=command
-| arma3
+|game1= arma3
+|version1= 0.50
-|0.50
 |gr1= Markers
-| Returns all markers in map including user placed markers (_USER_DEFINED #). <br><br>
+|descr= Returns all map marker names, including user-placed markers.
-Since Arma 3 v1.58 User defined markers have the following name format: <br><tt>_USER_DEFINED #<PlayerID>/<MarkerID>/<ChannelID></tt> where:
-* <PlayerID> - unique network id of the player in [[String]] format, also available as [[String]] in the 6th param in [[Arma_3:_Event_Handlers/addMissionEventHandler#PlayerConnected | "PlayerConnected"]] and [[Arma_3:_Event_Handlers/addMissionEventHandler#PlayerDisconnected|"PlayerDisconnected"]] EHs
-* <MarkerID> - a marker counter id
-* <ChannelID> - id of the chat channel on which marker was placed (see [[currentChannel]])
-For custom waypoint position (LShift+LMB) see [[customWaypointPosition]]
-\|s1= '''allMapMarkers'''
+{{Feature|informative|
+* {{GVI|arma3|1.58|size= 0.75}} User-defined markers have the following name format: {{hl|_USER_DEFINED #<PlayerID>/<MarkerID>/<ChannelID>}}, where:
+** <PlayerID> - unique network id of the player in [[String]] format, also available as [[String]] in the 6th param in [[Arma 3: Mission Event Handlers#PlayerConnected | "PlayerConnected"]] and [[Arma 3: Mission Event Handlers#PlayerDisconnected|"PlayerDisconnected"]] Event Handlers
+** <MarkerID> - an incrementing marker counter id
+** <ChannelID> - id of the chat channel in which the marker was placed (see [[currentChannel]])
+* To obtain the custom waypoint's (set with {{Controls|LShift|LMB}}) position, see [[customWaypointPosition]].
+}}
-|r1=[[Array]] of [[String]]s
+|s1= [[allMapMarkers]]
-|x1= <code>_markers = [[allMapMarkers]];</code>
+|r1= [[Array]] of [[String]]s
-returns: ["marker1","_USER_DEFINED #2/0"]
+|x1= <sqf>_markers = allMapMarkers; // returns e.g ["marker1", "_USER_DEFINED #2/0"]</sqf>
-|x2= <code>{
+|x2= <sqf>
-  [[private]] "_a";
+{
-  _a = [[toArray]] _x;
+	private "_a";
-  _a [[resize]] 15;
+	_a = toArray _x;
-  [[if]] ([[toString]] _a == "_USER_DEFINED #") [[then]] {
+	_a resize 15;
-    [[deleteMarker]] _x;
+	if (toString _a == "_USER_DEFINED #") then
-  }
+	// or if (_x select [0, 15] == "_USER_DEFINED #") since {{arma3}} v1.28
-} [[forEach]] [[allMapMarkers]];</code>
+	{
+		deleteMarker _x;
+	};
+} forEach allMapMarkers;
+</sqf>
-|x3= <code>[[if]] (_someString [[in]] [[allMapMarkers]]) [[then]] {
+|x3= <sqf>
-  [[hint]] (_someString [[valuea_plus_valueb|+]] " is a valid marker name");
+if (_someString in allMapMarkers) then
+{
+	hint (_someString + " is an existing marker");
 };
-</code>
+</sqf>
-|seealso= [[createMarker]], [[deleteMarker]], [[customWaypointPosition]]
+|seealso= [[createMarker]] [[deleteMarker]] [[customWaypointPosition]]
 }}
-<dl class="command_description">
-<dt><dt>
-<dd class="notedate">Posted on March 17, 2014</dd>
-<dt class="note">[[User:Waffle SS.|Waffle SS.]]</dt>
-<dd class="note">'''A3 1.12''': Markers placed in editor will be in the array as a string of their name. Markers placed by the player will begin with "_USER_DEFINED #."
-<dt><dt>
-<dd class="notedate">Posted on March 17, 2014</dd>
-<dt class="note">[[User:Killzone_Kid|Killzone_Kid]]</dt>
-<dd class="note">To expand on the comment above. In Multiplayer, user created marker will appear in [[allMapMarkers]] as _USER_DEFINED #ID/Number, where ID is unique id related to _id param from [[onPlayerConnected]] and Number is sequential integer incremented by 1 with each marker placement by the IDed user.
-<BR><BR>
-</dl>