st_aspng: Render stable object in png format

In metrumresearchgroup/pmtables: Tables for Pharmacometrics

Render stable object in png format

Description

Create a standalone png snippet using latex and dvipng from an stable object; both functions are required to be installed for this to work. The resultant png file is saved on disk and the relative path to the file is returned. st2png() is an alias to st_as_png().

Usage

st_aspng(
  x,
  stem = "pmt-standalone-preview",
  dir = tempdir(),
  font = "helvetica",
  textwidth = getOption("pmtables.text.width", 6.5),
  border = getOption("pmtables.image.border", "0.2cm 0.7cm"),
  ntex = 1,
  dpi = 200
)

st2png(
  x,
  stem = "pmt-standalone-preview",
  dir = tempdir(),
  font = "helvetica",
  textwidth = getOption("pmtables.text.width", 6.5),
  border = getOption("pmtables.image.border", "0.2cm 0.7cm"),
  ntex = 1,
  dpi = 200
)

Arguments

x	an stable object; this can be the result of calling stable() or stable_long().
stem	used to build intermediate and output file names.
dir	directory for building the pdf file.
font	the font to use; alternative values include roboto and utopia; passed to st_to_standalone().
textwidth	the page width (in inches) when building with pdflatex; passed to st_to_standalone(); see details.
border	passed as an option to standalone latex output type; see details.
ntex	number of times to build the pdf file
dpi	dots per inch for the resulting png file; used by dvipng when converting dvi file to the final png result.

Value

A string containing the path to the rendered png file.

See Also

st_aspdf(), st_as_image(), st_image_show()

Examples

## Not run: 
Sys.which("latex")
Sys.which("dvipng")

tab <- stable(stdata())
st_aspng(tab)

## End(Not run)

metrumresearchgroup/pmtables documentation built on Dec. 22, 2024, 1:34 a.m.