Functions | |
void | Open_Geometry (HC_KEY key) |
void | Close_Geometry (void) |
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.
key | - Unique identifier for this element of geometry or a light, typically returned from a previous call to a KInsert routine, Find_Contents() , or Show_Selection_Element() . |
If the item being opened is a shell or a mesh, the legal actions inside are:
Open_Edge() Open_Face() Open_Vertex() Set_Color(), Show_Color() Set_User_Options(), Show_User_Options()
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")
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.
void Close_Geometry | ( | void | ) |
Closes the session that began with an opening call to Open_Geometry().