kc3-lang/angle/src/libANGLE/renderer/wgpu/wgpu_format_utils.h

• Show log

  Commit

• Hash : 3cf7a604
  Author :
  Date : 2025-05-17T19:39:08
  

  WebGPU: Add extensions for importing external textures
  
  Add EGL_ANGLE_device_webgpu which exposes the adapter and device used
  by ANGLE internally.
  
  Add EGL_ANGLE_webgpu_texture_client_buffer which allows importing
  external WGPUTexture handles if they share the same device as ANGLE
  (queried from EGL_ANGLE_device_webgpu).
  
  Bug: angleproject:418022112
  Change-Id: I0683d36b84a0f8e0e9b68a5ec0d3aa8b7a95152c
  Reviewed-on: https://chromium-review.googlesource.com/c/angle/angle/+/6553063
  Reviewed-by: Corentin Wallez <cwallez@chromium.org>
  Commit-Queue: Geoff Lang <geofflang@chromium.org>
  

Download

• src/libANGLE/renderer/wgpu/wgpu_format_utils.h

• //
  // Copyright 2024 The ANGLE Project Authors. All rights reserved.
  // Use of this source code is governed by a BSD-style license that can be
  // found in the LICENSE file.
  //
  // wgpu_format_utils:
  //   Helper for WebGPU format code.
  
  #ifndef LIBANGLE_RENDERER_WGPU_WGPU_FORMAT_UTILS_H_
  #define LIBANGLE_RENDERER_WGPU_WGPU_FORMAT_UTILS_H_
  
  #include <webgpu/webgpu.h>
  
  #include "libANGLE/formatutils.h"
  #include "libANGLE/renderer/Format.h"
  #include "libANGLE/renderer/copyvertex.h"
  
  namespace rx
  {
  namespace webgpu
  {
  
  struct ImageFormatInitInfo final
  {
      angle::FormatID format;
      InitializeTextureDataFunction initializer;
  };
  
  struct BufferFormatInitInfo final
  {
      angle::FormatID format;
      VertexCopyFunction VertexLoadFunction;
      bool VertexLoadRequiresConversion;
  };
  
  WGPUTextureFormat GetWgpuTextureFormatFromFormatID(angle::FormatID formatID);
  angle::FormatID GetFormatIDFromWgpuTextureFormat(WGPUTextureFormat wgpuFormat);
  WGPUVertexFormat GetWgpuVertexFormatFromFormatID(angle::FormatID formatID);
  angle::FormatID GetFormatIDFromWgpuBufferFormat(WGPUVertexFormat wgpuFormat);
  
  // Describes a WebGPU format. WebGPU has separate formats for images and vertex buffers, this class
  // describes both.
  class Format final : private angle::NonCopyable
  {
    public:
      Format();
  
      bool valid() const { return mIntendedGLFormat != 0; }
  
      // The intended format is the front-end format. For Textures this usually correponds to a
      // GLenum in the headers. Buffer formats don't always have a corresponding GLenum type.
      // Some Surface formats and unsized types also don't have a corresponding GLenum.
      angle::FormatID getIntendedFormatID() const { return mIntendedFormatID; }
      const angle::Format &getIntendedFormat() const { return angle::Format::Get(mIntendedFormatID); }
  
      // The actual Image format is used to implement the front-end format for Texture/Renderbuffers.
      const angle::Format &getActualImageFormat() const
      {
          return angle::Format::Get(getActualImageFormatID());
      }
  
      LoadImageFunctionInfo getTextureLoadFunction(GLenum type) const
      {
          return mTextureLoadFunctions(type);
      }
  
      WGPUTextureFormat getActualWgpuTextureFormat() const
      {
          return GetWgpuTextureFormatFromFormatID(mActualImageFormatID);
      }
      angle::FormatID getActualImageFormatID() const { return mActualImageFormatID; }
  
      WGPUVertexFormat getActualWgpuVertexFormat() const
      {
          return GetWgpuVertexFormatFromFormatID(mActualBufferFormatID);
      }
      angle::FormatID getActualVertexFormatID() const { return mActualBufferFormatID; }
  
      // The actual Buffer format is used to implement the front-end format for Buffers.  This format
      // is used by vertex buffers as well as texture buffers.
      const angle::Format &getActualBufferFormat() const
      {
          return angle::Format::Get(mActualBufferFormatID);
      }
  
      bool vertexLoadRequiresConversion() const { return mVertexLoadRequiresConversion; }
      VertexCopyFunction getVertexLoadFunction() const { return mVertexLoadFunction; }
  
      // |intendedGLFormat| always correponds to a valid GLenum type. For types that don't have a
      // corresponding GLenum we do our best to specify a GLenum that is "close".
      const gl::InternalFormat &getInternalFormatInfo(GLenum type) const
      {
          return gl::GetInternalFormatInfo(mIntendedGLFormat, type);
      }
  
    private:
      friend class FormatTable;
      // This is an auto-generated method in vk_format_table_autogen.cpp.
      void initialize(const angle::Format &intendedAngleFormat);
  
      // These are used in the format table init.
      void initImageFallback(const ImageFormatInitInfo *info, int numInfo);
  
      void initBufferFallback(const BufferFormatInitInfo *fallbackInfo, int numInfo);
  
      angle::FormatID mIntendedFormatID;
      GLenum mIntendedGLFormat;
      angle::FormatID mActualImageFormatID;
      angle::FormatID mActualBufferFormatID;
  
      InitializeTextureDataFunction mImageInitializerFunction;
      LoadFunctionMap mTextureLoadFunctions;
      VertexCopyFunction mVertexLoadFunction;
  
      bool mVertexLoadRequiresConversion;
      bool mIsRenderable;
  };
  
  bool operator==(const Format &lhs, const Format &rhs);
  bool operator!=(const Format &lhs, const Format &rhs);
  
  class FormatTable final : angle::NonCopyable
  {
    public:
      FormatTable();
      ~FormatTable();
  
      void initialize();
  
      ANGLE_INLINE const Format &operator[](GLenum internalFormat) const
      {
          angle::FormatID formatID = angle::Format::InternalFormatToID(internalFormat);
          return mFormatData[static_cast<size_t>(formatID)];
      }
  
      ANGLE_INLINE const Format &operator[](angle::FormatID formatID) const
      {
          return mFormatData[static_cast<size_t>(formatID)];
      }
  
      const Format *findClosestTextureFormat(WGPUTextureFormat wgpuFormat) const;
  
    private:
      // The table data is indexed by angle::FormatID.
      std::array<Format, angle::kNumANGLEFormats> mFormatData;
  };
  }  // namespace webgpu
  }  // namespace rx
  
  #endif  // LIBANGLE_RENDERER_WGPU_WGPU_FORMAT_UTILS_H_
  

Download