public class SoTriangleSet extends SoNonIndexedShape
This shape node constructs triangles from the vertices located at the coordinates specified in the vertexProperty
field (from SoVertexShape
), or the current inherited state. For optimal performance, the vertexProperty
field is recommended.
Each triangle is defined by three vertices, starting at startIndex
. The numTriangles
field 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.
Limitations:
TriangleSet {
vertexProperty | NULL |
startIndex | 0 |
numTriangles | -1 |
Action behavior:
SoGLRenderAction
Draws triangles based on the current coordinates, normals, materials, drawing style, and so on.
SoRayPickAction
Picks triangles based on the current coordinates and transformation. Details about the intersection are returned in an SoFaceDetail
.
SoGetBoundingBoxAction
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.
SoCallbackAction
If any triangle callbacks are registered with the action, they will be invoked for each successive triangle generated from each triangle in the set.
See also:
SoCoordinate3
, SoDrawStyle
, SoIndexedTriangleSet
, SoFaceDetail
, SoFullSceneAntialiasing
, SoVertexProperty
, SoShapeHints
SoShape.ShapeTypes
SoNode.RenderModes
Inventor.ConstructorCommand
Modifier and Type | Field and Description |
---|---|
SoSFInt32 |
numTriangles
Number of triangles in the set.
|
startIndex
vertexProperty
boundingBoxIgnoring
VERBOSE_LEVEL, ZeroHandle
Constructor and Description |
---|
SoTriangleSet()
Creates a triangle set node with default settings.
|
getNormalCache, getTangentCache
getShapeType, isPrimitiveRestartAvailable, isPrimitiveRestartAvailable
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
copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults
dispose, getName, isDisposable, isSynchronizable, setName, setSynchronizable
getNativeResourceHandle
public final SoSFInt32 numTriangles
Generated on July 31, 2019, Copyright © Thermo Fisher Scientific. All rights reserved. http://www.openinventor.com