grid.dvi: Render DVI File in R

Description

Render a DVI file in R graphics.

Usage

dviGrob(dvi, ...) 
# S3 method for character
dviGrob(dvi, ...)
# S3 method for DVI
dviGrob(dvi, ...,
        packages=NULL,
        engine=getOption("xdvir.engine"))
# S3 method for list
dviGrob(dvi, x = 0.5, y = 0.5,
        margin=0, rot=0,
        default.units = "npc",
        hjust="centre", vjust="centre",
        dpi=NA,
        page=1,
        packages=NULL,
        engine=getOption("xdvir.engine"),
        fontLib=getOption("xdvir.fontLib"),
        ...,
        name=NULL,
        gp=gpar(),
        vp=NULL)
grid.dvi(...)
render(...)

Value

A "DVIgrob" object.

Arguments

dvi: A "DVI" object, as produced by readDVI, or a "DVIfile" object, as produced by typeset, or the name of a DVI file, or a list containing some combination of all three.
x, y: Numeric values or units specifying where to draw the output.
margin: Numeric values or units specifying margins (in the order bottom, left, top, right). Recycled if necessary.
rot: Rotation angle (in degrees).
default.units: Units to use if x or y are numeric.
hjust, vjust: Justification of the output relative to the x/y location.
dpi: Resolution (dots per inch) for rendering.
page: Which page should be drawn.
engine: The TeX engine that should be used to render the DVI file (see Details).
fontLib: The font libraary the should be used to query fonts and glyphs.
packages: The LaTeX packages to be used in rendering the DVI.
name: Character value giving name for the grob.
gp: Graphical parameter settings.
vp: A viewport or NULL.
...: Arguments specific to methods of dviGrob.

Author

Paul Murrell

Details

If the engine is NULL (the default), one is chosen based on the engine attribute of the dvi input (if an engine of that name has been registered).

If the engine is specified, but does not match the engine attribute of the dvi then, if the dvi engine was guessed the engine will be used, otherwise the conflict will result in an error.