R: Draw a Picture Object

grid.picture {grImport} | R Documentation

## Draw a Picture Object

### Description

These function take a `"Picture"` object and either draw the picture or create a grid graphical object representing the picture.

### Usage

    grid.picture(...)
    pictureGrob(picture, x = 0.5, y = 0.5,
                width = 1, height = 1, just = "centre",
                exp = 0.05, xscale = NULL, yscale = NULL,
                distort = FALSE,
                FUN = grobify, ..., name = NULL, gp = gpar())

### Arguments

`picture` | A `"Picture"` object.
`x` | A single numeric value or unit object specifying an x-value.
`y` | A single numeric value or unit object specifying a y-value.
`width` | A single numeric value or unit object specifying a width.
`height` | A single numeric value or unit object specifying a height.
`just` | The justification of the picture relative to its (x, y) location. If there are two values, the first value specifes horizontal justification and the second value specifies vertical justification. Possible string values are: `"left"`, `"right"`, `"centre"`, `"center"`, `"bottom"`, and `"top"`. For numeric values, 0 means left alignment and 1 means right alignment.
`exp` | An expansion factor; determines whether any space is left between the extent of the picture and the bounding rectangle it is drawn within.
`xscale` | A numeric vector of length two indicating the minimum and maximum on the x-scale.
`yscale` | A numeric vector of length two indicating the minimum and maximum on the y-scale.
`distort` | A logical value indicating whether the image should preserve its aspect ratio or distort to fit the area it is being drawn within.
`FUN` | The function used to convert paths within the picture to grid grobs.
`...` | For `grid.picture` arguments to be passed to `pictureGrob`. For `pictureGrob`, arguments to be passed to `grobify`.
`name` | A character identifier.
`gp` | An object of class `gpar`, typically the output from a call to the function `gpar`. This is basically a list of graphical parameter settings.

### Value

A grid gTree.

### Author(s)

Paul Murrell

### See Also

`grobify` and `grid.symbols`

[Package grImport version 0.9-0 Index]