1 /*****************************************************************************
2 ** This is part of the CTSim program
3 ** Copyright (C) 1983-2000 Kevin Rosenberg
5 ** $Id: ezplot.h,v 1.8 2000/06/20 17:54:51 kevin Exp $
7 ** This program is free software; you can redistribute it and/or modify
8 ** it under the terms of the GNU General Public License (version 2) as
9 ** published by the Free Software Foundation.
11 ** This program is distributed in the hope that it will be useful,
12 ** but WITHOUT ANY WARRANTY; without even the implied warranty of
13 ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 ** GNU General Public License for more details.
16 ** You should have received a copy of the GNU General Public License
17 ** along with this program; if not, write to the Free Software
18 ** Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19 ******************************************************************************/
21 /*----------------------------------------------------------------------*/
24 /*----------------------------------------------------------------------*/
34 #include "ctsupport.h"
37 #define MAXLABEL 40 /* maximum length of axis label */
38 #define MAXTITLE 40 /* maximum length of a title */
39 #define MAXLEGEND 20 /* maximum length of a legend */
40 #define MAXCURVES 10 /* maximum number of curves that can be plotted */
41 #define MAXPTS 200 /* max number of points that can be read with
42 DATA command in INTERACTIVE mode */
51 char legend[MAXLEGEND+1];
58 /*----------------------------------------------------------------------*/
60 /*----------------------------------------------------------------------*/
99 #define S_XAUTOSCALE -43
100 #define S_YAUTOSCALE -44
109 #define S_NOXAXIS -53
110 #define S_NOYAXIS -54
111 #define S_XPORIGIN -55
112 #define S_YPORIGIN -56
119 #define S_RESTORE -63
121 #define S_UFINISH -65
124 #define S_INTERACTIVE -68
132 #define S_NOGRID -103
136 #define S_LEGENDBOX -107
142 #define S_TEXTSIZE -120
145 #define S_PRTMODE -123
147 /*----------------------------------------------------------------------*/
148 /* GLOBAL VARIABLES */
149 /*----------------------------------------------------------------------*/
151 /* axis definitions */
152 #define LINEAR 1 /* linear axis */
153 #define LOG 2 /* logrithmic axis */
154 #define NOAXIS 3 /* don't plot axis */
156 /* tick definitions */
171 /* symbol definitions */
176 #define SB_ERRORBAR 5
179 #define INSIDE 1 /* values of o_legendbox */
183 /*-----------------------------------------------------------------------------
187 * i_ Internal variable
190 * Normal variable that is user modifiable
191 * These variables must always have a valid value
193 * Variables controlling devices
194 * clr_ Color variable
195 * Holds a color value
196 * c_ Character string variable
197 * Contains a character string
199 * User modifiable variable associated with the set variable (s_)
200 * These variables do not always have a valid value
201 * These variables change assumption EZPLOT makes about the plot
203 * TRUE if associated value variable (v_) has been set by the user
204 *---------------------------------------------------------------------------*/
213 struct ezp_curve_st curve[MAXCURVES];
215 /*--------------------*/
216 /* INTERNAL VARIABLES */
217 /*--------------------*/
219 bool i_plotimmediate; /* indicates that a call to EZPLOT is a signal
220 to print all received arrays. EZSET uses
221 this variable to force EZPLOT to replot
223 int i_numcurves; /* number of curves received by EZPLOT */
225 /*------------------*/
226 /* DEVICE VARIABLES */
227 /*------------------*/
229 bool d_usecrt; /* TRUE if want to use CRT as output device */
230 bool d_useprt; /* TRUE if wamt to use printer as output device */
232 int d_crtmode; /* Controls which crt mode to use for plot */
233 int d_prtmode; /* Controls mode of printer output */
235 int d_xprtbuf, d_yprtbuf; /* Size of printer buffer in pixels */
237 /*-----------------*/
238 /* COLOR VARIABLES */
239 /*-----------------*/
241 int clr_axis; /* color of all axis lines */
242 int clr_title; /* color of main title */
243 int clr_label; /* color of axis labels */
244 int clr_legend; /* color of legend box */
245 int clr_grid; /* color of grid lines */
246 int clr_number; /* color of axis number labels */
248 /*------------------*/
249 /* OPTION VARIABLES */
250 /*------------------*/
252 int o_reqcurves; /* # of curves specified in CURVES command */
253 /* default value is 1, so that a call to EZPLOT
255 bool o_unknowncurves; /* TRUE when the user specifies that the
256 number of curves is unknown */
258 bool o_ustart, o_ufinish; /* TRUE if user initiates or terminate sgp */
260 double o_xporigin, o_yporigin; /* origin of plot frame in NDC */
261 double o_xlength, o_ylength; /* length of plot frame in NDC */
263 char c_xlabel[MAXLABEL+1]; /* label for x axis */
264 char c_ylabel[MAXLABEL+1]; /* label for y axis */
265 char c_title[MAXTITLE+1]; /* title to print above graph */
266 char c_legend[MAXLEGEND+1]; /* current legend specified */
268 int o_linestyle, o_color; /* style to use for curves all subsequent */
269 /* curves to EZPLOT */
270 bool o_xaxis, o_yaxis; /* Specifies where axis & labels are drawn */
271 bool o_grid; /* Flag to draw a grid at major ticks */
272 bool o_box; /* Flag to draw a box around the graph */
274 int o_xticks, o_yticks; /* direction to draw tick marks */
275 bool o_xtlabel, o_ytlabel; /* TRUE if label tick marks */
277 int o_xmajortick, o_ymajortick; /* number of major ticks to draw */
278 int o_xminortick, o_yminortick; /* number of minor ticks between major ticks */
280 int o_symbol; /* Symbol type, (0 = no symbol) */
281 int o_symfreq; /* frequency to draw symbols at curve points */
283 int o_legendbox; /* controls whether legend is inside */
284 /* or outside of the axis extents */
285 int o_tag; /* controls whether to draw tag at end of axes */
287 /*-----------------------*/
288 /* VALUE & SET variables */
289 /*-----------------------*/
291 double v_xmin, v_xmax, v_ymin, v_ymax; /* user supplied axis endpoints */
292 bool s_xmin, s_xmax, s_ymin, s_ymax; /* TRUE is endpoint has been set */
294 double v_xtitle, v_ytitle; /* NDC position to plot title */
295 bool s_xtitle, s_ytitle; /* TRUE if set position for title */
296 double v_xcross, v_ycross; /* position that axes cross */
297 bool s_xcross, s_ycross; /* TRUE if set axes cross position */
299 double v_xlegend, v_ylegend; /* upper-left position of legend box in NDC */
300 bool s_xlegend, s_ylegend; /* TRUE if set position of legend box */
302 int v_lxfrac, v_lyfrac; /* number of digits to right of decimal place */
303 bool s_lxfrac, s_lyfrac; /* TRUE if set number of fractional digits */
305 double v_textsize; /* size of text in NDC */
306 bool s_textsize; /* TRUE if user set size of text */
308 }; /* end of EZPLOT VARIABLES */
312 extern struct ezplot_var ez;
313 extern bool ezplot_firstcall; /* set to false on first call to EZSET or EZPLOT */
317 SGP_ID ezplot(float x[], double y[], int num);
318 SGP_ID ezplot(double x[], double y[], int num);
324 int ezset(char *command);
327 void ezplot_1d(double *y, int n);
330 void make_numfmt(char *fmtstr, int *fldwid, int *nfrac, double min, double max, int nint);
333 int axis_scale (double min, double max, int nint, double *minp, double *maxp, int *nintp);