SkCanvas.h revision f87ea139deed57504b433fc4e1bf98c85ef0da80
10910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project/* 20910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 30910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project * 40910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 50910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project * you may not use this file except in compliance with the License. 60910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project * You may obtain a copy of the License at 70910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project * 80910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 90910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project * 100910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 110910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 120910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 130910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project * See the License for the specific language governing permissions and 140910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project * limitations under the License. 150910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 160910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 170910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project#ifndef SkCanvas_DEFINED 180910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project#define SkCanvas_DEFINED 190910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 200910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project#include "SkTypes.h" 210910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project#include "SkBitmap.h" 220910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project#include "SkDeque.h" 230910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project#include "SkPaint.h" 240910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project#include "SkRefCnt.h" 250910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project#include "SkPorterDuff.h" 260910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project#include "SkPath.h" 270910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project#include "SkRegion.h" 280910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project#include "SkScalarCompare.h" 290910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 300910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Projectclass SkBounder; 310910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Projectclass SkDevice; 320910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Projectclass SkDraw; 330910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Projectclass SkDrawFilter; 340910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Projectclass SkPicture; 35dab163f0b2658c2dba48839e72f81d3d8ee0ae8bMike Reedclass SkShape; 360910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 370910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project/** \class SkCanvas 380910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 390910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project A Canvas encapsulates all of the state about drawing into a device (bitmap). 400910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project This includes a reference to the device itself, and a stack of matrix/clip 410910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project values. For any given draw call (e.g. drawRect), the geometry of the object 420910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project being drawn is transformed by the concatenation of all the matrices in the 430910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project stack. The transformed geometry is clipped by the intersection of all of 440910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project the clips in the stack. 450910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 460910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project While the Canvas holds the state of the drawing device, the state (style) 470910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project of the object being drawn is held by the Paint, which is provided as a 480910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project parameter to each of the draw() methods. The Paint holds attributes such as 490910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project color, typeface, textSize, strokeWidth, shader (e.g. gradients, patterns), 500910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project etc. 510910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project*/ 520910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Projectclass SkCanvas : public SkRefCnt { 530910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Projectpublic: 540910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Construct a canvas with the specified bitmap to draw into. 550910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param bitmap Specifies a bitmap for the canvas to draw into. Its 560910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project structure are copied to the canvas. 570910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 580910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project explicit SkCanvas(const SkBitmap& bitmap); 590910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Construct a canvas with the specified device to draw into. 600910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param device Specifies a device for the canvas to draw into. The 610910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project device may be null. 620910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 630910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project explicit SkCanvas(SkDevice* device = NULL); 640910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual ~SkCanvas(); 650910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 660910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /////////////////////////////////////////////////////////////////////////// 670910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 680910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** If this subclass of SkCanvas supports GL viewports, return true and set 690910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project size (if not null) to the size of the viewport. If it is not supported, 700910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project ignore vp and return false. 710910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 720910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual bool getViewport(SkIPoint* size) const; 730910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 740910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** If this subclass of SkCanvas supports GL viewports, return true and set 750910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project the viewport to the specified x and y dimensions. If it is not 760910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project supported, ignore x and y and return false. 770910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 780910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual bool setViewport(int x, int y); 790910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 800910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Return the canvas' device object, which may be null. The device holds 810910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project the bitmap of the pixels that the canvas draws into. The reference count 820910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project of the returned device is not changed by this call. 830910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 840910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkDevice* getDevice() const; 850910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 860910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Specify a device for this canvas to draw into. If it is not null, its 870910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project reference count is incremented. If the canvas was already holding a 880910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project device, its reference count is decremented. The new device is returned. 890910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 900910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkDevice* setDevice(SkDevice* device); 910910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 920910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Specify a bitmap for the canvas to draw into. This is a help method for 930910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project setDevice(), and it creates a device for the bitmap by calling 940910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project createDevice(). The structure of the bitmap is copied into the device. 950910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 960910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual SkDevice* setBitmapDevice(const SkBitmap& bitmap); 970910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 980910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /////////////////////////////////////////////////////////////////////////// 990910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 1000910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project enum SaveFlags { 1010910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** save the matrix state, restoring it on restore() */ 1020910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project kMatrix_SaveFlag = 0x01, 1030910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** save the clip state, restoring it on restore() */ 1040910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project kClip_SaveFlag = 0x02, 1050910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** the layer needs to support per-pixel alpha */ 1060910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project kHasAlphaLayer_SaveFlag = 0x04, 1070910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** the layer needs to support 8-bits per color component */ 1080910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project kFullColorLayer_SaveFlag = 0x08, 1090910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** the layer should clip against the bounds argument */ 1100910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project kClipToLayer_SaveFlag = 0x10, 1110910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 1120910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project // helper masks for common choices 1130910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project kMatrixClip_SaveFlag = 0x03, 1140910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project kARGB_NoClipLayer_SaveFlag = 0x0F, 1150910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project kARGB_ClipLayer_SaveFlag = 0x1F 1160910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project }; 1170910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 1180910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** This call saves the current matrix and clip information, and pushes a 1190910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project copy onto a private stack. Subsequent calls to translate, scale, 1200910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project rotate, skew, concat or clipRect, clipPath all operate on this copy. 1210910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project When the balancing call to restore() is made, this copy is deleted and 1220910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project the previous matrix/clip state is restored. 1230910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @return The value to pass to restoreToCount() to balance this save() 1240910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 1250910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual int save(SaveFlags flags = kMatrixClip_SaveFlag); 1260910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 1270910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** This behaves the same as save(), but in addition it allocates an 1280910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project offscreen bitmap. All drawing calls are directed there, and only when 1290910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project the balancing call to restore() is made is that offscreen transfered to 1300910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project the canvas (or the previous layer). Subsequent calls to translate, 1310910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project scale, rotate, skew, concat or clipRect, clipPath all operate on this 1320910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project copy. When the balancing call to restore() is made, this copy is deleted 1330910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project and the previous matrix/clip state is restored. 1340910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param bounds (may be null) the maximum size the offscreen bitmap needs 1350910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project to be (in local coordinates) 1360910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint (may be null) This is copied, and is applied to the 1370910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project offscreen when restore() is called 1380910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param flags LayerFlags 1390910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @return The value to pass to restoreToCount() to balance this save() 1400910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 1410910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual int saveLayer(const SkRect* bounds, const SkPaint* paint, 1420910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SaveFlags flags = kARGB_ClipLayer_SaveFlag); 1430910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 1440910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** This behaves the same as save(), but in addition it allocates an 1450910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project offscreen bitmap. All drawing calls are directed there, and only when 1460910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project the balancing call to restore() is made is that offscreen transfered to 1470910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project the canvas (or the previous layer). Subsequent calls to translate, 1480910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project scale, rotate, skew, concat or clipRect, clipPath all operate on this 1490910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project copy. When the balancing call to restore() is made, this copy is deleted 1500910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project and the previous matrix/clip state is restored. 1510910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param bounds (may be null) the maximum size the offscreen bitmap needs 1520910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project to be (in local coordinates) 1530910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param alpha This is applied to the offscreen when restore() is called. 1540910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param flags LayerFlags 1550910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @return The value to pass to restoreToCount() to balance this save() 1560910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 1570910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project int saveLayerAlpha(const SkRect* bounds, U8CPU alpha, 1580910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SaveFlags flags = kARGB_ClipLayer_SaveFlag); 1590910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 1600910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** This call balances a previous call to save(), and is used to remove all 1610910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project modifications to the matrix/clip state since the last save call. It is 1620910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project an error to call restore() more times than save() was called. 1630910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 1640910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual void restore(); 1650910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 1660910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Returns the number of matrix/clip states on the SkCanvas' private stack. 1670910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project This will equal # save() calls - # restore() calls. 1680910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 1690910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project int getSaveCount() const; 1700910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 1710910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Efficient way to pop any calls to save() that happened after the save 1720910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project count reached saveCount. It is an error for saveCount to be less than 1730910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project getSaveCount() 1740910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param saveCount The number of save() levels to restore from 1750910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 1760910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void restoreToCount(int saveCount); 1770910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 1780910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Preconcat the current matrix with the specified translation 1790910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param dx The distance to translate in X 1800910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param dy The distance to translate in Y 1810910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project returns true if the operation succeeded (e.g. did not overflow) 1820910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 1830910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual bool translate(SkScalar dx, SkScalar dy); 1840910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 1850910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Preconcat the current matrix with the specified scale. 1860910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param sx The amount to scale in X 1870910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param sy The amount to scale in Y 1880910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project returns true if the operation succeeded (e.g. did not overflow) 1890910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 1900910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual bool scale(SkScalar sx, SkScalar sy); 1910910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 1920910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Preconcat the current matrix with the specified rotation. 1930910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param degrees The amount to rotate, in degrees 1940910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project returns true if the operation succeeded (e.g. did not overflow) 1950910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 1960910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual bool rotate(SkScalar degrees); 1970910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 1980910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Preconcat the current matrix with the specified skew. 1990910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param sx The amount to skew in X 2000910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param sy The amount to skew in Y 2010910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project returns true if the operation succeeded (e.g. did not overflow) 2020910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 2030910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual bool skew(SkScalar sx, SkScalar sy); 2040910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 2050910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Preconcat the current matrix with the specified matrix. 2060910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param matrix The matrix to preconcatenate with the current matrix 2070910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @return true if the operation succeeded (e.g. did not overflow) 2080910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 2090910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual bool concat(const SkMatrix& matrix); 2100910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 2110910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Replace the current matrix with a copy of the specified matrix. 2120910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param matrix The matrix that will be copied into the current matrix. 2130910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 2140910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual void setMatrix(const SkMatrix& matrix); 2150910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 2160910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Helper for setMatrix(identity). Sets the current matrix to identity. 2170910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 2180910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void resetMatrix(); 2190910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 2200910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Modify the current clip with the specified rectangle. 2210910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param rect The rect to intersect with the current clip 2220910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param op The region op to apply to the current clip 2230910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @return true if the canvas' clip is non-empty 2240910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 2250910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual bool clipRect(const SkRect& rect, 2260910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkRegion::Op op = SkRegion::kIntersect_Op); 2270910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 2280910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Modify the current clip with the specified path. 2290910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param path The path to apply to the current clip 2300910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param op The region op to apply to the current clip 2310910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @return true if the canvas' new clip is non-empty 2320910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 2330910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual bool clipPath(const SkPath& path, 2340910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkRegion::Op op = SkRegion::kIntersect_Op); 2350910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 2360910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Modify the current clip with the specified region. Note that unlike 2370910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project clipRect() and clipPath() which transform their arguments by the current 2380910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project matrix, clipRegion() assumes its argument is already in device 2390910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project coordinates, and so no transformation is performed. 2400910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param deviceRgn The region to apply to the current clip 2410910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param op The region op to apply to the current clip 2420910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @return true if the canvas' new clip is non-empty 2430910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 2440910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual bool clipRegion(const SkRegion& deviceRgn, 2450910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkRegion::Op op = SkRegion::kIntersect_Op); 2460910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 2470910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Helper for clipRegion(rgn, kReplace_Op). Sets the current clip to the 2480910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project specified region. This does not intersect or in any other way account 2490910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project for the existing clip region. 2500910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param deviceRgn The region to copy into the current clip. 2510910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @return true if the new clip region is non-empty 2520910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 2530910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project bool setClipRegion(const SkRegion& deviceRgn) { 2540910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project return this->clipRegion(deviceRgn, SkRegion::kReplace_Op); 2550910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project } 2560910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 2570910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Enum describing how to treat edges when performing quick-reject tests 2580910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project of a geometry against the current clip. Treating them as antialiased 2590910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project (kAA_EdgeType) will take into account the extra pixels that may be drawn 2600910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project if the edge does not lie exactly on a device pixel boundary (after being 2610910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project transformed by the current matrix). 2620910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 2630910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project enum EdgeType { 2640910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Treat the edges as B&W (not antialiased) for the purposes of testing 2650910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project against the current clip 2660910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 2670910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project kBW_EdgeType, 2680910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Treat the edges as antialiased for the purposes of testing 2690910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project against the current clip 2700910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 2710910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project kAA_EdgeType 2720910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project }; 2730910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 2740910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Return true if the specified rectangle, after being transformed by the 2750910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project current matrix, would lie completely outside of the current clip. Call 2760910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project this to check if an area you intend to draw into is clipped out (and 2770910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project therefore you can skip making the draw calls). 2780910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param rect the rect to compare with the current clip 2790910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param et specifies how to treat the edges (see EdgeType) 2800910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @return true if the rect (transformed by the canvas' matrix) does not 2810910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project intersect with the canvas' clip 2820910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 2830910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project bool quickReject(const SkRect& rect, EdgeType et) const; 2840910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 2850910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Return true if the specified path, after being transformed by the 2860910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project current matrix, would lie completely outside of the current clip. Call 2870910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project this to check if an area you intend to draw into is clipped out (and 2880910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project therefore you can skip making the draw calls). Note, for speed it may 2890910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project return false even if the path itself might not intersect the clip 2900910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project (i.e. the bounds of the path intersects, but the path does not). 2910910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param path The path to compare with the current clip 2920910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param et specifies how to treat the edges (see EdgeType) 2930910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @return true if the path (transformed by the canvas' matrix) does not 2940910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project intersect with the canvas' clip 2950910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 2960910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project bool quickReject(const SkPath& path, EdgeType et) const; 2970910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 2980910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Return true if the horizontal band specified by top and bottom is 2990910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project completely clipped out. This is a conservative calculation, meaning 3000910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project that it is possible that if the method returns false, the band may still 3010910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project in fact be clipped out, but the converse is not true. If this method 3020910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project returns true, then the band is guaranteed to be clipped out. 3030910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param top The top of the horizontal band to compare with the clip 3040910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param bottom The bottom of the horizontal and to compare with the clip 3050910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @return true if the horizontal band is completely clipped out (i.e. does 3060910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project not intersect the current clip) 3070910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 3080910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project bool quickRejectY(SkScalar top, SkScalar bottom, EdgeType et) const; 3090910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 3100910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Return the bounds of the current clip (in local coordinates) in the 3110910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project bounds parameter, and return true if it is non-empty. This can be useful 3120910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project in a way similar to quickReject, in that it tells you that drawing 3130910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project outside of these bounds will be clipped out. 3140910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 3150910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project bool getClipBounds(SkRect* bounds, EdgeType et = kAA_EdgeType) const; 3160910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 3170910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Fill the entire canvas' bitmap (restricted to the current clip) with the 3180910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project specified ARGB color, using the specified PorterDuff mode. 3190910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param a the alpha component (0..255) of the color to fill the canvas 3200910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param r the red component (0..255) of the color to fill the canvas 3210910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param g the green component (0..255) of the color to fill the canvas 3220910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param b the blue component (0..255) of the color to fill the canvas 3230910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param mode the mode to apply the color in (defaults to SrcOver) 3240910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 3250910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void drawARGB(U8CPU a, U8CPU r, U8CPU g, U8CPU b, 3260910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkPorterDuff::Mode mode = SkPorterDuff::kSrcOver_Mode); 3270910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 3280910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Fill the entire canvas' bitmap (restricted to the current clip) with the 3290910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project specified color and porter-duff xfermode. 3300910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param color the color to draw with 3310910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param mode the mode to apply the color in (defaults to SrcOver) 3320910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 3330910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void drawColor(SkColor color, 3340910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkPorterDuff::Mode mode = SkPorterDuff::kSrcOver_Mode); 3350910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 3360910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Fill the entire canvas' bitmap (restricted to the current clip) with the 3370910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project specified paint. 3380910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint The paint used to fill the canvas 3390910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 3400910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual void drawPaint(const SkPaint& paint); 3410910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 3420910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project enum PointMode { 3430910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** drawPoints draws each point separately */ 3440910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project kPoints_PointMode, 3450910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** drawPoints draws each pair of points as a line segment */ 3460910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project kLines_PointMode, 3470910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** drawPoints draws the array of points as a polygon */ 3480910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project kPolygon_PointMode 3490910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project }; 3500910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 3510910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draw a series of points, interpreted based on the PointMode mode. For 3520910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project all modes, the count parameter is interpreted as the total number of 3530910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project points. For kLine mode, count/2 line segments are drawn. 3540910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project For kPoint mode, each point is drawn centered at its coordinate, and its 3550910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project size is specified by the paint's stroke-width. It draws as a square, 3560910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project unless the paint's cap-type is round, in which the points are drawn as 3570910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project circles. 3580910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project For kLine mode, each pair of points is drawn as a line segment, 3590910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project respecting the paint's settings for cap/join/width. 3600910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project For kPolygon mode, the entire array is drawn as a series of connected 3610910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project line segments. 3620910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project Note that, while similar, kLine and kPolygon modes draw slightly 3630910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project differently than the equivalent path built with a series of moveto, 3640910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project lineto calls, in that the path will draw all of its contours at once, 3650910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project with no interactions if contours intersect each other (think XOR 3660910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project xfermode). drawPoints always draws each element one at a time. 3670910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param mode PointMode specifying how to draw the array of points. 3680910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param count The number of points in the array 3690910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param pts Array of points to draw 3700910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint The paint used to draw the points 3710910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 3720910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual void drawPoints(PointMode mode, size_t count, const SkPoint pts[], 3730910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkPaint& paint); 3740910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 3750910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Helper method for drawing a single point. See drawPoints() for a more 3760910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project details. 3770910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 3780910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void drawPoint(SkScalar x, SkScalar y, const SkPaint& paint); 3790910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 3800910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draws a single pixel in the specified color. 3810910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param x The X coordinate of which pixel to draw 3820910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param y The Y coordiante of which pixel to draw 3830910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param color The color to draw 3840910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 3850910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void drawPoint(SkScalar x, SkScalar y, SkColor color); 3860910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 3870910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draw a line segment with the specified start and stop x,y coordinates, 3880910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project using the specified paint. NOTE: since a line is always "framed", the 3890910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project paint's Style is ignored. 3900910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param x0 The x-coordinate of the start point of the line 3910910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param y0 The y-coordinate of the start point of the line 3920910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param x1 The x-coordinate of the end point of the line 3930910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param y1 The y-coordinate of the end point of the line 3940910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint The paint used to draw the line 3950910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 3960910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void drawLine(SkScalar x0, SkScalar y0, SkScalar x1, SkScalar y1, 3970910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkPaint& paint); 3980910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 3990910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draw the specified rectangle using the specified paint. The rectangle 4000910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project will be filled or stroked based on the Style in the paint. 4010910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param rect The rect to be drawn 4020910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint The paint used to draw the rect 4030910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 4040910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual void drawRect(const SkRect& rect, const SkPaint& paint); 4050910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 4060910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draw the specified rectangle using the specified paint. The rectangle 4070910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project will be filled or framed based on the Style in the paint. 4080910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param rect The rect to be drawn 4090910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint The paint used to draw the rect 4100910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 4110910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void drawIRect(const SkIRect& rect, const SkPaint& paint) 4120910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project { 4130910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkRect r; 4140910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project r.set(rect); // promotes the ints to scalars 4150910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project this->drawRect(r, paint); 4160910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project } 4170910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 4180910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draw the specified rectangle using the specified paint. The rectangle 4190910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project will be filled or framed based on the Style in the paint. 4200910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param left The left side of the rectangle to be drawn 4210910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param top The top side of the rectangle to be drawn 4220910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param right The right side of the rectangle to be drawn 4230910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param bottom The bottom side of the rectangle to be drawn 4240910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint The paint used to draw the rect 4250910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 4260910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void drawRectCoords(SkScalar left, SkScalar top, SkScalar right, 4270910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkScalar bottom, const SkPaint& paint); 4280910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 4290910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draw the specified oval using the specified paint. The oval will be 4300910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project filled or framed based on the Style in the paint. 4310910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param oval The rectangle bounds of the oval to be drawn 4320910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint The paint used to draw the oval 4330910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 4340910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void drawOval(const SkRect& oval, const SkPaint&); 4350910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 4360910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draw the specified circle using the specified paint. If radius is <= 0, 4370910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project then nothing will be drawn. The circle will be filled 4380910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project or framed based on the Style in the paint. 4390910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param cx The x-coordinate of the center of the cirle to be drawn 4400910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param cy The y-coordinate of the center of the cirle to be drawn 4410910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param radius The radius of the cirle to be drawn 4420910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint The paint used to draw the circle 4430910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 4440910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void drawCircle(SkScalar cx, SkScalar cy, SkScalar radius, 4450910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkPaint& paint); 4460910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 4470910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draw the specified arc, which will be scaled to fit inside the 4480910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project specified oval. If the sweep angle is >= 360, then the oval is drawn 4490910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project completely. Note that this differs slightly from SkPath::arcTo, which 4500910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project treats the sweep angle mod 360. 4510910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param oval The bounds of oval used to define the shape of the arc 4520910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param startAngle Starting angle (in degrees) where the arc begins 4530910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param sweepAngle Sweep angle (in degrees) measured clockwise 4540910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param useCenter true means include the center of the oval. For filling 4550910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project this will draw a wedge. False means just use the arc. 4560910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint The paint used to draw the arc 4570910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 4580910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void drawArc(const SkRect& oval, SkScalar startAngle, SkScalar sweepAngle, 4590910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project bool useCenter, const SkPaint& paint); 4600910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 4610910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draw the specified round-rect using the specified paint. The round-rect 4620910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project will be filled or framed based on the Style in the paint. 4630910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param rect The rectangular bounds of the roundRect to be drawn 4640910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param rx The x-radius of the oval used to round the corners 4650910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param ry The y-radius of the oval used to round the corners 4660910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint The paint used to draw the roundRect 4670910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 4680910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void drawRoundRect(const SkRect& rect, SkScalar rx, SkScalar ry, 4690910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkPaint& paint); 4700910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 4710910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draw the specified path using the specified paint. The path will be 4720910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project filled or framed based on the Style in the paint. 4730910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param path The path to be drawn 4740910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint The paint used to draw the path 4750910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 4760910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual void drawPath(const SkPath& path, const SkPaint& paint); 4770910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 4780910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draw the specified bitmap, with its top/left corner at (x,y), using the 4790910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project specified paint, transformed by the current matrix. Note: if the paint 4800910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project contains a maskfilter that generates a mask which extends beyond the 4810910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project bitmap's original width/height, then the bitmap will be drawn as if it 4820910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project were in a Shader with CLAMP mode. Thus the color outside of the original 4830910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project width/height will be the edge color replicated. 4840910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param bitmap The bitmap to be drawn 4850910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param left The position of the left side of the bitmap being drawn 4860910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param top The position of the top side of the bitmap being drawn 4870910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint The paint used to draw the bitmap, or NULL 4880910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 4890910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual void drawBitmap(const SkBitmap& bitmap, SkScalar left, SkScalar top, 4900910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkPaint* paint = NULL); 4910910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 4920910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draw the specified bitmap, with the specified matrix applied (before the 4930910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project canvas' matrix is applied). 4940910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param bitmap The bitmap to be drawn 4950910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param src Optional: specify the subset of the bitmap to be drawn 4960910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param dst The destination rectangle where the scaled/translated 4970910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project image will be drawn 4980910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint The paint used to draw the bitmap, or NULL 4990910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 5000910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual void drawBitmapRect(const SkBitmap& bitmap, const SkIRect* src, 5010910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkRect& dst, const SkPaint* paint = NULL); 5020910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 5030910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual void drawBitmapMatrix(const SkBitmap& bitmap, const SkMatrix& m, 5040910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkPaint* paint = NULL); 5050910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 5060910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draw the specified bitmap, with its top/left corner at (x,y), 5070910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project NOT transformed by the current matrix. Note: if the paint 5080910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project contains a maskfilter that generates a mask which extends beyond the 5090910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project bitmap's original width/height, then the bitmap will be drawn as if it 5100910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project were in a Shader with CLAMP mode. Thus the color outside of the original 5110910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project width/height will be the edge color replicated. 5120910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param bitmap The bitmap to be drawn 5130910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param left The position of the left side of the bitmap being drawn 5140910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param top The position of the top side of the bitmap being drawn 5150910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint The paint used to draw the bitmap, or NULL 5160910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 5170910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual void drawSprite(const SkBitmap& bitmap, int left, int top, 5180910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkPaint* paint = NULL); 5190910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 5200910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draw the text, with origin at (x,y), using the specified paint. 5210910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project The origin is interpreted based on the Align setting in the paint. 5220910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param text The text to be drawn 5230910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param byteLength The number of bytes to read from the text parameter 5240910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param x The x-coordinate of the origin of the text being drawn 5250910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param y The y-coordinate of the origin of the text being drawn 5260910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint The paint used for the text (e.g. color, size, style) 5270910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 5280910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual void drawText(const void* text, size_t byteLength, SkScalar x, 5290910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkScalar y, const SkPaint& paint); 5300910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 5310910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draw the text, with each character/glyph origin specified by the pos[] 5320910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project array. The origin is interpreted by the Align setting in the paint. 5330910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param text The text to be drawn 5340910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param byteLength The number of bytes to read from the text parameter 5350910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param pos Array of positions, used to position each character 5360910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint The paint used for the text (e.g. color, size, style) 5370910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 5380910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual void drawPosText(const void* text, size_t byteLength, 5390910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkPoint pos[], const SkPaint& paint); 5400910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 5410910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draw the text, with each character/glyph origin specified by the x 5420910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project coordinate taken from the xpos[] array, and the y from the constY param. 5430910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project The origin is interpreted by the Align setting in the paint. 5440910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param text The text to be drawn 5450910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param byteLength The number of bytes to read from the text parameter 5460910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param xpos Array of x-positions, used to position each character 5470910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param constY The shared Y coordinate for all of the positions 5480910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint The paint used for the text (e.g. color, size, style) 5490910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 5500910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual void drawPosTextH(const void* text, size_t byteLength, 5510910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkScalar xpos[], SkScalar constY, 5520910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkPaint& paint); 5530910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 5540910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draw the text, with origin at (x,y), using the specified paint, along 5550910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project the specified path. The paint's Align setting determins where along the 5560910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project path to start the text. 5570910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param text The text to be drawn 5580910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param byteLength The number of bytes to read from the text parameter 5590910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param path The path the text should follow for its baseline 5600910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param hOffset The distance along the path to add to the text's 5610910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project starting position 5620910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param vOffset The distance above(-) or below(+) the path to 5630910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project position the text 5640910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint The paint used for the text 5650910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 5660910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void drawTextOnPathHV(const void* text, size_t byteLength, 5670910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkPath& path, SkScalar hOffset, 5680910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkScalar vOffset, const SkPaint& paint); 5690910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 5700910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draw the text, with origin at (x,y), using the specified paint, along 5710910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project the specified path. The paint's Align setting determins where along the 5720910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project path to start the text. 5730910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param text The text to be drawn 5740910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param byteLength The number of bytes to read from the text parameter 5750910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param path The path the text should follow for its baseline 5760910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param matrix (may be null) Applied to the text before it is 5770910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project mapped onto the path 5780910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint The paint used for the text 5790910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 5800910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual void drawTextOnPath(const void* text, size_t byteLength, 5810910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkPath& path, const SkMatrix* matrix, 5820910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkPaint& paint); 5830910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 5840910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draw the picture into this canvas. This method effective brackets the 5850910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project playback of the picture's draw calls with save/restore, so the state 5860910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project of this canvas will be unchanged after this call. This contrasts with 5870910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project the more immediate method SkPicture::draw(), which does not bracket 5880910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project the canvas with save/restore, thus the canvas may be left in a changed 5890910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project state after the call. 5900910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param picture The recorded drawing commands to playback into this 5910910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project canvas. 5920910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 5930910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual void drawPicture(SkPicture& picture); 5940910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 595dab163f0b2658c2dba48839e72f81d3d8ee0ae8bMike Reed /** Draws the specified shape 596dab163f0b2658c2dba48839e72f81d3d8ee0ae8bMike Reed */ 597dab163f0b2658c2dba48839e72f81d3d8ee0ae8bMike Reed virtual void drawShape(SkShape*); 598dab163f0b2658c2dba48839e72f81d3d8ee0ae8bMike Reed 5990910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project enum VertexMode { 6000910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project kTriangles_VertexMode, 6010910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project kTriangleStrip_VertexMode, 6020910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project kTriangleFan_VertexMode 6030910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project }; 6040910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 6050910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Draw the array of vertices, interpreted as triangles (based on mode). 6060910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param vmode How to interpret the array of vertices 6070910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param vertexCount The number of points in the vertices array (and 6080910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project corresponding texs and colors arrays if non-null) 6090910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param vertices Array of vertices for the mesh 6100910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param texs May be null. If not null, specifies the coordinate 6110910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project in texture space for each vertex. 6120910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param colors May be null. If not null, specifies a color for each 6130910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project vertex, to be interpolated across the triangle. 6140910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param xmode Used if both texs and colors are present. In this 6150910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project case the colors are combined with the texture using mode, 6160910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project before being drawn using the paint. If mode is null, then 6170910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project the porter-duff MULTIPLY mode is used. 6180910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param indices If not null, array of indices to reference into the 6190910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project vertex (texs, colors) array. 6200910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param indexCount number of entries in the indices array (if not null) 6210910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param paint Specifies the shader/texture if present. 6220910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 6230910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual void drawVertices(VertexMode vmode, int vertexCount, 6240910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkPoint vertices[], const SkPoint texs[], 6250910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkColor colors[], SkXfermode* xmode, 6260910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const uint16_t indices[], int indexCount, 6270910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkPaint& paint); 6280910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 6290910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project ////////////////////////////////////////////////////////////////////////// 6300910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 6310910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Get the current bounder object. 6320910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project The bounder's reference count is unchaged. 6330910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @return the canva's bounder (or NULL). 6340910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 6350910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkBounder* getBounder() const { return fBounder; } 6360910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 6370910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Set a new bounder (or NULL). 6380910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project Pass NULL to clear any previous bounder. 6390910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project As a convenience, the parameter passed is also returned. 6400910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project If a previous bounder exists, its reference count is decremented. 6410910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project If bounder is not NULL, its reference count is incremented. 6420910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param bounder the new bounder (or NULL) to be installed in the canvas 6430910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @return the set bounder object 6440910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 6450910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual SkBounder* setBounder(SkBounder* bounder); 6460910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 6470910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Get the current filter object. The filter's reference count is not 6480910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project affected. The filter is part of the state this is affected by 6490910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project save/restore. 6500910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @return the canvas' filter (or NULL). 6510910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 6520910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkDrawFilter* getDrawFilter() const; 6530910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 6540910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Set the new filter (or NULL). Pass NULL to clear any existing filter. 6550910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project As a convenience, the parameter is returned. If an existing filter 6560910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project exists, its refcnt is decrement. If the new filter is not null, its 6570910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project refcnt is incremented. The filter is part of the state this is affected 6580910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project by save/restore. 6590910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @param filter the new filter (or NULL) 6600910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @return the new filter 6610910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 6620910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual SkDrawFilter* setDrawFilter(SkDrawFilter* filter); 6630910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 6640910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project ////////////////////////////////////////////////////////////////////////// 6650910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 6660910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Return the current matrix on the canvas. 6670910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project This does not account for the translate in any of the devices. 6680910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @return The current matrix on the canvas. 6690910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 6700910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkMatrix& getTotalMatrix() const; 6710910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 6720910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Return the current device clip (concatenation of all clip calls). 6730910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project This does not account for the translate in any of the devices. 6740910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project @return the current device clip (concatenation of all clip calls). 6750910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 6760910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkRegion& getTotalClip() const; 6770910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 6780910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** May be overridden by subclasses. This returns a compatible device 6790910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project for this canvas, with the specified config/width/height. If isOpaque 6800910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project is true, then the underlying bitmap is optimized to assume that every 6810910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project pixel will be drawn to, and thus it does not need to clear the alpha 6820910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project channel ahead of time (assuming the specified config supports per-pixel 6830910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project alpha.) If isOpaque is false, then the bitmap should clear its alpha 6840910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project channel. 6850910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 6860910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual SkDevice* createDevice(SkBitmap::Config, int width, int height, 6870910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project bool isOpaque, bool isForLayer); 6880910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 6890910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /////////////////////////////////////////////////////////////////////////// 6900910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 6910910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** After calling saveLayer(), there can be any number of devices that make 6920910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project up the top-most drawing area. LayerIter can be used to iterate through 6930910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project those devices. Note that the iterator is only valid until the next API 6940910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project call made on the canvas. Ownership of all pointers in the iterator stays 6950910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project with the canvas, so none of them should be modified or deleted. 6960910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 6970910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project class LayerIter /*: SkNoncopyable*/ { 6980910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project public: 6990910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Initialize iterator with canvas, and set values for 1st device */ 7000910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project LayerIter(SkCanvas*, bool skipEmptyClips); 7010910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project ~LayerIter(); 7020910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 7030910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Return true if the iterator is done */ 7040910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project bool done() const { return fDone; } 7050910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /** Cycle to the next device */ 7060910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void next(); 7070910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 7080910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project // These reflect the current device in the iterator 7090910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 7100910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkDevice* device() const; 7110910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkMatrix& matrix() const; 7120910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkRegion& clip() const; 7130910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkPaint& paint() const; 7140910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project int x() const; 7150910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project int y() const; 7160910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 7170910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project private: 7180910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project // used to embed the SkDrawIter object directly in our instance, w/o 7190910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project // having to expose that class def to the public. There is an assert 7200910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project // in our constructor to ensure that fStorage is large enough 7210910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project // (though needs to be a compile-time-assert!). We use intptr_t to work 7220910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project // safely with 32 and 64 bit machines (to ensure the storage is enough) 7230910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project intptr_t fStorage[12]; 7240910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project class SkDrawIter* fImpl; // this points at fStorage 7250910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkPaint fDefaultPaint; 7260910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project bool fDone; 7270910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project }; 7280910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 7290910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Projectprotected: 7300910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project // all of the drawBitmap variants call this guy 7310910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project virtual void commonDrawBitmap(const SkBitmap&, const SkMatrix& m, 7320910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkPaint& paint); 7330910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 7340910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Projectprivate: 7350910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project class MCRec; 7360910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 7370910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkDeque fMCStack; 7380910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project // points to top of stack 7390910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project MCRec* fMCRec; 7400910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project // the first N recs that can fit here mean we won't call malloc 7410910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project uint32_t fMCRecStorage[32]; 7420910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 7430910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkBounder* fBounder; 744f87ea139deed57504b433fc4e1bf98c85ef0da80Mike Reed SkDevice* fLastDeviceToGainFocus; 7450910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 7460910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void prepareForDeviceDraw(SkDevice*); 7470910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 7480910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project bool fDeviceCMDirty; // cleared by updateDeviceCMCache() 7490910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void updateDeviceCMCache(); 7500910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 7510910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project friend class SkDrawIter; // needs setupDrawForLayerDevice() 7520910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 7530910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkDevice* init(SkDevice*); 7540910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void internalDrawBitmap(const SkBitmap&, const SkMatrix& m, 7550910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkPaint* paint); 7560910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void drawDevice(SkDevice*, int x, int y, const SkPaint*); 7570910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project // shared by save() and saveLayer() 7580910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project int internalSave(SaveFlags flags); 7590910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void internalRestore(); 7600910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 7610910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project /* These maintain a cache of the clip bounds in local coordinates, 7620910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project (converted to 2s-compliment if floats are slow). 7630910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project */ 7640910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project mutable SkRectCompareType fLocalBoundsCompareType; 7650910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project mutable bool fLocalBoundsCompareTypeDirty; 7660910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 7670910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project const SkRectCompareType& getLocalClipBoundsCompareType() const { 7680910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project if (fLocalBoundsCompareTypeDirty) { 7690910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project this->computeLocalClipBoundsCompareType(); 7700910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project fLocalBoundsCompareTypeDirty = false; 7710910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project } 7720910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project return fLocalBoundsCompareType; 7730910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project } 7740910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project void computeLocalClipBoundsCompareType() const; 7750910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project}; 7760910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 7770910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project/** Stack helper class to automatically call restoreToCount() on the canvas 7780910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project when this object goes out of scope. Use this to guarantee that the canvas 7790910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project is restored to a known state. 7800910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project*/ 7810910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Projectclass SkAutoCanvasRestore : SkNoncopyable { 7820910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Projectpublic: 7830910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkAutoCanvasRestore(SkCanvas* canvas, bool doSave) : fCanvas(canvas) { 7840910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkASSERT(canvas); 7850910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project fSaveCount = canvas->getSaveCount(); 7860910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project if (doSave) { 7870910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project canvas->save(); 7880910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project } 7890910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project } 7900910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project ~SkAutoCanvasRestore() { 7910910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project fCanvas->restoreToCount(fSaveCount); 7920910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project } 7930910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 7940910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Projectprivate: 7950910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project SkCanvas* fCanvas; 7960910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project int fSaveCount; 7970910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project}; 7980910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 7990910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project#endif 8000910916c0f7b951ee55c4b7c6358295b9bca0565The Android Open Source Project 801