setLightAttenuation

From Bohemia Interactive Community
Revision as of 05:56, 25 March 2014 by Ffur2007slx2 5 (talk | contribs)
Jump to navigation Jump to search
Hover & click on the images for description

Description

Description:
Sets attenuation of light.
Groups:
Uncategorised

Syntax

Syntax:
light setLightAttenuation [start, constant, linear, quadratic]
Parameters:
light: Object
[start, constant, linear, quadratic]: Array
start: Number
constant: Number
linear: Number
quadratic: Number
Return Value:
Nothing

Examples

Example 1:

Additional Information

See also:
setLightAmbientsetLightColorlightAttachObjectlightDetachObjectsetLightBrightnesssetLightIntensitysetLightUseFlaresetLightFlareSizesetLightFlareMaxDistancesetLightDayLight

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

Notes

Posted on Mar 25, 2014 - 12:31
ffur2007slx2_5
In ArmA3 ver 1.14 setLightAttenuation array will present fallowing visual effects:

[start(SCALAR), constant(SCALAR), linear (SCALAR), quadratic(SCALAR)]

start(SCALAR) – Number can be unlimited, this parameter determines the range that the light source takes effect. Terrain environmental color will be bathed by ‎setLightAmbient within the range and its covered objects will reflect the color by ‎setLightColor.

constant(SCALAR) – Support signed number, this parameter determines the brightness proportion of the light source, higher the number is, less the brightness will be, vice versa. Any minus value passed will be treated as 0 (100% brightness). In other words, this parameter is related with ‎‎setLightBrightness and ‎setLightIntensity.

linear (SCALAR) – Support signed number, effective range is from 0 ~ 100 (passed minus value will be treated as 0), this parameter determines the concentration of the light source, higher the number is, more will the light concentrate, vice versa. In other words, this parameter will turn the source into spotlight and sharpens its light circle border.
WARNING: Please pay attention to a special value: 4.31918e-005
e.g.
_light setLightAttenuation [2,4,4.31918e-005,0]; //This value will make the light source reach its ultimate effect range.
Any start param set before will be discarded and overwrote.

quadratic(SCALAR) – Support signed number (range unlimited, passed minus number will be treated as 0), this parameter determines the range that the light source is seeable and its visual presentation looks similar to linear. 0 means the maximum seeable range. In further explanation, a less bright source can’t be seen out of the range on the land but still seeable on the sea, and a bright enough source won’t be effect by the passed range which is still seeable out of range.
WARNING: Please pay attention to a special value: 4.31918e-005
e.g.
_light setLightAttenuation [6,0,0,4.31918e-005]; //This value will make the light source reach its ultimate effect range.
Any start param set before will be discarded and overwrote.

Bottom Section