Canvas.h revision bad99183916ba2bac6659efc8a28273e344ba511
1cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger/* 2cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger * Copyright (C) 2014 The Android Open Source Project 3cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger * 4cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger * Licensed under the Apache License, Version 2.0 (the "License"); 5cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger * you may not use this file except in compliance with the License. 6cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger * You may obtain a copy of the License at 7cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger * 8cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger * http://www.apache.org/licenses/LICENSE-2.0 9cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger * 10cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger * Unless required by applicable law or agreed to in writing, software 11cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger * distributed under the License is distributed on an "AS IS" BASIS, 12cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger * See the License for the specific language governing permissions and 14cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger * limitations under the License. 15cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger */ 16cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 17cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger#ifndef ANDROID_GRAPHICS_CANVAS_H 18cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger#define ANDROID_GRAPHICS_CANVAS_H 19cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 20849911a9c4315fc552faa38516c842b2541b1909John Reck#include <cutils/compiler.h> 216f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger#include <utils/Functor.h> 22849911a9c4315fc552faa38516c842b2541b1909John Reck 234c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger#include "utils/NinePatch.h" 244c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger 25849911a9c4315fc552faa38516c842b2541b1909John Reck#include <SkBitmap.h> 26849911a9c4315fc552faa38516c842b2541b1909John Reck#include <SkCanvas.h> 27849911a9c4315fc552faa38516c842b2541b1909John Reck#include <SkMatrix.h> 28cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 29cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenbergernamespace android { 30cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 316f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenbergernamespace uirenderer { 326f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger class CanvasPropertyPaint; 336f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger class CanvasPropertyPrimitive; 346f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger class DeferredLayerUpdater; 356f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger class DisplayList; 366f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger class RenderNode; 376f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger} 386f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger 39eecff56fed5dd5206acfbc5007b4912081b36d3bFlorin Malitanamespace SaveFlags { 40eecff56fed5dd5206acfbc5007b4912081b36d3bFlorin Malita 41eecff56fed5dd5206acfbc5007b4912081b36d3bFlorin Malita// These must match the corresponding Canvas API constants. 42eecff56fed5dd5206acfbc5007b4912081b36d3bFlorin Malitaenum { 43eecff56fed5dd5206acfbc5007b4912081b36d3bFlorin Malita Matrix = 0x01, 44eecff56fed5dd5206acfbc5007b4912081b36d3bFlorin Malita Clip = 0x02, 45eecff56fed5dd5206acfbc5007b4912081b36d3bFlorin Malita HasAlphaLayer = 0x04, 46eecff56fed5dd5206acfbc5007b4912081b36d3bFlorin Malita ClipToLayer = 0x10, 47eecff56fed5dd5206acfbc5007b4912081b36d3bFlorin Malita 48eecff56fed5dd5206acfbc5007b4912081b36d3bFlorin Malita // Helper constant 49eecff56fed5dd5206acfbc5007b4912081b36d3bFlorin Malita MatrixClip = Matrix | Clip, 50eecff56fed5dd5206acfbc5007b4912081b36d3bFlorin Malita}; 51eecff56fed5dd5206acfbc5007b4912081b36d3bFlorin Malitatypedef uint32_t Flags; 52eecff56fed5dd5206acfbc5007b4912081b36d3bFlorin Malita 53eecff56fed5dd5206acfbc5007b4912081b36d3bFlorin Malita} // namespace SaveFlags 54eecff56fed5dd5206acfbc5007b4912081b36d3bFlorin Malita 55766431aa57c16ece8842287a92b2e7208e3b8ac3Doris Liunamespace uirenderer { 56766431aa57c16ece8842287a92b2e7208e3b8ac3Doris Liunamespace VectorDrawable { 57766431aa57c16ece8842287a92b2e7208e3b8ac3Doris Liuclass Tree; 58766431aa57c16ece8842287a92b2e7208e3b8ac3Doris Liu}; 59766431aa57c16ece8842287a92b2e7208e3b8ac3Doris Liu}; 60766431aa57c16ece8842287a92b2e7208e3b8ac3Doris Liutypedef uirenderer::VectorDrawable::Tree VectorDrawableRoot; 61766431aa57c16ece8842287a92b2e7208e3b8ac3Doris Liu 62dccca44ffda4836b56a21da95a046c9708ffd49csergeyvclass Paint; 63bad99183916ba2bac6659efc8a28273e344ba511sergeyvstruct Typeface; 64dccca44ffda4836b56a21da95a046c9708ffd49csergeyv 65849911a9c4315fc552faa38516c842b2541b1909John Reckclass ANDROID_API Canvas { 66cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenbergerpublic: 67cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual ~Canvas() {}; 68cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 69c1b33d665c8caf5760f68c45c6ca0baa649b832aJohn Reck static Canvas* create_canvas(const SkBitmap& bitmap); 7018981294a58c411a4a33ebb22caf9c75ba639691Leon Scroggins III 716f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger static Canvas* create_recording_canvas(int width, int height); 726f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger 7318981294a58c411a4a33ebb22caf9c75ba639691Leon Scroggins III /** 7418981294a58c411a4a33ebb22caf9c75ba639691Leon Scroggins III * Create a new Canvas object which delegates to an SkCanvas. 7518981294a58c411a4a33ebb22caf9c75ba639691Leon Scroggins III * 7618981294a58c411a4a33ebb22caf9c75ba639691Leon Scroggins III * @param skiaCanvas Must not be NULL. All drawing calls will be 7718981294a58c411a4a33ebb22caf9c75ba639691Leon Scroggins III * delegated to this object. This function will call ref() on the 7818981294a58c411a4a33ebb22caf9c75ba639691Leon Scroggins III * SkCanvas, and the returned Canvas will unref() it upon 7918981294a58c411a4a33ebb22caf9c75ba639691Leon Scroggins III * destruction. 8018981294a58c411a4a33ebb22caf9c75ba639691Leon Scroggins III * @return new Canvas object. Will not return NULL. 8118981294a58c411a4a33ebb22caf9c75ba639691Leon Scroggins III */ 82cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger static Canvas* create_canvas(SkCanvas* skiaCanvas); 83cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 841db141f93c4fe79a4669440c3d14f63bc87b2e34Derek Sollenberger /** 851db141f93c4fe79a4669440c3d14f63bc87b2e34Derek Sollenberger * Provides a Skia SkCanvas interface that acts as a proxy to this Canvas. 861db141f93c4fe79a4669440c3d14f63bc87b2e34Derek Sollenberger * It is useful for testing and clients (e.g. Picture/Movie) that expect to 871db141f93c4fe79a4669440c3d14f63bc87b2e34Derek Sollenberger * draw their contents into an SkCanvas. 881db141f93c4fe79a4669440c3d14f63bc87b2e34Derek Sollenberger * 8990fb1f6732a610ad5ff6acdb3bd9ae392c8eac82Tom Hudson * The SkCanvas returned is *only* valid until another Canvas call is made 9090fb1f6732a610ad5ff6acdb3bd9ae392c8eac82Tom Hudson * that would change state (e.g. matrix or clip). Clients of asSkCanvas() 9190fb1f6732a610ad5ff6acdb3bd9ae392c8eac82Tom Hudson * are responsible for *not* persisting this pointer. 9290fb1f6732a610ad5ff6acdb3bd9ae392c8eac82Tom Hudson * 931db141f93c4fe79a4669440c3d14f63bc87b2e34Derek Sollenberger * Further, the returned SkCanvas should NOT be unref'd and is valid until 941db141f93c4fe79a4669440c3d14f63bc87b2e34Derek Sollenberger * this canvas is destroyed or a new bitmap is set. 951db141f93c4fe79a4669440c3d14f63bc87b2e34Derek Sollenberger */ 96b3d50e007523d1ada0866d384c391c72ac1a3577Derek Sollenberger virtual SkCanvas* asSkCanvas() = 0; 97cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 986f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger 99c1b33d665c8caf5760f68c45c6ca0baa649b832aJohn Reck virtual void setBitmap(const SkBitmap& bitmap) = 0; 100cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 101cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual bool isOpaque() = 0; 102cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual int width() = 0; 103cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual int height() = 0; 104cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 1056f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger// ---------------------------------------------------------------------------- 1066f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger// View System operations (not exposed in public Canvas API) 1076f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger// ---------------------------------------------------------------------------- 1086f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger 1096f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger virtual void resetRecording(int width, int height) = 0; 1106f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger virtual uirenderer::DisplayList* finishRecording() = 0; 1116f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger virtual void insertReorderBarrier(bool enableReorder) = 0; 1126f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger 1136578a989566e585eee053095dc80e2552e125db2Derek Sollenberger virtual void setHighContrastText(bool highContrastText) = 0; 1146578a989566e585eee053095dc80e2552e125db2Derek Sollenberger virtual bool isHighContrastText() = 0; 1156578a989566e585eee053095dc80e2552e125db2Derek Sollenberger 1166f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger virtual void drawRoundRect(uirenderer::CanvasPropertyPrimitive* left, 1176f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger uirenderer::CanvasPropertyPrimitive* top, uirenderer::CanvasPropertyPrimitive* right, 1186f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger uirenderer::CanvasPropertyPrimitive* bottom, uirenderer::CanvasPropertyPrimitive* rx, 1196f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger uirenderer::CanvasPropertyPrimitive* ry, uirenderer::CanvasPropertyPaint* paint) = 0; 1206f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger virtual void drawCircle(uirenderer::CanvasPropertyPrimitive* x, 1216f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger uirenderer::CanvasPropertyPrimitive* y, uirenderer::CanvasPropertyPrimitive* radius, 1226f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger uirenderer::CanvasPropertyPaint* paint) = 0; 1236f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger 1246f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger virtual void drawLayer(uirenderer::DeferredLayerUpdater* layerHandle) = 0; 1256f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger virtual void drawRenderNode(uirenderer::RenderNode* renderNode) = 0; 1266f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger virtual void callDrawGLFunction(Functor* functor) = 0; 1276f485569fa3d6047dcffd068aebf361e3598783cDerek Sollenberger 128cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger// ---------------------------------------------------------------------------- 129cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger// Canvas state operations 130cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger// ---------------------------------------------------------------------------- 131eecff56fed5dd5206acfbc5007b4912081b36d3bFlorin Malita 132cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger // Save (layer) 133cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual int getSaveCount() const = 0; 134eecff56fed5dd5206acfbc5007b4912081b36d3bFlorin Malita virtual int save(SaveFlags::Flags flags) = 0; 135cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void restore() = 0; 136cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void restoreToCount(int saveCount) = 0; 137cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 138cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual int saveLayer(float left, float top, float right, float bottom, 139eecff56fed5dd5206acfbc5007b4912081b36d3bFlorin Malita const SkPaint* paint, SaveFlags::Flags flags) = 0; 140cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual int saveLayerAlpha(float left, float top, float right, float bottom, 141eecff56fed5dd5206acfbc5007b4912081b36d3bFlorin Malita int alpha, SaveFlags::Flags flags) = 0; 142cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 143cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger // Matrix 144cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void getMatrix(SkMatrix* outMatrix) const = 0; 145cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void setMatrix(const SkMatrix& matrix) = 0; 146cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 147cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void concat(const SkMatrix& matrix) = 0; 148cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void rotate(float degrees) = 0; 149cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void scale(float sx, float sy) = 0; 150cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void skew(float sx, float sy) = 0; 151cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void translate(float dx, float dy) = 0; 152cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 153cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger // clip 154cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual bool getClipBounds(SkRect* outRect) const = 0; 155cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual bool quickRejectRect(float left, float top, float right, float bottom) const = 0; 156cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual bool quickRejectPath(const SkPath& path) const = 0; 157cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 158c1b33d665c8caf5760f68c45c6ca0baa649b832aJohn Reck virtual bool clipRect(float left, float top, float right, float bottom, 159c1b33d665c8caf5760f68c45c6ca0baa649b832aJohn Reck SkRegion::Op op = SkRegion::kIntersect_Op) = 0; 160cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual bool clipPath(const SkPath* path, SkRegion::Op op) = 0; 161cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual bool clipRegion(const SkRegion* region, SkRegion::Op op) = 0; 162cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 163cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger // filters 164cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual SkDrawFilter* getDrawFilter() = 0; 165cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void setDrawFilter(SkDrawFilter* drawFilter) = 0; 166cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 167cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger// ---------------------------------------------------------------------------- 168cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger// Canvas draw operations 169cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger// ---------------------------------------------------------------------------- 170cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void drawColor(int color, SkXfermode::Mode mode) = 0; 171cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void drawPaint(const SkPaint& paint) = 0; 172cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 173cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger // Geometry 174cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void drawPoint(float x, float y, const SkPaint& paint) = 0; 175386aa031793bb037ec43b6cdbd8908c343cc86cbChris Craik virtual void drawPoints(const float* points, int floatCount, const SkPaint& paint) = 0; 176cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void drawLine(float startX, float startY, float stopX, float stopY, 177cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger const SkPaint& paint) = 0; 178386aa031793bb037ec43b6cdbd8908c343cc86cbChris Craik virtual void drawLines(const float* points, int floatCount, const SkPaint& paint) = 0; 179cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void drawRect(float left, float top, float right, float bottom, 180cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger const SkPaint& paint) = 0; 18194394b3fb048d5349a77b57950ab7f6b6e92ce34Derek Sollenberger virtual void drawRegion(const SkRegion& region, const SkPaint& paint) = 0; 182cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void drawRoundRect(float left, float top, float right, float bottom, 183cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger float rx, float ry, const SkPaint& paint) = 0; 184cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void drawCircle(float x, float y, float radius, const SkPaint& paint) = 0; 185cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void drawOval(float left, float top, float right, float bottom, 186cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger const SkPaint& paint) = 0; 187cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void drawArc(float left, float top, float right, float bottom, 188cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger float startAngle, float sweepAngle, bool useCenter, const SkPaint& paint) = 0; 189cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void drawPath(const SkPath& path, const SkPaint& paint) = 0; 190cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void drawVertices(SkCanvas::VertexMode vertexMode, int vertexCount, 191cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger const float* verts, const float* tex, const int* colors, 192cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger const uint16_t* indices, int indexCount, const SkPaint& paint) = 0; 193cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 194cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger // Bitmap-based 195cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void drawBitmap(const SkBitmap& bitmap, float left, float top, 196cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger const SkPaint* paint) = 0; 197cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void drawBitmap(const SkBitmap& bitmap, const SkMatrix& matrix, 198cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger const SkPaint* paint) = 0; 199cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void drawBitmap(const SkBitmap& bitmap, float srcLeft, float srcTop, 200cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger float srcRight, float srcBottom, float dstLeft, float dstTop, 201cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger float dstRight, float dstBottom, const SkPaint* paint) = 0; 202cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual void drawBitmapMesh(const SkBitmap& bitmap, int meshWidth, int meshHeight, 203cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger const float* vertices, const int* colors, const SkPaint* paint) = 0; 2044c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger virtual void drawNinePatch(const SkBitmap& bitmap, const android::Res_png_9patch& chunk, 2054c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger float dstLeft, float dstTop, float dstRight, float dstBottom, 2064c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger const SkPaint* paint) = 0; 207cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 208cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger // Text 2098dfaa4904205772cdceee63ef3989bcdedf1a914Tom Hudson /** 2108dfaa4904205772cdceee63ef3989bcdedf1a914Tom Hudson * drawText: count is of glyphs 211a1717271caac5e8ea3808c331d4141ac01a42134Chris Craik * totalAdvance: used to define width of text decorations (underlines, strikethroughs). 2128dfaa4904205772cdceee63ef3989bcdedf1a914Tom Hudson */ 213dccca44ffda4836b56a21da95a046c9708ffd49csergeyv virtual void drawGlyphs(const uint16_t* glyphs, const float* positions, int count, 214cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger const SkPaint& paint, float x, float y, 2158dfaa4904205772cdceee63ef3989bcdedf1a914Tom Hudson float boundsLeft, float boundsTop, float boundsRight, float boundsBottom, 2168dfaa4904205772cdceee63ef3989bcdedf1a914Tom Hudson float totalAdvance) = 0; 2178dfaa4904205772cdceee63ef3989bcdedf1a914Tom Hudson /** drawTextOnPath: count is of glyphs */ 218dccca44ffda4836b56a21da95a046c9708ffd49csergeyv virtual void drawGlyphsOnPath(const uint16_t* glyphs, int count, const SkPath& path, 219cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger float hOffset, float vOffset, const SkPaint& paint) = 0; 220cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 2218dfaa4904205772cdceee63ef3989bcdedf1a914Tom Hudson /** 222cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger * Specifies if the positions passed to ::drawText are absolute or relative 223cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger * to the (x,y) value provided. 224cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger * 225cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger * If true the (x,y) values are ignored. Otherwise, those (x,y) values need 226cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger * to be added to each glyph's position to get its absolute position. 227cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger */ 228cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger virtual bool drawTextAbsolutePos() const = 0; 229a1717271caac5e8ea3808c331d4141ac01a42134Chris Craik 230766431aa57c16ece8842287a92b2e7208e3b8ac3Doris Liu /** 231766431aa57c16ece8842287a92b2e7208e3b8ac3Doris Liu * Draws a VectorDrawable onto the canvas. 232766431aa57c16ece8842287a92b2e7208e3b8ac3Doris Liu */ 233766431aa57c16ece8842287a92b2e7208e3b8ac3Doris Liu virtual void drawVectorDrawable(VectorDrawableRoot* tree); 234766431aa57c16ece8842287a92b2e7208e3b8ac3Doris Liu 235dccca44ffda4836b56a21da95a046c9708ffd49csergeyv /** 236dccca44ffda4836b56a21da95a046c9708ffd49csergeyv * Converts utf16 text to glyphs, calculating position and boundary, 237dccca44ffda4836b56a21da95a046c9708ffd49csergeyv * and delegating the final draw to virtual drawGlyphs method. 238dccca44ffda4836b56a21da95a046c9708ffd49csergeyv */ 239dccca44ffda4836b56a21da95a046c9708ffd49csergeyv void drawText(const uint16_t* text, int start, int count, int contextCount, 240bad99183916ba2bac6659efc8a28273e344ba511sergeyv float x, float y, int bidiFlags, const Paint& origPaint, Typeface* typeface); 241dccca44ffda4836b56a21da95a046c9708ffd49csergeyv 242dccca44ffda4836b56a21da95a046c9708ffd49csergeyv void drawTextOnPath(const uint16_t* text, int count, int bidiFlags, const SkPath& path, 243bad99183916ba2bac6659efc8a28273e344ba511sergeyv float hOffset, float vOffset, const Paint& paint, Typeface* typeface); 244dccca44ffda4836b56a21da95a046c9708ffd49csergeyv 245a1717271caac5e8ea3808c331d4141ac01a42134Chris Craikprotected: 246a1717271caac5e8ea3808c331d4141ac01a42134Chris Craik void drawTextDecorations(float x, float y, float length, const SkPaint& paint); 247cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger}; 248cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger 249cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger}; // namespace android 250cae05e0b4c4726236487bdd7c23b82e93f85fd23Derek Sollenberger#endif // ANDROID_GRAPHICS_CANVAS_H 251