Set_Geometry_Options

Functions

void Set_Geometry_Options (HC_KEY key, const char *list)
 Allows users to make geometry-specific settings on a variety of 3dGS geometric primitives. More...
 

Detailed Description

Function Documentation

◆ Set_Geometry_Options()

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:

bounding cuboid = (xmin, ymin, zmin, xmax, ymax, zmax)

Specifies the bounding cuboid used to circumscribe the specified geometry. The key can only reference a shell or mesh.

bounding sphere = (x, y, z, radius)

Specifies the bounding sphere used to circumscribe the specified geometry. The key can only reference a shell or mesh.

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

coordinate systems = (projection, world, object, etc.)

Allows users to set points in different coordinate systems. See Compute_Coordinates() for available coordinate systems.

orientation = (a,b,c,d,e,f)

Defines the basis vectors for transformable marker symbols and line patterns, where (a,b,c) and (d,e,f) are all floats. If the vector (d,e,f) is omitted, then the vector (a,b,c) defines the normal to the plane on which the marker symbol or 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. This option is only valid if the supplied geometry is a marker or polyline.

NOTES

Edit_Geometry_Options() has been deprecated. Please use Set_Geometry_Options() instead.

RESTRICTIONS

See also
Show_Geometry_Options