#include <surface_context_vk.h>

Inheritance diagram for impeller::SurfaceContextVK:

Public Member Functions
	SurfaceContextVK (const std::shared_ptr< ContextVK > &parent)

	~SurfaceContextVK () override

BackendType	GetBackendType () const override
	Get the graphics backend of an Impeller context.

std::string	DescribeGpuModel () const override

bool	IsValid () const override
	Determines if a context is valid. If the caller ever receives an invalid context, they must discard it and construct a new context. There is no recovery mechanism to repair a bad context.

std::shared_ptr< Allocator >	GetResourceAllocator () const override
	Returns the allocator used to create textures and buffers on the device.

std::shared_ptr< ShaderLibrary >	GetShaderLibrary () const override
	Returns the library of shaders used to specify the programmable stages of a pipeline.

std::shared_ptr< SamplerLibrary >	GetSamplerLibrary () const override
	Returns the library of combined image samplers used in shaders.

std::shared_ptr< PipelineLibrary >	GetPipelineLibrary () const override
	Returns the library of pipelines used by render or compute commands.

std::shared_ptr< CommandBuffer >	CreateCommandBuffer () const override
	Create a new command buffer. Command buffers can be used to encode graphics, blit, or compute commands to be submitted to the device.

const std::shared_ptr< const Capabilities > &	GetCapabilities () const override
	Get the capabilities of Impeller context. All optionally supported feature of the platform, client-rendering API, and device can be queried using the `Capabilities`.

std::shared_ptr< CommandQueue >	GetCommandQueue () const override
	Return the graphics queue for submitting command buffers.

void	Shutdown () override
	Force all pending asynchronous work to finish. This is achieved by deleting all owned concurrent message loops.

bool	SetWindowSurface (vk::UniqueSurfaceKHR surface, const ISize &size)

std::unique_ptr< Surface >	AcquireNextSurface ()

void	UpdateSurfaceSize (const ISize &size) const
	Mark the current swapchain configuration as dirty, forcing it to be recreated on the next frame.

void	InitializeCommonlyUsedShadersIfNeeded () const override

const vk::Device &	GetDevice () const

const ContextVK &	GetParent () const

Public Member Functions inherited from impeller::Context
virtual	~Context ()
	Destroys an Impeller context.

virtual bool	UpdateOffscreenLayerPixelFormat (PixelFormat format)

virtual void	StoreTaskForGPU (const std::function< void()> &task)

Additional Inherited Members
Public Types inherited from impeller::Context
enum class	BackendType { kMetal , kOpenGLES , kVulkan }

Static Public Member Functions inherited from impeller::BackendCast< SurfaceContextVK, Context >
static SurfaceContextVK &	Cast (Context &base)

static const SurfaceContextVK &	Cast (const Context &base)

static SurfaceContextVK *	Cast (Context *base)

static const SurfaceContextVK *	Cast (const Context *base)

Public Attributes inherited from impeller::Context
CaptureContext	capture

Static Public Attributes inherited from impeller::Context
static constexpr int32_t	kMaxTasksAwaitingGPU = 10

Protected Member Functions inherited from impeller::Context
	Context ()

Protected Attributes inherited from impeller::Context
std::vector< std::function< void()> >	per_frame_task_

Detailed Description

For Vulkan, there is both a ContextVK that implements Context and a SurfaceContextVK that also implements Context and takes a ContextVK as its parent. There is a one to many relationship between ContextVK and SurfaceContextVK.

Most operations in this class are delegated to the parent ContextVK. This class specifically manages swapchains and creation of VkSurfaces on Android. By maintaining the swapchain this way, it is possible to have multiple surfaces sharing the same ContextVK without stepping on each other's swapchains.

Definition at line 31 of file surface_context_vk.h.

Constructor & Destructor Documentation

◆ SurfaceContextVK()

impeller::SurfaceContextVK::SurfaceContextVK ( const std::shared_ptr< ContextVK > & parent )

explicit

Definition at line 15 of file surface_context_vk.cc.

16 : parent_(parent) {}

◆ ~SurfaceContextVK()

impeller::SurfaceContextVK::~SurfaceContextVK ( )

overridedefault

Member Function Documentation

◆ AcquireNextSurface()

std::unique_ptr< Surface > impeller::SurfaceContextVK::AcquireNextSurface ( )

Definition at line 80 of file surface_context_vk.cc.

                                                            {
  TRACE_EVENT0("impeller", __FUNCTION__);
  auto surface = swapchain_ ? swapchain_->AcquireNextDrawable() : nullptr;
  if (!surface) {
    return nullptr;
  }
  if (auto pipeline_library = parent_->GetPipelineLibrary()) {
    impeller::PipelineLibraryVK::Cast(*pipeline_library)
        .DidAcquireSurfaceFrame();
  }
  parent_->GetCommandPoolRecycler()->Dispose();
  parent_->GetResourceAllocator()->DebugTraceMemoryStatistics();
  return surface;
}

◆ CreateCommandBuffer()

std::shared_ptr< CommandBuffer > impeller::SurfaceContextVK::CreateCommandBuffer ( ) const

overridevirtual

Create a new command buffer. Command buffers can be used to encode graphics, blit, or compute commands to be submitted to the device.

A command buffer can only be used on a single thread. Multi-threaded render, blit, or compute passes must create a new command buffer on each thread.

Returns: A new command buffer.

Implements impeller::Context.

Definition at line 48 of file surface_context_vk.cc.

                                                                         {
  return parent_->CreateCommandBuffer();
}

◆ DescribeGpuModel()

std::string impeller::SurfaceContextVK::DescribeGpuModel ( ) const

overridevirtual

Implements impeller::Context.

Definition at line 24 of file surface_context_vk.cc.

                                                   {
  return parent_->DescribeGpuModel();
}

◆ GetBackendType()

Context::BackendType impeller::SurfaceContextVK::GetBackendType ( ) const

overridevirtual

Get the graphics backend of an Impeller context.

        This is useful for cases where a renderer needs to track and
        lookup backend-specific resources, like shaders or uniform
        layout information.

        It's not recommended to use this as a substitute for
        per-backend capability checking. Instead, check for specific
        capabilities via `GetCapabilities()`.

Returns: The graphics backend of the Context.

Implements impeller::Context.

Definition at line 20 of file surface_context_vk.cc.

                                                          {
  return parent_->GetBackendType();
}

◆ GetCapabilities()

const std::shared_ptr< const Capabilities > & impeller::SurfaceContextVK::GetCapabilities ( ) const

overridevirtual

Get the capabilities of Impeller context. All optionally supported feature of the platform, client-rendering API, and device can be queried using the Capabilities.

Returns: The capabilities. Can never be nullptr for a valid context.

Implements impeller::Context.

Definition at line 56 of file surface_context_vk.cc.

          {
  return parent_->GetCapabilities();
}

◆ GetCommandQueue()

std::shared_ptr< CommandQueue > impeller::SurfaceContextVK::GetCommandQueue ( ) const

overridevirtual

Return the graphics queue for submitting command buffers.

Implements impeller::Context.

Definition at line 52 of file surface_context_vk.cc.

                                                                    {
  return parent_->GetCommandQueue();
}

◆ GetDevice()

const vk::Device & impeller::SurfaceContextVK::GetDevice ( ) const

Definition at line 122 of file surface_context_vk.cc.

                                                  {
  return parent_->GetDevice();
}

◆ GetParent()

const ContextVK & impeller::SurfaceContextVK::GetParent ( ) const

Definition at line 130 of file surface_context_vk.cc.

                                                   {
  return *parent_;
}

◆ GetPipelineLibrary()

std::shared_ptr< PipelineLibrary > impeller::SurfaceContextVK::GetPipelineLibrary ( ) const

overridevirtual

Returns the library of pipelines used by render or compute commands.

Returns: The pipeline library. Can never be nullptr for a valid context.

Implements impeller::Context.

Definition at line 44 of file surface_context_vk.cc.

                                                                          {
  return parent_->GetPipelineLibrary();
}

◆ GetResourceAllocator()

std::shared_ptr< Allocator > impeller::SurfaceContextVK::GetResourceAllocator ( ) const

overridevirtual

Returns the allocator used to create textures and buffers on the device.

Returns: The resource allocator. Can never be nullptr for a valid context.

Implements impeller::Context.

Definition at line 32 of file surface_context_vk.cc.

                                                                      {
  return parent_->GetResourceAllocator();
}

◆ GetSamplerLibrary()

std::shared_ptr< SamplerLibrary > impeller::SurfaceContextVK::GetSamplerLibrary ( ) const

overridevirtual

Returns the library of combined image samplers used in shaders.

Returns: The sampler library. Can never be nullptr for a valid context.

Implements impeller::Context.

Definition at line 40 of file surface_context_vk.cc.

                                                                        {
  return parent_->GetSamplerLibrary();
}

◆ GetShaderLibrary()

std::shared_ptr< ShaderLibrary > impeller::SurfaceContextVK::GetShaderLibrary ( ) const

overridevirtual

Returns the library of shaders used to specify the programmable stages of a pipeline.

Returns: The shader library. Can never be nullptr for a valid context.

Implements impeller::Context.

Definition at line 36 of file surface_context_vk.cc.

                                                                      {
  return parent_->GetShaderLibrary();
}

◆ InitializeCommonlyUsedShadersIfNeeded()

void impeller::SurfaceContextVK::InitializeCommonlyUsedShadersIfNeeded ( ) const

overridevirtual

Run backend specific additional setup and create common shader variants.

This bootstrap is intended to improve the performance of several first frame benchmarks that are tracked in the flutter device lab. The workload includes initializing commonly used but not default shader variants, as well as forcing driver initialization.

Reimplemented from impeller::Context.

Definition at line 126 of file surface_context_vk.cc.

                                                                   {
  parent_->InitializeCommonlyUsedShadersIfNeeded();
}

◆ IsValid()

bool impeller::SurfaceContextVK::IsValid ( ) const

overridevirtual

Determines if a context is valid. If the caller ever receives an invalid context, they must discard it and construct a new context. There is no recovery mechanism to repair a bad context.

It is convention in Impeller to never return an invalid context from a call that returns an pointer to a context. The call implementation performs validity checks itself and return a null context instead of a pointer to an invalid context.

How a context goes invalid is backend specific. It could happen due to device loss, or any other unrecoverable error.

Returns: If the context is valid.

Implements impeller::Context.

Definition at line 28 of file surface_context_vk.cc.

                                     {
  return parent_->IsValid();
}

◆ SetWindowSurface()

bool impeller::SurfaceContextVK::SetWindowSurface	(	vk::UniqueSurfaceKHR	surface,
		const ISize &	size
	)

Definition at line 65 of file surface_context_vk.cc.

                                                           {
  auto swapchain = SwapchainVK::Create(parent_, std::move(surface), size);
  if (!swapchain) {
    VALIDATION_LOG << "Could not create swapchain.";
    return false;
  }
  if (!swapchain->IsValid()) {
    VALIDATION_LOG << "Could not create valid swapchain.";
    return false;
  }
  swapchain_ = std::move(swapchain);
  return true;
}

◆ Shutdown()

void impeller::SurfaceContextVK::Shutdown ( )

overridevirtual

Force all pending asynchronous work to finish. This is achieved by deleting all owned concurrent message loops.

Implements impeller::Context.

Definition at line 61 of file surface_context_vk.cc.

                                {
  parent_->Shutdown();
}

◆ UpdateSurfaceSize()

void impeller::SurfaceContextVK::UpdateSurfaceSize ( const ISize & size ) const

Mark the current swapchain configuration as dirty, forcing it to be recreated on the next frame.

Definition at line 95 of file surface_context_vk.cc.

                                                                {
  swapchain_->UpdateSurfaceSize(size);
}

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

impeller/renderer/backend/vulkan/surface_context_vk.h
impeller/renderer/backend/vulkan/surface_context_vk.cc

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ SurfaceContextVK()

◆ ~SurfaceContextVK()

Member Function Documentation

◆ AcquireNextSurface()

◆ CreateCommandBuffer()

◆ DescribeGpuModel()

◆ GetBackendType()

◆ GetCapabilities()

◆ GetCommandQueue()

◆ GetDevice()

◆ GetParent()

◆ GetPipelineLibrary()

◆ GetResourceAllocator()

◆ GetSamplerLibrary()

◆ GetShaderLibrary()

◆ InitializeCommonlyUsedShadersIfNeeded()

◆ IsValid()

◆ SetWindowSurface()

◆ Shutdown()

◆ UpdateSurfaceSize()