SoSpotLight

InventorModule

genre	InventorNodesAutomatic,InventorLights
author	Silicon Graphics Inc
package	MeVisLab/Standard
definition	inventor.def

Purpose

The node SoSpotLight defines a spotlight-style light source.

A spotlight is positioned at a fixed location in 3D space and illuminates in a cone along a specific direction. The intensity of the illumination decreases exponentially as a ray of light diverges from this direction toward the edges of the cone. The rate of drop-off and the angle of the cone are controlled by the Drop Off Rate and Cut Off Angle fields.

Windows

Default Panel

Output Fields

self

name: self, type: SoNode

Parameter Fields

Field Index

Color: Color

Cut Off Angle: Float

Direction: Vector3

Drop Off Rate: Float

Intensity: Float

Location: Vector3

On: Bool

Visible Fields

On

name: on, type: Bool, default: TRUE

If checked, the source is active.

Otherwise, the light source does not illuminate at all.

Intensity

name: intensity, type: Float, default: 1

Sets the illumination intensity of the light source.

Valid values range from 0.0 (no illumination) to 1.0 (maximum illumination).

Color

name: color, type: Color, default: 1 1 1

Sets the illumination color of the light source, defined by its RGB components.

Location

name: location, type: Vector3, default: 0 0 1

Sets the location of the light source.

Direction

name: direction, type: Vector3, default: 0 0 -1

Sets the principal direction of illumination (center axis of cone).

Drop Off Rate

name: dropOffRate, type: Float, default: 0

Sets the rate of intensity drop-off per change in angle from the primary direction: 0 = constant intensity, 1 = very sharp drop-off.

Cut Off Angle

name: cutOffAngle, type: Float, default: 0.78539819

Sets the angle, in radians, beyond which the intensity is zero, measured from the center axis of the cone to an edge.