Google Git
Sign in
fuchsia / garnet / 721263348a3f9308473a4284e511fd2c8c914f45 / . / public / lib / escher
tree: 6151fdd3008220f457fffa35b123a750182d9ef1 [path history] [tgz]
  1. base/
  2. build_linux/
  3. flib/
  4. fs/
  5. geometry/
  6. hmd/
  7. impl/
  8. material/
  9. math/
  10. meta/
  11. profiling/
  12. renderer/
  13. resources/
  14. scene/
  15. scripts/
  16. shaders/
  17. shape/
  18. test/
  19. third_party/
  20. util/
  21. vk/
  22. BUILD.gn
  23. escher.cc
  24. escher.h
  25. escher_process_init.cc
  26. escher_process_init.h
  27. forward_declarations.h
  28. MAINTAINERS
  29. README.md
  30. 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
    • as part of the jiri update, Escher will download a private copy of the Vulkan SDK to $FUCHSIA_DIR/garnet/public/lib/escher/third_party/vulkansdk/
  • 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
    • NVIDIA: version >= 367.35
      sudo apt install nvidia-driver
    • Intel: Mesa >= 12.0
      sudo apt install mesa-vulkan-drivers
  • set the 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 x64  --packages garnet/packages/experimental/examples_escher_linux,garnet/packages/experimental/tests_escher_linux
    • See $FUCHSIA_DIR/docs/getting_source.md for how to set up the fx tool.
  • Do this once only:
    fx full-build
  • BUILD!! AND RUN!!!
    buildtools/ninja -C out/release-x64/ && out/release-x64/host_x64/waterfall