setMarkerPos: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " \{\{GameCategory\|[a-z]+[0-9]?\|Scripting Commands\}\}" to "")
No edit summary
 
(29 intermediate revisions by 2 users not shown)
Line 26: Line 26:
|eff= global
|eff= global


|descr= Moves the marker. 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. When [[Object]] is used for position, [[PositionWorld]] of the object is used.
|descr= Moves the marker. If position is given in 3D format, {{hl|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. In case of an object, the object's model [0,0,0] is used.
{{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).}}
{{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).
}}


|s1= markerName '''setMarkerPos''' pos
|s1= markerName [[setMarkerPos]] position


|p1= markerName: [[String]]
|p1= markerName: [[String]]
|p2= pos: [[Array]] - format [[Position2D]], [[PositionAGL]] or [[Object]] (since Arma 3 v1.94)


|r1=[[Nothing]]
|p2= position: [[Array]] format [[Position#Introduction|Position2D]] or [[Position#PositionAGL|PositionAGL]] or {{GVI|arma3|1.94|size= 0.75}} [[Object]]. In case of an object, the object's model [0,0,0] is used.
|r1= [[Nothing]]


|x1= <code>"MarkerOne" '''setMarkerPos''' [[getMarkerPos]] "MarkerTwo"</code>
|x1= <sqf>"MarkerOne" setMarkerPos getMarkerPos "MarkerTwo";</sqf>


|seealso= [[setMarkerPosLocal]], [[setMarkerBrush]], [[setMarkerColor]], [[setMarkerDir]], [[createMarker]], [[setMarkerShape]], [[setMarkerSize]], [[setMarkerText]], [[setMarkerType]], [[setMarkerAlpha]]
|seealso= [[setMarkerPosLocal]] [[setMarkerBrush]] [[setMarkerColor]] [[setMarkerDir]] [[createMarker]] [[setMarkerShape]] [[setMarkerSize]] [[setMarkerText]] [[setMarkerType]] [[setMarkerAlpha]]
}}
}}


<dl class="command_description">
{{Note
|user= Pulverizer
|timestamp= 20070323234700
|text= Effect is local in OFP.
|game= ofp
}}


<dt class="note">[[User:Pulverizer|Pulverizer]]</dt>
{{Note
<dd class="note">Effect is local in OFP.
|user= Dr Eyeball
<dt><dt>
|timestamp= 20090807020300
<dd class="notedate">Posted on August 7, 2009 - 02:03 (CEST)</dd>
|text= The marker position can actually be set in 3D. This has a benefit for respawn markers, when placed at the correct altitude ASL on the LHD, the correct altitude will be used for respawn.
<dt class="note">[[User:Dr Eyeball|Dr Eyeball]]</dt>
There is no particular benefit for regular markers since [[markerPos]] will still return 0 for the altitude array element. // Tip obtained from Xeno
<dd class="note">The marker position can actually be set in 3D. This has a benefit for respawn markers, when placed at the correct altitude ASL on the LHD, the correct altitude will be used for respawn. There is no particular benefit for regular markers since [[markerPos]] will still return 0 for the altitude array element. <!-- Tip obtained from Xeno -->
}}
 
</dl>

Latest revision as of 11:56, 1 November 2024

Hover & click on the images for description

Description

Description:
Moves the marker. If position is given in 3D format, 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. In case of an object, the object's model [0,0,0] is used.
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).
Groups:
Markers

Syntax

Syntax:
markerName setMarkerPos position
Parameters:
markerName: String
position: Array format Position2D or PositionAGL or Arma 3 logo black.png1.94 Object. In case of an object, the object's model [0,0,0] is used.
Return Value:
Nothing

Examples

Example 1:
"MarkerOne" setMarkerPos getMarkerPos "MarkerTwo";

Additional Information

See also:
setMarkerPosLocal setMarkerBrush setMarkerColor setMarkerDir createMarker setMarkerShape setMarkerSize setMarkerText setMarkerType setMarkerAlpha

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
Pulverizer - c
Posted on Mar 23, 2007 - 23:47 (UTC)

Effect is local in OFP.

Dr Eyeball - c
Posted on Aug 07, 2009 - 02:03 (UTC)
The marker position can actually be set in 3D. This has a benefit for respawn markers, when placed at the correct altitude ASL on the LHD, the correct altitude will be used for respawn. There is no particular benefit for regular markers since markerPos will still return 0 for the altitude array element. // Tip obtained from Xeno