getEntityInfo: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Some wiki formatting)
No edit summary
Line 14: Line 14:
|p1= entity: [[Object]]
|p1= entity: [[Object]]


|r1= [[Array]] in format [isAnimal, isDeadSet, deadSetTime, lastEntityCausingDamage, lastDamageTime, isUpsideDown, upsideDownTime, isStopped, canFloat, hasTerminalOpened], where:
|r1= [[Array]] in format [isMan, isAnimal, isDeadSet, deadSetTime, lastEntityCausingDamage, lastDamageTime, isUpsideDown, upsideDownTime, isStopped, canFloat, hasTerminalOpened], where:
* isMan [[Boolean]] - [[true]] if the entity is a man
* isAnimal: [[Boolean]] - [[true]] if the entity is an animal
* isAnimal: [[Boolean]] - [[true]] if the entity is an animal
* isDeadSet: [[Boolean]] - [[true]] if the entity has dead flag set. Often has the same value as ![[alive]], but is not the same, as [[alive]] checks the total damage.
* isDeadSet: [[Boolean]] - [[true]] if the entity has dead flag set. Often has the same value as ![[alive]], but is not the same, as [[alive]] checks the total damage.
Line 25: Line 26:
* canFloat: [[Boolean]] - [[true]] if the entity is able to float on water.
* canFloat: [[Boolean]] - [[true]] if the entity is able to float on water.
* hasTerminalOpened: [[Boolean]] - [[true]] if the UAV terminal is opened for the given entity.
* hasTerminalOpened: [[Boolean]] - [[true]] if the UAV terminal is opened for the given entity.
|s2= entity [[getEntityInfo]] index
|p21= entity: [[Object]]
|p22= index: [[Number]] - property index (see main syntax, 2 - isDeadSet for example)
|r2= [[Anything]] - depends on requested property, or [[Nothing]]


|x1= <sqf>private _entityInfo = getEntityInfo ent1;</sqf>
|x1= <sqf>private _entityInfo = getEntityInfo ent1;</sqf>
|x2= <sqf>private _isMan = ent1 getEntityInfo 0;</sqf>


|seealso= [[cursorObject]] [[cursorTarget]] [[createSimpleObject]] [[getObjectType]] [[getObjectTextures]] [[objectParent]] [[setVelocityTransformation]] [[getUnitFreefallInfo]] [[getModelInfo]]
|seealso= [[cursorObject]] [[cursorTarget]] [[createSimpleObject]] [[getObjectType]] [[getObjectTextures]] [[objectParent]] [[setVelocityTransformation]] [[getUnitFreefallInfo]] [[getModelInfo]]
}}
}}

Revision as of 04:34, 12 January 2024

Hover & click on the images for description
Only available in Development branch(es) until its release with Arma 3 patch v2.16.

Description

Description:
Returns various properties for the given entity.
Groups:
Object Manipulation

Syntax

Syntax:
getEntityInfo entity
Parameters:
entity: Object
Return Value:
Array in format [isMan, isAnimal, isDeadSet, deadSetTime, lastEntityCausingDamage, lastDamageTime, isUpsideDown, upsideDownTime, isStopped, canFloat, hasTerminalOpened], where:
  • isMan Boolean - true if the entity is a man
  • isAnimal: Boolean - true if the entity is an animal
  • isDeadSet: Boolean - true if the entity has dead flag set. Often has the same value as !alive, but is not the same, as alive checks the total damage.
  • deadSetTime: Number - for how long the entity was dead
  • lastEntityCausingDamage: Object - objNull or the entity that last caused damage to this entity. Is not the same as the killer but could be the same. Killed entity might not have this set either. The entity does not have to be dead in order to have last entity that caused damage assigned.
  • lastDamageTime: Number - how long ago was lastEntityCausingDamage assigned
  • isUpsideDown: Boolean - true if the entity is upside down. The engine considers this to be vectorUp ent select 2 < 0.3
  • upsideDownTime: Number - how long the entity was upside down.
  • isStopped: Boolean - true when the entity does not need to be actively simulated.
  • canFloat: Boolean - true if the entity is able to float on water.
  • hasTerminalOpened: Boolean - true if the UAV terminal is opened for the given entity.

Alternative Syntax

Syntax:
entity getEntityInfo index
Parameters:
entity: Object
index: Number - property index (see main syntax, 2 - isDeadSet for example)
Return Value:
Anything - depends on requested property, or Nothing

Examples

Example 1:
private _entityInfo = getEntityInfo ent1;
Example 2:
private _isMan = ent1 getEntityInfo 0;

Additional Information

See also:
cursorObject cursorTarget createSimpleObject getObjectType getObjectTextures objectParent setVelocityTransformation getUnitFreefallInfo getModelInfo

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