Brian Osman | 13dddce | 2017-05-09 13:19:50 -0400 | [diff] [blame] | 1 | /* |
| 2 | * Copyright 2017 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 | #ifndef GrBackendTextureImageGenerator_DEFINED |
| 8 | #define GrBackendTextureImageGenerator_DEFINED |
| 9 | |
Mike Klein | c0bd9f9 | 2019-04-23 12:05:21 -0500 | [diff] [blame] | 10 | #include "include/core/SkImageGenerator.h" |
| 11 | #include "include/gpu/GrBackendSurface.h" |
| 12 | #include "include/private/GrResourceKey.h" |
| 13 | #include "include/private/SkMutex.h" |
Brian Osman | 13dddce | 2017-05-09 13:19:50 -0400 | [diff] [blame] | 14 | |
| 15 | class GrSemaphore; |
| 16 | |
Greg Daniel | 966db9e | 2018-01-12 13:15:06 -0500 | [diff] [blame] | 17 | /* |
| 18 | * This ImageGenerator is used to wrap a texture in one GrContext and can then be used as a source |
Greg Daniel | abba998 | 2018-02-01 10:07:57 -0500 | [diff] [blame] | 19 | * in another GrContext. It holds onto a semaphore which the producing GrContext will signal and the |
Greg Daniel | 966db9e | 2018-01-12 13:15:06 -0500 | [diff] [blame] | 20 | * consuming GrContext will wait on before using the texture. Only one GrContext can ever be used |
| 21 | * as a consumer (this is mostly because Vulkan can't allow multiple things to wait on the same |
| 22 | * semaphore). |
Greg Daniel | abba998 | 2018-02-01 10:07:57 -0500 | [diff] [blame] | 23 | * |
| 24 | * In practice, this capability is used by clients to create backend-specific texture resources in |
| 25 | * one thread (with, say, GrContext-A) and then ship them over to another GrContext (say, |
| 26 | * GrContext-B) which will then use the texture as a source for draws. GrContext-A uses the |
| 27 | * semaphore to notify GrContext-B when the shared texture is ready to use. |
Greg Daniel | 966db9e | 2018-01-12 13:15:06 -0500 | [diff] [blame] | 28 | */ |
Brian Osman | 13dddce | 2017-05-09 13:19:50 -0400 | [diff] [blame] | 29 | class GrBackendTextureImageGenerator : public SkImageGenerator { |
| 30 | public: |
Robert Phillips | b0e93a2 | 2017-08-29 08:26:54 -0400 | [diff] [blame] | 31 | static std::unique_ptr<SkImageGenerator> Make(sk_sp<GrTexture>, GrSurfaceOrigin, |
Brian Osman | 052ef69 | 2018-03-27 09:56:31 -0400 | [diff] [blame] | 32 | sk_sp<GrSemaphore>, SkColorType, |
Brian Osman | 13dddce | 2017-05-09 13:19:50 -0400 | [diff] [blame] | 33 | SkAlphaType, sk_sp<SkColorSpace>); |
| 34 | |
Stan Iliev | 7e910df | 2017-06-02 10:29:21 -0400 | [diff] [blame] | 35 | ~GrBackendTextureImageGenerator() override; |
Brian Osman | 13dddce | 2017-05-09 13:19:50 -0400 | [diff] [blame] | 36 | |
| 37 | protected: |
Brian Osman | 0745422 | 2017-05-12 09:46:56 -0400 | [diff] [blame] | 38 | // NOTE: We would like to validate that the owning context hasn't been abandoned, but we can't |
| 39 | // do that safely (we might be on another thread). So assume everything is fine. |
| 40 | bool onIsValid(GrContext*) const override { return true; } |
Brian Osman | 13dddce | 2017-05-09 13:19:50 -0400 | [diff] [blame] | 41 | |
Stan Iliev | ba81af2 | 2017-06-08 15:16:53 -0400 | [diff] [blame] | 42 | TexGenType onCanGenerateTexture() const override { return TexGenType::kCheap; } |
Robert Phillips | 9338c60 | 2019-02-19 12:52:29 -0500 | [diff] [blame] | 43 | sk_sp<GrTextureProxy> onGenerateTexture(GrRecordingContext*, const SkImageInfo&, |
| 44 | const SkIPoint&, bool willNeedMipMaps) override; |
Brian Osman | 13dddce | 2017-05-09 13:19:50 -0400 | [diff] [blame] | 45 | |
| 46 | private: |
Robert Phillips | b0e93a2 | 2017-08-29 08:26:54 -0400 | [diff] [blame] | 47 | GrBackendTextureImageGenerator(const SkImageInfo& info, GrTexture*, GrSurfaceOrigin, |
Brian Osman | 13dddce | 2017-05-09 13:19:50 -0400 | [diff] [blame] | 48 | uint32_t owningContextID, sk_sp<GrSemaphore>, |
| 49 | const GrBackendTexture&); |
| 50 | |
| 51 | static void ReleaseRefHelper_TextureReleaseProc(void* ctx); |
| 52 | |
Mike Klein | 408ef21 | 2018-10-30 15:23:00 +0000 | [diff] [blame] | 53 | class RefHelper : public SkNVRefCnt<RefHelper> { |
Brian Osman | 13dddce | 2017-05-09 13:19:50 -0400 | [diff] [blame] | 54 | public: |
Brian Salomon | b916b7b | 2019-04-01 13:34:34 -0400 | [diff] [blame] | 55 | RefHelper(GrTexture*, uint32_t owningContextID); |
Brian Osman | 13dddce | 2017-05-09 13:19:50 -0400 | [diff] [blame] | 56 | |
| 57 | ~RefHelper(); |
| 58 | |
Greg Daniel | abba998 | 2018-02-01 10:07:57 -0500 | [diff] [blame] | 59 | GrTexture* fOriginalTexture; |
| 60 | uint32_t fOwningContextID; |
Brian Osman | 13dddce | 2017-05-09 13:19:50 -0400 | [diff] [blame] | 61 | |
Brian Salomon | b916b7b | 2019-04-01 13:34:34 -0400 | [diff] [blame] | 62 | // We use this key so that we don't rewrap the GrBackendTexture in a GrTexture for each |
| 63 | // proxy created from this generator for a particular borrowing context. |
| 64 | GrUniqueKey fBorrowedTextureKey; |
| 65 | // There is no ref associated with this pointer. We rely on our atomic bookkeeping with the |
| 66 | // context ID to know when this pointer is valid and safe to use. This is used to make sure |
| 67 | // all uses of the wrapped texture are finished on the borrowing context before we open |
| 68 | // this back up to other contexts. In general a ref to this release proc is owned by all |
| 69 | // proxies and gpu uses of the backend texture. |
Brian Salomon | b2c5dae | 2019-03-04 10:25:17 -0500 | [diff] [blame] | 70 | GrRefCntedCallback* fBorrowingContextReleaseProc; |
Greg Daniel | abba998 | 2018-02-01 10:07:57 -0500 | [diff] [blame] | 71 | uint32_t fBorrowingContextID; |
Brian Osman | 13dddce | 2017-05-09 13:19:50 -0400 | [diff] [blame] | 72 | }; |
| 73 | |
Greg Daniel | abba998 | 2018-02-01 10:07:57 -0500 | [diff] [blame] | 74 | RefHelper* fRefHelper; |
| 75 | // This Mutex is used to guard the borrowing of the texture to one GrContext at a time as well |
| 76 | // as the creation of the fBorrowingContextReleaseProc. The latter happening if two threads with |
| 77 | // the same consuming GrContext try to generate a texture at the same time. |
| 78 | SkMutex fBorrowingMutex; |
Brian Osman | 13dddce | 2017-05-09 13:19:50 -0400 | [diff] [blame] | 79 | |
Greg Daniel | abba998 | 2018-02-01 10:07:57 -0500 | [diff] [blame] | 80 | sk_sp<GrSemaphore> fSemaphore; |
Brian Osman | 13dddce | 2017-05-09 13:19:50 -0400 | [diff] [blame] | 81 | |
Greg Daniel | abba998 | 2018-02-01 10:07:57 -0500 | [diff] [blame] | 82 | GrBackendTexture fBackendTexture; |
| 83 | GrPixelConfig fConfig; |
| 84 | GrSurfaceOrigin fSurfaceOrigin; |
Brian Osman | 13dddce | 2017-05-09 13:19:50 -0400 | [diff] [blame] | 85 | |
| 86 | typedef SkImageGenerator INHERITED; |
| 87 | }; |
| 88 | #endif // GrBackendTextureImageGenerator_DEFINED |