impeller::ComputePassBindingsCacheMTL 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 <compute_pass_bindings_cache_mtl.h>

Public Member Functions
	ComputePassBindingsCacheMTL ()
	ComputePassBindingsCacheMTL (const ComputePassBindingsCacheMTL &)=delete
	ComputePassBindingsCacheMTL (ComputePassBindingsCacheMTL &&)=delete
void	SetComputePipelineState (id< MTLComputePipelineState > pipeline)
id< MTLComputePipelineState >	GetPipeline () const
void	SetEncoder (id< MTLComputeCommandEncoder > encoder)
void	SetBuffer (uint64_t index, uint64_t offset, id< MTLBuffer > buffer)
void	SetTexture (uint64_t index, id< MTLTexture > texture)
void	SetSampler (uint64_t index, id< MTLSamplerState > sampler)

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 compute_pass_bindings_cache_mtl.h.

Constructor & Destructor Documentation

ComputePassBindingsCacheMTL() [1/3]

impeller::ComputePassBindingsCacheMTL::ComputePassBindingsCacheMTL ( )

inlineexplicit

Definition at line 25 of file compute_pass_bindings_cache_mtl.h.

{}

ComputePassBindingsCacheMTL() [2/3]

impeller::ComputePassBindingsCacheMTL::ComputePassBindingsCacheMTL ( const ComputePassBindingsCacheMTL &  )

delete

ComputePassBindingsCacheMTL() [3/3]

impeller::ComputePassBindingsCacheMTL::ComputePassBindingsCacheMTL ( ComputePassBindingsCacheMTL &&  )

delete

Member Function Documentation

GetPipeline()

id< MTLComputePipelineState > impeller::ComputePassBindingsCacheMTL::GetPipeline

(

)

const

Definition at line 18 of file compute_pass_bindings_cache_mtl.mm.

                                                                           {
  return pipeline_;
}

SetBuffer()

void impeller::ComputePassBindingsCacheMTL::SetBuffer	(	uint64_t	index,
		uint64_t	offset,
		id< MTLBuffer >	buffer
	)

Definition at line 27 of file compute_pass_bindings_cache_mtl.mm.

                                                                  {
  auto found = buffers_.find(index);
  if (found != buffers_.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;
    }
 
    // Only the offset needs to be updated.
    found->second.offset = offset;
 
    [encoder_ setBufferOffset:offset atIndex:index];
    return;
  }
 
  buffers_[index] = {buffer, static_cast<size_t>(offset)};
  [encoder_ setBuffer:buffer offset:offset atIndex:index];
}

SetComputePipelineState()

void impeller::ComputePassBindingsCacheMTL::SetComputePipelineState

(

id< MTLComputePipelineState >

pipeline

)

Definition at line 9 of file compute_pass_bindings_cache_mtl.mm.

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

SetEncoder()

void impeller::ComputePassBindingsCacheMTL::SetEncoder

(

id< MTLComputeCommandEncoder >

encoder

)

Definition at line 22 of file compute_pass_bindings_cache_mtl.mm.

                                          {
  encoder_ = encoder;
}

SetSampler()

void impeller::ComputePassBindingsCacheMTL::SetSampler	(	uint64_t	index,
		id< MTLSamplerState >	sampler
	)

Definition at line 61 of file compute_pass_bindings_cache_mtl.mm.

                                                                          {
  auto found = samplers_.find(index);
  if (found != samplers_.end() && found->second == sampler) {
    // Already bound.
    return;
  }
  samplers_[index] = sampler;
  [encoder_ setSamplerState:sampler atIndex:index];
  return;
}

SetTexture()

void impeller::ComputePassBindingsCacheMTL::SetTexture	(	uint64_t	index,
		id< MTLTexture >	texture
	)

Definition at line 49 of file compute_pass_bindings_cache_mtl.mm.

                                                                     {
  auto found = textures_.find(index);
  if (found != textures_.end() && found->second == texture) {
    // Already bound.
    return;
  }
  textures_[index] = texture;
  [encoder_ setTexture:texture atIndex:index];
  return;
}

References texture.

---

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

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