Add support for creating texture backed images where Skia will delete the texture.

include/gpu/GrGpuResource.h

 /*
  * Copyright 2014 Google Inc.
  *
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
 #ifndef GrGpuResource_DEFINED
 #define GrGpuResource_DEFINED
 
@@ skipping 124 matching lines @@
 
     template <typename, GrIOType> friend class GrPendingIOResource;
 };
 
 /**
  * Base class for objects that can be kept in the GrResourceCache.
  */
 class SK_API GrGpuResource : public GrIORef<GrGpuResource> {
 public:
     SK_DECLARE_INST_COUNT(GrGpuResource)
 

[robertphillips, 2015/06/18 14:18:49]

Would a set of orthogonal flags make any of this easier:

kCached|kUncached
kSkiaFrees|kSkiaDoesntFree
kInternal|kExternal

?

[bsalomon, 2015/06/18 15:19:37]

Maybe, but I sort of like the explicit flags for interactive debugging. I can
just look at the flag and know where it came from instead of thinking about a
bitfield and what paths set which bits. If it got yet more complicated I think
we'd have to move to flags. Also, I think those flags aren't really orthogonal
(kCached | kSkiaDoesnFree) is illegal as is (kInternal | kSkiaDoesnFree) (at
least for now).

     enum LifeCycle {
         /**
          * The resource is cached and owned by Skia. Resources with this status may be kept alive
          * by the cache as either scratch or unique resources even when there are no refs to them.
          * The cache may release them whenever there are no refs.
          */
         kCached_LifeCycle,
+
         /**
          * The resource is uncached. As soon as there are no more refs to it, it is released. Under
          * the hood the cache may opaquely recycle it as a cached resource.
          */
         kUncached_LifeCycle,
+
         /**
          * Similar to uncached, but Skia does not manage the lifetime of the underlying backend
          * 3D API object(s). The client is responsible for freeing those. Used to inject client-
          * created GPU resources into Skia (e.g. to render to a client-created texture).
          */
-        kWrapped_LifeCycle,
+        kBorrowed_LifeCycle,
+
+        /**

[robertphillips, 2015/06/18 14:18:49]

add a space after '.' ?

[bsalomon, 2015/06/18 15:19:37]

Done.

+         * An external resource with ownership transfered into Skia.Skia will free the resource.
+         */
+        kAdopted_LifeCycle,
     };
 
     /**
      * Tests whether a object has been abandoned or released. All objects will
      * be in this state after their creating GrContext is destroyed or has
      * contextLost called. It's up to the client to test wasDestroyed() before
      * attempting to use an object if it holds refs on objects across
      * ~GrContext, freeResources with the force flag, or contextLost.
      *
      * @return true if the object has been released or abandoned,
@@ skipping 84 matching lines @@
 
     GrGpu* getGpu() const { return fGpu; }
 
     /** Overridden to free GPU resources in the backend API. */
     virtual void onRelease() { }
     /** Overridden to abandon any internal handles, ptrs, etc to backend API resources.
         This may be called when the underlying 3D context is no longer valid and so no
         backend API calls should be made. */
     virtual void onAbandon() { }
 
-    bool isWrapped() const { return kWrapped_LifeCycle == fLifeCycle; }
+    bool shouldFreeResources() const { return fLifeCycle != kBorrowed_LifeCycle; }
+
+    bool isExternal() const {
+        return GrGpuResource::kAdopted_LifeCycle == fLifeCycle ||
+               GrGpuResource::kBorrowed_LifeCycle == fLifeCycle;
+    }
 
     /**
      * This entry point should be called whenever gpuMemorySize() should report a different size.
      * The cache will call gpuMemorySize() to update the current size of the resource.
      */
     void didChangeGpuMemorySize() const;
 
     /**
      * Optionally called by the GrGpuResource subclass if the resource can be used as scratch.
      * By default resources are not usable as scratch. This should only be called once.
@@ skipping 42 matching lines @@
     LifeCycle                   fLifeCycle;
     const uint32_t              fUniqueID;
 
     SkAutoTUnref<const SkData>  fData;
 
     typedef GrIORef<GrGpuResource> INHERITED;
     friend class GrIORef<GrGpuResource>; // to access notifyAllCntsAreZero and notifyRefCntIsZero.
 };
 
 #endif