Brief Index      Full Index      Events Index      I.M. Reference

Move_Light_Position


Functions

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

Function Documentation

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.

Brief Index      Full Index      Events Index      I.M. Reference