vtkLight - a virtual light for 3D rendering

Super Class: vtkObject

Description:

vtkLight is a virtual light for 3D rendering. It provides methods to locate and point the light, turn it on and off, and set its brightness and color. In addition to the basic infinite distance point light source attributes, you also can specify the light attenuation values and cone angle. These attributes are only used if the light is a positional light. The default is a directional light (e.g. infinite point light source).

See Also:

vtkLightDevice

Methods:

• vtkLight ();
• char *GetClassName ();
• void PrintSelf (ostream &os, vtkIndent indent);
• vtkLight *New ();
• virtual void Render (vtkRenderer *, int );
• void SetColor (float , float , float );
• void SetColor (float a[3]);
• float *GetColor ();
• void SetPosition (float , float , float );
• void SetPosition (float a[3]);
• float *GetPosition ();
• void SetFocalPoint (float , float , float );
• void SetFocalPoint (float a[3]);
• float *GetFocalPoint ();
• void SetIntensity (float );
• float GetIntensity ();
• void SetSwitch (int );
• int GetSwitch ();
• void SwitchOn ();
• void SwitchOff ();
• void SetPositional (int );
• int GetPositional ();
• void PositionalOn ();
• void PositionalOff ();
• void SetExponent (float );
• float GetExponent ();
• void SetConeAngle (float );
• float GetConeAngle ();
• void SetAttenuationValues (float , float , float );
• void SetAttenuationValues (float a[3]);
• float *GetAttenuationValues ();

Detailed Method Descriptions:

• vtkLight *New ();

Create a light with the focal point at the origin and its position set to (0,0,1). The lights color is white, intensity=1, and the light is turned on.

• virtual void Render (vtkRenderer *, int );

Abstract interface to renderer. Each concrete subclass of vtkLight will load its data into the graphics system in response to this method invocation. The actual loading is performed by a vtkLightDevice subclass, which will get created automatically.

• void SetColor (float , float , float );
• void SetColor (float a[3]);
• float *GetColor ();

Set/Get the color of the light.

• void SetPosition (float , float , float );
• void SetPosition (float a[3]);
• float *GetPosition ();

Set/Get the position of the light.

• void SetFocalPoint (float , float , float );
• void SetFocalPoint (float a[3]);
• float *GetFocalPoint ();

Set/Get the point at which the light is shining.

• void SetIntensity (float );
• float GetIntensity ();

Set/Get the brightness of the light (from one to zero).

• void SetSwitch (int );
• int GetSwitch ();
• void SwitchOn ();
• void SwitchOff ();

Turn the light on or off.

• void SetPositional (int );
• int GetPositional ();
• void PositionalOn ();
• void PositionalOff ();

Turn positional lighting on or off.

• void SetExponent (float );
• float GetExponent ();

Set/Get the exponent of the cosine used in positional lighting.

• void SetConeAngle (float );
• float GetConeAngle ();

Set/Get the lighting cone angle of a positional light in degrees. A value of 180 indicates that you want no spot lighting effects just a positional light.

• void SetAttenuationValues (float , float , float );
• void SetAttenuationValues (float a[3]);
• float *GetAttenuationValues ();

Set/Get the quadratic attenuation constants. They are specified as constant, linear, and quadratic, in that order.