Open Inventor Reference
|
00001 /* 00002 * 00003 * Copyright (C) 2000 Silicon Graphics, Inc. All Rights Reserved. 00004 * 00005 * This library is free software; you can redistribute it and/or 00006 * modify it under the terms of the GNU Lesser General Public 00007 * License as published by the Free Software Foundation; either 00008 * version 2.1 of the License, or (at your option) any later version. 00009 * 00010 * This library is distributed in the hope that it will be useful, 00011 * but WITHOUT ANY WARRANTY; without even the implied warranty of 00012 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 00013 * Lesser General Public License for more details. 00014 * 00015 * Further, this software is distributed without any warranty that it is 00016 * free of the rightful claim of any third person regarding infringement 00017 * or the like. Any license provided herein, whether implied or 00018 * otherwise, applies only to this software file. Patent licenses, if 00019 * any, provided herein do not apply to combinations of this program with 00020 * other software, or any other product whatsoever. 00021 * 00022 * You should have received a copy of the GNU Lesser General Public 00023 * License along with this library; if not, write to the Free Software 00024 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 00025 * 00026 * Contact information: Silicon Graphics, Inc., 1600 Amphitheatre Pkwy, 00027 * Mountain View, CA 94043, or: 00028 * 00029 * http://www.sgi.com 00030 * 00031 * For further information regarding this notice, see: 00032 * 00033 * http://oss.sgi.com/projects/GenInfo/NoticeExplan/ 00034 * 00035 */ 00036 00037 00038 /* 00039 * Copyright (C) 1990,91,92 Silicon Graphics, Inc. 00040 * 00041 _______________________________________________________________________ 00042 ______________ S I L I C O N G R A P H I C S I N C . ____________ 00043 | 00044 | $Revision: 1.1.1.1 $ 00045 | 00046 | Description: 00047 | Abstract base class for sensors that attach to some part of a 00048 | scene graph and detect changes to it. A data sensor is scheduled 00049 | when a change is made to the thing to which it is attached. This 00050 | change is detected via the notification mechanism. 00051 | 00052 | Author(s) : Nick Thompson, Gavin Bell, Paul Strauss 00053 | 00054 ______________ S I L I C O N G R A P H I C S I N C . ____________ 00055 _______________________________________________________________________ 00056 */ 00057 00058 #ifndef _SO_DATA_SENSOR_ 00059 #define _SO_DATA_SENSOR_ 00060 00061 class SoBase; 00062 class SoNode; 00063 class SoPath; 00064 class SoNotList; 00065 00066 #include <Inventor/sensors/SoDelayQueueSensor.h> 00067 00070 00091 00092 00093 class INVENTOR_API SoDataSensor : public SoDelayQueueSensor { 00094 00095 public: 00097 SoDataSensor(); 00098 SoDataSensor(SoSensorCB *func, void *data); 00099 00101 virtual ~SoDataSensor(); 00102 00105 void setDeleteCallback(SoSensorCB *f, void *data = NULL) 00106 { deleteFunc = f; deleteData = data; } 00107 00117 SoNode * getTriggerNode() const; 00118 00122 SoField * getTriggerField() const; 00123 00129 SoPath * getTriggerPath() const; 00130 00132 void setTriggerPathFlag(SbBool flag) { doTrigPath = flag; } 00134 SbBool getTriggerPathFlag() const { return doTrigPath; } 00135 00137 virtual void unschedule(); 00138 00139 SoINTERNAL public: 00142 virtual void trigger(); 00143 00148 virtual void notify(SoNotList *list); 00149 00153 virtual void dyingReference() = 0; 00154 00155 protected: 00157 void invokeDeleteCallback(); 00158 00159 private: 00160 SoSensorCB *deleteFunc; 00161 void *deleteData; 00162 SoNode *trigNode; 00163 SoField *trigField; 00164 SoPath *trigPath; 00165 SbBool doTrigPath; 00166 }; 00167 00168 #endif /* _SO_DATA_SENSOR_ */