|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...|
Prepares a vertex within a shell, mesh, or polycylinder for the local overriding of drawing attributes.
offset - The offset within the array of points originally passed to Insert_Shell() or Insert_Mesh() . The first point is at offset zero.
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.
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.
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.