An object used to specify compute work to the GPU along with references to resources the GPU will used when doing said work. More...

#include <compute_command.h>

Inheritance diagram for impeller::ComputeCommand:

Public Member Functions
bool	BindResource (ShaderStage stage, const ShaderUniformSlot &slot, const ShaderMetadata &metadata, const BufferView &view) override

bool	BindResource (ShaderStage stage, const SampledImageSlot &slot, const ShaderMetadata &metadata, const std::shared_ptr< const Texture > &texture, const std::shared_ptr< const Sampler > &sampler) override

constexpr	operator bool () const

Public Member Functions inherited from impeller::ResourceBinder
virtual	~ResourceBinder ()=default

Public Attributes
std::shared_ptr< Pipeline< ComputePipelineDescriptor > >	pipeline

Bindings	bindings

Detailed Description

An object used to specify compute work to the GPU along with references to resources the GPU will used when doing said work.

To construct a valid command, follow these steps:

Specify a valid pipeline.
(Optional) Specify a debug label.

Command are very lightweight objects and can be created frequently and on demand. The resources referenced in commands views into buffers managed by other allocators and resource managers.

Definition at line 43 of file compute_command.h.

Member Function Documentation

◆ BindResource() [1/2]

bool impeller::ComputeCommand::BindResource	(	ShaderStage	stage,
		const SampledImageSlot &	slot,
		const ShaderMetadata &	metadata,
		const std::shared_ptr< const Texture > &	texture,
		const std::shared_ptr< const Sampler > &	sampler
	)

overridevirtual

Implements impeller::ResourceBinder.

Definition at line 30 of file compute_command.cc.

                                                  {
   if (stage != ShaderStage::kCompute) {
     VALIDATION_LOG << "Use Command for non-compute shader stages.";
     return false;
   }
   if (!sampler || !sampler->IsValid()) {
     return false;
   }
   if (!texture || !texture->IsValid()) {
     return false;
   }
   if (!slot.HasSampler() || !slot.HasTexture()) {
     return true;
   }
  
   bindings.sampled_images[slot.sampler_index] = TextureAndSampler{
       .slot = slot,
       .texture = {&metadata, texture},
       .sampler = {&metadata, sampler},
   };
  
   return false;
 }

References bindings, impeller::SampledImageSlot::HasSampler(), impeller::SampledImageSlot::HasTexture(), impeller::kCompute, impeller::Bindings::sampled_images, impeller::SampledImageSlot::sampler_index, impeller::TextureAndSampler::slot, and VALIDATION_LOG.

◆ BindResource() [2/2]

bool impeller::ComputeCommand::BindResource	(	ShaderStage	stage,
		const ShaderUniformSlot &	slot,
		const ShaderMetadata &	metadata,
		const BufferView &	view
	)

overridevirtual

Implements impeller::ResourceBinder.

Definition at line 14 of file compute_command.cc.

                                                           {
   if (stage != ShaderStage::kCompute) {
     VALIDATION_LOG << "Use Command for non-compute shader stages.";
     return false;
   }
   if (!view) {
     return false;
   }
  
   bindings.buffers[slot.ext_res_0] = {.slot = slot, .view = {&metadata, view}};
   return true;
 }

References bindings, impeller::Bindings::buffers, impeller::ShaderUniformSlot::ext_res_0, impeller::kCompute, and VALIDATION_LOG.

◆ operator bool()

constexpr impeller::ComputeCommand::operator bool ( ) const

inlineexplicitconstexpr

Definition at line 74 of file compute_command.h.

                                            {
     return pipeline && pipeline->IsValid();
   }

References pipeline.

Member Data Documentation

◆ bindings

Bindings impeller::ComputeCommand::bindings

The buffer, texture, and sampler bindings used by the compute pipeline stage.

Definition at line 52 of file compute_command.h.

Referenced by impeller::AllocateAndBindDescriptorSets(), BindResource(), and impeller::UpdateBindingLayouts().

◆ pipeline

std::shared_ptr<Pipeline<ComputePipelineDescriptor> > impeller::ComputeCommand::pipeline

The pipeline to use for this command.

Definition at line 47 of file compute_command.h.

Referenced by operator bool(), impeller::ComputeTessellator::Tessellate(), and impeller::testing::TEST_P().

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

impeller/renderer/compute_command.h
impeller/renderer/compute_command.cc

Public Member Functions

Public Attributes