Class SoTriangleSet
- java.lang.Object
-
- All Implemented Interfaces:
SafeDisposable
public class SoTriangleSet extends SoNonIndexedShape
Set 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
vertexProperty
field (fromSoVertexShape
), or the current inherited state. For optimal performance, thevertexProperty
field is recommended.Each triangle is defined by three vertices, starting at
startIndex
. ThenumTriangles
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:
- 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).
- Since:
- Open Inventor 8.6
File format/default:
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.
SoCoordinate3
,
SoDrawStyle
,
SoIndexedTriangleSet
,
SoFaceDetail
,
SoFullSceneAntialiasing
,
SoVertexProperty
,
SoShapeHints
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class com.openinventor.inventor.nodes.SoShape
SoShape.ShapeTypes
-
Nested classes/interfaces inherited from class com.openinventor.inventor.nodes.SoNode
SoNode.RenderModes
-
Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor
Inventor.ConstructorCommand
-
-
Field Summary
Fields Modifier and Type Field Description SoSFInt32
numTriangles
Number of triangles in the set.-
Fields inherited from class com.openinventor.inventor.nodes.SoNonIndexedShape
startIndex
-
Fields inherited from class com.openinventor.inventor.nodes.SoVertexShape
vertexProperty
-
Fields inherited from class com.openinventor.inventor.nodes.SoShape
boundingBoxIgnoring
-
Fields inherited from class com.openinventor.inventor.Inventor
VERBOSE_LEVEL, ZeroHandle
-
-
Constructor Summary
Constructors Constructor Description SoTriangleSet()
Creates a triangle set node with default settings.
-
Method Summary
-
Methods inherited from class com.openinventor.inventor.nodes.SoVertexShape
getNormalCache, getTangentCache
-
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
-
Methods inherited from class com.openinventor.inventor.Inventor
getNativeResourceHandle
-
-
-
-
Field Detail
-
numTriangles
public final SoSFInt32 numTriangles
Number 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.
-
-