R: Opens a new device

devNew {R.devices} | R Documentation

## Opens a new device

### Description

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 device `function`.
`...` | Additional arguments passed to the device `function`, e.g. `width` and `height`. If not given, the are inferred from `devOptions`().
`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 to `par`, immediately after opening the device.
`label` | An optional `character` string specifying the label of the opened device.

### Value

Returns the device index of the opened device.

### 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.

### Author(s)

Henrik Bengtsson

### See Also

`devDone`() and `devOff`(). For simplified generation of image files, see `devEval`().

[Package R.devices version 2.16.0 Index]