visiblePosition: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(New command)
 
m (Text replacement - "↵ ↵|" to " |")
 
(83 intermediate revisions by 10 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 [[Position3D|3D position]] (z value above ground level). |= 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 [[Position3D]] |= Return value
|p1= object: [[Object]] - name of the object


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


| [[position]] |= 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_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
</sqf>
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
}}

Latest revision as of 13:45, 8 April 2024

A2 OA Logo.png1.60tkoh logo small.png1.00Arma 3 logo black.png0.50
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
Retrieved from "https://community.bistudio.com/wiki?title=visiblePosition&oldid=363616"