TITLE(par @@  Set or Query Graphical Parameters)
USAGE(
par(DOTS)
)
ALIAS(par)
DESCRIPTION(
COMMENT(LANG(par) is an abomination before man and god.)
LANG(par) can be used to set or query graphical parameters.
Parameters can be set by specifying them as arguments to LANG(par")
in LANG(tag=value) form, or by passing them as a list of tagged values.
In either case the previous values are returned in an invisible tagged list.
Such a list can be passed as an arument to LANG(par) to
restore the parameter values.
PARA
Parameters are queried by giving vectors of character strings to
LANG(par).  In this case, the values are returned in a tagged list.
)
BEGIN_ARGUMENTS
ARG(adj @@
The value of LANG(adj) determines the way in which text strings are justified.
A value of LANG(0) produces right left-justified text, LANG(0.5)
centered text and LANG(1) right-justified text.)
ARG(ann @@
If set to LANG(FALSE), high-level plotting functions do
not annotate the plots they produce with axis and overall
titles.
The default is to do annotation.)
ARG(bg @@
The color to be used for the background of plots.
A description of how colors are specified is given below.)
ARG(bty @@
A character string which determined the type of box which is drawn
about plots.  If LANG(bty) is one of are LANG("o"), LANG("l"), LANG("7") or
LANG("c") the resulting box resembles the corresponding upper case letter.
A value of LANG("n") suppresses the box.)
ARG(cex @@
A numerical value giving the amount by which plotting text
and symbols should be scaled relative to the default.)
ARG(cex.axis @@
The magnification to be used for axis anotation relative to the current.)
ARG(cex.lab @@
The magnification to be used for x and y labels relative to the current.)
ARG(cex.main @@
The magnification to be used for main titles relative to the current.)
ARG(cex.sub @@
The magnification to be used for sub-titles relative to the current.)
ARG(col @@
A specification for the default plotting color.
A description of how colors are specified is given below.)
ARG(col.axis @@
The color to be used for axis annotation.)
ARG(col.lab @@
The color to be used for x and y labels.)
ARG(col.main @@
The color to be used for plot main titles.)
ARG(col.sub @@
The color to be used for plot sub-titles.)
ARG(crt @@
A numerical value specifying (in degrees) how strings should be rotated.
It is unwise to expect values other than multiples of 90 to work.)
ARG(csi @@
(ITALIC(Unimplemented)) The height of characters in inches.)
ARG(err @@
(ITALIC(Unimplemented)) The degree of error reporting desired.)
ARG(fg @@
The color to be used for the foreground of plots.
This is the default color is used for things like axes and boxes around plots.
A description of how colors are specified is given below.)
ARG(fig @@
A numerical vector of the form LANG(c(x1,x2,y1,y2)) which gives
the (NDC) coordinates of the figure region in the display region
of the device.)
ARG(fin @@
A numerical vector of the form LANG(c(x,y)) which gives
the size of the figure region in inches.)
ARG(font @@
An integer which specifies which font to use for text.
If possible, device drivers arrange so that 1 corresponds to
plain text, 2 to bold face, 3 to italic and 4 to bold italic.)
ARG(lab @@
A numerical vector of the form LANG(c(x,y,len)) which
modifies the way that axes are annotated.
The values of LANG(x) and LANG(y) give the (approximate)
number of tickmarks on the x and y axes and
LANG(len) species the label size.
ITALIC(Currently), LANG(len) ITALIC(is unimplemented).)
ARG(las @@
(ITALIC(Unimplemented))
the style of axis labels.
0=always parallel to the axis,
1=always horizontal,
2=always perpendicular to the axis.)
ARG(lty @@
The line type.
Line types can either be specified as an integer
(1=solid, 2=dashed, 3=dotted 4=dotdashed) or as one of the character strings
LANG("solid"), LANG("dashed"), LANG("dotted") or LANG("dotdashed").
Alternatively, a string of up to 8 characters
may be given, giving the length (in points) of line segments which are
alternatively drawn and skipped.
For example, LANG("44") is dashed and LANG("13") is dotted.)
ARG(mai @@
A numerical vector of the form LANG(c(xb,xt,yl,yr))
which gives the margin size specified in inches.)
ARG(mar @@
A numerical vector of the form LANG(c(xb,xt,yl,yr))
which gives the
lines of margin to be specified on the four sides of the plot.
The default is LANG(c(5,4,4,2)+0.1).)
ARG(mex @@
LANG(mex) is a character size expansion factor
which is used to describe coordinates in the margins of plots.)
ARG(mfcol @@
This is a vector of the form LANG(c(r,c)).
Subsequent figures will be drawn in an LANG(r)-by-LANG(c)
array on the device by ITALIC(columns).)
ARG(mfg @@
A numerical vector of the form LANG(c(i,j,r,c)) where
LANG(i) and LANG(j) indicate which figure in an LANG(r)-by-LANG(c)
array of figures is currently being drawn.)
ARG(mfrow @@
This is a vector of the form LANG(c(nr,nc)).
Subsequent figures will be drawn in an LANG(r)-by-LANG(c)
array on the device by ITALIC(rows).)
ARG(mgp @@
The margin line for the axis title, axis labels and axis line.
The default is LANG(c(3,1,0)).)
ARG(mkh @@
The height in inches of symbols to be drawn when
the value of LANG(pch) is an integer.)
ARG(oma @@
A vector of the form LANG(c(xb,xt,yl,yr)) giving
the size of the outer margins in lines of text.)
ARG(omd @@
A vector of the form LANG(c(x1,x2,y1,y2)) giving the
NDC coordinates of the region where (multiple) figures
will appear on the device.)
ARG(omi @@
A vector of the form LANG(c(xb,xt,yl,yr)) giving
the size of the outer margins in inches.)
ARG(pch @@
Either an integer specifying a symbol or a single character
to be used as the default in plotting.)
ARG(pin @@
The width and height of the current plot in inches.)
ARG(plt @@
A vector of the form LANG(c(x1,x2,y1,y2)) giving the
the coordinates of the plot region as fractions of the
current figure region.)
ARG(pty @@
A character specifying the type of plot region to be used;
LANG("s") generates a square plotting region and
LANG("m") generates the maximal plotting region.)
ARG(smo @@
(ITALIC(Unimplemented)) a value which indicates
how smooth circles and circular arc should be.)
ARG(srt @@
The string rotation in degrees.
Causes LANG(srt) to be set to the same value.)
ARG(tck @@
The length of tick marks as a fraction of the smaller of
the width or height of the plotting region.
If LANG(tck=1), grid lines are drawn.
The default value is LANG(-0.2).)
ARG(tmag @@
A number specifying the enlargement of text of the main title
relative to the other annotating text of the plot.)
ARG(usr @@
A vector of the form LANG(c(x1,x2,y1,y2)) giving the extremes
of the user coordinates of the plotting region.)
ARG(xaxp @@
A vector of the form LANG(c(x1,x2,n)) giving
the coordinates of the extreme tick marks and the number
of intervals between tick-marks.)
ARG(xaxs @@
(ITALIC(Unimplemented)) The style of axis interval calculation
to be used for the x-axis.)
ARG(xaxt @@
A character which specifies the axis type.
Specifying LANG("n") causes an axis to be set up, but not plotted.)
ARG(xlog @@
A logical value. If LANG(TRUE) a logarithmic scale is used.
The default is to use a linear scale.)
ARG(xpd @@
A logical value.
If LANG(FALSE), all plotting is clipped to the plot region.)
ARG(yaxp @@
A vector of the form LANG(c(y1,y2,n)) giving
the coordinates of the extreme tick marks and the number
of intervals between tick-marks.)
ARG(yaxs @@
(ITALIC(Unimplemented)) The style of axis interval calculation
to be used for the y-axis.)
ARG(yaxt @@
A character which specifies the axis type.
Specifying LANG("n") causes an axis to be set up, but not plotted.)
ARG(ylog @@
A logical value. If LANG(TRUE) a logarithmic scale is used.
The default is to use a linear scale.)
END_ARGUMENTS
COMMENT(---------------------------------------------------------------------)
SECTION(Color Specification @@
Colors can be specified in several different ways.  The simplest way is
with a character string giving the color name (eg. LANG("red")).
A list of the possible colors can be obtained with the function
LANG(LINK(colors)).  Alternatively, colors can be specified directly
in terms of there RGB components with a string of the form
LANG("#RRGGBB") where each of the pairs LANG(RR), LANG(GG),
LANG(BB) consist of two hexidecimal digits giving a value in the
range LANG(00) to LANG(FF).  Colors can also be specified
by giving an index into a small table of colors.  This provides
compatibility with S.
PARA
The functions LANG(rgb), LANG(hsv), LANG(gray) and LANG(rainbow)
provide additional ways of generating colors.
)
SECTION(Line Type Specification @@
Line types can either be specified by giving an index
into a small built in table of line types (1=solid, 2=dashed, 3=dotted)
or directly as the lengths of on/off stretches of line.
This is done with a string of up to eight characters which give
the lengths in consecutive positions in the string.
For example, the string LANG("33") specifies three pixels on followed
by three off and LANG("3313") specifies three pixels on followed
by three off followed by one on and finally three off.
)
SEEALSO(
LANG(LINK(colors)), LANG(LINK(gray)), LANG(LINK(rainbow)), LANG(LINK(rgb)).
LANG(LINK(options)) for other setup parameters.
Graphic devices  LANG(LINK(x11)), LANG(LINK(postscript)).
)
EXAMPLES(
op <- par(mfrow=c(2,2)) #-- 2 x 2 pictures on one plot
par(pty = 's') #- square plotting region, independent of device size
)
