Brian Osman | 45580d3 | 2016-11-23 09:37:01 -0500 | [diff] [blame] | 1 | /* |
| 2 | * Copyright 2016 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 GrSurfaceContext_DEFINED |
| 9 | #define GrSurfaceContext_DEFINED |
| 10 | |
Brian Salomon | e9ad998 | 2019-07-22 16:17:41 -0400 | [diff] [blame] | 11 | #include "include/core/SkFilterQuality.h" |
| 12 | #include "include/core/SkImageInfo.h" |
| 13 | #include "include/core/SkRect.h" |
Mike Klein | c0bd9f9 | 2019-04-23 12:05:21 -0500 | [diff] [blame] | 14 | #include "include/core/SkRefCnt.h" |
Brian Salomon | e9ad998 | 2019-07-22 16:17:41 -0400 | [diff] [blame] | 15 | #include "include/core/SkSurface.h" |
Mike Klein | c0bd9f9 | 2019-04-23 12:05:21 -0500 | [diff] [blame] | 16 | #include "src/gpu/GrColorSpaceInfo.h" |
Brian Salomon | 1d43530 | 2019-07-01 13:05:28 -0400 | [diff] [blame] | 17 | #include "src/gpu/GrDataUtils.h" |
Greg Daniel | f91aeb2 | 2019-06-18 09:58:02 -0400 | [diff] [blame] | 18 | #include "src/gpu/GrSurfaceProxy.h" |
Brian Osman | 45580d3 | 2016-11-23 09:37:01 -0500 | [diff] [blame] | 19 | |
| 20 | class GrAuditTrail; |
Robert Phillips | 7215283 | 2017-01-25 17:31:35 -0500 | [diff] [blame] | 21 | class GrDrawingManager; |
Robert Phillips | 6989370 | 2019-02-22 11:16:30 -0500 | [diff] [blame] | 22 | class GrRecordingContext; |
Robert Phillips | d46697a | 2017-01-25 12:10:37 -0500 | [diff] [blame] | 23 | class GrRenderTargetContext; |
Robert Phillips | 2734136 | 2016-12-14 08:46:47 -0500 | [diff] [blame] | 24 | class GrRenderTargetProxy; |
Brian Osman | 45580d3 | 2016-11-23 09:37:01 -0500 | [diff] [blame] | 25 | class GrSingleOwner; |
| 26 | class GrSurface; |
Robert Phillips | e305cc1f | 2016-12-14 12:19:05 -0500 | [diff] [blame] | 27 | class GrSurfaceContextPriv; |
Robert Phillips | 2734136 | 2016-12-14 08:46:47 -0500 | [diff] [blame] | 28 | class GrSurfaceProxy; |
| 29 | class GrTextureProxy; |
Brian Osman | 45580d3 | 2016-11-23 09:37:01 -0500 | [diff] [blame] | 30 | struct SkIPoint; |
| 31 | struct SkIRect; |
| 32 | |
| 33 | /** |
| 34 | * A helper object to orchestrate commands for a particular surface |
| 35 | */ |
Brian Salomon | 57f211b | 2019-08-21 15:21:09 -0400 | [diff] [blame] | 36 | class GrSurfaceContext { |
Brian Osman | 45580d3 | 2016-11-23 09:37:01 -0500 | [diff] [blame] | 37 | public: |
Brian Salomon | bf6b979 | 2019-08-21 09:38:10 -0400 | [diff] [blame] | 38 | virtual ~GrSurfaceContext() = default; |
Brian Osman | 45580d3 | 2016-11-23 09:37:01 -0500 | [diff] [blame] | 39 | |
Brian Salomon | f3569f0 | 2017-10-24 12:52:33 -0400 | [diff] [blame] | 40 | const GrColorSpaceInfo& colorSpaceInfo() const { return fColorSpaceInfo; } |
Robert Phillips | 2c86249 | 2017-01-18 10:08:39 -0500 | [diff] [blame] | 41 | |
Robert Phillips | d46697a | 2017-01-25 12:10:37 -0500 | [diff] [blame] | 42 | // TODO: these two calls would be way cooler if this object had a GrSurfaceProxy pointer |
Robert Phillips | f200a90 | 2017-01-30 13:27:37 -0500 | [diff] [blame] | 43 | int width() const { return this->asSurfaceProxy()->width(); } |
| 44 | int height() const { return this->asSurfaceProxy()->height(); } |
Robert Phillips | d46697a | 2017-01-25 12:10:37 -0500 | [diff] [blame] | 45 | |
Brian Salomon | 4d2d6f4 | 2019-07-26 14:15:11 -0400 | [diff] [blame] | 46 | const GrCaps* caps() const; |
| 47 | |
Robert Phillips | 2c86249 | 2017-01-18 10:08:39 -0500 | [diff] [blame] | 48 | /** |
| 49 | * Reads a rectangle of pixels from the render target context. |
| 50 | * @param dstInfo image info for the destination |
Brian Salomon | 1d43530 | 2019-07-01 13:05:28 -0400 | [diff] [blame] | 51 | * @param dst destination pixels for the read |
| 52 | * @param rowBytes bytes in a row of 'dst' |
| 53 | * @param srcPt offset w/in the surface context from which to read |
| 54 | * @param direct The direct context to use. If null will use our GrRecordingContext if it |
| 55 | * is a GrDirectContext and fail otherwise. |
Robert Phillips | 2c86249 | 2017-01-18 10:08:39 -0500 | [diff] [blame] | 56 | */ |
Brian Salomon | 1d43530 | 2019-07-01 13:05:28 -0400 | [diff] [blame] | 57 | bool readPixels(const GrPixelInfo& dstInfo, void* dst, size_t rowBytes, SkIPoint srcPt, |
| 58 | GrContext* direct = nullptr); |
Robert Phillips | 2c86249 | 2017-01-18 10:08:39 -0500 | [diff] [blame] | 59 | |
| 60 | /** |
Robert Phillips | b726d58 | 2017-03-09 16:36:32 -0500 | [diff] [blame] | 61 | * Writes a rectangle of pixels [srcInfo, srcBuffer, srcRowbytes] into the |
Robert Phillips | 2c86249 | 2017-01-18 10:08:39 -0500 | [diff] [blame] | 62 | * renderTargetContext at the specified position. |
| 63 | * @param srcInfo image info for the source pixels |
Brian Salomon | 1d43530 | 2019-07-01 13:05:28 -0400 | [diff] [blame] | 64 | * @param src source for the write |
| 65 | * @param rowBytes bytes in a row of 'src' |
| 66 | * @param dstPt offset w/in the surface context at which to write |
| 67 | * @param direct The direct context to use. If null will use our GrRecordingContext if it |
| 68 | * is a GrDirectContext and fail otherwise. |
Robert Phillips | 2c86249 | 2017-01-18 10:08:39 -0500 | [diff] [blame] | 69 | */ |
Brian Salomon | 1d43530 | 2019-07-01 13:05:28 -0400 | [diff] [blame] | 70 | bool writePixels(const GrPixelInfo& srcInfo, const void* src, size_t rowBytes, SkIPoint dstPt, |
| 71 | GrContext* direct = nullptr); |
Greg Daniel | 6eb8c24 | 2019-06-05 10:22:24 -0400 | [diff] [blame] | 72 | |
Robert Phillips | 2734136 | 2016-12-14 08:46:47 -0500 | [diff] [blame] | 73 | // TODO: this is virtual b.c. this object doesn't have a pointer to the wrapped GrSurfaceProxy? |
Robert Phillips | f200a90 | 2017-01-30 13:27:37 -0500 | [diff] [blame] | 74 | virtual GrSurfaceProxy* asSurfaceProxy() = 0; |
| 75 | virtual const GrSurfaceProxy* asSurfaceProxy() const = 0; |
| 76 | virtual sk_sp<GrSurfaceProxy> asSurfaceProxyRef() = 0; |
| 77 | |
| 78 | virtual GrTextureProxy* asTextureProxy() = 0; |
Greg Daniel | e252f08 | 2017-10-23 16:05:23 -0400 | [diff] [blame] | 79 | virtual const GrTextureProxy* asTextureProxy() const = 0; |
Robert Phillips | f200a90 | 2017-01-30 13:27:37 -0500 | [diff] [blame] | 80 | virtual sk_sp<GrTextureProxy> asTextureProxyRef() = 0; |
| 81 | |
| 82 | virtual GrRenderTargetProxy* asRenderTargetProxy() = 0; |
| 83 | virtual sk_sp<GrRenderTargetProxy> asRenderTargetProxyRef() = 0; |
Robert Phillips | 2734136 | 2016-12-14 08:46:47 -0500 | [diff] [blame] | 84 | |
Robert Phillips | d46697a | 2017-01-25 12:10:37 -0500 | [diff] [blame] | 85 | virtual GrRenderTargetContext* asRenderTargetContext() { return nullptr; } |
| 86 | |
Robert Phillips | 0d075de | 2019-03-04 11:08:13 -0500 | [diff] [blame] | 87 | GrAuditTrail* auditTrail(); |
Brian Osman | 45580d3 | 2016-11-23 09:37:01 -0500 | [diff] [blame] | 88 | |
Robert Phillips | e305cc1f | 2016-12-14 12:19:05 -0500 | [diff] [blame] | 89 | // Provides access to functions that aren't part of the public API. |
| 90 | GrSurfaceContextPriv surfPriv(); |
| 91 | const GrSurfaceContextPriv surfPriv() const; |
| 92 | |
Greg Daniel | 46cfbc6 | 2019-06-07 11:43:30 -0400 | [diff] [blame] | 93 | #if GR_TEST_UTILS |
| 94 | bool testCopy(GrSurfaceProxy* src, const SkIRect& srcRect, const SkIPoint& dstPoint) { |
| 95 | return this->copy(src, srcRect, dstPoint); |
| 96 | } |
| 97 | |
| 98 | bool testCopy(GrSurfaceProxy* src) { |
| 99 | return this->copy(src); |
| 100 | } |
| 101 | #endif |
| 102 | |
| 103 | |
Brian Osman | 45580d3 | 2016-11-23 09:37:01 -0500 | [diff] [blame] | 104 | protected: |
Robert Phillips | e305cc1f | 2016-12-14 12:19:05 -0500 | [diff] [blame] | 105 | friend class GrSurfaceContextPriv; |
| 106 | |
Brian Salomon | bd3d8d3 | 2019-07-02 09:16:28 -0400 | [diff] [blame] | 107 | GrSurfaceContext(GrRecordingContext*, GrColorType, SkAlphaType, sk_sp<SkColorSpace>); |
Robert Phillips | 7215283 | 2017-01-25 17:31:35 -0500 | [diff] [blame] | 108 | |
Robert Phillips | 0d075de | 2019-03-04 11:08:13 -0500 | [diff] [blame] | 109 | GrDrawingManager* drawingManager(); |
| 110 | const GrDrawingManager* drawingManager() const; |
Brian Osman | 45580d3 | 2016-11-23 09:37:01 -0500 | [diff] [blame] | 111 | |
Robert Phillips | 2de8cfa | 2017-06-28 10:33:41 -0400 | [diff] [blame] | 112 | SkDEBUGCODE(virtual void validate() const = 0;) |
| 113 | |
Robert Phillips | 0d075de | 2019-03-04 11:08:13 -0500 | [diff] [blame] | 114 | SkDEBUGCODE(GrSingleOwner* singleOwner();) |
Brian Osman | 45580d3 | 2016-11-23 09:37:01 -0500 | [diff] [blame] | 115 | |
Robert Phillips | 6989370 | 2019-02-22 11:16:30 -0500 | [diff] [blame] | 116 | GrRecordingContext* fContext; |
Brian Osman | 45580d3 | 2016-11-23 09:37:01 -0500 | [diff] [blame] | 117 | |
Brian Salomon | e9ad998 | 2019-07-22 16:17:41 -0400 | [diff] [blame] | 118 | // The rescaling step of asyncRescaleAndReadPixels[YUV420](). |
Brian Salomon | bf6b979 | 2019-08-21 09:38:10 -0400 | [diff] [blame] | 119 | std::unique_ptr<GrRenderTargetContext> rescale(const SkImageInfo& info, const SkIRect& srcRect, |
| 120 | SkSurface::RescaleGamma rescaleGamma, |
| 121 | SkFilterQuality rescaleQuality); |
Brian Salomon | e9ad998 | 2019-07-22 16:17:41 -0400 | [diff] [blame] | 122 | |
Brian Salomon | 4d2d6f4 | 2019-07-26 14:15:11 -0400 | [diff] [blame] | 123 | // Inserts a transfer, part of the implementation of asyncReadPixels and |
| 124 | // asyncRescaleAndReadPixelsYUV420(). |
| 125 | struct PixelTransferResult { |
| 126 | using ConversionFn = void(void* dst, const void* mappedBuffer); |
| 127 | // If null then the transfer could not be performed. Otherwise this buffer will contain |
| 128 | // the pixel data when the transfer is complete. |
| 129 | sk_sp<GrGpuBuffer> fTransferBuffer; |
| 130 | // If this is null then the transfer buffer will contain the data in the requested |
| 131 | // color type. Otherwise, when the transfer is done this must be called to convert |
| 132 | // from the transfer buffer's color type to the requested color type. |
| 133 | std::function<ConversionFn> fPixelConverter; |
| 134 | }; |
| 135 | PixelTransferResult transferPixels(GrColorType colorType, const SkIRect& rect); |
| 136 | |
Robert Phillips | e305cc1f | 2016-12-14 12:19:05 -0500 | [diff] [blame] | 137 | private: |
Greg Daniel | 46cfbc6 | 2019-06-07 11:43:30 -0400 | [diff] [blame] | 138 | friend class GrSurfaceProxy; // for copy |
| 139 | |
| 140 | /** |
| 141 | * Copy 'src' into the proxy backing this context. This call will not do any draw fallback. |
| 142 | * Currently only writePixels and replaceRenderTarget call this directly. All other copies |
| 143 | * should go through GrSurfaceProxy::Copy. |
| 144 | * @param src src of pixels |
| 145 | * @param srcRect the subset of 'src' to copy |
| 146 | * @param dstPoint the origin of the 'srcRect' in the destination coordinate space |
| 147 | * @return true if the copy succeeded; false otherwise |
| 148 | * |
| 149 | * Note: Notionally, 'srcRect' is clipped to 'src's extent with 'dstPoint' being adjusted. |
| 150 | * Then the 'srcRect' offset by 'dstPoint' is clipped against the dst's extent. |
| 151 | * The end result is only valid src pixels and dst pixels will be touched but the copied |
| 152 | * regions will not be shifted. The 'src' must have the same origin as the backing proxy |
| 153 | * of fSurfaceContext. |
| 154 | */ |
| 155 | bool copy(GrSurfaceProxy* src, const SkIRect& srcRect, const SkIPoint& dstPoint); |
| 156 | |
| 157 | bool copy(GrSurfaceProxy* src) { |
| 158 | return this->copy(src, SkIRect::MakeWH(src->width(), src->height()), SkIPoint::Make(0, 0)); |
| 159 | } |
| 160 | |
Robert Phillips | 6989370 | 2019-02-22 11:16:30 -0500 | [diff] [blame] | 161 | GrColorSpaceInfo fColorSpaceInfo; |
Brian Salomon | f3569f0 | 2017-10-24 12:52:33 -0400 | [diff] [blame] | 162 | |
Robert Phillips | e305cc1f | 2016-12-14 12:19:05 -0500 | [diff] [blame] | 163 | typedef SkRefCnt INHERITED; |
Brian Osman | 45580d3 | 2016-11-23 09:37:01 -0500 | [diff] [blame] | 164 | }; |
| 165 | |
| 166 | #endif |