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