Functions | |
void | Move_Light_Position (HC_KEY key, double x, double y, double z) |
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".
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. |
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.)