| /* |
| * Copyright 2015 Google Inc. |
| * |
| * Use of this source code is governed by a BSD-style license that can be |
| * found in the LICENSE file. |
| */ |
| |
| #ifndef GrDrawContext_DEFINED |
| #define GrDrawContext_DEFINED |
| |
| #include "GrColor.h" |
| #include "GrPaint.h" |
| #include "GrRenderTarget.h" |
| #include "SkRefCnt.h" |
| #include "SkRegion.h" |
| #include "SkSurfaceProps.h" |
| #include "../private/GrInstancedPipelineInfo.h" |
| #include "../private/GrSingleOwner.h" |
| |
| class GrAuditTrail; |
| class GrClip; |
| class GrContext; |
| class GrDrawBatch; |
| class GrDrawContextPriv; |
| class GrDrawPathBatchBase; |
| class GrDrawingManager; |
| class GrDrawTarget; |
| class GrPaint; |
| class GrPathProcessor; |
| class GrPipelineBuilder; |
| class GrRenderTarget; |
| class GrStyle; |
| class GrSurface; |
| struct GrUserStencilSettings; |
| class SkDrawFilter; |
| struct SkIPoint; |
| struct SkIRect; |
| class SkLatticeIter; |
| class SkMatrix; |
| class SkPaint; |
| class SkPath; |
| struct SkPoint; |
| struct SkRect; |
| class SkRRect; |
| struct SkRSXform; |
| class SkTextBlob; |
| |
| /* |
| * A helper object to orchestrate draws |
| */ |
| class SK_API GrDrawContext : public SkRefCnt { |
| public: |
| ~GrDrawContext() override; |
| |
| bool copySurface(GrSurface* src, const SkIRect& srcRect, const SkIPoint& dstPoint); |
| |
| // TODO: it is odd that we need both the SkPaint in the following 3 methods. |
| // We should extract the text parameters from SkPaint and pass them separately |
| // akin to GrStyle (GrTextInfo?) |
| virtual void drawText(const GrClip&, const GrPaint&, const SkPaint&, |
| const SkMatrix& viewMatrix, const char text[], size_t byteLength, |
| SkScalar x, SkScalar y, const SkIRect& clipBounds); |
| virtual void drawPosText(const GrClip&, const GrPaint&, const SkPaint&, |
| const SkMatrix& viewMatrix, const char text[], size_t byteLength, |
| const SkScalar pos[], int scalarsPerPosition, |
| const SkPoint& offset, const SkIRect& clipBounds); |
| virtual void drawTextBlob(const GrClip&, const SkPaint&, |
| const SkMatrix& viewMatrix, const SkTextBlob*, |
| SkScalar x, SkScalar y, |
| SkDrawFilter*, const SkIRect& clipBounds); |
| |
| /** |
| * Provides a perfomance hint that the render target's contents are allowed |
| * to become undefined. |
| */ |
| void discard(); |
| |
| /** |
| * Clear the entire or rect of the render target, ignoring any clips. |
| * @param rect the rect to clear or the whole thing if rect is NULL. |
| * @param color the color to clear to. |
| * @param canIgnoreRect allows partial clears to be converted to whole |
| * clears on platforms for which that is cheap |
| */ |
| void clear(const SkIRect* rect, GrColor color, bool canIgnoreRect); |
| |
| /** |
| * Draw everywhere (respecting the clip) with the paint. |
| */ |
| void drawPaint(const GrClip&, const GrPaint&, const SkMatrix& viewMatrix); |
| |
| /** |
| * Draw the rect using a paint. |
| * @param paint describes how to color pixels. |
| * @param viewMatrix transformation matrix |
| * @param style The style to apply. Null means fill. Currently path effects are not |
| * allowed. |
| * The rects coords are used to access the paint (through texture matrix) |
| */ |
| void drawRect(const GrClip&, |
| const GrPaint& paint, |
| const SkMatrix& viewMatrix, |
| const SkRect&, |
| const GrStyle* style = nullptr); |
| |
| /** |
| * Maps a rectangle of shader coordinates to a rectangle and fills that rectangle. |
| * |
| * @param paint describes how to color pixels. |
| * @param viewMatrix transformation matrix which applies to rectToDraw |
| * @param rectToDraw the rectangle to draw |
| * @param localRect the rectangle of shader coordinates applied to rectToDraw |
| */ |
| void fillRectToRect(const GrClip&, |
| const GrPaint& paint, |
| const SkMatrix& viewMatrix, |
| const SkRect& rectToDraw, |
| const SkRect& localRect); |
| |
| /** |
| * Fills a rect with a paint and a localMatrix. |
| */ |
| void fillRectWithLocalMatrix(const GrClip& clip, |
| const GrPaint& paint, |
| const SkMatrix& viewMatrix, |
| const SkRect& rect, |
| const SkMatrix& localMatrix); |
| |
| /** |
| * Draw a roundrect using a paint. |
| * |
| * @param paint describes how to color pixels. |
| * @param viewMatrix transformation matrix |
| * @param rrect the roundrect to draw |
| * @param style style to apply to the rrect. Currently path effects are not allowed. |
| */ |
| void drawRRect(const GrClip&, |
| const GrPaint&, |
| const SkMatrix& viewMatrix, |
| const SkRRect& rrect, |
| const GrStyle& style); |
| |
| /** |
| * Shortcut for drawing an SkPath consisting of nested rrects using a paint. |
| * Does not support stroking. The result is undefined if outer does not contain |
| * inner. |
| * |
| * @param paint describes how to color pixels. |
| * @param viewMatrix transformation matrix |
| * @param outer the outer roundrect |
| * @param inner the inner roundrect |
| */ |
| void drawDRRect(const GrClip&, |
| const GrPaint&, |
| const SkMatrix& viewMatrix, |
| const SkRRect& outer, |
| const SkRRect& inner); |
| |
| /** |
| * Draws a path. |
| * |
| * @param paint describes how to color pixels. |
| * @param viewMatrix transformation matrix |
| * @param path the path to draw |
| * @param style style to apply to the path. |
| */ |
| void drawPath(const GrClip&, |
| const GrPaint&, |
| const SkMatrix& viewMatrix, |
| const SkPath&, |
| const GrStyle& style); |
| |
| /** |
| * Draws vertices with a paint. |
| * |
| * @param paint describes how to color pixels. |
| * @param viewMatrix transformation matrix |
| * @param primitiveType primitives type to draw. |
| * @param vertexCount number of vertices. |
| * @param positions array of vertex positions, required. |
| * @param texCoords optional array of texture coordinates used |
| * to access the paint. |
| * @param colors optional array of per-vertex colors, supercedes |
| * the paint's color field. |
| * @param indices optional array of indices. If NULL vertices |
| * are drawn non-indexed. |
| * @param indexCount if indices is non-null then this is the |
| * number of indices. |
| */ |
| void drawVertices(const GrClip&, |
| const GrPaint& paint, |
| const SkMatrix& viewMatrix, |
| GrPrimitiveType primitiveType, |
| int vertexCount, |
| const SkPoint positions[], |
| const SkPoint texs[], |
| const GrColor colors[], |
| const uint16_t indices[], |
| int indexCount); |
| |
| /** |
| * Draws textured sprites from an atlas with a paint. |
| * |
| * @param paint describes how to color pixels. |
| * @param viewMatrix transformation matrix |
| * @param spriteCount number of sprites. |
| * @param xform array of compressed transformation data, required. |
| * @param texRect array of texture rectangles used to access the paint. |
| * @param colors optional array of per-sprite colors, supercedes |
| * the paint's color field. |
| */ |
| void drawAtlas(const GrClip&, |
| const GrPaint& paint, |
| const SkMatrix& viewMatrix, |
| int spriteCount, |
| const SkRSXform xform[], |
| const SkRect texRect[], |
| const SkColor colors[]); |
| |
| /** |
| * Draws an oval. |
| * |
| * @param paint describes how to color pixels. |
| * @param viewMatrix transformation matrix |
| * @param oval the bounding rect of the oval. |
| * @param style style to apply to the oval. Currently path effects are not allowed. |
| */ |
| void drawOval(const GrClip&, |
| const GrPaint& paint, |
| const SkMatrix& viewMatrix, |
| const SkRect& oval, |
| const GrStyle& style); |
| |
| /** |
| * Draw the image as a set of rects, specified by |iter|. |
| */ |
| void drawImageLattice(const GrClip&, |
| const GrPaint& paint, |
| const SkMatrix& viewMatrix, |
| int imageWidth, |
| int imageHeight, |
| std::unique_ptr<SkLatticeIter> iter, |
| const SkRect& dst); |
| |
| /** |
| * After this returns any pending surface IO will be issued to the backend 3D API and |
| * if the surface has MSAA it will be resolved. |
| */ |
| void prepareForExternalIO(); |
| |
| bool isStencilBufferMultisampled() const { |
| return fRenderTarget->isStencilBufferMultisampled(); |
| } |
| bool isUnifiedMultisampled() const { return fRenderTarget->isUnifiedMultisampled(); } |
| bool hasMixedSamples() const { return fRenderTarget->isMixedSampled(); } |
| |
| bool mustUseHWAA(const GrPaint& paint) const { |
| return paint.isAntiAlias() && fRenderTarget->isUnifiedMultisampled(); |
| } |
| |
| const GrSurfaceDesc& desc() const { return fRenderTarget->desc(); } |
| int width() const { return fRenderTarget->width(); } |
| int height() const { return fRenderTarget->height(); } |
| GrPixelConfig config() const { return fRenderTarget->config(); } |
| int numColorSamples() const { return fRenderTarget->numColorSamples(); } |
| bool isGammaCorrect() const { return SkToBool(fColorSpace.get()); } |
| SkSourceGammaTreatment sourceGammaTreatment() const { |
| return this->isGammaCorrect() ? SkSourceGammaTreatment::kRespect |
| : SkSourceGammaTreatment::kIgnore; |
| } |
| const SkSurfaceProps& surfaceProps() const { return fSurfaceProps; } |
| SkColorSpace* getColorSpace() const { return fColorSpace.get(); } |
| GrSurfaceOrigin origin() const { return fRenderTarget->origin(); } |
| |
| bool wasAbandoned() const; |
| |
| GrRenderTarget* accessRenderTarget() { return fRenderTarget.get(); } |
| |
| sk_sp<GrRenderTarget> renderTarget() { return fRenderTarget; } |
| |
| sk_sp<GrTexture> asTexture() { return sk_ref_sp(fRenderTarget->asTexture()); } |
| |
| // Provides access to functions that aren't part of the public API. |
| GrDrawContextPriv drawContextPriv(); |
| const GrDrawContextPriv drawContextPriv() const; |
| |
| GrAuditTrail* auditTrail() { return fAuditTrail; } |
| |
| protected: |
| GrDrawContext(GrContext*, GrDrawingManager*, sk_sp<GrRenderTarget>, sk_sp<SkColorSpace>, |
| const SkSurfaceProps* surfaceProps, GrAuditTrail*, GrSingleOwner*); |
| |
| GrDrawingManager* drawingManager() { return fDrawingManager; } |
| |
| SkDEBUGCODE(GrSingleOwner* singleOwner() { return fSingleOwner; }) |
| SkDEBUGCODE(void validate() const;) |
| |
| private: |
| friend class GrAtlasTextBlob; // for access to drawBatch |
| friend class GrStencilAndCoverTextContext; // for access to drawBatch |
| |
| friend class GrDrawingManager; // for ctor |
| friend class GrDrawContextPriv; |
| friend class GrTestTarget; // for access to getDrawTarget |
| friend class GrSWMaskHelper; // for access to drawBatch |
| |
| // All the path renderers currently make their own batches |
| friend class GrSoftwarePathRenderer; // for access to drawBatch |
| friend class GrAAConvexPathRenderer; // for access to drawBatch |
| friend class GrDashLinePathRenderer; // for access to drawBatch |
| friend class GrAAHairLinePathRenderer; // for access to drawBatch |
| friend class GrAALinearizingConvexPathRenderer; // for access to drawBatch |
| friend class GrAADistanceFieldPathRenderer; // for access to drawBatch |
| friend class GrDefaultPathRenderer; // for access to drawBatch |
| friend class GrPLSPathRenderer; // for access to drawBatch |
| friend class GrMSAAPathRenderer; // for access to drawBatch |
| friend class GrStencilAndCoverPathRenderer; // for access to drawBatch |
| friend class GrTessellatingPathRenderer; // for access to drawBatch |
| |
| bool drawFilledDRRect(const GrClip& clip, |
| const GrPaint& paint, |
| const SkMatrix& viewMatrix, |
| const SkRRect& origOuter, |
| const SkRRect& origInner); |
| |
| bool drawFilledRect(const GrClip& clip, |
| const GrPaint& paint, |
| const SkMatrix& viewMatrix, |
| const SkRect& rect, |
| const GrUserStencilSettings* ss); |
| |
| void drawNonAAFilledRect(const GrClip&, |
| const GrPaint&, |
| const SkMatrix& viewMatrix, |
| const SkRect& rect, |
| const SkRect* localRect, |
| const SkMatrix* localMatrix, |
| const GrUserStencilSettings* ss, |
| bool useHWAA); |
| |
| void internalDrawPath(const GrClip& clip, |
| const GrPaint& paint, |
| const SkMatrix& viewMatrix, |
| const SkPath& path, |
| const GrStyle& style); |
| |
| // This entry point allows the GrTextContext-derived classes to add their batches to |
| // the drawTarget. |
| void drawBatch(const GrPipelineBuilder& pipelineBuilder, const GrClip&, GrDrawBatch* batch); |
| |
| GrDrawTarget* getDrawTarget(); |
| |
| GrDrawingManager* fDrawingManager; |
| sk_sp<GrRenderTarget> fRenderTarget; |
| |
| // In MDB-mode the drawTarget can be closed by some other drawContext that has picked |
| // it up. For this reason, the drawTarget should only ever be accessed via 'getDrawTarget'. |
| GrDrawTarget* fDrawTarget; |
| GrContext* fContext; |
| GrInstancedPipelineInfo fInstancedPipelineInfo; |
| |
| sk_sp<SkColorSpace> fColorSpace; |
| SkSurfaceProps fSurfaceProps; |
| GrAuditTrail* fAuditTrail; |
| |
| // In debug builds we guard against improper thread handling |
| SkDEBUGCODE(mutable GrSingleOwner* fSingleOwner;) |
| }; |
| |
| #endif |