orb_save: Save a plot at any resolution

In orbis: Interactive and High-Resolution Layered Graphics with Built-in World Maps

Save a plot at any resolution

Description

Writes a plot to disk. The format is taken from the file extension:

Usage

orb_save(plot, file, width = 820, height = 520, dpi = 300, interactive = TRUE)

Arguments

plot	An orb_spec object.
file	Output path. The extension selects the format.
width, height	Logical size in pixels (the drawing is laid out at this size, then rendered at dpi).
dpi	Resolution for raster formats. 96 is screen resolution; 300 is a common print requirement; 600 gives very high resolution output.
interactive	For .html and .svg, embed interactive behaviour.

Details

.svg

Vector output from the built-in SVG writer. Being a vector format it is resolution independent - it stays sharp at any size.

.html

A self-contained interactive page (see orb_interactive()).

.pdf

Vector output through R's PDF device.

.png, .tiff, .jpeg

Raster output at the requested dpi; use 300 or more for print.

Value

The file path, invisibly.

See Also

orb_svg(), orb_interactive(), orb_draw()

Examples

p <- orb(mtcars, x = wt, y = mpg, colour = cyl) + orb_points()
f <- tempfile(fileext = ".png")
orb_save(p, f, dpi = 300)
file.exists(f)
unlink(f)

orbis documentation built on Aug. 5, 2026, 9:08 a.m.