DISTANTLIGHT Command — GstarCAD 2027

DISTANTLIGHT Command

GstarCAD 2027 · Command Reference

Commands > D Command > DISTANTLIGHT

Function Description:

This command is used to create a parallel light.

Command Access:

Icon:
Menu: View > Render> Light > New Distant Light
Ribbon: /
Toolbar: Light > New Distant Light
Command: DISTANTLIGHT
Alias: /

Command Prompts:

Specify light direction FROM \<0,0,0> or [Vector]:

If inputting "Vector", it will display the following prompt:

Specify vector direction \<0.0000,-0.0100,1.0000>:

After specifying light source direction, it will display the following prompt:

Enter an option to change [Name/Intensity factor/Status/Photometry/shadoW/filterColor/eXit] \<eXit>:

Name

Specifies the name of the light source. Users can use uppercase and lowercase letters, numbers, spaces, hyphens(-) and underscores(_) in the name. The maximum length is 256 characters.

Intensity factor

Sets the intensity or brightness of the light. The intensity ranges from 0.00 to the supported maximum value.

Status

Turns on or turns off the light source. If no light applied in the current drawing, this setting has no effect.

Photometry

Photometry is the measurement of the luminous intensities of visible light sources.
When the LIGHTINGUNITS system variable is set to 1 or 2, the photometry is available.
In photometry, luminous intensity is a measure of the perceived power emitted by a light source in a particular direction. The luminous flux refers to the perceived power per unit of solid angle. The total luminous flux is the perceived power that emitted in all directions. The luminance refers to the total luminous flux on a surface per unit area.

• Intensity: Enter an intensity value in candelas or perceived power in a luminous flux value, or illuminance value for the total luminous flux incident on a surface. User can use Candela (cd) to express the luminous intensity in SI units; the unit is Cd/Sr.
  User can use Lux (lx) to express the illuminance in SI units; the unit is Lm/m2. Users can use Foot-candle (fc) to express the illuminance in US units; the unit is Lm/ft2.
  Enter "f" to specify the perceived power in a luminous flux value. Enter "i" to specify the intensity of the light based on an illuminance value.
  Users can choose Lux or Foot candle to specify the illuminance value.
  Enter "d" to specify a distance to use to calculate illuminance.
• Color: Specify the light color based on a color name and a Kelvin temperature. Users can enter "?" to display the list of color names.
  Users can use wild card characters to enter character string in order to display a partial listing of color names, or enter "*" to display all available choices.
  Enter "k" to specify the color of the light based on Kelvin temperature value.
• eXit: Exit the Photometry option.

ShadoW

Makes the light cast shadows.

• Off: Turns off the display and calculation of shadows. Turning shadows off increases performance.
• Sharp: Displays shadows with sharp edges. This option can increase performance.
• soFtmapped: Displays realistic shadows with soft edges. Specifies the amount of the memory or softness that should be used to calculate the shadow map.

Filtercolor

Controls the color of the light source.

• True color: Specifies a true color. Output in R,G,B format.
• Index color: Specifies an ACI color.
• Hsl: Specifies an HSL color.
• Color Book: Specifies a color from a color book.

eXit

Exits the command.

Other versions with matching text

2022 · 2023 · 2024 · 2025 · 2026

Article ID: 4376
Created: September 26, 2026
Last Updated: September 25, 2026
Author: kbadmin

Online URL: https://kb.gstarcad.com.my/article/distantlight-command-gstarcad-2027-4376.html