Brief Index      Full Index      Events Index      I.M. Reference

Show_Distant_Light

Functions

void Show_Distant_Light (HC_KEY key, float *di, float *dj, float *dk)

Function Documentation

void Show_Distant_Light ( HC_KEY  key,
float *  di,
float *  dj,
float *  dk 
)

Returns the direction of a "distant light", as referenced by a key.

Parameters:
key- Unique numeric identifier pointing to a distant light in the database.
di- Direction, with respect to the origin, of the distant light in object space. Returned to user. Passed by reference always.
dj-
dk-

DETAILS

This routine finds the direction of the distant light that corresponds to the given key. You could use this ability, for example, to duplicate an existing light, or to place the camera at a particular position with respect to a light.

The key for the distant light might come from Find_Contents() ( Begin_Contents_Search() ), or it might have been saved by your program when the distant light was created (via Insert_Distant_Light() ).

See also:
Insert_Distant_Light, Begin_Contents_Search, Compute_Coordinates.

Brief Index      Full Index      Events Index      I.M. Reference