---
name: "setLightVolumeShape"
type: command
status: ok
groups: ["Lights"]
arma3_since: "2.06"
locality: {"argument": "local", "effect": "local", "server_exec": false}
source: https://community.bistudio.com/wiki/setLightVolumeShape
revid: 378534
updated: 2026-05-04T02:22:29Z
---

# setLightVolumeShape

*Command · Lights · Arma 3 v2.06*

Locality: arguments **local** · effect **local**

## Description

Sets the `1. lightreflector`'s volume shape. An empty shape will switch the light off.

## Syntax

```sqf
lightReflector setLightVolumeShape [shapePath, scale]
```

**Parameters:**

- `lightReflector` : [Object](../topics/Object.md) - object of class `1. lightreflector`)
- `shapePath`: [String](../topics/String.md) - "" to turn the light off
- `scale`: [Array](../topics/Array.md) with [sizeX, sizeY, sizeZ]
  - sizeX: [Number](../topics/Number.md)
  - sizeY: [Number](../topics/Number.md)
  - sizeZ: [Number](../topics/Number.md)

**Returns:** [Nothing](../topics/Nothing.md)

## Examples

### Example 1

```sqf
_light setLightVolumeShape ["a3\data_f\VolumeLightFlashlight.p3d", [1, 1, 1]];
```

## See also

[setLightColor](../commands/setLightColor.md) · [setLightAmbient](../commands/setLightAmbient.md) · [setLightBrightness](../commands/setLightBrightness.md) · [lightAttachObject](../commands/lightAttachObject.md) · [lightDetachObject](../commands/lightDetachObject.md) · [setLightIntensity](../commands/setLightIntensity.md) · [setLightAttenuation](../commands/setLightAttenuation.md) · [setLightUseFlare](../commands/setLightUseFlare.md) · [setLightFlareSize](../commands/setLightFlareSize.md) · [setLightFlareMaxDistance](../commands/setLightFlareMaxDistance.md) · [setLightDayLight](../commands/setLightDayLight.md) · [setLightIR](../commands/setLightIR.md)

<sub>Source: [BI Community Wiki — setLightVolumeShape](https://community.bistudio.com/wiki/setLightVolumeShape) (revision 378534).</sub>