public class SoPointSet extends SoNonIndexedShape
vertexProperty
field (from SoVertexShape
) or the current inherited coordinates. For optimal performance, the vertexProperty
field is recommended.
SoPointSet
uses 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 numPoints
field. 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 SoVertexProperty
or 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 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.
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 SoGLRenderAction
class. You can get the current render action object from the viewer (or from the SoSceneManager
if you are not using a viewer).
Shape Antialiasing type is SoShape.POINTS
.
File format/default:
PointSet {
vertexProperty | NULL |
startIndex | 0 |
numPoints | -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 an SoPointDetail
.
SoGetBoundingBoxAction
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.
SoCallbackAction
If any point callbacks are registered with the action, they will be invoked for each point in the set.
See also:
SoCoordinate3
, SoDrawStyle
, SoFullSceneAntialiasing
, SoIndexedPointSet
, SoPointDetail
, SoVertexProperty
SoShape.ShapeTypes
SoNode.RenderModes
Inventor.ConstructorCommand
Modifier and Type | Field and Description |
---|---|
SoSFInt32 |
numPoints
Number of points.
|
startIndex
vertexProperty
boundingBoxIgnoring
VERBOSE_LEVEL, ZeroHandle
Constructor and Description |
---|
SoPointSet()
Creates a point 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 numPoints
Generated on July 31, 2019, Copyright © Thermo Fisher Scientific. All rights reserved. http://www.openinventor.com