Conversion Overrides#
An override changes one conversion without affecting the converter configuration. Use Configuration instead when the same value should apply to every conversion.
Override |
Applies to |
Effect |
|---|---|---|
|
Vega-Lite |
Applies a built-in or custom theme |
|
Vega-Lite and Vega |
Merges a Vega or Vega-Lite configuration object into the input |
|
Vega-Lite and Vega |
Selects number formatting rules |
|
Vega-Lite and Vega |
Selects date and time formatting rules |
|
Vega-Lite and Vega |
Sets the chart background and logical size before rendering |
|
PNG and JPEG |
Multiplies raster pixel dimensions |
|
PNG |
Combines with |
|
JPEG |
Sets encoding quality from |
|
SVG and HTML |
Embeds fonts and images in SVG, or browser dependencies in HTML |
|
HTML |
Selects |
|
Vega-Lite |
Selects a bundled Vega-Lite compiler version |
|
Vega-Lite and Vega |
Makes selected Google Fonts available to one conversion |
|
Vega-Lite and Vega |
Registers plugin code for one conversion |
|
Vega Editor URLs |
Selects the full-screen editor URL form |
SVG input conversions accept only the raster options scale, ppi, and quality. Chart options such as theme, width, and height do not apply to them.
The examples override this Vega-Lite input:
chart.vl.json
{
"$schema": "https://vega.github.io/schema/vega-lite/v6.json",
"data": {
"values": [
{"category": "A", "value": 28},
{"category": "B", "value": 55},
{"category": "C", "value": 43},
{"category": "D", "value": 91},
{"category": "E", "value": 81}
]
},
"mark": "bar",
"encoding": {
"x": {"field": "category", "type": "nominal"},
"y": {"field": "value", "type": "quantitative"}
}
}
Pass overrides as options after the conversion command:
$ vl-convert vl2png \
> --input chart.vl.json \
> --output chart.png \
> --scale 2 \
> --width 640 \
> --height 360 \
> --theme dark
Run a command with --help to see its options. --config is available on the Vega-Lite and Vega chart commands except vl2url and vg2url, which only encode the input specification in a URL. Converter settings such as --google-font and --vega-plugin are global options and can appear before or after the command.