KDGpu::Adapter

Module: Public API

Adapter is a representation of a physical hardware device. More...

#include <KDGpu/adapter.h>

Public Functions

	Name
	Adapter() =default
	~Adapter()
	Adapter(Adapter && other)
Adapter &	operator=(Adapter && other)
	Adapter(const Adapter & ) =delete
Adapter &	operator=(const Adapter & ) =delete
Handle< Adapter_t >	handle() const Returns the handle used to retrieve the underlying API specific Adapter.
bool	isValid() const Convenience function to check whether the Adapter is actually referencing a valid API specific resource.
	operator Handle< Adapter_t >() const
std::vector< Extension >	extensions() const
const AdapterProperties &	properties() const Returns the AdapterFeatures supported by the Adapter.
const AdapterFeatures &	features() const Returns the AdapterFeatures supported by the Adapter.
std::span< AdapterQueueType >	queueTypes() const Returns the AdapterQueueType supported by the Adapter.
AdapterSwapchainProperties	swapchainProperties(const Handle< Surface_t > & surface) const Returns the AdapterSwapchainProperties supported for Surfacesurface.
bool	supportsPresentation(const Handle< Surface_t > & surface, uint32_t queueTypeIndex) const Returns whether presentation is supported for surface and queueTypeIndex.
FormatProperties	formatProperties(Format format) const Returns the FormatProperties for Format @format supported by the Adapter.
bool	supportsBlitting(Format srcFormat, TextureTiling srcTiling, Format dstFormat, TextureTiling dstTiling) const
bool	supportsBlitting(Format format, TextureTiling tiling) const
Device	createDevice(const DeviceOptions & options =DeviceOptions()) Create a Device object.

Friends

	Name
class	Instance
class	VulkanGraphicsApi

Detailed Description

class KDGpu::Adapter;

Adapter is a representation of a physical hardware device.

See:

• KDGpu::Instance::createDefaultDevice
• KDGpu::Instance::adapters
• KDGpu::Instance::selectAdapter
• KDGpu::Device

Adapter instances are provided by the Instance. The Adapter is used to query what the underlying physical hardware supports. In turn, a logical Device can be created from the Adapter.

using namespace KDGpu;

Adapter *selectedAdapter = instance.selectAdapter(AdapterDeviceType::Default);
if (!selectedAdapter)
    return;

auto queueTypes = selectedAdapter->queueTypes();
const bool hasGraphicsAndCompute = queueTypes[0].supportsFeature(QueueFlags(QueueFlagBits::GraphicsBit) | QueueFlags(QueueFlagBits::ComputeBit));
const bool supportsPresentation = selectedAdapter->supportsPresentation(surface, 0);

if (!supportsPresentation || !hasGraphicsAndCompute)
    return;
...

Public Functions Documentation

function Adapter

Adapter() =default

function ~Adapter

~Adapter()

function Adapter

Adapter(
    Adapter && other
)

function operator=

Adapter & operator=(
    Adapter && other
)

function Adapter

Adapter(
    const Adapter & 
) =delete

function operator=

Adapter & operator=(
    const Adapter & 
) =delete

function handle

inline Handle< Adapter_t > handle() const

Returns the handle used to retrieve the underlying API specific Adapter.

See: ResourceManager

function isValid

inline bool isValid() const

Convenience function to check whether the Adapter is actually referencing a valid API specific resource.

function operator Handle< Adapter_t >

inline operator Handle< Adapter_t >() const

function extensions

std::vector< Extension > extensions() const

function properties

const AdapterProperties & properties() const

Returns the AdapterFeatures supported by the Adapter.

function features

const AdapterFeatures & features() const

Returns the AdapterFeatures supported by the Adapter.

function queueTypes

std::span< AdapterQueueType > queueTypes() const

Returns the AdapterQueueType supported by the Adapter.

function swapchainProperties

AdapterSwapchainProperties swapchainProperties(
    const Handle< Surface_t > & surface
) const

Returns the AdapterSwapchainProperties supported for Surfacesurface.

function supportsPresentation

bool supportsPresentation(
    const Handle< Surface_t > & surface,
    uint32_t queueTypeIndex
) const

Returns whether presentation is supported for surface and queueTypeIndex.

function formatProperties

FormatProperties formatProperties(
    Format format
) const

Returns the FormatProperties for Format @format supported by the Adapter.

function supportsBlitting

bool supportsBlitting(
    Format srcFormat,
    TextureTiling srcTiling,
    Format dstFormat,
    TextureTiling dstTiling
) const

function supportsBlitting

bool supportsBlitting(
    Format format,
    TextureTiling tiling
) const

function createDevice

Device createDevice(
    const DeviceOptions & options =DeviceOptions()
)

Create a Device object.

Parameters:

• options

Return: Device

Friends

friend Instance

friend class Instance(
    Instance 
);

friend VulkanGraphicsApi

friend class VulkanGraphicsApi(
    VulkanGraphicsApi 
);

---

Updated on 2024-09-08 at 00:13:10 +0000