1SoMFVec4f(3IV)() SoMFVec4f(3IV)()
2
6 SoMFVec4f — multiple-value field containing any number of four-dimen‐
7 sional vectors
8
10 SoField > SoMField > SoMFVec4f
11
13 #include <Inventor/fields/SoMFVec4f.h>
14 Methods from class SoMFVec4f:
16 void setValues(int start, int num, const float xyzw[][4])
18 void set1Value(int index, float x, float y, float z, float
19 w)
20 void set1Value(int index, const float xyzw[4])
21 void setValue(float x, float y, float z, float w)
22 void setValue(const float xyzw[4])
23 static SoType getClassTypeId()
24 virtual void getTypeId() const
25 const SbVec4f & operator [](int i) const
26 const SbVec4f * getValues(int start) const
27 int find(const SbVec4f & targetValue, SbBool addIfNot‐
28 Found = FALSE)
29 void setValues(int start, int num, const SbVec4f *newVal‐
30 ues)
31 void set1Value(int index, const SbVec4f & newValue)
32 const SbVec4f & operator =(const SbVec4f & newValue)
33 void setValue(const SbVec4f & newValue)
34 int operator ==(const SoMFVec4f &f) const
35 int operator !=(const SoMFVec4f &f) const
36 SbVec4f * startEditing()
37 void finishEditing()
38 Methods from class SoMField:
40 int getNum() const
42 void setNum(int num)
43 virtual void deleteValues(int start, int num = -1)
44 virtual void insertSpace(int start, int num)
45 SbBool set1(int index, const char *valueString)
46 void get1(int index, SbString &valueString)
47 Methods from class SoField:
49 void setIgnored(SbBool ignore)
51 SbBool isIgnored() const
52 SbBool isDefault() const
53 virtual SbBool isOfType(SoType type) const
54 SbBool set(const char *valueString)
55 void get(SbString &valueString)
56 void touch()
57 SbBool connectFrom(SoField *fromField)
58 SbBool connectFrom(SoEngineOutput *fromEngine)
59 void disconnect()
60 SbBool isConnected() const
61 SbBool isConnectedFromField() const
62 SbBool getConnectedField(SoField *&writingField) const
63 SbBool isConnectedFromEngine() const
64 SbBool getConnectedEngine(SoEngineOutput *&engineOutput)
65 const
66 void enableConnection(SbBool flag)
67 SbBool isConnectionEnabled() const
68 int getForwardConnections(SoFieldList &list) const
69 SoFieldContainer * getContainer() const
70
73 A multiple-value field that contains any number of four-dimensional
74 vectors.
75 SoMFVec4fs are written to file as one or more triples of floating point
77 values separated by whitespace.
78 When more than one value is present, all of the values are enclosed in
80 square brackets and separated by commas; for example:
81 [ 0 0 0, 1.2 3.4 5.6, 98.6 -4e1 212 ]
83
87 void setValues(int start, int num, const float xyzw[][4])
88 Sets num values starting at index start to the given floating point
89 values. There must be num*4 values in the passed array.
90 void set1Value(int index, float x, float y, float z, float
92 w)
93 void set1Value(int index, const float xyzw[4])
94 Set the index'th value to the given floating point values.
95 void setValue(float x, float y, float z, float w)
97 void setValue(const float xyzw[4])
98 Sets the field to contain the given value and only the given value
99 (if the array had multiple values before, they are deleted).
100 static SoType getClassTypeId()
102 virtual void getTypeId() const
103 Returns the type for this class or a particular object of this
104 class.
105 const SbVec4f & operator [](int i) const
107 Returns the i'th value of the field. Indexing past the end of the
108 field (passing in i greater than getNum()) will return garbage.
109 const SbVec4f * getValues(int start) const
111 Returns a pointer into the array of values in the field, starting at
112 index start. The values are read-only; see the startEditing()/fin‐
113 ishEditing() methods for a way of modifying values in place.
114 int find(const SbVec4f & targetValue, SbBool addIfNot‐
116 Found = FALSE)
117 Finds the given value in the array and returns the index of that
118 value in the array. If the value is not found, -1 is returned. If
119 addIfNotFound is set, then targetValue is added to the end of the
120 array (but -1 is still returned).
121 void setValues(int start, int num, const SbVec4f *newVal‐
123 ues)
124 Sets num values starting at index start to the values in newValues.
125 The array will be automatically be made larger to accomodate the new
126 values, if necessary.
127 void set1Value(int index, const SbVec4f & newValue)
129 Sets the index'th value in the array to newValue. The array will be
130 automatically expanded, if necessary.
131 const SbVec4f & operator =(const SbVec4f & newValue)
133 void setValue(const SbVec4f & newValue)
134 Sets the first value in the array to newValue, and deletes the sec‐
135 ond and subsequent values.
136 int operator ==(const SoMFVec4f &f) const
138 int operator !=(const SoMFVec4f &f) const
139 Returns TRUE if all of the values of this field equal (do not equal)
140 those of the given field. If the fields are different types FALSE
141 will always be returned (even if one field is an SoMFFloat with one
142 value of 1.0 and the other is an SoMFInt with a value of 1, for
143 example).
144 SbVec4f * startEditing()
146 void finishEditing()
147 startEditing() returns a pointer to the internally-maintained array
148 that can be modified. The values in the array may be changed, but
149 values cannot be added or removed. It is illegal to call any other
150 editing methods between startEditing() and finishEditing() (e.g.
151 set1Value(), setValue(), etc).
152 Fields, engines or sensors connected to this field and sensors are
154 not notified that this field has changed until finishEditing() is
155 called. Calling finishEditing() always sets the isDefault() flag to
156 FALSE and informs engines and sensors that the field changed, even
157 if none of the values actually were changed.
158 SoMFVec4f(3IV)()