skia: Add support for CHROMIUM_image backed textures.

include/gpu/GrTypes.h

 /*
  * Copyright 2010 Google Inc.
  *
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
 #ifndef GrTypes_DEFINED
 #define GrTypes_DEFINED
 
@@ skipping 391 matching lines @@
     kZeroCopy_GrSurfaceFlag         = 0x2,
     /**
      * Indicates that all allocations (color buffer, FBO completeness, etc)
      * should be verified.
      */
     kCheckAllocation_GrSurfaceFlag  = 0x4,
 };
 
 GR_MAKE_BITFIELD_OPS(GrSurfaceFlags)
 
+// opaque type for 3D API object handles
+typedef intptr_t GrBackendObject;
+
+/**
+ * An abstract base class which consumers of Skia can subclass and pass to Skia.
+ * Skia will use this object in place of its backend API texture creation
+ * function.
+ */
+class GrTextureStorageAllocator {
+public:
+    /*
+     * Whether a texture can be created with the given pixel config.
+     */
+    virtual bool supportsPixelConfig(GrPixelConfig config) = 0;
+    /*
+     * Generates and binds a texture to |textureStorageTarget()|. Allocates
+     * storage for the texture.
+     *
+     * The MIN and MAX filters for the created texture must be GL_LINEAR. The
+     * WRAP_S and WRAP_T must be GL_CLAMP_TO_EDGE.
+     *
+     * The internal format must be GL_RGBA.

[bsalomon, 2016/01/29 16:57:38]

I'm not crazy about this restriction. I get that that's all that will be
supported for the initial subclass in Chromium, but I'd like to use this for
some testing on the Skia side and would like to allow support for all formats. I
think that would mean that the Allocator can fail and allow the default
implementation to take over.

Also, I think for certain potential use cases the allocator should at least have
the option of performing the upload, in case it can do something more efficient
than glTexSubImage2D.

[erikchen, 2016/01/29 20:32:25]

I added two more parameters: GrPixelConfig and a const void* srcData.

+     */
+    virtual bool allocateTextureStorage(GrBackendObject texture, unsigned width,
+                                        unsigned height) = 0;
+    /*
+     * Deallocate the storage for the given texture.
+     *
+     * Skia does not always destroy its outstanding textures. See
+     * GrContext::abandonContext() for more details. The consumer of Skia is
+     * responsible for making sure that all textures are destroyed, even if this
+     * callback is not invoked.
+     */
+    virtual void deallocateTextureStorage(GrBackendObject texture) = 0;
+
+protected:
+    virtual ~GrTextureStorageAllocator() {}
+};
+
 /**
  * Some textures will be stored such that the upper and left edges of the content meet at the
  * the origin (in texture coord space) and for other textures the lower and left edges meet at
  * the origin. kDefault_GrSurfaceOrigin sets textures to TopLeft, and render targets
  * to BottomLeft.
  */
 
 enum GrSurfaceOrigin {
     kDefault_GrSurfaceOrigin,         // DEPRECATED; to be removed
     kTopLeft_GrSurfaceOrigin,
     kBottomLeft_GrSurfaceOrigin,
 };
 
 /**
  * Describes a surface to be created.
  */
 struct GrSurfaceDesc {
     GrSurfaceDesc()
     : fFlags(kNone_GrSurfaceFlags)
     , fOrigin(kDefault_GrSurfaceOrigin)
     , fWidth(0)
     , fHeight(0)
     , fConfig(kUnknown_GrPixelConfig)
-    , fSampleCnt(0) {
+    , fSampleCnt(0)
+    , fTextureStorageAllocator(nullptr) {
     }
 
     GrSurfaceFlags         fFlags;  //!< bitfield of TextureFlags
     GrSurfaceOrigin        fOrigin; //!< origin of the texture
     int                    fWidth;  //!< Width of the texture
     int                    fHeight; //!< Height of the texture
 
     /**
      * Format of source data of the texture. Not guaranteed to be the same as
      * internal format used by 3D API.
      */
     GrPixelConfig          fConfig;
 
     /**
      * The number of samples per pixel or 0 to disable full scene AA. This only
      * applies if the kRenderTarget_GrSurfaceFlag is set. The actual number
      * of samples may not exactly match the request. The request will be rounded
      * up to the next supported sample count, or down if it is larger than the
      * max supported count.
      */
     int                    fSampleCnt;
+
+    /**
+     * A custom platform-specific allocator to use in place of TexImage2D. All
+     * surfaces derived from the original surface will have the same value for
+     * fTextureStorageAllocator.
+     */
+    GrTextureStorageAllocator* fTextureStorageAllocator;
 };
 
 // Legacy alias
 typedef GrSurfaceDesc GrTextureDesc;
 
 /**
  * Clips are composed from these objects.
  */
 enum GrClipType {
     kRect_ClipType,
     kPath_ClipType
 };
 
 ///////////////////////////////////////////////////////////////////////////////
 
-// opaque type for 3D API object handles
-typedef intptr_t GrBackendObject;
-
 
 /** Ownership rules for external GPU resources imported into Skia. */
 enum GrWrapOwnership {
     /** Skia will assume the client will keep the resource alive and Skia will not free it. */
     kBorrow_GrWrapOwnership,
 
     /** Skia will assume ownership of the resource and free it. */
     kAdopt_GrWrapOwnership,
 };
 
@@ skipping 133 matching lines @@
             return 4 * width * height;
     }
 }
 
 /**
  * This value translates to reseting all the context state for any backend.
  */
 static const uint32_t kAll_GrBackendState = 0xffffffff;
 
 #endif