getLightInfo: Difference between revisions

From Bohemia Interactive Community
No edit summary
m (Add devbranch)
 
Line 3: Line 3:
|game1= arma3
|game1= arma3
|version1= 2.22
|version1= 2.22
|branch= dev


|gr1= Object Manipulation
|gr1= Object Manipulation
Line 12: Line 14:
|p1= light: [[Object]] - {{hl|#lightpoint}} or {{hl|#lightreflector}}
|p1= light: [[Object]] - {{hl|#lightpoint}} or {{hl|#lightreflector}}


|r1= [[Array]] in format [Intensity, DiffuseColor, AmbientColor, DayLight, IR, UseFlare, FlareSize, FlareMaxDistance, AttenuationPars, AttachedToPars, ConePars, VolumeShapePars], where:
|r1= [[Array]] in format [intensity, diffuseColor, ambientColor, dayLight, IR, useFlare, flareSize, flareMaxDistance, attenuationPars, attachedToPars, conePars, volumeShapePars], where:


* 0 - Intensity: [[Number]] - getter for [[setLightIntensity]] ([[setLightBrightness]] also sets intensity in a weird way, but it is also obsolete)
* 0 - intensity: [[Number]] - getter for [[setLightIntensity]] ([[setLightBrightness]] also sets intensity in a weird way, but it is also obsolete)
* 1 - DiffuseColor: [[Color]] - getter for [[setLightColor]]
* 1 - diffuseColor: [[Color]] - getter for [[setLightColor]]
* 2 - AmbientColor: [[Color]] - getter for [[setLightAmbient]]
* 2 - ambientColor: [[Color]] - getter for [[setLightAmbient]]
* 3 - DayLight: [[Boolean]] - getter for [[setLightDayLight]]
* 3 - dayLight: [[Boolean]] - getter for [[setLightDayLight]]
* 4 - IR: [[Boolean]] - getter for [[setLightIR]]
* 4 - IR: [[Boolean]] - getter for [[setLightIR]]
* 5 - UseFlare: [[Boolean]] - getter for [[setLightUseFlare]]
* 5 - useFlare: [[Boolean]] - getter for [[setLightUseFlare]]
* 6 - FlareSize: [[Number]] - getter for [[setLightFlareSize]]
* 6 - flareSize: [[Number]] - getter for [[setLightFlareSize]]
* 7 - FlareMaxDistance: [[Number]] - getter for [[setLightFlareMaxDistance]]
* 7 - flareMaxDistance: [[Number]] - getter for [[setLightFlareMaxDistance]]
* 8 - AttenuationPars: [[Array]] - getter for [[setLightAttenuation]]
* 8 - attenuationPars: [[Array]] - getter for [[setLightAttenuation]]
* 9 - AttachedToPars: [[Array]] - getter for [[lightAttachObject]], [[lightDetachObject]]
* 9 - attachedToPars: [[Array]] - getter for [[lightAttachObject]], [[lightDetachObject]]
* 10 - ConePars: [[Array]] - getter for [[setLightConePars]]
* 10 - conePars: [[Array]] - getter for [[setLightConePars]]
* 11 - VolumeShapePars: [[Array]] - getter for [[setLightVolumeShape]]
* 11 - volumeShapePars: [[Array]] - getter for [[setLightVolumeShape]]


|s2= light [[getLightInfo]] index
|s2= light [[getLightInfo]] index

Latest revision as of 11:54, 25 November 2025

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

Description

Description:
Returns various properties for the given #lightpoint or #lightreflector. ConePars and VolumeShapePars are exclusive properties of #lightreflector only.
Groups:
Object Manipulation

Syntax

Syntax:
getLightInfo light
Parameters:
light: Object - #lightpoint or #lightreflector
Return Value:
Array in format [intensity, diffuseColor, ambientColor, dayLight, IR, useFlare, flareSize, flareMaxDistance, attenuationPars, attachedToPars, conePars, volumeShapePars], where:

Alternative Syntax

Syntax:
light getLightInfo index
Parameters:
light: Object - #lightpoint or #lightreflector
index: Number - property index (see main syntax, for example 0 for light intensity)
Return Value:
Anything - depends on the requested property, or Nothing

Examples

Example 1:
private _lightInfo = getLightInfo light1;
Example 2:
private _lightIntensity = light1 getLightInfo 0;

Additional Information

See also:
setLightIntensity setLightColor setLightAmbient setLightDayLight setLightIR setLightUseFlare setLightFlareSize setLightFlareMaxDistance setLightAttenuation lightAttachObject lightDetachObject setLightConePars getUnitFreefallInfo setLightConePars getEntityInfo 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