gecko-dev/gfx/wr/wrench
Lee Salzman cfb26bdf6f Bug 1792527 - Explicitly bind mip filter for external textures inside WebRender. r=gw
If an external image shows up multiple times while using a different image rendering
setting on each instance, we can erroneously call handler.lock() for each instance in
parallel, thus defaulting to the last image rendering setting supplied for all instances
in that batch.

To work around this, we get rid of the concept of having RenderTextureHosts maintain and
set the image rendering state, which results in a nice simplification. Then, when we go
to actually bind an external image inside WebRender, we set the image rendering state
at that point, so that regardless of how many instances of an external image are locked
simultaneously, we always use the correct image rendering setting for a batch.

Differential Revision: https://phabricator.services.mozilla.com/D158920
2022-10-10 19:23:51 +00:00
..
benchmarks Bug 1778030 - Remove clip_id_stack from wrench r=gfx-reviewers,lsalzman 2022-07-05 20:52:31 +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 1788774 - Remove unused slow subpixel rendering path r=gfx-reviewers,lsalzman 2022-09-01 21:34:17 +00:00
res
script
src Bug 1792527 - Explicitly bind mip filter for external textures inside WebRender. r=gw 2022-10-10 19:23:51 +00:00
.gitignore
Cargo.toml Bug 1772132 - Update Glean and remove cargo metadata replacement. r=janerik,supply-chain-reviewers 2022-07-14 13:11:13 +00:00
README.md
android.txt Bug 1766990 - Redirect stdout and stderr to file for wrench tests on Android. r=gfx-reviewers,nical 2022-05-03 15:37:49 +00:00
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