Render an SVG file with the AxiDraw penplotter

This function takes an SVG representation of a graphic and sends it to the AxiDraw penplotter for drawing. This function uses the build-in svg drawing capabilities of the pyaxidraw library so rendering an svg with grDevices::svg() and then using axi_svg to draw it will likely produce a different result than rendering directly to axi_dev().

axi_svg(
  file,
  capture = FALSE,
  options = axi_options(),
  layer = NULL,
  copies = 1L,
  page_delay = 15,
  auto_rotate = TRUE,
  rendering = "all",
  reorder = "none",
  summary = FALSE,
  text
)

Arguments

file	An svg file
capture	Logical. Should the drawing instructions be captured and returned as a new svg.
options	An axi_options object. See the documentation for axi_options() for all the settings.
layer	The layer to plot when mode = 'layers'. See the details section
copies	The number of copies to produce
page_delay	The delay in seconds between each copy
auto_rotate	Automatically rotate the image to maximize paper usage
rendering	The type of preview to generate when preview = TRUE. Either 'none' (nothing rendered), 'down' (render when pen is down), 'up' (render when pen is up), or 'all' (render everything)
reorder	The type of automatical line reordering to perform. Either 'none' (no reordering), 'objects' (reorder within objects), 'groups' ( reorder within objects, then reorder groups), or 'full' (reorder everything together).
summary	Should time spend and distance travel be reported in the end
text	An svg as a character vector.

Value

If capture = TRUE a new svg showing the pen plotter movement that will be used for drawing.

Examples

if (FALSE) {
logo <- system.file('example.svg', package = 'fawkes')
axi_svg(logo)
}