selectionPosition: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\| *((\[\[[a-zA-Z0-9_ |()]+\]\],? ?)+) * \}\}" to "|seealso= $1 }}")
(page cleanup and formatting)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| arma1
|game1= arma1


|1.00
|version1= 1.00
 
|game2= arma2
 
|version2= 1.00
 
|game3= arma2oa
 
|version3= 1.51
 
|game4= tkoh
 
|version4= 1.00
 
|game5= arma3
 
|version5= 0.50


|arg= global
|arg= global
Line 11: Line 27:
|gr2= Render Time Scope
|gr2= Render Time Scope


| Search for selection in the object model (first in the memory level, then in geometry LODs).<br>
|descr= Returns position in model space and returns its relative position. Searches first in memory level, then in geometry [[LOD]]s.<br>
Returns position in model space. In {{Name|arma1|short}} it returns the initial position of the selection, in {{arma2}}/{{arma3}} position of the selection (e.g. when it is animated) in render time scope. If a selection does not exist [0,0,0] is returned.
In {{arma}} it returns the initial position of the selection, in {{arma2}}/{{arma3}} position of the selection (e.g. when it is animated) in render time scope. If a selection does not exist [0,0,0] is returned.


| object '''selectionPosition''' selectionName
|s1= object '''selectionPosition''' selectionName


|p1= object: [[Object]]
|p1= object: [[Object]]
Line 20: Line 36:
|p2= selectionName: [[String]]
|p2= selectionName: [[String]]


| [[Array]] - in format [[PositionRelative]] ([x,y,z] relative position in model space)
|r1= [[Array]] - relative position in model space. If selection does not exist, {{ic|[0, 0, 0]}} is returned.


|s2= object '''selectionPosition''' [selectionName, LODName] {{Since|arma3|1.49.131660|y}}
|s2= object '''selectionPosition''' [selectionName, LODName] {{Since|arma3|1.49.131660|y}}
Line 37: Line 53:
* "HitPoints"
* "HitPoints"


|r2= [[Array]] - [x,y,z] relative position in model space
|r2= [[Array]] - relative position in model space. If selection does not exist, {{ic|[0, 0, 0]}} is returned.


|x1= <code>_inModelPosition = [[player]] [[selectionPosition]] "head_hit";</code>
|x1= <code>_inModelPosition = [[player]] [[selectionPosition]] "head_hit";</code>
Line 47: Line 63:
|x4= <code>_inModelPosition = [[player]] [[selectionPosition]] "camera";</code>
|x4= <code>_inModelPosition = [[player]] [[selectionPosition]] "camera";</code>


|seealso= [[modelToWorld]], [[selectionNames]]
|seealso= [[modelToWorld]] [[selectionNames]] [[getAllHitPointsDamage]]
}}
}}


<dl class="command_description">
<!-- Note Section BEGIN -->
<dd class="notedate">Posted on January 5, 2007 - 12:24</dd>
<dt class="note">[[User:Giova|Giova]]<dd class="note">
To know more selections simply create an eventHandler damage on an object.
<!-- Note Section END -->
</dl>
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}


<!-- CONTINUE Notes -->
<dl class="command_description">
<dl class="command_description">
<dd class="notedate">Posted on July 29, 2015 - 09:35 (UTC)</dd>
<dt class="note">[[User:Jezuro|Jezuro]]</dt>
<dd class="note">
Since 1.49.131660, you can use an alternative syntax:
<br><br>
object '''selectionPosition''' [selectionName, lodName]
<br><br>
lodName: "Memory", "Geometry", "FireGeometry", "LandContact", "HitPoints"
<br><br>
If the given selectionName is not found in the given lod, [0,0,0] is returned.
</dd>
<dd class="notedate">Posted on June 25, 2017 - 15:13 (UTC)</dd>
<dd class="notedate">Posted on June 25, 2017 - 15:13 (UTC)</dd>
<dt class="note">[[User:Killzone Kid|Killzone Kid]]</dt>
<dt class="note">[[User:Killzone Kid|Killzone Kid]]</dt>
Line 83: Line 75:
[[player]] [[selectionPosition]] ["head", "HitPoints"]; // [0.144257,0.306769,1.53471]</code></dd>
[[player]] [[selectionPosition]] ["head", "HitPoints"]; // [0.144257,0.306769,1.53471]</code></dd>
</dl>
</dl>
<!-- DISCONTINUE Notes -->

Revision as of 12:35, 3 March 2021

Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.51tkoh logo small.png1.00Arma 3 logo black.png0.50
GAGlobal
Hover & click on the images for description

Description

Description:
Returns position in model space and returns its relative position. Searches first in memory level, then in geometry LODs.
In Arma it returns the initial position of the selection, in Arma 2/Arma 3 position of the selection (e.g. when it is animated) in render time scope. If a selection does not exist [0,0,0] is returned.
Groups:
Object ManipulationRender Time Scope

Syntax

Syntax:
object selectionPosition selectionName
Parameters:
object: Object
selectionName: String
Return Value:
Array - relative position in model space. If selection does not exist, [0, 0, 0] is returned.

Alternative Syntax

Syntax:
object selectionPosition [selectionName, LODName] Template:Since
Parameters:
object: Object
[selectionName, LODName]: Array
selectionName: String
LODName: String - LOD name, one of the following:
  • "Memory"
  • "Geometry"
  • "FireGeometry"
  • "LandContact"
  • "HitPoints"
Return Value:
Array - relative position in model space. If selection does not exist, [0, 0, 0] is returned.

Examples

Example 1:
_inModelPosition = player selectionPosition "head_hit";
Example 2:
_inModelPosition = player selectionPosition "pelvis";
Example 3:
_inModelPosition = player selectionPosition "head";
Example 4:
_inModelPosition = player selectionPosition "camera";

Additional Information

See also:
modelToWorld selectionNames getAllHitPointsDamage

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


Posted on June 25, 2017 - 15:13 (UTC)
Killzone Kid
Do use the filter that comes with Alt Syntax to suit your needs. For example player has 3 selections called "head" and their selectionPositions are quite different from each other: player selectionPosition ["head", "Memory"]; // [0.173798,0.330415,1.37783] player selectionPosition ["head", "FireGeometry"]; // [0.14375,0.206039,1.44689] player selectionPosition ["head", "HitPoints"]; // [0.144257,0.306769,1.53471]
Retrieved from "https://community.bistudio.com/wiki?title=selectionPosition&oldid=250556"