setPosATL: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (template:command argument fix)
mNo edit summary
 
(58 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma2 |= Game name
|game1= arma2
|version1= 1.03


|1.03|= Game version
|game2= arma2oa
|version2= 1.50


|arg= global |Multiplayer Arguments=
|game3= tkoh
|version3= 1.00


|eff= global |Multiplayer Effects=
|game4= arma3
____________________________________________________________________________________________
|version4= 0.50


| Sets the position of an object relative to the terrain. |DESCRIPTION=
|arg= global
____________________________________________________________________________________________


| object '''setPosATL''' pos |SYNTAX=
|eff= global


|p1= object: [[Object]] |PARAMETER1=
|gr1= Positions


|p2= pos: [[Array]] - format [[PositionATL]] |PARAMETER2=
|descr= Sets the position of an object relative to the terrain.


| [[Nothing]] |RETURNVALUE=
|s1= object [[setPosATL]] pos
____________________________________________________________________________________________


|x1= <code>[[player]] [[setPosATL]] <nowiki>[</nowiki>[[getPosATL]] [[player]] [[select]] 0, ([[getPosATL]] [[player]] [[select]] 1) - 10, [[getPosATL]] [[player]] [[select]] 2];</code> |EXAMPLE1=
|p1= object: [[Object]]
____________________________________________________________________________________________


| [[getPosATL]], [[getPos]], [[getPosASL]], [[setPos]], [[setPosASL]] |SEEALSO=
|p2= pos: [[Array]] format [[Position#PositionATL|PositionATL]]
 
|r1= [[Nothing]]
 
|x1= <sqf>player setPosATL [getPosATL player select 0, (getPosATL player select 1) - 10, getPosATL player select 2];</sqf>
 
|seealso= [[getPosATL]] [[getPos]] [[getPosASL]] [[setPos]] [[setPosASL]]
}}
}}


<h3 style="display:none">Notes</h3>
{{Note
<dl class="command_description">
|user= DreadedEntity
<!-- Note Section BEGIN -->
|timestamp= 20141111203900
<dd class="notedate">Posted on Feb 26, 2012 - 18:12 (CEST)
|text= If you plan on creating bases through script, [[setPosATL]] and [[getPosATL]] will be your friends. Other commands like [[getPos]] or [[getPosASL]] '''will''' return the position relative to any objects that are underneath / to the terrain.
<dt class="note">'''[[User:Lou Montana|Lou Montana]]'''
I wrote a base building helper script and through multiple tests, I have found that [[getPosATL]] is the absolute best way to get position for objects that are over land.
<dd class="note"> '''Please Note :''' this command '''demands''' [[PositionATL]] format ; one does not simply give 2D position, as this function won't do anything.
}}
<!-- Note Section END -->
</dl>


[[Category:ArmA 2: New Scripting Commands List|{{uc:{{PAGENAME}}}}]]
{{Note
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
|user= Hypoxic125
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
|timestamp= 20220930040303
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
|text= As of '''Verson 2.10''', if you use '''setPosX''' commands on a remote unit within a vehicle, the unit will remain in the vehicle. In order to avoid this, '''remoteExec''' the command to the remote client.
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]


<!-- CONTINUE Notes -->
<sqf>
<dl class="command_description">
if !(isNull objectParent _unit) then {
<dd class="notedate">Posted on November 11, 2014 - 20:39 (UTC)</dd>
[_unit, [0,0,0]] remoteExec ["setPosATL", _unit];
<dt class="note">[[User:DreadedEntity|DreadedEntity]]</dt>
};
<dd class="note">
</sqf>
If you plan on creating bases through script, [[setPosATL]] and [[getPosATL]] will be your friends. Other commands like [[getPos]] or [[getPosASL]] '''will''' return the position relative to any objects that are underneath. I wrote a base building helper script and through multiple tests, I have found that [[getPosATL]] is the absolute best way to get position for objects that are over land.
}}
</dd>
</dl>
<!-- DISCONTINUE Notes -->

Latest revision as of 21:33, 28 September 2023

Hover & click on the images for description

Description

Description:
Sets the position of an object relative to the terrain.
Groups:
Positions

Syntax

Syntax:
object setPosATL pos
Parameters:
object: Object
pos: Array format PositionATL
Return Value:
Nothing

Examples

Example 1:

Additional Information

See also:
getPosATL getPos getPosASL setPos setPosASL

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
DreadedEntity - c
Posted on Nov 11, 2014 - 20:39 (UTC)
If you plan on creating bases through script, setPosATL and getPosATL will be your friends. Other commands like getPos or getPosASL will return the position relative to any objects that are underneath / to the terrain. I wrote a base building helper script and through multiple tests, I have found that getPosATL is the absolute best way to get position for objects that are over land.
Hypoxic125 - c
Posted on Sep 30, 2022 - 04:03 (UTC)
As of Verson 2.10, if you use setPosX commands on a remote unit within a vehicle, the unit will remain in the vehicle. In order to avoid this, remoteExec the command to the remote client.
if !(isNull objectParent _unit) then { [_unit, [0,0,0]] remoteExec ["setPosATL", _unit]; };