impeller::Command Struct Reference

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

#include <command.h>

Inheritance diagram for impeller::Command:

Public Member Functions
bool	BindVertices (const VertexBuffer &buffer)
	Specify the vertex and index buffer to use for this command. More...
bool	BindResource (ShaderStage stage, const ShaderUniformSlot &slot, const ShaderMetadata &metadata, const BufferView &view) override
bool	BindResource (ShaderStage stage, const ShaderUniformSlot &slot, const std::shared_ptr< const ShaderMetadata > &metadata, const BufferView &view)
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
BufferView	GetVertexBuffer () const
constexpr	operator bool () const
Public Member Functions inherited from impeller::ResourceBinder
virtual	~ResourceBinder ()=default

Public Attributes
std::shared_ptr< Pipeline< PipelineDescriptor > >	pipeline
Bindings	vertex_bindings
Bindings	fragment_bindings
BufferView	index_buffer
size_t	vertex_count = 0u
IndexType	index_type = IndexType::kUnknown
uint32_t	stencil_reference = 0u
uint64_t	base_vertex = 0u
std::optional< Viewport >	viewport
std::optional< IRect >	scissor
size_t	instance_count = 1u

Detailed Description

An object used to specify 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.
• Specify vertex information via a call BindVertices
• Specify any stage bindings.
• (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 99 of file command.h.

Member Function Documentation

BindResource() [1/3]

bool impeller::Command::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 78 of file command.cc.

                                                                        {
  if (!sampler || !sampler->IsValid()) {
    return false;
  }
  if (!texture || !texture->IsValid()) {
    return false;
  }
  if (!slot.HasSampler() || !slot.HasTexture()) {
    return true;
  }
 
  switch (stage) {
    case ShaderStage::kVertex:
      vertex_bindings.sampled_images[slot.sampler_index] = TextureAndSampler{
          .slot = slot,
          .texture = {&metadata, texture},
          .sampler = {&metadata, sampler},
      };
      return true;
    case ShaderStage::kFragment:
      fragment_bindings.sampled_images[slot.sampler_index] = TextureAndSampler{
          .slot = slot,
          .texture = {&metadata, texture},
          .sampler = {&metadata, sampler},
      };
      return true;
    case ShaderStage::kCompute:
      VALIDATION_LOG << "Use ComputeCommands for compute shader stages.";
    case ShaderStage::kUnknown:
    case ShaderStage::kTessellationControl:
    case ShaderStage::kTessellationEvaluation:
      return false;
  }
 
  return false;
}

References fragment_bindings, impeller::SampledImageSlot::HasSampler(), impeller::SampledImageSlot::HasTexture(), impeller::kCompute, impeller::kFragment, impeller::kTessellationControl, impeller::kTessellationEvaluation, impeller::kUnknown, impeller::kVertex, impeller::Bindings::sampled_images, impeller::SampledImageSlot::sampler_index, impeller::TextureAndSampler::slot, VALIDATION_LOG, and vertex_bindings.

BindResource() [2/3]

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

overridevirtual

Implements impeller::ResourceBinder.

Definition at line 33 of file command.cc.

                                                   {
  return DoBindResource(stage, slot, &metadata, view);
}

Referenced by impeller::RuntimeEffectContents::Render().

BindResource() [3/3]

bool impeller::Command::BindResource	(	ShaderStage	stage,
		const ShaderUniformSlot &	slot,
		const std::shared_ptr< const ShaderMetadata > &	metadata,
		const BufferView &	view
	)

Definition at line 40 of file command.cc.

                            {
  return DoBindResource(stage, slot, metadata, view);
}

BindVertices()

bool impeller::Command::BindVertices

(

const VertexBuffer &

buffer

)

Specify the vertex and index buffer to use for this command.

Parameters

[in]

buffer

The vertex and index buffer definition.

Returns

returns if the binding was updated.

Definition at line 15 of file command.cc.

                                                     {
  if (buffer.index_type == IndexType::kUnknown) {
    VALIDATION_LOG << "Cannot bind vertex buffer with an unknown index type.";
    return false;
  }
 
  vertex_bindings.vertex_buffer =
      BufferAndUniformSlot{.slot = {}, .view = {nullptr, buffer.vertex_buffer}};
  index_buffer = buffer.index_buffer;
  vertex_count = buffer.vertex_count;
  index_type = buffer.index_type;
  return true;
}

References impeller::VertexBuffer::index_buffer, index_buffer, impeller::VertexBuffer::index_type, index_type, impeller::kUnknown, impeller::BufferAndUniformSlot::slot, VALIDATION_LOG, vertex_bindings, impeller::VertexBuffer::vertex_buffer, impeller::Bindings::vertex_buffer, impeller::VertexBuffer::vertex_count, and vertex_count.

Referenced by impeller::AdvancedBlend(), impeller::scene::CuboidGeometry::BindToCommand(), impeller::scene::UnskinnedVertexBufferGeometry::BindToCommand(), impeller::scene::SkinnedVertexBufferGeometry::BindToCommand(), ImGui_ImplImpeller_RenderDrawData(), impeller::PipelineBlend(), impeller::CheckerboardContents::Render(), impeller::RuntimeEffectContents::Render(), impeller::TiledTextureContents::Render(), impeller::ClipContents::Render(), impeller::SolidRRectBlurContents::Render(), impeller::SolidColorContents::Render(), impeller::TextContents::Render(), impeller::TextureContents::Render(), impeller::VerticesColorContents::Render(), impeller::AtlasContents::Render(), impeller::ClipRestoreContents::Render(), impeller::VerticesUVContents::Render(), impeller::AtlasTextureContents::Render(), impeller::AtlasColorContents::Render(), and impeller::testing::TEST_P().

GetVertexBuffer()

BufferView impeller::Command::GetVertexBuffer

(

)

const

Definition at line 29 of file command.cc.

                                          {
  return vertex_bindings.vertex_buffer.view.resource;
}

References impeller::Resource< T >::resource, vertex_bindings, impeller::Bindings::vertex_buffer, and impeller::BufferAndUniformSlot::view.

Referenced by impeller::EncodeCommand().

operator bool()

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

inlineexplicitconstexpr

Definition at line 208 of file command.h.

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

References pipeline.

Member Data Documentation

base_vertex

uint64_t impeller::Command::base_vertex = 0u

The offset used when indexing into the vertex buffer.

Definition at line 156 of file command.h.

Referenced by impeller::EncodeCommand(), and ImGui_ImplImpeller_RenderDrawData().

fragment_bindings

Bindings impeller::Command::fragment_bindings

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

Definition at line 113 of file command.h.

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

index_buffer

BufferView impeller::Command::index_buffer

The index buffer binding used by the vertex shader stage. Instead of setting this directly, it usually easier to specify the vertex and index buffer bindings directly via a single call to BindVertices.

See also

BindVertices

Definition at line 121 of file command.h.

Referenced by BindVertices(), and impeller::EncodeCommand().

index_type

IndexType impeller::Command::index_type = IndexType::kUnknown

The type of indices in the index buffer. The indices must be tightly packed in the index buffer.

Definition at line 136 of file command.h.

Referenced by BindVertices(), and impeller::EncodeCommand().

instance_count

size_t impeller::Command::instance_count = 1u

The number of instances of the given set of vertices to render. Not all backends support rendering more than one instance at a time.

Warning

Setting this to more than one will limit the availability of backends to use with this command.

Definition at line 177 of file command.h.

Referenced by impeller::EncodeCommand(), and impeller::testing::TEST_P().

pipeline

std::shared_ptr<Pipeline<PipelineDescriptor> > impeller::Command::pipeline

The pipeline to use for this command.

Definition at line 103 of file command.h.

Referenced by impeller::AdvancedBlend(), impeller::scene::EncodeCommand(), impeller::EncodeCommand(), ImGui_ImplImpeller_RenderDrawData(), operator bool(), impeller::PipelineBlend(), impeller::CheckerboardContents::Render(), impeller::RuntimeEffectContents::Render(), impeller::TiledTextureContents::Render(), impeller::ClipContents::Render(), impeller::SolidRRectBlurContents::Render(), impeller::SolidColorContents::Render(), impeller::TextContents::Render(), impeller::TextureContents::Render(), impeller::VerticesColorContents::Render(), impeller::AtlasContents::Render(), impeller::ClipRestoreContents::Render(), impeller::VerticesUVContents::Render(), impeller::AtlasTextureContents::Render(), impeller::AtlasColorContents::Render(), and impeller::testing::TEST_P().

scissor

std::optional<IRect> impeller::Command::scissor

The scissor rect to use for clipping writes to the render target. The scissor rect must lie entirely within the render target. If unset, no scissor is applied.

Definition at line 169 of file command.h.

Referenced by ImGui_ImplImpeller_RenderDrawData(), and impeller::SetViewportAndScissor().

stencil_reference

uint32_t impeller::Command::stencil_reference = 0u

The reference value to use in stenciling operations. Stencil configuration is part of pipeline setup and can be read from the pipelines descriptor.

See also

Pipeline

PipelineDescriptor

Definition at line 152 of file command.h.

Referenced by impeller::scene::EncodeCommand(), impeller::EncodeCommand(), impeller::TiledTextureContents::Render(), impeller::RuntimeEffectContents::Render(), impeller::ClipContents::Render(), impeller::SolidRRectBlurContents::Render(), impeller::SolidColorContents::Render(), impeller::TextContents::Render(), impeller::TextureContents::Render(), impeller::VerticesColorContents::Render(), impeller::AtlasContents::Render(), impeller::ClipRestoreContents::Render(), impeller::VerticesUVContents::Render(), impeller::AtlasTextureContents::Render(), impeller::AtlasColorContents::Render(), and impeller::testing::TEST_P().

vertex_bindings

Bindings impeller::Command::vertex_bindings

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

Definition at line 108 of file command.h.

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

vertex_count

size_t impeller::Command::vertex_count = 0u

The number of vertices to draw.

If the index_type is IndexType::kNone, this is a count into the vertex buffer. Otherwise, it is a count into the index buffer. Set the vertex and index buffers as well as the index count using a call to BindVertices.

See also

BindVertices

Definition at line 131 of file command.h.

Referenced by BindVertices(), and impeller::EncodeCommand().

viewport

std::optional<Viewport> impeller::Command::viewport

The viewport coordinates that the rasterizer linearly maps normalized device coordinates to. If unset, the viewport is the size of the render target with a zero origin, znear=0, and zfar=1.

Definition at line 163 of file command.h.

Referenced by ImGui_ImplImpeller_RenderDrawData(), and impeller::SetViewportAndScissor().

---

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

• impeller/renderer/command.h
• impeller/renderer/command.cc