| windows {base} | R Documentation |
A graphics device is opened. For win.graph, windows,
x11 and X11 this is a graphics window on the current
Windows display: the multiple names are for compatibility with other
systems. win.metafile prints to a file and win.print to
the Windows print system.
windows(width = 7, height = 7, pointsize = 12,
record = getOption("graphics.record"),
rescale = c("R", "fit", "fixed"), xpinch, ypinch,
canvas = "white", gamma = getOption("gamma"))
win.graph(width = 7, height = 7, pointsize = 12)
x11(width = 7, height = 7, pointsize = 12)
X11(width = 7, height = 7, pointsize = 12)
win.metafile(filename = "", width = 7, height = 7, pointsize = 12)
win.print(width = 7, height = 7, pointsize = 12, printer = "")
display |
indicates the purpose of the device. |
filename |
the name of the output file: it will be an enhanced
Windows metafile, usually given extension |
width |
the (nominal) width of the plotting window in inches. |
height |
the (nominal) height of the plotting window in inches. |
pointsize |
the default pointsize of plotted text. |
record |
logical: sets the initial state of the flag for recording plots. |
rescale |
controls the action for resizing plots. |
xpinch, ypinch |
double. Pixels per inch, horizontally and vertically. |
canvas |
color. The color of the canvas which is visible when the background color is transparent. |
gamma |
the gamma correction factor. This value is used
to ensure that the colors displayed are linearly related to
RGB values. By default this is taken from
|
printer |
The name of a printer as known to Windows. The default causes a dialog box to come for the user to choose a printer. |
All these devices are implemented as windows devices, the
display parameter selects which is actually used.
The size of a window is computed from information provided about the
display: it depends on the system being configured accurately.
By default a screen device asks Windows for the number of pixels per
inch. This can be overridden (it is often wrong) by specifying
xpinch and ypinch or the corresponding options
"xpinch" and "ypinch".
A graphics window is not allowed to be specified at more that 85% of the screen width or height: the width and height are rescaled proportionally. The window can be resized to a larger size.
If the filename is omitted for a win.metafile device, the
output is copied to the clipboard when the device is closed. A
win.metafile device can only be used for a single page.
If a screen device is re-sized, the default behaviour is to redraw the
plot(s) as if the new size had been specified originally. Using
"fit" will rescale the existing plot(s) to fit the new device
region, preserving the aspect ratio. Using "fixed" will leave
the plot size unchanged, adding scrollbars if part of the
plot is obscured.
A graphics window will never be created at more that 85% of
the screen width or height, but can be resized to a larger size.
For the first two rescale options the width and height are
rescaled proportionally if necessary, and if rescale = "fit"
the plot(s) are rescaled accordingly. If rescale = "fixed"
the initially displayed portion is selected within these constraints,
separately for width and height.
Using strwidth or strheight after a window
has been rescaled (when using "fit") gives dimensions in the
original units, but only approximately as they are derived from the
metrics of the rescaled fonts (which are in integer sizes)
The displayed region may be bigger than the ‘paper’ size, and areas
outside the ‘paper’ are coloured in the Windows application background
colour. Graphics parameters such
as "din" refer to the scaled plot if rescaling is in effect.
The different colours need to be distinguished carefully. The area outside the device region is coloured in the Windows application background colour. The device region is coloured in the canvas colour. This is over-painted by the background colour of a plot when a new page is called for, but that background colour can be transparent (and is by default). The difference between setting the canvas colour and the background colour is that when the device is copied the background colour is copied but the canvas colour is not.
Recorded plot histories are of class "SavedPlots". They have a
print method, and a subset method. As the individual plots are
of class "recordedplot" they can be replayed by printing them:
see recordPlot.
A plot device is opened: nothing is returned to the R interpreter.
Guido Masarotto and Brian Ripley
savePlot, bringToTop,
Devices, postscript