mirror of https://github.com/mozilla/gecko-dev.git synced 2024-12-03 02:25:34 +00:00

History

Solomon Chiu 26f860a4a3 Bug 1667939 - Make the picture tile size configurable via pref. r=gw Differential Revision: https://phabricator.services.mozilla.com/D91759		2020-10-02 10:38:45 +00:00
..
ci-scripts	Bug 1665371 - Switch WR reftests to llvmpipe and update the expectations r=gw,kats	2020-09-25 19:54:32 +00:00
debugger
direct-composition
example-compositor
examples
glsl-to-cxx	Bug 1664282 - Use span buffering for SWGL depth testing. r=jimb	2020-09-22 23:23:10 +00:00
peek-poke
swgl	Bug 1666119 - Clip the last band to the dest bounds at remaining callsites. r=jrmuizel	2020-09-29 03:00:52 +00:00
tileview
webrender	Bug 1667939 - Make the picture tile size configurable via pref. r=gw	2020-10-02 10:38:45 +00:00
webrender_api
webrender_build	Bug 1665274 - Speed up brush_opacity. r=lsalzman	2020-10-01 13:13:30 +00:00
wr_malloc_size_of
wrench	Bug 1665371 - Switch WR reftests to llvmpipe and update the expectations r=gw,kats	2020-09-25 19:54:32 +00:00
.gitignore
.taskcluster.yml	Bug 1665371 - Follow-up to bump docker image for github CI. r=kvark	2020-09-28 13:16:44 +00:00
Cargo.lock	Bug 1665371 - Switch WR reftests to llvmpipe and update the expectations r=gw,kats	2020-09-25 19:54:32 +00:00
Cargo.toml
LICENSE
README.md
rustfmt.toml
servo-tidy.toml

README.md

WebRender

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.