Google Git
Sign in
dawn / dawn / b3acbb992945314db24e3062ad70ae1f0d740273
commitb3acbb992945314db24e3062ad70ae1f0d740273[log] [tgz]
authorCorentin Wallez <cwallez@chromium.org>Thu Jun 27 18:06:41 2024 +0000
committerDawn LUCI CQ <dawn-scoped@luci-project-accounts.iam.gserviceaccount.com>Thu Jun 27 18:06:41 2024 +0000
treee33dfd80b2ef58e05db921ac2f5521fe3084d7af
parent4431e54d1f80867890e340d89c4cd7584f5a0653 [diff]
GL: Add support for wgpu::Surface.

This adds a dawn::native::opengl::SwapChainEGL object that uses
EGLSurfaces under the hood. Due to how special the default framebuffer
is in OpenGL (you can draw Y-flipped to it as the sole attachment or
with depth-stencil, or blit to it), rendering is done "offscreen" and
blitted with Y-flip on Present().

ContextEGL gains a "MakeSurfaceCurrentScope" method that helps make sure
a surface is always present even as opengl::Device::GetGL/EGL keeps
doing calls to MakeCurrent.

DisplayEGL gains a ChooseConfig method to help choose EGL configs for
the swapchain (and later will be used for context creation).

Many improvements are possible to this implementation:

 - Supporting rendering directly to the default framebuffer when it is
   RenderAttachment only and the sole attachment of render passes. (will
   require adding a Y-flip uniform to every vertex shader).
 - Supporting rendering directly to the default framebuffer when used
   with a depth-stencil attachment that's discarded as EGLConfig can
   contain depth-stencil.
 - Support for SRGB swapchains with EGL_KHR_gl_colorspace.
 - Support for more than the hardcoded RGBA8Unorm formats with
   EGL_KHR_no_config_context.
 - Dynamic support for wayland and x11 with EGL_EXT_platform_base and
   friends.

Bug: 344814083
Change-Id: I64f3bb5d314acea87f472eaa78dff06deeb4ff3d
Reviewed-on: https://dawn-review.googlesource.com/c/dawn/+/191142
Reviewed-by: Stephen White <senorblanco@chromium.org>
Commit-Queue: Corentin Wallez <cwallez@chromium.org>
11 files changed
tree: e33dfd80b2ef58e05db921ac2f5521fe3084d7af
  1. .github/
  2. .vscode/
  3. build_overrides/
  4. docs/
  5. generator/
  6. include/
  7. infra/
  8. scripts/
  9. src/
  10. test/
  11. third_party/
  12. tools/
  13. webgpu-cts/
  14. build
  15. buildtools
  16. testing
  17. .bazelrc
  18. .clang-format
  19. .clang-tidy
  20. .gitattributes
  21. .gitignore
  22. .gitmodules
  23. .gn
  24. AUTHORS
  25. BUILD.bazel
  26. BUILD.gn
  27. CMakeLists.txt
  28. CMakeSettings.json
  29. CODE_OF_CONDUCT.md
  30. codereview.settings
  31. CONTRIBUTING.md
  32. CPPLINT.cfg
  33. DEPS
  34. DIR_METADATA
  35. go.mod
  36. go.sum
  37. go_presubmit_support.py
  38. LICENSE
  39. OWNERS
  40. PRESUBMIT.py
  41. README.chromium
  42. README.md
  43. WORKSPACE.bazel
README.md

Build Status Matrix Space

Dawn, a WebGPU implementation

Dawn is an open-source and cross-platform implementation of the WebGPU standard. More precisely it implements webgpu.h that is a one-to-one mapping with the WebGPU IDL. Dawn is meant to be integrated as part of a larger system and is the underlying implementation of WebGPU in Chromium.

Dawn provides several WebGPU building blocks:

  • WebGPU C/C++ headers that applications and other building blocks use.
    • The webgpu.h version that Dawn implements.
    • A C++ wrapper for the webgpu.h.
  • A “native” implementation of WebGPU using platforms' GPU APIs: D3D12, Metal, Vulkan and OpenGL. See per API support for more details.
  • A client-server implementation of WebGPU for applications that are in a sandbox without access to native drivers
  • Tint is a compiler for the WebGPU Shader Language (WGSL) that can be used in standalone to convert shaders from and to WGSL.

Helpful links:

Documentation table of content

Developer documentation:

User documentation: (TODO, figure out what overlaps with the webgpu.h docs)

License

BSD 3-Clause License, please see LICENSE.

Disclaimer

This is not an officially supported Google product.