Brief Index      Full Index      Events Index      I.M. Reference

Show_Spot_Light

Functions

void Show_Spot_Light (HC_KEY key, HC_POINT *position, HC_POINT *target, char *list)
 
void DShow_Spot_Light (HC_KEY key, HCD_POINT *position, HCD_POINT *target, char *list)
 

Detailed Description

Function Documentation

void Show_Spot_Light ( HC_KEY  key,
HC_POINT position,
HC_POINT target,
char *  list 
)

Returns a full description of the "spot light" referenced by a key.

Parameters
key- Unique numeric identifier pointing to a spot light in the database.
position- The location of the light source in object space or, optionally, in camera relative units. Returned to user. Passed by reference always.
target- The targettowards which the light source shines in user coordinates or, optionally, in camera relative units. Returned to user. Passed by reference always.
list- A quoted string or a string variable containing a list of current options for this specific light. Returned to user. Passed by reference always.

DETAILS

This routine returns the definition of the spot light identified by the given key. You could use this function, for example, to duplicate an existing light, or to realign the light with an object that has moved in the scene. There is no way to edit an existing spotlight. You can remove the lights definition with Delete_By_Key() , then reinsert the light with modifications applied.

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

If you want the ability to "drag" the light around with the mouse, you could insert a selectable marker in the same segment as the light source and apply modelling transformations to both objects. Note that "point" lights (spot, local, and distant lights) are not directly selectable.

NOTES

RESTRICTIONS

See Also
Insert_Spot_Light, Begin_Contents_Search, Delete_By_Key, Translate_Object, Rotate_Object, Compute_Coordinates, Insert_Marker, Set_Selectability.
void DShow_Spot_Light ( HC_KEY  key,
HCD_POINT *  position,
HCD_POINT *  target,
char *  list 
)

Similar to Show_Spot_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.h.

Parameters
key- Unique numeric identifier pointing to a spot light in the database.
position- The location of the light source in object space or, optionally, in camera relative units. Returned to user. Passed by reference always.
target- The targettowards which the light source shines in user coordinates or, optionally, in camera relative units. Returned to user. Passed by reference always.
list- A quoted string or a string variable containing a list of current options for this specific light. Returned to user. Passed by reference always.

DETAILS

No additional details. See Show_Spot_Light().

Brief Index      Full Index      Events Index      I.M. Reference