gecko-dev/gfx/wr/wrench
Glenn Watson 601f48038d Bug 1734346 - Support backdrops with simple rounded-rect clip cases. r=gfx-reviewers,nical
This allows picture slice backdrops to be supported when they contain
rounded-rect clip(s) that are in the same coordinate system as the
primitive. This is the common case, and allows subpixel AA to be
used in bookmark menu and other popups that are part of the current
Gecko UI.

Differential Revision: https://phabricator.services.mozilla.com/D128156
2021-10-12 23:38:23 +00:00
..
benchmarks
examples
invalidation
reftests Bug 1734346 - Support backdrops with simple rounded-rect clip cases. r=gfx-reviewers,nical 2021-10-12 23:38:23 +00:00
res
script
src Bug 1734282 - Remove some unused scroll frame APIs and code r=gfx-reviewers,jrmuizel 2021-10-06 06:43:03 +00:00
.gitignore
Cargo.toml Bug 1728064 - Add test to ensure shaders don't contain flat scalar varyings on android. r=gfx-reviewers,kvark 2021-09-06 13:56:58 +00:00
README.md
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