impeller::PassBindingsCacheMTL Struct Reference

Ensures that bindings on the pass are not redundantly set or updated. Avoids making the driver do additional checks and makes the frame insights during profiling and instrumentation not complain about the same. More...

#include <pass_bindings_cache_mtl.h>

Public Member Functions
	PassBindingsCacheMTL ()
	~PassBindingsCacheMTL ()=default
	PassBindingsCacheMTL (const PassBindingsCacheMTL &)=delete
	PassBindingsCacheMTL (PassBindingsCacheMTL &&)=delete
void	SetEncoder (id< MTLRenderCommandEncoder > encoder)
	Set the command encoder for this pass bindings cache.
void	SetRenderPipelineState (id< MTLRenderPipelineState > pipeline)
	Set the render pipeline state for the current encoder.
void	SetDepthStencilState (id< MTLDepthStencilState > depth_stencil)
	Set the depth and stencil state for the current encoder.
bool	SetBuffer (ShaderStage stage, uint64_t index, uint64_t offset, id< MTLBuffer > buffer)
	Set the buffer for the given shader stage, binding, and offset.
bool	SetTexture (ShaderStage stage, uint64_t index, id< MTLTexture > texture)
	Set the texture for the given stage and binding.
bool	SetSampler (ShaderStage stage, uint64_t index, id< MTLSamplerState > sampler)
	Set the sampler for the given stage and binding.
void	SetViewport (const Viewport &viewport)
	Set the viewport if the value is different from the current encoder state.
void	SetScissor (const IRect32 &scissor)
	Set the encoder scissor rect if the value is different from the current encoder state.
void	SetStencilRef (uint32_t stencil_ref)
	Set the encoder's stencil reference if the value is different from the current encoder state.

Detailed Description

Ensures that bindings on the pass are not redundantly set or updated. Avoids making the driver do additional checks and makes the frame insights during profiling and instrumentation not complain about the same.

There should be no change to rendering if this caching was absent.

Definition at line 24 of file pass_bindings_cache_mtl.h.

Constructor & Destructor Documentation

PassBindingsCacheMTL() [1/3]

impeller::PassBindingsCacheMTL::PassBindingsCacheMTL ( )

inlineexplicit

Definition at line 25 of file pass_bindings_cache_mtl.h.

{}

~PassBindingsCacheMTL()

impeller::PassBindingsCacheMTL::~PassBindingsCacheMTL ( )

default

PassBindingsCacheMTL() [2/3]

impeller::PassBindingsCacheMTL::PassBindingsCacheMTL ( const PassBindingsCacheMTL &  )

delete

PassBindingsCacheMTL() [3/3]

impeller::PassBindingsCacheMTL::PassBindingsCacheMTL ( PassBindingsCacheMTL &&  )

delete

Member Function Documentation

SetBuffer()

bool impeller::PassBindingsCacheMTL::SetBuffer	(	ShaderStage	stage,
		uint64_t	index,
		uint64_t	offset,
		id< MTLBuffer >	buffer
	)

Set the buffer for the given shader stage, binding, and offset.

If the buffer is already bound, only the offset is updated.

Definition at line 31 of file pass_bindings_cache_mtl.mm.

                                                           {
  auto& buffers_map = buffers_[stage];
  auto found = buffers_map.find(index);
  if (found != buffers_map.end() && found->second.buffer == buffer) {
    // The right buffer is bound. Check if its offset needs to be updated.
    if (found->second.offset == offset) {
      // Buffer and its offset is identical. Nothing to do.
      return true;
    }
 
    // Only the offset needs to be updated.
    found->second.offset = offset;
 
    switch (stage) {
      case ShaderStage::kVertex:
        [encoder_ setVertexBufferOffset:offset atIndex:index];
        return true;
      case ShaderStage::kFragment:
        [encoder_ setFragmentBufferOffset:offset atIndex:index];
        return true;
      default:
        VALIDATION_LOG << "Cannot update buffer offset of an unknown stage.";
        return false;
    }
    return true;
  }
  buffers_map[index] = {buffer, static_cast<size_t>(offset)};
  switch (stage) {
    case ShaderStage::kVertex:
      [encoder_ setVertexBuffer:buffer offset:offset atIndex:index];
      return true;
    case ShaderStage::kFragment:
      [encoder_ setFragmentBuffer:buffer offset:offset atIndex:index];
      return true;
    default:
      VALIDATION_LOG << "Cannot bind buffer to unknown shader stage.";
      return false;
  }
  return false;
}

References impeller::kFragment, impeller::kVertex, and VALIDATION_LOG.

Referenced by impeller::Bind().

SetDepthStencilState()

void impeller::PassBindingsCacheMTL::SetDepthStencilState

(

id< MTLDepthStencilState >

depth_stencil

)

Set the depth and stencil state for the current encoder.

If this matches the previous depth and stencil state, no update is performed.

Definition at line 22 of file pass_bindings_cache_mtl.mm.

                                            {
  if (depth_stencil_ == depth_stencil) {
    return;
  }
  depth_stencil_ = depth_stencil;
  [encoder_ setDepthStencilState:depth_stencil_];
}

SetEncoder()

void impeller::PassBindingsCacheMTL::SetEncoder

(

id< MTLRenderCommandEncoder >

encoder

)

Set the command encoder for this pass bindings cache.

The encoder must be set before any state adjusting commands can be called.

Definition at line 9 of file pass_bindings_cache_mtl.mm.

                                                                         {
  encoder_ = encoder;
}

SetRenderPipelineState()

void impeller::PassBindingsCacheMTL::SetRenderPipelineState

(

id< MTLRenderPipelineState >

pipeline

)

Set the render pipeline state for the current encoder.

If this matches the previous render pipeline state, no update is performed.

Definition at line 13 of file pass_bindings_cache_mtl.mm.

                                         {
  if (pipeline == pipeline_) {
    return;
  }
  pipeline_ = pipeline;
  [encoder_ setRenderPipelineState:pipeline_];
}

SetSampler()

bool impeller::PassBindingsCacheMTL::SetSampler	(	ShaderStage	stage,
		uint64_t	index,
		id< MTLSamplerState >	sampler
	)

Set the sampler for the given stage and binding.

If the same sampler is already bound at the index for this stage, no state updates are performed.

Definition at line 99 of file pass_bindings_cache_mtl.mm.

                                                                   {
  auto& sampler_map = samplers_[stage];
  auto found = sampler_map.find(index);
  if (found != sampler_map.end() && found->second == sampler) {
    // Already bound.
    return true;
  }
  sampler_map[index] = sampler;
  switch (stage) {
    case ShaderStage::kVertex:
      [encoder_ setVertexSamplerState:sampler atIndex:index];
      return true;
    case ShaderStage::kFragment:
      [encoder_ setFragmentSamplerState:sampler atIndex:index];
      return true;
    default:
      VALIDATION_LOG << "Cannot bind buffer to unknown shader stage.";
      return false;
  }
  return false;
}

References impeller::kFragment, impeller::kVertex, and VALIDATION_LOG.

Referenced by impeller::Bind().

SetScissor()

void impeller::PassBindingsCacheMTL::SetScissor

(

const IRect32 &

scissor

)

Set the encoder scissor rect if the value is different from the current encoder state.

Definition at line 138 of file pass_bindings_cache_mtl.mm.

                                                            {
  if (scissor_.has_value() && scissor_.value() == scissor) {
    return;
  }
  [encoder_
      setScissorRect:MTLScissorRect{
                         .x = static_cast<NSUInteger>(scissor.GetX()),
                         .y = static_cast<NSUInteger>(scissor.GetY()),
                         .width = static_cast<NSUInteger>(scissor.GetWidth()),
                         .height = static_cast<NSUInteger>(scissor.GetHeight()),
                     }];
  scissor_ = scissor;
}

References impeller::TRect< T >::GetHeight(), impeller::TRect< T >::GetWidth(), impeller::TRect< T >::GetX(), impeller::TRect< T >::GetY(), height, width, and y.

SetStencilRef()

void impeller::PassBindingsCacheMTL::SetStencilRef

(

uint32_t

stencil_ref

)

Set the encoder's stencil reference if the value is different from the current encoder state.

Definition at line 152 of file pass_bindings_cache_mtl.mm.

                                                             {
  if (stencil_ref_.has_value() && stencil_ref_.value() == stencil_ref) {
    return;
  }
  [encoder_ setStencilReferenceValue:stencil_ref];
  stencil_ref_ = stencil_ref;
}

SetTexture()

bool impeller::PassBindingsCacheMTL::SetTexture	(	ShaderStage	stage,
		uint64_t	index,
		id< MTLTexture >	texture
	)

Set the texture for the given stage and binding.

If the same texture is already bound at the index for this stage, no state updates are performed.

Definition at line 75 of file pass_bindings_cache_mtl.mm.

                                                              {
  auto& texture_map = textures_[stage];
  auto found = texture_map.find(index);
  if (found != texture_map.end() && found->second == texture) {
    // Already bound.
    return true;
  }
  texture_map[index] = texture;
  switch (stage) {
    case ShaderStage::kVertex:
      [encoder_ setVertexTexture:texture atIndex:index];
      return true;
    case ShaderStage::kFragment:
      [encoder_ setFragmentTexture:texture atIndex:index];
      return true;
    default:
      VALIDATION_LOG << "Cannot bind buffer to unknown shader stage.";
      return false;
  }
  return false;
}

References impeller::kFragment, impeller::kVertex, texture, and VALIDATION_LOG.

Referenced by impeller::Bind().

SetViewport()

void impeller::PassBindingsCacheMTL::SetViewport

(

const Viewport &

viewport

)

Set the viewport if the value is different from the current encoder state.

Definition at line 123 of file pass_bindings_cache_mtl.mm.

                                                               {
  if (viewport_.has_value() && viewport_.value() == viewport) {
    return;
  }
  [encoder_ setViewport:MTLViewport{
                            .originX = viewport.rect.GetX(),
                            .originY = viewport.rect.GetY(),
                            .width = viewport.rect.GetWidth(),
                            .height = viewport.rect.GetHeight(),
                            .znear = viewport.depth_range.z_near,
                            .zfar = viewport.depth_range.z_far,
                        }];
  viewport_ = viewport;
}

References impeller::Viewport::depth_range, impeller::TRect< T >::GetHeight(), impeller::TRect< T >::GetWidth(), impeller::TRect< T >::GetX(), impeller::TRect< T >::GetY(), impeller::Viewport::rect, impeller::DepthRange::z_far, and impeller::DepthRange::z_near.

---

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

• impeller/renderer/backend/metal/pass_bindings_cache_mtl.h
• impeller/renderer/backend/metal/pass_bindings_cache_mtl.mm