#include <GrCaps.h>

Inheritance diagram for GrCaps:

Classes
struct	DstCopyRestrictions

struct	SupportedRead

struct	SupportedWrite

Public Types
enum	BlendEquationSupport { kBasic_BlendEquationSupport , kAdvanced_BlendEquationSupport , kAdvancedCoherent_BlendEquationSupport , kLast_BlendEquationSupport = kAdvancedCoherent_BlendEquationSupport }

enum	MapFlags { kNone_MapFlags = 0x0 , kCanMap_MapFlag = 0x1 , kSubset_MapFlag = 0x2 , kAsyncRead_MapFlag = 0x4 }

enum class	SurfaceReadPixelsSupport { kSupported , kCopyToTexture2D , kUnsupported }

enum class	ProgramDescOverrideFlags { kNone = 0 , kVulkanHasResolveLoadSubpass = 0x1 }

Public Member Functions
	GrCaps (const GrContextOptions &)

void	dumpJSON (SkJSONWriter *) const

const GrShaderCaps *	shaderCaps () const

bool	npotTextureTileSupport () const

bool	mipmapSupport () const

bool	anisoSupport () const

bool	gpuTracingSupport () const

bool	oversizedStencilSupport () const

bool	textureBarrierSupport () const

bool	sampleLocationsSupport () const

bool	drawInstancedSupport () const

bool	nativeDrawIndirectSupport () const

bool	useClientSideIndirectBuffers () const

bool	conservativeRasterSupport () const

bool	wireframeSupport () const

bool	msaaResolvesAutomatically () const

bool	preferDiscardableMSAAAttachment () const

bool	halfFloatVertexAttributeSupport () const

bool	usePrimitiveRestart () const

bool	preferClientSideDynamicBuffers () const

bool	preferFullscreenClears () const

bool	discardStencilValuesAfterRenderPass () const

bool	twoSidedStencilRefsAndMasksMustMatch () const

bool	preferVRAMUseOverFlushes () const

bool	avoidStencilBuffers () const

bool	avoidWritePixelsFastPath () const

bool	nativeDrawIndexedIndirectIsBroken () const

BlendEquationSupport	blendEquationSupport () const

bool	advancedBlendEquationSupport () const

bool	advancedCoherentBlendEquationSupport () const

bool	isAdvancedBlendEquationDisabled (skgpu::BlendEquation equation) const

bool	shouldCollapseSrcOverToSrcWhenAble () const

bool	mustSyncGpuDuringAbandon () const

bool	reducedShaderMode () const

uint32_t	mapBufferFlags () const

bool	reuseScratchTextures () const

bool	reuseScratchBuffers () const

int	maxVertexAttributes () const
	maximum number of attribute values per vertex

int	maxRenderTargetSize () const

int	maxPreferredRenderTargetSize () const

int	maxTextureSize () const

int	maxWindowRectangles () const

bool	isWindowRectanglesSupportedForRT (const GrBackendRenderTarget &rt) const

uint32_t	maxPushConstantsSize () const

size_t	transferBufferRowBytesAlignment () const

size_t	transferFromBufferToBufferAlignment () const

size_t	bufferUpdateDataPreserveAlignment () const

virtual bool	isFormatSRGB (const GrBackendFormat &) const =0

bool	isFormatCompressed (const GrBackendFormat &format) const

virtual bool	isFormatTexturable (const GrBackendFormat &, GrTextureType) const =0

virtual bool	isFormatCopyable (const GrBackendFormat &) const =0

virtual int	maxRenderTargetSampleCount (const GrBackendFormat &) const =0

int	internalMultisampleCount (const GrBackendFormat &format) const

virtual bool	isFormatAsColorTypeRenderable (GrColorType ct, const GrBackendFormat &format, int sampleCount=1) const =0

virtual bool	isFormatRenderable (const GrBackendFormat &format, int sampleCount) const =0

virtual int	getRenderTargetSampleCount (int requestedCount, const GrBackendFormat &) const =0

bool	surfaceSupportsWritePixels (const GrSurface *) const

virtual SurfaceReadPixelsSupport	surfaceSupportsReadPixels (const GrSurface *) const =0

virtual SupportedWrite	supportedWritePixelsColorType (GrColorType surfaceColorType, const GrBackendFormat &surfaceFormat, GrColorType srcColorType) const =0

SupportedRead	supportedReadPixelsColorType (GrColorType srcColorType, const GrBackendFormat &srcFormat, GrColorType dstColorType) const

bool	writePixelsRowBytesSupport () const

bool	transferPixelsToRowBytesSupport () const

bool	readPixelsRowBytesSupport () const

bool	transferFromSurfaceToBufferSupport () const

bool	transferFromBufferToTextureSupport () const

bool	transferFromBufferToBufferSupport () const

bool	suppressPrints () const

size_t	bufferMapThreshold () const

bool	mustClearUploadedBufferData () const

bool	shouldInitializeTextures () const

bool	buffersAreInitiallyZero () const

bool	supportsAHardwareBufferImages () const

bool	wireframeMode () const

bool	semaphoreSupport () const

bool	backendSemaphoreSupport () const

bool	finishedProcAsyncCallbackSupport () const

bool	crossContextTextureSupport () const

bool	canCopySurface (const GrSurfaceProxy dst, const SkIRect &dstRect, const GrSurfaceProxy src, const SkIRect &srcRect) const

bool	dynamicStateArrayGeometryProcessorTextureSupport () const

bool	supportsProtectedContent () const

bool	performPartialClearsAsDraws () const

bool	performColorClearsAsDraws () const

bool	avoidLargeIndexBufferDraws () const

bool	performStencilClearsAsDraws () const

bool	disableTessellationPathRenderer () const

GrDstSampleFlags	getDstSampleFlagsForProxy (const GrRenderTargetProxy *, bool drawUsesMSAA) const

virtual DstCopyRestrictions	getDstCopyRestrictions (const GrRenderTargetProxy *src, GrColorType ct) const

bool	validateSurfaceParams (const SkISize &, const GrBackendFormat &, GrRenderable renderable, int renderTargetSampleCnt, skgpu::Mipmapped, GrTextureType) const

bool	areColorTypeAndFormatCompatible (GrColorType grCT, const GrBackendFormat &format) const

GrBackendFormat	getDefaultBackendFormat (GrColorType, GrRenderable) const

virtual GrBackendFormat	getBackendFormatFromCompressionType (SkTextureCompressionType) const =0

bool	clampToBorderSupport () const

skgpu::Swizzle	getReadSwizzle (const GrBackendFormat &format, GrColorType colorType) const

virtual skgpu::Swizzle	getWriteSwizzle (const GrBackendFormat &, GrColorType) const =0

virtual uint64_t	computeFormatKey (const GrBackendFormat &) const =0

const GrDriverBugWorkarounds &	workarounds () const

virtual void	addExtraSamplerKey (skgpu::KeyBuilder *, GrSamplerState, const GrBackendFormat &) const

	GR_DECL_BITFIELD_CLASS_OPS_FRIENDS (ProgramDescOverrideFlags)

virtual GrProgramDesc	makeDesc (GrRenderTarget *, const GrProgramInfo &, ProgramDescOverrideFlags overrideFlags=ProgramDescOverrideFlags::kNone) const =0

virtual GrInternalSurfaceFlags	getExtraSurfaceFlagsForDeferredRT () const

bool	supportsDynamicMSAA (const GrRenderTargetProxy *) const

virtual bool	dmsaaResolveCanBeUsedAsTextureInSameRenderPass () const

bool	avoidReorderingRenderTasks () const

bool	avoidDithering () const

bool	disablePerspectiveSDFText () const

bool	avoidLineDraws () const

std::tuple< GrColorType, GrBackendFormat >	getFallbackColorTypeAndFormat (GrColorType, int sampleCount) const

Public Member Functions inherited from SkCapabilities
SkSL::Version	skslVersion () const

Public Member Functions inherited from SkRefCntBase
	SkRefCntBase ()

virtual	~SkRefCntBase ()

bool	unique () const

void	ref () const

void	unref () const

Protected Member Functions
void	finishInitialization (const GrContextOptions &options)

virtual bool	onSupportsDynamicMSAA (const GrRenderTargetProxy *) const

Protected Member Functions inherited from SkCapabilities
	SkCapabilities ()=default

void	initSkCaps (const SkSL::ShaderCaps *)

Protected Attributes
std::unique_ptr< GrShaderCaps >	fShaderCaps

bool	fNPOTTextureTileSupport: 1

bool	fMipmapSupport: 1

bool	fAnisoSupport: 1

bool	fReuseScratchTextures: 1

bool	fReuseScratchBuffers: 1

bool	fGpuTracingSupport: 1

bool	fOversizedStencilSupport: 1

bool	fTextureBarrierSupport: 1

bool	fSampleLocationsSupport: 1

bool	fDrawInstancedSupport: 1

bool	fNativeDrawIndirectSupport: 1

bool	fUseClientSideIndirectBuffers: 1

bool	fConservativeRasterSupport: 1

bool	fWireframeSupport: 1

bool	fMSAAResolvesAutomatically: 1

bool	fPreferDiscardableMSAAAttachment: 1

bool	fUsePrimitiveRestart: 1

bool	fPreferClientSideDynamicBuffers: 1

bool	fPreferFullscreenClears: 1

bool	fTwoSidedStencilRefsAndMasksMustMatch: 1

bool	fMustClearUploadedBufferData: 1

bool	fBuffersAreInitiallyZero: 1

bool	fShouldInitializeTextures: 1

bool	fSupportsAHardwareBufferImages: 1

bool	fHalfFloatVertexAttributeSupport: 1

bool	fClampToBorderSupport: 1

bool	fPerformPartialClearsAsDraws: 1

bool	fPerformColorClearsAsDraws: 1

bool	fAvoidLargeIndexBufferDraws: 1

bool	fPerformStencilClearsAsDraws: 1

bool	fTransferFromBufferToTextureSupport: 1

bool	fTransferFromSurfaceToBufferSupport: 1

bool	fTransferFromBufferToBufferSupport: 1

bool	fWritePixelsRowBytesSupport: 1

bool	fTransferPixelsToRowBytesSupport: 1

bool	fReadPixelsRowBytesSupport: 1

bool	fShouldCollapseSrcOverToSrcWhenAble: 1

bool	fMustSyncGpuDuringAbandon: 1

bool	fDisableTessellationPathRenderer: 1

bool	fAvoidStencilBuffers: 1

bool	fAvoidWritePixelsFastPath: 1

bool	fNativeDrawIndexedIndirectIsBroken: 1

bool	fAvoidReorderingRenderTasks: 1

bool	fAvoidDithering: 1

bool	fDisablePerspectiveSDFText: 1

bool	fAvoidLineDraws: 1

bool	fPreferVRAMUseOverFlushes: 1

bool	fSemaphoreSupport: 1

bool	fBackendSemaphoreSupport: 1

bool	fFinishedProcAsyncCallbackSupport: 1

bool	fCrossContextTextureSupport: 1

bool	fDynamicStateArrayGeometryProcessorTextureSupport: 1

bool	fSupportsProtectedContent: 1

BlendEquationSupport	fBlendEquationSupport

uint32_t	fAdvBlendEqDisableFlags

uint32_t	fMapBufferFlags

int	fBufferMapThreshold

int	fMaxRenderTargetSize

int	fMaxPreferredRenderTargetSize

int	fMaxVertexAttributes

int	fMaxTextureSize

int	fMaxWindowRectangles

int	fInternalMultisampleCount

uint32_t	fMaxPushConstantsSize = 0

size_t	fTransferBufferRowBytesAlignment = 1

size_t	fTransferFromBufferToBufferAlignment = 1

size_t	fBufferUpdateDataPreserveAlignment = 1

GrDriverBugWorkarounds	fDriverBugWorkarounds

Protected Attributes inherited from SkCapabilities
SkSL::Version	fSkSLVersion = SkSL::Version::k100

Private Member Functions
virtual void	onApplyOptionsOverrides (const GrContextOptions &)

virtual void	onDumpJSON (SkJSONWriter *) const

virtual bool	onSurfaceSupportsWritePixels (const GrSurface *) const =0

virtual bool	onCanCopySurface (const GrSurfaceProxy dst, const SkIRect &dstRect, const GrSurfaceProxy src, const SkIRect &srcRect) const =0

virtual GrBackendFormat	onGetDefaultBackendFormat (GrColorType) const =0

virtual bool	onIsWindowRectanglesSupportedForRT (const GrBackendRenderTarget &) const

virtual bool	onAreColorTypeAndFormatCompatible (GrColorType, const GrBackendFormat &) const =0

virtual SupportedRead	onSupportedReadPixelsColorType (GrColorType srcColorType, const GrBackendFormat &srcFormat, GrColorType dstColorType) const =0

virtual skgpu::Swizzle	onGetReadSwizzle (const GrBackendFormat &, GrColorType) const =0

virtual GrDstSampleFlags	onGetDstSampleFlagsForProxy (const GrRenderTargetProxy *) const

Additional Inherited Members
Static Public Member Functions inherited from SkCapabilities
static sk_sp< const SkCapabilities >	RasterBackend ()

Detailed Description

Represents the capabilities of a GrContext.

Definition at line 57 of file GrCaps.h.

Member Enumeration Documentation

◆ BlendEquationSupport

enum GrCaps::BlendEquationSupport

Indicates the capabilities of the fixed function blend unit.

Enumerator
kBasic_BlendEquationSupport
kAdvanced_BlendEquationSupport
kAdvancedCoherent_BlendEquationSupport
kLast_BlendEquationSupport

Definition at line 149 of file GrCaps.h.

                              {
        kBasic_BlendEquationSupport,             //<! Support to select the operator that
                                                 //   combines src and dst terms.
        kAdvanced_BlendEquationSupport,          //<! Additional fixed function support for specific
                                                 //   SVG/PDF blend modes. Requires blend barriers.
        kAdvancedCoherent_BlendEquationSupport,  //<! Advanced blend equation support that does not
                                                 //   require blend barriers, and permits overlap.
 
        kLast_BlendEquationSupport = kAdvancedCoherent_BlendEquationSupport
    };

◆ MapFlags

enum GrCaps::MapFlags

Indicates whether GPU->CPU memory mapping for GPU resources such as vertex buffers and textures allows partial mappings or full mappings.

Enumerator
kNone_MapFlags
kCanMap_MapFlag
kSubset_MapFlag
kAsyncRead_MapFlag

Definition at line 196 of file GrCaps.h.

                  {
        kNone_MapFlags      = 0x0,   //<! Cannot map the resource.
 
        kCanMap_MapFlag     = 0x1,   //<! The resource can be mapped. Must be set for any of
                                     //   the other flags to have meaning.
        kSubset_MapFlag     = 0x2,   //<! The resource can be partially mapped.
        kAsyncRead_MapFlag  = 0x4,   //<! Are maps for reading asynchronous WRT GrOpsRenderPass
                                     //   submitted to GrGpu.
    };

◆ ProgramDescOverrideFlags

enum class GrCaps::ProgramDescOverrideFlags

strong

Enumerator
kNone
kVulkanHasResolveLoadSubpass

Definition at line 511 of file GrCaps.h.

                                        {
        kNone = 0,
        // If using discardable msaa surfaces in vulkan, when we break up a render pass for an
        // inline upload, we must do a load msaa subpass for the second render pass. However, if the
        // original render pass did not have this load subpass (e.g. clear or discard load op), then
        // all the GrProgramInfos for draws that end up in the second render pass will have been
        // recorded thinking they will be in a render pass with only 1 subpass. Thus we add an
        // override flag to the makeDesc call to force the actually VkPipeline that gets created to
        // be created using a render pass with 2 subpasses. We do miss on the pre-compile with this
        // approach, but inline uploads are very rare and already slow.
        kVulkanHasResolveLoadSubpass = 0x1,
    };

◆ SurfaceReadPixelsSupport

enum class GrCaps::SurfaceReadPixelsSupport

strong

Indicates whether surface supports GrGpu::readPixels, must be copied, or cannot be read.

Enumerator
kSupported	GrGpu::readPixels is supported by the surface.
kCopyToTexture2D	GrGpu::readPixels is not supported by this surface but this surface can be drawn or copied to a Ganesh-created GrTextureType::kTexture2D and then that surface will be readable.
kUnsupported	Not supported

Definition at line 296 of file GrCaps.h.

                                        {
        /** GrGpu::readPixels is supported by the surface. */
        kSupported,
        /**
         * GrGpu::readPixels is not supported by this surface but this surface can be drawn
         * or copied to a Ganesh-created GrTextureType::kTexture2D and then that surface will be
         * readable.
         */
        kCopyToTexture2D,
        /**
         * Not supported
         */
        kUnsupported,
    };

Constructor & Destructor Documentation

◆ GrCaps()

GrCaps::GrCaps ( const GrContextOptions & options )

Definition at line 26 of file GrCaps.cpp.

                                              {
    fNPOTTextureTileSupport = false;
    fMipmapSupport = false;
    fAnisoSupport = false;
    fReuseScratchTextures = true;
    fReuseScratchBuffers = true;
    fGpuTracingSupport = false;
    fOversizedStencilSupport = false;
    fTextureBarrierSupport = false;
    fSampleLocationsSupport = false;
    fDrawInstancedSupport = false;
    fNativeDrawIndirectSupport = false;
    fUseClientSideIndirectBuffers = false;
    fConservativeRasterSupport = false;
    fWireframeSupport = false;
    fMSAAResolvesAutomatically = false;
    fPreferDiscardableMSAAAttachment = false;
    fUsePrimitiveRestart = false;
    fPreferClientSideDynamicBuffers = false;
    fPreferFullscreenClears = false;
    fTwoSidedStencilRefsAndMasksMustMatch = false;
    fMustClearUploadedBufferData = false;
    fShouldInitializeTextures = false;
    fBuffersAreInitiallyZero = false;
    fSupportsAHardwareBufferImages = false;
    fSemaphoreSupport = false;
    fBackendSemaphoreSupport = false;
    fFinishedProcAsyncCallbackSupport = false;
    fCrossContextTextureSupport = false;
    fHalfFloatVertexAttributeSupport = false;
    fDynamicStateArrayGeometryProcessorTextureSupport = false;
    fSupportsProtectedContent = false;
    fPerformPartialClearsAsDraws = false;
    fPerformColorClearsAsDraws = false;
    fAvoidLargeIndexBufferDraws = false;
    fPerformStencilClearsAsDraws = false;
    fTransferFromBufferToTextureSupport = false;
    fTransferFromSurfaceToBufferSupport = false;
    fTransferFromBufferToBufferSupport = false;
    fWritePixelsRowBytesSupport = false;
    fTransferPixelsToRowBytesSupport = false;
    fReadPixelsRowBytesSupport = false;
    fShouldCollapseSrcOverToSrcWhenAble = false;
    fMustSyncGpuDuringAbandon = true;
    fDisableTessellationPathRenderer = false;
 
    fBlendEquationSupport = kBasic_BlendEquationSupport;
    fAdvBlendEqDisableFlags = 0;
 
    fMapBufferFlags = kNone_MapFlags;
 
    fMaxVertexAttributes = 0;
    fMaxRenderTargetSize = 1;
    fMaxPreferredRenderTargetSize = 1;
    fMaxTextureSize = 1;
    fMaxWindowRectangles = 0;
    fInternalMultisampleCount = 0;
 
    fSuppressPrints = options.fSuppressPrints;
#if defined(GR_TEST_UTILS)
    fWireframeMode = options.fWireframeMode;
#else
    fWireframeMode = false;
#endif
    fBufferMapThreshold = options.fBufferMapThreshold;
    fAvoidStencilBuffers = false;
    fAvoidWritePixelsFastPath = false;
    fNativeDrawIndexedIndirectIsBroken = false;
    fAvoidReorderingRenderTasks = false;
    fAvoidDithering = false;
    fAvoidLineDraws = false;
    fDisablePerspectiveSDFText = false;
 
    fPreferVRAMUseOverFlushes = true;
 
    // Default to true, allow older versions of OpenGL to disable explicitly
    fClampToBorderSupport = true;
 
    fDriverBugWorkarounds = options.fDriverBugWorkarounds;
}

Member Function Documentation

◆ addExtraSamplerKey()

virtual void GrCaps::addExtraSamplerKey	(	skgpu::KeyBuilder *	,
		GrSamplerState	,
		const GrBackendFormat &
	)		const

inlinevirtual

Adds fields to the key to represent the sampler that will be created for the passed in parameters. Currently this extra keying is only needed when building a vulkan pipeline with immutable samplers.

Reimplemented in GrD3DCaps, and GrVkCaps.

Definition at line 507 of file GrCaps.h.

509 {}

◆ advancedBlendEquationSupport()

bool GrCaps::advancedBlendEquationSupport ( ) const

inline

Definition at line 162 of file GrCaps.h.

                                              {
        return fBlendEquationSupport >= kAdvanced_BlendEquationSupport;
    }

◆ advancedCoherentBlendEquationSupport()

bool GrCaps::advancedCoherentBlendEquationSupport ( ) const

inline

Definition at line 166 of file GrCaps.h.

                                                      {
        return kAdvancedCoherent_BlendEquationSupport == fBlendEquationSupport;
    }

◆ anisoSupport()

bool GrCaps::anisoSupport ( ) const

inline

Is anisotropic filtering supported.

Definition at line 74 of file GrCaps.h.

74{ return fAnisoSupport; }

◆ areColorTypeAndFormatCompatible()

bool GrCaps::areColorTypeAndFormatCompatible	(	GrColorType	grCT,
		const GrBackendFormat &	format
	)		const

Definition at line 428 of file GrCaps.cpp.

                                                                                  {
    if (GrColorType::kUnknown == grCT) {
        return false;
    }
 
    SkTextureCompressionType compression = GrBackendFormatToCompressionType(format);
    if (compression != SkTextureCompressionType::kNone) {
        return grCT == (SkTextureCompressionTypeIsOpaque(compression) ? GrColorType::kRGB_888x
                                                                      : GrColorType::kRGBA_8888);
    }
 
    return this->onAreColorTypeAndFormatCompatible(grCT, format);
}

◆ avoidDithering()

bool GrCaps::avoidDithering ( ) const

inline

Definition at line 546 of file GrCaps.h.

                                {
        return fAvoidDithering;
    }

◆ avoidLargeIndexBufferDraws()

bool GrCaps::avoidLargeIndexBufferDraws ( ) const

inline

Definition at line 433 of file GrCaps.h.

433{ return fAvoidLargeIndexBufferDraws; }

◆ avoidLineDraws()

bool GrCaps::avoidLineDraws ( ) const

inline

Definition at line 555 of file GrCaps.h.

555{ return fAvoidLineDraws; }

◆ avoidReorderingRenderTasks()

bool GrCaps::avoidReorderingRenderTasks ( ) const

inline

Definition at line 542 of file GrCaps.h.

                                            {
        return fAvoidReorderingRenderTasks;
    }

◆ avoidStencilBuffers()

bool GrCaps::avoidStencilBuffers ( ) const

inline

Definition at line 139 of file GrCaps.h.

139{ return fAvoidStencilBuffers; }

◆ avoidWritePixelsFastPath()

bool GrCaps::avoidWritePixelsFastPath ( ) const

inline

Definition at line 141 of file GrCaps.h.

141{ return fAvoidWritePixelsFastPath; }

◆ backendSemaphoreSupport()

bool GrCaps::backendSemaphoreSupport ( ) const

inline

Supports using GrBackendSemaphore as "signal" semaphores or for waiting. See also GrFlushInfo and GrDirectContext.

Definition at line 406 of file GrCaps.h.

406{ return fBackendSemaphoreSupport; }

◆ blendEquationSupport()

BlendEquationSupport GrCaps::blendEquationSupport ( ) const

inline

Definition at line 160 of file GrCaps.h.

160{ return fBlendEquationSupport; }

◆ bufferMapThreshold()

size_t GrCaps::bufferMapThreshold ( ) const

inline

Definition at line 373 of file GrCaps.h.

                                      {
        SkASSERT(fBufferMapThreshold >= 0);
        return static_cast<size_t>(fBufferMapThreshold);
    }

◆ buffersAreInitiallyZero()

bool GrCaps::buffersAreInitiallyZero ( ) const

inline

When a new GrGpuBuffer is created is it known to contain all zero bytes?

Definition at line 391 of file GrCaps.h.

391{ return fBuffersAreInitiallyZero; }

◆ bufferUpdateDataPreserveAlignment()

size_t GrCaps::bufferUpdateDataPreserveAlignment ( ) const

inline

Definition at line 250 of file GrCaps.h.

                                                     {
        return fBufferUpdateDataPreserveAlignment;
    }

◆ canCopySurface()

bool GrCaps::canCopySurface	(	const GrSurfaceProxy *	dst,
		const SkIRect &	dstRect,
		const GrSurfaceProxy *	src,
		const SkIRect &	srcRect
	)		const

Returns whether or not we will be able to do a copy given the passed in params

Definition at line 309 of file GrCaps.cpp.

                                                                                     {
    if (dst->readOnly()) {
        return false;
    }
 
    if (dst->backendFormat() != src->backendFormat()) {
        return false;
    }
    // For simplicity, all GrGpu::copySurface() calls can assume that srcRect and dstRect
    // are already contained within their respective surfaces.
    if (!SkIRect::MakeSize(dst->dimensions()).contains(dstRect) ||
        !SkIRect::MakeSize(src->dimensions()).contains(srcRect)) {
        return false;
    }
    return this->onCanCopySurface(dst, dstRect, src, srcRect);
}

◆ clampToBorderSupport()

bool GrCaps::clampToBorderSupport ( ) const

inline

The CLAMP_TO_BORDER wrap mode for texture coordinates was added to desktop GL in 1.3, and GLES 3.2, but is also available in extensions. Vulkan and Metal always have support.

Definition at line 484 of file GrCaps.h.

484{ return fClampToBorderSupport; }

◆ computeFormatKey()

virtual uint64_t GrCaps::computeFormatKey ( const GrBackendFormat & ) const

pure virtual

Implemented in GrD3DCaps, GrGLCaps, GrMockCaps, GrMtlCaps, and GrVkCaps.

◆ conservativeRasterSupport()

bool GrCaps::conservativeRasterSupport ( ) const

inline

Definition at line 95 of file GrCaps.h.

95{ return fConservativeRasterSupport; }

◆ crossContextTextureSupport()

bool GrCaps::crossContextTextureSupport ( ) const

inline

Definition at line 411 of file GrCaps.h.

411{ return fCrossContextTextureSupport; }

◆ disablePerspectiveSDFText()

bool GrCaps::disablePerspectiveSDFText ( ) const

inline

Definition at line 550 of file GrCaps.h.

                                           {
        return fDisablePerspectiveSDFText;
    }

◆ disableTessellationPathRenderer()

bool GrCaps::disableTessellationPathRenderer ( ) const

inline

Definition at line 441 of file GrCaps.h.

441{ return fDisableTessellationPathRenderer; }

◆ discardStencilValuesAfterRenderPass()

bool GrCaps::discardStencilValuesAfterRenderPass ( ) const

inline

Definition at line 122 of file GrCaps.h.

                                                     {
        // b/160958008
        return false;
#if 0
        // This method is actually just a duplicate of preferFullscreenClears(), with a descriptive
        // name for the sake of readability.
        return this->preferFullscreenClears();
#endif
    }

◆ dmsaaResolveCanBeUsedAsTextureInSameRenderPass()

virtual bool GrCaps::dmsaaResolveCanBeUsedAsTextureInSameRenderPass ( ) const

inlinevirtual

Reimplemented in GrVkCaps.

Definition at line 539 of file GrCaps.h.

539{ return true; }

◆ drawInstancedSupport()

bool GrCaps::drawInstancedSupport ( ) const

inline

Definition at line 80 of file GrCaps.h.

80{ return fDrawInstancedSupport; }

◆ dumpJSON()

void GrCaps::dumpJSON ( SkJSONWriter * writer ) const

Definition at line 302 of file GrCaps.cpp.

302{ }

◆ dynamicStateArrayGeometryProcessorTextureSupport()

bool GrCaps::dynamicStateArrayGeometryProcessorTextureSupport ( ) const

inline

Definition at line 418 of file GrCaps.h.

                                                                  {
        return fDynamicStateArrayGeometryProcessorTextureSupport;
    }

◆ finishedProcAsyncCallbackSupport()

bool GrCaps::finishedProcAsyncCallbackSupport ( ) const

inline

Supports async callback for finishedProcs

Definition at line 409 of file GrCaps.h.

409{ return fFinishedProcAsyncCallbackSupport; }

◆ finishInitialization()

void GrCaps::finishInitialization ( const GrContextOptions & options )

protected

Definition at line 107 of file GrCaps.cpp.

                                                                 {
    if (!fNativeDrawIndirectSupport) {
        // We will implement indirect draws with a polyfill, so the commands need to reside in CPU
        // memory.
        fUseClientSideIndirectBuffers = true;
    }
 
    this->applyOptionsOverrides(options);
 
    // Our render targets are always created with textures as the color attachment, hence this min:
    fMaxRenderTargetSize = std::min(fMaxRenderTargetSize, fMaxTextureSize);
    fMaxPreferredRenderTargetSize = std::min(fMaxPreferredRenderTargetSize, fMaxRenderTargetSize);
 
    this->initSkCaps(this->shaderCaps());
}

◆ getBackendFormatFromCompressionType()

virtual GrBackendFormat GrCaps::getBackendFormatFromCompressionType ( SkTextureCompressionType ) const

pure virtual

Implemented in GrD3DCaps, GrGLCaps, GrMockCaps, GrMtlCaps, and GrVkCaps.

◆ getDefaultBackendFormat()

GrBackendFormat GrCaps::getDefaultBackendFormat	(	GrColorType	colorType,
		GrRenderable	renderable
	)		const

These are used when creating a new texture internally.

Definition at line 400 of file GrCaps.cpp.

                                                                               {
    // Unknown color types are always an invalid format, so early out before calling virtual.
    if (colorType == GrColorType::kUnknown) {
        return {};
    }
 
    auto format = this->onGetDefaultBackendFormat(colorType);
    if (!this->isFormatTexturable(format, GrTextureType::k2D)) {
        return {};
    }
    if (!this->areColorTypeAndFormatCompatible(colorType, format)) {
        return {};
    }
    // Currently we require that it be possible to write pixels into the "default" format. Perhaps,
    // that could be a separate requirement from the caller. It seems less necessary if
    // renderability was requested.
    if (this->supportedWritePixelsColorType(colorType, format, colorType).fColorType ==
        GrColorType::kUnknown) {
        return {};
    }
    if (renderable == GrRenderable::kYes &&
        !this->isFormatAsColorTypeRenderable(colorType, format)) {
        return {};
    }
    return format;
}

◆ getDstCopyRestrictions()

virtual DstCopyRestrictions GrCaps::getDstCopyRestrictions	(	const GrRenderTargetProxy *	src,
		GrColorType	ct
	)		const

inlinevirtual

Reimplemented in GrMtlCaps, and GrGLCaps.

Definition at line 461 of file GrCaps.h.

                                                                             {
        return {};
    }

◆ getDstSampleFlagsForProxy()

GrDstSampleFlags GrCaps::getDstSampleFlagsForProxy	(	const GrRenderTargetProxy *	rt,
		bool	drawUsesMSAA
	)		const

Definition at line 461 of file GrCaps.cpp.

                                                                            {
    SkASSERT(rt);
    if (this->textureBarrierSupport() && (!drawUsesMSAA || this->msaaResolvesAutomatically())) {
        return this->onGetDstSampleFlagsForProxy(rt);
    }
    return GrDstSampleFlags::kNone;
}

◆ getExtraSurfaceFlagsForDeferredRT()

virtual GrInternalSurfaceFlags GrCaps::getExtraSurfaceFlagsForDeferredRT ( ) const

inlinevirtual

Reimplemented in GrVkCaps.

Definition at line 533 of file GrCaps.h.

                                                                             {
        return GrInternalSurfaceFlags::kNone;
    }

◆ getFallbackColorTypeAndFormat()

std::tuple< GrColorType, GrBackendFormat > GrCaps::getFallbackColorTypeAndFormat	(	GrColorType	ct,
		int	sampleCount
	)		const

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

Definition at line 499 of file GrCaps.cpp.

                                                                                                 {
    do {
        auto format = this->getDefaultBackendFormat(ct, GrRenderable::kYes);
        // We continue to the fallback color type if there no default renderable format or we
        // requested msaa and the format doesn't support msaa.
        if (format.isValid() && this->isFormatRenderable(format, sampleCnt)) {
            return {ct, format};
        }
        ct = color_type_fallback(ct);
    } while (ct != GrColorType::kUnknown);
    return {GrColorType::kUnknown, {}};
}

◆ getReadSwizzle()

skgpu::Swizzle GrCaps::getReadSwizzle	(	const GrBackendFormat &	format,
		GrColorType	colorType
	)		const

Returns the skgpu::Swizzle to use when sampling or reading back from a texture with the passed in GrBackendFormat and GrColorType.

Definition at line 443 of file GrCaps.cpp.

                                                                                              {
    SkTextureCompressionType compression = GrBackendFormatToCompressionType(format);
    if (compression != SkTextureCompressionType::kNone) {
        if (colorType == GrColorType::kRGB_888x || colorType == GrColorType::kRGBA_8888) {
            return skgpu::Swizzle::RGBA();
        }
        SkDEBUGFAILF("Illegal color type (%d) and compressed format (%d) combination.",
                     (int)colorType, (int)compression);
        return {};
    }
 
    return this->onGetReadSwizzle(format, colorType);
}

◆ getRenderTargetSampleCount()

virtual int GrCaps::getRenderTargetSampleCount	(	int	requestedCount,
		const GrBackendFormat &
	)		const

pure virtual

Implemented in GrMockCaps, GrD3DCaps, GrMtlCaps, GrVkCaps, and GrGLCaps.

◆ getWriteSwizzle()

virtual skgpu::Swizzle GrCaps::getWriteSwizzle	(	const GrBackendFormat &	,
		GrColorType
	)		const

pure virtual

Returns the skgpu::Swizzle to use when writing colors to a surface with the passed in GrBackendFormat and GrColorType.

Implemented in GrD3DCaps, GrGLCaps, GrMtlCaps, GrVkCaps, and GrMockCaps.

◆ gpuTracingSupport()

bool GrCaps::gpuTracingSupport ( ) const

inline

Definition at line 76 of file GrCaps.h.

76{ return fGpuTracingSupport; }

◆ GR_DECL_BITFIELD_CLASS_OPS_FRIENDS()

GrCaps::GR_DECL_BITFIELD_CLASS_OPS_FRIENDS ( ProgramDescOverrideFlags )

◆ halfFloatVertexAttributeSupport()

bool GrCaps::halfFloatVertexAttributeSupport ( ) const

inline

Definition at line 108 of file GrCaps.h.

108{ return fHalfFloatVertexAttributeSupport; }

◆ internalMultisampleCount()

int GrCaps::internalMultisampleCount ( const GrBackendFormat & format ) const

inline

Definition at line 271 of file GrCaps.h.

                                                                      {
        return std::min(fInternalMultisampleCount, this->maxRenderTargetSampleCount(format));
    }

◆ isAdvancedBlendEquationDisabled()

bool GrCaps::isAdvancedBlendEquationDisabled ( skgpu::BlendEquation equation ) const

inline

Definition at line 170 of file GrCaps.h.

                                                                            {
        SkASSERT(skgpu::BlendEquationIsAdvanced(equation));
        SkASSERT(this->advancedBlendEquationSupport());
        return SkToBool(fAdvBlendEqDisableFlags & (1 << static_cast<int>(equation)));
    }

◆ isFormatAsColorTypeRenderable()

virtual bool GrCaps::isFormatAsColorTypeRenderable	(	GrColorType	ct,
		const GrBackendFormat &	format,
		int	sampleCount = `1`
	)		const

pure virtual

Implemented in GrD3DCaps, GrGLCaps, GrMockCaps, GrMtlCaps, and GrVkCaps.

◆ isFormatCompressed()

bool GrCaps::isFormatCompressed ( const GrBackendFormat & format ) const

Definition at line 457 of file GrCaps.cpp.

                                                                   {
    return GrBackendFormatToCompressionType(format) != SkTextureCompressionType::kNone;
}

◆ isFormatCopyable()

virtual bool GrCaps::isFormatCopyable ( const GrBackendFormat & ) const

pure virtual

Implemented in GrD3DCaps, GrGLCaps, GrMtlCaps, GrVkCaps, and GrMockCaps.

◆ isFormatRenderable()

virtual bool GrCaps::isFormatRenderable	(	const GrBackendFormat &	format,
		int	sampleCount
	)		const

pure virtual

Implemented in GrD3DCaps, GrGLCaps, GrMockCaps, GrMtlCaps, and GrVkCaps.

◆ isFormatSRGB()

virtual bool GrCaps::isFormatSRGB ( const GrBackendFormat & ) const

pure virtual

Implemented in GrD3DCaps, GrGLCaps, GrMtlCaps, GrVkCaps, and GrMockCaps.

◆ isFormatTexturable()

virtual bool GrCaps::isFormatTexturable	(	const GrBackendFormat &	,
		GrTextureType
	)		const

pure virtual

Implemented in GrD3DCaps, GrGLCaps, GrMtlCaps, GrVkCaps, and GrMockCaps.

◆ isWindowRectanglesSupportedForRT()

bool GrCaps::isWindowRectanglesSupportedForRT ( const GrBackendRenderTarget & rt ) const

inline

Definition at line 234 of file GrCaps.h.

                                                                                 {
        return this->maxWindowRectangles() > 0 && this->onIsWindowRectanglesSupportedForRT(rt);
    }

◆ makeDesc()

virtual GrProgramDesc GrCaps::makeDesc	(	GrRenderTarget *	,
		const GrProgramInfo &	,
		ProgramDescOverrideFlags	overrideFlags = `ProgramDescOverrideFlags::kNone`
	)		const

pure virtual

Implemented in GrD3DCaps, GrGLCaps, GrMockCaps, GrMtlCaps, and GrVkCaps.

◆ mapBufferFlags()

uint32_t GrCaps::mapBufferFlags ( ) const

inline

Definition at line 211 of file GrCaps.h.

211{ return fMapBufferFlags; }

◆ maxPreferredRenderTargetSize()

int GrCaps::maxPreferredRenderTargetSize ( ) const

inline

This is the largest render target size that can be used without incurring extra perfomance cost. It is usually the max RT size, unless larger render targets are known to be slower.

Definition at line 227 of file GrCaps.h.

227{ return fMaxPreferredRenderTargetSize; }

◆ maxPushConstantsSize()

uint32_t GrCaps::maxPushConstantsSize ( ) const

inline

Definition at line 238 of file GrCaps.h.

238{ return fMaxPushConstantsSize; }

GrCaps::fMaxPushConstantsSize

uint32_t fMaxPushConstantsSize

Definition GrCaps.h:663

◆ maxRenderTargetSampleCount()

virtual int GrCaps::maxRenderTargetSampleCount ( const GrBackendFormat & ) const

pure virtual

Implemented in GrD3DCaps, GrMtlCaps, GrVkCaps, GrGLCaps, and GrMockCaps.

◆ maxRenderTargetSize()

int GrCaps::maxRenderTargetSize ( ) const

inline

Definition at line 223 of file GrCaps.h.

223{ return fMaxRenderTargetSize; }

◆ maxTextureSize()

int GrCaps::maxTextureSize ( ) const

inline

Definition at line 229 of file GrCaps.h.

229{ return fMaxTextureSize; }

◆ maxVertexAttributes()

int GrCaps::maxVertexAttributes ( ) const

inline

maximum number of attribute values per vertex

Definition at line 221 of file GrCaps.h.

221{ return fMaxVertexAttributes; }

◆ maxWindowRectangles()

int GrCaps::maxWindowRectangles ( ) const

inline

Definition at line 231 of file GrCaps.h.

231{ return fMaxWindowRectangles; }

◆ mipmapSupport()

bool GrCaps::mipmapSupport ( ) const

inline

To avoid as-yet-unnecessary complexity we don't allow any partial support of MIP Maps (e.g. only for POT textures)

Definition at line 72 of file GrCaps.h.

72{ return fMipmapSupport; }

◆ msaaResolvesAutomatically()

bool GrCaps::msaaResolvesAutomatically ( ) const

inline

Definition at line 100 of file GrCaps.h.

100{ return fMSAAResolvesAutomatically; }

◆ mustClearUploadedBufferData()

bool GrCaps::mustClearUploadedBufferData ( ) const

inline

True in environments that will issue errors if memory uploaded to buffers is not initialized (even if not read by draw calls).

Definition at line 380 of file GrCaps.h.

380{ return fMustClearUploadedBufferData; }

◆ mustSyncGpuDuringAbandon()

bool GrCaps::mustSyncGpuDuringAbandon ( ) const

inline

Definition at line 185 of file GrCaps.h.

                                          {
        return fMustSyncGpuDuringAbandon;
    }

◆ nativeDrawIndexedIndirectIsBroken()

bool GrCaps::nativeDrawIndexedIndirectIsBroken ( ) const

inline

Definition at line 144 of file GrCaps.h.

144{ return fNativeDrawIndexedIndirectIsBroken; }

◆ nativeDrawIndirectSupport()

bool GrCaps::nativeDrawIndirectSupport ( ) const

inline

Definition at line 84 of file GrCaps.h.

84{ return fNativeDrawIndirectSupport; }

◆ npotTextureTileSupport()

bool GrCaps::npotTextureTileSupport ( ) const

inline

Definition at line 69 of file GrCaps.h.

69{ return fNPOTTextureTileSupport; }

◆ onApplyOptionsOverrides()

virtual void GrCaps::onApplyOptionsOverrides ( const GrContextOptions & )

inlineprivatevirtual

Reimplemented in GrGLCaps.

Definition at line 677 of file GrCaps.h.

677{}

◆ onAreColorTypeAndFormatCompatible()

virtual bool GrCaps::onAreColorTypeAndFormatCompatible	(	GrColorType	,
		const GrBackendFormat &
	)		const

privatepure virtual

Implemented in GrMockCaps, GrD3DCaps, GrGLCaps, GrMtlCaps, and GrVkCaps.

◆ onCanCopySurface()

virtual bool GrCaps::onCanCopySurface	(	const GrSurfaceProxy *	dst,
		const SkIRect &	dstRect,
		const GrSurfaceProxy *	src,
		const SkIRect &	srcRect
	)		const

privatepure virtual

Implemented in GrD3DCaps, GrGLCaps, GrMockCaps, GrMtlCaps, and GrVkCaps.

◆ onDumpJSON()

virtual void GrCaps::onDumpJSON ( SkJSONWriter * ) const

inlineprivatevirtual

Reimplemented in GrGLCaps, and GrMtlCaps.

Definition at line 678 of file GrCaps.h.

678{}

◆ onGetDefaultBackendFormat()

virtual GrBackendFormat GrCaps::onGetDefaultBackendFormat ( GrColorType ) const

privatepure virtual

Implemented in GrMockCaps, GrD3DCaps, GrGLCaps, GrMtlCaps, and GrVkCaps.

◆ onGetDstSampleFlagsForProxy()

virtual GrDstSampleFlags GrCaps::onGetDstSampleFlagsForProxy ( const GrRenderTargetProxy * ) const

inlineprivatevirtual

Reimplemented in GrGLCaps, and GrVkCaps.

Definition at line 698 of file GrCaps.h.

                                                                                           {
        return GrDstSampleFlags::kNone;
    }

◆ onGetReadSwizzle()

virtual skgpu::Swizzle GrCaps::onGetReadSwizzle	(	const GrBackendFormat &	,
		GrColorType
	)		const

privatepure virtual

Implemented in GrD3DCaps, GrGLCaps, GrMtlCaps, GrVkCaps, and GrMockCaps.

◆ onIsWindowRectanglesSupportedForRT()

virtual bool GrCaps::onIsWindowRectanglesSupportedForRT ( const GrBackendRenderTarget & ) const

inlineprivatevirtual

Reimplemented in GrGLCaps.

Definition at line 686 of file GrCaps.h.

                                                                                        {
        return true;
    }

◆ onSupportedReadPixelsColorType()

virtual SupportedRead GrCaps::onSupportedReadPixelsColorType	(	GrColorType	srcColorType,
		const GrBackendFormat &	srcFormat,
		GrColorType	dstColorType
	)		const

privatepure virtual

Implemented in GrMockCaps, GrD3DCaps, GrGLCaps, GrMtlCaps, and GrVkCaps.

◆ onSupportsDynamicMSAA()

virtual bool GrCaps::onSupportsDynamicMSAA ( const GrRenderTargetProxy * ) const

inlineprotectedvirtual

Reimplemented in GrGLCaps, and GrVkCaps.

Definition at line 582 of file GrCaps.h.

582{ return false; }

◆ onSurfaceSupportsWritePixels()

virtual bool GrCaps::onSurfaceSupportsWritePixels ( const GrSurface * ) const

privatepure virtual

Implemented in GrD3DCaps, GrGLCaps, GrMockCaps, GrMtlCaps, and GrVkCaps.

◆ oversizedStencilSupport()

bool GrCaps::oversizedStencilSupport ( ) const

inline

Definition at line 77 of file GrCaps.h.

77{ return fOversizedStencilSupport; }

◆ performColorClearsAsDraws()

bool GrCaps::performColorClearsAsDraws ( ) const

inline

Definition at line 431 of file GrCaps.h.

431{ return fPerformColorClearsAsDraws; }

◆ performPartialClearsAsDraws()

bool GrCaps::performPartialClearsAsDraws ( ) const

inline

Definition at line 426 of file GrCaps.h.

                                             {
        return fPerformColorClearsAsDraws || fPerformPartialClearsAsDraws;
    }

◆ performStencilClearsAsDraws()

bool GrCaps::performStencilClearsAsDraws ( ) const

inline

Adreno 4xx devices experience an issue when there are a large number of stencil clip bit clears. The minimal repro steps are not precisely known but drawing a rect with a stencil op instead of using glClear seems to resolve the issue.

Definition at line 438 of file GrCaps.h.

438{ return fPerformStencilClearsAsDraws; }

◆ preferClientSideDynamicBuffers()

bool GrCaps::preferClientSideDynamicBuffers ( ) const

inline

Definition at line 114 of file GrCaps.h.

114{ return fPreferClientSideDynamicBuffers; }

◆ preferDiscardableMSAAAttachment()

bool GrCaps::preferDiscardableMSAAAttachment ( ) const

inline

Definition at line 107 of file GrCaps.h.

107{ return fPreferDiscardableMSAAAttachment; }

◆ preferFullscreenClears()

bool GrCaps::preferFullscreenClears ( ) const

inline

Definition at line 118 of file GrCaps.h.

118{ return fPreferFullscreenClears; }

◆ preferVRAMUseOverFlushes()

bool GrCaps::preferVRAMUseOverFlushes ( ) const

inline

Definition at line 137 of file GrCaps.h.

137{ return fPreferVRAMUseOverFlushes; }

◆ readPixelsRowBytesSupport()

bool GrCaps::readPixelsRowBytesSupport ( ) const

inline

Does GrGpu::readPixels() support a dst buffer where the row bytes is not equal to bpp * w?

Definition at line 365 of file GrCaps.h.

365{ return fReadPixelsRowBytesSupport; }

◆ reducedShaderMode()

bool GrCaps::reducedShaderMode ( ) const

inline

Definition at line 190 of file GrCaps.h.

190{ return this->shaderCaps()->fReducedShaderMode; }

GrShaderCaps::fReducedShaderMode

bool fReducedShaderMode

Definition GrShaderCaps.h:46

◆ reuseScratchBuffers()

bool GrCaps::reuseScratchBuffers ( ) const

inline

Definition at line 218 of file GrCaps.h.

218{ return fReuseScratchBuffers; }

◆ reuseScratchTextures()

bool GrCaps::reuseScratchTextures ( ) const

inline

Definition at line 217 of file GrCaps.h.

217{ return fReuseScratchTextures; }

◆ sampleLocationsSupport()

bool GrCaps::sampleLocationsSupport ( ) const

inline

Definition at line 79 of file GrCaps.h.

79{ return fSampleLocationsSupport; }

◆ semaphoreSupport()

bool GrCaps::semaphoreSupport ( ) const

inline

Supports using GrSemaphores.

Definition at line 402 of file GrCaps.h.

402{ return fSemaphoreSupport; }

◆ shaderCaps()

const GrShaderCaps * GrCaps::shaderCaps ( ) const

inline

Definition at line 63 of file GrCaps.h.

63{ return fShaderCaps.get(); }

GrCaps::fShaderCaps

std::unique_ptr< GrShaderCaps > fShaderCaps

Definition GrCaps.h:584

◆ shouldCollapseSrcOverToSrcWhenAble()

bool GrCaps::shouldCollapseSrcOverToSrcWhenAble ( ) const

inline

Definition at line 179 of file GrCaps.h.

                                                    {
        return fShouldCollapseSrcOverToSrcWhenAble;
    }

◆ shouldInitializeTextures()

bool GrCaps::shouldInitializeTextures ( ) const

inline

For some environments, there is a performance or safety concern to not initializing textures. For example, with WebGL and Firefox, there is a large performance hit to not doing it.

Definition at line 386 of file GrCaps.h.

386{ return fShouldInitializeTextures; }

◆ supportedReadPixelsColorType()

GrCaps::SupportedRead GrCaps::supportedReadPixelsColorType	(	GrColorType	srcColorType,
		const GrBackendFormat &	srcFormat,
		GrColorType	dstColorType
	)		const

Given a src surface's color type and its backend format as well as a color type the caller would like read into, this provides a legal color type that the caller may pass to GrGpu::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.

Definition at line 366 of file GrCaps.cpp.

                                                                                           {
    SupportedRead read = this->onSupportedReadPixelsColorType(srcColorType, srcFormat,
                                                              dstColorType);
 
    // There are known problems with 24 vs 32 bit BPP with this color type. Just fail for now if
    // using a transfer buffer.
    if (GrColorType::kRGB_888x == read.fColorType) {
        read.fOffsetAlignmentForTransferBuffer = 0;
    }
    // It's very convenient to access 1 byte-per-channel 32 bit color types as uint32_t on the CPU.
    // Make those aligned reads out of the buffer even if the underlying API doesn't require it.
    auto channelFlags = GrColorTypeChannelFlags(read.fColorType);
    if ((channelFlags == kRGBA_SkColorChannelFlags || channelFlags == kRGB_SkColorChannelFlags ||
         channelFlags == kAlpha_SkColorChannelFlag || channelFlags == kGray_SkColorChannelFlag) &&
        GrColorTypeBytesPerPixel(read.fColorType) == 4) {
        switch (read.fOffsetAlignmentForTransferBuffer & 0b11) {
            // offset alignment already a multiple of 4
            case 0:
                break;
            // offset alignment is a multiple of 2 but not 4.
            case 2:
                read.fOffsetAlignmentForTransferBuffer *= 2;
                break;
            // offset alignment is not a multiple of 2.
            default:
                read.fOffsetAlignmentForTransferBuffer *= 4;
                break;
        }
    }
    return read;
}

◆ supportedWritePixelsColorType()

virtual SupportedWrite GrCaps::supportedWritePixelsColorType	(	GrColorType	surfaceColorType,
		const GrBackendFormat &	surfaceFormat,
		GrColorType	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 GrGpu::writePixels().

Implemented in GrD3DCaps, GrGLCaps, GrMockCaps, GrMtlCaps, and GrVkCaps.

◆ supportsAHardwareBufferImages()

bool GrCaps::supportsAHardwareBufferImages ( ) const

inline

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

Definition at line 397 of file GrCaps.h.

397{ return fSupportsAHardwareBufferImages; }

◆ supportsDynamicMSAA()

bool GrCaps::supportsDynamicMSAA ( const GrRenderTargetProxy * rtProxy ) const

Definition at line 470 of file GrCaps.cpp.

                                                                         {
    return rtProxy->numSamples() == 1 &&
           this->internalMultisampleCount(rtProxy->backendFormat()) > 1 &&
           this->onSupportsDynamicMSAA(rtProxy);
}

◆ supportsProtectedContent()

bool GrCaps::supportsProtectedContent ( ) const

inline

Definition at line 422 of file GrCaps.h.

422{ return fSupportsProtectedContent; }

◆ suppressPrints()

bool GrCaps::suppressPrints ( ) const

inline

Definition at line 371 of file GrCaps.h.

371{ return fSuppressPrints; }

◆ surfaceSupportsReadPixels()

virtual SurfaceReadPixelsSupport GrCaps::surfaceSupportsReadPixels ( const GrSurface * ) const

pure virtual

Backends may have restrictions on what types of surfaces support GrGpu::readPixels(). We may either be able to read directly from the surface, read from a copy of the surface, or not read at all.

Implemented in GrD3DCaps, GrGLCaps, GrMtlCaps, GrVkCaps, and GrMockCaps.

◆ surfaceSupportsWritePixels()

bool GrCaps::surfaceSupportsWritePixels ( const GrSurface * surface ) const

Backends may have restrictions on what types of surfaces support GrGpu::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.

Definition at line 305 of file GrCaps.cpp.

                                                                      {
    return surface->readOnly() ? false : this->onSurfaceSupportsWritePixels(surface);
}

◆ textureBarrierSupport()

bool GrCaps::textureBarrierSupport ( ) const

inline

Definition at line 78 of file GrCaps.h.

78{ return fTextureBarrierSupport; }

◆ transferBufferRowBytesAlignment()

size_t GrCaps::transferBufferRowBytesAlignment ( ) const

inline

Definition at line 241 of file GrCaps.h.

241{ return fTransferBufferRowBytesAlignment; }

GrCaps::fTransferBufferRowBytesAlignment

size_t fTransferBufferRowBytesAlignment

Definition GrCaps.h:664

◆ transferFromBufferToBufferAlignment()

size_t GrCaps::transferFromBufferToBufferAlignment ( ) const

inline

Definition at line 244 of file GrCaps.h.

                                                       {
        return fTransferFromBufferToBufferAlignment;
    }

◆ transferFromBufferToBufferSupport()

bool GrCaps::transferFromBufferToBufferSupport ( ) const

inline

Definition at line 369 of file GrCaps.h.

369{ return fTransferFromBufferToBufferSupport; }

◆ transferFromBufferToTextureSupport()

bool GrCaps::transferFromBufferToTextureSupport ( ) const

inline

Definition at line 368 of file GrCaps.h.

368{ return fTransferFromBufferToTextureSupport; }

◆ transferFromSurfaceToBufferSupport()

bool GrCaps::transferFromSurfaceToBufferSupport ( ) const

inline

Definition at line 367 of file GrCaps.h.

367{ return fTransferFromSurfaceToBufferSupport; }

◆ transferPixelsToRowBytesSupport()

bool GrCaps::transferPixelsToRowBytesSupport ( ) const

inline

Does GrGpu::transferPixelsTo() support a src buffer where the row bytes is not equal to bpp * w?

Definition at line 360 of file GrCaps.h.

360{ return fTransferPixelsToRowBytesSupport; }

◆ twoSidedStencilRefsAndMasksMustMatch()

bool GrCaps::twoSidedStencilRefsAndMasksMustMatch ( ) const

inline

Definition at line 133 of file GrCaps.h.

                                                      {
        return fTwoSidedStencilRefsAndMasksMustMatch;
    }

◆ useClientSideIndirectBuffers()

bool GrCaps::useClientSideIndirectBuffers ( ) const

inline

Definition at line 85 of file GrCaps.h.

                                              {
#ifdef SK_DEBUG
        if (!fNativeDrawIndirectSupport || fNativeDrawIndexedIndirectIsBroken) {
            // We might implement indirect draws with a polyfill, so the commands need to reside in
            // CPU memory.
            SkASSERT(fUseClientSideIndirectBuffers);
        }
#endif
        return fUseClientSideIndirectBuffers;
    }

◆ usePrimitiveRestart()

bool GrCaps::usePrimitiveRestart ( ) const

inline

Definition at line 112 of file GrCaps.h.

112{ return fUsePrimitiveRestart; }

◆ validateSurfaceParams()

bool GrCaps::validateSurfaceParams	(	const SkISize &	dimensions,
		const GrBackendFormat &	format,
		GrRenderable	renderable,
		int	renderTargetSampleCnt,
		skgpu::Mipmapped	mipped,
		GrTextureType	textureType
	)		const

Definition at line 327 of file GrCaps.cpp.

                                                                                           {
    if (textureType != GrTextureType::kNone) {
        if (!this->isFormatTexturable(format, textureType)) {
            return false;
        }
    }
 
    if (skgpu::Mipmapped::kYes == mipped && !this->mipmapSupport()) {
        return false;
    }
 
    if (dimensions.width() < 1 || dimensions.height() < 1) {
        return false;
    }
 
    if (renderable == GrRenderable::kYes) {
        if (!this->isFormatRenderable(format, renderTargetSampleCnt)) {
            return false;
        }
        int maxRTSize = this->maxRenderTargetSize();
        if (dimensions.width() > maxRTSize || dimensions.height() > maxRTSize) {
            return false;
        }
    } else {
        // We currently do not support multisampled textures
        if (renderTargetSampleCnt != 1) {
            return false;
        }
        int maxSize = this->maxTextureSize();
        if (dimensions.width() > maxSize || dimensions.height() > maxSize) {
            return false;
        }
    }
 
    return true;
}

◆ wireframeMode()

bool GrCaps::wireframeMode ( ) const

inline

Definition at line 399 of file GrCaps.h.

399{ return fWireframeMode; }

◆ wireframeSupport()

bool GrCaps::wireframeSupport ( ) const

inline

Definition at line 96 of file GrCaps.h.

96{ return fWireframeSupport; }

◆ workarounds()

const GrDriverBugWorkarounds & GrCaps::workarounds ( ) const

inline

Definition at line 500 of file GrCaps.h.

500{ return fDriverBugWorkarounds; }

◆ writePixelsRowBytesSupport()

bool GrCaps::writePixelsRowBytesSupport ( ) const

inline

Does GrGpu::writePixels() support a src buffer where the row bytes is not equal to bpp * w?

Definition at line 354 of file GrCaps.h.

354{ return fWritePixelsRowBytesSupport; }

Member Data Documentation

◆ fAdvBlendEqDisableFlags

uint32_t GrCaps::fAdvBlendEqDisableFlags

protected

Definition at line 651 of file GrCaps.h.

◆ fAnisoSupport

bool GrCaps::fAnisoSupport

protected

Definition at line 588 of file GrCaps.h.

◆ fAvoidDithering

bool GrCaps::fAvoidDithering

protected

Definition at line 631 of file GrCaps.h.

◆ fAvoidLargeIndexBufferDraws

bool GrCaps::fAvoidLargeIndexBufferDraws

protected

Definition at line 614 of file GrCaps.h.

◆ fAvoidLineDraws

bool GrCaps::fAvoidLineDraws

protected

Definition at line 633 of file GrCaps.h.

◆ fAvoidReorderingRenderTasks

bool GrCaps::fAvoidReorderingRenderTasks

protected

Definition at line 630 of file GrCaps.h.

◆ fAvoidStencilBuffers

bool GrCaps::fAvoidStencilBuffers

protected

Definition at line 627 of file GrCaps.h.

◆ fAvoidWritePixelsFastPath

bool GrCaps::fAvoidWritePixelsFastPath

protected

Definition at line 628 of file GrCaps.h.

◆ fBackendSemaphoreSupport

bool GrCaps::fBackendSemaphoreSupport

protected

Definition at line 639 of file GrCaps.h.

◆ fBlendEquationSupport

BlendEquationSupport GrCaps::fBlendEquationSupport

protected

Definition at line 650 of file GrCaps.h.

◆ fBufferMapThreshold

int GrCaps::fBufferMapThreshold

protected

Definition at line 655 of file GrCaps.h.

◆ fBuffersAreInitiallyZero

bool GrCaps::fBuffersAreInitiallyZero

protected

Definition at line 607 of file GrCaps.h.

◆ fBufferUpdateDataPreserveAlignment

size_t GrCaps::fBufferUpdateDataPreserveAlignment = 1

protected

Definition at line 666 of file GrCaps.h.

◆ fClampToBorderSupport

bool GrCaps::fClampToBorderSupport

protected

Definition at line 611 of file GrCaps.h.

◆ fConservativeRasterSupport

bool GrCaps::fConservativeRasterSupport

protected

Definition at line 598 of file GrCaps.h.

◆ fCrossContextTextureSupport

bool GrCaps::fCrossContextTextureSupport

protected

Definition at line 643 of file GrCaps.h.

◆ fDisablePerspectiveSDFText

bool GrCaps::fDisablePerspectiveSDFText

protected

Definition at line 632 of file GrCaps.h.

◆ fDisableTessellationPathRenderer

bool GrCaps::fDisableTessellationPathRenderer

protected

Definition at line 626 of file GrCaps.h.

◆ fDrawInstancedSupport

bool GrCaps::fDrawInstancedSupport

protected

Definition at line 595 of file GrCaps.h.

◆ fDriverBugWorkarounds

GrDriverBugWorkarounds GrCaps::fDriverBugWorkarounds

protected

Definition at line 668 of file GrCaps.h.

◆ fDynamicStateArrayGeometryProcessorTextureSupport

bool GrCaps::fDynamicStateArrayGeometryProcessorTextureSupport

protected

Definition at line 646 of file GrCaps.h.

◆ fFinishedProcAsyncCallbackSupport

bool GrCaps::fFinishedProcAsyncCallbackSupport

protected

Definition at line 640 of file GrCaps.h.

◆ fGpuTracingSupport

bool GrCaps::fGpuTracingSupport

protected

Definition at line 591 of file GrCaps.h.

◆ fHalfFloatVertexAttributeSupport

bool GrCaps::fHalfFloatVertexAttributeSupport

protected

Definition at line 610 of file GrCaps.h.

◆ fInternalMultisampleCount

int GrCaps::fInternalMultisampleCount

protected

Definition at line 662 of file GrCaps.h.

◆ fMapBufferFlags

uint32_t GrCaps::fMapBufferFlags

protected

Definition at line 654 of file GrCaps.h.

◆ fMaxPreferredRenderTargetSize

int GrCaps::fMaxPreferredRenderTargetSize

protected

Definition at line 658 of file GrCaps.h.

◆ fMaxPushConstantsSize

uint32_t GrCaps::fMaxPushConstantsSize = 0

protected

Definition at line 663 of file GrCaps.h.

◆ fMaxRenderTargetSize

int GrCaps::fMaxRenderTargetSize

protected

Definition at line 657 of file GrCaps.h.

◆ fMaxTextureSize

int GrCaps::fMaxTextureSize

protected

Definition at line 660 of file GrCaps.h.

◆ fMaxVertexAttributes

int GrCaps::fMaxVertexAttributes

protected

Definition at line 659 of file GrCaps.h.

◆ fMaxWindowRectangles

int GrCaps::fMaxWindowRectangles

protected

Definition at line 661 of file GrCaps.h.

◆ fMipmapSupport

bool GrCaps::fMipmapSupport

protected

Definition at line 587 of file GrCaps.h.

◆ fMSAAResolvesAutomatically

bool GrCaps::fMSAAResolvesAutomatically

protected

Definition at line 600 of file GrCaps.h.

◆ fMustClearUploadedBufferData

bool GrCaps::fMustClearUploadedBufferData

protected

Definition at line 606 of file GrCaps.h.

◆ fMustSyncGpuDuringAbandon

bool GrCaps::fMustSyncGpuDuringAbandon

protected

Definition at line 623 of file GrCaps.h.

◆ fNativeDrawIndexedIndirectIsBroken

bool GrCaps::fNativeDrawIndexedIndirectIsBroken

protected

Definition at line 629 of file GrCaps.h.

◆ fNativeDrawIndirectSupport

bool GrCaps::fNativeDrawIndirectSupport

protected

Definition at line 596 of file GrCaps.h.

◆ fNPOTTextureTileSupport

bool GrCaps::fNPOTTextureTileSupport

protected

Definition at line 586 of file GrCaps.h.

◆ fOversizedStencilSupport

bool GrCaps::fOversizedStencilSupport

protected

Definition at line 592 of file GrCaps.h.

◆ fPerformColorClearsAsDraws

bool GrCaps::fPerformColorClearsAsDraws

protected

Definition at line 613 of file GrCaps.h.

◆ fPerformPartialClearsAsDraws

bool GrCaps::fPerformPartialClearsAsDraws

protected

Definition at line 612 of file GrCaps.h.

◆ fPerformStencilClearsAsDraws

bool GrCaps::fPerformStencilClearsAsDraws

protected

Definition at line 615 of file GrCaps.h.

◆ fPreferClientSideDynamicBuffers

bool GrCaps::fPreferClientSideDynamicBuffers

protected

Definition at line 603 of file GrCaps.h.

◆ fPreferDiscardableMSAAAttachment

bool GrCaps::fPreferDiscardableMSAAAttachment

protected

Definition at line 601 of file GrCaps.h.

◆ fPreferFullscreenClears

bool GrCaps::fPreferFullscreenClears

protected

Definition at line 604 of file GrCaps.h.

◆ fPreferVRAMUseOverFlushes

bool GrCaps::fPreferVRAMUseOverFlushes

protected

Definition at line 636 of file GrCaps.h.

◆ fReadPixelsRowBytesSupport

bool GrCaps::fReadPixelsRowBytesSupport

protected

Definition at line 621 of file GrCaps.h.

◆ fReuseScratchBuffers

bool GrCaps::fReuseScratchBuffers

protected

Definition at line 590 of file GrCaps.h.

◆ fReuseScratchTextures

bool GrCaps::fReuseScratchTextures

protected

Definition at line 589 of file GrCaps.h.

◆ fSampleLocationsSupport

bool GrCaps::fSampleLocationsSupport

protected

Definition at line 594 of file GrCaps.h.

◆ fSemaphoreSupport

bool GrCaps::fSemaphoreSupport

protected

Definition at line 638 of file GrCaps.h.

◆ fShaderCaps

std::unique_ptr<GrShaderCaps> GrCaps::fShaderCaps

protected

Definition at line 584 of file GrCaps.h.

◆ fShouldCollapseSrcOverToSrcWhenAble

bool GrCaps::fShouldCollapseSrcOverToSrcWhenAble

protected

Definition at line 622 of file GrCaps.h.

◆ fShouldInitializeTextures

bool GrCaps::fShouldInitializeTextures

protected

Definition at line 608 of file GrCaps.h.

◆ fSupportsAHardwareBufferImages

bool GrCaps::fSupportsAHardwareBufferImages

protected

Definition at line 609 of file GrCaps.h.

◆ fSupportsProtectedContent

bool GrCaps::fSupportsProtectedContent

protected

Definition at line 648 of file GrCaps.h.

◆ fTextureBarrierSupport

bool GrCaps::fTextureBarrierSupport

protected

Definition at line 593 of file GrCaps.h.

◆ fTransferBufferRowBytesAlignment

size_t GrCaps::fTransferBufferRowBytesAlignment = 1

protected

Definition at line 664 of file GrCaps.h.

◆ fTransferFromBufferToBufferAlignment

size_t GrCaps::fTransferFromBufferToBufferAlignment = 1

protected

Definition at line 665 of file GrCaps.h.

◆ fTransferFromBufferToBufferSupport

bool GrCaps::fTransferFromBufferToBufferSupport

protected

Definition at line 618 of file GrCaps.h.

◆ fTransferFromBufferToTextureSupport

bool GrCaps::fTransferFromBufferToTextureSupport

protected

Definition at line 616 of file GrCaps.h.

◆ fTransferFromSurfaceToBufferSupport

bool GrCaps::fTransferFromSurfaceToBufferSupport

protected

Definition at line 617 of file GrCaps.h.

◆ fTransferPixelsToRowBytesSupport

bool GrCaps::fTransferPixelsToRowBytesSupport

protected

Definition at line 620 of file GrCaps.h.

◆ fTwoSidedStencilRefsAndMasksMustMatch

bool GrCaps::fTwoSidedStencilRefsAndMasksMustMatch

protected

Definition at line 605 of file GrCaps.h.

◆ fUseClientSideIndirectBuffers

bool GrCaps::fUseClientSideIndirectBuffers

protected

Definition at line 597 of file GrCaps.h.

◆ fUsePrimitiveRestart

bool GrCaps::fUsePrimitiveRestart

protected

Definition at line 602 of file GrCaps.h.

◆ fWireframeSupport

bool GrCaps::fWireframeSupport

protected

Definition at line 599 of file GrCaps.h.

◆ fWritePixelsRowBytesSupport

bool GrCaps::fWritePixelsRowBytesSupport

protected

Definition at line 619 of file GrCaps.h.

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

third_party/skia/src/gpu/ganesh/GrCaps.h
third_party/skia/src/gpu/ganesh/GrCaps.cpp

Classes

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ BlendEquationSupport

◆ MapFlags

◆ ProgramDescOverrideFlags

◆ SurfaceReadPixelsSupport

Constructor & Destructor Documentation

◆ GrCaps()

Member Function Documentation

◆ addExtraSamplerKey()

◆ advancedBlendEquationSupport()

◆ advancedCoherentBlendEquationSupport()

◆ anisoSupport()

◆ areColorTypeAndFormatCompatible()

◆ avoidDithering()

◆ avoidLargeIndexBufferDraws()

◆ avoidLineDraws()

◆ avoidReorderingRenderTasks()

◆ avoidStencilBuffers()

◆ avoidWritePixelsFastPath()

◆ backendSemaphoreSupport()

◆ blendEquationSupport()

◆ bufferMapThreshold()

◆ buffersAreInitiallyZero()

◆ bufferUpdateDataPreserveAlignment()

◆ canCopySurface()

◆ clampToBorderSupport()

◆ computeFormatKey()

◆ conservativeRasterSupport()

◆ crossContextTextureSupport()

◆ disablePerspectiveSDFText()

◆ disableTessellationPathRenderer()

◆ discardStencilValuesAfterRenderPass()

◆ dmsaaResolveCanBeUsedAsTextureInSameRenderPass()

◆ drawInstancedSupport()

◆ dumpJSON()

◆ dynamicStateArrayGeometryProcessorTextureSupport()

◆ finishedProcAsyncCallbackSupport()

◆ finishInitialization()

◆ getBackendFormatFromCompressionType()

◆ getDefaultBackendFormat()

◆ getDstCopyRestrictions()

◆ getDstSampleFlagsForProxy()

◆ getExtraSurfaceFlagsForDeferredRT()

◆ getFallbackColorTypeAndFormat()

◆ getReadSwizzle()

◆ getRenderTargetSampleCount()

◆ getWriteSwizzle()

◆ gpuTracingSupport()

◆ GR_DECL_BITFIELD_CLASS_OPS_FRIENDS()

◆ halfFloatVertexAttributeSupport()

◆ internalMultisampleCount()

◆ isAdvancedBlendEquationDisabled()

◆ isFormatAsColorTypeRenderable()

◆ isFormatCompressed()

◆ isFormatCopyable()

◆ isFormatRenderable()

◆ isFormatSRGB()

◆ isFormatTexturable()

◆ isWindowRectanglesSupportedForRT()

◆ makeDesc()

◆ mapBufferFlags()

◆ maxPreferredRenderTargetSize()

◆ maxPushConstantsSize()

◆ maxRenderTargetSampleCount()

◆ maxRenderTargetSize()

◆ maxTextureSize()

◆ maxVertexAttributes()

◆ maxWindowRectangles()

◆ mipmapSupport()

◆ msaaResolvesAutomatically()

◆ mustClearUploadedBufferData()

◆ mustSyncGpuDuringAbandon()