gecko-dev/gfx/wr
Nicolas Silva 295136d90a Bug 1710814 - Set the image tiling threshold to 4k. r=gfx-reviewers,jnicol
Depends on D114954

Differential Revision: https://phabricator.services.mozilla.com/D114955
2021-05-17 09:05:52 +00:00
..
ci-scripts Bug 1706824 - Remove old direct-composition example. r=gfx-reviewers,lsalzman 2021-05-04 00:32:41 +00:00
example-compositor Bug 1707202 - Remove surface_origin_is_top_left support from NativeSurface again, r=nical 2021-04-26 12:48:39 +00:00
examples Bug 1709757 - Pt 3 - Remove WR internal code and APIs for debugger feature r=gfx-reviewers,nical 2021-05-07 01:57:01 +00:00
glsl-to-cxx Bug 1703402 - Clamp RGB components after YUV conversion for SWGL blending. r=jrmuizel 2021-04-07 01:25:34 +00:00
peek-poke Bug 1676513 - Fix clippy warnings r=emilio,webdriver-reviewers,whimboo,rhunt 2020-11-17 12:02:22 +00:00
swgl Bug 1704750 - Simplify rasterizer edge termination condition. r=kvark 2021-05-06 21:55:27 +00:00
tileview Bug 1709757 - Pt 3 - Remove WR internal code and APIs for debugger feature r=gfx-reviewers,nical 2021-05-07 01:57:01 +00:00
webrender Bug 1710814 - Set the image tiling threshold to 4k. r=gfx-reviewers,jnicol 2021-05-17 09:05:52 +00:00
webrender_api Bug 1708540 - Handle and test various NaN situations with gradients. r=gfx-reviewers,bradwerth 2021-05-05 21:28:34 +00:00
webrender_build Bug 1702228 - Cache linear gradients by default. r=gw 2021-04-22 10:34:54 +00:00
wr_malloc_size_of Bug 1677866 - Report memory allocated by `cert_storage` crate r=keeler,emilio 2021-04-19 22:12:56 +00:00
wrench Bug 1710503 - Fix blend container + complex transform optimization r=gfx-reviewers,jnicol 2021-05-11 20:08:32 +00:00
.gitignore
.taskcluster.yml Bug 1670157 - Run wrench reftests with swgl in CI. r=kats 2020-10-09 18:06:36 +00:00
Cargo.lock Bug 1609191 - Revert previous attempt to work around Adreno shader compilation crash. r=nical 2021-05-12 13:03:51 +00:00
Cargo.toml Bug 1706824 - Remove old direct-composition example. r=gfx-reviewers,lsalzman 2021-05-04 00:32:41 +00:00
LICENSE
README.md
rustfmt.toml
servo-tidy.toml Bug 1609191 - Revert previous attempt to work around Adreno shader compilation crash. r=nical 2021-05-12 13:03:51 +00:00

README.md

WebRender

Version

WebRender is a GPU-based 2D rendering engine written in Rust. Firefox, the research web browser Servo, and other GUI frameworks draw with it. It currently uses the OpenGL API internally.

Note that the canonical home for this code is in gfx/wr folder of the mozilla-central repository at https://hg.mozilla.org/mozilla-central. The Github repository at https://github.com/servo/webrender should be considered a downstream mirror, although it contains additional metadata (such as Github wiki pages) that do not exist in mozilla-central. Pull requests against the Github repository are still being accepted, although once reviewed, they will be landed on mozilla-central first and then mirrored back. If you are familiar with the mozilla-central contribution workflow, filing bugs in Bugzilla and submitting patches there would be preferred.

Update as a Dependency

After updating shaders in WebRender, go to servo and:

  • Go to the servo directory and do ./mach update-cargo -p webrender
  • Create a pull request to servo

Use WebRender with Servo

To use a local copy of WebRender with servo, go to your servo build directory and:

  • Edit Cargo.toml
  • Add at the end of the file:
[patch."https://github.com/servo/webrender"]
"webrender" = { path = "<path>/webrender" }
"webrender_api" = { path = "<path>/webrender_api" }

where <path> is the path to your local copy of WebRender.

  • Build as normal

Documentation

The Wiki has a few pages describing the internals and conventions of WebRender.

Testing

Tests run using OSMesa to get consistent rendering across platforms.

Still there may be differences depending on font libraries on your system, for example.

See this gist for how to make the text tests useful in Fedora, for example.