1SoMFInt32(3IV)()                                              SoMFInt32(3IV)()
2
3
4

NAME

6       SoMFInt32 — multiple-value field containing any number of int32_t inte‐
7       gers
8

INHERITS FROM

10       SoField > SoMField > SoMFInt32
11

SYNOPSIS

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

DESCRIPTION

67       A  multiple-value  field  that  contains any number of int32_t (32-bit)
68       integers.
69
70       SoMFInt32s are written to file as one or more integer values, in  deci‐
71       mal,  hexadecimal or octal format. When more than one value is present,
72       all of the values are enclosed in square brackets and separated by com‐
73       mas; for example:
74
75          [ 17, -0xE20, -518820 ]
76
77
78

METHODS

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