allMapMarkers: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(description, info about user markers)
m (Some wiki formatting)
 
(65 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma3 |= Game name
|game1= arma3
|version1= 0.50


|0.50|= Game version
|gr1= Markers
____________________________________________________________________________________________


| Return 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.57.134377 User define marker have the following name format: <br><tt>_USER_DEFINED #<PlayerID>/<MarkerID>/<ChannelID></tt> where:
* <PlayerID> - unique network id of the player (same as _id in [[onPlayerConnected]])
* <MarkerID> - a marker counter id
* <ChannelID> - id of the chat channel on which marker was placed (see [[currentChannel]])
|= Description
____________________________________________________________________________________________


| '''allMapMarkers''' |= Syntax
{{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]].
}}


| [[Array]] of [[String]]s|= RETURNVALUE
|s1= [[allMapMarkers]]


|x1= <code>_markers = [[allMapMarkers]];</code>
|r1= [[Array]] of [[String]]s


returns: ["marker1","_USER_DEFINED #2/0"]|= EXAMPLE1
|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> |= EXAMPLE2
{
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> |= EXAMPLE3
</sqf>
____________________________________________________________________________________________
 
| [[createMarker]], [[deleteMarker]] |= SEEALSO


| |= MPBEHAVIOUR
|seealso= [[createMarker]] [[deleteMarker]] [[customWaypointPosition]]
____________________________________________________________________________________________
}}
}}
<h3 style='display:none'>Notes</h3>
<dl class='command_description'>
<!-- Note Section BEGIN -->
<dd class="notedate">Posted on March 17, 2014
<dt class="note">'''[[User:Waffle SS.|Waffle SS.]]'''
<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 #."
<dd class="notedate">Posted on March 17, 2014
<dt class="note">[[User:Killzone_Kid|Killzone_Kid]]
<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>
<!-- Note Section END -->
</dl>
<h3 style='display:none'>Bottom Section</h3>
[[Category:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Command Group: Markers|{{uc:{{PAGENAME}}}}]]

Latest revision as of 19:05, 17 February 2024

Arma 3 logo black.png0.50
Hover & click on the images for description

Description

Description:
Returns all map marker names, including user-placed markers.
ⓘ
  • Arma 3 logo black.png1.58 User-defined markers have the following name format: _USER_DEFINED #<PlayerID>/<MarkerID>/<ChannelID>, where:
  • To obtain the custom waypoint's (set with ⇧ Shift + Left Mouse Button) 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
Retrieved from "https://community.bistudio.com/wiki?title=allMapMarkers&oldid=352645"