Open Inventor Release 2024.1.0
 
Loading...
Searching...
No Matches
SoFieldSensor.h
Go to the documentation of this file.
1/*=======================================================================
2 * Copyright 1991-1996, Silicon Graphics, Inc.
3 * ALL RIGHTS RESERVED
4 *
5 * UNPUBLISHED -- Rights reserved under the copyright laws of the United
6 * States. Use of a copyright notice is precautionary only and does not
7 * imply publication or disclosure.
8 *
9 * U.S. GOVERNMENT RESTRICTED RIGHTS LEGEND:
10 * Use, duplication or disclosure by the Government is subject to restrictions
11 * as set forth in FAR 52.227.19(c)(2) or subparagraph (c)(1)(ii) of the Rights
12 * in Technical Data and Computer Software clause at DFARS 252.227-7013 and/or
13 * in similar or successor clauses in the FAR, or the DOD or NASA FAR
14 * Supplement. Contractor/manufacturer is Silicon Graphics, Inc.,
15 * 2011 N. Shoreline Blvd. Mountain View, CA 94039-7311.
16 *
17 * THE CONTENT OF THIS WORK CONTAINS CONFIDENTIAL AND PROPRIETARY
18 * INFORMATION OF SILICON GRAPHICS, INC. ANY DUPLICATION, MODIFICATION,
19 * DISTRIBUTION, OR DISCLOSURE IN ANY FORM, IN WHOLE, OR IN PART, IS STRICTLY
20 * PROHIBITED WITHOUT THE PRIOR EXPRESS WRITTEN PERMISSION OF SILICON
21 * GRAPHICS, INC.
22**=======================================================================*/
23/*=======================================================================
24** Author : Paul Strauss (MMM yyyy)
25**=======================================================================*/
26/*=======================================================================
27 *** THE CONTENT OF THIS WORK IS PROPRIETARY TO FEI S.A.S, (FEI S.A.S.), ***
28 *** AND IS DISTRIBUTED UNDER A LICENSE AGREEMENT. ***
29 *** ***
30 *** REPRODUCTION, DISCLOSURE, OR USE, IN WHOLE OR IN PART, OTHER THAN AS ***
31 *** SPECIFIED IN THE LICENSE ARE NOT TO BE UNDERTAKEN EXCEPT WITH PRIOR ***
32 *** WRITTEN AUTHORIZATION OF FEI S.A.S. ***
33 *** ***
34 *** RESTRICTED RIGHTS LEGEND ***
35 *** USE, DUPLICATION, OR DISCLOSURE BY THE GOVERNMENT OF THE CONTENT OF THIS ***
36 *** WORK OR RELATED DOCUMENTATION IS SUBJECT TO RESTRICTIONS AS SET FORTH IN ***
37 *** SUBPARAGRAPH (C)(1) OF THE COMMERCIAL COMPUTER SOFTWARE RESTRICTED RIGHT ***
38 *** CLAUSE AT FAR 52.227-19 OR SUBPARAGRAPH (C)(1)(II) OF THE RIGHTS IN ***
39 *** TECHNICAL DATA AND COMPUTER SOFTWARE CLAUSE AT DFARS 52.227-7013. ***
40 *** ***
41 *** COPYRIGHT (C) 1996-2014 BY FEI S.A.S, ***
42 *** BORDEAUX, FRANCE ***
43 *** ALL RIGHTS RESERVED ***
44**=======================================================================*/
45/*=======================================================================
46** Modified by : VSG (MMM YYYY)
47**=======================================================================*/
48
49
50#ifndef _SO_FIELD_SENSOR_
51#define _SO_FIELD_SENSOR_
52
54
56
77
78 public:
83
89 SoFieldSensor(SoSensorCB *func, void *data);
90
95 virtual ~SoFieldSensor();
96
101 void attach(SoField *field);
102
108 void detach();
109
115 SoField * getAttachedField() const { return field; }
116
117 private:
118 // Override trigger to evaluate the field we're connected to, just
119 // in case the trigger method doesn't get the value.
120 virtual void trigger();
121
122 private:
123 SoField * field; // Field sensor is attached to
124
125 // Propagates modification notification through an instance. This
126 // checks to see if the field that triggered notification matches
127 // the field we are attached to. (It also checks indices if necessary.)
128 virtual void notify(SoNotList *list);
129
130 // Called by the attached path when it (the path) is about to be deleted
131 virtual void dyingReference();
132
133 // unlocked calls used internally for correct Multithread management
134 void detach(SoField* field);
135};
136
137#endif /* _SO_FIELD_SENSOR_ */
138
void SoSensorCB(void *data, SoSensor *sensor)
This typedef defines the calling sequence for all callbacks from sensors.
Definition SoSensor.h:65
Abstract base class for sensors attached to parts of a scene.
Abstract base class for objects that contain fields.
Base class for all fields.
Definition SoField.h:234
Sensor class that can be attached to Open Inventor fields.
SoFieldSensor(SoSensorCB *func, void *data)
This constructor takes the callback function and data to be called when the sensor is triggered.
void detach()
The detach() method unschedules this sensor (if it is scheduled) and makes it ignore changes to the s...
virtual ~SoFieldSensor()
Destroys the sensor, freeing up any memory associated with it after unscheduling it.
void attach(SoField *field)
The attach() method makes this sensor detect changes to the given field.
SoField * getAttachedField() const
The getAttachedField() method returns the field that this sensor is sensing, or NULL if it is not att...
SoFieldSensor()
Constructor.