Open_Vertex

Functions

void Close_Vertex (void)
 Closes the session that began with an opening call to Open_Vertex(). More...
 
void Open_Vertex (int offset)
 Prepares a vertex within a shell, mesh, or polycylinder for the local overriding of drawing attributes. More...
 

Detailed Description

Function Documentation

◆ Close_Vertex()

void Close_Vertex ( void  )

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

DETAILS

No additional details. See Open_Vertex()

◆ Open_Vertex()

void Open_Vertex ( int  offset)

Prepares a vertex within a shell, mesh, or polycylinder for the local overriding of drawing attributes.

Parameters
offset- The offset within the array of points originally passed to Insert_Shell() or Insert_Mesh() . The first point is at offset zero.

DETAILS

Open_Vertex() is analogous to Open_Segment() - it makes a particular vertex within a shell, mesh, or polycylinder ready for further work. The geometry must already have been opened with a call to Open_Geometry() .
The operations permitted on a vertex are to Set, Show, or UnSet: marker symbol, marker size, and marker color; vertex normal vector; visibility; edge color; and face color. The color can be set using any of the many color routines. Set_Color_By_FIndex() may be of particular interest when you false-color objects. Note: vertex face color is only meaningful when "color interpolating" (see Set_Rendering_Options() ) is turned on.

The MSet_Vertex_(Attribute) ("Multi-Set") routines are offered as a convenient way to rapidly set normals or colors on a large number of vertices. The functions accept an explicit key, so no shell, mesh, or polycylinder need be previously opened, and an explicit vertex number and count, so no vertex need be previously opened.

NOTES

Your program should make sure that there is eventually a Close_Vertex() to match every Open.
If you are working on a mesh, please refer to the Insert_Mesh() manual page for guidance on the vertex numbering.

RESTRICTIONS

If you are working with polycylinders, please note that only face and edge color attributes can be set for polycylinder vertices. Marker attributes, normals, and visibility do not apply to polycylinders.

See also
Open_Geometry, Open_Segment, Open_Edge, Open_Face, Insert_Shell, Insert_Mesh, Insert_PolyCylinder, Set_Color, Set_Color_By_FIndex, Set_Marker_Size, Set_Marker_Symbol, Set_Normal, Set_Visibility.