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.