visiblePosition: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "↵ ↵|" to " |")
 
(76 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma2oa |= Game name
|game1= arma2oa
|version1= 1.60


|1.60|= Game version
|game2= tkoh
____________________________________________________________________________________________
|version2= 1.00


| Returns an object's rendered position (z value above surface underneath) in render time scope. Same as [[getPosVisual]] |= Description
|game3= arma3
____________________________________________________________________________________________
|version3= 0.50


|'''visiblePosition''' object |= Syntax
|gr1= Positions
|gr2= Render Time Scope


|descr= Returns an object's rendered position (z value above surface underneath) in render time scope. Same as [[getPosVisual]].
{{Feature|important|This command must '''not''' be used for actual 3D calculations. See [[getPos]] for an explanation.}}


|p1= object: [[Object]]: - name of the object |= Parameter 1
|s1= [[visiblePosition]] object


| [[Array]] - format [[Position]] |= Return value
|p1= object: [[Object]] - name of the object


____________________________________________________________________________________________
|r1= [[Position#PositionAGLS|PositionAGLS]]
 
|x1= <pre>playerRenderedPos = visiblePosition player;</pre> |= Example 1
____________________________________________________________________________________________


| [[getPosVisual]], [[getPosATLVisual]], [[getPosASLVisual]], [[visiblePositionASL]], [[position]], [[getPos]], [[getPosATL]], [[getPosASL]], [[getPosASLW]]  |= See also
|x1= <sqf>_playerRenderedPos = visiblePosition player;</sqf>


|seealso= [[getPosVisual]] [[getPosATLVisual]] [[getPosASLVisual]] [[getPosWorldVisual]] [[visiblePositionASL]] [[position]] [[getPos]] [[getPosATL]] [[getPosASL]] [[getPosASLW]]
}}
}}


<h3 style="display:none">Notes</h3>
{{Note
<dl class="command_description">
|user= Leopard20
<!-- Note Section BEGIN -->
|timestamp= 20220126151506
<!-- Note Section END -->
|text= Note that this command returns the position in [[Position#PositionAGLS|AGLS]] format (Z is measured from the nearest surface below). For example the value of Z is 0 even if the object is resting on top of a building.<br>
</dl>
For use with draw commands, such as [[drawIcon3D]], an [[Position#PositionAGL|AGL]] position is needed. The following alternatives can be used, depending on where the icon is intended to be shown:
 
<sqf>
<h3 style="display:none">Bottom Section</h3>
ASLToAGL getPosWorldVisual _object // object center in model coordinates, i.e [0,0,0]
 
ASLToAGL getPosASLVisual _object // object land contact (e.g. floor of a building)
[[Category:ArmA 2 OA: New Scripting Commands List|{{uc:{{PAGENAME}}}}]]
unitAimPositionVisual _object // object's aiming position, i.e where the AI aim at, such as a soldier's chest
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
_object modelToWorldVisual _relativePos // custom position in model coordinates. if _relativePos is [0,0,0], it'll be the same as ASLToAGL getPosWorldVisual _object
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
</sqf>
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
}}
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Render Time Scope Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 12:45, 8 April 2024

Hover & click on the images for description

Description

Description:
Returns an object's rendered position (z value above surface underneath) in render time scope. Same as getPosVisual.
This command must not be used for actual 3D calculations. See getPos for an explanation.
Groups:
PositionsRender Time Scope

Syntax

Syntax:
visiblePosition object
Parameters:
object: Object - name of the object
Return Value:
PositionAGLS

Examples

Example 1:
_playerRenderedPos = visiblePosition player;

Additional Information

See also:
getPosVisual getPosATLVisual getPosASLVisual getPosWorldVisual visiblePositionASL position getPos getPosATL getPosASL getPosASLW

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
Leopard20 - c
Posted on Jan 26, 2022 - 15:15 (UTC)
Note that this command returns the position in AGLS format (Z is measured from the nearest surface below). For example the value of Z is 0 even if the object is resting on top of a building.
For use with draw commands, such as drawIcon3D, an AGL position is needed. The following alternatives can be used, depending on where the icon is intended to be shown:
ASLToAGL getPosWorldVisual _object // object center in model coordinates, i.e [0,0,0] ASLToAGL getPosASLVisual _object // object land contact (e.g. floor of a building) unitAimPositionVisual _object // object's aiming position, i.e where the AI aim at, such as a soldier's chest _object modelToWorldVisual _relativePos // custom position in model coordinates. if _relativePos is [0,0,0], it'll be the same as ASLToAGL getPosWorldVisual _object