# Lights (scripting commands)

- [apertureParams](../../commands/apertureParams.md): Returns current aperture parameters.
- [diag_lightNewLoad](../../commands/diag_lightNewLoad.md): Allows loading of lighting config during the gameplay (effectively changing the current scene lighting). Filename path can be either absolute or relative.
- [diag_setLightNew](../../commands/diag_setLightNew.md): Overrides currently used scene lighting. The operand is config that is placed as a string (not file). The changes may not be applied immediately, but can be forced by the call of simulWeatherSync.
- [drawLaser](../../commands/drawLaser.md): Draws a laserbeam and a lightpoint at the impact location of the laser.
- [enableGunLights](../../commands/enableGunLights.md): Toggles the target group's gun lights. disableAI "LIGHTS" will disable the use of gun lights.
- [getLighting](../../commands/getLighting.md): Gets general environment's light settings.
- [getLightingAt](../../commands/getLightingAt.md): Gets provided object's lighting information.
- [isCollisionLightOn](../../commands/isCollisionLightOn.md): Returns true if vehicle collision lights are on otherwise false.
- [isIRLaserOn](../../commands/isIRLaserOn.md): Returns true if there is a linked and enabled IR on the given weapon.
- [isLightOn](../../commands/isLightOn.md): Returns true if vehicle headlights are on otherwise false.
- [lightAttachObject](../../commands/lightAttachObject.md): Attach light to given object at given position on object.
- [lightDetachObject](../../commands/lightDetachObject.md): Detach light from object.
- [lightIsOn](../../commands/lightIsOn.md): Check if lampost is on (shining).
- [setAperture](../../commands/setAperture.md): Sets custom eye accommodation camera aperture.
- [setApertureNew](../../commands/setApertureNew.md): Sets custom camera aperture when HDR is enabled. Provided values should be set such as *minimum* &lte; *standard* &lte; *maximum*.
- [setCollisionLight](../../commands/setCollisionLight.md): Switches collision lights of a vehicle on/off.
- [setLightAmbient](../../commands/setLightAmbient.md): Set ambient color of light. This includes surfaces that face away from the light, unlike setLightColor.
- [setLightAttenuation](../../commands/setLightAttenuation.md): Sets attenuation of light. Standard method of attenuation (1 / (constant + linear*dist + quadratic*dist*dist)). *start* param represents distance where the attenuation starts to take effects (dist = distance - start).
- [setLightBrightness](../../commands/setLightBrightness.md): Set brightness of light. Does nothing for light reflector, for light point the formula is setLightIntensity ((brightness * 50) ^ 2)
- [setLightColor](../../commands/setLightColor.md): Set diffuse color of light. Illuminates surfaces that are facing the light.
- [setLightConePars](../../commands/setLightConePars.md): Sets the `1. lightreflector`'s cone params.
- [setLightDayLight](../../commands/setLightDayLight.md): Sets if light can be used during the day.
- [setLightFlareMaxDistance](../../commands/setLightFlareMaxDistance.md): Sets max distance where the flare is visible.
- [setLightFlareSize](../../commands/setLightFlareSize.md): Sets relative size of the flare for the light.
- [setLightIntensity](../../commands/setLightIntensity.md): Sets intensity of light directly. setLightBrightness uses setLightIntensity internally, therefore avoid using setLightBrightness alltogether to avoid confusion
- [setLightIR](../../commands/setLightIR.md): Sets lightpoint in infrared range.
- [setLightUseFlare](../../commands/setLightUseFlare.md): Sets if light has flare.
- [setLightVolumeShape](../../commands/setLightVolumeShape.md): Sets the `1. lightreflector`'s volume shape. An empty shape will switch the light off.
- [setPilotLight](../../commands/setPilotLight.md): Switches headlights of a vehicle on/off. Note that the vehicle has to be local, for global variant use Arma 3: Actions "LightOn"/"LightOff"
- [switchLight](../../commands/switchLight.md): Controls whether a lamp is lit or not.