1SoMFFloat(3IV)()                                              SoMFFloat(3IV)()
2
3
4

NAME

6       SoMFFloat  —  multiple-value  field  containing  any number of floating
7       point values
8

INHERITS FROM

10       SoField > SoMField > SoMFFloat
11

SYNOPSIS

13       #include <Inventor/fields/SoMFFloat.h>
14
15          Methods from class SoMFFloat:
16
17     static SoType       getClassTypeId()
18     virtual void        getTypeId() const
19     float               operator [](int i) const
20     const float *       getValues(int start) const
21     int                 find(float targetValue, SbBool addIfNotFound = FALSE)
22     void                setValues(int start, int num, const float *newValues)
23     void                set1Value(int index, float newValue)
24     float               operator =(float newValue)
25     void                setValue(float newValue)
26     int                 operator ==(const SoMFFloat &f) const
27     int                 operator !=(const SoMFFloat &f) const
28     float *             startEditing()
29     void                finishEditing()
30
31          Methods from class SoMField:
32
33     int                 getNum() const
34     void                setNum(int num)
35     virtual void        deleteValues(int start, int num = -1)
36     virtual void        insertSpace(int start, int num)
37     SbBool              set1(int index, const char *valueString)
38     void                get1(int index, SbString &valueString)
39
40          Methods from class SoField:
41
42     void                setIgnored(SbBool ignore)
43     SbBool              isIgnored() const
44     SbBool              isDefault() const
45     virtual SbBool      isOfType(SoType type) const
46     SbBool              set(const char *valueString)
47     void                get(SbString &valueString)
48     void                touch()
49     SbBool              connectFrom(SoField *fromField)
50     SbBool              connectFrom(SoEngineOutput *fromEngine)
51     void                disconnect()
52     SbBool              isConnected() const
53     SbBool              isConnectedFromField() const
54     SbBool              getConnectedField(SoField *&writingField) const
55     SbBool              isConnectedFromEngine() const
56     SbBool              getConnectedEngine(SoEngineOutput     *&engineOutput)
57                              const
58     void                enableConnection(SbBool flag)
59     SbBool              isConnectionEnabled() const
60     int                 getForwardConnections(SoFieldList &list) const
61     SoFieldContainer *  getContainer() const
62
63

DESCRIPTION

65       A  multiple-value field that contains any number of floating point val‐
66       ues.
67
68       SoMFFloats are written to file as one or more values in standard scien‐
69       tific  notation. When more than one value is present, all of the values
70       are enclosed in square brackets and separated by commas; for example:
71
72          [ 1.0, 2.3, 5, 6.2e4, -100, ]
73
74     The last comma is optional.
75

METHODS

77     static SoType       getClassTypeId()
78     virtual void        getTypeId() const
79          Returns the type for this class  or  a  particular  object  of  this
80          class.
81
82     float               operator [](int i) const
83          Returns  the  i'th  value of the field. Indexing past the end of the
84          field (passing in i greater than getNum()) will return garbage.
85
86     const float *       getValues(int start) const
87          Returns a pointer into the array of values in the field, starting at
88          index  start.  The values are read-only; see the startEditing()/fin‐
89          ishEditing() methods for a way of modifying values in place.
90
91     int                 find(float targetValue, SbBool addIfNotFound = FALSE)
92          Finds the given value in the array and returns  the  index  of  that
93          value  in  the  array. If the value is not found, -1 is returned. If
94          addIfNotFound is set, then targetValue is added to the  end  of  the
95          array (but -1 is still returned).
96
97     void                setValues(int start, int num, const float *newValues)
98          Sets  num values starting at index start to the values in newValues.
99          The array will be automatically be made larger to accomodate the new
100          values, if necessary.
101
102     void                set1Value(int index, float newValue)
103          Sets  the index'th value in the array to newValue. The array will be
104          automatically expanded, if necessary.
105
106     float               operator =(float newValue)
107     void                setValue(float newValue)
108          Sets the first value in the array to newValue, and deletes the  sec‐
109          ond and subsequent values.
110
111     int                 operator ==(const SoMFFloat &f) const
112     int                 operator !=(const SoMFFloat &f) const
113          Returns TRUE if all of the values of this field equal (do not equal)
114          those of the given field. If the fields are  different  types  FALSE
115          will  always be returned (even if one field is an SoMFFloat with one
116          value of 1.0 and the other is an SoMFInt with  a  value  of  1,  for
117          example).
118
119     float *             startEditing()
120     void                finishEditing()
121          startEditing()  returns a pointer to the internally-maintained array
122          that can be modified. The values in the array may  be  changed,  but
123          values  cannot  be added or removed. It is illegal to call any other
124          editing methods between  startEditing()  and  finishEditing()  (e.g.
125          set1Value(), setValue(), etc).
126
127          Fields,  engines  or sensors connected to this field and sensors are
128          not notified that this field has changed  until  finishEditing()  is
129          called.  Calling finishEditing() always sets the isDefault() flag to
130          FALSE and informs engines and sensors that the field  changed,  even
131          if none of the values actually were changed.
132
133
134
135
136                                                              SoMFFloat(3IV)()
Impressum