gecko-dev/gfx/webrender_bindings
alwu efe35b01d5 Bug 1771011 - part2 : wrap media engine's dcomp handle, and use it on our gfx pipeline in the GPU process.r=jolin,sotaro
In this patch, we ask the media engine to return a handle for shareable
dcomp surface, which will then be packaged into a new texture data type
and being shared with the GPU process via the video bridge.

DcompSurfaceImage is the image which contains the handle texture data,
which doesn't support being accessed in the content process. When the
compositor uploads the image to the GPU process, the corresponding
texture host will be created.

The render texture host will be created by that texture host, and it
will be used in DCLayerTree. In DCLayerTree, we create a new type of
surface for our dcomp handle. DCSurfaceHandle will ask the render
texture host to reconstruct the surface by the handle shared from the
remote process (the handle is actually duplicated to the parent process
first due to the sandbox policy, and then be duplicated to the GPU
process later)

DCSurfaceHandle will attach that surface to its visual in order to
display the video frame directly. In the whole process, it's not
possible for Gecko to access any decoded video data which is protected by the
media engine itself.

Depends on D149941

Differential Revision: https://phabricator.services.mozilla.com/D151019
2022-08-13 23:48:07 +00:00
..
src Bug 1690244 - Move WebRender initialization code out of renderer.rs. r=kvark 2022-08-12 07:30:14 +00:00
Cargo.toml Bug 1776096 - Bump WebRender crate versions. r=jrmuizel 2022-06-24 04:11:26 +00:00
DCLayerTree.cpp Bug 1771011 - part2 : wrap media engine's dcomp handle, and use it on our gfx pipeline in the GPU process.r=jolin,sotaro 2022-08-13 23:48:07 +00:00
DCLayerTree.h Bug 1771011 - part2 : wrap media engine's dcomp handle, and use it on our gfx pipeline in the GPU process.r=jolin,sotaro 2022-08-13 23:48:07 +00:00
Moz2DImageRenderer.cpp Bug 1726118 - Prefix all webrender debug prefs with gfx.webrender.debug. r=gfx-reviewers,jrmuizel 2021-09-01 17:08:36 +00:00
README.webrender
RenderAndroidHardwareBufferTextureHost.cpp Bug 1731980 - Ensure SurfaceTextures with transforms get rendered at correct size. r=gfx-reviewers,lsalzman 2022-04-25 16:47:51 +00:00
RenderAndroidHardwareBufferTextureHost.h
RenderAndroidSurfaceTextureHost.cpp Bug 1731980 - Ensure SurfaceTextures with transforms get rendered at correct size. r=gfx-reviewers,lsalzman 2022-04-25 16:47:51 +00:00
RenderAndroidSurfaceTextureHost.h Bug 1731980 - Ensure SurfaceTextures with transforms get rendered at correct size. r=gfx-reviewers,lsalzman 2022-04-25 16:47:51 +00:00
RenderBufferTextureHost.cpp Bug 1757111 - Report cropped YCbCr sizes in RenderExternalTextureHost. r=jrmuizel 2022-02-26 21:12:35 +00:00
RenderBufferTextureHost.h Bug 1459526 - Handle full-range video in Webrender. r=gw,lsalzman 2021-06-25 19:16:22 +00:00
RenderCompositor.cpp Bug 1731136 Part 1: Extend compositor to manage backdrop surfaces. r=gw 2022-06-01 19:40:02 +00:00
RenderCompositor.h Backed out changeset 48381173c92c (bug 1780315) for causing bug 1782764. CLOSED TREE 2022-08-03 13:43:39 +03:00
RenderCompositorANGLE.cpp Bug 1766561 - Add missing l modifier for HRESULT formatting. r=media-playback-reviewers,gfx-reviewers,nika,necko-reviewers,rkraesig,alwu,kershaw 2022-05-03 20:49:07 +00:00
RenderCompositorANGLE.h Bug 1740675 - Cleanup device handling around RenderThread r=nical,gfx-reviewers 2021-11-25 02:49:29 +00:00
RenderCompositorD3D11SWGL.cpp Bug 1744666 - Remove CompositorD3D11::mUseForSoftwareWebRender r=gfx-reviewers,lsalzman 2021-12-07 07:34:00 +00:00
RenderCompositorD3D11SWGL.h
RenderCompositorEGL.cpp Bug 1775480 - Log number of total and active renderers when EGL surface creation fails. r=gfx-reviewers,aosmond 2022-06-27 14:13:26 +00:00
RenderCompositorEGL.h Bug 1740675 - Cleanup device handling around RenderThread r=nical,gfx-reviewers 2021-11-25 02:49:29 +00:00
RenderCompositorLayersSWGL.cpp Backed out changeset 48381173c92c (bug 1780315) for causing bug 1782764. CLOSED TREE 2022-08-03 13:43:39 +03:00
RenderCompositorLayersSWGL.h Backed out changeset 48381173c92c (bug 1780315) for causing bug 1782764. CLOSED TREE 2022-08-03 13:43:39 +03:00
RenderCompositorNative.cpp Backed out changeset 48381173c92c (bug 1780315) for causing bug 1782764. CLOSED TREE 2022-08-03 13:43:39 +03:00
RenderCompositorNative.h Backed out changeset 48381173c92c (bug 1780315) for causing bug 1782764. CLOSED TREE 2022-08-03 13:43:39 +03:00
RenderCompositorOGL.cpp Bug 1727511 - Add mozlog around WebRenderBridgeParent and RenderThread r=gfx-reviewers,jrmuizel,aosmond 2021-09-01 22:27:15 +00:00
RenderCompositorOGL.h
RenderCompositorOGLSWGL.cpp Bug 1775480 - Log number of total and active renderers when EGL surface creation fails. r=gfx-reviewers,aosmond 2022-06-27 14:13:26 +00:00
RenderCompositorOGLSWGL.h Bug 1741156 - Initial GPU process implementation on Android. r=aosmond,agi 2021-11-29 20:52:31 +00:00
RenderCompositorRecordedFrame.h
RenderCompositorSWGL.cpp Bug 1727511 - Add mozlog around WebRenderBridgeParent and RenderThread r=gfx-reviewers,jrmuizel,aosmond 2021-09-01 22:27:15 +00:00
RenderCompositorSWGL.h Bug 1719367 - Hook up default clear color to RenderCompositorLayersSWGL. r=sotaro 2021-07-08 11:46:37 +00:00
RenderD3D11TextureHost.cpp Backed out 9 changesets (bug 1771374) for causing mochitest-webgl failures. CLOSED TREE 2022-08-02 03:38:09 +03:00
RenderD3D11TextureHost.h Backed out 9 changesets (bug 1771374) for causing mochitest-webgl failures. CLOSED TREE 2022-08-02 03:38:09 +03:00
RenderDMABUFTextureHost.cpp Bug 1731980 - Ensure SurfaceTextures with transforms get rendered at correct size. r=gfx-reviewers,lsalzman 2022-04-25 16:47:51 +00:00
RenderDMABUFTextureHost.h
RenderDcompSurfaceTextureHost.cpp Bug 1771011 - part2 : wrap media engine's dcomp handle, and use it on our gfx pipeline in the GPU process.r=jolin,sotaro 2022-08-13 23:48:07 +00:00
RenderDcompSurfaceTextureHost.h Bug 1771011 - part2 : wrap media engine's dcomp handle, and use it on our gfx pipeline in the GPU process.r=jolin,sotaro 2022-08-13 23:48:07 +00:00
RenderEGLImageTextureHost.cpp Bug 1731980 - Ensure SurfaceTextures with transforms get rendered at correct size. r=gfx-reviewers,lsalzman 2022-04-25 16:47:51 +00:00
RenderEGLImageTextureHost.h
RenderExternalTextureHost.cpp Bug 1731980 - Ensure SurfaceTextures with transforms get rendered at correct size. r=gfx-reviewers,lsalzman 2022-04-25 16:47:51 +00:00
RenderExternalTextureHost.h Bug 1459526 - Handle full-range video in Webrender. r=gw,lsalzman 2021-06-25 19:16:22 +00:00
RenderMacIOSurfaceTextureHost.cpp Bug 1731980 - Ensure SurfaceTextures with transforms get rendered at correct size. r=gfx-reviewers,lsalzman 2022-04-25 16:47:51 +00:00
RenderMacIOSurfaceTextureHost.h Bug 1459526 - Handle full-range video in Webrender. r=gw,lsalzman 2021-06-25 19:16:22 +00:00
RenderSharedSurfaceTextureHost.cpp Bug 1739454 - Don't allow write-mapping of SourceSurfaceSharedData after Finalize. r=aosmond 2021-11-19 18:46:47 +00:00
RenderSharedSurfaceTextureHost.h
RenderTextureHost.cpp Backed out 9 changesets (bug 1771374) for causing mochitest-webgl failures. CLOSED TREE 2022-08-02 03:38:09 +03:00
RenderTextureHost.h Bug 1771011 - part2 : wrap media engine's dcomp handle, and use it on our gfx pipeline in the GPU process.r=jolin,sotaro 2022-08-13 23:48:07 +00:00
RenderTextureHostSWGL.cpp Bug 1731980 - Ensure SurfaceTextures with transforms get rendered at correct size. r=gfx-reviewers,lsalzman 2022-04-25 16:47:51 +00:00
RenderTextureHostSWGL.h Bug 1459526 - Handle full-range video in Webrender. r=gw,lsalzman 2021-06-25 19:16:22 +00:00
RenderTextureHostWrapper.cpp Bug 1771011 - part2 : wrap media engine's dcomp handle, and use it on our gfx pipeline in the GPU process.r=jolin,sotaro 2022-08-13 23:48:07 +00:00
RenderTextureHostWrapper.h Bug 1771011 - part2 : wrap media engine's dcomp handle, and use it on our gfx pipeline in the GPU process.r=jolin,sotaro 2022-08-13 23:48:07 +00:00
RenderThread.cpp Bug 1780788 - Use abstract strings as in-arguments for ipdl. r=nika,necko-reviewers,media-playback-reviewers,alwu,dragana 2022-07-25 20:19:48 +00:00
RenderThread.h Bug 1780788 - Use abstract strings as in-arguments for ipdl. r=nika,necko-reviewers,media-playback-reviewers,alwu,dragana 2022-07-25 20:19:48 +00:00
RendererOGL.cpp Backed out changeset 48381173c92c (bug 1780315) for causing bug 1782764. CLOSED TREE 2022-08-03 13:43:39 +03:00
RendererOGL.h Backed out changeset 48381173c92c (bug 1780315) for causing bug 1782764. CLOSED TREE 2022-08-03 13:43:39 +03:00
RendererScreenshotGrabber.cpp Backed out changeset 48381173c92c (bug 1780315) for causing bug 1782764. CLOSED TREE 2022-08-03 13:43:39 +03:00
RendererScreenshotGrabber.h Backed out changeset 48381173c92c (bug 1780315) for causing bug 1782764. CLOSED TREE 2022-08-03 13:43:39 +03:00
WebRenderAPI.cpp Bug 1780788 - Use abstract strings as in-arguments for ipdl. r=nika,necko-reviewers,media-playback-reviewers,alwu,dragana 2022-07-25 20:19:48 +00:00
WebRenderAPI.h Bug 1780788 - Use abstract strings as in-arguments for ipdl. r=nika,necko-reviewers,media-playback-reviewers,alwu,dragana 2022-07-25 20:19:48 +00:00
WebRenderTypes.cpp Bug 856337 - Implement image-rendering: smooth and image-rendering: pixelated. r=jrmuizel,dholbert,longsonr 2021-09-03 08:56:43 +00:00
WebRenderTypes.h Bug 1769900 - Add more logs of window size sanity check around nsWindow r=gfx-reviewers,lsalzman 2022-05-18 15:15:41 +00:00
cbindgen.toml Bug 1711648 - Move all device rects to the Box2D representations. r=jrmuizel 2021-06-02 12:47:03 +00:00
moz.build Bug 1771011 - part2 : wrap media engine's dcomp handle, and use it on our gfx pipeline in the GPU process.r=jolin,sotaro 2022-08-13 23:48:07 +00:00
rustfmt.toml
webrender_ffi.h Bug 1773491 - Partially back out bug 1773359 since Solaris also defines this constant. DONTBUILD 2022-06-09 16:35:00 +02:00

README.webrender

To build and run WebRender in Gecko:
1. Install Rust if you don't have it already
   If you are doing gecko builds already, you should already have Rust as it is a build requirement.
   If not, you can install it using |mach bootstrap| (recommended) or from https://www.rust-lang.org/
       Note: If installing manually, use the stable 64-bit release - on Windows make sure to use the MSVC ABI installer.
   Ensure that rustc and cargo are in your $PATH (adding $HOME/.cargo/bin/ should be sufficient)
2. Build using |mach build|.
   You don't need anything special in your mozconfig for local builds; webrender will be built by default.
3. Run with |MOZ_WEBRENDER=1| in your environment. e.g. |MOZ_WEBRENDER=1 ./mach run|.
   Alternatively, you can set the gfx.webrender.enabled pref to true (browser restart required).
   Note that on Linux, acceleration is disabled by default and it needs to be enabled for WebRender to work.
   On Linux you can enable acceleration by putting |MOZ_ACCELERATED=1| in your environment, or setting layers.acceleration.force-enabled to true in about:config.
4. Verify WebRender is enabled. You can do this by going to about:support and checking the "Compositing" line in the Graphics section. It should say "WebRender".
   There should also be a WebRender section under "Decision Log" in about:support, which will provide some more detail on what caused it to be enabled/disabled.

When making changes:
    - Make the changes you want.
    - Run |mach build| or |mach build binaries| as desired.

For a debug webrender build:
    Use a debug mozconfig (ac_add_options --enable-debug)
    You can also use an opt build but make webrender less optimized by putting opt-level=0 in the [profile.release] section of your toolkit/library/rust/Cargo.toml file
    See also https://groups.google.com/forum/#!topic/mozilla.dev.servo/MbeMcqqO1fs