trellis.device {lattice} | R Documentation |
trellis.device
initializes a Trellis display device with
appropriate settings of the graphics control parameter
trellis.settings
.
trellis.device(device = getOption("device"), color = TRUE, theme = getOption("lattice.theme"), bg = NULL, new = TRUE, retain = FALSE, ...) canonical.theme(name, color)
device |
name of a function (possibly as a character string) that initializes a device. Admissible values include "x11", "windows", "mac", "postscript", "pdf", "png", etc. |
color |
logical, whether the display should be color or black and white. |
theme |
list of components that change the settings of the
device opened, or, a function that when called produces such a
list. The function name can be supplied as a quoted string. A
possible usage is to change the default settings at session startup,
for example by setting options(lattice.theme =
"col.whitebg") . If theme is a function, it will not be
supplied any arguments, however, it is guaranteed that a device will
already be open when it is called, so one may use .Device
inside the function to ascertain what device has been opened.
|
bg |
background color for the device. |
new |
logical flag indicating whether a new device should be
started. If FALSE , the options for the current device are
changed to the defaults determined by the other arguments.
|
retain |
logical. If TRUE and a setting for this device
already exists, then that is used instead of the defaults for this
device. By default, pre-existing settings are overwritten (and lost).
|
name |
name of the device for which the setting is required, as
returned by .Device
|
... |
additional parameters to be passed to the device
function, most commonly file for non-screen devices.
|
trellis.device
calls the device
function to start a
display, and sets an appropriate component of the global variable
lattice.theme
to appropriate (device-specific) values.
The device specific settings are determined by canonical.theme
which returns a list (see below).
The settings can subsequently be handled by the interface functions
trellis.par.get
and trellis.par.set
(also the
lset
interface).
canonical.theme
returns a list of components defining graphical
parameter settings for Lattice displays. It is used internally in
trellis.device
, and can also be used as an argument to
lset
, or even as theme
in trellis.device
to use
the defaults for another device.
Deepayan Sarkar deepayan@stat.wisc.edu
trellis.par.set
, lset
,
postscript
,x11
, Lattice