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

                                                                                            SoConcatenate(3IV)()