kc3-lang/angle/src/libANGLE/renderer/metal/DisplayMtl.h

• Show log

  Commit

• Hash : ff64d2c7
  Author :
  Date : 2021-08-06T21:24:09
  

  Choose direct-to-Metal translator through a feature.
  
  Define directMetalGeneration in FeaturesMtl.h. If
  ANGLE_ENABLE_METAL_SPIRV is defined to 1 (still the default),
  directMetalGeneration defaults to false. It can be overridden via the
  standard ANGLE mechanism:
    ANGLE_FEATURE_OVERRIDES_ENABLED=directMetalGeneration
  
  It can also be overridden by instantiating angle_end2end_tests with
  the directives:
    WithDirectMetalGeneration(ES2_METAL())
    WithDirectMetalGeneration(ES3_METAL())
  
  These directives aren't working properly yet though. The
  direct-to-Metal compiler is instantiated, but the _DirectMetalGen
  versions of the tests fail. They pass when switching the Metal
  backend's default behavior using the above environment variable. This
  will be debugged in follow-on CLs.
  
  Thanks to syoussefi@ for the prototype of this CL:
  https://chromium-review.googlesource.com/3076129
  
  Bug: angleproject:5505
  Change-Id: I188ab89abc75bf89c5ed2d90102af311feaa1960
  Reviewed-on: https://chromium-review.googlesource.com/c/angle/angle/+/3079083
  Reviewed-by: Jamie Madill <jmadill@chromium.org>
  Reviewed-by: Shahbaz Youssefi <syoussefi@chromium.org>
  Commit-Queue: Kenneth Russell <kbr@chromium.org>
  

Download

• src/libANGLE/renderer/metal/DisplayMtl.h

• //
  // Copyright 2019 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.
  //
  // DisplayMtl.h:
  //    Defines the class interface for DisplayMtl, implementing DisplayImpl.
  //
  
  #ifndef LIBANGLE_RENDERER_METAL_DISPLAYMTL_H_
  #define LIBANGLE_RENDERER_METAL_DISPLAYMTL_H_
  
  #include "common/PackedEnums.h"
  #include "libANGLE/angletypes.h"
  #include "libANGLE/renderer/DisplayImpl.h"
  #include "libANGLE/renderer/metal/mtl_command_buffer.h"
  #include "libANGLE/renderer/metal/mtl_format_utils.h"
  #include "libANGLE/renderer/metal/mtl_render_utils.h"
  #include "libANGLE/renderer/metal/mtl_state_cache.h"
  #include "libANGLE/renderer/metal/mtl_utils.h"
  #include "platform/FeaturesMtl.h"
  
  namespace egl
  {
  class Surface;
  }
  
  namespace rx
  {
  class ShareGroupMtl : public ShareGroupImpl
  {};
  
  class ContextMtl;
  
  struct DefaultShaderAsyncInfoMtl;
  
  class DisplayMtl : public DisplayImpl
  {
    public:
      DisplayMtl(const egl::DisplayState &state);
      ~DisplayMtl() override;
  
      egl::Error initialize(egl::Display *display) override;
      void terminate() override;
  
      bool testDeviceLost() override;
      egl::Error restoreLostDevice(const egl::Display *display) override;
  
      std::string getRendererDescription() override;
      std::string getVendorString() override;
      std::string getVersionString() override;
  
      DeviceImpl *createDevice() override;
  
      egl::Error waitClient(const gl::Context *context) override;
      egl::Error waitNative(const gl::Context *context, EGLint engine) override;
  
      SurfaceImpl *createWindowSurface(const egl::SurfaceState &state,
                                       EGLNativeWindowType window,
                                       const egl::AttributeMap &attribs) override;
      SurfaceImpl *createPbufferSurface(const egl::SurfaceState &state,
                                        const egl::AttributeMap &attribs) override;
      SurfaceImpl *createPbufferFromClientBuffer(const egl::SurfaceState &state,
                                                 EGLenum buftype,
                                                 EGLClientBuffer clientBuffer,
                                                 const egl::AttributeMap &attribs) override;
      SurfaceImpl *createPixmapSurface(const egl::SurfaceState &state,
                                       NativePixmapType nativePixmap,
                                       const egl::AttributeMap &attribs) override;
  
      ImageImpl *createImage(const egl::ImageState &state,
                             const gl::Context *context,
                             EGLenum target,
                             const egl::AttributeMap &attribs) override;
  
      ContextImpl *createContext(const gl::State &state,
                                 gl::ErrorSet *errorSet,
                                 const egl::Config *configuration,
                                 const gl::Context *shareContext,
                                 const egl::AttributeMap &attribs) override;
  
      StreamProducerImpl *createStreamProducerD3DTexture(egl::Stream::ConsumerType consumerType,
                                                         const egl::AttributeMap &attribs) override;
  
      ShareGroupImpl *createShareGroup() override;
  
      ExternalImageSiblingImpl *createExternalImageSibling(const gl::Context *context,
                                                           EGLenum target,
                                                           EGLClientBuffer buffer,
                                                           const egl::AttributeMap &attribs) override;
      gl::Version getMaxSupportedESVersion() const override;
      gl::Version getMaxConformantESVersion() const override;
  
      EGLSyncImpl *createSync(const egl::AttributeMap &attribs) override;
  
      egl::Error makeCurrent(egl::Display *display,
                             egl::Surface *drawSurface,
                             egl::Surface *readSurface,
                             gl::Context *context) override;
  
      void populateFeatureList(angle::FeatureList *features) override;
  
      bool isValidNativeWindow(EGLNativeWindowType window) const override;
  
      egl::Error validateClientBuffer(const egl::Config *configuration,
                                      EGLenum buftype,
                                      EGLClientBuffer clientBuffer,
                                      const egl::AttributeMap &attribs) const override;
  
      egl::Error validateImageClientBuffer(const gl::Context *context,
                                           EGLenum target,
                                           EGLClientBuffer clientBuffer,
                                           const egl::AttributeMap &attribs) const override;
  
      egl::ConfigSet generateConfigs() override;
  
      gl::Caps getNativeCaps() const;
      const gl::TextureCapsMap &getNativeTextureCaps() const;
      const gl::Extensions &getNativeExtensions() const;
      const gl::Limitations &getNativeLimitations() const;
      const angle::FeaturesMtl &getFeatures() const { return mFeatures; }
  
      // Check whether either of the specified iOS or Mac GPU family is supported
      bool supportsEitherGPUFamily(uint8_t iOSFamily, uint8_t macFamily) const;
      bool supportsAppleGPUFamily(uint8_t iOSFamily) const;
      bool supportsMacGPUFamily(uint8_t macFamily) const;
      bool isAMD() const;
      bool isIntel() const;
      bool isNVIDIA() const;
  
      id<MTLDevice> getMetalDevice() const { return mMetalDevice; }
  
      mtl::CommandQueue &cmdQueue() { return mCmdQueue; }
      const mtl::FormatTable &getFormatTable() const { return mFormatTable; }
      mtl::RenderUtils &getUtils() { return mUtils; }
      mtl::StateCache &getStateCache() { return mStateCache; }
  
      id<MTLLibrary> getDefaultShadersLib();
  
      id<MTLDepthStencilState> getDepthStencilState(const mtl::DepthStencilDesc &desc)
      {
          return mStateCache.getDepthStencilState(getMetalDevice(), desc);
      }
      id<MTLSamplerState> getSamplerState(const mtl::SamplerDesc &desc)
      {
          return mStateCache.getSamplerState(getMetalDevice(), desc);
      }
  
      const mtl::Format &getPixelFormat(angle::FormatID angleFormatId) const
      {
          return mFormatTable.getPixelFormat(angleFormatId);
      }
      const mtl::FormatCaps &getNativeFormatCaps(MTLPixelFormat mtlFormat) const
      {
          return mFormatTable.getNativeFormatCaps(mtlFormat);
      }
  
      // See mtl::FormatTable::getVertexFormat()
      const mtl::VertexFormat &getVertexFormat(angle::FormatID angleFormatId,
                                               bool tightlyPacked) const
      {
          return mFormatTable.getVertexFormat(angleFormatId, tightlyPacked);
      }
  #if ANGLE_MTL_EVENT_AVAILABLE
      mtl::AutoObjCObj<MTLSharedEventListener> getOrCreateSharedEventListener();
  #endif
  
      bool useDirectToMetalCompiler();
  
    protected:
      void generateExtensions(egl::DisplayExtensions *outExtensions) const override;
      void generateCaps(egl::Caps *outCaps) const override;
  
    private:
      angle::Result initializeImpl(egl::Display *display);
      void ensureCapsInitialized() const;
      void initializeCaps() const;
      void initializeExtensions() const;
      void initializeTextureCaps() const;
      void initializeFeatures();
      void initializeLimitations();
      id<MTLDevice> getMetalDeviceMatchingAttribute(const egl::AttributeMap &attribs);
      angle::Result initializeShaderLibrary();
  
      mtl::AutoObjCPtr<id<MTLDevice>> mMetalDevice = nil;
      uint32_t mMetalDeviceVendorId                = 0;
  
      mtl::CommandQueue mCmdQueue;
  
      mutable mtl::FormatTable mFormatTable;
      mtl::StateCache mStateCache;
      mtl::RenderUtils mUtils;
  
      // Built-in Shaders
      std::shared_ptr<DefaultShaderAsyncInfoMtl> mDefaultShadersAsyncInfo;
  #if ANGLE_MTL_EVENT_AVAILABLE
      mtl::AutoObjCObj<MTLSharedEventListener> mSharedEventListener;
  #endif
  
      mutable bool mCapsInitialized;
      mutable gl::TextureCapsMap mNativeTextureCaps;
      mutable gl::Extensions mNativeExtensions;
      mutable gl::Caps mNativeCaps;
      mutable gl::Limitations mNativeLimitations;
  
      angle::FeaturesMtl mFeatures;
  };
  
  }  // namespace rx
  
  #endif /* LIBANGLE_RENDERER_METAL_DISPLAYMTL_H_ */
  

Download