1SoSFTrigger(3IV)()                                          SoSFTrigger(3IV)()
2
3
4

NAME

6       SoSFTrigger — field used to trigger engines or connection networks
7

INHERITS FROM

9       SoField > SoSField > SoSFTrigger
10

SYNOPSIS

12       #include <Inventor/fields/SoSFTrigger.h>
13
14          Methods from class SoSFTrigger:
15
16     void                setValue()
17     void                getValue()
18     int                 operator ==(const SoSFTrigger &t) const
19     int                 operator !=(const SoSFTrigger &t) const
20
21          Methods from class SoSField:
22
23     static SoType       getClassTypeId()
24
25          Methods from class SoField:
26
27     void                setIgnored(SbBool ignore)
28     SbBool              isIgnored() const
29     SbBool              isDefault() const
30     virtual SoType      getTypeId() const
31     virtual SbBool      isOfType(SoType type) const
32     SbBool              set(const char *valueString)
33     void                get(SbString &valueString)
34     void                touch()
35     SbBool              connectFrom(SoField *fromField)
36     SbBool              connectFrom(SoEngineOutput *fromEngine)
37     void                disconnect()
38     SbBool              isConnected() const
39     SbBool              isConnectedFromField() const
40     SbBool              getConnectedField(SoField *&writingField) const
41     SbBool              isConnectedFromEngine() const
42     SbBool              getConnectedEngine(SoEngineOutput     *&engineOutput)
43                              const
44     void                enableConnection(SbBool flag)
45     SbBool              isConnectionEnabled() const
46     int                 getForwardConnections(SoFieldList &list) const
47     SoFieldContainer *  getContainer() const
48
49

DESCRIPTION

51       This class can be used to start or to synchronize a  network  of  field
52       connections.  It  is  the  "null" field — a field with no values. It is
53       typically used as the "start button" for engines that change over time.
54
55       Triggers can be connected from any other type of field, and will notify
56       any  engines  or nodes they are part of (or any other triggers they are
57       connected to) whenever the value of the field is set (even if it is set
58       to its current value) or the field is touch()'ed.
59
60       Since  they have no value, SoSFTriggers are not written to file. A node
61       or engine containing an SoSFTrigger field will write only  the  field's
62       name.
63

METHODS

65     void                setValue()
66          Starts  the  notification  process;  this  is  equivalent to calling
67          touch().
68
69     void                getValue()
70          Forces any connected engines or fields to evaluate themselves.
71
72     int                 operator ==(const SoSFTrigger &t) const
73     int                 operator !=(const SoSFTrigger &t) const
74          All trigger fields are equal; these methods always return  TRUE  and
75          FALSE, respectively.
76
77

SEE ALSO

79       SoSFBool, SoMFBool
80
81
82
83
84                                                            SoSFTrigger(3IV)()