grid.picture: Draw a Picture Object.

View source: R/grid.picture.R

grid.pictureR 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

pictureGrob(picture,
            x = unit(0.5, "npc"), y = unit(0.5, "npc"),
            width = NULL, height = NULL,
            just = "centre", hjust = NULL, vjust = NULL,
            default.units = "npc", expansion = 0.05,
            xscale = NULL, yscale = NULL, distort = FALSE,
            gpFUN = identity, ...,
            ext = c("none", "clipbbox", "gridSVG"),
            delayContent = match.arg(ext) == "gridSVG",
            name = NULL, prefix = NULL, clip = "on")
grid.picture(...)

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. May also be NULL (see Details).

height

A single numeric value or unit object specifying a height. May also be NULL (see Details).

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.

hjust

A numeric vector specifying horizontal justification. If specified, overrides the just setting.

vjust

A numeric vector specifying vertical justification. If specified, overrides the just setting.

default.units

A string indicating the default units to use if x, y, width, or height are only given as numeric vectors.

expansion

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.

gpFUN

A function that takes in a grid gpar object and returns a (optionally modified) gpar object.

...

For grid.picture, arguments to be passed to pictureGrob. For pictureGrob, arguments to be passed to the picture object's grobify method.

ext

A character vector. Selects from one of three possible extensions for drawing imported pictures. "none" means that no clipping will be applied to the imported picture. "clipbbox" means that clipping will be applied, but only to the bounding boxes of any imported clipping paths. "gridSVG" means that gridSVG will be used when drawing the "Picture" object, which enables the use of complex clipping paths, gradients, patterns, etc. to be rendered from an imported picture.

delayContent

If FALSE, pictureGrob() generates a gTree with children immediately. If TRUE, pictureGrob() produces a gTree with a makeContent() method so that children are generated only at drawing time. The latter is relevant when ext == "gridSVG" because it affects when SVG definitions are registered.

name

A character identifier.

prefix

A character string. A prefix to add to referenced gridSVG content (e.g. pattern fills). Only used when gridSVG is TRUE (for grobify). The reference label must be a unique reference label, otherwise an error will result. This can be checked by calling gridSVG's listSVGDefinitions(). When this parameter is NULL, a prefix will automatically be generated but this is not guaranteed to be unique.

clip

Clipping setting passed to the viewport that is set up for drawing the imported image.

Details

If width or height is NULL, and distort=FALSE, the aspect ratio of the image will be respected. By default, the image will match the width/height of the current viewport, (if distort=FALSE, as much as the aspect ratio allows), less any expansion.

Value

A grid gTree.

Author(s)

Simon Potter

See Also

grobify, grid.symbols.


grImport2 documentation built on Sept. 11, 2024, 5:19 p.m.