x11 {grDevices}R Documentation

X Window System Graphics

Description

X11 starts a graphics device driver for the X Window System (version 11). This can only be done on machines that run X. x11 is recognized as a synonym for X11.

Usage

X11(display = "", width = 7, height = 7, pointsize = 12,
    gamma = 1, colortype = getOption("X11colortype"),
    maxcubesize = 256, bg = "transparent", canvas = "white",
    fonts = getOption("X11fonts"))

Arguments

display the display on which the graphics window will appear. The default is to use the value in the user's environment variable DISPLAY.
width the width of the plotting window in inches.
height the height of the plotting window in inches.
pointsize the default pointsize to be used.
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.
colortype the kind of color model to be used. The possibilities are "mono", "gray", "pseudo", "pseudo.cube" and "true". Ignored if an X11 is already open.
maxcubesize can be used to limit the size of color cube allocated for pseudocolor devices.
bg color. The default background color.
canvas color. The color of the canvas, which is visible only when the background color is transparent.
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.

Details

By default, an X11 device will use the best color rendering strategy that it can. The choice can be overriden with the colortype parameter. A value of "mono" results in black and white graphics, "gray" in grayscale and "true" in truecolor graphics (if this is possible). The values "pseudo" and "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 "pseudo".

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

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

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

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

pch="." with cex = 1 corresponds to a rectangle of sides the larger of one pixel and 0.01 inch.

See Also

Devices.


[Package grDevices version 2.2.1 Index]