SoGate(3IV)

NAME
     SoGate - selectively copies its input to its output

INHERITS FROM
     SoBase > SoFieldContainer > SoEngine > SoGate

SYNOPSIS
     #include <Inventor/engines/SoGate.h>

          Inputs from class SoGate:

     SoSFBool            enable
     SoSFTrigger         trigger
     <inputType>         input

          Outputs from class SoGate:

     (<outputType>)      output

          Methods from class SoGate:

                         SoGate(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 selectively copies its input to its output. The type of the
     input field can be any subclass of SoMField. The type is specified when
     an instance of the class is created. For example,
     SoGate(SoMFFloat::getClassTypeId())  creates an engine that copies
     floating-point values.

     The enable input controls continous flow-through of values. While enable
     is TRUE, the input will be copied to the output. Alternatively, by
     touching the trigger input, you can copy a single value from the input to
     the output.

     Note that unlike most other engine fields, input and output are pointers.
     Note also that by default input does not contain any values.

INPUTS
     SoSFBool            enable
          Enable continous flow-through.

     SoSFTrigger         trigger
          Copy a single value.

     <inputType>         input
          The value that is copied to the output when the gate is open.


OUTPUTS
     (<outputType>)      output
          Contains a copy of the input value if the gate is open.


METHODS
                         SoGate(SoType inputType)
          Constructor. The argument specifies the type of the input field.


FILE FORMAT/DEFAULTS
     Gate {
          type     <inputType>
          input    []
          enable   FALSE
          trigger
     }

SEE ALSO
     SoEngineOutput, SoConcatenate, SoSelectOne