SoPointSet Class Reference
[Shapes]

Point set shape node. More...

#include <Inventor/nodes/SoPointSet.h>

Inheritance diagram for SoPointSet:
SoNonIndexedShape SoVertexShape SoShape SoNode SoFieldContainer SoBase SoRefCounter SoTypedObject SoMarkerSet

List of all members.

Public Member Functions

virtual SoType getTypeId () const
 SoPointSet ()

Static Public Member Functions

static SoType getClassTypeId ()

Public Attributes

SoSFInt32 numPoints

Detailed Description

Point set shape node.

This node represents a set of points located at the coordinates specified by the 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

ACTION BEHAVIOR

SEE ALSO

SoCoordinate3, SoDrawStyle, SoFullSceneAntialiasing, SoIndexedPointSet, SoPointDetail, SoVertexProperty

See related examples:

MarkerSet, ColoredMarkerSet


Constructor & Destructor Documentation

SoPointSet::SoPointSet (  ) 

Creates a point set node with default settings.


Member Function Documentation

static SoType SoPointSet::getClassTypeId (  )  [static]

Returns the type identifier for this class.

Reimplemented from SoNonIndexedShape.

Reimplemented in SoMarkerSet.

virtual SoType SoPointSet::getTypeId (  )  const [virtual]

Returns the type identifier for this specific instance.

Reimplemented from SoNonIndexedShape.

Reimplemented in SoMarkerSet.


Member Data Documentation

Number of points.


The documentation for this class was generated from the following file:

Open Inventor Toolkit reference manual, generated on 27 Oct 2019
Copyright © Thermo Fisher Scientific All rights reserved.
http://www.openinventor.com/