Introduction

Getting Started

Programming Guides

API Reference

Additional Resources

Show_Distant_Light

Functions

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. More...
 

Detailed Description

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.