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 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.2 $ 00045 | 00046 | Description: 00047 | This file defines the base SoError class. 00048 | 00049 | Classes: 00050 | SoError 00051 | 00052 | Author(s) : Paul S. 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_ERROR 00059 #define _SO_ERROR 00060 00061 00062 #include <Inventor/system/SbSystem.h> 00063 #include <Inventor/SbString.h> 00064 #include <Inventor/SoType.h> 00065 00066 class SoError; 00067 00068 class SoBase; 00069 class SoEngine; 00070 class SoNode; 00071 class SoPath; 00072 00074 typedef void INVENTOR_API SoErrorCB(const SoError *error, void *data); 00075 00078 00115 00116 00117 class INVENTOR_API SoError { 00118 00119 public: 00120 00122 static void setHandlerCallback(SoErrorCB *cb, void *data) 00123 { handlerCB = cb; cbData = data; } 00125 static SoErrorCB * getHandlerCallback() { return handlerCB; } 00127 static void * getHandlerData() { return cbData; } 00128 00130 const SbString & getDebugString() const { return debugString; } 00131 00133 static SoType getClassTypeId() { return classTypeId; } 00134 00136 virtual SoType getTypeId() const; 00137 00139 SbBool isOfType(SoType type) const; 00140 00141 SoEXTENDER public: 00144 static void post(const char *formatString ...); 00145 00151 static SbString getString(const SoNode *node); 00152 static SbString getString(const SoPath *path); 00153 static SbString getString(const SoEngine *engine); 00154 00155 SoINTERNAL public: 00157 static void initClass(); 00158 00160 static void initClasses(); 00161 00162 protected: 00164 static void defaultHandlerCB(const SoError *error, void *data); 00165 00167 virtual SoErrorCB * getHandler(void *&data) const; 00168 00170 void setDebugString(const char *string) 00171 { debugString = string; } 00172 void appendToDebugString(const char *string) 00173 { debugString += string; } 00174 00177 void handleError(); 00178 00179 virtual ~SoError() {} 00180 00181 private: 00182 static SoType classTypeId; 00183 static SoErrorCB *handlerCB; 00184 static void *cbData; 00185 static SbBool wasInitted; 00186 SbString debugString; 00187 00189 static SbString getBaseString(const SoBase *base, const char *what); 00190 }; 00191 00192 #endif /* _SO_ERROR */