SoConcatenate(3IV)

NAME
     SoConcatenate - joins separate fields into a single multiple-value field

INHERITS FROM
     SoBase > SoFieldContainer > SoEngine > SoConcatenate

SYNOPSIS
     #include <Inventor/engines/SoConcatenate.h>

          Inputs from class SoConcatenate:

     <inputType>         input[10]

          Outputs from class SoConcatenate:

     (<outputType>)      output

          Methods from class SoConcatenate:

                         SoConcatenate(SoType inputType)

          Methods from class SoEngine:

     static SoType       getClassTypeId()
     virtual int         getOutputs(SoEngineOutputList &list) const
     SoEngineOutput *    getOutput(const SbName &outputName) const
     SbBool              getOutputName(const SoEngineOutput *output, SbName
                              &outputName) const
     SoEngine *          copy() const
     static SoEngine *   getByName(const SbName &name)
     static int          getByName(const SbName &name, SoEngineList &list)

          Methods from class SoFieldContainer:

     void                setToDefaults()
     SbBool              hasDefaultValues() const
     SbBool              fieldsAreEqual(const SoFieldContainer *fc) const
     void                copyFieldValues(const SoFieldContainer *fc, SbBool
                              copyConnections = FALSE)
     SbBool              set(const char *fieldDataString)
     void                get(SbString &fieldDataString)
     virtual int         getFields(SoFieldList &resultList) const
     virtual SoField *   getField(const SbName &fieldName) const
     SbBool              getFieldName(const SoField *field, SbName &fieldName)
                              const
     SbBool              isNotifyEnabled() const
     SbBool              enableNotify(SbBool flag)

          Methods from class SoBase:

     void                ref()

     void                unref() const
     void                unrefNoDelete() const
     void                touch()
     virtual SoType      getTypeId() const
     SbBool              isOfType(SoType type) const
     virtual void        setName(const SbName &name)
     virtual SbName      getName() const


DESCRIPTION
     This engine joins up to 10 separate fields of a type into a single
     multiple-valued field of the same type. The type of the input fields can
     be any subclass of SoMField The type is specified when an instance of the
     class is created. For example, SoConcatenate(SoMFFloat::getClassTypeId())
     creates an engine that concatenates floating-point values.

     The input field is a 10-element array, where each element can be
     connected to single- or multiple-valued fields.  All the values in the
     input are concatenated together to form one multiple-value field. For
     example, if input[0] contains 10 values and input[1] contains 3 values,
     the output will contain 13 values.

     Note that, unlike the output of most engines, output is a pointer. Note
     also that by default input does not contain any values, and no value is
     output from the engine.

INPUTS
     <inputType>         input[10]


OUTPUTS
     (<outputType>)      output


METHODS
                         SoConcatenate(SoType inputType)
          Constructor. The argument specifies the type of values to
          concatenate.


FILE FORMAT/DEFAULTS
     Concatenate {
          type                <inputType>
          input0              []
          input1              []
          input2              []
          input3              []
          input4              []
          input5              []
          input6              []
          input7              []
          input8              []
          input9              []
     }

SEE ALSO
     SoEngineOutput, SoGate, SoSelectOne