1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
/*
*
* Copyright (C) 2000 Silicon Graphics, Inc. All Rights Reserved.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* Further, this software is distributed without any warranty that it is
* free of the rightful claim of any third person regarding infringement
* or the like. Any license provided herein, whether implied or
* otherwise, applies only to this software file. Patent licenses, if
* any, provided herein do not apply to combinations of this program with
* other software, or any other product whatsoever.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
* Contact information: Silicon Graphics, Inc., 1600 Amphitheatre Pkwy,
* Mountain View, CA 94043, or:
*
* http://www.sgi.com
*
* For further information regarding this notice, see:
*
* http://oss.sgi.com/projects/GenInfo/NoticeExplan/
*
*/
// -*- C++ -*-
/*
* Copyright (C) 1990,91 Silicon Graphics, Inc.
*
_______________________________________________________________________
______________ S I L I C O N G R A P H I C S I N C . ____________
|
| $Revision: 1.2 $
|
| Description:
| This file defines the SoDebugError class.
|
| Classes:
| SoDebugError
|
| Author(s) : Paul S. Strauss
|
______________ S I L I C O N G R A P H I C S I N C . ____________
_______________________________________________________________________
*/
#ifndef _SO_DEBUG_ERROR
#define _SO_DEBUG_ERROR
#include <Inventor/errors/SoError.h>
//////////////////////////////////////////////////////////////////////////////
//
// Class: SoDebugError
//
// This class is used for all errors reported from the debugging
// version of the Inventor library. These errors are typically
// programmer errors, such as passing a NULL pointer or an
// out-of-range index. The post() method takes the name of the
// Inventor method that detected the error, to aid the programmer in
// debugging.
//
//////////////////////////////////////////////////////////////////////////////
// C-api: prefix=SoDbgErr
#if _COMPILER_VERSION>=710
# pragma set woff 1375
#endif
class SoDebugError : public SoError {
public:
enum Severity {
ERROR, // Error
WARNING, // Just a warning
INFO // No error, just information
};
// Sets/returns handler callback for SoDebugError class
// C-api: name=setHndlrCB
static void setHandlerCallback(SoErrorCB *cb, void *data)
{ handlerCB = cb; cbData = data; }
// C-api: name=getHndlrCB
static SoErrorCB * getHandlerCallback() { return handlerCB; }
// C-api: name=getHndlrData
static void * getHandlerData() { return cbData; }
// Returns type identifier for SoDebugError class
static SoType getClassTypeId() { return classTypeId; }
// Returns type identifier for error instance
virtual SoType getTypeId() const;
// Returns severity of error (for use by handlers)
SoDebugError::Severity getSeverity() const { return severity; }
SoEXTENDER public:
// Posts an error
static void post(const char *methodName,
const char *formatString ...);
// Posts a warning
static void postWarning(const char *methodName,
const char *formatString ...);
// Posts an informational (non-error) message
static void postInfo(const char *methodName,
const char *formatString ...);
SoINTERNAL public:
// Initializes SoDebugError class
static void initClass();
protected:
// Returns handler callback (and data) to use for a given instance
virtual SoErrorCB * getHandler(void *&data) const;
virtual ~SoDebugError() {}
private:
static SoType classTypeId; // Type id of SoDebugError class
static SoErrorCB *handlerCB; // Handler callback for class
static void *cbData; // User data for callback
Severity severity; // Severity of error
};
#if _COMPILER_VERSION>=710
# pragma reset woff 1375
#endif
#endif /* _SO_DEBUG_ERROR */
|
