vello_cpu

This release has an MSRV of 1.88.

Vello CPU

Vello CPU is our 2D renderer which doesn't use a GPU.
The imaging model exposed by Vello CPU is very similar to that of current Vello.

Crates.io | Docs

This implementation is now broadly usable, with a reasonably complete imaging model and competitive performance.
It does not, however, have any API stability guarantees, as we intend to redesign the API to be consistent across the Vello renderers.
Performance information can be seen at https://laurenzv.github.io/vello_chart/ (although this URL is not time-locked, so it might show results from a slightly newer or older version than this tag).

Fixed

• Wrong application of extend mode in the y-direction. (#1803 by @LaurenzV, @ShiroKSH)

Optimized

• Multi-threaded render contexts now initialize task dispatch lazily on the first drawing operation, avoiding unnecessary setup for empty frames and after resets. (#1787 by @LaurenzV, @yezhizhen)

Vello Hybrid

This release is a minor release of Vello Hybrid, which uses the CPU for preprocessing and the GPU for rasterization. The imaging model exposed by Vello Hybrid is very similar to that of current Vello.

Crates.io | Docs

This implementation is in its early stages and does not yet provide any API stability guarantees (see the roadmap for more details). It also doesn't have feature parity with Vello CPU. A few known issues remain, which we plan to address soon.

Added

• Support for sampling from external textures through Scene::draw_texture_rects in the webgl backend, bringing it to parity with the wgpu backend. Textures are bound at render time through the new WebGlTextureBindings. (#1792 by @grebmeg)
• ProbeResult::statistics, ProbeStatistics, and ProbeFeature for diagnosing which renderer-probe features and pixels differ from the reference output. (#1779 by @LaurenzV)
• PROBE_ELEMENTS for inspecting the active features used by the WebGL compatibility probe. (#1801 by @LaurenzV)

Changed

• Breaking change: Renderer::new, Renderer::new_with, WebGlRenderer::new, and WebGlRenderer::new_with now return the renderer and its associated Resources as a tuple. Resources can no longer be constructed directly and must only be used with the renderer instance that generated it. (#1794 by @LaurenzV)
• Breaking change: Scene::new_with now takes a Level instead of RenderSettings. (#1794 by @LaurenzV)
• Breaking change: WebGlRenderer::render and WebGlRenderer::render_to_atlas now take WebGlTextureBindings, providing the external textures referenced by the scene. Pass &WebGlTextureBindings::new() if the scene does not use any. (#1792 by @grebmeg)
• Breaking change: Image-atlas allocation errors now include allocation and free-space diagnostics, while intermediate-texture failures use the new IntermediateTextureError variants for oversized allocations and texture-count limits. (#1778 by @grebmeg)

Fixed

• Image tints with zero opacity now make the image fully transparent. (#1791 by @LaurenzV)
• WebGL image-atlas allocation and growth on Mali-G52 GPUs, avoiding application-not-responding errors. (#1800 by @grebmeg)

Optimized

• WebGL intermediate textures are destroyed before resized replacements are allocated, reducing peak texture memory while render targets grow. (#1781 by @LaurenzV)

Vello Common

This release also contains Vello Common, a support crate used by Vello CPU and Vello Hybrid.

Crates.io | Docs

Vello Common itself does not currently have any stable API surface, as it is only an implementation detail of Vello CPU and Vello Hybrid.

Added

• ProbeResult::statistics, ProbeStatistics, and ProbeFeature for diagnosing which renderer-probe features and pixels differ from the reference output. (#1779 by @LaurenzV)
• PROBE_ELEMENTS for inspecting the active features used by the shared probe scene. (#1801 by @LaurenzV)

Changed

• Breaking change: AtlasError variants now report configured limits and allocation sizes, with the new AtlasSpaceDiagnostics and AtlasLayerDiagnostics types providing per-layer free-space, utilization, and fragmentation details. (#1778 by @grebmeg)

Vello Sparse Shaders

This release also contains Vello Sparse Shaders, a support crate used by Vello Hybrid.

Crates.io | Docs

This crate does not currently have any stable API guarantees.

Full Changelog: sparse-strips-v0.1.0...sparse-strips-v0.2.0

Contributors

• @grebmeg
• @LaurenzV
• @ShiroKSH
• @yezhizhen

This release has an MSRV of 1.88.

Vello CPU

Vello CPU is our 2d renderer which doesn't use a GPU.
The imaging model exposed by Vello CPU is very similar to that of current Vello.
Crates.io | Docs

This implementation is now broadly usable, with a reasonably complete imaging model and competitive performance.
It does not however have any API stability guarantees, as we intend to redesign the API to be consistent across the Vello renderers.
Performance information can be seen at https://laurenzv.github.io/vello_chart/ (although note that this URL is not "time-locked", so might show results from a slightly newer or older version than this tag).

Added

• RenderContext::reset_and_resize, allowing a render context to be reused after its target size changes. (#1705 by @LaurenzV)
• RenderContext::is_multi_threaded for querying whether the context uses multi-threaded rendering. (#1703 by @LaurenzV)
• Inverse blurred rounded rectangles through the new invert parameter on RenderContext::fill_blurred_rounded_rect, enabling inset box shadows. (#1715 by @nicoburns)
• FilterPrimitive::DropShadowOnly for rendering a drop shadow without compositing the original input over it. (#1763 by @LaurenzV)

Changed

• Breaking change: The methods render_to_pixmap and composite_to_pixmap_at_offset have been replaced with unified render and render_with methods, whose settings control the target, pixel format, compositing, and rendering mode. (#1665 by @LaurenzV)
• The Vello CPU frontend and coarse rasterizer have been rewritten. As a result:
  • Filter layers always render correctly, even at viewport boundaries.
  • A number of issues with layer clipping have been fixed.
  • Performance improves by up to 10% across a variety of rendering workloads. (#1701 by @LaurenzV)

Fixed

• Opaque image rendering when blend modes or masks are active. (#1697 by @LaurenzV)
• Gaussian blur strength changing abruptly at decimation thresholds. (#1720 by @grebmeg)
• Panics when resetting or dropping a multi-threaded render context while worker tasks are still in flight. (#1732, #1756 by @yezhizhen)

Optimized

• x86 rendering, including blending and high-quality image sampling, through improved SIMD code generation. (#1688 by @LaurenzV)
• Clip-path intersection by skipping rows outside the paths' shared vertical extent and locating the first relevant strip with binary search. (#1690, #1691 by @LaurenzV)
• Radial-gradient evaluation and gradient lookup-table generation. (#1723, #1726 by @LaurenzV)
• Rendering opaque peniko::ImageData by computing and retaining its transparency hint during conversion. (#1760 by @tronical)

Vello Hybrid

This release is a minor release of Vello Hybrid, which uses the CPU for preprocessing and the GPU for rasterization. The imaging model exposed by Vello Hybrid is very similar to that of current Vello.
Crates.io | Docs

This implementation is in its early stages and does not yet provide any API stability guarantees (see the roadmap for more details). It also doesn’t have feature parity with Vello CPU. A few known issues remain, which we plan to address soon.

Added

• Inverse blurred rounded rectangles through the new invert parameter on Scene::fill_blurred_rounded_rect, enabling inset box shadows. (#1715 by @nicoburns)
• Resources::new_with_config for configuring the image and glyph atlas used by resources. (#1750 by @grebmeg)
• FilterPrimitive::DropShadowOnly for rendering a drop shadow without compositing the original input over it. (#1763 by @LaurenzV)
• Scene::reset_and_resize, allowing a scene to be reused after its target size changes. (#1769 by @LaurenzV)

Changed

• Breaking change: WebGlRenderer::probe is now asynchronous. It returns a WebGlPendingProbe, which can be polled with try_finish, avoiding a synchronous GPU-to-CPU readback stall and providing specific WebGL error codes on failure. (#1671, #1735 by @LaurenzV)
• Breaking change: Vello Hybrid's core scene scheduling and rendering architecture has been rewritten, removing coarse rasterization. The rewrite improves layer performance, allows filter output beyond the root viewport, reduces memory use for filter-heavy scenes, and removes the need for scene constraints. (#1759 by @LaurenzV)
• Breaking change: RenderSettings now contains MemorySettings, with separate image-atlas and intermediate-layer configuration. SceneConstraints and RenderError::SlotsExhausted have been removed, and LayersConfig allows applications to limit and tune intermediate textures. (#1759 by @LaurenzV)
• WebGL APIs are now exported whenever the webgl feature is enabled, including on non-Wasm targets. (#1682 by @jesses-canva)
• Relaxed the minimum versions of wasm-bindgen-related dependencies. (#1683 by @LaurenzV)

Fixed

• Opaque image rendering when blend modes or masks are active. (#1697 by @LaurenzV)
• Gaussian blur strength changing abruptly at decimation thresholds. (#1720 by @grebmeg)
• Fast rectangle rendering at the maximum u16 coordinates. (#1666 by @dipeshbabu)
• WebGL renderer resources are now deleted when dropped instead of relying on garbage collection, allowing renderers to be recreated safely after context loss. (#1674 by @LaurenzV)
• WebGL probing after rendering filter layers no longer corrupts the renderer's atlas state. (#1734 by @LaurenzV)

Optimized

• Image-atlas textures and intermediate filter/layer textures are allocated lazily, substantially reducing initial GPU memory use for scenes that do not use images, layers, or filters. (#1747, #1757, #1759 by @grebmeg, @LaurenzV)
• Clip-path intersection by skipping rows outside the paths' shared vertical extent and locating the first relevant strip with binary search. (#1690, #1691 by @LaurenzV)
• Gradient lookup-table generation. (#1726 by @LaurenzV)
• Rendering opaque peniko::ImageData by computing and retaining its transparency hint during conversion. (#1760 by @tronical)

Vello Common

This release also contains Vello Common, a support crate used by Vello CPU and Vello Hybrid.
Crates.io | Docs

Vello Common itself does not currently have any stable API surface, as it is only an implementation detail of Vello CPU and Vello Hybrid.

Added

• FilterPrimitive::DropShadowOnly for rendering a drop shadow without compositing the original input over it. (#1763 by @LaurenzV)
• Support for inverse blurred rounded rectangles, enabling inset box shadows in the renderer crates. (#1715 by @nicoburns)

Changed

• Breaking change: Filter bounds now distinguish the output expansion from the source expansion required to compute a filter. The bounds_expansion APIs have been replaced by filter_expansion and source_expansion. (#1701 by @LaurenzV)
• Breaking change: Filter padding now uses the new PaddingU16 type, RectU16::intersect no longer produces inverted rectangles, and strip_bbox now returns Option<RectU16>. (#1751 by @LaurenzV)

Removed

• Breaking change: The old coarse rasterizer and render graph, including the public coarse and render_graph modules. The rewritten CPU and hybrid renderers no longer use them. (#1762 by @LaurenzV)

Fixed

• Opaque image rendering when blend modes or masks are active. (#1697 by @LaurenzV)
• Gaussian blur strength changing abruptly at decimation thresholds. (#1720 by @grebmeg)
• Fast rectangle rendering at the maximum u16 coordinates. (#1666 by @dipeshbabu)

Optimized

• Clip-path intersection by skipping rows outside the paths' shared vertical extent and locating the first relevant strip with binary search. (#1690, #1691 by @LaurenzV)
• Gradient lookup-table generation. (#1726 by @LaurenzV)
• x86 rendering, including blending and high-quality image sampling, through improved SIMD code generation. (#1688 by @LaurenzV)
• Rendering opaque peniko::ImageData by computing and retaining its transparency hint during conversion. (#1760 by @tronical)
• Filter processing for drop shadows by tightening their source and output bounds. (#1768 by @LaurenzV)

Vello Sparse Shaders

This release also contains Vello Sparse Shaders, a support crate used by Vello Hybrid.
Crates.io | Docs

This crate does not currently have any stable API guarantees.

Full Changelog: sparse-strips-v0.0.9...sparse-strips-v0.1.0

The 9th alpha version of the Vello Sparse Strips renderers (version 0.0.9) has been released.

This release has an MSRV of 1.88.
You can also follow the roadmap for Vello Sparse Strips.

Vello CPU

Vello CPU is our 2d renderer which doesn't use a GPU.
The imaging model exposed by Vello CPU is very similar to that of current Vello.
Crates.io | Docs

This implementation is now broadly usable, with a reasonably complete imaging model and competitive performance.
It does not however have any API stability guarantees, as we intend to redesign the API to be consistent across the Vello renderers.
Performance information can be seen at https://laurenzv.github.io/vello_chart/ (although note that this URL is not "time-locked", so might shows results from a slightly newer or older version than this tag).

Fixed

• Rendering of glyphs with complex paints. (#1668 by @LaurenzV)
• Rendering of paths with high winding counts. (#1673 by @b0nes164)

Optimized

• Optimized rendering of a number of blend modes. (#1653 by @LaurenzV)

Vello Hybrid

This release is a minor release of Vello Hybrid, which uses the CPU for preprocessing and the GPU for rasterization. The imaging model exposed by Vello Hybrid is very similar to that of current Vello.
Crates.io | Docs

This implementation is in its early stages and does not yet provide any API stability guarantees (see the roadmap for more details). It also doesn’t have feature parity with Vello CPU. A few known issues remain, which we plan to address soon.

Fixed

• WebGL rendering on certain Adreno GPUs. (#1619, #1620, #1659 by @LaurenzV, @grebmeg)
• Rendering of glyphs with complex paints. (#1668 by @LaurenzV)
• Rendering of paths with high winding counts. (#1673 by @b0nes164)

Vello Common

This release also contains Vello Common, a support crate used by Vello CPU and Vello Hybrid.
Crates.io | Docs

Vello Common itself does not currently have any stable API surface, as it is only an implementation detail of Vello CPU and Vello Hybrid.

Fixed

• Rendering of paths with high winding counts. (#1673 by @b0nes164)

Optimized

• Tiling of line segments fully contained in the viewport. (#1635 by @LaurenzV)

Vello Sparse Shaders

This release also contains Vello Sparse Shaders, a support crate used by Vello Hybrid.
Crates.io | Docs

This crate also does not currently have any public API surface.

Fixed

• WebGL rendering on certain Adreno GPUs. (#1619, #1620, #1659 by @LaurenzV, @grebmeg)

Full Changelog: sparse-strips-v0.0.8...sparse-strips-v0.0.9

This release has an [MSRV][] of 1.88.

Added

• render_decoration on glyph run builders for rendering text decorations with skip-ink behavior. ([#1592][] by [@taj-p][])
• Support for rendering VARC glyphs in text paths. ([#1594][] by [@nicoburns][], [@oscargus][])
• Support for synthetic font emboldening in text glyph runs via GlyphRunBuilder::font_embolden and glifo::FontEmbolden. ([#1628][] by [@jrmoulton][])

Changed

• Migrated text rendering to glifo; rendering, glyph, and image APIs now use an explicit Resources object for persistent image and glyph caches. RenderContext::render_to_buffer, RenderContext::render_to_pixmap, RenderContext::composite_to_pixmap_at_offset, and RenderContext::glyph_run now take resources, and image registration moved from RenderContext to Resources. ([#1562][] by [@LaurenzV][])
• Renamed image transparency hint APIs from may_have_opacities and *_opacity_hint to may_have_transparency and *_transparency_hint. ([#1613][] by [@upsuper][])

Removed

• Experimental vello_api integration and api module. ([#1602][] by [@waywardmonkeys][])
• Support for recordings. This decision was made due to a number of downsides that came with the implementation. See the corresponding PR and Zulip thread for more information. ([#1611][] by [@LaurenzV][])

Fixed

• Rendering of rare degenerate radial gradients with undefined regions, which should render those regions transparent. ([#1529][] by [@LaurenzV][])
• Incorrect rendering of filter layers containing nested clip layers. ([#1541][] by [@LaurenzV][])
• x86 artifacts in bicubic image rendering caused by negative interpolated color values wrapping during SIMD f32 to u8 conversion. ([#1563][] by [@LaurenzV][])
• Stroked glyph rendering when scaled glyph runs absorb the transform into the font size, preserving the expected stroke width. ([#1576][] by [@LaurenzV][])
• COLR glyph rendering, including glyphs using non-default blend modes. ([#1584][] by [@LaurenzV][])
• Rendering of inverted rectangles, including blurred rounded rectangles. ([#1589][] by [@LaurenzV][])

Optimized

• CPU fine rasterization performance through improved SIMD codegen. ([#1616][] by [@LaurenzV][])

This release has an [MSRV][] of 1.92.

Added

• composite_to_pixmap_at_offset method to RenderContext for compositing at specific offsets within a larger pixmap. ([#1416][] by [@grebmeg][])
• ImageResolver for resolving opaque image IDs at rasterization time. ([#1451][] by [@grebmeg][])
• Support for image tinting. ([#1460][] by [@grebmeg][])

Fixed

• Rendering of blurred rounded rectangles with zero or very small blur standard deviations. ([#1422][] by [@tomcur][])
• Off-by-one error in gaussian blur decimation filter. ([#1488][] by [@LaurenzV][])
• Filter layers with zero clips. ([#1437][] by [@LaurenzV][])

Optimized

• Bilinear image sampling in the RenderMode::OptimizeQuality (f32) pipeline. ([#1343][] by [@tomcur][])

This release has an [MSRV][] of 1.88.

Added

• Support for the "offset" filter. ([#1351] by [@waywardmonkeys])

Changed

• Breaking change: Updated Peniko to v0.6.0. ([#1349][] by [@DJMcNab][])
  • This also updates Kurbo to v0.13.0.
• Upgraded Skrifa to v0.40.0. ([#1353][] by [@waywardmonkeys][])
• Upgraded Hashbrown to v0.16.1. ([#1354][] by [@waywardmonkeys][])
• Optimized image rendering for axis-aligned images. ([#1335][] by [@grebmeg][])

See also the vello_hybrid 0.0.6 and vello_common 0.0.6 releases.

This release has an [MSRV][] of 1.88.

Added

• The RenderContext now has a set_blend_mode (and a corresponding blend_mode getter method) that can be used to support non-isolated blending. ([#1159][] by [@LaurenzV])
• The RenderContext now contains a push_clip_path and pop_clip_path method for performing non-isolated clipping. ([#1203][] by [@LaurenzV])
• Experimental support for image filter effects: ([#1286][] by [@grebmeg][])
  • New filter API methods on RenderContext:
    • set_filter_effect() - Set a filter to be applied to subsequent drawing operations.
    • push_filter_layer() - Create a new layer with a filter effect.
  • FilterEffect trait providing both u8 and f32 precision variants for rendering across different backends.
  • Gaussian Blur filter with configurable standard deviation and edge modes (None, Mirror, Wrap, Duplicate). Uses an optimized decimated blur algorithm with automatic downsampling for performance.
  • Drop Shadow filter with customizable offset, blur radius, and shadow color.
  • Flood filter for solid color fills.
• A set_mask method to make it possible to mask rendered paths without inducing layer isolation. ([#1237][] by [@LaurenzV])
• Support for conditionally disabling the u8 or f32 pipeline. ([#1294][] by [@nicoburns])

Changed

• Improved performance of rendering opaque images. ([#1327][] by [@grebmeg])

Known Limitations

• Filter effects currently support only single-primitive filters; filter graphs with multiple chained primitives are not yet supported.
• Multithreaded rendering is not supported for filter effects; filters are only applied in single-threaded mode.

See also the vello_hybrid 0.0.5 and vello_common 0.0.5 releases.

This release has an [MSRV][] of 1.86.

No changelog was kept for this release.

See also the vello_hybrid 0.0.4 and vello_common 0.0.4 releases.

This release has an [MSRV][] of 1.86.

No changelog was kept for this release.

See also the vello_common 0.0.3 release.

This release has an [MSRV][] of 1.85.

No changelog was kept for this release.

See also the vello_common 0.0.2 release.

This release has an MSRV of 1.85.

This is the initial release. No changelog was kept for this release.

See also the vello_common 0.0.1 release.