Cargo Features

[dependencies]
vello = { version = "0.3.0", default-features = false, features = ["bump_estimate", "buffer_labels", "wgpu", "debug_layers", "wgpu-profiler", "hot_reload"] }
default = wgpu

The wgpu feature is set by default whenever vello is added without default-features = false somewhere in the dependency tree.

bump_estimate

Enables GPU memory usage estimation. This performs additional computations in order to estimate the minimum required allocations for buffers backing bump-allocated GPU memory.
TODO: Turn this into a runtime option used at resolve time and remove the feature.

Enables bump_estimate of vello_encoding

buffer_labels

Adds labels to buffers created by Vello.
May improve debugability at the cost of slightly higher memory usage (TODO: We should just not make these optional).

wgpu default

Enables wgpu ^22.1.0

Affects vello::util, vello::Renderer, vello::RendererOptions

debug_layers

Development only features

Enables debug features when using the "async" pipeline.
This is only intended for development of Vello itself.

Affects render::CapturedBuffers

wgpu-profiler

Enables an embedded wgpu-profiler profiler. This is only intended for development of Vello itself. It is currently known to not work - see https://github.com/linebender/vello/issues/678

Enables wgpu-profiler ^0.18.2

Affects vello::Renderer.profiler, vello::Renderer.profile_result

hot_reload

Enables hot reloading of Vello shaders.
This is only intended for development of Vello itself.
In practise, this won't compile outside of the Vello repository.

Enables compile of vello_shaders