skgpu::graphite::DrawOrder Class Reference

#include <DrawOrder.h>

Public Member Functions
	DrawOrder (PaintersDepth originalOrder)
	DrawOrder (PaintersDepth originalOrder, CompressedPaintersOrder compressedOrder)
CompressedPaintersOrder	paintOrder () const
DisjointStencilIndex	stencilIndex () const
PaintersDepth	depth () const
float	depthAsFloat () const
DrawOrder &	dependsOnPaintersOrder (CompressedPaintersOrder prevDraw)
DrawOrder &	dependsOnStencil (DisjointStencilIndex disjointSet)

Static Public Attributes
static constexpr PaintersDepth	kClearDepth = PaintersDepth::First()
static constexpr CompressedPaintersOrder	kNoIntersection = CompressedPaintersOrder::First()
static constexpr DisjointStencilIndex	kUnassigned = DisjointStencilIndex::First()

Detailed Description

DrawOrder aggregates the three separate sequences that Graphite uses to re-order draws and their substeps as much as possible while preserving the painter's order semantics of the Skia API.

To build the full DrawOrder for a draw, start with its assigned PaintersDepth (i.e. the original painter's order of the draw call). From there, the DrawOrder can be updated to reflect dependencies on previous draws, either from depth-only clip draws or because the draw is transparent and must blend with the previous color values. Lastly, once the CompressedPaintersOrder is finalized, the DrawOrder can be updated to reflect whether or not the draw will involve the stencil buffer–and if so, specify the disjoint stencil set it belongs to.

The original and effective order that draws are executed in is defined by the PaintersDepth. However, the actual execution order is defined by first the CompressedPaintersOrder and then the DisjointStencilIndex. This means that draws with much higher depths can be executed earlier if painter's order compression allows for it.

Definition at line 105 of file DrawOrder.h.

Constructor & Destructor Documentation

DrawOrder() [1/2]

skgpu::graphite::DrawOrder::DrawOrder ( PaintersDepth  originalOrder )

inlineexplicit

Definition at line 117 of file DrawOrder.h.

            : fPaintOrder(kNoIntersection)
            , fStencilIndex(kUnassigned)
            , fDepth(originalOrder) {}

DrawOrder() [2/2]

skgpu::graphite::DrawOrder::DrawOrder ( PaintersDepth  originalOrder, CompressedPaintersOrder  compressedOrder  )

inline

Definition at line 122 of file DrawOrder.h.

            : fPaintOrder(compressedOrder)
            , fStencilIndex(kUnassigned)
            , fDepth(originalOrder) {}

Member Function Documentation

dependsOnPaintersOrder()

DrawOrder & skgpu::graphite::DrawOrder::dependsOnPaintersOrder ( CompressedPaintersOrder  prevDraw )

inline

Definition at line 133 of file DrawOrder.h.

                                                                        {
        // A draw must be ordered after all previous draws that it depends on
        CompressedPaintersOrder next = prevDraw.next();
        if (fPaintOrder < next) {
            fPaintOrder = next;
        }
        return *this;
    }

dependsOnStencil()

DrawOrder & skgpu::graphite::DrawOrder::dependsOnStencil ( DisjointStencilIndex  disjointSet )

inline

Definition at line 142 of file DrawOrder.h.

                                                                  {
        // Stencil usage should only be set once
        SkASSERT(fStencilIndex == kUnassigned);
        fStencilIndex = disjointSet;
        return *this;
    }

depth()

PaintersDepth skgpu::graphite::DrawOrder::depth ( ) const

inline

Definition at line 129 of file DrawOrder.h.

{ return fDepth;        }

depthAsFloat()

float skgpu::graphite::DrawOrder::depthAsFloat ( ) const

inline

Definition at line 131 of file DrawOrder.h.

{ return fDepth.bits() / (float) PaintersDepth::Last().bits(); }

paintOrder()

CompressedPaintersOrder skgpu::graphite::DrawOrder::paintOrder ( ) const

inline

Definition at line 127 of file DrawOrder.h.

{ return fPaintOrder;   }

stencilIndex()

DisjointStencilIndex skgpu::graphite::DrawOrder::stencilIndex ( ) const

inline

Definition at line 128 of file DrawOrder.h.

{ return fStencilIndex; }

Member Data Documentation

kClearDepth

constexpr PaintersDepth skgpu::graphite::DrawOrder::kClearDepth = PaintersDepth::First()

inlinestaticconstexpr

Definition at line 109 of file DrawOrder.h.

kNoIntersection

constexpr CompressedPaintersOrder skgpu::graphite::DrawOrder::kNoIntersection = CompressedPaintersOrder::First()

inlinestaticconstexpr

Definition at line 113 of file DrawOrder.h.

kUnassigned

constexpr DisjointStencilIndex skgpu::graphite::DrawOrder::kUnassigned = DisjointStencilIndex::First()

inlinestaticconstexpr

Definition at line 115 of file DrawOrder.h.

---

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

• third_party/skia/src/gpu/graphite/DrawOrder.h