man SoSelectOne () - selects one value from a multiple-value field.

NAME

SoSelectOne - selects one value from a multiple-value field.

INHERITS FROM

SoBase > SoFieldContainer > SoEngine > SoSelectOne

SYNOPSIS

#include <Inventor/engines/SoSelectOne.h> Inputs from class SoSelectOne: c } c } index

c } c } input Outputs from class SoSelectOne: c } c } output Methods from class SoSelectOne: c } c } SoSelectOne(SoType inputType) Methods from class SoEngine: c } c } getClassTypeId()

c } c } getOutputs(SoEngineOutputList &list) const

c } c } getOutput(const SbName &outputName) const

c } c } getOutputName(const SoEngineOutput *output, SbName &outputName) const

c } c } copy() const

c } c } getByName(const SbName &name)

c } c } getByName(const SbName &name, SoEngineList &list) Methods from class SoFieldContainer: c } c } setToDefaults()

c } c } hasDefaultValues() const

c } c } fieldsAreEqual(const SoFieldContainer *fc) const

c } c } copyFieldValues(const SoFieldContainer *fc, SbBool copyConnections = FALSE)

c } c } set(const char *fieldDataString)

c } c } get(SbString &fieldDataString)

c } c } getFields(SoFieldList &resultList) const

c } c } getField(const SbName &fieldName) const

c } c } getFieldName(const SoField *field, SbName &fieldName) const

c } c } isNotifyEnabled() const

c } c } enableNotify(SbBool flag) Methods from class SoBase: c } c } ref()

c } c } unref() const

c } c } unrefNoDelete() const

c } c } touch()

c } c } getTypeId() const

c } c } isOfType(SoType type) const

c } c } setName(const SbName &name)

c } c } getName() const

DESCRIPTION

This engine selects a single value from a multiple-value field, based on the input field index. The type of the input field can be any subclass of SoMField, and the type of the output is the corresponding subclass of SoSField. For example, if the input type is SoMFVec3f, the output type will be SoSFVec3f. The type is specified when an instance of the class is created. For example, SoSelectOne(SoMFFloat::getClassTypeId()) creates an engine that selects one floating-point value. Note that unlike most other engine fields, the input field and output are pointers. Note also that by default input does not contain any values, and no value is output from the engine.

INPUTS

c } c } index

Index of the value to select from the multiple-value field. c } c } input

The multiple-value field from which the value will be selected.

OUTPUTS

c } c } output

The single value selected.

METHODS

c } c } SoSelectOne(SoType inputType)

Constructor. The argument specifies the type of the multiple-value input field.

FILE FORMAT/DEFAULTS

SelectOne {
type	<inputType>
input	[]
index	0
}

SEE ALSO

SoEngineOutput, SoConcatenate, SoGate