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
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
|
/**************************************************************************\
*
* This file is part of the Coin 3D visualization library.
* Copyright (C) by Kongsberg Oil & Gas Technologies.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* ("GPL") version 2 as published by the Free Software Foundation.
* See the file LICENSE.GPL at the root directory of this source
* distribution for additional information about the GNU GPL.
*
* For using Coin with software that can not be combined with the GNU
* GPL, and for taking advantage of the additional benefits of our
* support services, please contact Kongsberg Oil & Gas Technologies
* about acquiring a Coin Professional Edition License.
*
* See http://www.coin3d.org/ for more information.
*
* Kongsberg Oil & Gas Technologies, Bygdoy Alle 5, 0257 Oslo, NORWAY.
* http://www.sim.no/ sales@sim.no coin-support@coin3d.org
*
\**************************************************************************/
#ifndef COIN_TIDBITSP_H
#define COIN_TIDBITSP_H
#ifndef COIN_INTERNAL
#error this is a private header file
#endif
#include <stdio.h>
#include <Inventor/C/tidbits.h>
#include <Inventor/C/basic.h>
#include <Inventor/C/base/string.h>
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
#if 0 /* to get proper auto-indentation in emacs */
}
#endif /* emacs indentation */
/* ********************************************************************** */
void coin_init_tidbits(void);
/* ********************************************************************** */
FILE * coin_get_stdin(void);
FILE * coin_get_stdout(void);
FILE * coin_get_stderr(void);
/* ********************************************************************** */
#define coin_atexit(func, priority) \
coin_atexit_func(SO__QUOTE(func), func, priority)
void coin_atexit_cleanup(void);
SbBool coin_is_exiting(void);
/* this enum contains all values that are available for use for the
third argument to coin_atexit_func() -- no other values than these
should be used! */
enum coin_atexit_priorities {
/* Absolute priorities goes first */
/* clean-ups of client code should be done before any clean-up code
within Coin happens, so this is (2^31 - 1): */
CC_ATEXIT_EXTERNAL = 2147483647,
/* clean-up code with no particular dependencies should use this
code: */
CC_ATEXIT_NORMAL = 0,
/* dynamically loaded libraries should be the last to go, as other
code in Coin will be dependent on functionality in these in its
own clean-up code: */
CC_ATEXIT_DYNLIBS = -2147483647,
/* Relative priorities */
/* The realTime field should be cleaned up before normal cleanups
are called, since the global field list will be cleaned up there.
*/
CC_ATEXIT_REALTIME_FIELD = CC_ATEXIT_NORMAL + 10,
/*
We need to clean up default parts for draggers before tracking SoBase instances
*/
CC_ATEXIT_DRAGGERDEFAULTS = CC_ATEXIT_NORMAL + 2,
/*
SoBase instance tracking should happen before normal cleanups
*/
CC_ATEXIT_TRACK_SOBASE_INSTANCES = CC_ATEXIT_NORMAL + 1,
/* Just after NORMAL */
CC_ATEXIT_NORMAL_LOWPRIORITY = CC_ATEXIT_NORMAL - 1,
/*
Used to clean up static data for nodes/elements/nodekits ++
Must be done before the typesystem cleanup
*/
CC_ATEXIT_STATIC_DATA = CC_ATEXIT_NORMAL - 10,
/*
Cleanups for static SoDB data (sensor manager, converters++)
*/
CC_ATEXIT_SODB = CC_ATEXIT_NORMAL - 20,
/*
SoBase (the base class) cleanup.
*/
CC_ATEXIT_SOBASE = CC_ATEXIT_NORMAL - 30,
/*
Typesystem cleanup.
*/
CC_ATEXIT_SOTYPE = CC_ATEXIT_NORMAL - 40,
/* later, in case e.g. some nodes' clean-up depends on the font
subsystem still being up'n'running: */
CC_ATEXIT_FONT_SUBSYSTEM = CC_ATEXIT_NORMAL - 100,
/* Just before FONT_SUBSYSTEM */
CC_ATEXIT_FONT_SUBSYSTEM_HIGHPRIORITY = CC_ATEXIT_FONT_SUBSYSTEM + 1,
/* Just later than FONT_SUBSYSTEM */
CC_ATEXIT_FONT_SUBSYSTEM_LOWPRIORITY = CC_ATEXIT_FONT_SUBSYSTEM - 1,
/* still later, so clean-up code can use e.g. SoDebugError to report
problems, output debugging info, etc: */
CC_ATEXIT_MSG_SUBSYSTEM = CC_ATEXIT_NORMAL - 200,
/*
Clean up the SbName dictionary. Should be done as late as
possible, since SbName is used a lot in other modules.
*/
CC_ATEXIT_SBNAME = CC_ATEXIT_NORMAL - 500,
/* needs to happen late, since CC_ATEXIT_NORMAL clean-up routines
will for instance often want to dealloc mutexes: */
CC_ATEXIT_THREADING_SUBSYSTEM = CC_ATEXIT_NORMAL - 1000,
/* FIXME: Not sure if this is needed, refer comment by mortene where
enum is used in mutex.cpp - 20080711 BFG */
CC_ATEXIT_THREADING_SUBSYSTEM_LOWPRIORITY = CC_ATEXIT_THREADING_SUBSYSTEM - 1,
/* FIXME: Not sure if this is needed, refer comment by mortene where
enum is used in thread.cpp - 20080711 BFG */
CC_ATEXIT_THREADING_SUBSYSTEM_VERYLOWPRIORITY = CC_ATEXIT_THREADING_SUBSYSTEM - 2,
/* Needs to happen late, but before we cleanup our dynamic
libraries */
CC_ATEXIT_ENVIRONMENT = CC_ATEXIT_DYNLIBS + 10
};
void coin_atexit_func(const char * name, coin_atexit_f * fp, coin_atexit_priorities priority);
/* ********************************************************************** */
/*
We're using these to ensure portable import and export even when the
application sets a locale with different thousands separator and
decimal point than the default "C" locale.
Use these functions to wrap locale-aware functions where
necessary:
\code
cc_string storedlocale;
SbBool changed = coin_locale_set_portable(&storedlocale);
// [code with locale-aware functions]
if (changed) { coin_locale_reset(&storedlocale); }
\endcode
Possibly locale-aware functions includes at least atof(), atoi(),
atol(), strtol(), strtoul(), strtod(), strtof(), strtold(), and all
the *printf() functions.
*/
SbBool coin_locale_set_portable(cc_string * storeold);
void coin_locale_reset(cc_string * storedold);
/*
Portable atof() function, which will not cause any trouble due to
underlying locale's decimal point setting.
*/
double coin_atof(const char * ptr);
/* ********************************************************************** */
/*
Functions to output ascii85 encoded data. Used for instance for Postscript
image rendering.
*/
void coin_output_ascii85(FILE * fp,
const unsigned char val,
unsigned char * tuple,
unsigned char * linebuf,
int * tuplecnt, int * linecnt,
const int rowlen,
const SbBool flush);
void coin_flush_ascii85(FILE * fp,
unsigned char * tuple,
unsigned char * linebuf,
int * tuplecnt, int * linecnt,
const int rowlen);
/* ********************************************************************** */
/*
Parse version string of type <major>.<minor>.<patch>. <minor> or
<patch> might not be in the string. It's possible to supply NULL for
minor and/or patch if you're not interested in minor and/or patch.
*/
SbBool coin_parse_versionstring(const char * versionstr,
int * major,
int * minor,
int * patch);
/* ********************************************************************** */
SbBool coin_getcwd(cc_string * str);
/* ********************************************************************** */
int coin_isinf(double value);
int coin_isnan(double value);
int coin_finite(double value);
/* ********************************************************************** */
unsigned long coin_geq_prime_number(unsigned long num);
/* ********************************************************************** */
enum CoinOSType {
COIN_UNIX,
COIN_OS_X,
COIN_MSWINDOWS
};
int coin_runtime_os(void);
#define COIN_MAC_FRAMEWORK_IDENTIFIER_CSTRING ("org.coin3d.Coin.framework")
/* ********************************************************************** */
int coin_debug_extra(void);
int coin_debug_normalize(void);
int coin_debug_caching_level(void);
/* ********************************************************************** */
#ifdef __cplusplus
} /* extern "C" */
#endif /* __cplusplus */
/* ********************************************************************** */
#endif /* !COIN_TIDBITS_H */
|