| /* |
| * 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 "GrRenderTarget.h" |
| #include "SkRefCnt.h" |
| #include "SkRegion.h" |
| #include "SkSurfaceProps.h" |
| #include "../private/GrSingleOwner.h" |
| |
| class GrAtlasTextContext; |
| 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 GrStrokeInfo; |
| class GrSurface; |
| class SkDrawFilter; |
| struct SkIPoint; |
| struct SkIRect; |
| 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 GrStrokeInfo (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 strokeInfo the stroke information (width, join, cap), and. |
| * the dash information (intervals, count, phase). |
| * If strokeInfo == NULL, then the rect is filled. |
| * Otherwise, if stroke width == 0, then the stroke |
| * is always a single pixel thick, else the rect is |
| * mitered/beveled stroked based on stroke width. |
| * 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 GrStrokeInfo* strokeInfo = 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 strokeInfo the stroke information (width, join, cap) and |
| * the dash information (intervals, count, phase). |
| */ |
| void drawRRect(const GrClip&, |
| const GrPaint&, |
| const SkMatrix& viewMatrix, |
| const SkRRect& rrect, |
| const GrStrokeInfo&); |
| |
| /** |
| * 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 strokeInfo the stroke information (width, join, cap) and |
| * the dash information (intervals, count, phase). |
| */ |
| void drawPath(const GrClip&, |
| const GrPaint&, |
| const SkMatrix& viewMatrix, |
| const SkPath&, |
| const GrStrokeInfo&); |
| |
| /** |
| * 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 strokeInfo the stroke information (width, join, cap) and |
| * the dash information (intervals, count, phase). |
| */ |
| void drawOval(const GrClip&, |
| const GrPaint& paint, |
| const SkMatrix& viewMatrix, |
| const SkRect& oval, |
| const GrStrokeInfo& strokeInfo); |
| |
| /** |
| * Draw the image stretched differentially to fit into dst. |
| * center is a rect within the image, and logically divides the image |
| * into 9 sections (3x3). For example, if the middle pixel of a [5x5] |
| * image is the "center", then the center-rect should be [2, 2, 3, 3]. |
| * |
| * If the dst is >= the image size, then... |
| * - The 4 corners are not stretched at all. |
| * - The sides are stretched in only one axis. |
| * - The center is stretched in both axes. |
| * Else, for each axis where dst < image, |
| * - The corners shrink proportionally |
| * - The sides (along the shrink axis) and center are not drawn |
| */ |
| void drawImageNine(const GrClip&, |
| const GrPaint& paint, |
| const SkMatrix& viewMatrix, |
| int imageWidth, |
| int imageHeight, |
| const SkIRect& center, |
| const SkRect& dst); |
| |
| /** |
| * Draws a batch |
| * |
| * @param paint describes how to color pixels. |
| * @param batch the batch to draw |
| */ |
| void drawBatch(const GrClip&, const GrPaint&, GrDrawBatch*); |
| |
| /** |
| * Draws a path batch. This needs to be separate from drawBatch because we install path stencil |
| * settings late. |
| * |
| * TODO: Figure out a better model that allows us to roll this method into drawBatch. |
| */ |
| void drawPathBatch(const GrPipelineBuilder&, GrDrawPathBatchBase*); |
| |
| int width() const { return fRenderTarget->width(); } |
| int height() const { return fRenderTarget->height(); } |
| int numColorSamples() const { return fRenderTarget->numColorSamples(); } |
| bool isGammaCorrect() const { return fSurfaceProps.isGammaCorrect(); } |
| |
| 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; |
| |
| protected: |
| GrDrawContext(GrContext*, GrDrawingManager*, sk_sp<GrRenderTarget>, |
| const SkSurfaceProps* surfaceProps, GrAuditTrail*, GrSingleOwner*); |
| |
| GrDrawingManager* drawingManager() { return fDrawingManager; } |
| GrAuditTrail* auditTrail() { return fAuditTrail; } |
| const SkSurfaceProps& surfaceProps() const { return fSurfaceProps; } |
| |
| SkDEBUGCODE(GrSingleOwner* singleOwner() { return fSingleOwner; }) |
| SkDEBUGCODE(void validate() const;) |
| |
| private: |
| friend class GrAtlasTextBlob; // for access to drawBatch |
| friend class GrDrawingManager; // for ctor |
| friend class GrDrawContextPriv; |
| |
| bool drawFilledDRRect(const GrClip& clip, |
| const GrPaint& paint, |
| const SkMatrix& viewMatrix, |
| const SkRRect& origOuter, |
| const SkRRect& origInner); |
| |
| GrDrawBatch* getFillRectBatch(const GrPaint& paint, |
| const SkMatrix& viewMatrix, |
| const SkRect& rect); |
| |
| void internalDrawPath(const GrClip& clip, |
| const GrPaint& paint, |
| const SkMatrix& viewMatrix, |
| const SkPath& path, |
| const GrStrokeInfo& strokeInfo); |
| |
| // This entry point allows the GrTextContext-derived classes to add their batches to |
| // the drawTarget. |
| void drawBatch(GrPipelineBuilder* pipelineBuilder, 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; |
| SkAutoTDelete<GrAtlasTextContext> fAtlasTextContext; |
| GrContext* fContext; |
| |
| SkSurfaceProps fSurfaceProps; |
| GrAuditTrail* fAuditTrail; |
| |
| // In debug builds we guard against improper thread handling |
| SkDEBUGCODE(mutable GrSingleOwner* fSingleOwner;) |
| }; |
| |
| #endif |