#include <IDevice.h>

Inheritance diagram for Renderer::Backend::IDevice:

Classes
struct	Capabilities

Public Member Functions
virtual	~IDevice ()

virtual Backend	GetBackend () const =0

virtual const std::string &	GetName () const =0

virtual const std::string &	GetVersion () const =0

virtual const std::string &	GetDriverInformation () const =0

virtual const std::vector< std::string > &	GetExtensions () const =0

virtual void	Report (const ScriptRequest &rq, JS::HandleValue settings)=0

virtual std::unique_ptr< IDeviceCommandContext >	CreateCommandContext ()=0

virtual std::unique_ptr< IGraphicsPipelineState >	CreateGraphicsPipelineState (const SGraphicsPipelineStateDesc &pipelineStateDesc)=0
	Creates a graphics pipeline state. More...

virtual std::unique_ptr< IVertexInputLayout >	CreateVertexInputLayout (const PS::span< const SVertexAttributeFormat > attributes)=0
	Creates a vertex input layout. More...

virtual std::unique_ptr< ITexture >	CreateTexture (const char *name, const ITexture::Type type, const uint32_t usage, const Format format, const uint32_t width, const uint32_t height, const Sampler::Desc &defaultSamplerDesc, const uint32_t MIPLevelCount, const uint32_t sampleCount)=0

virtual std::unique_ptr< ITexture >	CreateTexture2D (const char *name, const uint32_t usage, const Format format, const uint32_t width, const uint32_t height, const Sampler::Desc &defaultSamplerDesc, const uint32_t MIPLevelCount=1, const uint32_t sampleCount=1)=0

virtual std::unique_ptr< IFramebuffer >	CreateFramebuffer (const char name, SColorAttachment colorAttachment, SDepthStencilAttachment *depthStencilAttachment)=0

virtual std::unique_ptr< IBuffer >	CreateBuffer (const char *name, const IBuffer::Type type, const uint32_t size, const bool dynamic)=0

virtual std::unique_ptr< IShaderProgram >	CreateShaderProgram (const CStr &name, const CShaderDefines &defines)=0

virtual bool	AcquireNextBackbuffer ()=0
	Acquires a backbuffer for rendering a frame. More...

virtual IFramebuffer *	GetCurrentBackbuffer (const AttachmentLoadOp colorAttachmentLoadOp, const AttachmentStoreOp colorAttachmentStoreOp, const AttachmentLoadOp depthStencilAttachmentLoadOp, const AttachmentStoreOp depthStencilAttachmentStoreOp)=0
	Returns a framebuffer for the current backbuffer with the required attachment operations. More...

virtual void	Present ()=0
	Presents the backbuffer to the swapchain queue to be flipped on a screen. More...

virtual void	OnWindowResize (const uint32_t width, const uint32_t height)=0
	Should be called on window surface resize. More...

virtual bool	IsTextureFormatSupported (const Format format) const =0

virtual bool	IsFramebufferFormatSupported (const Format format) const =0

virtual Format	GetPreferredDepthStencilFormat (const uint32_t usage, const bool depth, const bool stencil) const =0
	Returns the most suitable format for the usage. More...

virtual const Capabilities &	GetCapabilities () const =0

Constructor & Destructor Documentation

◆ ~IDevice()

virtual Renderer::Backend::IDevice::~IDevice ( )

inlinevirtual

Member Function Documentation

◆ AcquireNextBackbuffer()

virtual bool Renderer::Backend::IDevice::AcquireNextBackbuffer ( )

pure virtual

Acquires a backbuffer for rendering a frame.

Returns: True if it was successfully acquired and we can render to it.

Implemented in Renderer::Backend::Vulkan::CDevice, Renderer::Backend::GL::CDevice, and Renderer::Backend::Dummy::CDevice.

◆ CreateBuffer()

virtual std::unique_ptr<IBuffer> Renderer::Backend::IDevice::CreateBuffer	(	const char *	name,
		const IBuffer::Type	type,
		const uint32_t	size,
		const bool	dynamic
	)

pure virtual

Implemented in Renderer::Backend::Vulkan::CDevice, Renderer::Backend::GL::CDevice, and Renderer::Backend::Dummy::CDevice.

◆ CreateCommandContext()

virtual std::unique_ptr<IDeviceCommandContext> Renderer::Backend::IDevice::CreateCommandContext ( )

pure virtual

Implemented in Renderer::Backend::Vulkan::CDevice, Renderer::Backend::GL::CDevice, and Renderer::Backend::Dummy::CDevice.

◆ CreateFramebuffer()

virtual std::unique_ptr<IFramebuffer> Renderer::Backend::IDevice::CreateFramebuffer	(	const char *	name,
		SColorAttachment *	colorAttachment,
		SDepthStencilAttachment *	depthStencilAttachment
	)

pure virtual

See also: IFramebuffer

The color attachment and the depth-stencil attachment should not be nullptr at the same time. There should not be many different clear colors along all color attachments for all framebuffers created for the device.

Returns: A valid framebuffer if it was created successfully else nullptr.

Implemented in Renderer::Backend::Vulkan::CDevice, Renderer::Backend::GL::CDevice, and Renderer::Backend::Dummy::CDevice.

◆ CreateGraphicsPipelineState()

virtual std::unique_ptr<IGraphicsPipelineState> Renderer::Backend::IDevice::CreateGraphicsPipelineState ( const SGraphicsPipelineStateDesc & pipelineStateDesc )

pure virtual

Creates a graphics pipeline state.

It's a caller responsibility to guarantee a lifespan of IShaderProgram stored in the description.

Implemented in Renderer::Backend::Vulkan::CDevice, Renderer::Backend::GL::CDevice, and Renderer::Backend::Dummy::CDevice.

◆ CreateShaderProgram()

virtual std::unique_ptr<IShaderProgram> Renderer::Backend::IDevice::CreateShaderProgram	(	const CStr &	name,
		const CShaderDefines &	defines
	)

pure virtual

Implemented in Renderer::Backend::Vulkan::CDevice, Renderer::Backend::GL::CDevice, and Renderer::Backend::Dummy::CDevice.

◆ CreateTexture()

virtual std::unique_ptr<ITexture> Renderer::Backend::IDevice::CreateTexture	(	const char *	name,
		const ITexture::Type	type,
		const uint32_t	usage,
		const Format	format,
		const uint32_t	width,
		const uint32_t	height,
		const Sampler::Desc &	defaultSamplerDesc,
		const uint32_t	MIPLevelCount,
		const uint32_t	sampleCount
	)

pure virtual

Implemented in Renderer::Backend::Vulkan::CDevice, Renderer::Backend::GL::CDevice, and Renderer::Backend::Dummy::CDevice.

◆ CreateTexture2D()

virtual std::unique_ptr<ITexture> Renderer::Backend::IDevice::CreateTexture2D	(	const char *	name,
		const uint32_t	usage,
		const Format	format,
		const uint32_t	width,
		const uint32_t	height,
		const Sampler::Desc &	defaultSamplerDesc,
		const uint32_t	MIPLevelCount = `1`,
		const uint32_t	sampleCount = `1`
	)

pure virtual

Implemented in Renderer::Backend::Vulkan::CDevice, Renderer::Backend::GL::CDevice, and Renderer::Backend::Dummy::CDevice.

◆ CreateVertexInputLayout()

virtual std::unique_ptr<IVertexInputLayout> Renderer::Backend::IDevice::CreateVertexInputLayout ( const PS::span< const SVertexAttributeFormat > attributes )

pure virtual

Creates a vertex input layout.

It's recommended to use as few different layouts as posible.

Implemented in Renderer::Backend::Vulkan::CDevice, Renderer::Backend::GL::CDevice, and Renderer::Backend::Dummy::CDevice.

◆ GetBackend()

virtual Backend Renderer::Backend::IDevice::GetBackend ( ) const

pure virtual

Implemented in Renderer::Backend::Vulkan::CDevice, Renderer::Backend::GL::CDevice, and Renderer::Backend::Dummy::CDevice.

◆ GetCapabilities()

virtual const Capabilities& Renderer::Backend::IDevice::GetCapabilities ( ) const

pure virtual

Implemented in Renderer::Backend::Vulkan::CDevice, Renderer::Backend::GL::CDevice, and Renderer::Backend::Dummy::CDevice.

◆ GetCurrentBackbuffer()

virtual IFramebuffer* Renderer::Backend::IDevice::GetCurrentBackbuffer	(	const AttachmentLoadOp	colorAttachmentLoadOp,
		const AttachmentStoreOp	colorAttachmentStoreOp,
		const AttachmentLoadOp	depthStencilAttachmentLoadOp,
		const AttachmentStoreOp	depthStencilAttachmentStoreOp
	)

pure virtual

Returns a framebuffer for the current backbuffer with the required attachment operations.

It should not be called if the last AcquireNextBackbuffer call returned false.

It's guaranteed that for the same acquired backbuffer this function returns a framebuffer with the same attachments and properties except load and store operations.