SoConcatenate.3iv man page

SoConcatenate — joins separate fields into a single multiple-value field

Inherits from

SoBase > SoFieldContainer > SoEngine > SoConcatenate


#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


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.


<inputType> input[10]


(<outputType>) output


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