Brief Index      Full Index      I.M. Reference

Show_Distant_Light


Functions

void Show_Distant_Light (HC_KEY key, float *di, float *dj, float *dk)
void DShow_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 KInsert_Distant_Light() ).

NOTES

RESTRICTIONS

See also:
Insert_Distant_Light, Begin_Contents_Search, Compute_Coordinates.

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

Similar to Show_Distant_Light(), but accepts and/or returns double-precision values. This command can only be used when the application source includes the HOOPS double-precision header, hcd.hs.

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

No additional details. See Show_Distant_Light().

Main Index
Brief Index      Full Index      I.M. Functions