81479c964dbc56bacde5ce0e4645f845ecfb11e9
[ctsim.git] / include / ctsupport.h
1 /*****************************************************************************
2 ** FILE IDENTIFICATION
3 **
4 **      File Name:      ctsupport.h
5 **      Author:         Kevin Rosenberg
6 **      Purpose:        Header file for CT support library
7 **      Date Started:   Dec. 83
8 **
9 **  This is part of the CTSim program
10 **  Copyright (C) 1983-2000 Kevin Rosenberg
11 **
12 **  $Id: ctsupport.h,v 1.19 2000/12/29 20:04:02 kevin Exp $
13 **
14 **
15 **  This program is free software; you can redistribute it and/or modify
16 **  it under the terms of the GNU General Public License (version 2) as
17 **  published by the Free Software Foundation.
18 **
19 **  This program is distributed in the hope that it will be useful,
20 **  but WITHOUT ANY WARRANTY; without even the implied warranty of
21 **  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
22 **  GNU General Public License for more details.
23 **
24 **  You should have received a copy of the GNU General Public License
25 **  along with this program; if not, write to the Free Software
26 **  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
27 ******************************************************************************/
28
29 #ifndef CTSUPPORT_H
30 #define CTSUPPORT_H
31
32 #ifdef HAVE_CONFIG_H
33 #include "config.h"
34 #endif
35
36 #ifdef MSVC
37 #include "msvc_compat.h"
38 #endif
39
40 #define STR_MAX_LEN 255
41 #define STR_SIZE    STR_MAX_LEN+1
42
43 #include <cstdio>
44 #include <cstdlib>
45 #include <cstring>
46 #include <cstdarg>\r
47 #include <string>
48 #include <vector>\r
49 #include <algorithm>\r
50
51 #define TRUE    1
52 #define FALSE   0
53 #define OK      TRUE
54
55 /*----------------------------------------------------------------------*/
56
57 #define SHOW(var, fmt)  { cerr << "var = " << var << endl; }
58
59 /*----------------------------------------------------------------------*/
60
61 #define NEWLINE '\n'
62 #define TAB     '\t'
63 #define EOS     '\0'
64 #define BLANK   ' '
65
66 /*----------------------------------------------------------------------*/
67
68 #define ERR_TRACE -1\r
69 #define ERR_WARNING     0
70 #define ERR_SEVERE      1
71 #define ERR_FATAL       2
72
73 /*----------------------------------------------------------------------*/
74
75
76 /* codes for open command */
77 #ifdef MSVC
78 #define OPEN_RDONLY  O_RDONLY                   /* other system use standard codes */
79 #define OPEN_WRONLY  O_WRONLY                   /* for binary */
80 #define OPEN_RDWR    O_RDWR
81 #else
82 #define OPEN_RDONLY  0                  /* other system use standard codes */
83 #define OPEN_WRONLY  1                  /* for binary */
84 #define OPEN_RDWR    2
85 #endif
86
87 /*----------------------------------------------------------------------*/
88
89 #if !defined(O_BINARY) && !defined(MSVC)
90 #define O_BINARY (0)
91 #endif
92
93 #ifndef S_IWRITE
94 #define S_IWRITE S_IWUSR
95 #endif
96
97 /*----------------------------------------------------------------------*/
98
99 #if defined(MSVC) || ! defined(SIZEOF_INT)
100    #define SIZEOF_INT 4
101    #define SIZEOF_LONG 4
102    #define SIZEOF_SHORT 2
103    #define SIZEOF_FLOAT 4
104    #define SIZEOF_DOUBLE 8
105 #endif
106
107 typedef signed char kint8;
108 typedef unsigned char kuint8;
109
110 #if SIZEOF_INT == 4
111     typedef int kint32;
112     typedef unsigned int kuint32;
113 #elif SIZEOF_LONG == 4
114     typedef long int kint32;
115     typedef unsigned int kuint32;
116 #endif
117
118 #if SIZEOF_SHORT == 2
119     typedef short int kint16;
120     typedef unsigned short int kuint16;
121 #elif SIZEOF_INT == 2
122     typedef int kint16;
123     typedef unsigned int kuint16;
124 #endif
125
126 #if SIZEOF_FLOAT == 4
127     typedef float kfloat32;
128 #endif
129 #if SIZEOF_DOUBLE == 8
130     typedef double kfloat64;
131 #endif
132
133
134 inline const char* 
135 fileBasename (const char* const filename)
136 {
137   const char* p = strrchr (filename, '/');
138   return (p ? p + 1 : filename);
139 }
140
141
142 /* strfuncs.cpp */
143 char* str_skip_head(const char* str, const char* const charlist);
144 char* str_skip_head(const char* str, char* charlist);
145 char *str_lower(char *s);
146 char *str_wrm_tail(char *str);
147 char *str_rm_tail(char *str, const char* const charlist);
148 char *str_upper(char *str);
149
150 /* syserror.cpp */
151 void sys_error(int severity, const char *msg, ...);
152 void sys_verror (std::string& strOutput, int severity, const char *msg, va_list arg);
153 void sys_error_level(int severity);
154
155 // Math Section
156
157 #include <cmath>
158
159 #define PI      3.14159265358979323846
160 #define HALFPI  1.57079632679489661923  /* PI divided by 2 */
161 #define QUARTPI 0.78539816339744830962  /* PI divided by 4 */
162 #define I_PI    0.31830988618379067154  /* Inverse of PI */
163 #define I_PID2  0.63661977236758134308  /* Inverse of PID2 */
164  
165 #define TWOPI   6.28318530717958647692
166 #define SQRT2   1.414213562373095049
167
168 #define F_EPSILON       1.0E-6
169 #define D_EPSILON       1.0E-10
170
171 #define ASSUMEDZERO  1E-10
172
173 typedef double GRFMTX_2D[3][3];
174 typedef double GRFMTX_3D[4][4];
175
176 inline double 
177 convertDegreesToRadians (double x)
178 { return (x * (PI/180.)); }
179
180 inline double
181 convertRadiansToDegrees (double x)
182 { return (x*(180./PI)); }
183
184 template<class T>
185 inline T nearest (double x)
186 { return (x > 0 ? static_cast<T>(x+0.5) : static_cast<T>(x-0.5)); }
187
188 inline int imax (int a, int b)\r
189 { return (a >= b ? a : b); }\r
190 \r
191 inline double dmax (double a, double b)\r
192 { return (a >= b ? a : b); }\r
193 \r
194 template<class T>
195 inline T clamp (T value, T lowerBounds, T upperBounds)
196 { return (value >= upperBounds ? upperBounds : (value <= lowerBounds ? lowerBounds : value )); }
197
198 template<class T>
199 inline T lineLength (T x1, T y1, T x2, T y2)
200 { return static_cast<T>( sqrt ((x2-x1)*(x2-x1) + (y2-y1)*(y2-y1)) ); }
201
202 template<class T>
203 inline void minmax_array (const T* array, const int n, T& min, T& max)
204 {
205   max = min = array[0];
206
207   for (int i = 1; i < n; i++)
208     if (array[i] < min)
209       min = array[i];
210     else if (array[i] > max)
211       max = array[i];
212 }
213
214
215 //////////////////////////////////////////////////////////////
216 // FUNTION DECLARATIONS
217 //////////////////////////////////////////////////////////////
218
219 // clip.cpp 
220 bool clip_rect (double& x1, double& y1, double& x2, double& y2, const double rect[4]);
221 bool clip_segment (double& x1, double& y1, double& x2, double& y2, const double u, const double v);
222 bool clip_sector (double& x1, double& y1, double& x2, double& y2, const double u, const double v);
223 bool clip_circle (double& x1, double& y1, double& x2, double& y2, const double cx, const double cy, const double radius, double t1, double t2);
224 bool clip_triangle (double& x1, double& y1, double& x2, double& y2, const double u, const double v, const int clip_xaxis);
225
226
227 // xform.cpp 
228 void indent_mtx2 (GRFMTX_2D m);
229 void xlat_mtx2 (GRFMTX_2D m, const double x, const double y);
230 void scale_mtx2 (GRFMTX_2D m, const double sx, const double sy);
231 void rot_mtx2 (GRFMTX_2D m, const double theta);
232 void mult_mtx2 (const GRFMTX_2D m1, const GRFMTX_2D m2, GRFMTX_2D result);
233 void xform_mtx2 (const GRFMTX_2D m, double& x, double& y);
234 void rotate2d (double x[], double y[], int pts, double angle);
235 void xlat2d (double x[], double y[], int pts, double xoffset, double yoffset);
236 void scale2d (double x[], double y[], int pts, double xfact, double yfact);
237
238 // mathfuncs.cpp
239 double normalizeAngle (double theta);
240 double integrateSimpson (const double xmin, const double xmax, const double *y, const int np);
241 void vectorNumericStatistics (std::vector<double> vec, const int nPoints, double& min, double& max, double& mean, double& mode, double& median, double& stddev);\r
242
243
244 /*----------------------------------------------------------------------*/
245
246 /* screen character codes */
247
248 #define SC_BKSP           8
249 #define SC_TAB            9
250 #define SC_BLANK        ' '
251
252
253 /* audio.cpp */
254 void cio_beep(void);
255 void cio_tone(double freq, double length);
256
257 /* crtput.cpp */
258 void cio_put_c(int c);
259 void cio_put_cc(int c, int count);
260 void cio_put_str(const char *str);
261
262 /* kbget.cpp */
263 unsigned int cio_kb_getc(void);
264 void cio_kb_ungetc(unsigned int c);
265 char *cio_kb_gets(char *str, int maxlen);
266 unsigned int cio_kb_waitc(const char *astr, int beep);
267
268 // Keyboard Section
269
270 #define KEY_BKSP         8
271 #define KEY_TAB          9
272 #define KEY_RETURN      13
273 #define KEY_ESCAPE      27
274
275 // ASCII Section
276
277 #define BACKSPACE  8
278 #define LF      0x0A
279 #define CR      0x0D
280 #define BELL    0x07
281
282 #define SQUOTE    '\''
283 #define DQUOTE    '\"'
284 #define BSLASH    '\\'
285 #define BACKSLASH '\\'
286 #define SHARP     '#'
287 #define SLASH     '/'
288 #define ASTERICK  '*'
289 #define COLON     ':'
290 #define LBRACE    '{'
291 #define RBRACE    '}'
292 #define LPAREN    '('
293 #define RPAREN    ')'
294 #define LBRACK    '['
295 #define RBRACK    ']'
296 #define LANBRACK  '<'
297 #define RANBRACK  '>'
298 #define SEMICOL   ';'
299 #define UNDERLIN  '_'
300 #define COMMA     ','
301 #define CARET     '^'
302 #define TILDE     '~'
303 #define ATSIGN    '@'
304 #define AMPERSAND  '&'
305 #define EXCLAM    '!'
306 #define DOLLAR    '$'
307 #define PERCENT   '%'
308 #define PLUS      '+'
309 #define HYPHEN    '-'
310 #define EQUALS    '='
311 #define QUESTION  '?'
312 #define PERIOD    '.'
313 #define VERTBAR   '|'
314
315 #endif  /* #ifndef CTSUPPORT_H */