Class SoIndexedPointSet
- java.lang.Object
-
- All Implemented Interfaces:
SafeDisposable
- Direct Known Subclasses:
SoIndexedMarkerSet
public class SoIndexedPointSet extends SoIndexedShape
Indexed point set shape node. This node represents a set of points located at the coordinates specified by thevertexProperty
field (fromSoVertexShape
) or the current inherited coordinates. For optimal performance, thevertexProperty
field is recommended.Each point consists of one vertex, which is denoted by an integer index (from the
coordIndex
field) into the current coordinates. The number of values in the coordIndex field defines the number of points. Depending on the current material and normal binding values, the materials and normals for the vertices may be accessed in order or indexed. If they are indexed, the materialIndex and normalIndex fields are used.The coordinates of the point set are transformed by the current cumulative transformation.
Lighting is not applied to points (i.e., they are rendered with light model BASE_COLOR) unless the application explicitly sets normal vectors using
SoVertexProperty
orSoNormal
. Note that this is specific to direct rendering of point sets. If you render polygonal geometry, e.g.SoFaceSet
, in POINTS mode (SoDrawStyle
), normal vectors are computed by Open Inventor and lighting is enabled.NOTE: If you want to apply lighting in a shader, you still need to explicitly set normal vectors, otherwise lighting will be disabled for the point set.
Point size is controlled by the
SoDrawStyle
field pointSize.Automatic simplification (by skipping points) is controlled by the
SoComplexity
field value. Only values < 0.5 have any effect.Treatment of the current material and normal binding is as follows: PER_PART, PER_FACE, and PER_VERTEX bindings bind one material or normal to each point. The default material binding is OVERALL. The default normal binding is PER_VERTEX.
Shape Antialiasing type is
SoShape.POINTS
.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.
File format/default:
IndexedPointSet {
vertexProperty NULL coordIndex -1 materialIndex -1 normalIndex -1 textureCoordIndex -1 Action behavior:
SoGLRenderAction
Draws points based on the current coordinates, normals, materials, drawing style, and so on.SoRayPickAction
Picks points based on the current coordinates and transformation. Details about the intersection are returned in anSoPointDetail
.SoGetBoundingBoxAction
Computes the bounding box that encloses all vertices of the point set with the current transformation applied to them. Sets the center to the average of the coordinates of all points.SoCallbackAction
If any point callbacks are registered with the action, they will be invoked for each successive point in the set.
-
-
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 inherited from class com.openinventor.inventor.nodes.SoIndexedShape
coordIndex, materialIndex, normalIndex, tangentIndex, textureCoordIndex
-
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 SoIndexedPointSet()
Creates an indexed point 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
-
-