EncodingContext: Use a Status enum to handle the various states.

Following the logic of what's happening in EncodingContext was difficult
as there was a mix of booleans, mTopLevelEncoder != nullptr and implicit
handling of when EncodingContext was used for an error encoder.

Introduce a status enum with the invariant that
(mStatus == Open) == (mToplevelEncoder != nullptr) to keep the fast
check for ValidateCanEncodeOn (renamed from CheckCurrentEncoder).

Adds a constructor for EncodingContext with the ErrorTag that's used in
the error constructors of CommandEncoder and RenderBundleEncoder.

Removes dawn_unittests expliclty calling EncodingContext::Destroy at
random times which forced more complex handling than necessary
(Destroy is called only in the top level encoder's DestroyImpl or in
~EncodingContext).

Slightly simplify the handling of the acquisition of the CommandIterator
as it can only be done once, and can always go through AcquireCommands.

Fixup a couple tests for the functional change that now starting a pass
on an error CommandEncoder will emit a device error instead of silently
failing.

Bug: 355308275
Change-Id: I5536f17da10b157c2924372ff499387743e0a485
Reviewed-on: https://dawn-review.googlesource.com/c/dawn/+/200135
Reviewed-by: Brandon Jones <bajones@chromium.org>
Reviewed-by: Loko Kung <lokokung@google.com>
Commit-Queue: Corentin Wallez <cwallez@chromium.org>
8 files changed
tree: 4b32575c073f2096fe151102793e3a672da89768
  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. .bazelrc
  15. .clang-format
  16. .clang-tidy
  17. .gitattributes
  18. .gitignore
  19. .gitmodules
  20. .gn
  21. AUTHORS
  22. BUILD.bazel
  23. BUILD.gn
  24. CMakeLists.txt
  25. CMakeSettings.json
  26. CODE_OF_CONDUCT.md
  27. codereview.settings
  28. CONTRIBUTING.md
  29. CPPLINT.cfg
  30. DEPS
  31. DIR_METADATA
  32. go.mod
  33. go.sum
  34. go_presubmit_support.py
  35. LICENSE
  36. OWNERS
  37. PRESUBMIT.py
  38. README.chromium
  39. README.md
  40. 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.