SoConcatenate(3IV)NAMESoConcatenate (SoConcat) - joins separate fields into a single multiple-
value field
INHERITS FROM
SoBase > SoFieldContainer > SoEngine > SoConcatenateSYNOPSIS
#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)
Page 1SoConcatenate(3IV)
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
FUNCTIONSSoConcatenate * SoConcatSoConcatCreate(SoType inputType)
Constructor. The argument specifies the type of values to
concatenate.
Page 2SoConcatenate(3IV)FILE FORMAT/DEFAULTS
Concatenate {
type <inputType>
input0 []
input1 []
input2 []
input3 []
input4 []
input5 []
input6 []
input7 []
input8 []
input9 []
}
SEE ALSO
SoEngineOutput, SoGate, SoSelectOne
Page 3