\HeaderA{x11}{X Window System Graphics}{x11}
\aliasA{X11}{x11}{X11}
\keyword{device}{x11}
\begin{Description}\relax
\code{X11} starts a graphics device driver for the X Window System
(version 11).  This can only be done on machines that run X.
\code{x11} is recognized as a synonym for \code{X11}.
\end{Description}
\begin{Usage}
\begin{verbatim}
X11(display = "", width = 7, height = 7, pointsize = 12,
    gamma = 1, colortype = getOption("X11colortype"),
    maxcubesize = 256, bg = "transparent", canvas = "white",
    fonts = getOption("X11fonts"))
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{display}] the display on which the graphics window will appear.
The default is to use the value in the user's environment variable
\env{DISPLAY}.
\item[\code{width}] the width of the plotting window in inches.
\item[\code{height}] the height of the plotting window in inches.
\item[\code{pointsize}] the default pointsize to be used.
\item[\code{gamma}] the gamma correction factor.  This value is used
to ensure that the colors displayed are linearly related to
RGB values.  A value of around 0.5 is appropriate for many PC
displays.  A value of 1.0 (no correction) is usually appropriate
for high-end displays or Macintoshs.
\item[\code{colortype}] the kind of color model to be used.  The
possibilities are \code{"mono"}, \code{"gray"}, \code{"pseudo"},
\code{"pseudo.cube"} and \code{"true"}. Ignored if an \code{X11} is
already open.
\item[\code{maxcubesize}] can be used to limit the size of color
cube allocated for pseudocolor devices.
\item[\code{bg}] color.  The default background color.
\item[\code{canvas}] color.  The color of the canvas, which is visible only
when the background color is transparent.
\item[\code{fonts}] X11 font description strings into which weight, slant and
size will be substituted.  There are two, the first for fonts 1 to 4
and the second for font 5, the symbol font.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
By default, an X11 device will use the best color rendering
strategy that it can.  The choice can be overriden with the
\code{colortype} parameter.  A value of \code{"mono"} results in
black and white graphics, \code{"gray"} in grayscale and
\code{"true"} in truecolor graphics (if this is possible).  The
values \code{"pseudo"} and \code{"pseudo.cube"} provide color
strategies for pseudocolor displays.  The first strategy provides
on-demand color allocation which produces exact colors until
the color resources of the display are exhausted.  The second
causes a standard color cube to be set up, and requested colors
are approximated by the closest value in the cube.  The default
strategy for pseudocolor displays is \code{"pseudo"}.

An initial/default font family for the device can be specified via
the \code{fonts} argument, but
if a device-independent R graphics font family is specified
(e.g., via \code{par(family=)} in the graphics package),
the X11 device makes use of the X11 font database
(see \code{X11Fonts}) to
convert the R graphics font family
to an X11-specific font family description.  

\bold{Note:} All \code{X11} devices share a \code{colortype} which is
set by the first device to be opened.  To change the \code{colortype}
you need to close \emph{all} open \code{X11} devices then open one
with the desired \code{colortype}.

With \code{colortype} equal to \code{"pseudo.cube"} or \code{"gray"}
successively smaller palettes are tried until one is completely
allocated. If allocation of the smallest attempt fails the device will
revert to \code{"mono"}.

Line widths as controlled by \code{par(lwd=)} are in multiples of the
pixel size, and multiples < 1 are silently converted to 1.

\code{pch="."} with \code{cex = 1} corresponds to a rectangle of sides
the larger of one pixel and 0.01 inch.
\end{Details}
\begin{SeeAlso}\relax
\code{\LinkA{Devices}{Devices}}.
\end{SeeAlso}

