devNew
Opens a new device
Opens a new device.
Usage
devNew(type=getOption("device"), ..., scale=1, aspectRatio=1, par=NULL, label=NULL)
Arguments
- type
- A
character
string specifying the type of device to be opened. This string should match the name of an existing devicefunction
. - ...
- Additional arguments passed to the device
function
, e.g.width
andheight
. If not given, the are inferred fromdevOptions
- scale
- A
numeric
scalar factor specifying how much the width and the height should be rescaled. - aspectRatio
- A
numeric
ratio specifying the aspect ratio of the image. See below. - par
- An optional named
list
of graphical settings applied, that is, passed topar
, immediately after opening the device. - label
- An optional
character
string specifying the label of the opened device.
Value
- Returns what the device
function
returns.
Width and heights
The default width and height of the generated image is specific to
the type of device used. There is not straightforward programatical
way to infer these defaults; here we use devOptions
(), which
in most cases returns the correct defaults.
Aspect ratio
The aspect ratio of an image is the height relative to the width.
If argument height
is not given (or NULL
), it is
calculated as aspectRatio*width
as long as they are given.
Likewise, if argument width
is not given (or NULL
), it is
calculated as width/aspectRatio
as long as they are given.
If neither width
nor height
is given, then width
defaults to devOptions(type)$width
.
If both width
and height
are given, then
aspectRatio
is ignored.
See Also
devDone
() and devOff
().
For simplified generation of image files, see devEval
().