SoIndexedLineSet Class Reference
[Shapes]
Indexed polyline shape node. More...
#include <Inventor/nodes/SoIndexedLineSet.h>
Public Member Functions | |
| virtual SoType | getTypeId () const |
| SoIndexedLineSet () | |
Static Public Member Functions | |
| static SoType | getClassTypeId () |
Detailed Description
Indexed polyline shape node.
This node represents a 3D shape formed by constructing a set of polylines from vertices located at the coordinates specified in the vertexProperty field (from SoVertexShape), or the current inherited coordinates. For optimal performance, the vertexProperty field is recommended.
SoIndexedLineSet uses the indices in the coordIndex field (from SoIndexedShape) to specify the polylines. An index of SO_END_LINE_INDEX (-1) indicates that the current polyline has ended and the next one begins.
The coordinates of the line set are transformed by the current cumulative transformation.
The line width and pattern are controlled by fields in SoDrawStyle.
The lines are drawn with the current drawing style (SoDrawStyle), but drawing style FILLED is treated as LINES.
Lighting is not applied to lines (i.e., they are rendered with light model BASE_COLOR) unless the application explicitly sets normal vectors using SoVertexProperty or SoNormal.
Treatment of the current material and normal binding is as follows: The PER_PART binding specifies a material or normal for each segment of the line. The PER_FACE binding specifies a material or normal for each polyline. PER_VERTEX specifies a material or normal for each vertex. The corresponding _INDEXED bindings are the same, but use the materialIndex or normalIndex indices (see SoIndexedShape). The default material binding is OVERALL. The default normal binding is PER_VERTEX_INDEXED
The current complexity value has no effect on the rendering of indexed line sets.
Shape Antialiasing type is SoShape::LINES.
Limitations:
- The OpenGL VBO (vertex buffer object) rendering model only allows one set of indices for a primitive. Therefore it is not possible to use VBO rendering (and performance may be lower) if indices are set in the materialIndex, normalIndex or textureCoordIndex fields.
- Due to limitations of the OpenGL VBO (vertex buffer object) rendering model, it is not possible to use VBO rendering (and performance may be lower) if either the normal binding or the material binding is set to either PER_PART(_INDEXED) or PER_FACE(_INDEXED).
FILE FORMAT/DEFAULT
- IndexedLineSet {
| vertexProperty | NULL |
| coordIndex | -1 |
| materialIndex | -1 |
| normalIndex | -1 |
| textureCoordIndex | -1 |
ACTION BEHAVIOR
- SoGLRenderAction
Draws lines based on the current coordinates, normals, materials, drawing style, and so on.
SoRayPickAction
Picks lines based on the current coordinates and transformation. Details about the intersection are returned in an SoLineDetail.
SoGetBoundingBoxAction
Computes the bounding box that encloses all vertices of the line set with the current transformation applied to them. Sets the center to the average of the coordinates of all vertices.
SoCallbackAction
If any line segment callbacks are registered with the action, they will be invoked for each successive segment in the line set.
SEE ALSO
SoCoordinate3, SoDrawStyle, SoFullSceneAntialiasing, SoLineDetail, SoLineSet, SoVertexProperty
- See related examples:
Constructor & Destructor Documentation
| SoIndexedLineSet::SoIndexedLineSet | ( | ) |
Creates an indexed line set node with default settings.
Member Function Documentation
| static SoType SoIndexedLineSet::getClassTypeId | ( | ) | [static] |
Returns the type identifier for this class.
Reimplemented from SoIndexedShape.
| virtual SoType SoIndexedLineSet::getTypeId | ( | ) | const [virtual] |
Returns the type identifier for this specific instance.
Reimplemented from SoIndexedShape.
The documentation for this class was generated from the following file:
- Inventor/nodes/SoIndexedLineSet.h