Skip to content

v0.5.0-rc.0

Pre-release
Pre-release

Choose a tag to compare

@matiasngf matiasngf released this 10 Sep 14:15
2213b5d

v0.5.0-rc.0

First release candidate for the 0.5.0 minor. This is an opt-in prerelease published to npm next; latest remains on the stable release.

npm install vgpu@next

All seven public packages are versioned together at 0.5.0-rc.0.

Highlights

  • Explicit, unified texture creation: kind, spatial size, array layers, and nonempty usage, with immutable creation metadata.
  • Texture readback supports explicit mip selection, mip-relative regions, and every selected layer or slice, with early allocation and usage validation.
  • Safer texture replacement and resource lifetime handling, including stale bundle detection and separate compute/draw cache ownership.
  • Linux Node rendering defaults to Vulkan, avoiding Dawn's restricted-mip-view/storage-write defect on OpenGL. macOS, Windows, and browser defaults are unchanged.
  • Atmosphere & Clouds example with temporally accumulated haze, filtered near cloud shadows, and smoothed scene controls.

Migration required

This pre-1.0 minor includes breaking API changes: Texture.resize() and Target/Surface read delegates are removed. Replace texture allocations explicitly, and read from a selected attachment with texture.read({ mipLevel: 0, region: "all" }) or readFloats(options).

See the texture API migration guide for before/after examples.

Linux installations need a usable Vulkan driver or an installed portable CPU renderer (npx vgpu install-software-renderer). Auto mode does not silently fall back to OpenGL or download drivers. Explicit OpenGL overrides remain available with the documented upstream limitation.

Please validate texture creation/replacement, cropped and layered readback, and Linux rendering in your applications before stable promotion.