"Fossies" - the Fresh Open Source Software Archive

Member "firefox-69.0.1/gfx/webrender_bindings/README.webrender" (17 Sep 2019, 1871 Bytes) of package /linux/www/firefox-69.0.1.source.tar.xz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the last Fossies "Diffs" side-by-side code changes report for "README.webrender": 68.0.2_vs_69.0.

    1 To build and run WebRender in Gecko:
    2 1. Install Rust if you don't have it already
    3    If you are doing gecko builds already, you should already have Rust as it is a build requirement.
    4    If not, you can install it using |mach bootstrap| (recommended) or from https://www.rust-lang.org/
    5        Note: If installing manually, use the stable 64-bit release - on Windows make sure to use the MSVC ABI installer.
    6    Ensure that rustc and cargo are in your $PATH (adding $HOME/.cargo/bin/ should be sufficient)
    7 2. Build using |mach build|.
    8    You don't need anything special in your mozconfig for local builds; webrender will be built by default.
    9 3. Run with |MOZ_WEBRENDER=1| in your environment. e.g. |MOZ_WEBRENDER=1 ./mach run|.
   10    Alternatively, you can set the gfx.webrender.enabled pref to true (browser restart required).
   11    Note that on Linux, acceleration is disabled by default and it needs to be enabled for WebRender to work.
   12    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.
   13 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".
   14    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.
   15 
   16 When making changes:
   17     - Make the changes you want.
   18     - Run |mach build| or |mach build binaries| as desired.
   19 
   20 For a debug webrender build:
   21     Use a debug mozconfig (ac_add_options --enable-debug)
   22     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
   23     See also https://groups.google.com/forum/#!topic/mozilla.dev.servo/MbeMcqqO1fs