Brief Index      Full Index      I.M. Functions

Set_Geometry_Options


Functions

void Set_Geometry_Options (HC_KEY key, const char *list)

Function Documentation

void Set_Geometry_Options ( HC_KEY  key,
const char *  list 
)

Allows users to make geometry-specific settings on a variety of 3dGS geometric primitives.

Parameters:
key - Key to the geometry to which an option is to be attached.
list - A quoted string or a string variable containing a list of the desired option settings.

DETAILS

In certain cases, users may need to set additional attributes on a specific primitive, in order to create the correct rendering. The following choices for list are recognized:

[no] camera relative

Forces a light to always maintain the same direction and distance from the camera. This option is valid for spot, distant and local lights. Setting this option on spot lights has the exact same effect as setting the "camera relative" option in the options list passed to Insert_Spot_Light(). The default setting is "no camera relative".

  • As one might expect, local lights have a position relative to the camera (instead of the origin), and distant lights have direction relative to the camera's.
  • A direction of (0,0,-1) corresponds to a light directly along the same direction as the camera.
orientation = (a,b,c,d,e,f)

Defines the basis vectors for transformable user-defined line patterns, where (a,b,c) and (d,e,f) are all floats. Valid only for polylines. If the vector (d,e,f) is omitted, then the vector (a,b,c) defines the normal to the plane on which the line pattern will be projected. If (a,b,c) and (d,e,f) are both specified, then the first vector is a normal and the second is an up-vector. In effect, specifying both vectors controls the rotation of the pattern.

NOTES

RESTRICTIONS

See also:
Show_Geometry_Options

Main Index
Brief Index      Full Index      I.M. Functions