SoMFUInt32(3IV)

SoMFUInt32 (SoMUInt32) - multiple-value field containing any number of uint32_tegers

As shipped in IRIX 6.5.30. Added in IRIX 6.5.22.

NAME
     SoMFUInt32 (SoMUInt32) - multiple-value field containing any number of
     uint32_tegers

INHERITS FROM
     SoField > SoMField > SoMFUInt32

SYNOPSIS
     #include <Inventor_c/fields/SoMFUInt32.h>

     typedef SoMFUInt32  SoMUInt32

          Functions from class SoMFUInt32:

     SoType              SoMUInt32GetClassTypeId()
     void                SoMUInt32GetTypeId(const SoMUInt32 *this)
     uint32_t            SoMUInt32Get(const SoMUInt32 *this, int i)
     const uint32_t *    SoMUInt32GetN(const SoMUInt32 *this, int start)
     int                 SoMUInt32Find(SoMUInt32 *this, uint32_t targetValue,
                              SbBool addIfNotFound = FALSE)
     void                SoMUInt32SetN(SoMUInt32 *this, int start, int num,
                              const uint32_t *newValues)
     void                SoMUInt32Set1(SoMUInt32 *this, int index, uint32_t
                              newValue)
     void                SoMUInt32Set(SoMUInt32 *this, uint32_t newValue)
     int                 SoMUInt32IsEq(const SoMUInt32 *this, const SoMFUInt32
                              *f)
     int                 SoMUInt32IsNEq(const SoMUInt32 *this, const
                              SoMFUInt32 *f)
     uint32_t *          SoMUInt32StartEdit(SoMUInt32 *this)
     void                SoMUInt32FinishEdit(SoMUInt32 *this)

          Functions from class SoMField:

     int                 SoMUInt32GetNum(const SoMUInt32 *this)
     void                SoMUInt32SetNum(SoMUInt32 *this, int num)
     void                SoMUInt32Del(SoMUInt32 *this, int start, int num =
                              -1)
     void                SoMUInt32InsertSpace(SoMUInt32 *this, int start, int
                              num)
     void                SoMUInt32Get1(SoMUInt32 *this, int index, SbString
                              *valueString)

          Functions from class SoField:

     void                SoMUInt32SetIgnored(SoMUInt32 *this, SbBool ignore)
     SbBool              SoMUInt32IsIgnored(const SoMUInt32 *this)
     SbBool              SoMUInt32IsDflt(const SoMUInt32 *this)
     SbBool              SoMUInt32IsOfType(const SoMUInt32 *this, SoType type)
     SbBool              SoMUInt32SetFromStr(SoMUInt32 *this, const char
                              *valueString)
     void                SoMUInt32GetIntoStr(SoMUInt32 *this, SbString
                              *valueString)
     void                SoMUInt32Touch(SoMUInt32 *this)
     SbBool              SoMUInt32ConnFromField(SoMUInt32 *this, SoField
                              *fromField)
     SbBool              SoMUInt32ConnFrom(SoMUInt32 *this, SoEngineOutput
                              *fromEngine)
     void                SoMUInt32Disconn(SoMUInt32 *this)
     SbBool              SoMUInt32IsConn(const SoMUInt32 *this)
     SbBool              SoMUInt32IsConnFromField(const SoMUInt32 *this)
     SbBool              SoMUInt32GetConnField(const SoMUInt32 *this, SoField
                              **writingField)
     SbBool              SoMUInt32IsConnFromEngine(const SoMUInt32 *this)
     SbBool              SoMUInt32GetConnEngine(const SoMUInt32 *this,
                              SoEngineOutput **engineOutput)
     void                SoMUInt32EnableConn(SoMUInt32 *this, SbBool flag)
     SbBool              SoMUInt32IsConnEnabled(const SoMUInt32 *this)
     int                 SoMUInt32GetForwardConn(const SoMUInt32 *this,
                              SoFieldList *list)
     SoFieldContainer *  SoMUInt32GetContainer(const SoMUInt32 *this)


DESCRIPTION
     A multiple-value field that contains any number of uint32_t (32-bit)
     integers.

     SoMFUInt32s are written to file as one or more uint32_t integers, in
     decimal, hexadecimal or octal format.

     When more than one value is present, all of the values are enclosed in
     square brackets and separated by commas; for example:

          [ 17, 0xFFFFE0, 0755 ]



FUNCTIONS
     SoType              SoMUInt32GetClassTypeId()
     void                SoMUInt32GetTypeId(const SoMUInt32 *this)
          Returns the type for this class or a particular object of this
          class.

     uint32_t            SoMUInt32Get(const SoMUInt32 *this, int i)
          Returns the i'th value of the field. Indexing past the end of the
          field (passing in i greater than getNum()) will return garbage.

     const uint32_t *    SoMUInt32GetN(const SoMUInt32 *this, int start)
          Returns a pointer into the array of values in the field, starting at
          index start. The values are read-only; see the
          startEditing()/finishEditing() methods for a way of modifying values
          in place.
     int                 SoMUInt32Find(SoMUInt32 *this, uint32_t targetValue,
                              SbBool addIfNotFound = FALSE)
          Finds the given value in the array and returns the index of that
          value in the array. If the value is not found, -1 is returned. If
          addIfNotFound is set, then targetValue is added to the end of the
          array (but -1 is still returned).

     void                SoMUInt32SetN(SoMUInt32 *this, int start, int num,
                              const uint32_t *newValues)
          Sets num values starting at index start to the values in newValues.
          The array will be automatically be made larger to accomodate the new
          values, if necessary.

     void                SoMUInt32Set1(SoMUInt32 *this, int index, uint32_t
                              newValue)
          Sets the index'th value in the array to newValue. The array will be
          automatically expanded, if necessary.

     void                SoMUInt32Set(SoMUInt32 *this, uint32_t newValue)
          Sets the first value in the array to newValue, and deletes the
          second and subsequent values.

     int                 SoMUInt32IsEq(const SoMUInt32 *this, const SoMFUInt32
                              *f)
     int                 SoMUInt32IsNEq(const SoMUInt32 *this, const
                              SoMFUInt32 *f)
          Returns TRUE if all of the values of this field equal (do not equal)
          those of the given field. If the fields are different types FALSE
          will always be returned (even if one field is an SoMFFloat with one
          value of 1.0 and the other is an SoMFInt with a value of 1, for
          example).

     uint32_t *          SoMUInt32StartEdit(SoMUInt32 *this)
     void                SoMUInt32FinishEdit(SoMUInt32 *this)
          startEditing() returns a pointer to the internally-maintained array
          that can be modified. The values in the array may be changed, but
          values cannot be added or removed. It is illegal to call any other
          editing methods between StartEdit() and FinishEdit() (e.g. Set1(),
          Set(), etc).

          Fields, engines or sensors connected to this field and sensors are
          not notified that this field has changed until FinishEdit() is
          called. Calling FinishEdit() always sets the IsDflt flag to FALSE
          and informs engines and sensors that the field changed, even if none
          of the values actually were changed.