setPos: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(Modified comment on the behaviour of setPos with triggers)
No edit summary
Line 1: Line 1:
[[Category:Scripting Commands|SETPOS]]
{{Command|= Comments
[[Category:Scripting Commands OFP 1.96|SETPOS]]
____________________________________________________________________________________________
[[Category:Scripting Commands OFP 1.46|SETPOS]]
[[Category:Scripting Commands ArmA|SETPOS]]


| ofp |= Game name


<h2 style="color:#000066">'''''obj'' setPos ''pos'''''</h2>
|1.00|= Game version
____________________________________________________________________________________________


| Set object position.
Pos array format is [[Position]]. See also [[getPos]]
Examples: [[player]] setPos [ [[getPos]] [[player]] [[select]] 0, ([[getPos]] [[player]] [[select]] 1) + 10]
[[player]] setPos [ [[getPos]] this [[select]] 0, [[getPos]] this [[select]] 1, ([[getPos]] this [[select]] 2) +10]
obj1 setpos [ [[getPos]] obj1 [[select]] 0, [[getPos]] obj1 [[select]] 1, -5] .........Buries obj1 5 metres below ground level.
Comment applicable to Ver 1.96 and earlier: Note that:
obj1 setPos [x,y,z]
Will place most objects z metres above ground level (negative numbers for underground). But if obj1 is a trigger then it will be placed z metres above sea level. This can be very useful if you want to check a unit's height above sea level but it can be a problem if you want to move a trigger to create an explosion or a sound. To move a trigger to a location at ground level: triggername setPos [x,y,0]
triggername setPos [x,y,[[abs]]([[getPos]] triggername select 2)]
Note for Armed Assault: Using setPos for a trigger will work in exactly the same way that setPos works for other objects - namely that setPos [x,y,z] will place the trigger z metres above ground level. See also: [[setPosASL]] |= Description
____________________________________________________________________________________________


'''Operand types:'''
| obj '''setPos''' pos |= Syntax


'''obj:''' [[Object]]
|p1= obj: [[Object]] |= Parameter 1


'''pos:''' [[Array]]
|p2= pos: [[Array]] |= Parameter 2


'''Type of returned value:'''
| [[Nothing]] |= Return value
____________________________________________________________________________________________


[[Nothing]]
|  |= See also


'''Description:'''
}}


Set '''object''' position.<br>
<h3 style="display:none">Notes</h3>
'''Pos''' array format is [[Position]].
<dl class="command_description">
<!-- Note Section BEGIN -->


See also [[getPos]]
<!-- Note Section END -->
</dl>


 
<h3 style="display:none">Bottom Section</h3>
'''Examples:'''
[[Category:Scripting Commands|SETPOS]]
 
[[Category:Scripting Commands OFP 1.96|SETPOS]]
[[player]] '''setPos''' [ [[getPos]] [[player]] [[select]] 0, ([[getPos]] [[player]] [[select]] 1) + 10]<br>
[[Category:Scripting Commands OFP 1.46|SETPOS]]
[[player]] '''setPos''' [ [[getPos]] '''this''' [[select]] 0, [[getPos]] '''this''' [[select]] 1, ([[getPos]] '''this''' [[select]] 2) +10]<br>
[[Category:Scripting Commands ArmA|SETPOS]]
obj1 '''setpos''' [ [[getPos]] obj1 [[select]] 0, [[getPos]] obj1 [[select]] 1, -5] .........Buries obj1 5 metres below ground level.
 
 
'''Comment applicable to Ver 1.96 and earlier:'''
 
Note that:<br>
 
obj1 '''setPos''' [x,y,z]<br>
 
Will place most objects '''z''' metres above ground level (negative numbers for underground).
 
But if obj1 is a '''trigger''' then it will be placed '''z''' metres above '''sea level'''.
 
This can be very useful if you want to check a unit's height above sea level but it can be a problem if you want to move a trigger to create an explosion or a sound.
 
To move a trigger to a location at ground level:
 
''triggername'' '''setPos''' [x,y,0]<br>
''triggername'' '''setPos''' [x,y,[[abs]]([[getPos]] ''triggername'' select 2)]
 
 
'''Note for Armed Assault:'''
 
Using setPos for a trigger will work in exactly the same way that setPos works for other objects - namely that setPos [x,y,z] will place the trigger z metres above ground level.  See also: [[setPosASL]]

Revision as of 00:26, 2 August 2006

Hover & click on the images for description

Description

Description:
Set object position. Pos array format is Position. See also getPos Examples: player setPos [ getPos player select 0, (getPos player select 1) + 10] player setPos [ getPos this select 0, getPos this select 1, (getPos this select 2) +10] obj1 setpos [ getPos obj1 select 0, getPos obj1 select 1, -5] .........Buries obj1 5 metres below ground level. Comment applicable to Ver 1.96 and earlier: Note that: obj1 setPos [x,y,z] Will place most objects z metres above ground level (negative numbers for underground). But if obj1 is a trigger then it will be placed z metres above sea level. This can be very useful if you want to check a unit's height above sea level but it can be a problem if you want to move a trigger to create an explosion or a sound. To move a trigger to a location at ground level: triggername setPos [x,y,0] triggername setPos [x,y,abs(getPos triggername select 2)] Note for Armed Assault: Using setPos for a trigger will work in exactly the same way that setPos works for other objects - namely that setPos [x,y,z] will place the trigger z metres above ground level. See also: setPosASL
Groups:
Uncategorised

Syntax

Syntax:
obj setPos pos
Parameters:
obj: Object
pos: Array
Return Value:
Nothing

Examples

Examples:
Example needed

Additional Information

See also:
See also needed

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

Bottom Section