Robert Phillips | 1afd4cd | 2018-01-08 13:40:32 -0500 | [diff] [blame] | 1 | /* |
| 2 | * Copyright 2018 Google Inc. |
| 3 | * |
| 4 | * Use of this source code is governed by a BSD-style license that can be |
| 5 | * found in the LICENSE file. |
| 6 | */ |
| 7 | |
| 8 | #ifndef GrProxyProvider_DEFINED |
| 9 | #define GrProxyProvider_DEFINED |
| 10 | |
| 11 | #include "GrResourceKey.h" |
| 12 | #include "GrTextureProxy.h" |
| 13 | #include "GrTypes.h" |
| 14 | #include "SkRefCnt.h" |
| 15 | #include "SkTDynamicHash.h" |
| 16 | |
| 17 | class GrCaps; |
| 18 | class GrResourceProvider; |
| 19 | class GrSingleOwner; |
Robert Phillips | 0bd24dc | 2018-01-16 08:06:32 -0500 | [diff] [blame] | 20 | class GrBackendRenderTarget; |
Greg Daniel | a4ead65 | 2018-02-07 10:21:48 -0500 | [diff] [blame] | 21 | class SkBitmap; |
Greg Daniel | 9d86f1d | 2018-01-29 09:33:59 -0500 | [diff] [blame] | 22 | class SkImage; |
Robert Phillips | 1afd4cd | 2018-01-08 13:40:32 -0500 | [diff] [blame] | 23 | |
| 24 | /* |
| 25 | * A factory for creating GrSurfaceProxy-derived objects. |
| 26 | */ |
| 27 | class GrProxyProvider { |
| 28 | public: |
| 29 | GrProxyProvider(GrResourceProvider*, GrResourceCache*, sk_sp<const GrCaps>, GrSingleOwner*); |
| 30 | |
| 31 | ~GrProxyProvider(); |
| 32 | |
| 33 | /* |
| 34 | * Assigns a unique key to a proxy. The proxy will be findable via this key using |
| 35 | * findProxyByUniqueKey(). It is an error if an existing proxy already has a key. |
| 36 | */ |
Robert Phillips | adbe132 | 2018-01-17 13:35:46 -0500 | [diff] [blame] | 37 | bool assignUniqueKeyToProxy(const GrUniqueKey&, GrTextureProxy*); |
Robert Phillips | 1afd4cd | 2018-01-08 13:40:32 -0500 | [diff] [blame] | 38 | |
| 39 | /* |
| 40 | * Sets the unique key of the provided proxy to the unique key of the surface. The surface must |
| 41 | * have a valid unique key. |
| 42 | */ |
| 43 | void adoptUniqueKeyFromSurface(GrTextureProxy* proxy, const GrSurface*); |
| 44 | |
| 45 | /* |
| 46 | * Removes a unique key from a proxy. If the proxy has already been instantiated, it will |
| 47 | * also remove the unique key from the target GrSurface. |
| 48 | */ |
| 49 | void removeUniqueKeyFromProxy(const GrUniqueKey&, GrTextureProxy*); |
| 50 | |
| 51 | /* |
| 52 | * Finds a proxy by unique key. |
| 53 | */ |
| 54 | sk_sp<GrTextureProxy> findProxyByUniqueKey(const GrUniqueKey&, GrSurfaceOrigin); |
| 55 | |
| 56 | /* |
| 57 | * Finds a proxy by unique key or creates a new one that wraps a resource matching the unique |
| 58 | * key. |
| 59 | */ |
| 60 | sk_sp<GrTextureProxy> findOrCreateProxyByUniqueKey(const GrUniqueKey&, GrSurfaceOrigin); |
| 61 | |
| 62 | /* |
Robert Phillips | 0bd24dc | 2018-01-16 08:06:32 -0500 | [diff] [blame] | 63 | * Create a texture proxy that is backed by an instantiated GrSurface. This is almost entirely |
| 64 | * used by Skia's testing code. |
| 65 | * DDL TODO: remove the remaining Skia-internal use of this method and make it truly |
| 66 | * testing-only. |
Robert Phillips | 1afd4cd | 2018-01-08 13:40:32 -0500 | [diff] [blame] | 67 | */ |
Robert Phillips | 0bd24dc | 2018-01-16 08:06:32 -0500 | [diff] [blame] | 68 | sk_sp<GrTextureProxy> createInstantiatedProxy(const GrSurfaceDesc&, SkBackingFit, SkBudgeted, |
| 69 | uint32_t flags = 0); |
| 70 | |
| 71 | /* |
| 72 | * Create an un-mipmapped texture proxy with data. |
| 73 | * DDL TODO: need to refine ownership semantics of 'srcData' if we're in completely |
| 74 | * deferred mode |
| 75 | */ |
| 76 | sk_sp<GrTextureProxy> createTextureProxy(const GrSurfaceDesc&, SkBudgeted, |
| 77 | const void* srcData, size_t rowBytes); |
Robert Phillips | 1afd4cd | 2018-01-08 13:40:32 -0500 | [diff] [blame] | 78 | |
| 79 | /* |
Greg Daniel | 9d86f1d | 2018-01-29 09:33:59 -0500 | [diff] [blame] | 80 | * Create an un-mipmapped texture proxy with data. The SkImage must be a raster backend image. |
| 81 | * Since the SkImage is ref counted, we simply take a ref on it to keep the data alive until we |
| 82 | * actually upload the data to the gpu. |
| 83 | */ |
| 84 | sk_sp<GrTextureProxy> createTextureProxy(sk_sp<SkImage> srcImage, |
| 85 | GrSurfaceFlags flags, |
| 86 | GrSurfaceOrigin origin, |
| 87 | int sampleCnt, |
Greg Daniel | fb3abcd | 2018-02-02 15:48:33 -0500 | [diff] [blame] | 88 | SkBudgeted budgeted, |
| 89 | SkBackingFit fit); |
Greg Daniel | 9d86f1d | 2018-01-29 09:33:59 -0500 | [diff] [blame] | 90 | |
| 91 | /* |
Robert Phillips | 0bd24dc | 2018-01-16 08:06:32 -0500 | [diff] [blame] | 92 | * Create a mipmapped texture proxy without any data. |
| 93 | * |
| 94 | * Like the call above but there are no texels to upload. A texture proxy is returned that |
| 95 | * simply has space allocated for the mips. We will allocated the full amount of mip levels |
| 96 | * based on the width and height in the GrSurfaceDesc. |
| 97 | */ |
| 98 | sk_sp<GrTextureProxy> createMipMapProxy(const GrSurfaceDesc&, SkBudgeted); |
| 99 | |
| 100 | /* |
Greg Daniel | a4ead65 | 2018-02-07 10:21:48 -0500 | [diff] [blame] | 101 | * Creates a new mipmapped texture proxy for the bitmap with mip levels generated by the cpu. |
| 102 | */ |
| 103 | sk_sp<GrTextureProxy> createMipMapProxyFromBitmap(const SkBitmap& bitmap, |
| 104 | SkColorSpace* dstColorSpace); |
| 105 | |
| 106 | /* |
Robert Phillips | 0bd24dc | 2018-01-16 08:06:32 -0500 | [diff] [blame] | 107 | * Create a GrSurfaceProxy without any data. |
| 108 | */ |
| 109 | sk_sp<GrTextureProxy> createProxy(const GrSurfaceDesc&, SkBackingFit, SkBudgeted, |
| 110 | uint32_t flags = 0); |
| 111 | |
Robert Phillips | adbe132 | 2018-01-17 13:35:46 -0500 | [diff] [blame] | 112 | // These match the definitions in SkImage & GrTexture.h, for whence they came |
| 113 | typedef void* ReleaseContext; |
| 114 | typedef void (*ReleaseProc)(ReleaseContext); |
| 115 | |
Robert Phillips | 0bd24dc | 2018-01-16 08:06:32 -0500 | [diff] [blame] | 116 | /* |
| 117 | * Create a texture proxy that wraps a (non-renderable) backend texture. |
| 118 | */ |
Robert Phillips | adbe132 | 2018-01-17 13:35:46 -0500 | [diff] [blame] | 119 | sk_sp<GrTextureProxy> createWrappedTextureProxy(const GrBackendTexture&, GrSurfaceOrigin, |
| 120 | GrWrapOwnership = kBorrow_GrWrapOwnership, |
| 121 | ReleaseProc = nullptr, |
| 122 | ReleaseContext = nullptr); |
Robert Phillips | 0bd24dc | 2018-01-16 08:06:32 -0500 | [diff] [blame] | 123 | |
| 124 | /* |
| 125 | * Create a texture proxy that wraps a backend texture and is both texture-able and renderable |
| 126 | */ |
| 127 | sk_sp<GrTextureProxy> createWrappedTextureProxy(const GrBackendTexture&, |
| 128 | GrSurfaceOrigin, |
| 129 | int sampleCnt); |
| 130 | |
| 131 | /* |
| 132 | * Create a render target proxy that wraps a backend rendertarget |
| 133 | */ |
| 134 | sk_sp<GrSurfaceProxy> createWrappedRenderTargetProxy(const GrBackendRenderTarget&, |
| 135 | GrSurfaceOrigin); |
| 136 | |
| 137 | /* |
| 138 | * Create a render target proxy that wraps a backend texture? |
| 139 | */ |
| 140 | sk_sp<GrSurfaceProxy> createWrappedRenderTargetProxy(const GrBackendTexture& tex, |
| 141 | GrSurfaceOrigin origin, |
| 142 | int sampleCnt); |
Robert Phillips | 1afd4cd | 2018-01-08 13:40:32 -0500 | [diff] [blame] | 143 | |
Robert Phillips | ce5209a | 2018-02-13 11:13:51 -0500 | [diff] [blame^] | 144 | using LazyInstantiateCallback = std::function<sk_sp<GrSurface>(GrResourceProvider*)>; |
Robert Phillips | e8fabb2 | 2018-02-04 14:33:21 -0500 | [diff] [blame] | 145 | enum class Textureable : bool { |
| 146 | kNo = false, |
| 147 | kYes = true |
| 148 | }; |
| 149 | |
Robert Phillips | 777707b | 2018-01-17 11:40:14 -0500 | [diff] [blame] | 150 | enum class Renderable : bool { |
| 151 | kNo = false, |
| 152 | kYes = true |
| 153 | }; |
| 154 | |
| 155 | /** |
| 156 | * Creates a texture proxy that will be instantiated by a user-supplied callback during flush. |
| 157 | * (Stencil is not supported by this method.) The width and height must either both be greater |
| 158 | * than 0 or both less than or equal to zero. A non-positive value is a signal that the width |
| 159 | * and height are currently unknown. |
| 160 | * |
| 161 | * When called, the callback must be able to cleanup any resources that it captured at creation. |
| 162 | * It also must support being passed in a null GrResourceProvider. When this happens, the |
| 163 | * callback should cleanup any resources it captured and return an empty sk_sp<GrTextureProxy>. |
| 164 | */ |
| 165 | sk_sp<GrTextureProxy> createLazyProxy(LazyInstantiateCallback&&, const GrSurfaceDesc&, |
| 166 | GrMipMapped, SkBackingFit, SkBudgeted); |
| 167 | |
Robert Phillips | ce5209a | 2018-02-13 11:13:51 -0500 | [diff] [blame^] | 168 | /** |
| 169 | * Fully lazy proxies have unspecified width and height. Methods that rely on those values |
| 170 | * (e.g., width, height, getBoundsRect) should be avoided. |
| 171 | */ |
Robert Phillips | 777707b | 2018-01-17 11:40:14 -0500 | [diff] [blame] | 172 | sk_sp<GrTextureProxy> createFullyLazyProxy(LazyInstantiateCallback&&, |
Robert Phillips | ce5209a | 2018-02-13 11:13:51 -0500 | [diff] [blame^] | 173 | Renderable, GrSurfaceOrigin, GrPixelConfig); |
Robert Phillips | 777707b | 2018-01-17 11:40:14 -0500 | [diff] [blame] | 174 | |
Robert Phillips | e8fabb2 | 2018-02-04 14:33:21 -0500 | [diff] [blame] | 175 | sk_sp<GrRenderTargetProxy> createLazyRenderTargetProxy(LazyInstantiateCallback&&, |
| 176 | const GrSurfaceDesc&, Textureable, |
| 177 | GrMipMapped, SkBackingFit, SkBudgeted); |
| 178 | |
Robert Phillips | 1afd4cd | 2018-01-08 13:40:32 -0500 | [diff] [blame] | 179 | // 'proxy' is about to be used as a texture src or drawn to. This query can be used to |
| 180 | // determine if it is going to need a texture domain or a full clear. |
| 181 | static bool IsFunctionallyExact(GrSurfaceProxy* proxy); |
| 182 | |
| 183 | /** |
| 184 | * Either the proxy attached to the unique key is being deleted (in which case we |
| 185 | * don't want it cluttering up the hash table) or the client has indicated that |
| 186 | * it will never refer to the unique key again. In either case, remove the key |
| 187 | * from the hash table. |
| 188 | * Note: this does not, by itself, alter unique key attached to the underlying GrTexture. |
| 189 | */ |
| 190 | void processInvalidProxyUniqueKey(const GrUniqueKey&); |
| 191 | |
| 192 | /** |
| 193 | * Same as above, but you must pass in a GrTextureProxy to save having to search for it. The |
| 194 | * GrUniqueKey of the proxy must be valid and it must match the passed in key. This function |
| 195 | * also gives the option to invalidate the GrUniqueKey on the underlying GrTexture. |
| 196 | */ |
| 197 | void processInvalidProxyUniqueKey(const GrUniqueKey&, GrTextureProxy*, bool invalidateSurface); |
| 198 | |
| 199 | const GrCaps* caps() const { return fCaps.get(); } |
| 200 | |
| 201 | void abandon() { |
| 202 | fResourceCache = nullptr; |
| 203 | fResourceProvider = nullptr; |
Robert Phillips | 4d12051 | 2018-01-19 13:22:07 -0500 | [diff] [blame] | 204 | fAbandoned = true; |
Robert Phillips | 1afd4cd | 2018-01-08 13:40:32 -0500 | [diff] [blame] | 205 | } |
| 206 | |
| 207 | bool isAbandoned() const { |
Robert Phillips | 4d12051 | 2018-01-19 13:22:07 -0500 | [diff] [blame] | 208 | #ifdef SK_DEBUG |
| 209 | if (fAbandoned) { |
| 210 | SkASSERT(!fResourceCache && !fResourceProvider); |
| 211 | } |
| 212 | #endif |
| 213 | return fAbandoned; |
Robert Phillips | 1afd4cd | 2018-01-08 13:40:32 -0500 | [diff] [blame] | 214 | } |
| 215 | |
| 216 | int numUniqueKeyProxies_TestOnly() const; |
| 217 | |
| 218 | void removeAllUniqueKeys(); |
| 219 | |
Greg Daniel | 7e1912a | 2018-02-08 09:15:33 -0500 | [diff] [blame] | 220 | /** |
| 221 | * Helper function for callers who are wrapping a bitmap into an SkImage so they know whether or |
| 222 | * not that bitmap should be copied or not. |
| 223 | */ |
| 224 | bool mutableBitmapsNeedCopy() const { return !SkToBool(fResourceProvider); } |
| 225 | |
Robert Phillips | 1afd4cd | 2018-01-08 13:40:32 -0500 | [diff] [blame] | 226 | private: |
Robert Phillips | adbe132 | 2018-01-17 13:35:46 -0500 | [diff] [blame] | 227 | friend class GrAHardwareBufferImageGenerator; // for createWrapped |
| 228 | |
| 229 | sk_sp<GrTextureProxy> createWrapped(sk_sp<GrTexture> tex, GrSurfaceOrigin origin); |
| 230 | |
Robert Phillips | 1afd4cd | 2018-01-08 13:40:32 -0500 | [diff] [blame] | 231 | struct UniquelyKeyedProxyHashTraits { |
| 232 | static const GrUniqueKey& GetKey(const GrTextureProxy& p) { return p.getUniqueKey(); } |
| 233 | |
| 234 | static uint32_t Hash(const GrUniqueKey& key) { return key.hash(); } |
| 235 | }; |
| 236 | typedef SkTDynamicHash<GrTextureProxy, GrUniqueKey, UniquelyKeyedProxyHashTraits> UniquelyKeyedProxyHash; |
| 237 | |
| 238 | // This holds the texture proxies that have unique keys. The resourceCache does not get a ref |
| 239 | // on these proxies but they must send a message to the resourceCache when they are deleted. |
| 240 | UniquelyKeyedProxyHash fUniquelyKeyedProxies; |
| 241 | |
| 242 | GrResourceProvider* fResourceProvider; |
| 243 | GrResourceCache* fResourceCache; |
Robert Phillips | 4d12051 | 2018-01-19 13:22:07 -0500 | [diff] [blame] | 244 | bool fAbandoned; |
Robert Phillips | 1afd4cd | 2018-01-08 13:40:32 -0500 | [diff] [blame] | 245 | sk_sp<const GrCaps> fCaps; |
| 246 | |
| 247 | // In debug builds we guard against improper thread handling |
| 248 | SkDEBUGCODE(mutable GrSingleOwner* fSingleOwner;) |
| 249 | }; |
| 250 | |
| 251 | #endif |