pslegendbox.psplot.lib

su 的源代码库

PSLEGENDBOX - Functions to draw PostScript axes and estimate bounding box

psLegendBox	Draw an legend box via PostScript
psLegendBBox	estimate bounding box for an legend box drawn via psLegendBox

Function Prototypes:
void psLegendBox(
	float x, float y, float width, float height,
	float x1Beg, float x1End, float p1Beg, float p1End, 
	float d1Num, float f1Num, int n1Tic, int grid1, char *label1,
	char *labelFont, float labelSize,
	char *axesColor, char *gridColor,
	int style);

void psLegendBBox(
	float x, float y, float width, float height,
	char *labelFont, float labelSize,
	int style, int bbox[]);


psLegendBox:
Input:
x		x coordinate of lower left corner of box
y		y coordinate of lower left corner of box
width		width of box
height		height of box
x1Beg  		axis value at beginning of axis 1
x1End		axis value at end of axis 1
p1Beg  		pad value at beginning of axis 1
p1End		pad value at end of axis 1
d1Num		numbered tic increment for axis 1 (0.0 for automatic)
f1Num		first numbered tic for axis 1
n1Tic		number of horizontal tics per numbered tic for axis 1
grid1		grid code for axis 1:  NONE, DOT, DASH, or SOLID
label1		label for axis 1
labelFont	name of font to use for axes labels
labelSize	size of font to use for axes labels
axesColor	color to use for axes and axes labels
gridColor	color to use for grid lines
style		VERTLEFT (Vertical, axis label on left side) 
		VERTRIGHT (Vertical, axis label on right side) 
		HORIBOTTOM (Horizontal, axis label on bottom)

psLegendBBox:
Input:
x		x coordinate of lower left corner of box
y		y coordinate of lower left corner of box
width		width of box
height		height of box
labelFont	name of font to use for axes labels
labelSize	size of font to use for axes labels
style		VERTLEFT (Vertical, axis label on left side) 
		VERTRIGHT (Vertical, axis label on right side) 
		HORIBOTTOM (Horizontal, axis label on bottom)
Output:
bbox		bounding box (bbox[0:3] = llx, lly, ulx, uly)

Notes:
psLegendBox:
psLegendBox will determine the numbered tic increment and first numbered
tic automatically, if the specified increment is zero.  Axis numbering
is in scientific notation, if necessary and is plotted to four
significant digits.

Pad values must be specified in the same units as the corresponding
Legend values.  These pads are useful when the contents of the Legend box
requires more space than implied by the Legend values.  For example, the
first and last seismic wiggle traces plotted inside an Legend box will
typically extend beyond the Legend values corresponding to the first and
last traces.  However, all tics will lie with the limits specified in
the Legend values (x1Beg, x1End, x2Beg, x2End).

psLegendBBox:
psLegendBBox uses font sizes to estimate the bounding box for
an Legend box drawn with psLegendBox.  To be on the safe side, 
psLegendBBox overestimates.

psLegendBBox assumes that the Legend labels and titles do not extend
beyond the corresponding edges of the Legend box.

References:
(see References for basic.c)
Author:   Dave Hale,  Colorado School of Mines, 06/27/89
Modified: Ken Larner, Colorado School of Mines, 08/30/90
Modified: Dave Hale, Advance Geophysical, 10/18/92
	Added color parameters for title, axes, and grid.
Modified: Torsten Schoenfelder, Koeln, Germany, 07/06/97
        Display a legend for ps file, move axis from left to right
Modified: Torsten Schoenfelder, Koeln, Germany, 10/02/98
        Corrected width of bbox to include legend title