SoPointSet(3iv)

1SoPointSet(3IV)()                                            SoPointSet(3IV)()
2
3
4

NAME

6       SoPointSet — point set shape node
7

INHERITS FROM

9       SoBase > SoFieldContainer > SoNode > SoShape > SoVertexShape > SoNonIn‐
10       dexedShape > SoPointSet
11

SYNOPSIS

13       #include <Inventor/nodes/SoPointSet.h>
14
15          Fields from class SoPointSet:
16
17     SoSFInt32           numPoints
18
19          Fields from class SoNonIndexedShape:
20
21     SoSFInt32           startIndex
22
23          Fields from class SoVertexShape:
24
25     SoSFNode            vertexProperty
26
27          Methods from class SoPointSet:
28
29                         SoPointSet()
30     static SoType       getClassTypeId()
31
32          Methods from class SoNode:
33
34     void                setOverride(SbBool state)
35     SbBool              isOverride() const
36     SoNode *            copy(SbBool copyConnections = FALSE) const
37     virtual SbBool      affectsState() const
38     static SoNode *     getByName(const SbName &name)
39     static int          getByName(const SbName &name, SoNodeList &list)
40
41          Methods from class SoFieldContainer:
42
43     void                setToDefaults()
44     SbBool              hasDefaultValues() const
45     SbBool              fieldsAreEqual(const SoFieldContainer *fc) const
46     void                copyFieldValues(const  SoFieldContainer  *fc,  SbBool
47                              copyConnections = FALSE)
48     SbBool              set(const char *fieldDataString)
49     void                get(SbString &fieldDataString)
50     virtual int         getFields(SoFieldList &resultList) const
51     virtual SoField *   getField(const SbName &fieldName) const
52     SbBool              getFieldName(const SoField *field, SbName &fieldName)
53                              const
54     SbBool              isNotifyEnabled() const
55     SbBool              enableNotify(SbBool flag)
56
57          Methods from class SoBase:
58
59     void                ref()
60     void                unref() const
61     void                unrefNoDelete() const
62     void                touch()
63     virtual SoType      getTypeId() const
64     SbBool              isOfType(SoType type) const
65     virtual void        setName(const SbName &name)
66     virtual SbName      getName() const
67
68

DESCRIPTION

70       This node represents a set of points located at the coordinates  speci‐
71       fied  by  the  vertexProperty field (from SoVertexShape) or the current
72       inherited coordinates.  For  optimal  performance,  the  vertexProperty
73       field is recommended.
74
75       SoPointSet  uses the coordinates in order, starting with the first one.
76       The number of points in the set is specified by the numPoints field.
77
78       The coordinates of the point set are transformed by the current cumula‐
79       tive  transformation. The points are drawn with the current light model
80       and drawing style (drawing styles  FILLED  and  LINES  are  treated  as
81       POINTS).
82
83       Treatment  of  the  current  material and normal binding is as follows:
84       PER_PART, PER_FACE, and PER_VERTEX bindings bind one material or normal
85       to  each  point.  The  default material binding is OVERALL. The default
86       normal binding is PER_VERTEX.
87

FIELDS

89     SoSFInt32           numPoints
90          Number of points.
91
92

METHODS

94                         SoPointSet()
95          Creates a point set node with default settings.
96
97     static SoType       getClassTypeId()
98          Returns type identifier for this class.
99
100

ACTION BEHAVIOR

102       SoGLRenderAction
103          Draws points based on the current coordinates,  normals,  materials,
104          drawing style, and so on.
105
106     SoRayPickAction
107          Picks  points  based  on the current coordinates and transformation.
108          Details about the intersection are returned in an SoPointDetail.
109
110     SoGetBoundingBoxAction
111          Computes the bounding box that encloses all points in the  set  with
112          the  current  transformation applied to them. Sets the center to the
113          average of the coordinates of all points.
114
115     SoCallbackAction
116          If any point callbacks are registered with the action, they will  be
117          invoked for each point in the set.
118
119

FILE FORMAT/DEFAULTS

121       PointSet {
122          vertexProperty  NULL
123          startIndex      0
124          numPoints       -1
125     }
126