SoLineSet(3iv)

1SoLineSet(3IV)()                                              SoLineSet(3IV)()
2
3
4

NAME

6       SoLineSet — polyline shape node
7

INHERITS FROM

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

SYNOPSIS

13       #include <Inventor/nodes/SoLineSet.h>
14
15          Fields from class SoLineSet:
16
17     SoMFInt32           numVertices
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 SoLineSet:
28
29                         SoLineSet()
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 3D shape formed by constructing  polylines  from
71       vertices  located  at  the  coordinates specified in the vertexProperty
72       field (from SoVertexShape), or the current inherited  coordinates.  For
73       optimal performance, the vertexProperty field is recommended.
74
75       SoLineSet  uses  the coordinates in order, starting with the first one.
76       Each line has a number of vertices specified by a value in the  numVer‐
77       tices  field.  For  example, an SoLineSet with a numVertices of [3,4,2]
78       would use coordinates 1, 2, and 3 for the first line, coordinates 4, 5,
79       6, and 7 for the second line, and coordinates 8 and 9 for the third.
80
81       The  number  of values in the numVertices field indicates the number of
82       polylines in the set.
83
84       The coordinates of the line set are transformed by the current  cumula‐
85       tive  transformation.  The lines are drawn with the current light model
86       and drawing style (drawing style FILLED is treated as LINES).
87
88       Treatment of the current material and normal binding is as follows: The
89       PER_PART binding specifies a material or normal for each segment of the
90       line. The PER_FACE binding specifies a  material  or  normal  for  each
91       polyline.  The  _INDEXED  bindings  are equivalent to their non-indexed
92       counterparts. The default material binding is OVERALL. The default nor‐
93       mal binding is PER_VERTEX.
94
95       The  current  complexity  value  has no effect on the rendering of line
96       sets.
97

FIELDS

99     SoMFInt32           numVertices
100          Number of vertices per polyline.
101
102

METHODS

104                         SoLineSet()
105          Creates a line set node with default settings.
106
107     static SoType       getClassTypeId()
108          Returns type identifier for this class.
109
110

ACTION BEHAVIOR

112       SoGLRenderAction
113          Draws lines based on the current  coordinates,  normals,  materials,
114          drawing style, and so on.
115
116     SoRayPickAction
117          Picks  lines  based  on  the current coordinates and transformation.
118          Details about the intersection are returned in an SoLineDetail.
119
120     SoGetBoundingBoxAction
121          Computes the bounding box that encloses all vertices of the line set
122          with  the current transformation applied to them. Sets the center to
123          the average of the coordinates of all vertices.
124
125     SoCallbackAction
126          If any line segment callbacks are registered with the  action,  they
127          will be invoked for each successive segment in the line set.
128
129

FILE FORMAT/DEFAULTS

131       LineSet {
132          vertexProperty  NULL
133          startIndex      0
134          numVertices     -1
135     }
136