createMarker: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(see also)
m (Fix page)
Line 1: Line 1:
{{Command|= Comments
{{Command|Comments=
____________________________________________________________________________________________
____________________________________________________________________________________________


| arma |= Game name
| arma |Game name=


|1.00|= Game version
|1.00|Game version=


|eff= global |= Effects in MP
|eff= global |Effects in MP=
____________________________________________________________________________________________
____________________________________________________________________________________________


| Creates a new map marker at the given position. The marker will be created for every player on network as well as JIP. The marker name has to be unique, if a marker with the given name exists, the command will be ignored. Use [[deleteMarker]] to delete global marker.<br><br>
| Creates a new map marker at the given position. The marker will be created for every player on network as well as JIP. The marker name has to be unique, if a marker with the given name exists, the command will be ignored. Use [[deleteMarker]] to delete global marker.<br />
<br />
{{Important|The marker will be visible if you define ''at least'' [[markerShape]] and [[markerType]] settings:
<code>_markerName {{=}} [[createMarker]] ["markername", [_Xpos, _Ypos]];
_markerName [[setMarkerShape]] "ICON";
_markerName [[setMarkerType]] "hd_dot";</code>
}}


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
{{Informative|If position is given in 3D format, the <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=
____________________________________________________________________________________________
____________________________________________________________________________________________


| '''createMarker''' [name, position] |= Syntax
| [[createMarker]] [name, position] |Syntax=


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


| [[String]] |= Return value
|p2= name: [[String]] |Parameter 2=
 
|p3= position: [[Array]] or [[Object]] - format position: [[Position2D]], [[PositionAGL]] or [[Object]] |Parameter 3=
 
| [[String]] |Return value=
____________________________________________________________________________________________
____________________________________________________________________________________________
   
   
|x1= <code>_marker1 = [[createMarker]] ["Marker1", [[position]] [[player]]];</code> |= Example 1
|x1= <code>_marker1 = [[createMarker]] ["Marker1", [[position]] [[player]]];</code> |Example 1=
|x2= <code>_marker2 = [[createMarker]] ["Marker2", [[player]]];</code> |= Example 2
|x2= <code>_marker2 = [[createMarker]] ["Marker2", [[player]]]; {{codecomment|// since {{arma3}} v1.50}}</code> |Example 2=
____________________________________________________________________________________________
____________________________________________________________________________________________
|mp= createMarker is global, use [[createMarkerLocal]] if you want to create a marker locally|=


| [[allMapMarkers]], [[deleteMarker]], [[createMarkerLocal]], [[allMapMarkers]], [[setMarkerBrush]], [[setMarkerColor]], [[setMarkerDir]], [[setMarkerPos]], [[setMarkerShape]], [[setMarkerSize]], [[setMarkerText]], [[setMarkerType]], [[setMarkerAlpha]]
|mp= [[createMarker]] is global, use [[createMarkerLocal]] if you want to create a [[local]] marker |multiplayer=
|= See also


| [[allMapMarkers]], [[deleteMarker]], [[createMarkerLocal]], [[allMapMarkers]],
[[setMarkerBrush]], [[setMarkerColor]], [[setMarkerDir]],
[[setMarkerPos]], [[setMarkerShape]], [[setMarkerSize]],
[[setMarkerText]], [[setMarkerType]], [[setMarkerAlpha]] |See also=
}}
}}


<h3 style="display:none">Notes</h3>
<h3 style="display:none">Notes</h3>
<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>
[[Category:Scripting Commands|CREATEMARKER]]
[[Category:Scripting Commands OFP Elite |CREATEMARKER]]
[[Category:Scripting Commands ArmA|CREATEMARKER]]
[[Category:Command Group: Markers|CREATEMARKER]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
<!-- CONTINUE Notes -->
<dl class="command_description">
<dl class="command_description">
<dd class="notedate">Posted on September 19, 2015 - 21:02 (UTC)</dd>
<dd class="notedate">Posted on September 19, 2015 - 21:02 (UTC)</dd>
Line 60: Line 50:
createMarker accepts an object as position parameter as well (A3 - 1.50.131969). You could try this with the following code (both SP/MP)
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];
<code>_markerstr = [[createMarker]] ["markername", [[player]]];
_markerstr setMarkerShape "RECTANGLE";
_markerstr [[setMarkerShape]] "RECTANGLE";
_markerstr setMarkerSize [100,100];</code>
_markerstr [[setMarkerSize]] [100, 100];</code>
</dd>
</dd>
</dl>
</dl>
Line 74: Line 64:
In Arma 3, one can create markers which are deletable by the user by prefixing the name with `_USER_DEFINED`.
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: <code>[[createMarker]] "_USER_DEFINED someMarkerName"</code>
</dd>
</dd>
</dl>
</dl>
<!-- DISCONTINUE Notes -->
 
 
<h3 style="display:none">Bottom Section</h3>
[[Category:Command Group: Markers|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP Elite |{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]

Revision as of 01:25, 3 February 2019

-wrong parameter ("Arma") defined!-1.00
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 player on network as well as JIP. The marker name has to be unique, if a marker with the given name exists, the command will be ignored. Use deleteMarker to delete global marker.

The marker will be visible if you define at least markerShape and markerType settings:

_markerName = createMarker ["markername", [_Xpos, _Ypos]]; _markerName setMarkerShape "ICON";

_markerName setMarkerType "hd_dot";
If position is given in 3D format, the z 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 z.
Multiplayer:
createMarker is global, use createMarkerLocal if you want to create a local marker
Groups:
Uncategorised

Syntax

Syntax:
createMarker [name, position]
Parameters:
[name, position]: Array
name: String
position: Array or Object - format position: Position2D, PositionAGL or Object
Return Value:
String

Examples

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

Additional Information

See also:
allMapMarkersdeleteMarkercreateMarkerLocalallMapMarkers, setMarkerBrushsetMarkerColorsetMarkerDir, setMarkerPossetMarkerShapesetMarkerSize, setMarkerTextsetMarkerTypesetMarkerAlpha

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

Notes

Posted on September 19, 2015 - 21:02 (UTC)
Soldia (JP)
createMarker accepts an object as position parameter as well (A3 - 1.50.131969). You could try this with the following code (both SP/MP) _markerstr = createMarker ["markername", player]; _markerstr setMarkerShape "RECTANGLE"; _markerstr setMarkerSize [100, 100];
Posted on May 28, 2018 - 11:57 (UTC)
x39
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"


Bottom Section