gecko-dev/gfx/webrender_bindings
Markus Stange daf06d791b Bug 1565668 - Add back-pressure to WebRender+OGL by implementing RenderCompositorOGL::WaitForGPU(). r=sotaro
Without CoreAnimation, back-pressure was applied by SwapBuffers: On a
double-buffered NSOpenGLContext which is bound to an NSView, [context flushBuffer]
waits for the previous frame to be finished. With CoreAnimation, the context
is no longer bound to an NSView, and SwapBuffers acts as a regular glFlush.
glFlush on its own does not prevent overproduction.

If we submit GPU work at a faster rate than the GPU can handle, we end up
delaying the window server's GPU work. This can cause the window server to skip
frames. So even if Gecko can produce frames at 60FPS, the window server might
only present those frames at 30FPS, skipping every second frame.

Differential Revision: https://phabricator.services.mozilla.com/D26412

--HG--
extra : moz-landing-system : lando
2019-07-17 20:46:39 +00:00
..
src Bug 1565904. Move the blob metadata from image space to an absolute space. r=nical 2019-07-15 15:24:54 +00:00
Cargo.toml Bug 1554401 - Part 1: Update dwrote to 0.9. r=emilio 2019-05-25 17:08:40 +00:00
Moz2DImageRenderer.cpp Bug 1519636 - Fix some conflicts r=bustage . CLOSED TREE 2019-07-16 10:04:55 +02:00
README.webrender Bug 1563311 - Remove uses of MOZ_BUILD_WEBRENDER. r=aosmond 2019-07-05 11:05:17 +00:00
RenderAndroidSurfaceTextureHostOGL.cpp Bug 1533296 - Make WebRender error as to Fallback to Compositor rendering during disabling WebRender on android r=nical 2019-06-19 16:14:56 +00:00
RenderAndroidSurfaceTextureHostOGL.h Bug 1544642 - Do not bind SurfaceTexture of video to gl context if it is used by WebGL r=nical 2019-04-26 07:48:54 +00:00
RenderBufferTextureHost.cpp Bug 1511181 - Reformat everything to the Google coding style r=ehsan a=clang-format 2018-11-30 11:46:48 +01:00
RenderBufferTextureHost.h Bug 1511181 - Reformat everything to the Google coding style r=ehsan a=clang-format 2018-11-30 11:46:48 +01:00
RenderCompositor.cpp Bug 1563432 - Remove ID3D11Device::GetDeviceRemovedReason() call from RenderCompositorANGLE::BeginFrame() r=nical 2019-07-11 09:41:38 +00:00
RenderCompositor.h Bug 1563432 - Remove ID3D11Device::GetDeviceRemovedReason() call from RenderCompositorANGLE::BeginFrame() r=nical 2019-07-11 09:41:38 +00:00
RenderCompositorANGLE.cpp Bug 1563432 - Remove ID3D11Device::GetDeviceRemovedReason() call from RenderCompositorANGLE::BeginFrame() r=nical 2019-07-11 09:41:38 +00:00
RenderCompositorANGLE.h Bug 1563432 - Remove ID3D11Device::GetDeviceRemovedReason() call from RenderCompositorANGLE::BeginFrame() r=nical 2019-07-11 09:41:38 +00:00
RenderCompositorEGL.cpp Bug 1563432 - Remove ID3D11Device::GetDeviceRemovedReason() call from RenderCompositorANGLE::BeginFrame() r=nical 2019-07-11 09:41:38 +00:00
RenderCompositorEGL.h Bug 1563432 - Remove ID3D11Device::GetDeviceRemovedReason() call from RenderCompositorANGLE::BeginFrame() r=nical 2019-07-11 09:41:38 +00:00
RenderCompositorOGL.cpp Bug 1565668 - Add back-pressure to WebRender+OGL by implementing RenderCompositorOGL::WaitForGPU(). r=sotaro 2019-07-17 20:46:39 +00:00
RenderCompositorOGL.h Bug 1565668 - Add back-pressure to WebRender+OGL by implementing RenderCompositorOGL::WaitForGPU(). r=sotaro 2019-07-17 20:46:39 +00:00
RenderD3D11TextureHostOGL.cpp Bug 1559524 - Reduce calls to GLLibraryEGL::Get(). r=lsalzman 2019-06-15 05:21:12 +00:00
RenderD3D11TextureHostOGL.h Bug 1540581 - P6. Tidy some C++ declarations in gfx/. r=gerald,jrmuizel 2019-04-11 12:36:51 +00:00
RenderEGLImageTextureHost.cpp Bug 1559524 - Reduce calls to GLLibraryEGL::Get(). r=lsalzman 2019-06-15 05:21:12 +00:00
RenderEGLImageTextureHost.h Bug 1540581 - P6. Tidy some C++ declarations in gfx/. r=gerald,jrmuizel 2019-04-11 12:36:51 +00:00
RenderMacIOSurfaceTextureHostOGL.cpp Bug 1511181 - Reformat everything to the Google coding style r=ehsan a=clang-format 2018-11-30 11:46:48 +01:00
RenderMacIOSurfaceTextureHostOGL.h Bug 1540581 - P6. Tidy some C++ declarations in gfx/. r=gerald,jrmuizel 2019-04-11 12:36:51 +00:00
RenderSharedSurfaceTextureHost.cpp Bug 1511181 - Reformat everything to the Google coding style r=ehsan a=clang-format 2018-11-30 11:46:48 +01:00
RenderSharedSurfaceTextureHost.h Bug 1540581 - P6. Tidy some C++ declarations in gfx/. r=gerald,jrmuizel 2019-04-11 12:36:51 +00:00
RenderTextureHost.cpp Bug 1529870 - Add handling of single buffer mode android SurfaceTexture r=nical 2019-04-03 22:05:27 +00:00
RenderTextureHost.h Bug 1544642 - Do not bind SurfaceTexture of video to gl context if it is used by WebGL r=nical 2019-04-26 07:48:54 +00:00
RenderTextureHostOGL.cpp Bug 1511181 - Reformat everything to the Google coding style r=ehsan a=clang-format 2018-11-30 11:46:48 +01:00
RenderTextureHostOGL.h Bug 1511181 - Reformat everything to the Google coding style r=ehsan a=clang-format 2018-11-30 11:46:48 +01:00
RenderTextureHostWrapper.cpp Bug 1526213 - Enable WebRenderTextureHostWrapper for canvas r=nical 2019-02-18 09:33:32 +00:00
RenderTextureHostWrapper.h Bug 1540581 - P6. Tidy some C++ declarations in gfx/. r=gerald,jrmuizel 2019-04-11 12:36:51 +00:00
RenderThread.cpp No bug - clang-format dom/canvas, gfx/[gl,layers,webrender_bindings]. 2019-07-11 15:36:44 -07:00
RenderThread.h Bug 1557208 - Deallocate thread pool handles during RenderThread sync shutdown. r=sotaro 2019-07-01 17:24:32 +02:00
RendererOGL.cpp Bug 1563432 - Remove ID3D11Device::GetDeviceRemovedReason() call from RenderCompositorANGLE::BeginFrame() r=nical 2019-07-11 09:41:38 +00:00
RendererOGL.h Bug 1533296 - Make WebRender error as to Fallback to Compositor rendering during disabling WebRender on android r=nical 2019-06-19 16:14:56 +00:00
RendererScreenshotGrabber.cpp Bug 1562642 - Part 2 - Add missing MPL2 headers r=Gijs 2019-07-08 09:27:47 +00:00
RendererScreenshotGrabber.h Bug 1547472 - Ref count the ProfilerScreenshots structure r=gerald,jesup 2019-05-24 23:53:28 +00:00
WebRenderAPI.cpp Backed out 3 changesets (bug 1547351) for assertion failures on a CLOSED TREE 2019-07-15 17:47:40 +03:00
WebRenderAPI.h Backed out 3 changesets (bug 1547351) for assertion failures on a CLOSED TREE 2019-07-15 17:47:40 +03:00
WebRenderTypes.cpp Bug 1441308 - Core renderroot splitting changes r=kats,sotaro 2019-03-22 18:28:42 +00:00
WebRenderTypes.h Bug 1564720 - Fallback from WebRender when EGLSurface creation failed in RenderCompositorEGL::BeginFrame() r=nical 2019-07-10 11:14:40 +00:00
cbindgen.toml Bug 1563311 - Remove uses of MOZ_BUILD_WEBRENDER. r=aosmond 2019-07-05 11:05:17 +00:00
moz.build Bug 1532201 - Enable SurfaceFactory_EGLImage usage with WebRender r=nical 2019-04-02 03:16:20 +00:00
rustfmt.toml
webrender_ffi.h Bug 1563311 - Remove uses of MOZ_BUILD_WEBRENDER. r=aosmond 2019-07-05 11:05:17 +00: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