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:

     SoSFInt32           index
     <inputType>         input

          Outputs from class SoSelectOne:

     (<outputType>)      output

          Methods from class SoSelectOne:

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

     SoSFInt32           index
          Index of the value to select from the multiple-value field.

     <inputType>         input
          The multiple-value field from which the value will be selected.

OUTPUTS

     (<outputType>)      output
          The single value selected.

METHODS

                         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

                                                                               SoSelectOne(3IV)()