|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 15-Mar-2021 | - |
| ci-scripts/ | H | 15-Mar-2021 | - | 353 | 257 |
| debugger/ | H | 03-May-2022 | - | 8,219 | 8,167 |
| direct-composition/ | H | 15-Mar-2021 | - | 708 | 566 |
| example-compositor/ | H | 15-Mar-2021 | - | 1,600 | 1,279 |
| examples/ | H | 15-Mar-2021 | - | 3,082 | 2,581 |
| glsl-to-cxx/ | H | 15-Mar-2021 | - | 7,589 | 6,834 |
| peek-poke/ | H | 15-Mar-2021 | - | 1,949 | 1,494 |
| swgl/ | H | 15-Mar-2021 | - | 10,645 | 8,713 |
| tileview/ | H | 15-Mar-2021 | - | 848 | 686 |
| webrender/ | H | 15-Mar-2021 | - | 79,432 | 62,404 |
| webrender_api/ | H | 15-Mar-2021 | - | 9,040 | 6,445 |
| webrender_build/ | H | 15-Mar-2021 | - | 411 | 315 |
| wr_malloc_size_of/ | H | 15-Mar-2021 | - | 677 | 538 |
| wrench/ | H | 03-May-2022 | - | 47,533 | 44,752 |
| .gitignore | H A D | 15-Mar-2021 | 193 | 28 | 21 |
| .taskcluster.yml | H A D | 15-Mar-2021 | 7.4 KiB | 177 | 174 |
| Cargo.lock | H A D | 15-Mar-2021 | 99.8 KiB | 2,227 | 1,996 |
| Cargo.toml | H A D | 15-Mar-2021 | 757 | 26 | 22 |
| LICENSE | H A D | 15-Mar-2021 | 15.3 KiB | 375 | 293 |
| README.md | H A D | 15-Mar-2021 | 2.1 KiB | 54 | 36 |
| rustfmt.toml | H A D | 15-Mar-2021 | 170 | 7 | 6 |
| servo-tidy.toml | H A D | 15-Mar-2021 | 914 | 40 | 36 |
README.md
1# WebRender
2
3[![Version](https://img.shields.io/crates/v/webrender.svg)](https://crates.io/crates/webrender)
4
5WebRender is a GPU-based 2D rendering engine written in [Rust](https://www.rust-lang.org/). [Firefox](https://www.mozilla.org/firefox), the research web browser [Servo](https://github.com/servo/servo), and other GUI frameworks draw with it. It currently uses the OpenGL API internally.
6
7Note that the canonical home for this code is in gfx/wr folder of the
8mozilla-central repository at https://hg.mozilla.org/mozilla-central. The
9Github repository at https://github.com/servo/webrender should be considered
10a downstream mirror, although it contains additional metadata (such as Github
11wiki pages) that do not exist in mozilla-central. Pull requests against the
12Github repository are still being accepted, although once reviewed, they will
13be landed on mozilla-central first and then mirrored back. If you are familiar
14with the mozilla-central contribution workflow, filing bugs in
15[Bugzilla](https://bugzilla.mozilla.org/enter_bug.cgi?product=Core&component=Graphics%3A%20WebRender)
16and submitting patches there would be preferred.
17
18## Update as a Dependency
19After updating shaders in WebRender, go to servo and:
20
21 * Go to the servo directory and do ./mach update-cargo -p webrender
22 * Create a pull request to servo
23
24
25## Use WebRender with Servo
26To use a local copy of WebRender with servo, go to your servo build directory and:
27
28 * Edit Cargo.toml
29 * Add at the end of the file:
30
31```
32[patch."https://github.com/servo/webrender"]
33"webrender" = { path = "<path>/webrender" }
34"webrender_api" = { path = "<path>/webrender_api" }
35```
36
37where `<path>` is the path to your local copy of WebRender.
38
39 * Build as normal
40
41## Documentation
42
43The Wiki has a [few pages](https://github.com/servo/webrender/wiki/) describing the internals and conventions of WebRender.
44
45## Testing
46
47Tests run using OSMesa to get consistent rendering across platforms.
48
49Still there may be differences depending on font libraries on your system, for
50example.
51
52See [this gist](https://gist.github.com/finalfantasia/129cae811e02bf4551ac) for
53how to make the text tests useful in Fedora, for example.
54