The R Project SVN – R – Diff – /branches/R-exp-API/src/include/Graphics.h

  * new graphics frame is started, the values revert to the defaults
+ *
  */
 typedef struct {
-	/* Basic Device Driver Properties */
+    /* Basic Device Driver Properties */
-		/* These MUST be set by device drivers on open */
+    /* These MUST be set by device drivers on open */
-		/* These parameters cannot be set by the user */
+    /* These parameters cannot be set by the user */
-		/* although left, right, bottom, and top can be */
+    /* although left, right, bottom, and top can be */
-		/* interrogated indirectly (i.e., par("din")) */
+    /* interrogated indirectly (i.e., par("din")) */
-		/* and cra can be interrogated directly (i.e., par("cra")) */
+    /* and cra can be interrogated directly (i.e., par("cra")) */
-	double	left;		/* left raster coordinate */
+    double left;	/* left raster coordinate */
-	double	right;		/* right raster coordinate */
+    double right;	/* right raster coordinate */
-	double	bottom;		/* bottom raster coordinate */
+    double bottom;	/* bottom raster coordinate */
-	double	top;		/* top raster coordinate */
+    double top;		/* top raster coordinate */
-	double	xCharOffset;	/* x character addressing offset */
+    double xCharOffset;	/* x character addressing offset */
-	double	yCharOffset;	/* y character addressing offset */
+    double yCharOffset;	/* y character addressing offset */
-	double	yLineBias;	/* 1/2 interline space as fraction of line height */
+    double yLineBias;	/* 1/2 interline space as fraction of line height */
-	int	canResizePlot;	/* can the graphics surface be resized */
+    int canResizePlot;	/* can the graphics surface be resized */
-	int	canChangeFont;	/* device has multiple fonts */
+    int canChangeFont;	/* device has multiple fonts */
-	int	canRotateText;	/* text can be rotated */
+    int canRotateText;	/* text can be rotated */
-	int	canResizeText;	/* text can be resized */
+    int canResizeText;	/* text can be resized */
-	int	canClip;	/* Hardware clipping */
+    int canClip;	/* Hardware clipping */
-		/* a couple of the GRZ-like parameters that have to be */
+    /* a couple of the GRZ-like parameters that have to be */
-		/* set by the device */
+    /* set by the device */
-	double	ipr[2];		/* Inches per raster; [0]=x, [1]=y */
+    double ipr[2];	/* Inches per raster; [0]=x, [1]=y */
-	double	asp;		/* Pixel aspect ratio = ipr[1]/ipr[0] */
+    double asp;		/* Pixel aspect ratio = ipr[1]/ipr[0] */
-	double	cra[2];		/* Character size in rasters; [0]=x, [1]=y */
+    double cra[2];	/* Character size in rasters; [0]=x, [1]=y */
-	/* Plot State */
+    /* Plot State */
-		/* When the device driver is started this is 0 */
+    /* When the device driver is started this is 0 */
-		/* After the first call to plot.new it is 1 */
+    /* After the first call to plot.new it is 1 */
-		/* Every graphics operation except plot.new */
+    /* Every graphics operation except plot.new */
-		/* should fail if state = 0 */
+    /* should fail if state = 0 */
-		/* This is checked at the highest internal function */
+    /* This is checked at the highest internal function */
-		/* level (e.g., do_lines, do_axis, do_plot_xy, ...) */
+    /* level (e.g., do_lines, do_axis, do_plot_xy, ...) */
-	int	state;		/* Plot State */
+    int	state;		/* Plot State */
-	int	valid;		/* valid layout ? */
+    int	valid;		/* valid layout ? */
-	/* GRZ-like Graphics Parameters */
+    /* GRZ-like Graphics Parameters */
-		/* ``The horror, the horror ... '' */
+    /* ``The horror, the horror ... '' */
-		/* Marlon Brando - Appocalypse Now */
+    /* Marlon Brando - Appocalypse Now */
+    /* General Parameters -- set and interrogated directly */
-		/* General Parameters -- set and interrogated directly */
+    double adj;		/* String adjustment */
-	double	adj;		/* String adjustment */
+    int	ann;		/* Should annotation take place */
-	int	ann;		/* Should annotation take place */
+    int	ask;		/* User confirmation of ``page eject'' */
-	int	ask;		/* User confirmation of ``page eject'' */
+    rcolor bg;		/* **R ONLY** Background color */
-	rcolor	bg;		/* **R ONLY** Background color */
+    int	bty;		/* Box type */
-	int	bty;		/* Box type */
+    double cex;		/* Character expansion */
-	double	cex;		/* Character expansion */
+    rcolor col;		/* Plotting Color */
-	rcolor	col;		/* Plotting Color */
+    double crt;		/* Character/string rotation */
-	double	crt;		/* Character/string rotation */
+    double din[2];	/* device size in inches */
-	double	din[2];		/* device size in inches */
+    int	err;		/* Error repporting level */
-	int	err;		/* Error repporting level */
+    rcolor fg;		/* **R ONLY** Foreground Color */
-	rcolor	fg;		/* **R ONLY** Foreground Color */
+    int	font;		/* Text font */
-	int	font;		/* Text font */
+    double gamma;	/* Device Gamma Correction */
-	double	gamma;		/* Device Gamma Correction */
+    int	lab[3];		/* Axis labelling */
-	int	lab[3];		/* Axis labelling */
+			/* [0] = # ticks on x-axis */
-				/* [0] = # ticks on x-axis */
+			/* [1] = # ticks on y-axis */
-				/* [1] = # ticks on y-axis */
+			/* [2] = length of axis labels */
-				/* [2] = length of axis labels */
+    int	las;		/* Label style (rotation) */
-	int	las;		/* Label style (rotation) */
+    int	lty;		/* Line texture */
-	int	lty;		/* Line texture */
+    double lwd;		/* Line width */
-	double	lwd;		/* Line width */
+    double mgp[3];	/* Annotation location */
-	double	mgp[3];		/* Annotation location */
+			/* [0] = location of axis title */
-				/* [0] = location of axis title */
+			/* [1] = location of axis label */
-				/* [1] = location of axis label */
+			/* [2] = location of axis line */
-				/* [2] = location of axis line */
+    double mkh;		/* Mark size in inches */
-	double	mkh;		/* Mark size in inches */
+    int	pch;		/* Plotting character */
-	int	pch;		/* Plotting character */
+    int	ps;		/* Text & symbol pointsize */
-	int	ps;		/* Text & symbol pointsize */
+    int	smo;		/* Curve smoothness */
-	int	smo;		/* Curve smoothness */
+    double srt;		/* String Rotation */
-	double	srt;		/* String Rotation */
+    double tck;		/* Tick size as in S */
-	double	tck;		/* Tick size as in S */
+    double tcl;		/* Tick size in "lines" */
-	double	tcl;		/* Tick size in "lines" */
+    double tmag;	/* **R ONLY** Title Magnification */
-	double	tmag;		/* **R ONLY** Title Magnification */
+    int	type;		/* type of plot desired */
-	int	type;		/* type of plot desired */
+    double xaxp[3];	/* X Axis annotation */
-	double	xaxp[3];	/* X Axis annotation */
+			/* [0] = coordinate of lower tick */
-				/* [0] = coordinate of lower tick */
+			/* [1] = coordinate of upper tick */
-				/* [1] = coordinate of upper tick */
+			/* [2] = num tick intervals */
-				/* [2] = num tick intervals */
+			/* almost always used internally */
-				/* almost always used internally */
+    int	xaxs;		/* X Axis style */
-	int	xaxs;		/* X Axis style */
+    int	xaxt;		/* X Axis type */
-	int	xaxt;		/* X Axis type */
+    int	xpd;		/* Clip to plot region indicator */
-	int	xpd;		/* Clip to plot region indicator */
+    int	oldxpd;
-	int	oldxpd;
+    double yaxp[3];	/* Y Axis annotation */
-	double	yaxp[3];	/* Y Axis annotation */
+    int	yaxs;		/* Y Axis style */
-	int	yaxs;		/* Y Axis style */
+    int	yaxt;		/* Y Axis type */
-	int	yaxt;		/* Y Axis type */
+    int	xlog;		/* Log Axis for X */
-	int	xlog;		/* Log Axis for X */
+    int	ylog;		/* Log Axis for Y */
-	int	ylog;		/* Log Axis for Y */
+    /* Annotation Parameters */
-		/* Annotation Parameters */
+    float cexbase;	/* Base character size */
-	float	cexbase;	/* Base character size */
+    float cexmain;	/* Main title size */
-	float	cexmain;	/* Main title size */
+    float cexlab;	/* xlab and ylab size */
-	float	cexlab;		/* xlab and ylab size */
+    float cexsub;	/* Sub title size */
-	float	cexsub;		/* Sub title size */
+    float cexaxis;	/* Axis label size */
-	float	cexaxis;	/* Axis label size */
+    int	fontmain;	/* Main title font */
-	int	fontmain;	/* Main title font */
+    int	fontlab;	/* Xlab and ylab font */
-	int	fontlab;	/* Xlab and ylab font */
+    int	fontsub;	/* Subtitle font */
-	int	fontsub;	/* Subtitle font */
+    int	fontaxis;	/* Axis label fonts */
-	int	fontaxis;	/* Axis label fonts */
+    int	colmain;	/* Main title color */
-	int	colmain;	/* Main title color */
+    int	collab;		/* Xlab and ylab color */
-	int	collab;		/* Xlab and ylab color */
+    int	colsub;		/* Subtitle color */
-	int	colsub;		/* Subtitle color */
+    int	colaxis;	/* Axis label color */
-	int	colaxis;	/* Axis label color */
+    /* Layout Parameters */
-		/* Layout Parameters */
+    int	layout;		/* has a layout been specified */
-	int	layout;		/* has a layout been specified */
+    int	numrows;
-	int	numrows;
+    int	numcols;
-	int	numcols;
+    int	currentFigure;
-	int	currentFigure;
+    int	lastFigure;
-	int	lastFigure;
+    double heights[MAX_LAYOUT_ROWS];
-	double	heights[MAX_LAYOUT_ROWS];
+    double widths[MAX_LAYOUT_COLS];
-	double	widths[MAX_LAYOUT_COLS];
+    int	cmHeights[MAX_LAYOUT_ROWS];
-	int	cmHeights[MAX_LAYOUT_ROWS];
+    int	cmWidths[MAX_LAYOUT_COLS];
-	int	cmWidths[MAX_LAYOUT_COLS];
+    int	order[MAX_LAYOUT_ROWS][MAX_LAYOUT_COLS];
-	int	order[MAX_LAYOUT_ROWS][MAX_LAYOUT_COLS];
+    int	rspct;	        /* 0 = none, 1 = full, 2 = see respect */
-	int	rspct;	/* 0 = none, 1 = full, 2 = see respect */
+    int	respect[MAX_LAYOUT_ROWS][MAX_LAYOUT_COLS];
-	int	respect[MAX_LAYOUT_ROWS][MAX_LAYOUT_COLS];
+    int	mfind;		/* By row/col indicator */
-	int	mfind;		/* By row/col indicator */
+    /* Layout parameters which can be set directly by the */
-		/* Layout parameters which can be set directly by the */
+    /* user (e.g., par(fig=c(.5,1,0,1))) or otherwise are */
-		/* user (e.g., par(fig=c(.5,1,0,1))) or otherwise are */
+    /* calculated automatically */
-		/* calculated automatically */
+    /* NOTE that *Units parameters are for internal use only */
-		/* NOTE that *Units parameters are for internal use only */
+    double fig[4];	/* (current) Figure size (proportion) */
-	double	fig[4];		/* (current) Figure size (proportion) */
+			/* [0] = left, [1] = right */
-				/* [0] = left, [1] = right */
+			/* [2] = bottom, [3] = top */
-				/* [2] = bottom, [3] = top */
+    double fin[2];	/* (current) Figure size (inches) */
-	double	fin[2];		/* (current) Figure size (inches) */
+			/* [0] = width, [1] = height */
-				/* [0] = width, [1] = height */
+    int	fUnits;		/* (current) figure size units */
-	int	fUnits;		/* (current) figure size units */
+    int	defaultFigure;	/* calculate figure from layout ? */
-	int	defaultFigure;	/* calculate figure from layout ? */
+    double plt[4];	/* (current) Plot size (proportions) */
-	double	plt[4];		/* (current) Plot size (proportions) */
+			/* [0] = left, [1] = right */
-				/* [0] = left, [1] = right */
+			/* [2] = bottom, [3] = top */
-				/* [2] = bottom, [3] = top */
+    double pin[2];	/* (current) plot size (inches) */
-	double	pin[2];		/* (current) plot size (inches) */
+			/* [0] = width, [1] = height */
-				/* [0] = width, [1] = height */
+    int	pUnits;		/* (current) plot size units */
-	int	pUnits;		/* (current) plot size units */
+    int	defaultPlot;	/* calculate plot from figure - margins ? */
-	int	defaultPlot;	/* calculate plot from figure - margins ? */
+    /* Layout parameters which are set directly by the user */
-		/* Layout parameters which are set directly by the user */
+    double mar[4];	/* Plot margins in lines */
-	double	mar[4];		/* Plot margins in lines */
+    double mai[4];	/* Plot margins in inches */
-	double	mai[4];		/* Plot margins in inches */
+			/* [0] = bottom, [1] = left */
-				/* [0] = bottom, [1] = left */
+			/* [2] = top, [3] = right */
-				/* [2] = top, [3] = right */
+    int	mUnits;		/* plot margin units */
-	int	mUnits;		/* plot margin units */
+    double mex;		/* Margin expansion factor */
-	double	mex;		/* Margin expansion factor */
+    double oma[4];	/* Outer margins in lines */
-	double	oma[4];		/* Outer margins in lines */
+    double omi[4];	/* outer margins in inches */
-	double	omi[4];		/* outer margins in inches */
+    double omd[4];	/* outer margins in NDC */
-	double	omd[4];		/* outer margins in NDC */
+			/* [0] = bottom, [1] = left */
-				/* [0] = bottom, [1] = left */
+			/* [2] = top, [3] = right */
-				/* [2] = top, [3] = right */
+    int	oUnits;		/* outer margin units */
-	int	oUnits;		/* outer margin units */
+    int	pty;		/* Plot type */
-	int	pty;		/* Plot type */
+    /* Layout parameters which can be set by the user, but */
-		/* Layout parameters which can be set by the user, but */
+    /* almost always get automatically calculated anyway */
-		/* almost always get automatically calculated anyway */
+    double usr[4];	/* Graphics window */
-	double	usr[4];		/* Graphics window */
+			/* [0] = xmin, [1] = xmax */
-				/* [0] = xmin, [1] = xmax */
+			/* [2] = ymin, [3] = ymax */
-				/* [2] = ymin, [3] = ymax */
+    /* The logged usr parameter;  if xlog, use logusr[0:1] */
-		/* The logged usr parameter;  if xlog, use logusr[0:1] */
+    /* if ylog, use logusr[2:3] */
-		/*			      if ylog, use logusr[2:3] */
+    double logusr[4];
-	double logusr[4];
+    /* Layout parameter: Internal flags */
-		/* Layout parameter: Internal flags */
+    int	new;		/* Clean plot ? */
-	int	new;		/* Clean plot ? */
+    int	devmode;	/* creating new image or adding to existing one */
-	int	devmode;	/* creating new image or adding to existing one */
+    /* Coordinate System Mappings */
-		/* Coordinate System Mappings */
+    /* These are only used internally (i.e., cannot be */
-		/* These are only used internally (i.e., cannot be */
+    /* set directly by the user) */
-		/* set directly by the user) */
+    /* The reliability of these parameters relies on */
-		/* The reliability of these parameters relies on */
+    /* the fact that plot.new is the */
-		/* the fact that plot.new is the */
+    /* first graphics operation called in the creation */
-		/* first graphics operation called in the creation */
+    /* of a graph */
-		/* of a graph */
+    /* udpated per plot.new */
-		/* udpated per plot.new */
+    double xNDCPerChar;	/* Nominal character width (NDC) */
-	double	xNDCPerChar;	/* Nominal character width (NDC) */
+    double yNDCPerChar;	/* Nominal character height (NDC) */
-	double	yNDCPerChar;	/* Nominal character height (NDC) */
+    double xNDCPerLine;	/* Nominal line width (NDC) */
-	double	xNDCPerLine;	/* Nominal line width (NDC) */
+    double yNDCPerLine;	/* Nominal line height (NDC) */
-	double	yNDCPerLine;	/* Nominal line height (NDC) */
+    double xNDCPerInch;	/* xNDC -> Inches */
-	double	xNDCPerInch;	/* xNDC -> Inches */
+    double yNDCPerInch;	/* yNDC -> Inches */
-	double	yNDCPerInch;	/* yNDC -> Inches */
+    /* updated per plot.new and if inner2dev changes */
-		/* updated per plot.new and if inner2dev changes */
+    GTrans fig2dev;	/* Figure to device */
-	GTrans	fig2dev;	/* Figure to device */
+    /* udpated per DevNewPlot and if ndc2dev changes */
-		/* udpated per DevNewPlot and if ndc2dev changes */
+    GTrans inner2dev;	/* Inner region to device */
-	GTrans	inner2dev;	/* Inner region to device */
+    /* udpated per device resize */
-		/* udpated per device resize */
+    GTrans ndc2dev;	/* NDC to raw device */
-	GTrans	ndc2dev;	/* NDC to raw device */
+    /* updated per plot.new and per plot.window */
-		/* updated per plot.new and per plot.window */
+    GTrans win2fig;	/* Window to figure mapping */
-	GTrans	win2fig;	/* Window to figure mapping */
+    /* NOTE: if user has not set fig and/or plt then */
-		/* NOTE: if user has not set fig and/or plt then */
+    /* they need to be updated per plot.new too */
-		/* they need to be updated per plot.new too */
+    /* device operations */
-		/* device operations */
+    int (*open)();
-	int (*open)();
+    void (*close)();
-	void (*close)();
+    void (*activate)();
-	void (*activate)();
+    void (*deactivate)();
-	void (*deactivate)();
+    void (*resize)();
-	void (*resize)();
+    void (*newPage)();
-	void (*newPage)();
+    void (*clip)();
-	void (*clip)();
+    double (*strWidth)();
-	double (*strWidth)();
+    void (*line)();
-	void (*line)();
+    void (*polyline)();
-	void (*polyline)();
+    void (*text)();
-	void (*text)();
+    void (*dot)();
-	void (*dot)();
+    void (*rect)();
-	void (*rect)();
+    void (*circle)();
-	void (*circle)();
+    void (*polygon)();
-	void (*polygon)();
+    int (*locator)();
-	int (*locator)();
+    void (*mode)();
-	void (*mode)();
+    void (*hold)();
-	void (*hold)();
+    void (*metricInfo)();
-	void (*metricInfo)();
 } GPar;
 typedef struct {
 	GPar dp;		/* current device default parameters */
 	GPar gp;		/* current device current parameters */

The R Project SVN R

(root)/branches/R-exp-API/src/include/Graphics.h @ 28362 – Rev 3979 → 4022