Save a vrt_block object to disk

Usage

vrt_save(
  x,
  outfile = fs::file_temp(tmp_dir = getOption("vrt.cache"), ext = "vrt"),
  bundle = FALSE,
  include_rasters = FALSE
)

x: A vrt_stack or vrt_block object.
outfile: A character string of the output file path. Must have a .vrt extension. Defaults to a temporary file inside getOption("vrt.cache").
bundle: Logical. If TRUE, copy every intermediate VRT in the dependency tree into the directory containing outfile and rewrite all <SourceFilename> paths relative to that directory. The result is a self-contained bundle that survives wiping the VRT cache. Remote sources (URLs, /vsicurl/, ...) cannot be bundled and are left untouched.
include_rasters: Logical. Only meaningful when bundle = TRUE. If TRUE, copy local raster leaves (e.g. GeoTIFFs) into the bundle as well, producing a fully portable directory. Remote raster sources are skipped and surfaced as a single warning.

Invisibly, the normalised absolute path to the saved .vrt file.