00001 /*======================================================================= 00002 * Copyright 1991-1996, Silicon Graphics, Inc. 00003 * ALL RIGHTS RESERVED 00004 * 00005 * UNPUBLISHED -- Rights reserved under the copyright laws of the United 00006 * States. Use of a copyright notice is precautionary only and does not 00007 * imply publication or disclosure. 00008 * 00009 * U.S. GOVERNMENT RESTRICTED RIGHTS LEGEND: 00010 * Use, duplication or disclosure by the Government is subject to restrictions 00011 * as set forth in FAR 52.227.19(c)(2) or subparagraph (c)(1)(ii) of the Rights 00012 * in Technical Data and Computer Software clause at DFARS 252.227-7013 and/or 00013 * in similar or successor clauses in the FAR, or the DOD or NASA FAR 00014 * Supplement. Contractor/manufacturer is Silicon Graphics, Inc., 00015 * 2011 N. Shoreline Blvd. Mountain View, CA 94039-7311. 00016 * 00017 * THE CONTENT OF THIS WORK CONTAINS CONFIDENTIAL AND PROPRIETARY 00018 * INFORMATION OF SILICON GRAPHICS, INC. ANY DUPLICATION, MODIFICATION, 00019 * DISTRIBUTION, OR DISCLOSURE IN ANY FORM, IN WHOLE, OR IN PART, IS STRICTLY 00020 * PROHIBITED WITHOUT THE PRIOR EXPRESS WRITTEN PERMISSION OF SILICON 00021 * GRAPHICS, INC. 00022 **=======================================================================*/ 00023 /*======================================================================= 00024 ** Author : Paul S. Strauss (MMM yyyy) 00025 ** Modified by : Nick Thompson (MMM yyyy) 00026 ** Modified by : Gavin Bell (MMM yyyy) 00027 **=======================================================================*/ 00028 /*======================================================================= 00029 *** THE CONTENT OF THIS WORK IS PROPRIETARY TO FEI S.A.S, (FEI S.A.S.), *** 00030 *** AND IS DISTRIBUTED UNDER A LICENSE AGREEMENT. *** 00031 *** *** 00032 *** REPRODUCTION, DISCLOSURE, OR USE, IN WHOLE OR IN PART, OTHER THAN AS *** 00033 *** SPECIFIED IN THE LICENSE ARE NOT TO BE UNDERTAKEN EXCEPT WITH PRIOR *** 00034 *** WRITTEN AUTHORIZATION OF FEI S.A.S. *** 00035 *** *** 00036 *** RESTRICTED RIGHTS LEGEND *** 00037 *** USE, DUPLICATION, OR DISCLOSURE BY THE GOVERNMENT OF THE CONTENT OF THIS *** 00038 *** WORK OR RELATED DOCUMENTATION IS SUBJECT TO RESTRICTIONS AS SET FORTH IN *** 00039 *** SUBPARAGRAPH (C)(1) OF THE COMMERCIAL COMPUTER SOFTWARE RESTRICTED RIGHT *** 00040 *** CLAUSE AT FAR 52.227-19 OR SUBPARAGRAPH (C)(1)(II) OF THE RIGHTS IN *** 00041 *** TECHNICAL DATA AND COMPUTER SOFTWARE CLAUSE AT DFARS 52.227-7013. *** 00042 *** *** 00043 *** COPYRIGHT (C) 1996-2021 BY FEI S.A.S, *** 00044 *** BORDEAUX, FRANCE *** 00045 *** ALL RIGHTS RESERVED *** 00046 **=======================================================================*/ 00047 /*======================================================================= 00048 ** Modified by : VSG (MMM YYYY) 00049 **=======================================================================*/ 00050 00051 00052 #ifndef _SO_CALLBACK_ 00053 #define _SO_CALLBACK_ 00054 00055 #include <Inventor/SbLinear.h> 00056 #include <Inventor/nodes/SoNode.h> 00057 00059 // 00060 // Class: SoCallback 00061 // 00062 // The SoCallback node is a general mechanism that allows 00063 // applications to insert callback functions into a scene graph. The 00064 // callback function registered with the node is called each time 00065 // that node is traversed to perform any scene graph action. When the 00066 // callback function is called, it is passed a pointer to the action 00067 // being traversed and a user-data pointer that is registered with 00068 // the callback function. A NULL callback function pointer means that 00069 // no function will be called. 00070 // 00072 00076 typedef void SoCallbackCB(void *userData, SoAction *action); 00077 00437 class SoCallback : public SoNode { 00438 00439 SO_NODE_HEADER(SoCallback); 00440 00441 public: 00445 SoCallback(); 00446 00452 void setCallback(SoCallbackCB *func, void *localUserData = NULL) 00453 { callbackFunc = func; callbackData = localUserData; } 00454 00455 private: 00456 00457 // Traversal methods for all the actions: 00458 virtual void doAction(SoAction *action); 00459 virtual void callback(SoCallbackAction *action); 00460 virtual void GLRender(SoGLRenderAction *action); 00461 virtual void getBoundingBox(SoGetBoundingBoxAction *action); 00462 virtual void getMatrix(SoGetMatrixAction *action); 00463 virtual void handleEvent(SoHandleEventAction *action); 00464 virtual void pick(SoPickAction *action); 00465 virtual void search(SoSearchAction *action); 00466 virtual void write(SoWriteAction *action); 00467 virtual void getPrimitiveCount(SoGetPrimitiveCountAction *action); 00468 00469 private: 00470 00471 static void initClass(); 00472 static void exitClass(); 00473 00474 // Convenient Constructor 00475 SoCallback( SoCallbackCB* func, void* localUserData = nullptr ); 00476 00477 00478 //Gets pointer to callback function. By default, the function pointer in the node is nullptr and does nothing. 00479 SoCallbackCB* getCallback() const; 00480 00481 // Copies the contents of the given node into this instance 00482 virtual void copyContents(const SoFieldContainer *fromFC, 00483 SbBool copyConnections); 00484 00485 private: 00486 00487 // destructor 00488 virtual ~SoCallback(); 00489 00490 // Function to call 00491 SoCallbackCB *callbackFunc; 00492 00493 // User data to pass it 00494 void *callbackData; 00495 }; 00496 00497 #endif /* _SO_CALLBACK_ */ 00498 00499