123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306 |
- /*
- * Copyright 2012 Google Inc.
- *
- * Use of this source code is governed by a BSD-style license that can be
- * found in the LICENSE file.
- */
- #ifndef GrShaderCaps_DEFINED
- #define GrShaderCaps_DEFINED
- #include "include/core/SkRefCnt.h"
- #include "include/private/GrTypesPriv.h"
- #include "src/gpu/GrSwizzle.h"
- #include "src/gpu/glsl/GrGLSL.h"
- namespace SkSL {
- class ShaderCapsFactory;
- }
- struct GrContextOptions;
- class SkJSONWriter;
- class GrShaderCaps : public SkRefCnt {
- public:
- /**
- * Indicates how GLSL must interact with advanced blend equations. The KHR extension requires
- * special layout qualifiers in the fragment shader.
- */
- enum AdvBlendEqInteraction {
- kNotSupported_AdvBlendEqInteraction, //<! No _blend_equation_advanced extension
- kAutomatic_AdvBlendEqInteraction, //<! No interaction required
- kGeneralEnable_AdvBlendEqInteraction, //<! layout(blend_support_all_equations) out
- kSpecificEnables_AdvBlendEqInteraction, //<! Specific layout qualifiers per equation
- kLast_AdvBlendEqInteraction = kSpecificEnables_AdvBlendEqInteraction
- };
- GrShaderCaps(const GrContextOptions&);
- void dumpJSON(SkJSONWriter*) const;
- bool supportsDistanceFieldText() const { return fShaderDerivativeSupport; }
- bool shaderDerivativeSupport() const { return fShaderDerivativeSupport; }
- bool geometryShaderSupport() const { return fGeometryShaderSupport; }
- bool gsInvocationsSupport() const { return fGSInvocationsSupport; }
- bool pathRenderingSupport() const { return fPathRenderingSupport; }
- bool dstReadInShaderSupport() const { return fDstReadInShaderSupport; }
- bool dualSourceBlendingSupport() const { return fDualSourceBlendingSupport; }
- bool integerSupport() const { return fIntegerSupport; }
- /**
- * Some helper functions for encapsulating various extensions to read FB Buffer on openglES
- *
- * TODO(joshualitt) On desktop opengl 4.2+ we can achieve something similar to this effect
- */
- bool fbFetchSupport() const { return fFBFetchSupport; }
- bool fbFetchNeedsCustomOutput() const { return fFBFetchNeedsCustomOutput; }
- const char* versionDeclString() const { return fVersionDeclString; }
- const char* fbFetchColorName() const { return fFBFetchColorName; }
- const char* fbFetchExtensionString() const { return fFBFetchExtensionString; }
- bool flatInterpolationSupport() const { return fFlatInterpolationSupport; }
- bool preferFlatInterpolation() const { return fPreferFlatInterpolation; }
- bool noperspectiveInterpolationSupport() const { return fNoPerspectiveInterpolationSupport; }
- // Can we use sample variables everywhere?
- bool sampleVariablesSupport() const { return fSampleVariablesSupport; }
- // Can we use sample variables when rendering to stencil? (This is a workaround for platforms
- // where sample variables are broken in general, but seem to work when rendering to stencil.)
- bool sampleVariablesStencilSupport() const { return fSampleVariablesStencilSupport; }
- bool externalTextureSupport() const { return fExternalTextureSupport; }
- bool vertexIDSupport() const { return fVertexIDSupport; }
- // frexp, ldexp, etc.
- bool fpManipulationSupport() const { return fFPManipulationSupport; }
- bool floatIs32Bits() const { return fFloatIs32Bits; }
- bool halfIs32Bits() const { return fHalfIs32Bits; }
- bool hasLowFragmentPrecision() const { return fHasLowFragmentPrecision; }
- // SkSL only.
- bool builtinFMASupport() const { return fBuiltinFMASupport; }
- AdvBlendEqInteraction advBlendEqInteraction() const { return fAdvBlendEqInteraction; }
- bool mustEnableAdvBlendEqs() const {
- return fAdvBlendEqInteraction >= kGeneralEnable_AdvBlendEqInteraction;
- }
- bool mustEnableSpecificAdvBlendEqs() const {
- return fAdvBlendEqInteraction == kSpecificEnables_AdvBlendEqInteraction;
- }
- bool mustDeclareFragmentShaderOutput() const { return fGLSLGeneration > k110_GrGLSLGeneration; }
- bool usesPrecisionModifiers() const { return fUsesPrecisionModifiers; }
- // Returns whether we can use the glsl function any() in our shader code.
- bool canUseAnyFunctionInShader() const { return fCanUseAnyFunctionInShader; }
- bool canUseMinAndAbsTogether() const { return fCanUseMinAndAbsTogether; }
- bool canUseFractForNegativeValues() const { return fCanUseFractForNegativeValues; }
- bool mustForceNegatedAtanParamToFloat() const { return fMustForceNegatedAtanParamToFloat; }
- // Returns whether a device incorrectly implements atan(y,x) as atan(y/x)
- bool atan2ImplementedAsAtanYOverX() const { return fAtan2ImplementedAsAtanYOverX; }
- // If this returns true some operation (could be a no op) must be called between floor and abs
- // to make sure the driver compiler doesn't inline them together which can cause a driver bug in
- // the shader.
- bool mustDoOpBetweenFloorAndAbs() const { return fMustDoOpBetweenFloorAndAbs; }
- // If false, SkSL uses a workaround so that sk_FragCoord doesn't actually query gl_FragCoord
- bool canUseFragCoord() const { return fCanUseFragCoord; }
- // If true, short ints can't represent every integer in the 16-bit two's complement range as
- // required by the spec. SKSL will always emit full ints.
- bool incompleteShortIntPrecision() const { return fIncompleteShortIntPrecision; }
- // If true, then conditions in for loops need "&& true" to work around driver bugs.
- bool addAndTrueToLoopCondition() const { return fAddAndTrueToLoopCondition; }
- // If true, then expressions such as "x && y" or "x || y" are rewritten as
- // ternary to work around driver bugs.
- bool unfoldShortCircuitAsTernary() const { return fUnfoldShortCircuitAsTernary; }
- bool emulateAbsIntFunction() const { return fEmulateAbsIntFunction; }
- bool rewriteDoWhileLoops() const { return fRewriteDoWhileLoops; }
- bool removePowWithConstantExponent() const { return fRemovePowWithConstantExponent; }
- bool requiresLocalOutputColorForFBFetch() const { return fRequiresLocalOutputColorForFBFetch; }
- bool mustObfuscateUniformColor() const { return fMustObfuscateUniformColor; }
- // The D3D shader compiler, when targeting PS 3.0 (ie within ANGLE) fails to compile certain
- // constructs. See detailed comments in GrGLCaps.cpp.
- bool mustGuardDivisionEvenAfterExplicitZeroCheck() const {
- return fMustGuardDivisionEvenAfterExplicitZeroCheck;
- }
- // On Nexus 6, the GL context can get lost if a shader does not write a value to gl_FragColor.
- // https://bugs.chromium.org/p/chromium/issues/detail?id=445377
- bool mustWriteToFragColor() const { return fMustWriteToFragColor; }
- // Returns the string of an extension that must be enabled in the shader to support
- // derivatives. If nullptr is returned then no extension needs to be enabled. Before calling
- // this function, the caller should check that shaderDerivativeSupport exists.
- const char* shaderDerivativeExtensionString() const {
- SkASSERT(this->shaderDerivativeSupport());
- return fShaderDerivativeExtensionString;
- }
- // Returns the string of an extension that must be enabled in the shader to support geometry
- // shaders. If nullptr is returned then no extension needs to be enabled. Before calling this
- // function, the caller must verify that geometryShaderSupport exists.
- const char* geometryShaderExtensionString() const {
- SkASSERT(this->geometryShaderSupport());
- return fGeometryShaderExtensionString;
- }
- // Returns the string of an extension that must be enabled in the shader to support
- // geometry shader invocations. If nullptr is returned then no extension needs to be enabled.
- // Before calling this function, the caller must verify that gsInvocationsSupport exists.
- const char* gsInvocationsExtensionString() const {
- SkASSERT(this->gsInvocationsSupport());
- return fGSInvocationsExtensionString;
- }
- // Returns the string of an extension that will do all necessary coord transfomations needed
- // when reading the fragment position. If such an extension does not exisits, this function
- // returns a nullptr, and all transforms of the frag position must be done manually in the
- // shader.
- const char* fragCoordConventionsExtensionString() const {
- return fFragCoordConventionsExtensionString;
- }
- // This returns the name of an extension that must be enabled in the shader, if such a thing is
- // required in order to use a secondary output in the shader. This returns a nullptr if no such
- // extension is required. However, the return value of this function does not say whether dual
- // source blending is supported.
- const char* secondaryOutputExtensionString() const { return fSecondaryOutputExtensionString; }
- // This returns the name of an extension that must be enabled in the shader to support external
- // textures. In some cases, two extensions must be enabled - the second extension is returned
- // by secondExternalTextureExtensionString(). If that function returns nullptr, then only one
- // extension is required.
- const char* externalTextureExtensionString() const {
- SkASSERT(this->externalTextureSupport());
- return fExternalTextureExtensionString;
- }
- const char* secondExternalTextureExtensionString() const {
- SkASSERT(this->externalTextureSupport());
- return fSecondExternalTextureExtensionString;
- }
- const char* noperspectiveInterpolationExtensionString() const {
- SkASSERT(this->noperspectiveInterpolationSupport());
- return fNoPerspectiveInterpolationExtensionString;
- }
- const char* sampleVariablesExtensionString() const {
- SkASSERT(this->sampleVariablesSupport() || this->sampleVariablesStencilSupport());
- return fSampleVariablesExtensionString;
- }
- int maxFragmentSamplers() const { return fMaxFragmentSamplers; }
- bool textureSwizzleAppliedInShader() const { return fTextureSwizzleAppliedInShader; }
- GrGLSLGeneration generation() const { return fGLSLGeneration; }
- private:
- void applyOptionsOverrides(const GrContextOptions& options);
- GrGLSLGeneration fGLSLGeneration;
- bool fShaderDerivativeSupport : 1;
- bool fGeometryShaderSupport : 1;
- bool fGSInvocationsSupport : 1;
- bool fPathRenderingSupport : 1;
- bool fDstReadInShaderSupport : 1;
- bool fDualSourceBlendingSupport : 1;
- bool fIntegerSupport : 1;
- bool fFBFetchSupport : 1;
- bool fFBFetchNeedsCustomOutput : 1;
- bool fUsesPrecisionModifiers : 1;
- bool fFlatInterpolationSupport : 1;
- bool fPreferFlatInterpolation : 1;
- bool fNoPerspectiveInterpolationSupport : 1;
- bool fSampleVariablesSupport : 1;
- bool fSampleVariablesStencilSupport : 1;
- bool fExternalTextureSupport : 1;
- bool fVertexIDSupport : 1;
- bool fFPManipulationSupport : 1;
- bool fFloatIs32Bits : 1;
- bool fHalfIs32Bits : 1;
- bool fHasLowFragmentPrecision : 1;
- bool fTextureSwizzleAppliedInShader : 1;
- // Used by SkSL to know when to generate polyfills.
- bool fBuiltinFMASupport : 1;
- // Used for specific driver bug work arounds
- bool fCanUseAnyFunctionInShader : 1;
- bool fCanUseMinAndAbsTogether : 1;
- bool fCanUseFractForNegativeValues : 1;
- bool fMustForceNegatedAtanParamToFloat : 1;
- bool fAtan2ImplementedAsAtanYOverX : 1;
- bool fMustDoOpBetweenFloorAndAbs : 1;
- bool fRequiresLocalOutputColorForFBFetch : 1;
- bool fMustObfuscateUniformColor : 1;
- bool fMustGuardDivisionEvenAfterExplicitZeroCheck : 1;
- bool fCanUseFragCoord : 1;
- bool fIncompleteShortIntPrecision : 1;
- bool fAddAndTrueToLoopCondition : 1;
- bool fUnfoldShortCircuitAsTernary : 1;
- bool fEmulateAbsIntFunction : 1;
- bool fRewriteDoWhileLoops : 1;
- bool fRemovePowWithConstantExponent : 1;
- bool fMustWriteToFragColor : 1;
- const char* fVersionDeclString;
- const char* fShaderDerivativeExtensionString;
- const char* fGeometryShaderExtensionString;
- const char* fGSInvocationsExtensionString;
- const char* fFragCoordConventionsExtensionString;
- const char* fSecondaryOutputExtensionString;
- const char* fExternalTextureExtensionString;
- const char* fSecondExternalTextureExtensionString;
- const char* fNoPerspectiveInterpolationExtensionString;
- const char* fSampleVariablesExtensionString;
- const char* fFBFetchColorName;
- const char* fFBFetchExtensionString;
- int fMaxFragmentSamplers;
- AdvBlendEqInteraction fAdvBlendEqInteraction;
- friend class GrCaps; // For initialization.
- friend class GrGLCaps;
- friend class GrMockCaps;
- friend class GrMtlCaps;
- friend class GrVkCaps;
- friend class SkSL::ShaderCapsFactory;
- };
- #endif
|