impeller::DriverInfoVK Class Reference

Get information about the Vulkan driver. More...

#include <driver_info_vk.h>

Public Member Functions
	DriverInfoVK (const vk::PhysicalDevice &device)
	~DriverInfoVK ()
	DriverInfoVK (const DriverInfoVK &)=delete
DriverInfoVK &	operator= (const DriverInfoVK &)=delete
const Version &	GetAPIVersion () const
	Gets the Vulkan API version. Should be at or above Vulkan 1.1 which is the Impeller baseline. More...
const VendorVK &	GetVendor () const
	Get the vendor of the Vulkan implementation. This is a broad check and includes multiple drivers and platforms. More...
const DeviceTypeVK &	GetDeviceType () const
	Get the device type. Typical use might be to check if the device is a CPU implementation. More...
const std::string &	GetDriverName () const
	Get the self-reported name of the graphics driver. More...
void	DumpToLog () const
	Dumps the current driver info to the log. More...
bool	IsEmulator () const
	Determines if the driver represents an emulator. There is no definitive way to tell if a driver is an emulator and drivers don't self identify as emulators. So take this information with a pinch of salt. More...
bool	IsKnownBadDriver () const
	Determines if the driver has been tested and determined to be non-functional. More...

Detailed Description

Get information about the Vulkan driver.

Warning

Be extremely cautious about the information reported here. This is self-reported information (by the driver) and may be inaccurate and or inconsistent.

Before gating features behind any of the information reported by the driver, consider alternatives (extensions checks perhaps) and try to get a reviewer buddy to convince you to avoid using this.

Definition at line 174 of file driver_info_vk.h.

Constructor & Destructor Documentation

DriverInfoVK() [1/2]

impeller::DriverInfoVK::DriverInfoVK ( const vk::PhysicalDevice &  device )

explicit

Definition at line 241 of file driver_info_vk.cc.

                                                         {
  auto props = device.getProperties();
  api_version_ = Version{VK_API_VERSION_MAJOR(props.apiVersion),
                         VK_API_VERSION_MINOR(props.apiVersion),
                         VK_API_VERSION_PATCH(props.apiVersion)};
  vendor_ = IdentifyVendor(props.vendorID);
  if (vendor_ == VendorVK::kUnknown) {
    FML_LOG(WARNING) << "Unknown GPU Driver Vendor: " << props.vendorID
                     << ". This is not an error.";
  }
  type_ = ToDeviceType(props.deviceType);
  if (props.deviceName.data() != nullptr) {
    driver_name_ = props.deviceName.data();
  }
 
  switch (vendor_) {
    case VendorVK::kQualcomm:
      adreno_gpu_ = GetAdrenoVersion(driver_name_);
      break;
    case VendorVK::kARM:
      mali_gpu_ = GetMaliVersion(driver_name_);
      break;
    default:
      break;
  }
}

References impeller::GetAdrenoVersion(), impeller::GetMaliVersion(), impeller::IdentifyVendor(), impeller::kARM, impeller::kQualcomm, impeller::kUnknown, and impeller::ToDeviceType().

~DriverInfoVK()

impeller::DriverInfoVK::~DriverInfoVK ( )

default

DriverInfoVK() [2/2]

impeller::DriverInfoVK::DriverInfoVK ( const DriverInfoVK &  )

delete

Member Function Documentation

DumpToLog()

void impeller::DriverInfoVK::DumpToLog

(

)

const

Dumps the current driver info to the log.

Definition at line 286 of file driver_info_vk.cc.

                                   {
  std::vector<std::pair<std::string, std::string>> items;
  items.emplace_back("Name", driver_name_);
  items.emplace_back("API Version", api_version_.ToString());
  items.emplace_back("Vendor", VendorToString(vendor_));
  items.emplace_back("Device Type", DeviceTypeToString(type_));
  items.emplace_back("Is Emulator", std::to_string(IsEmulator()));
 
  size_t padding = 0;
 
  for (const auto& item : items) {
    padding = std::max(padding, item.first.size());
  }
 
  padding += 1;
 
  std::stringstream stream;
 
  stream << std::endl;
 
  stream << "--- Driver Information ------------------------------------------";
 
  stream << std::endl;
 
  for (const auto& item : items) {
    stream << "| " << std::setw(static_cast<int>(padding)) << item.first
           << std::setw(0) << ": " << item.second << std::endl;
  }
 
  stream << "-----------------------------------------------------------------";
 
  FML_LOG(IMPORTANT) << stream.str();
}

References impeller::DeviceTypeToString(), IsEmulator(), padding, impeller::Version::ToString(), and impeller::VendorToString().

GetAPIVersion()

const Version & impeller::DriverInfoVK::GetAPIVersion

(

)

const

Gets the Vulkan API version. Should be at or above Vulkan 1.1 which is the Impeller baseline.

Returns

The Vulkan API version.

Definition at line 270 of file driver_info_vk.cc.

                                                 {
  return api_version_;
}

GetDeviceType()

const DeviceTypeVK & impeller::DriverInfoVK::GetDeviceType

(

)

const

Get the device type. Typical use might be to check if the device is a CPU implementation.

Returns

The device type.

Definition at line 278 of file driver_info_vk.cc.

                                                      {
  return type_;
}

GetDriverName()

const std::string & impeller::DriverInfoVK::GetDriverName

(

)

const

Get the self-reported name of the graphics driver.

Returns

The driver name.

Definition at line 282 of file driver_info_vk.cc.

                                                   {
  return driver_name_;
}

GetVendor()

const VendorVK & impeller::DriverInfoVK::GetVendor

(

)

const

Get the vendor of the Vulkan implementation. This is a broad check and includes multiple drivers and platforms.

Returns

The vendor.

Definition at line 274 of file driver_info_vk.cc.

                                              {
  return vendor_;
}

IsEmulator()

bool impeller::DriverInfoVK::IsEmulator

(

)

const

Determines if the driver represents an emulator. There is no definitive way to tell if a driver is an emulator and drivers don't self identify as emulators. So take this information with a pinch of salt.

Returns

True if emulator, False otherwise.

Definition at line 320 of file driver_info_vk.cc.

                                    {
#if FML_OS_ANDROID
  // Google SwiftShader on Android.
  if (type_ == DeviceTypeVK::kCPU && vendor_ == VendorVK::kGoogle &&
      driver_name_.find("SwiftShader") != std::string::npos) {
    return true;
  }
#endif  // FML_OS_ANDROID
  return false;
}

References impeller::kCPU, and impeller::kGoogle.

Referenced by DumpToLog().

IsKnownBadDriver()

bool impeller::DriverInfoVK::IsKnownBadDriver

(

)

const

Determines if the driver has been tested and determined to be non-functional.

If true, context setup should fail such that the device falls back to OpenGLES.

Returns

True if non-functional device, False otherwiise.

Definition at line 331 of file driver_info_vk.cc.

                                          {
  if (adreno_gpu_.has_value()) {
    AdrenoGPU adreno = adreno_gpu_.value();
    // See:
    // https://github.com/flutter/flutter/issues/154103
    //
    // Reports "VK_INCOMPLETE" when compiling certain entity shader with
    // vkCreateGraphicsPipelines, which is not a valid return status.
    // See https://github.com/flutter/flutter/issues/155185 .
    //
    // https://github.com/flutter/flutter/issues/155185
    // Unknown crashes but device is not easily acquirable.
    switch (adreno) {
      case AdrenoGPU::kAdreno640:
      case AdrenoGPU::kAdreno630:
      case AdrenoGPU::kAdreno620:
      case AdrenoGPU::kAdreno619:
      case AdrenoGPU::kAdreno619L:
      case AdrenoGPU::kAdreno618:
      case AdrenoGPU::kAdreno616:
      case AdrenoGPU::kAdreno615:
      case AdrenoGPU::kAdreno613:
      case AdrenoGPU::kAdreno612:
      case AdrenoGPU::kAdreno610:
      case AdrenoGPU::kAdreno608:
      case AdrenoGPU::kAdreno605:
      case AdrenoGPU::kAdreno540:
      case AdrenoGPU::kAdreno530:
      case AdrenoGPU::kAdreno512:
      case AdrenoGPU::kAdreno510:
      case AdrenoGPU::kAdreno509:
      case AdrenoGPU::kAdreno508:
      case AdrenoGPU::kAdreno506:
      case AdrenoGPU::kAdreno505:
      case AdrenoGPU::kAdreno504:
        return true;
      default:
        return false;
    }
  }
  // Disable Maleoon series GPUs, see:
  // https://github.com/flutter/flutter/issues/156623
  if (vendor_ == VendorVK::kHuawei) {
    return true;
  }
  return false;
}

References impeller::kAdreno504, impeller::kAdreno505, impeller::kAdreno506, impeller::kAdreno508, impeller::kAdreno509, impeller::kAdreno510, impeller::kAdreno512, impeller::kAdreno530, impeller::kAdreno540, impeller::kAdreno605, impeller::kAdreno608, impeller::kAdreno610, impeller::kAdreno612, impeller::kAdreno613, impeller::kAdreno615, impeller::kAdreno616, impeller::kAdreno618, impeller::kAdreno619, impeller::kAdreno619L, impeller::kAdreno620, impeller::kAdreno630, impeller::kAdreno640, and impeller::kHuawei.

operator=()

DriverInfoVK& impeller::DriverInfoVK::operator= ( const DriverInfoVK &  )

delete

---

The documentation for this class was generated from the following files:

• impeller/renderer/backend/vulkan/driver_info_vk.h
• impeller/renderer/backend/vulkan/driver_info_vk.cc