3ea1798829
Change-Id: I7db113e66d81516b2beb5eefeddf488d9bfed2e5 Reviewed-on: https://skia-review.googlesource.com/18488 Reviewed-by: Brian Salomon <bsalomon@google.com> Commit-Queue: Robert Phillips <robertphillips@google.com>
268 lines
11 KiB
C++
268 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 "GrTypes.h"
|
|
#include "GrTypesPriv.h"
|
|
#include "GrBlend.h"
|
|
#include "GrShaderCaps.h"
|
|
#include "SkRefCnt.h"
|
|
#include "SkString.h"
|
|
|
|
struct GrContextOptions;
|
|
class GrRenderTargetProxy;
|
|
|
|
/**
|
|
* Represents the capabilities of a GrContext.
|
|
*/
|
|
class GrCaps : public SkRefCnt {
|
|
public:
|
|
GrCaps(const GrContextOptions&);
|
|
|
|
virtual SkString dump() 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 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; }
|
|
bool preferClientSideDynamicBuffers() const { return fPreferClientSideDynamicBuffers; }
|
|
|
|
bool useDrawInsteadOfClear() const { return fUseDrawInsteadOfClear; }
|
|
bool useDrawInsteadOfPartialRenderTargetWrite() const {
|
|
return fUseDrawInsteadOfPartialRenderTargetWrite;
|
|
}
|
|
|
|
bool useDrawInsteadOfAllRenderTargetWrites() const {
|
|
return fUseDrawInsteadOfAllRenderTargetWrites;
|
|
}
|
|
|
|
bool preferVRAMUseOverFlushes() const { return fPreferVRAMUseOverFlushes; }
|
|
|
|
/**
|
|
* Indicates the level of support for gr_instanced::* functionality. A higher level includes
|
|
* all functionality from the levels below it.
|
|
*/
|
|
enum class InstancedSupport {
|
|
kNone,
|
|
kBasic,
|
|
kMultisampled,
|
|
kMixedSampled
|
|
};
|
|
|
|
InstancedSupport instancedSupport() const { return fInstancedSupport; }
|
|
|
|
bool avoidInstancedDrawsToFPTargets() const { return fAvoidInstancedDrawsToFPTargets; }
|
|
|
|
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.k
|
|
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; }
|
|
|
|
// Will be 0 if MSAA is not supported
|
|
int maxColorSampleCount() const { return fMaxColorSampleCount; }
|
|
// Will be 0 if MSAA is not supported
|
|
int maxStencilSampleCount() const { return fMaxStencilSampleCount; }
|
|
// Will be 0 if raster multisample is not supported. Raster multisample is a special HW mode
|
|
// where the rasterizer runs with more samples than are in the target framebuffer.
|
|
int maxRasterSamples() const { return fMaxRasterSamples; }
|
|
// We require the sample count to be less than maxColorSampleCount and maxStencilSampleCount.
|
|
// If we are using mixed samples, we only care about stencil.
|
|
int maxSampleCount() const {
|
|
if (this->usesMixedSamples()) {
|
|
return this->maxStencilSampleCount();
|
|
} else {
|
|
return SkTMin(this->maxColorSampleCount(), this->maxStencilSampleCount());
|
|
}
|
|
}
|
|
|
|
int maxWindowRectangles() const { return fMaxWindowRectangles; }
|
|
|
|
virtual bool isConfigTexturable(GrPixelConfig) const = 0;
|
|
virtual bool isConfigRenderable(GrPixelConfig config, bool withMSAA) const = 0;
|
|
virtual bool canConfigBeImageStorage(GrPixelConfig config) const = 0;
|
|
|
|
bool suppressPrints() const { return fSuppressPrints; }
|
|
|
|
size_t bufferMapThreshold() const {
|
|
SkASSERT(fBufferMapThreshold >= 0);
|
|
return fBufferMapThreshold;
|
|
}
|
|
|
|
bool fullClearIsFree() const { return fFullClearIsFree; }
|
|
|
|
/** 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;
|
|
|
|
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 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 fPreferClientSideDynamicBuffers : 1;
|
|
bool fFullClearIsFree : 1;
|
|
bool fMustClearUploadedBufferData : 1;
|
|
|
|
// Driver workaround
|
|
bool fUseDrawInsteadOfClear : 1;
|
|
bool fUseDrawInsteadOfPartialRenderTargetWrite : 1;
|
|
bool fUseDrawInsteadOfAllRenderTargetWrites : 1;
|
|
bool fAvoidInstancedDrawsToFPTargets : 1;
|
|
bool fAvoidStencilBuffers : 1;
|
|
|
|
// ANGLE 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;
|
|
|
|
InstancedSupport fInstancedSupport;
|
|
|
|
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;
|
|
|
|
private:
|
|
virtual void onApplyOptionsOverrides(const GrContextOptions&) {}
|
|
|
|
bool fSuppressPrints : 1;
|
|
bool fWireframeMode : 1;
|
|
|
|
typedef SkRefCnt INHERITED;
|
|
};
|
|
|
|
#endif
|