Open_Geometry

Functions

void Close_Geometry (void)
 Closes the session that began with an opening call to Open_Geometry(). More...
 
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. More...
 

Detailed Description

Function Documentation

◆ Close_Geometry()

void Close_Geometry ( void  )

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

DETAILS

No additional details. See Open_Geometry()

◆ Open_Geometry()

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 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 are:

If the item being opened is a light, the legal actions 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.