selectionPosition: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
No edit summary
Line 22: Line 22:
|gr2= Render Time Scope
|gr2= Render Time Scope


|descr= Returns selection position in model space pertaining to the current animation in [[Simulation_vs_Render_Time_Scope|render time scope]]. When default syntax is used, command searches first in Memory level, then in Geometry level, FireGeometry level, LandContact level and finally in HitPoints level and returns on the first matching find. The alt syntax allows to specify which one of these levels to search in instead. If a selection does not exist [0,0,0] is returned.
|descr= Returns selection position in model space pertaining to the current animation in [[Simulation_vs_Render_Time_Scope|render time scope]]. When default syntax is used, command searches first in Memory level, then in Geometry level, FireGeometry level, LandContact level, HitPoints level and finally in VewGeometry level and returns on the first matching find. The alt syntax allows to specify which one of these levels to search in instead. If a selection does not exist [0,0,0] is returned.


|s1= object '''selectionPosition''' selectionName
|s1= object '''selectionPosition''' selectionName
Line 32: Line 32:
|r1= [[Array]] - relative position in model space. If selection does not exist, {{ic|[0, 0, 0]}} is returned.
|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, LOD] {{Since|arma3|1.49.131660|y}}


|p21= object: [[Object]]
|p21= object: [[Object]]


|p22= [selectionName, LODName]: [[Array]]
|p22= [selectionName, LOD]: [[Array]]


|p23= selectionName: [[String]]
|p23= selectionName: [[String]]


|p24= LODName: [[String]] - LOD name, one of the following:
|p24= LOD: [[String]] - name or [[Number]] - resolution (''since Arma 3 v2.06.147638). [[String]] could be one of:
* "Memory"
* "Memory"
* "Geometry"
* "Geometry"
Line 47: Line 47:
* "HitPoints"
* "HitPoints"
* "ViewGeometry" (''since Arma 3 v2.06.147636'')
* "ViewGeometry" (''since Arma 3 v2.06.147636'')
When [[Number]] is used, command searches for a LOD with the similar [[LOD_resolutions|resolution]]


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

Revision as of 14:22, 20 May 2021

Hover & click on the images for description

Description

Description:
Returns selection position in model space pertaining to the current animation in render time scope. When default syntax is used, command searches first in Memory level, then in Geometry level, FireGeometry level, LandContact level, HitPoints level and finally in VewGeometry level and returns on the first matching find. The alt syntax allows to specify which one of these levels to search in instead. 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, LOD] Template:Since
Parameters:
object: Object
[selectionName, LOD]: Array
selectionName: String
LOD: String - name or Number - resolution (since Arma 3 v2.06.147638). String could be one of:
  • "Memory"
  • "Geometry"
  • "FireGeometry"
  • "LandContact"
  • "HitPoints"
  • "ViewGeometry" (since Arma 3 v2.06.147636)
When Number is used, command searches for a LOD with the similar resolution
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:
modelToWorldselectionNamesgetAllHitPointsDamageallLODs

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]