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)()