skgpu::graphite::Caps Class Reference

#include <Caps.h>

Inheritance diagram for skgpu::graphite::Caps:

Classes
struct	ColorTypeInfo

Public Member Functions
virtual	~Caps ()
const SkSL::ShaderCaps *	shaderCaps () const
sk_sp< SkCapabilities >	capabilities () const
virtual TextureInfo	getDefaultSampledTextureInfo (SkColorType, Mipmapped mipmapped, Protected, Renderable) const =0
virtual TextureInfo	getTextureInfoForSampledCopy (const TextureInfo &textureInfo, Mipmapped mipmapped) const =0
virtual TextureInfo	getDefaultCompressedTextureInfo (SkTextureCompressionType, Mipmapped mipmapped, Protected) const =0
virtual TextureInfo	getDefaultMSAATextureInfo (const TextureInfo &singleSampledInfo, Discardable discardable) const =0
virtual TextureInfo	getDefaultDepthStencilTextureInfo (SkEnumBitMask< DepthStencilFlags >, uint32_t sampleCount, Protected) const =0
virtual TextureInfo	getDefaultStorageTextureInfo (SkColorType) const =0
virtual SkISize	getDepthAttachmentDimensions (const TextureInfo &, const SkISize colorAttachmentDimensions) const
virtual UniqueKey	makeGraphicsPipelineKey (const GraphicsPipelineDesc &, const RenderPassDesc &) const =0
virtual UniqueKey	makeComputePipelineKey (const ComputePipelineDesc &) const =0
virtual GraphiteResourceKey	makeSamplerKey (const SamplerDesc &samplerDesc) const
virtual ImmutableSamplerInfo	getImmutableSamplerInfo (const TextureProxy *) const
virtual bool	extractGraphicsDescs (const UniqueKey &, GraphicsPipelineDesc *, RenderPassDesc *, const RendererProvider *) const
bool	areColorTypeAndTextureInfoCompatible (SkColorType, const TextureInfo &) const
virtual uint32_t	channelMask (const TextureInfo &) const =0
bool	isTexturable (const TextureInfo &) const
virtual bool	isRenderable (const TextureInfo &) const =0
virtual bool	isStorage (const TextureInfo &) const =0
int	maxTextureSize () const
int	defaultMSAASamplesCount () const
virtual void	buildKeyForTexture (SkISize dimensions, const TextureInfo &, ResourceType, Shareable, GraphiteResourceKey *) const =0
const ResourceBindingRequirements &	resourceBindingRequirements () const
size_t	requiredUniformBufferAlignment () const
size_t	requiredStorageBufferAlignment () const
size_t	requiredTransferBufferAlignment () const
size_t	getAlignedTextureDataRowBytes (size_t rowBytes) const
virtual bool	supportsWritePixels (const TextureInfo &textureInfo) const =0
virtual bool	supportsReadPixels (const TextureInfo &textureInfo) const =0
virtual std::pair< SkColorType, bool >	supportedWritePixelsColorType (SkColorType dstColorType, const TextureInfo &dstTextureInfo, SkColorType srcColorType) const =0
virtual std::pair< SkColorType, bool >	supportedReadPixelsColorType (SkColorType srcColorType, const TextureInfo &srcTextureInfo, SkColorType dstColorType) const =0
SkColorType	getRenderableColorType (SkColorType) const
bool	clampToBorderSupport () const
bool	protectedSupport () const
bool	semaphoreSupport () const
bool	allowCpuSync () const
bool	storageBufferSupport () const
bool	storageBufferPreferred () const
bool	drawBufferCanBeMapped () const
bool	bufferMapsAreAsync () const
bool	msaaRenderToSingleSampledSupport () const
bool	computeSupport () const
bool	supportsAHardwareBufferImages () const
skgpu::Swizzle	getReadSwizzle (SkColorType, const TextureInfo &) const
skgpu::Swizzle	getWriteSwizzle (SkColorType, const TextureInfo &) const
skgpu::ShaderErrorHandler *	shaderErrorHandler () const
DstReadRequirement	getDstReadRequirement () const
float	minDistanceFieldFontSize () const
float	glyphsAsPathsFontSize () const
size_t	glyphCacheTextureMaximumBytes () const
int	maxPathAtlasTextureSize () const
bool	allowMultipleAtlasTextures () const
bool	supportBilerpFromGlyphAtlas () const
bool	requireOrderedRecordings () const
bool	fullCompressedUploadSizeMustAlignToBlockDims () const
sktext::gpu::SDFTControl	getSDFTControl (bool useSDFTForSmallText) const
bool	setBackendLabels () const

Protected Member Functions
	Caps ()
void	finishInitialization (const ContextOptions &)

Static Protected Member Functions
static uint32_t	SamplesToKey (uint32_t numSamples)

Protected Attributes
int	fMaxTextureSize = 0
int	fDefaultMSAASamples = 4
size_t	fRequiredUniformBufferAlignment = 0
size_t	fRequiredStorageBufferAlignment = 0
size_t	fRequiredTransferBufferAlignment = 0
size_t	fTextureDataRowBytesAlignment = 1
std::unique_ptr< SkSL::ShaderCaps >	fShaderCaps
bool	fClampToBorderSupport = true
bool	fProtectedSupport = false
bool	fSemaphoreSupport = false
bool	fAllowCpuSync = true
bool	fStorageBufferSupport = false
bool	fStorageBufferPreferred = false
bool	fDrawBufferCanBeMapped = true
bool	fBufferMapsAreAsync = false
bool	fMSAARenderToSingleSampledSupport = false
bool	fComputeSupport = false
bool	fSupportsAHardwareBufferImages = false
bool	fFullCompressedUploadSizeMustAlignToBlockDims = false
ResourceBindingRequirements	fResourceBindingReqs
ShaderErrorHandler *	fShaderErrorHandler = nullptr
size_t	fGlyphCacheTextureMaximumBytes = 2048 * 1024 * 4
float	fMinDistanceFieldFontSize = 18
float	fGlyphsAsPathsFontSize = 324
int	fMaxPathAtlasTextureSize = 8192
bool	fAllowMultipleAtlasTextures = true
bool	fSupportBilerpFromGlyphAtlas = false
bool	fRequireOrderedRecordings = false
bool	fSetBackendLabels = false

Private Member Functions
virtual bool	onIsTexturable (const TextureInfo &) const =0
virtual const ColorTypeInfo *	getColorTypeInfo (SkColorType, const TextureInfo &) const =0

Detailed Description

Definition at line 71 of file Caps.h.

Constructor & Destructor Documentation

~Caps()

skgpu::graphite::Caps::~Caps ( )

virtual

Definition at line 27 of file Caps.cpp.

{}

Caps()

skgpu::graphite::Caps::Caps ( )

protected

Definition at line 23 of file Caps.cpp.

        : fShaderCaps(std::make_unique<SkSL::ShaderCaps>())
        , fCapabilities(new SkCapabilities()) {}

Member Function Documentation

allowCpuSync()

bool skgpu::graphite::Caps::allowCpuSync ( ) const

inline

Definition at line 232 of file Caps.h.

{ return fAllowCpuSync; }

allowMultipleAtlasTextures()

bool skgpu::graphite::Caps::allowMultipleAtlasTextures ( ) const

inline

Definition at line 284 of file Caps.h.

{ return fAllowMultipleAtlasTextures; }

areColorTypeAndTextureInfoCompatible()

bool skgpu::graphite::Caps::areColorTypeAndTextureInfoCompatible	(	SkColorType	ct,
		const TextureInfo &	info
	)		const

Definition at line 85 of file Caps.cpp.

                                                                                             {
    // TODO: add SkTextureCompressionType handling
    // (can be handled by setting up the colorTypeInfo instead?)
 
    return SkToBool(this->getColorTypeInfo(ct, info));
}

bufferMapsAreAsync()

bool skgpu::graphite::Caps::bufferMapsAreAsync ( ) const

inline

Definition at line 251 of file Caps.h.

{ return fBufferMapsAreAsync; }

buildKeyForTexture()

virtual void skgpu::graphite::Caps::buildKeyForTexture ( SkISize  dimensions, const TextureInfo &  , ResourceType  , Shareable  , GraphiteResourceKey *    ) const

pure virtual

Implemented in skgpu::graphite::DawnCaps, skgpu::graphite::MtlCaps, and skgpu::graphite::VulkanCaps.

capabilities()

sk_sp< SkCapabilities > skgpu::graphite::Caps::capabilities

(

)

const

Definition at line 59 of file Caps.cpp.

{ return fCapabilities; }

channelMask()

virtual uint32_t skgpu::graphite::Caps::channelMask ( const TextureInfo &  ) const

pure virtual

Implemented in skgpu::graphite::DawnCaps, skgpu::graphite::MtlCaps, and skgpu::graphite::VulkanCaps.

clampToBorderSupport()

bool skgpu::graphite::Caps::clampToBorderSupport ( ) const

inline

Definition at line 224 of file Caps.h.

{ return fClampToBorderSupport; }

computeSupport()

bool skgpu::graphite::Caps::computeSupport ( ) const

inline

Definition at line 257 of file Caps.h.

{ return fComputeSupport; }

defaultMSAASamplesCount()

int skgpu::graphite::Caps::defaultMSAASamplesCount ( ) const

inline

Definition at line 142 of file Caps.h.

{ return fDefaultMSAASamples; }

drawBufferCanBeMapped()

bool skgpu::graphite::Caps::drawBufferCanBeMapped ( ) const

inline

Definition at line 242 of file Caps.h.

{ return fDrawBufferCanBeMapped; }

extractGraphicsDescs()

virtual bool skgpu::graphite::Caps::extractGraphicsDescs ( const UniqueKey &  , GraphicsPipelineDesc *  , RenderPassDesc *  , const RendererProvider *    ) const

inlinevirtual

Reimplemented in skgpu::graphite::MtlCaps.

Definition at line 129 of file Caps.h.

                                                                     { return false; }

finishInitialization()

void skgpu::graphite::Caps::finishInitialization ( const ContextOptions &  options )

protected

Definition at line 29 of file Caps.cpp.

                                                             {
    fCapabilities->initSkCaps(fShaderCaps.get());
 
    fDefaultMSAASamples = options.fInternalMultisampleCount;
 
    if (options.fShaderErrorHandler) {
        fShaderErrorHandler = options.fShaderErrorHandler;
    } else {
        fShaderErrorHandler = DefaultShaderErrorHandler();
    }
 
#if defined(GRAPHITE_TEST_UTILS)
    if (options.fOptionsPriv) {
        fMaxTextureSize = std::min(fMaxTextureSize, options.fOptionsPriv->fMaxTextureSizeOverride);
        fMaxTextureAtlasSize = options.fOptionsPriv->fMaxTextureAtlasSize;
        fRequestedPathRendererStrategy = options.fOptionsPriv->fPathRendererStrategy;
    }
#endif
    fGlyphCacheTextureMaximumBytes = options.fGlyphCacheTextureMaximumBytes;
    fMinDistanceFieldFontSize = options.fMinDistanceFieldFontSize;
    fGlyphsAsPathsFontSize = options.fGlyphsAsPathsFontSize;
    fMaxPathAtlasTextureSize = options.fMaxPathAtlasTextureSize;
    fAllowMultipleAtlasTextures = options.fAllowMultipleAtlasTextures;
    fSupportBilerpFromGlyphAtlas = options.fSupportBilerpFromGlyphAtlas;
    if (options.fDisableCachedGlyphUploads) {
        fRequireOrderedRecordings = true;
    }
    fSetBackendLabels = options.fSetBackendLabels;
}

fullCompressedUploadSizeMustAlignToBlockDims()

bool skgpu::graphite::Caps::fullCompressedUploadSizeMustAlignToBlockDims ( ) const

inline

Definition at line 291 of file Caps.h.

                                                              {
        return fFullCompressedUploadSizeMustAlignToBlockDims;
    }

getAlignedTextureDataRowBytes()

size_t skgpu::graphite::Caps::getAlignedTextureDataRowBytes ( size_t  rowBytes ) const

inline

Definition at line 166 of file Caps.h.

                                                                {
        return SkAlignTo(rowBytes, fTextureDataRowBytesAlignment);
    }

getColorTypeInfo()

virtual const ColorTypeInfo * skgpu::graphite::Caps::getColorTypeInfo ( SkColorType  , const TextureInfo &    ) const

privatepure virtual

getDefaultCompressedTextureInfo()

virtual TextureInfo skgpu::graphite::Caps::getDefaultCompressedTextureInfo ( SkTextureCompressionType  , Mipmapped  mipmapped, Protected    ) const

pure virtual

Implemented in skgpu::graphite::DawnCaps, skgpu::graphite::MtlCaps, and skgpu::graphite::VulkanCaps.

getDefaultDepthStencilTextureInfo()

virtual TextureInfo skgpu::graphite::Caps::getDefaultDepthStencilTextureInfo ( SkEnumBitMask< DepthStencilFlags >  , uint32_t  sampleCount, Protected    ) const

pure virtual

Implemented in skgpu::graphite::DawnCaps, skgpu::graphite::MtlCaps, and skgpu::graphite::VulkanCaps.

getDefaultMSAATextureInfo()

virtual TextureInfo skgpu::graphite::Caps::getDefaultMSAATextureInfo ( const TextureInfo &  singleSampledInfo, Discardable  discardable  ) const

pure virtual

Implemented in skgpu::graphite::DawnCaps, skgpu::graphite::MtlCaps, and skgpu::graphite::VulkanCaps.

getDefaultSampledTextureInfo()

virtual TextureInfo skgpu::graphite::Caps::getDefaultSampledTextureInfo ( SkColorType  , Mipmapped  mipmapped, Protected  , Renderable    ) const

pure virtual

Implemented in skgpu::graphite::DawnCaps, skgpu::graphite::MtlCaps, and skgpu::graphite::VulkanCaps.

getDefaultStorageTextureInfo()

virtual TextureInfo skgpu::graphite::Caps::getDefaultStorageTextureInfo ( SkColorType  ) const

pure virtual

Implemented in skgpu::graphite::DawnCaps, skgpu::graphite::MtlCaps, and skgpu::graphite::VulkanCaps.

getDepthAttachmentDimensions()

SkISize skgpu::graphite::Caps::getDepthAttachmentDimensions ( const TextureInfo &  textureInfo, const SkISize  colorAttachmentDimensions  ) const

virtual

Reimplemented in skgpu::graphite::DawnCaps.

Definition at line 61 of file Caps.cpp.

                                                                                          {
    return colorAttachmentDimensions;
}

getDstReadRequirement()

DstReadRequirement skgpu::graphite::Caps::getDstReadRequirement

(

)

const

Definition at line 152 of file Caps.cpp.

                                                     {
    // TODO(b/238757201): Currently this only supports dst reads by FB fetch and texture copy.
    if (this->shaderCaps()->fFBFetchSupport) {
        return DstReadRequirement::kFramebufferFetch;
    } else {
        return DstReadRequirement::kTextureCopy;
    }
}

getImmutableSamplerInfo()

virtual ImmutableSamplerInfo skgpu::graphite::Caps::getImmutableSamplerInfo ( const TextureProxy *  ) const

inlinevirtual

Reimplemented in skgpu::graphite::VulkanCaps.

Definition at line 125 of file Caps.h.

                                                                                    {
        return {};
    }

getReadSwizzle()

skgpu::Swizzle skgpu::graphite::Caps::getReadSwizzle	(	SkColorType	ct,
		const TextureInfo &	info
	)		const

Definition at line 129 of file Caps.cpp.

                                                                               {
    // TODO: add SkTextureCompressionType handling
    // (can be handled by setting up the colorTypeInfo instead?)
 
    auto colorTypeInfo = this->getColorTypeInfo(ct, info);
    if (!colorTypeInfo) {
        SkDEBUGFAILF("Illegal color type (%d) and format combination.", static_cast<int>(ct));
        return {};
    }
 
    return colorTypeInfo->fReadSwizzle;
}

getRenderableColorType()

SkColorType skgpu::graphite::Caps::getRenderableColorType

(

SkColorType

ct

)

const

Checks whether the passed color type is renderable. If so, the same color type is passed back. If not, provides an alternative (perhaps lower bit depth and/or unorm instead of float) color type that is supported or kUnknown if there no renderable fallback format.

Definition at line 114 of file Caps.cpp.

                                                             {
    do {
        auto texInfo = this->getDefaultSampledTextureInfo(ct,
                                                          Mipmapped::kNo,
                                                          Protected::kNo,
                                                          Renderable::kYes);
        // We continue to the fallback color type if there is no default renderable format
        if (texInfo.isValid() && this->isRenderable(texInfo)) {
            return ct;
        }
        ct = color_type_fallback(ct);
    } while (ct != kUnknown_SkColorType);
    return kUnknown_SkColorType;
}

getSDFTControl()

sktext::gpu::SDFTControl skgpu::graphite::Caps::getSDFTControl

(

bool

useSDFTForSmallText

)

const

Definition at line 161 of file Caps.cpp.

                                                                        {
#if !defined(SK_DISABLE_SDF_TEXT)
    return sktext::gpu::SDFTControl{
            this->shaderCaps()->supportsDistanceFieldText(),
            useSDFTForSmallText,
            true, /*ableToUsePerspectiveSDFT*/
            this->minDistanceFieldFontSize(),
            this->glyphsAsPathsFontSize()};
#else
    return sktext::gpu::SDFTControl{};
#endif
}

getTextureInfoForSampledCopy()

virtual TextureInfo skgpu::graphite::Caps::getTextureInfoForSampledCopy ( const TextureInfo &  textureInfo, Mipmapped  mipmapped  ) const

pure virtual

Implemented in skgpu::graphite::DawnCaps, skgpu::graphite::MtlCaps, and skgpu::graphite::VulkanCaps.

getWriteSwizzle()

skgpu::Swizzle skgpu::graphite::Caps::getWriteSwizzle	(	SkColorType	ct,
		const TextureInfo &	info
	)		const

Definition at line 142 of file Caps.cpp.

                                                                                {
    auto colorTypeInfo = this->getColorTypeInfo(ct, info);
    if (!colorTypeInfo) {
        SkDEBUGFAILF("Illegal color type (%d) and format combination.", static_cast<int>(ct));
        return {};
    }
 
    return colorTypeInfo->fWriteSwizzle;
}

glyphCacheTextureMaximumBytes()

size_t skgpu::graphite::Caps::glyphCacheTextureMaximumBytes ( ) const

inline

Definition at line 281 of file Caps.h.

{ return fGlyphCacheTextureMaximumBytes; }

glyphsAsPathsFontSize()

float skgpu::graphite::Caps::glyphsAsPathsFontSize ( ) const

inline

Definition at line 279 of file Caps.h.

{ return fGlyphsAsPathsFontSize; }

isRenderable()

virtual bool skgpu::graphite::Caps::isRenderable ( const TextureInfo &  ) const

pure virtual

Implemented in skgpu::graphite::DawnCaps, skgpu::graphite::MtlCaps, and skgpu::graphite::VulkanCaps.

isStorage()

virtual bool skgpu::graphite::Caps::isStorage ( const TextureInfo &  ) const

pure virtual

Implemented in skgpu::graphite::DawnCaps, skgpu::graphite::MtlCaps, and skgpu::graphite::VulkanCaps.

isTexturable()

bool skgpu::graphite::Caps::isTexturable

(

const TextureInfo &

info

)

const

Definition at line 66 of file Caps.cpp.

                                                     {
    if (info.numSamples() > 1) {
        return false;
    }
    return this->onIsTexturable(info);
}

makeComputePipelineKey()

virtual UniqueKey skgpu::graphite::Caps::makeComputePipelineKey ( const ComputePipelineDesc &  ) const

pure virtual

Implemented in skgpu::graphite::DawnCaps, skgpu::graphite::MtlCaps, and skgpu::graphite::VulkanCaps.

makeGraphicsPipelineKey()

virtual UniqueKey skgpu::graphite::Caps::makeGraphicsPipelineKey ( const GraphicsPipelineDesc &  , const RenderPassDesc &    ) const

pure virtual

Implemented in skgpu::graphite::DawnCaps, skgpu::graphite::MtlCaps, and skgpu::graphite::VulkanCaps.

makeSamplerKey()

GraphiteResourceKey skgpu::graphite::Caps::makeSamplerKey ( const SamplerDesc &  samplerDesc ) const

virtual

Reimplemented in skgpu::graphite::VulkanCaps.

Definition at line 73 of file Caps.cpp.

                                                                             {
    GraphiteResourceKey samplerKey;
    static const ResourceType kType = GraphiteResourceKey::GenerateResourceType();
    GraphiteResourceKey::Builder builder(&samplerKey, kType, /*data32Count=*/1, Shareable::kYes);
 
    // The default impl. of this method adds no additional backend information to the key.
    builder[0] = samplerDesc.desc();
 
    builder.finish();
    return samplerKey;
}

maxPathAtlasTextureSize()

int skgpu::graphite::Caps::maxPathAtlasTextureSize ( ) const

inline

Definition at line 282 of file Caps.h.

{ return fMaxPathAtlasTextureSize; }

maxTextureSize()

int skgpu::graphite::Caps::maxTextureSize ( ) const

inline

Definition at line 141 of file Caps.h.

{ return fMaxTextureSize; }

minDistanceFieldFontSize()

float skgpu::graphite::Caps::minDistanceFieldFontSize ( ) const

inline

Definition at line 278 of file Caps.h.

{ return fMinDistanceFieldFontSize; }

msaaRenderToSingleSampledSupport()

bool skgpu::graphite::Caps::msaaRenderToSingleSampledSupport ( ) const

inline

Definition at line 254 of file Caps.h.

{ return fMSAARenderToSingleSampledSupport; }

onIsTexturable()

virtual bool skgpu::graphite::Caps::onIsTexturable ( const TextureInfo &  ) const

privatepure virtual

protectedSupport()

bool skgpu::graphite::Caps::protectedSupport ( ) const

inline

Definition at line 226 of file Caps.h.

{ return fProtectedSupport; }

requiredStorageBufferAlignment()

size_t skgpu::graphite::Caps::requiredStorageBufferAlignment ( ) const

inline

Definition at line 160 of file Caps.h.

{ return fRequiredStorageBufferAlignment; }

requiredTransferBufferAlignment()

size_t skgpu::graphite::Caps::requiredTransferBufferAlignment ( ) const

inline

Definition at line 163 of file Caps.h.

{ return fRequiredTransferBufferAlignment; }

requiredUniformBufferAlignment()

size_t skgpu::graphite::Caps::requiredUniformBufferAlignment ( ) const

inline

Definition at line 156 of file Caps.h.

{ return fRequiredUniformBufferAlignment; }

requireOrderedRecordings()

bool skgpu::graphite::Caps::requireOrderedRecordings ( ) const

inline

Definition at line 287 of file Caps.h.

{ return fRequireOrderedRecordings; }

resourceBindingRequirements()

const ResourceBindingRequirements & skgpu::graphite::Caps::resourceBindingRequirements ( ) const

inline

Definition at line 150 of file Caps.h.

                                                                           {
        return fResourceBindingReqs;
    }

SamplesToKey()

static uint32_t skgpu::graphite::Caps::SamplesToKey ( uint32_t  numSamples )

inlinestaticprotected

Definition at line 314 of file Caps.h.

                                                             {
        switch (numSamples) {
            case 1:
                return 0;
            case 2:
                return 1;
            case 4:
                return 2;
            case 8:
                return 3;
            case 16:
                return 4;
            default:
                SkUNREACHABLE;
        }
    }

semaphoreSupport()

bool skgpu::graphite::Caps::semaphoreSupport ( ) const

inline

Definition at line 229 of file Caps.h.

{ return fSemaphoreSupport; }

setBackendLabels()

bool skgpu::graphite::Caps::setBackendLabels ( ) const

inline

Definition at line 297 of file Caps.h.

{ return fSetBackendLabels; }

shaderCaps()

const SkSL::ShaderCaps * skgpu::graphite::Caps::shaderCaps ( ) const

inline

Definition at line 75 of file Caps.h.

{ return fShaderCaps.get(); }

shaderErrorHandler()

skgpu::ShaderErrorHandler * skgpu::graphite::Caps::shaderErrorHandler ( ) const

inline

Definition at line 273 of file Caps.h.

{ return fShaderErrorHandler; }

storageBufferPreferred()

bool skgpu::graphite::Caps::storageBufferPreferred ( ) const

inline

Definition at line 239 of file Caps.h.

{ return fStorageBufferPreferred; }

storageBufferSupport()

bool skgpu::graphite::Caps::storageBufferSupport ( ) const

inline

Definition at line 235 of file Caps.h.

{ return fStorageBufferSupport; }

supportBilerpFromGlyphAtlas()

bool skgpu::graphite::Caps::supportBilerpFromGlyphAtlas ( ) const

inline

Definition at line 285 of file Caps.h.

{ return fSupportBilerpFromGlyphAtlas; }

supportedReadPixelsColorType()

virtual std::pair< SkColorType, bool > skgpu::graphite::Caps::supportedReadPixelsColorType ( SkColorType  srcColorType, const TextureInfo &  srcTextureInfo, SkColorType  dstColorType  ) const

pure virtual

Given a src surface's color type and its texture info as well as a color type the caller would like read into, this provides a legal color type that the caller can use for readPixels. The returned color type may differ from the passed dstColorType, in which case the caller must convert the read pixel data (see GrConvertPixels). When converting to dstColorType the swizzle in the returned struct should be applied. The caller must check the returned color type for kUnknown.

We currently don't have an SkColorType for a 3 channel RGB format. Additionally the current implementation of raster pipeline requires power of 2 channels, so it is not easy to add such an SkColorType. Thus we need to check for data that is 3 channels using the isRGBFormat return value and handle it manually

supportedWritePixelsColorType()

virtual std::pair< SkColorType, bool > skgpu::graphite::Caps::supportedWritePixelsColorType ( SkColorType  dstColorType, const TextureInfo &  dstTextureInfo, SkColorType  srcColorType  ) const

pure virtual

Given a dst pixel config and a src color type what color type must the caller coax the the data into in order to use writePixels.

We currently don't have an SkColorType for a 3 channel RGB format. Additionally the current implementation of raster pipeline requires power of 2 channels, so it is not easy to add such an SkColorType. Thus we need to check for data that is 3 channels using the isRGBFormat return value and handle it manually

supportsAHardwareBufferImages()

bool skgpu::graphite::Caps::supportsAHardwareBufferImages ( ) const

inline

Returns true if the given backend supports importing AHardwareBuffers. This will only ever be supported on Android devices with API level >= 26.

Definition at line 263 of file Caps.h.

{ return fSupportsAHardwareBufferImages; }

supportsReadPixels()

virtual bool skgpu::graphite::Caps::supportsReadPixels ( const TextureInfo &  textureInfo ) const

pure virtual

Backends may have restrictions on what types of textures support Device::readPixels(). If this returns false then the caller should implement a fallback where a temporary texture is created, the original texture is copied or drawn into it, and then pixels read from the temporary texture.

supportsWritePixels()

virtual bool skgpu::graphite::Caps::supportsWritePixels ( const TextureInfo &  textureInfo ) const

pure virtual

Backends may have restrictions on what types of textures support Device::writePixels(). If this returns false then the caller should implement a fallback where a temporary texture is created, pixels are written to it, and then that is copied or drawn into the the surface.

Member Data Documentation

fAllowCpuSync

bool skgpu::graphite::Caps::fAllowCpuSync = true

protected

Definition at line 368 of file Caps.h.

fAllowMultipleAtlasTextures

bool skgpu::graphite::Caps::fAllowMultipleAtlasTextures = true

protected

Definition at line 406 of file Caps.h.

fBufferMapsAreAsync

bool skgpu::graphite::Caps::fBufferMapsAreAsync = false

protected

Definition at line 372 of file Caps.h.

fClampToBorderSupport

bool skgpu::graphite::Caps::fClampToBorderSupport = true

protected

Definition at line 365 of file Caps.h.

fComputeSupport

bool skgpu::graphite::Caps::fComputeSupport = false

protected

Definition at line 375 of file Caps.h.

fDefaultMSAASamples

int skgpu::graphite::Caps::fDefaultMSAASamples = 4

protected

Definition at line 357 of file Caps.h.

fDrawBufferCanBeMapped

bool skgpu::graphite::Caps::fDrawBufferCanBeMapped = true

protected

Definition at line 371 of file Caps.h.

fFullCompressedUploadSizeMustAlignToBlockDims

bool skgpu::graphite::Caps::fFullCompressedUploadSizeMustAlignToBlockDims = false

protected

Definition at line 377 of file Caps.h.

fGlyphCacheTextureMaximumBytes

size_t skgpu::graphite::Caps::fGlyphCacheTextureMaximumBytes = 2048 * 1024 * 4

protected

Definition at line 399 of file Caps.h.

fGlyphsAsPathsFontSize

float skgpu::graphite::Caps::fGlyphsAsPathsFontSize = 324

protected

Definition at line 402 of file Caps.h.

fMaxPathAtlasTextureSize

int skgpu::graphite::Caps::fMaxPathAtlasTextureSize = 8192

protected

Definition at line 404 of file Caps.h.

fMaxTextureSize

int skgpu::graphite::Caps::fMaxTextureSize = 0

protected

Definition at line 356 of file Caps.h.

fMinDistanceFieldFontSize

float skgpu::graphite::Caps::fMinDistanceFieldFontSize = 18

protected

Definition at line 401 of file Caps.h.

fMSAARenderToSingleSampledSupport

bool skgpu::graphite::Caps::fMSAARenderToSingleSampledSupport = false

protected

Definition at line 373 of file Caps.h.

fProtectedSupport

bool skgpu::graphite::Caps::fProtectedSupport = false

protected

Definition at line 366 of file Caps.h.

fRequiredStorageBufferAlignment

size_t skgpu::graphite::Caps::fRequiredStorageBufferAlignment = 0

protected

Definition at line 359 of file Caps.h.

fRequiredTransferBufferAlignment

size_t skgpu::graphite::Caps::fRequiredTransferBufferAlignment = 0

protected

Definition at line 360 of file Caps.h.

fRequiredUniformBufferAlignment

size_t skgpu::graphite::Caps::fRequiredUniformBufferAlignment = 0

protected

Definition at line 358 of file Caps.h.

fRequireOrderedRecordings

bool skgpu::graphite::Caps::fRequireOrderedRecordings = false

protected

Definition at line 410 of file Caps.h.

fResourceBindingReqs

ResourceBindingRequirements skgpu::graphite::Caps::fResourceBindingReqs

protected

Definition at line 383 of file Caps.h.

fSemaphoreSupport

bool skgpu::graphite::Caps::fSemaphoreSupport = false

protected

Definition at line 367 of file Caps.h.

fSetBackendLabels

bool skgpu::graphite::Caps::fSetBackendLabels = false

protected

Definition at line 412 of file Caps.h.

fShaderCaps

std::unique_ptr<SkSL::ShaderCaps> skgpu::graphite::Caps::fShaderCaps

protected

Definition at line 363 of file Caps.h.

fShaderErrorHandler

ShaderErrorHandler* skgpu::graphite::Caps::fShaderErrorHandler = nullptr

protected

If present, use this object to report shader compilation failures. If not, report failures via SkDebugf and assert.

Definition at line 392 of file Caps.h.

fStorageBufferPreferred

bool skgpu::graphite::Caps::fStorageBufferPreferred = false

protected

Definition at line 370 of file Caps.h.

fStorageBufferSupport

bool skgpu::graphite::Caps::fStorageBufferSupport = false

protected

Definition at line 369 of file Caps.h.

fSupportBilerpFromGlyphAtlas

bool skgpu::graphite::Caps::fSupportBilerpFromGlyphAtlas = false

protected

Definition at line 407 of file Caps.h.

fSupportsAHardwareBufferImages

bool skgpu::graphite::Caps::fSupportsAHardwareBufferImages = false

protected

Definition at line 376 of file Caps.h.

fTextureDataRowBytesAlignment

size_t skgpu::graphite::Caps::fTextureDataRowBytesAlignment = 1

protected

Definition at line 361 of file Caps.h.

---

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

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