logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

SoMField — base class for all multiple-valued fields

Description

       Each  class  derived from SoMField begins with an SoMF prefix and contains a dynamic array of values of a
       particular type. Each has a setValues() method that is passed a pointer to a const array of values of the
       correct type; these values are copied into the array in the field, making extra  room  in  the  array  if
       necessary. The start and num parameters to this method indicate the starting array index to copy into and
       the number of values to copy.

       The  getValues()  method for a multiple-value field returns a const pointer to the array of values in the
       field. (Because this pointer is const, it cannot be used to change values in this array.)

       In addition, the indexing operator "[]" is overloaded to return the i'th value in the array;  because  it
       returns a const reference, it can be used only to get values, not to set them.

       Methods are provided for getting the number of values in the field, inserting space for new values in the
       middle, and deleting values.

       There are other methods that allow you to set only one value of several in the field and to set the field
       to contain one and only one value.

       Two  other  methods can be used to make several changes to a multiple-value field without the overhead of
       copying values into and out of the fields. The startEditing() method returns a non-const pointer  to  the
       array  of values in the field; this pointer can then be used to change (but not add or remove) any values
       in the array. The finishEditing() method indicates that the editing is done and notifies any  sensors  or
       engines that may be connected to the field.

       SoMFields are written to file as a series of values separated by commas, all enclosed in square brackets.
       If the field has no values (getNum() returns zero), then only the square brackets ("[]") are written. The
       last  value may optionally be followed by a comma. Each field subtype defines how the values are written;
       for example, a field whose values are integers might be written as:

          [ 1, 2, 3, 4 ]
             or:
          [ 1, 2, 3, 4, ]

Inherits From

       SoField > SoMField

Methods

intgetNum()const
          Returns the number of values currently in the field.

     voidsetNum(intnum)
          Forces this field to have exactly num values, inserting or deleting values as necessary.

     virtualvoiddeleteValues(intstart,intnum=-1)
          Deletes num values beginning at index start (index start through start+num-1 will be deleted, and  any
          leftover  values  will  be moved down to fill in the gap created). A num of -1 means delete all values
          from start to the last value in the field; getNum() will return start as the number of values  in  the
          field after this operation (deleteValues(0,-1)emptiesthefield).virtualvoidinsertSpace(intstart,intnum)
          Inserts  space for num values at index start. Index start through start+num-1 will be moved up to make
          room. For example, to make room for 7 new values at the beginning of  the  field  call  insertSpace(0,10).

     SbBoolset1(intindex,constchar*valueString)voidget1(intindex,SbString&valueString)
          These  are  equivalent  to the set() and get() methods of SoField, but they operate on only one value.
          See the SoField methods for details.

     staticSoTypegetClassTypeId()
          Return the type identifier for this field class.

Name

       SoMField — base class for all multiple-valued fields

See Also

SoNode,SoEngineSoMField(3IV)()

Synopsis

#include<Inventor/fields/SoField.h>

          Methods from class SoMField:

     intgetNum()constvoidsetNum(intnum)virtualvoiddeleteValues(intstart,intnum=-1)virtualvoidinsertSpace(intstart,intnum)SbBoolset1(intindex,constchar*valueString)voidget1(intindex,SbString&valueString)staticSoTypegetClassTypeId()

          Methods from class SoField:

     voidsetIgnored(SbBoolignore)SbBoolisIgnored()constSbBoolisDefault()constvirtualSoTypegetTypeId()constvirtualSbBoolisOfType(SoTypetype)constSbBoolset(constchar*valueString)voidget(SbString&valueString)intoperator==(constSoField&f)constintoperator!=(constSoField&f)constvoidtouch()SbBoolconnectFrom(SoField*fromField)SbBoolconnectFrom(SoEngineOutput*fromEngine)voiddisconnect()SbBoolisConnected()constSbBoolisConnectedFromField()constSbBoolgetConnectedField(SoField*&writingField)constSbBoolisConnectedFromEngine()constSbBoolgetConnectedEngine(SoEngineOutput*&engineOutput)constvoidenableConnection(SbBoolflag)SbBoolisConnectionEnabled()constintgetForwardConnections(SoFieldList&list)constSoFieldContainer*getContainer()const

See Also