capabilities.cc

Go to the documentation of this file.

// Copyright 2013 The Flutter Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
 
#include "impeller/renderer/capabilities.h"
#include "impeller/core/formats.h"
 
namespace impeller {
 
Capabilities::Capabilities() = default;
 
Capabilities::~Capabilities() = default;
 
size_t Capabilities::GetMinimumStorageBufferAlignment() const {
  return GetMinimumUniformAlignment();
}
 
class StandardCapabilities final : public Capabilities {
 public:
  // |Capabilities|
  ~StandardCapabilities() override = default;
 
  // |Capabilities|
  bool SupportsOffscreenMSAA() const override {
    return supports_offscreen_msaa_;
  }
 
  // |Capabilities|
  bool SupportsImplicitResolvingMSAA() const override { return false; }
 
  // |Capabilities|
  bool SupportsSSBO() const override { return supports_ssbo_; }
 
  // |Capabilities|
  bool SupportsTextureToTextureBlits() const override {
    return supports_texture_to_texture_blits_;
  }
 
  // |Capabilities|
  bool SupportsFramebufferFetch() const override {
    return supports_framebuffer_fetch_;
  }
 
  // |Capabilities|
  bool SupportsCompute() const override { return supports_compute_; }
 
  // |Capabilities|
  bool SupportsComputeSubgroups() const override {
    return supports_compute_subgroups_;
  }
 
  // |Capabilities|
  bool SupportsReadFromResolve() const override {
    return supports_read_from_resolve_;
  }
 
  // |Capabilities|
  bool SupportsDecalSamplerAddressMode() const override {
    return supports_decal_sampler_address_mode_;
  }
 
  // |Capabilities|
  bool SupportsTriangleFan() const override { return supports_triangle_fan_; }
 
  // |Capabilities|
  PixelFormat GetDefaultColorFormat() const override {
    return default_color_format_;
  }
 
  // |Capabilities|
  PixelFormat GetDefaultStencilFormat() const override {
    return default_stencil_format_;
  }
 
  // |Capabilities|
  PixelFormat GetDefaultDepthStencilFormat() const override {
    return default_depth_stencil_format_;
  }
 
  // |Capabilities|
  bool SupportsDeviceTransientTextures() const override {
    return supports_device_transient_textures_;
  }
 
  // |Capabilities|
  PixelFormat GetDefaultGlyphAtlasFormat() const override {
    return default_glyph_atlas_format_;
  }
 
  // |Capabilities|
  ISize GetMaximumRenderPassAttachmentSize() const override {
    return default_maximum_render_pass_attachment_size_;
  }
 
  // |Capabilities|
  bool SupportsPrimitiveRestart() const override { return true; }
 
  // |Capabilities|
  bool Supports32BitPrimitiveIndices() const override { return true; }
 
  // |Capabilities|
  bool SupportsManuallyMippedTextures() const override { return true; }
 
  // |Capabilities|
  bool SupportsExtendedRangeFormats() const override {
    return supports_extended_range_formats_;
  }
 
  // |Capabilities|
  bool SupportsFramebufferRenderMipmap() const override { return true; }
 
  // |Capabilities|
  bool SupportsTextureCompression(
      CompressedTextureFamily family) const override {
    switch (family) {
      case CompressedTextureFamily::kBC:
        return supports_texture_compression_bc_;
      case CompressedTextureFamily::kETC2:
        return supports_texture_compression_etc2_;
      case CompressedTextureFamily::kASTC:
        return supports_texture_compression_astc_;
      case CompressedTextureFamily::kASTCHDR:
        return supports_texture_compression_astc_hdr_;
    }
    return false;
  }
 
  // |Capabilities|
  uint32_t GetMaxSamplerAnisotropy() const override {
    return max_sampler_anisotropy_;
  }
 
  // |Capabilities|
  size_t GetMinimumUniformAlignment() const override {
    return minimum_uniform_alignment_;
  }
 
  // |Capabilities|
  bool NeedsPartitionedHostBuffer() const override {
    return needs_partitioned_host_buffer_;
  }
 
 private:
  StandardCapabilities(bool supports_offscreen_msaa,
                       bool supports_ssbo,
                       bool supports_texture_to_texture_blits,
                       bool supports_framebuffer_fetch,
                       bool supports_compute,
                       bool supports_compute_subgroups,
                       bool supports_read_from_resolve,
                       bool supports_decal_sampler_address_mode,
                       bool supports_device_transient_textures,
                       bool supports_triangle_fan,
                       bool supports_extended_range_formats,
                       PixelFormat default_color_format,
                       PixelFormat default_stencil_format,
                       PixelFormat default_depth_stencil_format,
                       PixelFormat default_glyph_atlas_format,
                       ISize default_maximum_render_pass_attachment_size,
                       uint32_t max_sampler_anisotropy,
                       size_t minimum_uniform_alignment,
                       bool needs_partitioned_host_buffer,
                       bool supports_texture_compression_bc,
                       bool supports_texture_compression_etc2,
                       bool supports_texture_compression_astc,
                       bool supports_texture_compression_astc_hdr)
      : supports_offscreen_msaa_(supports_offscreen_msaa),
        supports_ssbo_(supports_ssbo),
        supports_texture_to_texture_blits_(supports_texture_to_texture_blits),
        supports_framebuffer_fetch_(supports_framebuffer_fetch),
        supports_compute_(supports_compute),
        supports_compute_subgroups_(supports_compute_subgroups),
        supports_read_from_resolve_(supports_read_from_resolve),
        supports_decal_sampler_address_mode_(
            supports_decal_sampler_address_mode),
        supports_device_transient_textures_(supports_device_transient_textures),
        supports_triangle_fan_(supports_triangle_fan),
        supports_extended_range_formats_(supports_extended_range_formats),
        needs_partitioned_host_buffer_(needs_partitioned_host_buffer),
        default_color_format_(default_color_format),
        default_stencil_format_(default_stencil_format),
        default_depth_stencil_format_(default_depth_stencil_format),
        default_glyph_atlas_format_(default_glyph_atlas_format),
        default_maximum_render_pass_attachment_size_(
            default_maximum_render_pass_attachment_size),
        max_sampler_anisotropy_(max_sampler_anisotropy),
        minimum_uniform_alignment_(minimum_uniform_alignment),
        supports_texture_compression_bc_(supports_texture_compression_bc),
        supports_texture_compression_etc2_(supports_texture_compression_etc2),
        supports_texture_compression_astc_(supports_texture_compression_astc),
        supports_texture_compression_astc_hdr_(
            supports_texture_compression_astc_hdr) {}
 
  friend class CapabilitiesBuilder;
 
  bool supports_offscreen_msaa_ = false;
  bool supports_ssbo_ = false;
  bool supports_texture_to_texture_blits_ = false;
  bool supports_framebuffer_fetch_ = false;
  bool supports_compute_ = false;
  bool supports_compute_subgroups_ = false;
  bool supports_read_from_resolve_ = false;
  bool supports_decal_sampler_address_mode_ = false;
  bool supports_device_transient_textures_ = false;
  bool supports_triangle_fan_ = false;
  bool supports_extended_range_formats_ = false;
  bool needs_partitioned_host_buffer_ = false;
  PixelFormat default_color_format_ = PixelFormat::kUnknown;
  PixelFormat default_stencil_format_ = PixelFormat::kUnknown;
  PixelFormat default_depth_stencil_format_ = PixelFormat::kUnknown;
  PixelFormat default_glyph_atlas_format_ = PixelFormat::kUnknown;
  ISize default_maximum_render_pass_attachment_size_ = ISize(1, 1);
  uint32_t max_sampler_anisotropy_ = 1;
  size_t minimum_uniform_alignment_ = 256;
  bool supports_texture_compression_bc_ = false;
  bool supports_texture_compression_etc2_ = false;
  bool supports_texture_compression_astc_ = false;
  bool supports_texture_compression_astc_hdr_ = false;
 
  StandardCapabilities(const StandardCapabilities&) = delete;
 
  StandardCapabilities& operator=(const StandardCapabilities&) = delete;
};
 
CapabilitiesBuilder::CapabilitiesBuilder() = default;
 
CapabilitiesBuilder::~CapabilitiesBuilder() = default;
 
CapabilitiesBuilder& CapabilitiesBuilder::SetSupportsOffscreenMSAA(bool value) {
  supports_offscreen_msaa_ = value;
  return *this;
}
 
CapabilitiesBuilder& CapabilitiesBuilder::SetSupportsSSBO(bool value) {
  supports_ssbo_ = value;
  return *this;
}
 
CapabilitiesBuilder& CapabilitiesBuilder::SetSupportsTextureToTextureBlits(
    bool value) {
  supports_texture_to_texture_blits_ = value;
  return *this;
}
 
CapabilitiesBuilder& CapabilitiesBuilder::SetSupportsFramebufferFetch(
    bool value) {
  supports_framebuffer_fetch_ = value;
  return *this;
}
 
CapabilitiesBuilder& CapabilitiesBuilder::SetSupportsCompute(bool value) {
  supports_compute_ = value;
  return *this;
}
 
CapabilitiesBuilder& CapabilitiesBuilder::SetSupportsComputeSubgroups(
    bool value) {
  supports_compute_subgroups_ = value;
  return *this;
}
 
CapabilitiesBuilder& CapabilitiesBuilder::SetDefaultColorFormat(
    PixelFormat value) {
  default_color_format_ = value;
  return *this;
}
 
CapabilitiesBuilder& CapabilitiesBuilder::SetDefaultStencilFormat(
    PixelFormat value) {
  default_stencil_format_ = value;
  return *this;
}
 
CapabilitiesBuilder& CapabilitiesBuilder::SetDefaultDepthStencilFormat(
    PixelFormat value) {
  default_depth_stencil_format_ = value;
  return *this;
}
 
CapabilitiesBuilder& CapabilitiesBuilder::SetSupportsReadFromResolve(
    bool read_from_resolve) {
  supports_read_from_resolve_ = read_from_resolve;
  return *this;
}
 
CapabilitiesBuilder& CapabilitiesBuilder::SetSupportsDecalSamplerAddressMode(
    bool value) {
  supports_decal_sampler_address_mode_ = value;
  return *this;
}
 
CapabilitiesBuilder& CapabilitiesBuilder::SetSupportsDeviceTransientTextures(
    bool value) {
  supports_device_transient_textures_ = value;
  return *this;
}
 
CapabilitiesBuilder& CapabilitiesBuilder::SetDefaultGlyphAtlasFormat(
    PixelFormat value) {
  default_glyph_atlas_format_ = value;
  return *this;
}
 
CapabilitiesBuilder& CapabilitiesBuilder::SetSupportsTriangleFan(bool value) {
  supports_triangle_fan_ = value;
  return *this;
}
 
CapabilitiesBuilder& CapabilitiesBuilder::SetMaximumRenderPassAttachmentSize(
    ISize size) {
  default_maximum_render_pass_attachment_size_ = size;
  return *this;
}
 
CapabilitiesBuilder& CapabilitiesBuilder::SetSupportsExtendedRangeFormats(
    bool value) {
  supports_extended_range_formats_ = value;
  return *this;
}
 
CapabilitiesBuilder& CapabilitiesBuilder::SetSupportsTextureCompression(
    CompressedTextureFamily family,
    bool value) {
  switch (family) {
    case CompressedTextureFamily::kBC:
      supports_texture_compression_bc_ = value;
      break;
    case CompressedTextureFamily::kETC2:
      supports_texture_compression_etc2_ = value;
      break;
    case CompressedTextureFamily::kASTC:
      supports_texture_compression_astc_ = value;
      break;
    case CompressedTextureFamily::kASTCHDR:
      supports_texture_compression_astc_hdr_ = value;
      break;
  }
  return *this;
}
 
CapabilitiesBuilder& CapabilitiesBuilder::SetMaxSamplerAnisotropy(
    uint32_t value) {
  max_sampler_anisotropy_ = value;
  return *this;
}
 
CapabilitiesBuilder& CapabilitiesBuilder::SetMinimumUniformAlignment(
    size_t value) {
  minimum_uniform_alignment_ = value;
  return *this;
}
 
CapabilitiesBuilder& CapabilitiesBuilder::SetNeedsPartitionedHostBuffer(
    bool value) {
  needs_partitioned_host_buffer_ = value;
  return *this;
}
 
std::unique_ptr<Capabilities> CapabilitiesBuilder::Build() {
  // NOLINTNEXTLINE(clang-analyzer-cplusplus.NewDeleteLeaks)
  return std::unique_ptr<StandardCapabilities>(new StandardCapabilities(   //
      supports_offscreen_msaa_,                                            //
      supports_ssbo_,                                                      //
      supports_texture_to_texture_blits_,                                  //
      supports_framebuffer_fetch_,                                         //
      supports_compute_,                                                   //
      supports_compute_subgroups_,                                         //
      supports_read_from_resolve_,                                         //
      supports_decal_sampler_address_mode_,                                //
      supports_device_transient_textures_,                                 //
      supports_triangle_fan_,                                              //
      supports_extended_range_formats_,                                    //
      default_color_format_.value_or(PixelFormat::kUnknown),               //
      default_stencil_format_.value_or(PixelFormat::kUnknown),             //
      default_depth_stencil_format_.value_or(PixelFormat::kUnknown),       //
      default_glyph_atlas_format_.value_or(PixelFormat::kUnknown),         //
      default_maximum_render_pass_attachment_size_.value_or(ISize{1, 1}),  //
      max_sampler_anisotropy_,                                             //
      minimum_uniform_alignment_,                                          //
      needs_partitioned_host_buffer_,                                      //
      supports_texture_compression_bc_,                                    //
      supports_texture_compression_etc2_,                                  //
      supports_texture_compression_astc_,                                  //
      supports_texture_compression_astc_hdr_                               //
      ));
}
 
}  // namespace impeller