557728d4ad
This patch shouldn't have any functional effect. It's motivated by some changes needed to implement clip masks in pixel local storage, but these are also general improvements that stand alone. Specifically: - Remove clip_task_index from the global PrimitiveHeader struct. In most cases, the clip task is supplied in the BrushInstance structure, so it makes no sense to have this as a common field, where it is generally unused. Instead, there is now an extra 'user data' field available in the PrimitiveHeader. Non-brush shaders (text_run and split_composite) use that extra field to store the clip task address, while the brush shaders gain an extra (currently unused) user data field. - In turn, this means there is no need to unconditionally try and retrieve the first clip task address for a primitive during batching. This was previously used to initialize the PrimitiveHeader structure. Differential Revision: https://phabricator.services.mozilla.com/D24312 --HG-- extra : moz-landing-system : lando |
||
---|---|---|
.. | ||
ci-scripts | ||
debugger | ||
direct-composition | ||
examples | ||
webrender | ||
webrender_api | ||
webrender_build | ||
wr_malloc_size_of | ||
wrench | ||
.gitignore | ||
.taskcluster.yml | ||
appveyor.yml | ||
Cargo.lock | ||
Cargo.toml | ||
LICENSE | ||
README.md | ||
rustfmt.toml | ||
servo-tidy.toml |
WebRender
GPU renderer for the Web content, used by Servo.
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.