- All Implemented Interfaces:
public class SoTriangleSet extends SoNonIndexedShapeSet of triangles shape node. This node represents a 3D shape defined by a set of triangles.
This shape node constructs triangles from the vertices located at the coordinates specified in the
SoVertexShape), or the current inherited state. For optimal performance, the
vertexPropertyfield is recommended.
Each triangle is defined by three vertices, starting at
numTrianglesfield specifies the number of triangles in the set. If numTriangles is -1 (default), then all vertices are used and the number of triangles is the number of vertices divided by three. Setting numTriangles to zero means there are no triangles in the set (the bounding box is empty). An error message is generated in the debug build if there are not enough vertices to make the specified number of triangles.
The coordinates of the triangle set are transformed by the current cumulative transformation. The triangles are drawn with the current light model and drawing style.
Treatment of the current material and normal binding is as follows: The PER_PART and PER_FACE bindings specify a material or normal for each triangle. The _INDEXED bindings are equivalent to their non-indexed counterparts. The default material binding is OVERALL. The default normal binding is PER_VERTEX.
If any normals (or materials) are specified, Open Inventor assumes you provide the correct number of them, as indicated by the binding. You will see unexpected results if you specify fewer normals (or materials) than the shape requires. If no normals are specified, they will be generated automatically.
- 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).
- Open Inventor 8.6
vertexProperty NULL startIndex 0 numTriangles -1
Draws triangles based on the current coordinates, normals, materials, drawing style, and so on.
Computes the bounding box that encloses all vertices of the triangle set with the current transformation applied to them. Sets the center to the average of the coordinates of all vertices.
If any triangle callbacks are registered with the action, they will be invoked for each successive triangle generated from each triangle in the set.
Nested Class Summary
Nested classes/interfaces inherited from class com.openinventor.inventor.nodes.SoShape
Nested classes/interfaces inherited from class com.openinventor.inventor.nodes.SoNode
Fields Modifier and Type Field Description
numTrianglesNumber of triangles in the set.
Constructors Constructor Description
SoTriangleSet()Creates a triangle set node with default settings.
Methods inherited from class com.openinventor.inventor.nodes.SoVertexShape
Methods inherited from class com.openinventor.inventor.nodes.SoShape
getShapeType, isPrimitiveRestartAvailable, isPrimitiveRestartAvailable
Methods inherited from class com.openinventor.inventor.nodes.SoNode
affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderEngineMode, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, write
Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer
copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults
Methods inherited from class com.openinventor.inventor.misc.SoBase
dispose, getName, isDisposable, isSynchronizable, setName, setSynchronizable
public final SoSFInt32 numTrianglesNumber of triangles in the set. Default is SO_TRIANGLE_SET_USE_REST_OF_VERTICES, meaning to use all the vertices given, so the number of triangles is number of vertices divided by 3.