27059d36d6
Bug: skia: Change-Id: Ia7ab55f8b6ecdd674762f5197d35e8db58f07c01 Reviewed-on: https://skia-review.googlesource.com/98180 Commit-Queue: Chris Dalton <csmartdalton@google.com> Reviewed-by: Brian Salomon <bsalomon@google.com>
261 lines
11 KiB
C++
261 lines
11 KiB
C++
|
|
/*
|
|
* Copyright 2013 Google Inc.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license that can be
|
|
* found in the LICENSE file.
|
|
*/
|
|
#ifndef GrCaps_DEFINED
|
|
#define GrCaps_DEFINED
|
|
|
|
#include "../private/GrTypesPriv.h"
|
|
#include "GrBlend.h"
|
|
#include "GrShaderCaps.h"
|
|
#include "SkImageInfo.h"
|
|
#include "SkRefCnt.h"
|
|
#include "SkString.h"
|
|
|
|
class GrBackendRenderTarget;
|
|
class GrBackendTexture;
|
|
struct GrContextOptions;
|
|
class GrRenderTargetProxy;
|
|
class SkJSONWriter;
|
|
|
|
/**
|
|
* Represents the capabilities of a GrContext.
|
|
*/
|
|
class GrCaps : public SkRefCnt {
|
|
public:
|
|
GrCaps(const GrContextOptions&);
|
|
|
|
void dumpJSON(SkJSONWriter*) const;
|
|
|
|
const GrShaderCaps* shaderCaps() const { return fShaderCaps.get(); }
|
|
|
|
bool npotTextureTileSupport() const { return fNPOTTextureTileSupport; }
|
|
/** To avoid as-yet-unnecessary complexity we don't allow any partial support of MIP Maps (e.g.
|
|
only for POT textures) */
|
|
bool mipMapSupport() const { return fMipMapSupport; }
|
|
|
|
/**
|
|
* Skia convention is that a device only has sRGB support if it supports sRGB formats for both
|
|
* textures and framebuffers. In addition:
|
|
* Decoding to linear of an sRGB texture can be disabled.
|
|
*/
|
|
bool srgbSupport() const { return fSRGBSupport; }
|
|
/**
|
|
* Is there support for enabling/disabling sRGB writes for sRGB-capable color buffers?
|
|
*/
|
|
bool srgbWriteControl() const { return fSRGBWriteControl; }
|
|
bool srgbDecodeDisableSupport() const { return fSRGBDecodeDisableSupport; }
|
|
bool discardRenderTargetSupport() const { return fDiscardRenderTargetSupport; }
|
|
bool gpuTracingSupport() const { return fGpuTracingSupport; }
|
|
bool oversizedStencilSupport() const { return fOversizedStencilSupport; }
|
|
bool textureBarrierSupport() const { return fTextureBarrierSupport; }
|
|
bool sampleLocationsSupport() const { return fSampleLocationsSupport; }
|
|
bool multisampleDisableSupport() const { return fMultisampleDisableSupport; }
|
|
bool instanceAttribSupport() const { return fInstanceAttribSupport; }
|
|
bool usesMixedSamples() const { return fUsesMixedSamples; }
|
|
|
|
// Primitive restart functionality is core in ES 3.0, but using it will cause slowdowns on some
|
|
// systems. This cap is only set if primitive restart will improve performance.
|
|
bool usePrimitiveRestart() const { return fUsePrimitiveRestart; }
|
|
|
|
bool preferClientSideDynamicBuffers() const { return fPreferClientSideDynamicBuffers; }
|
|
|
|
// On tilers, an initial fullscreen clear is an OPTIMIZATION. It allows the hardware to
|
|
// initialize each tile with a constant value rather than loading each pixel from memory.
|
|
bool preferFullscreenClears() const { return fPreferFullscreenClears; }
|
|
|
|
bool preferVRAMUseOverFlushes() const { return fPreferVRAMUseOverFlushes; }
|
|
|
|
bool blacklistCoverageCounting() const { return fBlacklistCoverageCounting; }
|
|
|
|
bool avoidStencilBuffers() const { return fAvoidStencilBuffers; }
|
|
|
|
/**
|
|
* Indicates the capabilities of the fixed function blend unit.
|
|
*/
|
|
enum BlendEquationSupport {
|
|
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
|
|
};
|
|
|
|
BlendEquationSupport blendEquationSupport() const { return fBlendEquationSupport; }
|
|
|
|
bool advancedBlendEquationSupport() const {
|
|
return fBlendEquationSupport >= kAdvanced_BlendEquationSupport;
|
|
}
|
|
|
|
bool advancedCoherentBlendEquationSupport() const {
|
|
return kAdvancedCoherent_BlendEquationSupport == fBlendEquationSupport;
|
|
}
|
|
|
|
bool canUseAdvancedBlendEquation(GrBlendEquation equation) const {
|
|
SkASSERT(GrBlendEquationIsAdvanced(equation));
|
|
return SkToBool(fAdvBlendEqBlacklist & (1 << equation));
|
|
}
|
|
|
|
/**
|
|
* Indicates whether GPU->CPU memory mapping for GPU resources such as vertex buffers and
|
|
* textures allows partial mappings or full mappings.
|
|
*/
|
|
enum MapFlags {
|
|
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.
|
|
};
|
|
|
|
uint32_t mapBufferFlags() const { return fMapBufferFlags; }
|
|
|
|
// Scratch textures not being reused means that those scratch textures
|
|
// that we upload to (i.e., don't have a render target) will not be
|
|
// recycled in the texture cache. This is to prevent ghosting by drivers
|
|
// (in particular for deferred architectures).
|
|
bool reuseScratchTextures() const { return fReuseScratchTextures; }
|
|
bool reuseScratchBuffers() const { return fReuseScratchBuffers; }
|
|
|
|
/// maximum number of attribute values per vertex
|
|
int maxVertexAttributes() const { return fMaxVertexAttributes; }
|
|
|
|
int maxRenderTargetSize() const { return fMaxRenderTargetSize; }
|
|
int maxTextureSize() const { return fMaxTextureSize; }
|
|
/** This is the maximum tile size to use by GPU devices for rendering sw-backed images/bitmaps.
|
|
It is usually the max texture size, unless we're overriding it for testing. */
|
|
int maxTileSize() const { SkASSERT(fMaxTileSize <= fMaxTextureSize); return fMaxTileSize; }
|
|
|
|
int maxRasterSamples() const { return fMaxRasterSamples; }
|
|
|
|
// Find a sample count greater than or equal to the requested count which is supported for a
|
|
// color buffer of the given config. If MSAA is not support for the config we will return 0.
|
|
virtual int getSampleCount(int requestedCount, GrPixelConfig config) const = 0;
|
|
|
|
int maxWindowRectangles() const { return fMaxWindowRectangles; }
|
|
|
|
// A tuned, platform-specific value for the maximum number of analytic fragment processors we
|
|
// should use to implement a clip, before falling back on a mask.
|
|
int maxClipAnalyticFPs() const { return fMaxClipAnalyticFPs; }
|
|
|
|
virtual bool isConfigTexturable(GrPixelConfig) const = 0;
|
|
virtual bool isConfigRenderable(GrPixelConfig config, bool withMSAA) const = 0;
|
|
// Returns whether a texture of the given config can be copied to a texture of the same config.
|
|
virtual bool isConfigCopyable(GrPixelConfig config) const = 0;
|
|
|
|
bool suppressPrints() const { return fSuppressPrints; }
|
|
|
|
size_t bufferMapThreshold() const {
|
|
SkASSERT(fBufferMapThreshold >= 0);
|
|
return fBufferMapThreshold;
|
|
}
|
|
|
|
/** True in environments that will issue errors if memory uploaded to buffers
|
|
is not initialized (even if not read by draw calls). */
|
|
bool mustClearUploadedBufferData() const { return fMustClearUploadedBufferData; }
|
|
|
|
bool wireframeMode() const { return fWireframeMode; }
|
|
|
|
bool sampleShadingSupport() const { return fSampleShadingSupport; }
|
|
|
|
bool fenceSyncSupport() const { return fFenceSyncSupport; }
|
|
bool crossContextTextureSupport() const { return fCrossContextTextureSupport; }
|
|
|
|
/**
|
|
* This is can be called before allocating a texture to be a dst for copySurface. This is only
|
|
* used for doing dst copies needed in blends, thus the src is always a GrRenderTargetProxy. It
|
|
* will populate the origin, config, and flags fields of the desc such that copySurface can
|
|
* efficiently succeed. rectsMustMatch will be set to true if the copy operation must ensure
|
|
* that the src and dest rects are identical. disallowSubrect will be set to true if copy rect
|
|
* must equal src's bounds.
|
|
*/
|
|
virtual bool initDescForDstCopy(const GrRenderTargetProxy* src, GrSurfaceDesc* desc,
|
|
bool* rectsMustMatch, bool* disallowSubrect) const = 0;
|
|
|
|
/**
|
|
* Returns true if the GrBackendTexutre can we used with the supplied SkColorType. If it is
|
|
* compatible, the passed in GrPixelConfig will be set to a config that matches the backend
|
|
* format and requested SkColorType.
|
|
*/
|
|
virtual bool validateBackendTexture(const GrBackendTexture& tex, SkColorType ct,
|
|
GrPixelConfig*) const = 0;
|
|
virtual bool validateBackendRenderTarget(const GrBackendRenderTarget&, SkColorType,
|
|
GrPixelConfig*) const = 0;
|
|
|
|
protected:
|
|
/** Subclasses must call this at the end of their constructors in order to apply caps
|
|
overrides requested by the client. Note that overrides will only reduce the caps never
|
|
expand them. */
|
|
void applyOptionsOverrides(const GrContextOptions& options);
|
|
|
|
sk_sp<GrShaderCaps> fShaderCaps;
|
|
|
|
bool fNPOTTextureTileSupport : 1;
|
|
bool fMipMapSupport : 1;
|
|
bool fSRGBSupport : 1;
|
|
bool fSRGBWriteControl : 1;
|
|
bool fSRGBDecodeDisableSupport : 1;
|
|
bool fDiscardRenderTargetSupport : 1;
|
|
bool fReuseScratchTextures : 1;
|
|
bool fReuseScratchBuffers : 1;
|
|
bool fGpuTracingSupport : 1;
|
|
bool fOversizedStencilSupport : 1;
|
|
bool fTextureBarrierSupport : 1;
|
|
bool fSampleLocationsSupport : 1;
|
|
bool fMultisampleDisableSupport : 1;
|
|
bool fInstanceAttribSupport : 1;
|
|
bool fUsesMixedSamples : 1;
|
|
bool fUsePrimitiveRestart : 1;
|
|
bool fPreferClientSideDynamicBuffers : 1;
|
|
bool fPreferFullscreenClears : 1;
|
|
bool fMustClearUploadedBufferData : 1;
|
|
|
|
// Driver workaround
|
|
bool fBlacklistCoverageCounting : 1;
|
|
bool fAvoidStencilBuffers : 1;
|
|
|
|
// ANGLE performance workaround
|
|
bool fPreferVRAMUseOverFlushes : 1;
|
|
|
|
bool fSampleShadingSupport : 1;
|
|
// TODO: this may need to be an enum to support different fence types
|
|
bool fFenceSyncSupport : 1;
|
|
|
|
// Vulkan doesn't support this (yet) and some drivers have issues, too
|
|
bool fCrossContextTextureSupport : 1;
|
|
|
|
BlendEquationSupport fBlendEquationSupport;
|
|
uint32_t fAdvBlendEqBlacklist;
|
|
GR_STATIC_ASSERT(kLast_GrBlendEquation < 32);
|
|
|
|
uint32_t fMapBufferFlags;
|
|
int fBufferMapThreshold;
|
|
|
|
int fMaxRenderTargetSize;
|
|
int fMaxVertexAttributes;
|
|
int fMaxTextureSize;
|
|
int fMaxTileSize;
|
|
int fMaxColorSampleCount;
|
|
int fMaxStencilSampleCount;
|
|
int fMaxRasterSamples;
|
|
int fMaxWindowRectangles;
|
|
int fMaxClipAnalyticFPs;
|
|
|
|
private:
|
|
virtual void onApplyOptionsOverrides(const GrContextOptions&) {}
|
|
virtual void onDumpJSON(SkJSONWriter*) const {}
|
|
|
|
bool fSuppressPrints : 1;
|
|
bool fWireframeMode : 1;
|
|
|
|
typedef SkRefCnt INHERITED;
|
|
};
|
|
|
|
#endif
|