Move_Light_Position

Functions

void Move_Light_Position (HC_KEY key, double x, double y, double z)
 Changes the location, in object space, of a previously inserted "local light" or "spot light". More...
 

Detailed Description

Function Documentation

◆ Move_Light_Position()

void Move_Light_Position ( HC_KEY  key,
double  x,
double  y,
double  z 
)

Changes the location, in object space, of a previously inserted "local light" or "spot light".

Parameters
key- The numeric identifier returned by a previous call to Insert_Local_Light() or Insert_Spot_Light() .
x- The new x-location for the light.
y- The new y-location for the light.
z- The new z-location for the light.

DETAILS

Move_Light_Position() allows you to change the current specifications of a light's position so that it will shine from somewhere new.
When applied to a spotlight, Move_Light_Position() does not change the light's target point. In addition, if the spotlight was defined in "camera relative" coordinates when created, then Move_Light_Position() will also be in camera relative coordinates.
If you define the light in a segment of its own, you can also move it around relative to its previous location by calling modelling transformations like Rotate_Object() and Translate_Object() . (The "object", in this case, is the light.)

NOTES

RESTRICTIONS

See also
Insert_Local_Light, Insert_Spot_Light, Translate_Object, Rotate_Object, Rotate_Object_Offaxis.