skgpu::graphite::DrawPass::SortKey Class Reference

Public Member Functions
	SortKey (const DrawList::Draw *draw, int renderStep, GraphicsPipelineCache::Index pipelineIndex, UniformCache::Index geomUniformIndex, UniformCache::Index shadingUniformIndex, TextureBindingCache::Index textureBindingIndex)
bool	operator< (const SortKey &k) const
const RenderStep &	renderStep () const
const DrawList::Draw &	draw () const
GraphicsPipelineCache::Index	pipelineIndex () const
UniformCache::Index	geometryUniformIndex () const
UniformCache::Index	shadingUniformIndex () const
TextureBindingCache::Index	textureBindingIndex () const

Detailed Description

Each Draw in a DrawList might be processed by multiple RenderSteps (determined by the Draw's Renderer), which can be sorted independently. Each (step, draw) pair produces its own SortKey.

The goal of sorting draws for the DrawPass is to minimize pipeline transitions and dynamic binds within a pipeline, while still respecting the overall painter's order. This decreases the number of low-level draw commands in a command buffer and increases the size of those, allowing the GPU to operate more efficiently and have fewer bubbles within its own instruction stream.

The Draw's CompresssedPaintersOrder and DisjointStencilINdex represent the most significant bits of the key, and are shared by all SortKeys produced by the same draw. Next, the pipeline description is encoded in two steps:

1. The index of the RenderStep packed in the high bits to ensure each step for a draw is ordered correctly.
2. An index into a cache of pipeline descriptions is used to encode the identity of the pipeline (SortKeys that differ in the bits from #1 necessarily would have different descriptions, but then the specific ordering of the RenderSteps isn't enforced). Last, the SortKey encodes an index into the set of uniform bindings accumulated for a DrawPass. This allows the SortKey to cluster draw steps that have both a compatible pipeline and do not require rebinding uniform data or other state (e.g. scissor). Since the uniform data index and the pipeline description index are packed into indices and not actual pointers, a given SortKey is only valid for the a specific DrawList->DrawPass conversion.

Definition at line 339 of file DrawPass.cpp.

Constructor & Destructor Documentation

SortKey()

skgpu::graphite::DrawPass::SortKey::SortKey ( const DrawList::Draw *  draw, int  renderStep, GraphicsPipelineCache::Index  pipelineIndex, UniformCache::Index  geomUniformIndex, UniformCache::Index  shadingUniformIndex, TextureBindingCache::Index  textureBindingIndex  )

inline

Definition at line 341 of file DrawPass.cpp.

        : fPipelineKey(ColorDepthOrderField::set(draw->fDrawParams.order().paintOrder().bits()) |
                       StencilIndexField::set(draw->fDrawParams.order().stencilIndex().bits())  |
                       RenderStepField::set(static_cast<uint32_t>(renderStep))                  |
                       PipelineField::set(pipelineIndex))
        , fUniformKey(GeometryUniformField::set(geomUniformIndex)   |
                      ShadingUniformField::set(shadingUniformIndex) |
                      TextureBindingsField::set(textureBindingIndex))
        , fDraw(draw) {
        SkASSERT(pipelineIndex < GraphicsPipelineCache::kInvalidIndex);
        SkASSERT(renderStep <= draw->fRenderer->numRenderSteps());
    }

Member Function Documentation

draw()

const DrawList::Draw & skgpu::graphite::DrawPass::SortKey::draw ( ) const

inline

Definition at line 368 of file DrawPass.cpp.

{ return *fDraw; }

geometryUniformIndex()

UniformCache::Index skgpu::graphite::DrawPass::SortKey::geometryUniformIndex ( ) const

inline

Definition at line 373 of file DrawPass.cpp.

                                                   {
        return GeometryUniformField::get(fUniformKey);
    }

operator<()

bool skgpu::graphite::DrawPass::SortKey::operator< ( const SortKey &  k ) const

inline

Definition at line 359 of file DrawPass.cpp.

                                           {
        return fPipelineKey < k.fPipelineKey ||
               (fPipelineKey == k.fPipelineKey && fUniformKey < k.fUniformKey);
    }

pipelineIndex()

GraphicsPipelineCache::Index skgpu::graphite::DrawPass::SortKey::pipelineIndex ( ) const

inline

Definition at line 370 of file DrawPass.cpp.

                                                     {
        return PipelineField::get(fPipelineKey);
    }

renderStep()

const RenderStep & skgpu::graphite::DrawPass::SortKey::renderStep ( ) const

inline

Definition at line 364 of file DrawPass.cpp.

                                         {
        return fDraw->fRenderer->step(RenderStepField::get(fPipelineKey));
    }

shadingUniformIndex()

UniformCache::Index skgpu::graphite::DrawPass::SortKey::shadingUniformIndex ( ) const

inline

Definition at line 376 of file DrawPass.cpp.

                                                  {
        return ShadingUniformField::get(fUniformKey);
    }

textureBindingIndex()

TextureBindingCache::Index skgpu::graphite::DrawPass::SortKey::textureBindingIndex ( ) const

inline

Definition at line 379 of file DrawPass.cpp.

                                                         {
        return TextureBindingsField::get(fUniformKey);
    }

---

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

• third_party/skia/src/gpu/graphite/DrawPass.cpp