Changelog (2.0.0-beta.3)
Changes since 2.0.0-beta.2.
On this page
Last updated: November 11th, 2026
📘 See the full changelog for 2.0.0
These are the changes since
2.0.0-beta.2(released October 6th, 2026). For all changes since v1.4, see the 2.0.0 changelog.
Highlights
- macOS x64 support. The beta SDK now ships for macOS x64 (Intel Macs) alongside macOS arm64, Windows x64, and Linux x64, requiring macOS 11.3 or later.
- Async GPU driver. The Platform module adds
GPUDriverAsyncto run GPU commands on a separate render thread, with reference drivers for Direct3D 11, Direct3D 12, and Metal, plus C API bindings— see Asynchronous GPU Driver. - AppCore asynchronous rendering.
Settings::use_async_gpu_driverruns GPU work and presentation on a dedicated thread so pages keep rendering while waiting to present (on by default on macOS, off on Windows). - Crisp pixel fonts. They keep hard edges at every display scale on both renderers with no CSS or
Configchanges— see Text Rendering and Fonts. - Text layout closer to Safari. The library now supports CSS
font-palette,font-size-adjust, and@font-feature-values. - More JavaScript object operations. Delete object properties again with
Value::Delete()(as in Ultralight 1.4), with new support for own keys, defining and freezing properties, constructors, and dates.
Upgrading from beta.2
Recompile everything against the beta.3 headers. Then check the two lists below.
Changes the compiler won't catch
Some of the API behavior has changed, make sure to be aware of the following changes:
Custom GPU drivers:
UpdateCommandList()must append each new command list after pending ones rather than replacing them, running all lists in order.- Textures created with
kGPUTextureFlag_Immutablenow have immutable bitmaps (Bitmap::is_immutable()istrue), so writes (Erase(),Set(),DrawBitmap()) fail or do nothing while reads work. - Replace copied SDK
platform/code or shaders with beta.3 copies because the shaders changed. GPUContextD3D11.handGPUContextD3D12.hno longer defineENABLE_MSAA, so#if ENABLE_MSAAnow silently evaluates to0.GPUContextMetalno longer creates its own driver (driver()is null until attached), so createGPUDriverMetal(context)yourself and destroy it before the context.
Renderer:
- Call
Renderer::Render()every frame even with nothing to paint, or an undisplayed<canvas>that script draws into holds draw calls in memory. Config::num_renderer_threadsis now honored, whereas beta.2 ignored it and always used 8 threads.
AppCore:
- On macOS, GPU work and presentation run on a dedicated thread by default, so set
Settings::use_async_gpu_driver = falseto keep beta.2 behavior (ignored on Linux, on CPU renderers, and with your own GPU driver). LayoutNode::bounds()reads after a change now return the new geometry right away (previously after the next paint), andOnLayoutChange()callbacks run at the start of the next update rather than during paint.- Layout override delegates run only when size, children, options, or display scale change, so call the new
Container::SetNeedsLayout()when other state changes.
Text and canvas:
- Text layout is now closer to Safari, so lines are often 1-2 px shorter.
- Canvas
shadowOffsetYnow moves downward for positive values (beta.2 mirrored this), so remove any workaround. - Pixel font sizes snap to the closest 1:1 size (
Config::snap_pixel_font_sizedefaults totrue) with whole-pixel advances,font_emboldenno longer applies, and computed style keeps the authored size.
Downloads and navigation:
- Subframes (
<iframe>) start a download only after a user click in that frame, while the main frame is unchanged. - Responses without a usable
Content-Typenow have their MIME type sniffed, so HTML, text, or images that beta.2 downloaded may display instead while binary bodies still download in the main frame.
Logging:
- The Direct3D 11 and Direct3D 12 reference drivers now log under
d3d11andd3d12, andGPUContextMetallogs undermetalinstead ofrender(GPUDriverMetalstill logs underrender), so update your log filters.
JavaScript:
Value::To()intostd::map<std::string, T>now fails forMap,Set,Date, and typed arrays, where beta.2 succeeded and usually returned an empty map.
Changes the compiler will catch
When you rebuild the compiler should flag each of these changes. In the tables below, the left column is beta.2 code and the right column is the equivalent in beta.3.
Renderer configuration:
| beta.2 | beta.3 |
|---|---|
config.bitmap_alignment = 16; |
config.bitmap_row_alignment = 16; |
ulConfigSetBitmapAlignment(config, 16); |
ulConfigSetBitmapRowAlignment(config, 16); |
Platform module:
| beta.2 | beta.3 |
|---|---|
bool queued = chain->PresentFrame(true); |
bool queued = chain->PresentFrame(true) == SwapChainD3D11::PresentResult::Presented; |
SwapChainD3D11::PresentFrame()andSwapChainD3D12::PresentFrame()returnPresentResult(Presented,Busy,Failed) instead ofbool, and swap chains are no longer copyable.- Direct3D reference headers no longer put
ComPtrin the global namespace, so addusing Microsoft::WRL::ComPtr;to code that relied on it.
What's New
GPU drivers:
- Add
GPUDriverAsyncandGPUFrame(Platform/GPUDriverAsync.h), with reference drivers for Direct3D 11, Direct3D 12, and Metal - Add C API bindings for async GPU drivers in
AppCore/CAPI/CAPI_GPUDriverAsync.h - Add texture readback via
platform::GPUDriver::ReadbackTexture()andsupports_readback()in all reference drivers - Support texture readback in custom GPU drivers by overriding
ReadTexturePixels()andsupports_readback()(overrides ofBeginSynchronize()orEndSynchronize()must call the base implementation, else readback fails) - Add
Bitmap::is_immutable()andulBitmapIsImmutable()
AppCore:
- Add
Settings::use_async_gpu_driver - Allow
WindowListener::OnClear()andOnPaint()to draw through the publicGPUDriver(ulAppGetGPUDriver()in C) - Add
Container::SetNeedsLayout()
JavaScript:
- Add property deletion via
Value::Delete()andValue::DeleteProperty() - Add own property inspection via
Value::HasOwn()andValue::OwnKeys() - Add
Value::DefineProperty(),Value::DefineAccessor(), andValue::Freeze() - Add constructors via
Value::Construct()andValue::IsConstructor() - Add Dates via
Context::MakeDate()andValue::TimeValue() - Add C API counterparts for JavaScript object operations (
ulJSObjectDeleteProperty(), etc.)
CSS and text:
- Add CSS
font-paletteand@font-palette-valueson color fonts - Add CSS
font-size-adjustand@font-feature-values - Add
Config::pixel_font_rendering(Pixelateddefault,Smooth),Config::snap_pixel_font_size, and-ul-font-renderingCSS property (auto,smooth,pixelated)
Networking:
- Sniff MIME types for frame navigations without a usable
Content-Type, matching Chrome's rules
Performance:
- Draw scaled-down images roughly 10x faster
- Speed up the Direct3D 12 and Metal reference drivers
- Optimize
matchMedia()so evaluating it every frame no longer slows frames
Notable Fixes
- Fix Direct3D 12 device-removed faults on window resize or close, and debug-layer errors every frame in AppCore windows
- Fix Direct3D 11 and Direct3D 12 reference crashes, leaks, and message boxes on failure paths, falling back to CPU rendering in AppCore when Direct3D 11 device creation fails
- Fix occluded macOS windows blocking the main thread for roughly one second under synchronous Metal
- Fix Linux OpenGL crash on closing a window or popup
- Fix
App::Quit()during an update continuing to paint windows - Fix rendering of one-stop gradients, hard stops at 0% and 100%, zero-size gradients, and radius-0 radial gradients
- Fix translucent colors and opacity rendering one level too dark on both renderers
- Fix cubic Bezier curves with long handles shifting by up to 1.7 px (GitHub #539)
- Fix canvas
globalAlphaand shadows applying twice whenctx.filteris set,drawImage()ignoringglobalAlphafor videos, full-circlearc()calls drawing nothing, andstrokeRect()rendering nothing when either dimension is zero - Fix canvas shadows rendering only on solid rectangle fills (they now apply to all draws)
- Fix ligatures remaining active when
letter-spacingis set, single characters losing OpenType features, and combining marks following a space inheriting the space's width - Fix bitmap-only fonts missing glyphs, rendering at the wrong size, and ignoring
-webkit-text-stroke - Fix large images failing to appear when decoding takes longer than a frame
- Fix crash when script opens or closes a View (eg, a
<select>popup) during paint - Fix media elements with no playable tracks holding the page
loadevent - Fix
ImageSourceleak where bitmaps and GPU textures were never freed in apps that swap images