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