- All Implemented Interfaces:
- Direct Known Subclasses:
public class SoPointSet extends SoNonIndexedShapePoint set shape node. This node represents a set of points located at the coordinates specified by the
SoVertexShape) or the current inherited coordinates. For optimal performance, the
vertexPropertyfield is recommended.
SoPointSetuses the coordinates in order, starting with the coordinate at
startIndex. The number of coordinates to use (the number of points in the set) is specified by the
numPointsfield. The default value of this field is -1, which means to use all the coordinates, so it may not be necessary to explicitly set this field.
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
SoNormal. 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
Automatic simplification (by skipping points) is controlled by the
SoComplexityfield 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.
By default OpenGL renders points as "squares". To get round points (points rendered as circles) you must explicitly enable point smoothing, using the setSmoothing() method in the
SoGLRenderActionclass. You can get the current render action object from the viewer (or from the
SoSceneManagerif you are not using a viewer).
Shape Antialiasing type is
- By default,
SoPointSetignores the vertex ordering set on the state by
SoShapeHintsnodes in order to avoid a performance hit on some GeForce cards. However, this default behavior can be changed using the environment variable OIV_POINT_SET_USE_VERTEX_ORDERING (see
vertexProperty NULL startIndex 0 numPoints -1
Draws points based on the current coordinates, normals, materials, drawing style, and so on.
Computes the bounding box that encloses all points in the set with the current transformation applied to them. Sets the center to the average of the coordinates of all points.
If any point callbacks are registered with the action, they will be invoked for each point 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
numPointsNumber of points.
Constructors Constructor Description
SoPointSet()Creates a point 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 numPointsNumber of points.