skgpu::graphite::RenderPassDesc Struct Reference

#include <RenderPassDesc.h>

Public Member Functions
SkString	toString () const
SkString	toPipelineLabel () const

Static Public Member Functions
static RenderPassDesc	Make (const Caps *caps, const TextureInfo &targetInfo, LoadOp loadOp, StoreOp storeOp, SkEnumBitMask< DepthStencilFlags > depthStencilFlags, const std::array< float, 4 > &clearColor, bool requiresMSAA, Swizzle writeSwizzle)

Public Attributes
AttachmentDesc	fColorAttachment
std::array< float, 4 >	fClearColor
AttachmentDesc	fColorResolveAttachment
AttachmentDesc	fDepthStencilAttachment
float	fClearDepth
uint32_t	fClearStencil
Swizzle	fWriteSwizzle
uint32_t	fSampleCount

Detailed Description

Definition at line 31 of file RenderPassDesc.h.

Member Function Documentation

Make()

RenderPassDesc skgpu::graphite::RenderPassDesc::Make ( const Caps *  caps, const TextureInfo &  targetInfo, LoadOp  loadOp, StoreOp  storeOp, SkEnumBitMask< DepthStencilFlags >  depthStencilFlags, const std::array< float, 4 > &  clearColor, bool  requiresMSAA, Swizzle  writeSwizzle  )

static

Definition at line 37 of file RenderPassDesc.cpp.

                                                          {
    RenderPassDesc desc;
    desc.fWriteSwizzle = writeSwizzle;
    desc.fSampleCount = 1;
    // It doesn't make sense to have a storeOp for our main target not be store. Why are we doing
    // this DrawPass then
    SkASSERT(storeOp == StoreOp::kStore);
    if (requiresMSAA) {
        if (caps->msaaRenderToSingleSampledSupport()) {
            desc.fColorAttachment.fTextureInfo = targetInfo;
            desc.fColorAttachment.fLoadOp = loadOp;
            desc.fColorAttachment.fStoreOp = storeOp;
            desc.fSampleCount = caps->defaultMSAASamplesCount();
        } else {
            // TODO: If the resolve texture isn't readable, the MSAA color attachment will need to
            // be persistently associated with the framebuffer, in which case it's not discardable.
            auto msaaTextureInfo = caps->getDefaultMSAATextureInfo(targetInfo, Discardable::kYes);
            if (msaaTextureInfo.isValid()) {
                desc.fColorAttachment.fTextureInfo = msaaTextureInfo;
                if (loadOp != LoadOp::kClear) {
                    desc.fColorAttachment.fLoadOp = LoadOp::kDiscard;
                } else {
                    desc.fColorAttachment.fLoadOp = LoadOp::kClear;
                }
                desc.fColorAttachment.fStoreOp = StoreOp::kDiscard;
 
                desc.fColorResolveAttachment.fTextureInfo = targetInfo;
                if (loadOp != LoadOp::kLoad) {
                    desc.fColorResolveAttachment.fLoadOp = LoadOp::kDiscard;
                } else {
                    desc.fColorResolveAttachment.fLoadOp = LoadOp::kLoad;
                }
                desc.fColorResolveAttachment.fStoreOp = storeOp;
 
                desc.fSampleCount = msaaTextureInfo.numSamples();
            } else {
                // fall back to single sampled
                desc.fColorAttachment.fTextureInfo = targetInfo;
                desc.fColorAttachment.fLoadOp = loadOp;
                desc.fColorAttachment.fStoreOp = storeOp;
            }
        }
    } else {
        desc.fColorAttachment.fTextureInfo = targetInfo;
        desc.fColorAttachment.fLoadOp = loadOp;
        desc.fColorAttachment.fStoreOp = storeOp;
    }
    desc.fClearColor = clearColor;
 
    if (depthStencilFlags != DepthStencilFlags::kNone) {
        desc.fDepthStencilAttachment.fTextureInfo = caps->getDefaultDepthStencilTextureInfo(
                depthStencilFlags, desc.fSampleCount, targetInfo.isProtected());
        // Always clear the depth and stencil to 0 at the start of a DrawPass, but discard at the
        // end since their contents do not affect the next frame.
        desc.fDepthStencilAttachment.fLoadOp = LoadOp::kClear;
        desc.fClearDepth = 0.f;
        desc.fClearStencil = 0;
        desc.fDepthStencilAttachment.fStoreOp = StoreOp::kDiscard;
    }
 
    return desc;
}

toPipelineLabel()

SkString skgpu::graphite::RenderPassDesc::toPipelineLabel

(

)

const

Definition at line 120 of file RenderPassDesc.cpp.

                                               {
    // This intentionally only includes the fixed state that impacts pipeline compilation.
    // We include the load op of the color attachment when there is a resolve attachment because
    // the load may trigger a different renderpass description.
    const char* colorLoadStr = "";
    if (fColorAttachment.fLoadOp == LoadOp::kLoad &&
        (fColorResolveAttachment.fTextureInfo.isValid() || fSampleCount > 1)) {
        colorLoadStr = " w/ msaa load";
    }
    // TODO: Remove `fSampleCount` in label when the Dawn backend manages its MSAA color attachments
    // directly instead of relying on msaaRenderToSingleSampledSupport().
    return SkStringPrintf("RP(color: %s%s, resolve: %s, ds: %s, samples: %u, swizzle: %s)",
                          fColorAttachment.fTextureInfo.toRPAttachmentString().c_str(),
                          colorLoadStr,
                          fColorResolveAttachment.fTextureInfo.toRPAttachmentString().c_str(),
                          fDepthStencilAttachment.fTextureInfo.toRPAttachmentString().c_str(),
                          fSampleCount,
                          fWriteSwizzle.asString().c_str());
}

toString()

SkString skgpu::graphite::RenderPassDesc::toString

(

)

const

Definition at line 107 of file RenderPassDesc.cpp.

                                        {
    return SkStringPrintf("RP(color: %s, resolve: %s, ds: %s, samples: %u, swizzle: %s, "
                          "clear: c(%f,%f,%f,%f), d(%f), s(0x%02x))",
                          fColorAttachment.toString().c_str(),
                          fColorResolveAttachment.toString().c_str(),
                          fDepthStencilAttachment.toString().c_str(),
                          fSampleCount,
                          fWriteSwizzle.asString().c_str(),
                          fClearColor[0], fClearColor[1], fClearColor[2], fClearColor[3],
                          fClearDepth,
                          fClearStencil);
}

Member Data Documentation

fClearColor

std::array<float, 4> skgpu::graphite::RenderPassDesc::fClearColor

Definition at line 42 of file RenderPassDesc.h.

fClearDepth

float skgpu::graphite::RenderPassDesc::fClearDepth

Definition at line 46 of file RenderPassDesc.h.

fClearStencil

uint32_t skgpu::graphite::RenderPassDesc::fClearStencil

Definition at line 47 of file RenderPassDesc.h.

fColorAttachment

AttachmentDesc skgpu::graphite::RenderPassDesc::fColorAttachment

Definition at line 41 of file RenderPassDesc.h.

fColorResolveAttachment

AttachmentDesc skgpu::graphite::RenderPassDesc::fColorResolveAttachment

Definition at line 43 of file RenderPassDesc.h.

fDepthStencilAttachment

AttachmentDesc skgpu::graphite::RenderPassDesc::fDepthStencilAttachment

Definition at line 45 of file RenderPassDesc.h.

fSampleCount

uint32_t skgpu::graphite::RenderPassDesc::fSampleCount

Definition at line 54 of file RenderPassDesc.h.

fWriteSwizzle

Swizzle skgpu::graphite::RenderPassDesc::fWriteSwizzle

Definition at line 49 of file RenderPassDesc.h.

---

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

• third_party/skia/src/gpu/graphite/RenderPassDesc.h
• third_party/skia/src/gpu/graphite/RenderPassDesc.cpp