gecko-dev/gfx/wr/wrench
Jeff Muizelaar 348522399d Bug 1680118 - Update to mozangle 0.3.2. r=kvark
Differential Revision: https://phabricator.services.mozilla.com/D98379
2020-12-02 01:46:58 +00:00
..
benchmarks Bug 1656711. Support hardware accelerated <feGaussianBlur> SVG filters if the x and y radius are not equal with webrender. r=gw 2020-08-25 07:26:21 +00:00
examples
invalidation Bug 1675414 - Fix incorrect skipping of composites in some cases. r=nical 2020-11-17 19:24:16 +00:00
reftests Bug 1678192 - add wrench test for clipped yuv image. r=jrmuizel 2020-11-19 23:38:52 +00:00
res
script Bug 1665371 - Switch WR reftests to llvmpipe and update the expectations r=gw,kats 2020-09-25 19:54:32 +00:00
src Bug 1678711 - Make running with --software without the "software" feature panic. r=lsalzman 2020-11-27 14:51:19 +00:00
.gitignore
Cargo.toml Bug 1680118 - Update to mozangle 0.3.2. r=kvark 2020-12-02 01:46:58 +00:00
README.md Bug 1661408 - Update the README. r=gw 2020-08-27 19:58:34 +00:00
android.txt
build.rs

README.md

wrench

wrench is a tool for debugging webrender outside of a browser engine.

Build

Build wrench with cargo build --release within the wrench directory.

headless

wrench has an optional headless mode for use in continuous integration. To run in headless mode, instead of using cargo run -- args, use ./headless.py args.

show

If you are working on gecko integration you can capture a frame via the following steps.

  • Visit about:support and check that the "Compositing" value in the "Graphics" table says "WebRender". Enable gfx.webrender.all in about:config if necessary to enable WebRender.
  • Hit ctrl-shift-3 to capture the frame. The data will be put in ~/wr-capture.
  • View the capture with wrench show ~/wr-capture.

reftest

Wrench also has a reftest system for catching regressions.

  • To run all reftests, run script/headless.py reftest
  • To run specific reftests, run script/headless.py reftest path/to/test/or/dir
  • To examine test failures, use the reftest analyzer
  • To add a new reftest, create an example frame and a reference frame in reftests/ and then add an entry to reftests/reftest.list