| /* | 
 |  * 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 GrGLCaps_DEFINED | 
 | #define GrGLCaps_DEFINED | 
 |  | 
 | #include "GrDrawTargetCaps.h" | 
 | #include "GrGLStencilBuffer.h" | 
 | #include "SkChecksum.h" | 
 | #include "SkTHashCache.h" | 
 | #include "SkTArray.h" | 
 |  | 
 | class GrGLContextInfo; | 
 |  | 
 | /** | 
 |  * Stores some capabilities of a GL context. Most are determined by the GL | 
 |  * version and the extensions string. It also tracks formats that have passed | 
 |  * the FBO completeness test. | 
 |  */ | 
 | class GrGLCaps : public GrDrawTargetCaps { | 
 | public: | 
 |     SK_DECLARE_INST_COUNT(GrGLCaps) | 
 |  | 
 |     typedef GrGLStencilBuffer::Format StencilFormat; | 
 |  | 
 |     /** | 
 |      * The type of MSAA for FBOs supported. Different extensions have different | 
 |      * semantics of how / when a resolve is performed. | 
 |      */ | 
 |     enum MSFBOType { | 
 |         /** | 
 |          * no support for MSAA FBOs | 
 |          */ | 
 |         kNone_MSFBOType = 0, | 
 |         /** | 
 |          * GL3.0-style MSAA FBO (GL_ARB_framebuffer_object). | 
 |          */ | 
 |         kDesktop_ARB_MSFBOType, | 
 |         /** | 
 |          * earlier GL_EXT_framebuffer* extensions | 
 |          */ | 
 |         kDesktop_EXT_MSFBOType, | 
 |         /** | 
 |          * Similar to kDesktop_ARB but with additional restrictions on glBlitFramebuffer. | 
 |          */ | 
 |         kES_3_0_MSFBOType, | 
 |         /** | 
 |          * GL_APPLE_framebuffer_multisample ES extension | 
 |          */ | 
 |         kES_Apple_MSFBOType, | 
 |         /** | 
 |          * GL_IMG_multisampled_render_to_texture. This variation does not have MSAA renderbuffers. | 
 |          * Instead the texture is multisampled when bound to the FBO and then resolved automatically | 
 |          * when read. It also defines an alternate value for GL_MAX_SAMPLES (which we call | 
 |          * GR_GL_MAX_SAMPLES_IMG). | 
 |          */ | 
 |         kES_IMG_MsToTexture_MSFBOType, | 
 |         /** | 
 |          * GL_EXT_multisampled_render_to_texture. Same as the IMG one above but uses the standard | 
 |          * GL_MAX_SAMPLES value. | 
 |          */ | 
 |         kES_EXT_MsToTexture_MSFBOType, | 
 |  | 
 |         kLast_MSFBOType = kES_EXT_MsToTexture_MSFBOType | 
 |     }; | 
 |  | 
 |     enum InvalidateFBType { | 
 |         kNone_InvalidateFBType, | 
 |         kDiscard_InvalidateFBType,       //<! glDiscardFramebuffer() | 
 |         kInvalidate_InvalidateFBType,     //<! glInvalidateFramebuffer() | 
 |  | 
 |         kLast_InvalidateFBType = kInvalidate_InvalidateFBType | 
 |     }; | 
 |  | 
 |     enum MapBufferType { | 
 |         kNone_MapBufferType, | 
 |         kMapBuffer_MapBufferType,         // glMapBuffer() | 
 |         kMapBufferRange_MapBufferType,    // glMapBufferRange() | 
 |         kChromium_MapBufferType,          // GL_CHROMIUM_map_sub | 
 |  | 
 |         kLast_MapBufferType = kChromium_MapBufferType, | 
 |     }; | 
 |  | 
 |     /** | 
 |      * Creates a GrGLCaps that advertises no support for any extensions, | 
 |      * formats, etc. Call init to initialize from a GrGLContextInfo. | 
 |      */ | 
 |     GrGLCaps(); | 
 |  | 
 |     GrGLCaps(const GrGLCaps& caps); | 
 |  | 
 |     GrGLCaps& operator = (const GrGLCaps& caps); | 
 |  | 
 |     /** | 
 |      * Resets the caps such that nothing is supported. | 
 |      */ | 
 |     virtual void reset() SK_OVERRIDE; | 
 |  | 
 |     /** | 
 |      * Initializes the GrGLCaps to the set of features supported in the current | 
 |      * OpenGL context accessible via ctxInfo. | 
 |      */ | 
 |     bool init(const GrGLContextInfo& ctxInfo, const GrGLInterface* glInterface); | 
 |  | 
 |     /** | 
 |      * Call to note that a color config has been verified as a valid color | 
 |      * attachment. This may save future calls to glCheckFramebufferStatus | 
 |      * using isConfigVerifiedColorAttachment(). | 
 |      */ | 
 |     void markConfigAsValidColorAttachment(GrPixelConfig config) { | 
 |         fVerifiedColorConfigs.markVerified(config); | 
 |     } | 
 |  | 
 |     /** | 
 |      * Call to check whether a config has been verified as a valid color | 
 |      * attachment. | 
 |      */ | 
 |     bool isConfigVerifiedColorAttachment(GrPixelConfig config) const { | 
 |         return fVerifiedColorConfigs.isVerified(config); | 
 |     } | 
 |  | 
 |     /** | 
 |      * Call to note that a color config / stencil format pair passed | 
 |      * FBO status check. We may skip calling glCheckFramebufferStatus for | 
 |      * this combination in the future using | 
 |      * isColorConfigAndStencilFormatVerified(). | 
 |      */ | 
 |     void markColorConfigAndStencilFormatAsVerified( | 
 |                     GrPixelConfig config, | 
 |                     const GrGLStencilBuffer::Format& format); | 
 |  | 
 |     /** | 
 |      * Call to check whether color config / stencil format pair has already | 
 |      * passed FBO status check. | 
 |      */ | 
 |     bool isColorConfigAndStencilFormatVerified( | 
 |                     GrPixelConfig config, | 
 |                     const GrGLStencilBuffer::Format& format) const; | 
 |  | 
 |     /** | 
 |      * Reports the type of MSAA FBO support. | 
 |      */ | 
 |     MSFBOType msFBOType() const { return fMSFBOType; } | 
 |  | 
 |     /** | 
 |      * Does the supported MSAA FBO extension have MSAA renderbuffers? | 
 |      */ | 
 |     bool usesMSAARenderBuffers() const { | 
 |         return kNone_MSFBOType != fMSFBOType && | 
 |                kES_IMG_MsToTexture_MSFBOType != fMSFBOType && | 
 |                kES_EXT_MsToTexture_MSFBOType != fMSFBOType; | 
 |     } | 
 |  | 
 |     /** | 
 |      * Is the MSAA FBO extension one where the texture is multisampled when bound to an FBO and | 
 |      * then implicitly resolved when read. | 
 |      */ | 
 |     bool usesImplicitMSAAResolve() const { | 
 |         return kES_IMG_MsToTexture_MSFBOType == fMSFBOType || | 
 |                kES_EXT_MsToTexture_MSFBOType == fMSFBOType; | 
 |     } | 
 |  | 
 |     /** | 
 |      * 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; } | 
 |  | 
 |     const char* fbFetchColorName() const { return fFBFetchColorName; } | 
 |  | 
 |     const char* fbFetchExtensionString() const { return fFBFetchExtensionString; } | 
 |  | 
 |     InvalidateFBType invalidateFBType() const { return fInvalidateFBType; } | 
 |  | 
 |     /// What type of buffer mapping is supported? | 
 |     MapBufferType mapBufferType() const { return fMapBufferType; } | 
 |  | 
 |     /** | 
 |      * Gets an array of legal stencil formats. These formats are not guaranteed | 
 |      * to be supported by the driver but are legal GLenum names given the GL | 
 |      * version and extensions supported. | 
 |      */ | 
 |     const SkTArray<StencilFormat, true>& stencilFormats() const { | 
 |         return fStencilFormats; | 
 |     } | 
 |  | 
 |     /// The maximum number of fragment uniform vectors (GLES has min. 16). | 
 |     int maxFragmentUniformVectors() const { return fMaxFragmentUniformVectors; } | 
 |  | 
 |     /// maximum number of attribute values per vertex | 
 |     int maxVertexAttributes() const { return fMaxVertexAttributes; } | 
 |  | 
 |     /// maximum number of texture units accessible in the fragment shader. | 
 |     int maxFragmentTextureUnits() const { return fMaxFragmentTextureUnits; } | 
 |  | 
 |     /// maximum number of fixed-function texture coords, or zero if no fixed-function. | 
 |     int maxFixedFunctionTextureCoords() const { return fMaxFixedFunctionTextureCoords; } | 
 |  | 
 |     /// ES requires an extension to support RGBA8 in RenderBufferStorage | 
 |     bool rgba8RenderbufferSupport() const { return fRGBA8RenderbufferSupport; } | 
 |  | 
 |     /** | 
 |      * Depending on the ES extensions present the BGRA external format may | 
 |      * correspond either a BGRA or RGBA internalFormat. On desktop GL it is | 
 |      * RGBA. | 
 |      */ | 
 |     bool bgraIsInternalFormat() const { return fBGRAIsInternalFormat; } | 
 |  | 
 |     /// GL_ARB_texture_swizzle support | 
 |     bool textureSwizzleSupport() const { return fTextureSwizzleSupport; } | 
 |  | 
 |     /// Is there support for GL_UNPACK_ROW_LENGTH | 
 |     bool unpackRowLengthSupport() const { return fUnpackRowLengthSupport; } | 
 |  | 
 |     /// Is there support for GL_UNPACK_FLIP_Y | 
 |     bool unpackFlipYSupport() const { return fUnpackFlipYSupport; } | 
 |  | 
 |     /// Is there support for GL_PACK_ROW_LENGTH | 
 |     bool packRowLengthSupport() const { return fPackRowLengthSupport; } | 
 |  | 
 |     /// Is there support for GL_PACK_REVERSE_ROW_ORDER | 
 |     bool packFlipYSupport() const { return fPackFlipYSupport; } | 
 |  | 
 |     /// Is there support for texture parameter GL_TEXTURE_USAGE | 
 |     bool textureUsageSupport() const { return fTextureUsageSupport; } | 
 |  | 
 |     /// Is there support for glTexStorage | 
 |     bool texStorageSupport() const { return fTexStorageSupport; } | 
 |  | 
 |     /// Is there support for GL_RED and GL_R8 | 
 |     bool textureRedSupport() const { return fTextureRedSupport; } | 
 |  | 
 |     /// Is GL_ARB_IMAGING supported | 
 |     bool imagingSupport() const { return fImagingSupport; } | 
 |  | 
 |     /// Is GL_ARB_fragment_coord_conventions supported? | 
 |     bool fragCoordConventionsSupport() const { return fFragCoordsConventionSupport; } | 
 |  | 
 |     /// Is there support for Vertex Array Objects? | 
 |     bool vertexArrayObjectSupport() const { return fVertexArrayObjectSupport; } | 
 |  | 
 |     /// Use indices or vertices in CPU arrays rather than VBOs for dynamic content. | 
 |     bool useNonVBOVertexAndIndexDynamicData() const { | 
 |         return fUseNonVBOVertexAndIndexDynamicData; | 
 |     } | 
 |  | 
 |     /// Does ReadPixels support the provided format/type combo? | 
 |     bool readPixelsSupported(const GrGLInterface* intf, | 
 |                              GrGLenum format, | 
 |                              GrGLenum type, | 
 |                              GrGLenum currFboFormat) const; | 
 |  | 
 |     bool isCoreProfile() const { return fIsCoreProfile; } | 
 |  | 
 |  | 
 |     bool fullClearIsFree() const { return fFullClearIsFree; } | 
 |  | 
 |     bool dropsTileOnZeroDivide() const { return fDropsTileOnZeroDivide; } | 
 |  | 
 |     /** | 
 |      * Returns a string containing the caps info. | 
 |      */ | 
 |     virtual SkString dump() const SK_OVERRIDE; | 
 |  | 
 |     /** | 
 |      * LATC can appear under one of three possible names. In order to know | 
 |      * which GL internal format to use, we need to keep track of which name | 
 |      * we found LATC under. The default is LATC. | 
 |      */ | 
 |     enum LATCAlias { | 
 |         kLATC_LATCAlias, | 
 |         kRGTC_LATCAlias, | 
 |         k3DC_LATCAlias | 
 |     }; | 
 |  | 
 |     LATCAlias latcAlias() const { return fLATCAlias; } | 
 |  | 
 | private: | 
 |     /** | 
 |      * Maintains a bit per GrPixelConfig. It is used to avoid redundantly | 
 |      * performing glCheckFrameBufferStatus for the same config. | 
 |      */ | 
 |     struct VerifiedColorConfigs { | 
 |         VerifiedColorConfigs() { | 
 |             this->reset(); | 
 |         } | 
 |  | 
 |         void reset() { | 
 |             for (int i = 0; i < kNumUints; ++i) { | 
 |                 fVerifiedColorConfigs[i] = 0; | 
 |             } | 
 |         } | 
 |  | 
 |         static const int kNumUints = (kGrPixelConfigCnt  + 31) / 32; | 
 |         uint32_t fVerifiedColorConfigs[kNumUints]; | 
 |  | 
 |         void markVerified(GrPixelConfig config) { | 
 | #if !GR_GL_CHECK_FBO_STATUS_ONCE_PER_FORMAT | 
 |                 return; | 
 | #endif | 
 |             int u32Idx = config / 32; | 
 |             int bitIdx = config % 32; | 
 |             fVerifiedColorConfigs[u32Idx] |= 1 << bitIdx; | 
 |         } | 
 |  | 
 |         bool isVerified(GrPixelConfig config) const { | 
 | #if !GR_GL_CHECK_FBO_STATUS_ONCE_PER_FORMAT | 
 |             return false; | 
 | #endif | 
 |             int u32Idx = config / 32; | 
 |             int bitIdx = config % 32; | 
 |             return SkToBool(fVerifiedColorConfigs[u32Idx] & (1 << bitIdx)); | 
 |         } | 
 |     }; | 
 |  | 
 |     void initFSAASupport(const GrGLContextInfo&, const GrGLInterface*); | 
 |     void initStencilFormats(const GrGLContextInfo&); | 
 |     // This must be called after initFSAASupport(). | 
 |     void initConfigRenderableTable(const GrGLContextInfo&); | 
 |     void initConfigTexturableTable(const GrGLContextInfo&, const GrGLInterface*); | 
 |  | 
 |     // Must be called after fGeometryShaderSupport is initialized. | 
 |     void initShaderPrecisionTable(const GrGLContextInfo&, const GrGLInterface*); | 
 |  | 
 |     bool doReadPixelsSupported(const GrGLInterface* intf, GrGLenum format, GrGLenum type) const; | 
 |  | 
 |     // tracks configs that have been verified to pass the FBO completeness when | 
 |     // used as a color attachment | 
 |     VerifiedColorConfigs fVerifiedColorConfigs; | 
 |  | 
 |     SkTArray<StencilFormat, true> fStencilFormats; | 
 |     // tracks configs that have been verified to pass the FBO completeness when | 
 |     // used as a color attachment when a particular stencil format is used | 
 |     // as a stencil attachment. | 
 |     SkTArray<VerifiedColorConfigs, true> fStencilVerifiedColorConfigs; | 
 |  | 
 |     int fMaxFragmentUniformVectors; | 
 |     int fMaxVertexAttributes; | 
 |     int fMaxFragmentTextureUnits; | 
 |     int fMaxFixedFunctionTextureCoords; | 
 |  | 
 |     MSFBOType           fMSFBOType; | 
 |     InvalidateFBType    fInvalidateFBType; | 
 |     MapBufferType       fMapBufferType; | 
 |     LATCAlias           fLATCAlias; | 
 |  | 
 |     bool fRGBA8RenderbufferSupport : 1; | 
 |     bool fBGRAIsInternalFormat : 1; | 
 |     bool fTextureSwizzleSupport : 1; | 
 |     bool fUnpackRowLengthSupport : 1; | 
 |     bool fUnpackFlipYSupport : 1; | 
 |     bool fPackRowLengthSupport : 1; | 
 |     bool fPackFlipYSupport : 1; | 
 |     bool fTextureUsageSupport : 1; | 
 |     bool fTexStorageSupport : 1; | 
 |     bool fTextureRedSupport : 1; | 
 |     bool fImagingSupport  : 1; | 
 |     bool fTwoFormatLimit : 1; | 
 |     bool fFragCoordsConventionSupport : 1; | 
 |     bool fVertexArrayObjectSupport : 1; | 
 |     bool fUseNonVBOVertexAndIndexDynamicData : 1; | 
 |     bool fIsCoreProfile : 1; | 
 |     bool fFullClearIsFree : 1; | 
 |     bool fDropsTileOnZeroDivide : 1; | 
 |     // TODO(joshualitt) encapsulate the FB Fetch logic in a feature object | 
 |     bool fFBFetchSupport : 1; | 
 |  | 
 |     const char* fFBFetchColorName; | 
 |     const char* fFBFetchExtensionString; | 
 |  | 
 |     class ReadPixelsSupportedFormats { | 
 |     public: | 
 |         struct Key { | 
 |             GrGLenum fFormat; | 
 |             GrGLenum fType; | 
 |             GrGLenum fFboFormat; | 
 |  | 
 |             bool operator==(const Key& rhs) const { | 
 |                 return fFormat == rhs.fFormat | 
 |                         && fType == rhs.fType | 
 |                         && fFboFormat == rhs.fFboFormat; | 
 |             } | 
 |  | 
 |             uint32_t getHash() const { | 
 |                 return SkChecksum::Murmur3(reinterpret_cast<const uint32_t*>(this), sizeof(*this)); | 
 |             } | 
 |         }; | 
 |  | 
 |         ReadPixelsSupportedFormats(Key key, bool value) : fKey(key), fValue(value) { | 
 |         } | 
 |  | 
 |         static const Key& GetKey(const ReadPixelsSupportedFormats& element) { | 
 |             return element.fKey; | 
 |         } | 
 |  | 
 |         static uint32_t Hash(const Key& key) { | 
 |             return key.getHash(); | 
 |         } | 
 |  | 
 |         bool value() const { | 
 |             return fValue; | 
 |         } | 
 |     private: | 
 |         Key fKey; | 
 |         bool fValue; | 
 |     }; | 
 |  | 
 |     mutable SkTHashCache<ReadPixelsSupportedFormats, | 
 |                          ReadPixelsSupportedFormats::Key> fReadPixelsSupportedCache; | 
 |  | 
 |     typedef GrDrawTargetCaps INHERITED; | 
 | }; | 
 |  | 
 | #endif |