feat(wasm): software rendering fallback by ramezgerges · Pull Request #22247 · unoplatform/uno

ramezgerges · 2026-01-05T16:05:10Z

GitHub Issue: closes #21994

PR Type:

What is the current behavior? 🤔

What is the new behavior? 🚀

PR Checklist ✅

Please check if your PR fulfills the following requirements:

📝 Commits must be following the Conventional Commits specification.
🧪 Added Runtime tests, UI tests, or a manual test sample for the changes have been added (for bug fixes / features) (if applicable)
📚 Docs have been added/updated which fit documentation template (for bug fixes / features)
🖼️ Validated PR Screenshots Compare Test Run results.
❗ Contains NO breaking changes

Other information ℹ️

Copilot

Pull request overview

This PR implements a software rendering fallback for WebAssembly when WebGL context creation fails, addressing issue #21994. When WebGL is unavailable or initialization fails, the renderer now falls back to using a 2D canvas context with CPU-based rendering via SkiaSharp's software rasterizer.

Key changes:

Added try-catch around WebGL initialization with automatic fallback to 2D canvas context
Implemented software rendering path using pixel buffers and putImageData for blitting
Refactored JsInfo from a struct with validation to a record with a UseSoftware flag
Improved TypeScript type safety by replacing any types with proper type annotations

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 8 comments.

File	Description
BrowserRenderer.ts	Added software rendering support with 2D context, pixel buffer management, and WebGL fallback logic; improved type safety
BrowserRenderer.cs	Refactored initialization flow, added dual rendering paths (hardware/software), and simplified JsInfo structure

unodevops · 2026-01-05T16:30:57Z

🤖 Your WebAssembly Skia Sample App stage site is ready! Visit it here: https://unowasmprstaging.z20.web.core.windows.net/pr-22247/wasm-skia-net9/index.html

unodevops · 2026-01-05T16:35:10Z

🤖 Your Docs stage site is ready! Visit it here: https://unodocsprstaging.z13.web.core.windows.net/pr-22247/docs/index.html

unodevops · 2026-01-05T19:30:36Z

⚠️⚠️ The build 189927 has failed on Uno.UI - CI.

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 7 comments.

unodevops · 2026-01-07T13:15:49Z

🤖 Your Docs stage site is ready! Visit it here: https://unodocsprstaging.z13.web.core.windows.net/pr-22247/docs/index.html

unodevops · 2026-01-07T13:17:54Z

🤖 Your WebAssembly Skia Sample App stage site is ready! Visit it here: https://unowasmprstaging.z20.web.core.windows.net/pr-22247/wasm-skia-net9/index.html

unodevops · 2026-01-07T21:03:30Z

🤖 Your WebAssembly Skia Sample App stage site is ready! Visit it here: https://unowasmprstaging.z20.web.core.windows.net/pr-22247/wasm-skia-net9/index.html

unodevops · 2026-01-07T21:20:56Z

🤖 Your Docs stage site is ready! Visit it here: https://unodocsprstaging.z13.web.core.windows.net/pr-22247/docs/index.html

Copilot

Copilot reviewed 20 out of 20 changed files in this pull request and generated 9 comments.

unodevops · 2026-01-08T13:49:37Z

🤖 Your WebAssembly Skia Sample App stage site is ready! Visit it here: https://unowasmprstaging.z20.web.core.windows.net/pr-22247/wasm-skia-net9/index.html

unodevops · 2026-01-08T13:50:42Z

🤖 Your Docs stage site is ready! Visit it here: https://unodocsprstaging.z13.web.core.windows.net/pr-22247/docs/index.html

unodevops · 2026-01-08T19:01:07Z

🤖 Your Docs stage site is ready! Visit it here: https://unodocsprstaging.z13.web.core.windows.net/pr-22247/docs/index.html

unodevops · 2026-01-08T19:11:41Z

🤖 Your WebAssembly Skia Sample App stage site is ready! Visit it here: https://unowasmprstaging.z20.web.core.windows.net/pr-22247/wasm-skia-net9/index.html

MartinZikmund · 2026-01-20T15:47:14Z

@Mergifyio backport release/stable/6.5

mergify · 2026-01-20T15:48:05Z

backport release/stable/6.5

✅ Backports have been created

Details

#22403 feat(wasm): software rendering fallback (backport #22247) has been created for branch release/stable/6.5

ramezgerges added 2 commits January 5, 2026 10:31

feat(wasm): software rendering fallback

f3b1e17

chore: typo

7608992

Copilot AI review requested due to automatic review settings January 5, 2026 16:05

github-actions Bot added the platform/wasm 🌐 Categorizes an issue or PR as relevant to the WebAssembly platform label Jan 5, 2026

Copilot started reviewing on behalf of ramezgerges January 5, 2026 16:05 View session

Copilot AI reviewed Jan 5, 2026

View reviewed changes

jeromelaban reviewed Jan 6, 2026

View reviewed changes

Comment thread src/Uno.UI.Runtime.Skia.WebAssembly.Browser/Rendering/BrowserRenderer.cs Outdated

Copilot AI review requested due to automatic review settings January 7, 2026 12:31

Copilot started reviewing on behalf of ramezgerges January 7, 2026 12:31 View session

Copilot AI reviewed Jan 7, 2026

View reviewed changes

chore: refactor into split classes for software and webgl rendering

dad3a7b

ramezgerges force-pushed the wasm_skia_softwarerender branch from b01c09f to 0e7ed25 Compare January 7, 2026 20:43

Copilot AI review requested due to automatic review settings January 8, 2026 12:43

Copilot started reviewing on behalf of ramezgerges January 8, 2026 12:44 View session

Copilot AI reviewed Jan 8, 2026

View reviewed changes

ramezgerges added 6 commits January 8, 2026 12:51

chore: make timing of JS dotnet exports predictable

71b6c48

chore: fix font prefetching timing

c33d31c

chore: cleanup

1b18d39

chore: fix bootstrapper loader removal timing

e673c11

chore: add an option to force software rendering

c846ceb

chore: fix race condition related to heap resizing

49d750d

ramezgerges added 2 commits January 8, 2026 12:51

chore: build error

c69ab77

chore: review comments

899c15d

ramezgerges force-pushed the wasm_skia_softwarerender branch from 7658d34 to 899c15d Compare January 8, 2026 17:52

MartinZikmund approved these changes Jan 16, 2026

View reviewed changes

MartinZikmund merged commit 2749009 into unoplatform:master Jan 17, 2026
53 checks passed

ramezgerges deleted the wasm_skia_softwarerender branch January 18, 2026 14:27

mergify Bot mentioned this pull request Jan 20, 2026

feat(wasm): software rendering fallback (backport #22247) #22403

Merged

5 tasks

Conversation

ramezgerges commented Jan 5, 2026

PR Type:

What is the current behavior? 🤔

What is the new behavior? 🚀

PR Checklist ✅

Other information ℹ️

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

unodevops commented Jan 5, 2026

Uh oh!

unodevops commented Jan 5, 2026

Uh oh!

unodevops commented Jan 5, 2026

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

unodevops commented Jan 7, 2026

Uh oh!

unodevops commented Jan 7, 2026

Uh oh!

unodevops commented Jan 7, 2026

Uh oh!

unodevops commented Jan 7, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

unodevops commented Jan 8, 2026

Uh oh!

unodevops commented Jan 8, 2026

Uh oh!

unodevops commented Jan 8, 2026

Uh oh!

unodevops commented Jan 8, 2026

Uh oh!

Uh oh!

MartinZikmund commented Jan 20, 2026

Uh oh!

mergify Bot commented Jan 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Backports have been created

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

mergify Bot commented Jan 20, 2026 •

edited

Loading