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.1.1 Index]