SoConcatenate(3IV)

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

INHERITS FROM
     SoBase > SoFieldContainer > SoEngine > SoConcatenate

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

     typedef SoConcatenate  SoConcat

          Inputs from class SoConcatenate:

     <inputType>         input[10]

          Outputs from class SoConcatenate:

     (<outputType>)      output

          Functions from class SoConcatenate:

     SoConcatenate *     SoConcatSoConcatCreate(SoType inputType)

          Functions from class SoEngine:

     SoType              SoConcatGetTypeId()
     int                 SoConcatGetOuts(const SoConcat *this,
                              SoEngineOutputList *list)
     SoEngineOutput *    SoConcatGetOut(const SoConcat *this, const char
                              *outputName)
     SbBool              SoConcatGetOutName(const SoConcat *this, const
                              SoEngineOutput *output, SbName *outputName)
     SoEngine *          SoConcatCopy(const SoConcat *this)
     SoEngine *          SoConcatGetByName(const char *name)
     int                 SoConcatGetByNameList(const char *name, SoEngineList
                              *list)

          Functions from class SoFieldContainer:

     SoType              SoConcatGetClassTypeId()
     void                SoConcatSetToDflts(SoConcat *this)
     SbBool              SoConcatHasDfltVals(const SoConcat *this)
     SbBool              SoConcatFldsAreEq(const SoConcat *this, const
                              SoFieldContainer *fc)
     void                SoConcatCopyFieldVals(SoConcat *this, const
                              SoFieldContainer *fc, SbBool copyConnections =
                              FALSE)
     SbBool              SoConcatSet(SoConcat *this, const char
                              *fieldDataString)
     void                SoConcatGet(SoConcat *this, SbString
                              *fieldDataString)
     int                 SoConcatGetFields(const SoConcat *this, SoFieldList
                              *resultList)
     SoField *           SoConcatGetField(const SoConcat *this, const char
                              *fieldName)
     SbBool              SoConcatGetFieldName(const SoConcat *this, const
                              SoField *field, SbName *fieldName)
     SbBool              SoConcatIsNotifyEnabled(const SoConcat *this)
     SbBool              SoConcatEnableNotify(SoConcat *this, SbBool flag)

          Functions from class SoBase:

     void                SoConcatRef(SoConcat *this)
     void                SoConcatUnref(const SoConcat *this)
     void                SoConcatUnrefNoDelete(const SoConcat *this)
     void                SoConcatTouch(SoConcat *this)
     SbBool              SoConcatIsOfType(const SoConcat *this, SoType type)
     void                SoConcatSetName(SoConcat *this, const char *name)
     SbName              SoConcatGetName(const SoConcat *this)


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,  SoConcatCreate(SoMFloatGetClassTypeId())
     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


FUNCTIONS
     SoConcatenate *     SoConcatSoConcatCreate(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