Google Git
Sign in
fuchsia / garnet / refs/heads/sandbox/garratt/video_display / . / public / lib / escher
tree: 075241a7f4c386529b1da6e464e4b5c9de43326b [path history] [tgz]
  1. base/
  2. build_linux/
  3. flib/
  4. geometry/
  5. hmd/
  6. impl/
  7. material/
  8. math/
  9. profiling/
  10. renderer/
  11. resources/
  12. scene/
  13. scripts/
  14. shape/
  15. test/
  16. third_party/
  17. util/
  18. vk/
  19. BUILD.gn
  20. escher.cc
  21. escher.h
  22. escher_process_init.cc
  23. escher_process_init.h
  24. forward_declarations.h
  25. README.md
  26. status.h
public/lib/escher/README.md

Escher

Escher is a physically based renderer.

Features

  • Volumetric soft shadows
  • Color bleeding
  • Light diffusion
  • Lens effect

Building for Fuchsia

Escher is part of the default Fuchsia build. The “waterfall” demo is installed as system/bin/waterfall.

Building for Linux

Escher can also build on Linux. In order to do so, you need to:

  • add the Jiri “escher_linux_dev” manifest, then Jiri update
    cd $FUCHSIA_DIR
jiri import escher_linux_dev https://fuchsia.googlesource.com/manifest
jiri update
  • install build dependencies
    sudo apt install libxinerama-dev libxrandr-dev libxcursor-dev libx11-xcb-dev libx11-dev mesa_common_dev
  • install a GPU driver that supports Vulkan
  • install the LunarG Vulkan SDK (installed into third_party/vulkansdk when Escher is pulled down by jiri as a part of Fuchsia)
  • set the VULKAN_SDK, VK_LAYER_PATH, and LD_LIBRARY_PATH environment variables, e.g.:
    export VULKAN_SDK=$FUCHSIA_DIR/garnet/public/lib/escher/third_party/vulkansdk/x86_64
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$VULKAN_SDK/lib
export VK_LAYER_PATH=$VULKAN_SDK/etc/explicit_layer.d
  • specify that you want to build only the Escher module, for Linux:
    cd $FUCHSIA_DIR
fx set x86-64 --release --packages garnet/packages/escher_linux,garnet/packages/cobalt_client
    • See $FUCHSIA_DIR/docs/getting_source.md for how to set up the fx tool.
    • There may be a spurious error regarding skia_use_sfntly; ignore it.
    • cobalt_client shouldn't be necessary; it only is due to a bug where the build system expects there to be a non-empty system image.
    • NOTE!! These commands may conflict with the Vulkan SDK on your LD_LIBRARY_PATH. It is probably best to run these commands in one terminal window, then switch to another and setting LD_LIBRARY_PATH before Building and running.
  • Do this once only: fx full-build
    • Note: you can exit via Ctrl-C once Zircon is finished building.
  • BUILD!! AND RUN!!!
    buildtools/ninja -C out/release-x86-64/ && out/release-x86-64/host_x64/waterfall