x11                   package:base                   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, canvas = "white")

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.

  canvas: color.  The color of the canvas, which is visible only when
          the background color is transparent.

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"'.

     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"'.

See Also:

     `Devices'.

