impeller::ComputePassBindingsCache 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...

Public Member Functions
	ComputePassBindingsCache (id< MTLComputeCommandEncoder > encoder)
	ComputePassBindingsCache (const ComputePassBindingsCache &)=delete
	ComputePassBindingsCache (ComputePassBindingsCache &&)=delete
void	SetComputePipelineState (id< MTLComputePipelineState > pipeline)
id< MTLComputePipelineState >	GetPipeline () const
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 89 of file compute_pass_mtl.mm.

Constructor & Destructor Documentation

ComputePassBindingsCache() [1/3]

impeller::ComputePassBindingsCache::ComputePassBindingsCache ( id< MTLComputeCommandEncoder >  encoder )

inlineexplicit

Definition at line 90 of file compute_pass_mtl.mm.

      : encoder_(encoder) {}

ComputePassBindingsCache() [2/3]

impeller::ComputePassBindingsCache::ComputePassBindingsCache ( const ComputePassBindingsCache &  )

delete

ComputePassBindingsCache() [3/3]

impeller::ComputePassBindingsCache::ComputePassBindingsCache ( ComputePassBindingsCache &&  )

delete

Member Function Documentation

GetPipeline()

id<MTLComputePipelineState> impeller::ComputePassBindingsCache::GetPipeline ( ) const

inline

Definition at line 105 of file compute_pass_mtl.mm.

{ return pipeline_; }

SetBuffer()

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

inline

Definition at line 107 of file compute_pass_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];
  }

Referenced by impeller::Bind().

SetComputePipelineState()

void impeller::ComputePassBindingsCache::SetComputePipelineState ( id< MTLComputePipelineState >  pipeline )

inline

Definition at line 97 of file compute_pass_mtl.mm.

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

SetSampler()

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

inline

Definition at line 138 of file compute_pass_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;
  }

Referenced by impeller::Bind().

SetTexture()

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

inline

Definition at line 127 of file compute_pass_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;
  }

Referenced by impeller::Bind().

---

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

• impeller/renderer/backend/metal/compute_pass_mtl.mm