createMarker: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Bot: Replacing category Scripting Commands Arma 3 with Arma 3: Scripting Commands)
m (Text replacement - "|pr= setMarkerDrawPriority sorts allMapMarkers from least to most priority. As of {{GVI|arma3|2.16|size= 0.75}} createMarker/createMarkerLocal do '''not''' care about drawing priority and add the created marker to the end of the array, making it top priority. Running setMarkerDrawPriority again sorts this issue." to "|pr= setMarkerDrawPriority sorts allMapMarkers from least to most priority. Before {{GVI|arma3|2.18|size= 0.75}} createMarker/...)
 
(115 intermediate revisions by 10 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


|eff= global |= Effects in MP
|game3= arma2oa
____________________________________________________________________________________________
|version3= 1.50


| Creates a new marker at the given position. The marker name has to be unique. If position is given in 3D format, <tt>z</tt> coordinate is stored with the marker and will be used when marker is passed to commands like [[createVehicle]], [[createUnit]], [[createAgent]], [[createMine]], [[setVehiclePosition]] for example. However [[getMarkerPos]] and [[markerPos]] will always return 0 for <tt>z</tt>. |= Description
|game4= tkoh
____________________________________________________________________________________________
|version4= 1.00


| '''createMarker''' [name, position] |= Syntax
|game5= arma3
|version5= 0.50


|p1= [name, position]: [[Array]] |= Parameter 1
|gr1= Markers
|p2= name: [[String]] |= Parameter 2
|p3= position: [[Array]] or [[Object]] - format position: [[Position2D]], [[PositionAGL]] or [[Object]] |= Parameter 3


| [[String]] |= Return value
|eff= global
____________________________________________________________________________________________
 
|x1= <code>_marker1 = [[createMarker]] ["Marker1", [[position]] [[player]]];</code> |= Example 1
|x2= <code>_marker2 = [[createMarker]] ["Marker2", [[player]]];</code> |= Example 2
____________________________________________________________________________________________
|mp= createMarker is global, use [[createMarkerLocal]] if you want to create a marker locally|=


|[[createMarkerLocal]], [[allMapMarkers]], [[setMarkerBrush]], [[setMarkerColor]], [[setMarkerDir]], [[setMarkerPos]], [[setMarkerShape]], [[setMarkerSize]], [[setMarkerText]], [[setMarkerType]], [[setMarkerAlpha]]
|descr= Creates a new map marker at the given position. The marker will be created for every connected player as well as all JIP players. The marker name has to be unique; the command will be ignored if a marker with the given name already exists.
|= See also


{{Feature|important|
The marker will be visible only once at least [[markerType]] has been defined:
<sqf>
_marker = createMarker ["markername", player]; // Not visible yet.
_marker setMarkerType "hd_dot"; // Visible.</sqf>
}}
}}


<h3 style="display:none">Notes</h3>
{{Feature|informative|If the marker position is given in 3D format, the {{hl|z}}-coordinate is stored with the marker and will be used when the marker is passed to commands such as [[createVehicle]], [[createUnit]], [[createAgent]], [[createMine]] or [[setVehiclePosition]].<br>When a marker is manually placed in the editor, {{hl|z}} is always 0, which means the marker is placed on the ground. But when the player places a marker on the map in game, it is placed at sea level, so the {{hl|z}}-coordinate of that marker is <sqf inline>-getTerrainHeightASL markerPos "userMarker";</sqf>.}}
<dl class="command_description">
<!-- Note Section BEGIN -->
To create a marker which is visible on the map you need to define ''at least'' the following three settings:
<code>_markerstr = [[createMarker]] ["markername",[_Xpos,_Ypos]];
_markerstr [[setMarkerShape]] "ICON";
_markerstr [[setMarkerType]] "hd_dot";</code>
<!-- Note Section END -->
</dl>


<h3 style="display:none">Bottom Section</h3>
|mp= {{Feature|informative|'''Multiplayer optimisation:''' Global marker commands always broadcast the ''entire'' marker state over the network. As such, the number of network messages exchanged when creating or editing a marker can be reduced by performing all but the last operation using local marker commands, then using a global marker command for the last change (and subsequent global broadcast of all changes applied to the marker).}}
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on September 19, 2015 - 21:02 (UTC)</dd>
<dt class="note">[[User:Soldia (JP)|Soldia (JP)]]</dt>
<dd class="note">
createMarker accepts an object as position parameter as well (A3 - 1.50.131969). You could try this with the following code (both SP/MP)


<code>_markerstr = createMarker ["markername", player];
|pr= [[setMarkerDrawPriority]] sorts [[allMapMarkers]] from least to most priority. Before {{GVI|arma3|2.18|size= 0.75}} [[createMarker]]/[[createMarkerLocal]] did '''not''' care about drawing priority and added the created marker to the end of the array, making it top priority. Running [[setMarkerDrawPriority]] again sorted this issue.
 
|s1= [[createMarker]] [name, position, channel, creator]
 
|p1= name: [[String]] - the marker's name, used to reference the marker in scripts.
 
|p2= position: [[Array]] or [[Object]] - [[Position#Introduction|Position2D]], [[Position#PositionAGL|PositionAGL]] or [[Object]]. In case of an object, the object's '''model centre'''<nowiki/>'s [[Position#PositionASL|PositionASL]] is used (see [[getPosWorld]])
 
|p3= channel: [[Number]] - (Optional, default -1) the marker channel - see [[Channel IDs]] (for multiplayer)
|p3since= arma3 2.02
 
|p4= creator: [[Object]] - (Optional, default [[objNull]]) the marker creator (for multiplayer)
|p4since= arma3 2.02
 
|r1= [[String]] - the marker's name or empty string if the marker name is not unique.
 
|x1= <sqf>_marker1 = createMarker ["Marker1", position player];</sqf>
 
|x2= <sqf>_marker2 = createMarker ["Marker2", player]; // since {{arma3}} 1.50</sqf>
 
|seealso= [[createMarkerLocal]] [[deleteMarker]] [[BIS_fnc_markerToString]] [[BIS_fnc_stringToMarker]]
}}
 
{{Note
|user= Soldia
|timestamp= 20150919210200
|text= [[createMarker]] accepts an object as position parameter as well . You could try this with the following code (both SP/MP)
 
<sqf>
_markerstr = createMarker ["markername", player];
_markerstr setMarkerShape "RECTANGLE";
_markerstr setMarkerShape "RECTANGLE";
_markerstr setMarkerSize [100,100];</code>
_markerstr setMarkerSize [100, 100];
</dd>
</sqf>
</dl>
|game= arma3
<!-- DISCONTINUE Notes -->
|version= 1.50
}}


<!-- CONTINUE Notes -->
{{Note
<dl class="command_description">
|user= X39
<dd class="notedate">Posted on May 28, 2018 - 11:57 (UTC)</dd>
|timestamp= 20180528115700
<dt class="note">[[User:x39|x39]]</dt>
|text= In {{arma3}}, one can create markers which are deletable by the user by prefixing the name with {{hl|_USER_DEFINED}}.
<dd class="note">
In Arma 3, one can create markers which are deletable by the user by prefixing the name with `_USER_DEFINED`.


Example: <code>createMarker "_USER_DEFINED somemarkername"</code>
Example:
</dd>
<sqf>createMarker "_USER_DEFINED someMarkerName"</sqf>
</dl>
}}
<!-- DISCONTINUE Notes -->


[[Category:Scripting Commands|CREATEMARKER]]
{{Note
[[Category:Scripting Commands OFP Elite|CREATEMARKER]]
|user= 7erra
[[Category:Scripting Commands ArmA|CREATEMARKER]]
|timestamp= 20190503155300
[[Category:Command Group: Markers|CREATEMARKER]]
|text= There is a new function with which you can create a marker with all settings applied in one step: [[BIS_fnc_stringToMarker]] and [[BIS_fnc_stringToMarkerLocal]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
|game= arma3
[[Category:Arma 3: Scripting Commands]]
|version= 1.92
[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]
}}
 
{{Note
|user= Tirpitz
|timestamp= 20210126224200
|text= When creating a marker with the name format: "_USER_DEFINED #n1/n2/n3".
n1 can be used to set the owner, n2 I think is an incrementing index to ensure markers are unique, to this end also mangle some more characters onto the end of the string, and n3 is the channel ID the marker is in.
<sqf>_markerName = format ["_USER_DEFINED #%1/%2/%3" , clientOwner,_index, _ChannelID];
_marker = createMarkerLocal [_markerName, _pos];</sqf>
}}
 
{{Note
|user= POLPOX
|timestamp= 20230708160357
|text= If you use the letter "/" in the name, it may break the channel visibilities (especially in MP).
Possible reason is described above by Tirpitz, the engine may confuse which channel the marker belongs to after the "/".
}}

Latest revision as of 12:53, 24 April 2024

Hover & click on the images for description

Description

Description:
Creates a new map marker at the given position. The marker will be created for every connected player as well as all JIP players. The marker name has to be unique; the command will be ignored if a marker with the given name already exists.
The marker will be visible only once at least markerType has been defined:
_marker = createMarker ["markername", player]; // Not visible yet. _marker setMarkerType "hd_dot"; // Visible.
If the marker position is given in 3D format, the z-coordinate is stored with the marker and will be used when the marker is passed to commands such as createVehicle, createUnit, createAgent, createMine or setVehiclePosition.
When a marker is manually placed in the editor, z is always 0, which means the marker is placed on the ground. But when the player places a marker on the map in game, it is placed at sea level, so the z-coordinate of that marker is -getTerrainHeightASL markerPos "userMarker";.
Multiplayer:
Multiplayer optimisation: Global marker commands always broadcast the entire marker state over the network. As such, the number of network messages exchanged when creating or editing a marker can be reduced by performing all but the last operation using local marker commands, then using a global marker command for the last change (and subsequent global broadcast of all changes applied to the marker).
Problems:
setMarkerDrawPriority sorts allMapMarkers from least to most priority. Before Arma 3 logo black.png2.18 createMarker/createMarkerLocal did not care about drawing priority and added the created marker to the end of the array, making it top priority. Running setMarkerDrawPriority again sorted this issue.
Groups:
Markers

Syntax

Syntax:
createMarker [name, position, channel, creator]
Parameters:
name: String - the marker's name, used to reference the marker in scripts.
position: Array or Object - Position2D, PositionAGL or Object. In case of an object, the object's model centre's PositionASL is used (see getPosWorld)
since Arma 3 logo black.png2.02
channel: Number - (Optional, default -1) the marker channel - see Channel IDs (for multiplayer)
since Arma 3 logo black.png2.02
creator: Object - (Optional, default objNull) the marker creator (for multiplayer)
Return Value:
String - the marker's name or empty string if the marker name is not unique.

Examples

Example 1:
_marker1 = createMarker ["Marker1", position player];
Example 2:
_marker2 = createMarker ["Marker2", player]; // since Arma 3 1.50

Additional Information

See also:
createMarkerLocal deleteMarker BIS_fnc_markerToString BIS_fnc_stringToMarker

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
Soldia - c
Posted on Sep 19, 2015 - 21:02 (UTC)

createMarker accepts an object as position parameter as well . You could try this with the following code (both SP/MP)

_markerstr = createMarker ["markername", player]; _markerstr setMarkerShape "RECTANGLE"; _markerstr setMarkerSize [100, 100];

X39 - c
Posted on May 28, 2018 - 11:57 (UTC)
In Arma 3, one can create markers which are deletable by the user by prefixing the name with _USER_DEFINED. Example:
createMarker "_USER_DEFINED someMarkerName"
7erra - c
Posted on May 03, 2019 - 15:53 (UTC)

There is a new function with which you can create a marker with all settings applied in one step: BIS_fnc_stringToMarker and BIS_fnc_stringToMarkerLocal

Tirpitz - c
Posted on Jan 26, 2021 - 22:42 (UTC)
When creating a marker with the name format: "_USER_DEFINED #n1/n2/n3". n1 can be used to set the owner, n2 I think is an incrementing index to ensure markers are unique, to this end also mangle some more characters onto the end of the string, and n3 is the channel ID the marker is in.
_markerName = format ["_USER_DEFINED #%1/%2/%3" , clientOwner,_index, _ChannelID]; _marker = createMarkerLocal [_markerName, _pos];
POLPOX - c
Posted on Jul 08, 2023 - 16:03 (UTC)
If you use the letter "/" in the name, it may break the channel visibilities (especially in MP). Possible reason is described above by Tirpitz, the engine may confuse which channel the marker belongs to after the "/".