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, BufferView view) override

bool	BindResource (ShaderStage stage, const SampledImageSlot &slot, const ShaderMetadata &metadata, std::shared_ptr< const Texture > texture, 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 36 of file compute_command.h.

Member Function Documentation

◆ BindResource() [1/2]

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

overridevirtual

Implements impeller::ResourceBinder.

Definition at line 31 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;
   }
  
   bindings.sampled_images.emplace_back(TextureAndSampler{
       .slot = slot,
       .texture = {&metadata, std::move(texture)},
       .sampler = std::move(sampler),
   });
  
   return false;
 }

References bindings, impeller::kCompute, impeller::Bindings::sampled_images, impeller::TextureAndSampler::slot, and VALIDATION_LOG.

◆ BindResource() [2/2]

bool impeller::ComputeCommand::BindResource	(	ShaderStage	stage,
		const ShaderUniformSlot &	slot,
		const ShaderMetadata &	metadata,
		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.emplace_back(
       BufferAndUniformSlot{.slot = slot, .view = {&metadata, std::move(view)}});
   return true;
 }

References bindings, impeller::Bindings::buffers, impeller::kCompute, impeller::BufferAndUniformSlot::slot, and VALIDATION_LOG.

◆ operator bool()

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

inlineexplicitconstexpr

Definition at line 67 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 45 of file compute_command.h.

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

◆ pipeline

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

The pipeline to use for this command.

Definition at line 40 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