Brief Index      Full Index      Events Index      I.M. Reference

Open_Geometry

Functions

void Open_Geometry (HC_KEY key)
 
void Close_Geometry (void)
 

Detailed Description

Function Documentation

void Open_Geometry ( HC_KEY  key)

Readies an item of geometry – in particular a shell or a mesh – or a light to receive local attributes.

Parameters
key- Unique identifier for this element of geometry or a light, typically returned from a previous call to an Insert routine, Find_Contents() , or Show_Selection_Element() .

DETAILS

Open_Geometry() is analogous to Open_Segment() and makes an element of geometry or a light ready for a sequence of actions.

If the item being opened is a shell or a mesh, the legal actions inside are:

Within the open shell or mesh, operations such as setting or showing a face color are permitted. It is also possible to set the color of all faces in the shell with one call to Set_Color ("faces = [color by name | color by value]"). Please see Open_Edge(), Open_Face(), and Open_Vertex() for more details.

If the item being opened is any other type of geometry, the legal actions inside are:

Set_User_Options() and its variants, including Show variants. Set_User_Index() and its variants, including Show variants.

If the item being opened is a light, the legal actions inside are:

Set_Color("ambient = color_name, diffuse = color_name")

NOTES

An open item of geometry hides any currently open segment: segment name defaulting will behave as if no segment was open.

Geometry that is Open (at any level) cannot be deleted until it is closed.

There is no need to close open geometry before opening direct segments (e.g. ?driver/sbx/unix:0.0), requesting input and updating the screen, or doing any other normal operation (except deleting the geometry, naturally.) Your program should, of course, make sure that there is eventually a Close_Geometry() to match every Open.

RESTRICTIONS

See Also
Open_Segment, Open_Edge, Open_Face, Open_Vertex, Insert_Mesh, Insert_Shell, Set_User_Options.
void Close_Geometry ( void  )

Closes the session that began with an opening call to Open_Geometry().

DETAILS

No additional details. See Open_Geometry()

Brief Index      Full Index      Events Index      I.M. Reference