WEBLIGHT (Command)

Creates a precise 3D representation of the light intensity distribution of a light source.


The following prompts are displayed.

Note: The LIGHTINGUNITS system variable must be set to a value other than 0 to create and use weblights.

Source location

Sets the location of the light source in the drawing area. Enter coordinate values or use the pointing device.

Target location

Specifies where the light beam shines. Enter coordinate values or use the pointing device.


Specifies the name of the light.

Intensity Factor

Sets the intensity or brightness of the light.


Turns the light on and off. If lighting is not enabled in the drawing, this setting has no effect.


Photometry is the measurement of the luminous intensities of visible light sources.

In photometry, luminous intensity is a measure of the perceived power emitted by a light source in a particular direction. Luminous flux is the perceived power in per unit of solid angle. The total luminous flux for a lamp is the perceived power emitted in all directions. Luminance is the total luminous flux incident on a surface, per unit area.

Note: The Photometry option is available only when the LIGHTINGUNITS system variable is set to 1 or 2.

Enter an intensity value in candelas, flux value, or illuminance value.

  • Candela (symbol: cd) is the SI unit of luminous intensity (perceived power emitted by a light source in a particular direction). Cd/Sr
  • Lux (symbol: lx) is the SI unit of illuminance. Lm/m^2
  • Foot-candle (symbol: fc) is the American unit of illuminance. Lm/ft^2

Enter f to specify the perceived power in a luminous flux value.

If you enter i, you can specify the intensity of the light based on an illuminance value.

The illuminance value can be specified in either lux or foot-candles. Enter d to specify a distance to use to calculate illuminance.


Specify the color of the light based on a color name or a Kelvin temperature. Enter ? to display a list of color names.

Enter a text string using wild card characters to display a partial listing of color names, or an asterisk (*) to display all the possible choices.

If you enter k, you can specify the color of the light based on a Kelvin temperature value.


Exits the command.


Specifies the intensity for a light at points on a spherical grid.


Specifies which web file to use to define the properties of the web. Web files have the file extension .ies.


Specifies the X rotation for the web.


Specifies the Y rotation for the web.


Specifies the Z rotation for the web.


Makes the light cast shadows.

Note: Starting with AutoCAD 2016-based products, shadows are always rendered no matter the current status or values of the Shadow option. This option is maintained for scripting and backwards compatibility.

Turns off the display and calculation of shadows for the light. Use this option to increase performance.


Displays shadows with sharp edges. Use this option to increase performance.

Soft Mapped

Displays realistic shadows with soft edges.

Map Size

Specifies the amount of memory to use to calculate the shadow map.


Specifies the softness to use to calculate the shadow map.

Soft Sampled

Displays realistic shadows with softer shadows (penumbra) based on extended light sources.

Specify the shape of the shadow by entering s and then the dimensions of the shape. (For example, the radius of the sphere or the length and width of a rectangle.)

Specify the sample size by entering a.

Specify the visibility of the shape by for the shadow by entering v.

Filter Color

Controls the color of the light.

True Color

Specifies a True Color. Enter in the format R,G,B (red, green, blue).


Specifies an ACI (AutoCAD Color Index) color.


Specifies an HSL (hue, saturation, luminance) color.

Color Book

Specifies a color from a color book.


Exits the command.