# Upgrading from 1.x Version 2 keeps the conversions you already use but changes some details on how converters are configured, tightens data access, and replaces a few options. This page lists what to change when moving from 1.9 to 2.0, followed by behavior differences to check even when your code still runs. ## Update Your Code Change the dependency to `vl-convert-rs = "2.0.0-rc6"` to select rc6 or later, then update these API calls. **Conversion methods return output structs.** Methods that returned `String` or `Vec` now return `SvgOutput`, `PngOutput`, `JpegOutput`, `PdfOutput`, `HtmlOutput`, `ScenegraphOutput`, or `VegaOutput`. Read the result from `svg`, `data`, `html`, `scenegraph`, or `spec`, and Vega's messages from `logs`. **Format options are structs.** The positional `scale`, `ppi`, `quality`, `bundle`, and `renderer` arguments became `PngOpts`, `JpegOpts`, `PdfOpts`, `SvgOpts`, and `HtmlOpts`. The SVG and PDF methods gained an options argument too. ```rust // 1.x let png: Vec = converter .vegalite_to_png(spec, VlOpts::default(), Some(2.0), None) .await?; // 2.0 let png = converter .vegalite_to_png( spec, VlOpts::default(), PngOpts { scale: Some(2.0), ..Default::default() }, ) .await? .data; ``` **`VlOpts` and `VgOpts` changed fields.** `show_warnings` and `allowed_base_urls` were removed. Put the allowlist in `VlcConfig` and read warnings from `logs`. Both structs gained `google_fonts`, `vega_plugin`, `background`, `width`, and `height`, and `VgOpts` gained `config`. **URL helpers take `UrlOpts`.** `vegalite_to_url(&spec, true)` becomes `vegalite_to_url(&spec, UrlOpts { fullscreen: true })`, and the same for `vega_to_url`. **Converter construction.** `VlConverter::new()` still creates a converter with default settings. Use `VlConverter::with_config()` to set worker count, data access, fonts, and limits. Methods take `&self` instead of `&mut self`, and JavaScript workers start when needed. See {doc}`../advanced/rust-converter`. **SVG conversions use converter methods.** The free `converter::svg_to_png()`, `svg_to_jpeg()`, and `svg_to_pdf()` functions were removed. Use the async methods on `VlConverter` with `PngOpts`, `JpegOpts`, or `PdfOpts`. They apply the converter's font and image-access settings without starting JavaScript workers. See {doc}`../guides/svg-conversions`. **Public imports.** Use the crate-root `register_font_directory()` function. Implementation modules such as `text`, `html`, `extract`, and `module_loader` are now private. Import supported types, version constants, and locale maps from `vl_convert_rs` instead. Use `VlcConfig` in place of the removed `VlConverterConfig` alias. ## Check Behavior Differences These differences can change results even when code and commands still run. **The allowlist now covers images as well as data.** HTTP and HTTPS URLs remain allowed by default. Custom `allowed_base_urls` settings now restrict image loading too, so include any image locations your charts use. Local data and image files remain blocked unless the allowlist permits them. **The default base URL has changed.** The default base_url, that relative URLs resolve against, is now `https://cdn.jsdelivr.net/npm/vega-datasets@v3.2.1/` instead of `https://vega.github.io/vega-datasets/`. If your allowlist only permits the old host, update it or set `base_url` to the old location. See {doc}`../guides/data-loading`. **Absolute data and image paths refer to local files.** Paths such as `/data/cars.csv` and, on Windows, `C:\data\cars.csv` no longer resolve against `base_url`. Allow the directory to load them without a `file://` prefix. For a remote resource, remove the leading slash to resolve `data/cars.csv` against `base_url`, or use an explicit HTTP or HTTPS URL. Chart hyperlinks keep their existing URL behavior. **Warnings are always captured.** 1.x dropped Vega and Vega-Lite warnings unless you asked for them. 2.0 records them on every conversion and reports them through each interface's logging, so expect to see messages you did not see before. They are worth reading! A warning often explains why a chart renders differently than expected. See {doc}`../guides/logging`. **PNG pixels may differ slightly.** To build a PNG image, 1.x first generated an SVG and then rasterized the SVG using the `resvg` crate. This approach generally worked well, but one limitation was that it did not support Vega's [label transform](https://vega.github.io/vega/docs/transforms/label/). Also, the SVG generation followed by SVG parsing had some overhead for charts with many mark instances. Version 2.0 renders PNGs using Vega's canvas renderer with a new Canvas 2D implementation based on [tinyskia](https://github.com/linebender/tiny-skia) and [cosmic-text](https://github.com/pop-os/cosmic-text). This may result in small pixel-level changes to PNGs. Regenerate image baselines in tests that compare PNG bytes. **Conversions run on a worker pool.** 1.x ran every conversion on one JavaScript runtime. 2.0 starts a pool on first use, with one worker by default, and can run conversions concurrently when you configure multiple workers. See {doc}`../advanced/memory-management` for sizing.