SkCanvas.h revision 1f90287df3129cb267422e482c52ebeca6a8990f
1ec3ed6a5ebf6f2c406d7bcf94b6bc34fcaeb976eepoger@google.com 28a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com/* 3ec3ed6a5ebf6f2c406d7bcf94b6bc34fcaeb976eepoger@google.com * Copyright 2006 The Android Open Source Project 48a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com * 5ec3ed6a5ebf6f2c406d7bcf94b6bc34fcaeb976eepoger@google.com * Use of this source code is governed by a BSD-style license that can be 6ec3ed6a5ebf6f2c406d7bcf94b6bc34fcaeb976eepoger@google.com * found in the LICENSE file. 78a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 88a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 9ec3ed6a5ebf6f2c406d7bcf94b6bc34fcaeb976eepoger@google.com 108a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com#ifndef SkCanvas_DEFINED 118a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com#define SkCanvas_DEFINED 128a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 138a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com#include "SkTypes.h" 148a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com#include "SkBitmap.h" 158a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com#include "SkDeque.h" 165c3d1471e4908706cd053a5e2ea9ded3a6c2eaebreed@google.com#include "SkClipStack.h" 178a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com#include "SkPaint.h" 188a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com#include "SkRefCnt.h" 198a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com#include "SkPath.h" 208a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com#include "SkRegion.h" 218a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com#include "SkScalarCompare.h" 22845fdaca174f4675e9acc164b510e3a5ffa9053creed@android.com#include "SkXfermode.h" 238a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 248a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.comclass SkBounder; 258a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.comclass SkDevice; 268a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.comclass SkDraw; 278a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.comclass SkDrawFilter; 288a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.comclass SkPicture; 298a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 308a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com/** \class SkCanvas 318a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 328a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com A Canvas encapsulates all of the state about drawing into a device (bitmap). 338a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com This includes a reference to the device itself, and a stack of matrix/clip 348a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com values. For any given draw call (e.g. drawRect), the geometry of the object 358a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com being drawn is transformed by the concatenation of all the matrices in the 368a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com stack. The transformed geometry is clipped by the intersection of all of 378a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com the clips in the stack. 388a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 398a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com While the Canvas holds the state of the drawing device, the state (style) 408a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com of the object being drawn is held by the Paint, which is provided as a 418a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com parameter to each of the draw() methods. The Paint holds attributes such as 428a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com color, typeface, textSize, strokeWidth, shader (e.g. gradients, patterns), 438a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com etc. 448a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com*/ 457ffb1b21abcc7bbed5a0fc711f6dd7b9dbb4f577ctguil@chromium.orgclass SK_API SkCanvas : public SkRefCnt { 468a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.compublic: 47cde92111d50a96b6d0f3e166fbac7c9bc6eca349reed@google.com SkCanvas(); 488d84fac294682647694b0d2d8a87ac2bd19b6aabvandebo@chromium.org 496dc745506e6d6cc0936fed4de24443dc1ecb5a34reed@google.com /** Construct a canvas with the specified device to draw into. 50e97f0856a8044866b12527819d14cdfbcdfd96f2bsalomon@google.com 518d84fac294682647694b0d2d8a87ac2bd19b6aabvandebo@chromium.org @param device Specifies a device for the canvas to draw into. 528d84fac294682647694b0d2d8a87ac2bd19b6aabvandebo@chromium.org */ 538d84fac294682647694b0d2d8a87ac2bd19b6aabvandebo@chromium.org explicit SkCanvas(SkDevice* device); 548d84fac294682647694b0d2d8a87ac2bd19b6aabvandebo@chromium.org 558d84fac294682647694b0d2d8a87ac2bd19b6aabvandebo@chromium.org /** Deprecated - Construct a canvas with the specified bitmap to draw into. 568a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param bitmap Specifies a bitmap for the canvas to draw into. Its 578a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com structure are copied to the canvas. 588a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 598a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com explicit SkCanvas(const SkBitmap& bitmap); 608a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual ~SkCanvas(); 618a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 628a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /////////////////////////////////////////////////////////////////////////// 638a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 64210ce003a5ec039dda80de0569fb47ca4efc4dc7reed@google.com /** 65bf6c1e4aff4d233f6502157fb73459cf69d0ab37junov@chromium.org * Trigger the immediate execution of all pending draw operations. 66bf6c1e4aff4d233f6502157fb73459cf69d0ab37junov@chromium.org */ 67bf6c1e4aff4d233f6502157fb73459cf69d0ab37junov@chromium.org void flush(); 68bf6c1e4aff4d233f6502157fb73459cf69d0ab37junov@chromium.org 69bf6c1e4aff4d233f6502157fb73459cf69d0ab37junov@chromium.org /** 70210ce003a5ec039dda80de0569fb47ca4efc4dc7reed@google.com * Return the width/height of the underlying device. The current drawable 71210ce003a5ec039dda80de0569fb47ca4efc4dc7reed@google.com * area may be small (due to clipping or saveLayer). For a canvas with 72210ce003a5ec039dda80de0569fb47ca4efc4dc7reed@google.com * no device, 0,0 will be returned. 73210ce003a5ec039dda80de0569fb47ca4efc4dc7reed@google.com */ 74210ce003a5ec039dda80de0569fb47ca4efc4dc7reed@google.com SkISize getDeviceSize() const; 75210ce003a5ec039dda80de0569fb47ca4efc4dc7reed@google.com 768a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Return the canvas' device object, which may be null. The device holds 778a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com the bitmap of the pixels that the canvas draws into. The reference count 788a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com of the returned device is not changed by this call. 798a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 808a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkDevice* getDevice() const; 818a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 828a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Specify a device for this canvas to draw into. If it is not null, its 838a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com reference count is incremented. If the canvas was already holding a 848a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com device, its reference count is decremented. The new device is returned. 858a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 864370aedf7f55af74e9ebb4ad1c2e010c08236dfajunov@google.com virtual SkDevice* setDevice(SkDevice* device); 878d84fac294682647694b0d2d8a87ac2bd19b6aabvandebo@chromium.org 889266fed56a46a4edc710a52c7be8d46fd7c2bc7areed@google.com /** 899266fed56a46a4edc710a52c7be8d46fd7c2bc7areed@google.com * saveLayer() can create another device (which is later drawn onto 909266fed56a46a4edc710a52c7be8d46fd7c2bc7areed@google.com * the previous device). getTopDevice() returns the top-most device current 919266fed56a46a4edc710a52c7be8d46fd7c2bc7areed@google.com * installed. Note that this can change on other calls like save/restore, 929266fed56a46a4edc710a52c7be8d46fd7c2bc7areed@google.com * so do not access this device after subsequent canvas calls. 939266fed56a46a4edc710a52c7be8d46fd7c2bc7areed@google.com * The reference count of the device is not changed. 940b53d59a24f667350b4282f88470713902409030reed@google.com * 950b53d59a24f667350b4282f88470713902409030reed@google.com * @param updateMatrixClip If this is true, then before the device is 960b53d59a24f667350b4282f88470713902409030reed@google.com * returned, we ensure that its has been notified about the current 970b53d59a24f667350b4282f88470713902409030reed@google.com * matrix and clip. Note: this happens automatically when the device 980b53d59a24f667350b4282f88470713902409030reed@google.com * is drawn to, but is optional here, as there is a small perf hit 990b53d59a24f667350b4282f88470713902409030reed@google.com * sometimes. 1009266fed56a46a4edc710a52c7be8d46fd7c2bc7areed@google.com */ 1010b53d59a24f667350b4282f88470713902409030reed@google.com SkDevice* getTopDevice(bool updateMatrixClip = false) const; 1029266fed56a46a4edc710a52c7be8d46fd7c2bc7areed@google.com 103f2b98d67dcb6fcb3120feede9c72016fc7b3ead8reed@android.com /** 104f2b98d67dcb6fcb3120feede9c72016fc7b3ead8reed@android.com * Create a new raster device and make it current. This also returns 105f2b98d67dcb6fcb3120feede9c72016fc7b3ead8reed@android.com * the new device. 106f2b98d67dcb6fcb3120feede9c72016fc7b3ead8reed@android.com */ 107af951c9bc4cbb6e60b430194fe5127ebe99c53fbreed@google.com SkDevice* setBitmapDevice(const SkBitmap& bitmap); 1088a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 10951df9e3fe3c1aec370854b2718df16fc02faa1b2reed@google.com /** 110cde92111d50a96b6d0f3e166fbac7c9bc6eca349reed@google.com * Shortcut for getDevice()->createCompatibleDevice(...). 111cde92111d50a96b6d0f3e166fbac7c9bc6eca349reed@google.com * If getDevice() == NULL, this method does nothing, and returns NULL. 112e97f0856a8044866b12527819d14cdfbcdfd96f2bsalomon@google.com */ 11374b461961607fa57a150a9282c410ef0cab38764vandebo@chromium.org SkDevice* createCompatibleDevice(SkBitmap::Config config, 114e97f0856a8044866b12527819d14cdfbcdfd96f2bsalomon@google.com int width, int height, 115e97f0856a8044866b12527819d14cdfbcdfd96f2bsalomon@google.com bool isOpaque); 116e97f0856a8044866b12527819d14cdfbcdfd96f2bsalomon@google.com 1174b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com /////////////////////////////////////////////////////////////////////////// 1184b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com 119daba14b7d4fc96b915c45d82713b22729c0d0f37bsalomon@google.com /** 120d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com * This enum can be used with read/writePixels to perform a pixel ops to or 121d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com * from an 8888 config other than Skia's native config (SkPMColor). There 122d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com * are three byte orders supported: native, BGRA, and RGBA. Each has a 123d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com * premultiplied and unpremultiplied variant. 124d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com * 125d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com * Components of a 8888 pixel can be packed/unpacked from a 32bit word using 126d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com * either byte offsets or shift values. Byte offsets are endian-invariant 127d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com * while shifts are not. BGRA and RGBA configs are defined by byte 128d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com * orderings. The native config is defined by shift values (SK_A32_SHIFT, 129d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com * ..., SK_B32_SHIFT). 1306850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com */ 1316850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com enum Config8888 { 1326850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com /** 1336850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * Skia's native order specified by: 1346850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * SK_A32_SHIFT, SK_R32_SHIFT, SK_G32_SHIFT, and SK_B32_SHIFT 1356850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * 1366850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * kNative_Premul_Config8888 is equivalent to SkPMColor 1376850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * kNative_Unpremul_Config8888 has the same component order as SkPMColor 1386850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * but is not premultiplied. 1396850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com */ 1406850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com kNative_Premul_Config8888, 1416850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com kNative_Unpremul_Config8888, 1426850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com /** 1436850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * low byte to high byte: B, G, R, A. 1446850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com */ 1456850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com kBGRA_Premul_Config8888, 1466850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com kBGRA_Unpremul_Config8888, 1476850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com /** 1486850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * low byte to high byte: R, G, B, A. 1496850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com */ 1506850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com kRGBA_Premul_Config8888, 1511f90287df3129cb267422e482c52ebeca6a8990ftomhudson@google.com kRGBA_Unpremul_Config8888 1526850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com }; 1536850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com 1546850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com /** 155daba14b7d4fc96b915c45d82713b22729c0d0f37bsalomon@google.com * On success (returns true), copy the canvas pixels into the bitmap. 156daba14b7d4fc96b915c45d82713b22729c0d0f37bsalomon@google.com * On failure, the bitmap parameter is left unchanged and false is 157daba14b7d4fc96b915c45d82713b22729c0d0f37bsalomon@google.com * returned. 158daba14b7d4fc96b915c45d82713b22729c0d0f37bsalomon@google.com * 1596850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * The canvas' pixels are converted to the bitmap's config. The only 1606850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * supported config is kARGB_8888_Config, though this is likely to be 1616850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * relaxed in the future. The meaning of config kARGB_8888_Config is 1626850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * modified by the enum param config8888. The default value interprets 1636850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * kARGB_8888_Config as SkPMColor 164daba14b7d4fc96b915c45d82713b22729c0d0f37bsalomon@google.com * 165daba14b7d4fc96b915c45d82713b22729c0d0f37bsalomon@google.com * If the bitmap has pixels already allocated, the canvas pixels will be 16674b461961607fa57a150a9282c410ef0cab38764vandebo@chromium.org * written there. If not, bitmap->allocPixels() will be called 167daba14b7d4fc96b915c45d82713b22729c0d0f37bsalomon@google.com * automatically. If the bitmap is backed by a texture readPixels will 168daba14b7d4fc96b915c45d82713b22729c0d0f37bsalomon@google.com * fail. 169daba14b7d4fc96b915c45d82713b22729c0d0f37bsalomon@google.com * 170daba14b7d4fc96b915c45d82713b22729c0d0f37bsalomon@google.com * The actual pixels written is the intersection of the canvas' bounds, and 171daba14b7d4fc96b915c45d82713b22729c0d0f37bsalomon@google.com * the rectangle formed by the bitmap's width,height and the specified x,y. 172daba14b7d4fc96b915c45d82713b22729c0d0f37bsalomon@google.com * If bitmap pixels extend outside of that intersection, they will not be 173daba14b7d4fc96b915c45d82713b22729c0d0f37bsalomon@google.com * modified. 174daba14b7d4fc96b915c45d82713b22729c0d0f37bsalomon@google.com * 1756850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * Other failure conditions: 1766850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * * If the canvas is backed by a non-raster device (e.g. PDF) then 1776850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * readPixels will fail. 1786850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * * If bitmap is texture-backed then readPixels will fail. (This may be 1796850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * relaxed in the future.) 1806850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * 1816850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * Example that reads the entire canvas into a bitmap using the native 1826850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * SkPMColor: 1836850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * SkISize size = canvas->getDeviceSize(); 1846850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * bitmap->setConfig(SkBitmap::kARGB_8888_Config, size.fWidth, 1856850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * size.fHeight); 1866850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * if (canvas->readPixels(bitmap, 0, 0)) { 1876850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * // use the pixels 1886850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com * } 189c69809745e6496564639e42ef998ad39adf7dfb8bsalomon@google.com */ 1906850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com bool readPixels(SkBitmap* bitmap, 1916850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com int x, int y, 1926850eab42ba4c2a7033a99824b02a2846ce0ef2absalomon@google.com Config8888 config8888 = kNative_Premul_Config8888); 193c69809745e6496564639e42ef998ad39adf7dfb8bsalomon@google.com 1944b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com /** 195c69809745e6496564639e42ef998ad39adf7dfb8bsalomon@google.com * DEPRECATED: This will be removed as soon as webkit is no longer relying 196c69809745e6496564639e42ef998ad39adf7dfb8bsalomon@google.com * on it. The bitmap is resized to the intersection of srcRect and the 197c69809745e6496564639e42ef998ad39adf7dfb8bsalomon@google.com * canvas bounds. New pixels are always allocated on success. Bitmap is 198c69809745e6496564639e42ef998ad39adf7dfb8bsalomon@google.com * unmodified on failure. 19951df9e3fe3c1aec370854b2718df16fc02faa1b2reed@google.com */ 20051df9e3fe3c1aec370854b2718df16fc02faa1b2reed@google.com bool readPixels(const SkIRect& srcRect, SkBitmap* bitmap); 20151df9e3fe3c1aec370854b2718df16fc02faa1b2reed@google.com 20251df9e3fe3c1aec370854b2718df16fc02faa1b2reed@google.com /** 20351df9e3fe3c1aec370854b2718df16fc02faa1b2reed@google.com * Similar to draw sprite, this method will copy the pixels in bitmap onto 204d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com * the canvas, with the top/left corner specified by (x, y). The canvas' 205d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com * pixel values are completely replaced: there is no blending. 206d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com * 207d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com * Currently if bitmap is backed by a texture this is a no-op. This may be 208d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com * relaxed in the future. 209d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com * 210d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com * If the bitmap has config kARGB_8888_Config then the config8888 param 211d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com * will determines how the pixel valuess are intepreted. If the bitmap is 212d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com * not kARGB_8888_Config then this parameter is ignored. 2134f1151ab27485aff393d16559086c4c461f137a4epoger@google.com * 2144f1151ab27485aff393d16559086c4c461f137a4epoger@google.com * Note: If you are recording drawing commands on this canvas to 2154f1151ab27485aff393d16559086c4c461f137a4epoger@google.com * SkPicture, writePixels() is ignored! 21651df9e3fe3c1aec370854b2718df16fc02faa1b2reed@google.com */ 217d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com void writePixels(const SkBitmap& bitmap, 218d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com int x, int y, 219d58a1cd00b969a7755c375f55cf80f4d49d3047bbsalomon@google.com Config8888 config8888 = kNative_Premul_Config8888); 2204b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com 2218a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /////////////////////////////////////////////////////////////////////////// 2228d84fac294682647694b0d2d8a87ac2bd19b6aabvandebo@chromium.org 2238a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com enum SaveFlags { 2248a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** save the matrix state, restoring it on restore() */ 2258a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com kMatrix_SaveFlag = 0x01, 2268a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** save the clip state, restoring it on restore() */ 2278a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com kClip_SaveFlag = 0x02, 2288a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** the layer needs to support per-pixel alpha */ 2298a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com kHasAlphaLayer_SaveFlag = 0x04, 2308a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** the layer needs to support 8-bits per color component */ 2318a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com kFullColorLayer_SaveFlag = 0x08, 2328a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** the layer should clip against the bounds argument */ 2338a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com kClipToLayer_SaveFlag = 0x10, 2348a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 2358a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com // helper masks for common choices 2368a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com kMatrixClip_SaveFlag = 0x03, 2378a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com kARGB_NoClipLayer_SaveFlag = 0x0F, 2388a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com kARGB_ClipLayer_SaveFlag = 0x1F 2398a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com }; 2408a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 241dc3381fc8194a6192af39539c6ac9787b20209d3reed@android.com /** This call saves the current matrix, clip, and drawFilter, and pushes a 2428a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com copy onto a private stack. Subsequent calls to translate, scale, 243dc3381fc8194a6192af39539c6ac9787b20209d3reed@android.com rotate, skew, concat or clipRect, clipPath, and setDrawFilter all 244dc3381fc8194a6192af39539c6ac9787b20209d3reed@android.com operate on this copy. 245dc3381fc8194a6192af39539c6ac9787b20209d3reed@android.com When the balancing call to restore() is made, the previous matrix, clip, 246dc3381fc8194a6192af39539c6ac9787b20209d3reed@android.com and drawFilter are restored. 2478a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @return The value to pass to restoreToCount() to balance this save() 2488a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 2498a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual int save(SaveFlags flags = kMatrixClip_SaveFlag); 2508a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 2518a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** This behaves the same as save(), but in addition it allocates an 2528a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com offscreen bitmap. All drawing calls are directed there, and only when 2538a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com the balancing call to restore() is made is that offscreen transfered to 254dc3381fc8194a6192af39539c6ac9787b20209d3reed@android.com the canvas (or the previous layer). 255ad164b2025cba65131ca68221a6ea7640d7b1de8reed@android.com @param bounds (may be null) This rect, if non-null, is used as a hint to 256ad164b2025cba65131ca68221a6ea7640d7b1de8reed@android.com limit the size of the offscreen, and thus drawing may be 257ad164b2025cba65131ca68221a6ea7640d7b1de8reed@android.com clipped to it, though that clipping is not guaranteed to 258ad164b2025cba65131ca68221a6ea7640d7b1de8reed@android.com happen. If exact clipping is desired, use clipRect(). 2598a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param paint (may be null) This is copied, and is applied to the 2608a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com offscreen when restore() is called 2618a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param flags LayerFlags 2628a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @return The value to pass to restoreToCount() to balance this save() 2638a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 2648a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual int saveLayer(const SkRect* bounds, const SkPaint* paint, 2658a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SaveFlags flags = kARGB_ClipLayer_SaveFlag); 2668a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 2678a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** This behaves the same as save(), but in addition it allocates an 2688a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com offscreen bitmap. All drawing calls are directed there, and only when 2698a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com the balancing call to restore() is made is that offscreen transfered to 270dc3381fc8194a6192af39539c6ac9787b20209d3reed@android.com the canvas (or the previous layer). 27140408614655c4057d93842c9b0f09aa6dfff9e02reed@android.com @param bounds (may be null) This rect, if non-null, is used as a hint to 27240408614655c4057d93842c9b0f09aa6dfff9e02reed@android.com limit the size of the offscreen, and thus drawing may be 27340408614655c4057d93842c9b0f09aa6dfff9e02reed@android.com clipped to it, though that clipping is not guaranteed to 27440408614655c4057d93842c9b0f09aa6dfff9e02reed@android.com happen. If exact clipping is desired, use clipRect(). 2758a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param alpha This is applied to the offscreen when restore() is called. 2768a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param flags LayerFlags 2778a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @return The value to pass to restoreToCount() to balance this save() 2788a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 2798a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com int saveLayerAlpha(const SkRect* bounds, U8CPU alpha, 2808a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SaveFlags flags = kARGB_ClipLayer_SaveFlag); 2818a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 2828a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** This call balances a previous call to save(), and is used to remove all 283dc3381fc8194a6192af39539c6ac9787b20209d3reed@android.com modifications to the matrix/clip/drawFilter state since the last save 284dc3381fc8194a6192af39539c6ac9787b20209d3reed@android.com call. 285dc3381fc8194a6192af39539c6ac9787b20209d3reed@android.com It is an error to call restore() more times than save() was called. 2868a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 2878a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual void restore(); 2888a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 2898a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Returns the number of matrix/clip states on the SkCanvas' private stack. 2908a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com This will equal # save() calls - # restore() calls. 2918a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 292a907ac3e3e3458fbb5d673c3feafb31fd7647b38junov@chromium.org int getSaveCount() const; 2938a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 2948a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Efficient way to pop any calls to save() that happened after the save 2958a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com count reached saveCount. It is an error for saveCount to be less than 2968a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com getSaveCount() 2978a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param saveCount The number of save() levels to restore from 2988a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 2998a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com void restoreToCount(int saveCount); 3008a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 3017c2029367cea5479fa3b74fb0ca2b0297b42b709reed@google.com /** Returns true if drawing is currently going to a layer (from saveLayer) 3027c2029367cea5479fa3b74fb0ca2b0297b42b709reed@google.com * rather than to the root device. 3037c2029367cea5479fa3b74fb0ca2b0297b42b709reed@google.com */ 3048f9ecbd3466d4330886b4c23b06e75b468c795adjunov@chromium.org virtual bool isDrawingToLayer() const; 3057c2029367cea5479fa3b74fb0ca2b0297b42b709reed@google.com 3068a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Preconcat the current matrix with the specified translation 3078a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param dx The distance to translate in X 3088a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param dy The distance to translate in Y 3098a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com returns true if the operation succeeded (e.g. did not overflow) 3108a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 3118a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual bool translate(SkScalar dx, SkScalar dy); 3128a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 3138a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Preconcat the current matrix with the specified scale. 3148a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param sx The amount to scale in X 3158a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param sy The amount to scale in Y 3168a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com returns true if the operation succeeded (e.g. did not overflow) 3178a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 3188a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual bool scale(SkScalar sx, SkScalar sy); 3198a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 3208a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Preconcat the current matrix with the specified rotation. 3218a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param degrees The amount to rotate, in degrees 3228a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com returns true if the operation succeeded (e.g. did not overflow) 3238a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 3248a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual bool rotate(SkScalar degrees); 3258a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 3268a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Preconcat the current matrix with the specified skew. 3278a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param sx The amount to skew in X 3288a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param sy The amount to skew in Y 3298a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com returns true if the operation succeeded (e.g. did not overflow) 3308a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 3318a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual bool skew(SkScalar sx, SkScalar sy); 3328a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 3338a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Preconcat the current matrix with the specified matrix. 3348a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param matrix The matrix to preconcatenate with the current matrix 3358a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @return true if the operation succeeded (e.g. did not overflow) 3368a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 3378a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual bool concat(const SkMatrix& matrix); 3384b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com 3398a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Replace the current matrix with a copy of the specified matrix. 3408a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param matrix The matrix that will be copied into the current matrix. 3418a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 3428a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual void setMatrix(const SkMatrix& matrix); 3434b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com 3448a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Helper for setMatrix(identity). Sets the current matrix to identity. 3458a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 3468a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com void resetMatrix(); 3478a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 3488a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Modify the current clip with the specified rectangle. 3498a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param rect The rect to intersect with the current clip 3508a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param op The region op to apply to the current clip 3518a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @return true if the canvas' clip is non-empty 3528a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 3538a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual bool clipRect(const SkRect& rect, 354071eef918d70b6ca8334bc1241d1ea6923e828d5reed@google.com SkRegion::Op op = SkRegion::kIntersect_Op, 355071eef918d70b6ca8334bc1241d1ea6923e828d5reed@google.com bool doAntiAlias = false); 3568a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 3578a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Modify the current clip with the specified path. 3588a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param path The path to apply to the current clip 3598a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param op The region op to apply to the current clip 3608a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @return true if the canvas' new clip is non-empty 3618a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 3628a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual bool clipPath(const SkPath& path, 363071eef918d70b6ca8334bc1241d1ea6923e828d5reed@google.com SkRegion::Op op = SkRegion::kIntersect_Op, 364071eef918d70b6ca8334bc1241d1ea6923e828d5reed@google.com bool doAntiAlias = false); 3658a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 3668a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Modify the current clip with the specified region. Note that unlike 3678a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com clipRect() and clipPath() which transform their arguments by the current 3688a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com matrix, clipRegion() assumes its argument is already in device 3698a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com coordinates, and so no transformation is performed. 3708a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param deviceRgn The region to apply to the current clip 3718a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param op The region op to apply to the current clip 3728a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @return true if the canvas' new clip is non-empty 3738a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 3748a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual bool clipRegion(const SkRegion& deviceRgn, 3758a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkRegion::Op op = SkRegion::kIntersect_Op); 3768a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 3778a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Helper for clipRegion(rgn, kReplace_Op). Sets the current clip to the 3788a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com specified region. This does not intersect or in any other way account 3798a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com for the existing clip region. 3808a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param deviceRgn The region to copy into the current clip. 3818a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @return true if the new clip region is non-empty 3828a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 3838a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com bool setClipRegion(const SkRegion& deviceRgn) { 3848a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com return this->clipRegion(deviceRgn, SkRegion::kReplace_Op); 3858a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com } 3868a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 3878a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Enum describing how to treat edges when performing quick-reject tests 3888a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com of a geometry against the current clip. Treating them as antialiased 3898a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com (kAA_EdgeType) will take into account the extra pixels that may be drawn 3908a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com if the edge does not lie exactly on a device pixel boundary (after being 3918a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com transformed by the current matrix). 3928a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 3938a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com enum EdgeType { 3948a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Treat the edges as B&W (not antialiased) for the purposes of testing 3958a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com against the current clip 3968a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 3978a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com kBW_EdgeType, 3988a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Treat the edges as antialiased for the purposes of testing 3998a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com against the current clip 4008a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 4018a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com kAA_EdgeType 4028a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com }; 4038a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 4048a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Return true if the specified rectangle, after being transformed by the 4058a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com current matrix, would lie completely outside of the current clip. Call 4068a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com this to check if an area you intend to draw into is clipped out (and 4078a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com therefore you can skip making the draw calls). 4088a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param rect the rect to compare with the current clip 4098a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param et specifies how to treat the edges (see EdgeType) 4108a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @return true if the rect (transformed by the canvas' matrix) does not 4118a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com intersect with the canvas' clip 4128a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 4138a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com bool quickReject(const SkRect& rect, EdgeType et) const; 4148a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 4158a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Return true if the specified path, after being transformed by the 4168a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com current matrix, would lie completely outside of the current clip. Call 4178a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com this to check if an area you intend to draw into is clipped out (and 4188a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com therefore you can skip making the draw calls). Note, for speed it may 4198a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com return false even if the path itself might not intersect the clip 4208a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com (i.e. the bounds of the path intersects, but the path does not). 4218a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param path The path to compare with the current clip 4228a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param et specifies how to treat the edges (see EdgeType) 4238a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @return true if the path (transformed by the canvas' matrix) does not 4248a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com intersect with the canvas' clip 4258a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 4268a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com bool quickReject(const SkPath& path, EdgeType et) const; 4278a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 4288a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Return true if the horizontal band specified by top and bottom is 4298a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com completely clipped out. This is a conservative calculation, meaning 4308a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com that it is possible that if the method returns false, the band may still 4318a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com in fact be clipped out, but the converse is not true. If this method 4328a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com returns true, then the band is guaranteed to be clipped out. 4338a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param top The top of the horizontal band to compare with the clip 4348a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param bottom The bottom of the horizontal and to compare with the clip 4358a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @return true if the horizontal band is completely clipped out (i.e. does 4368a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com not intersect the current clip) 4378a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 43892d2a299d2738e4369508ea1296981a2f1f8aadbdjsollen@google.com bool quickRejectY(SkScalar top, SkScalar bottom, EdgeType et) const { 43992d2a299d2738e4369508ea1296981a2f1f8aadbdjsollen@google.com SkASSERT(SkScalarToCompareType(top) <= SkScalarToCompareType(bottom)); 44092d2a299d2738e4369508ea1296981a2f1f8aadbdjsollen@google.com const SkRectCompareType& clipR = this->getLocalClipBoundsCompareType(et); 44192d2a299d2738e4369508ea1296981a2f1f8aadbdjsollen@google.com // In the case where the clip is empty and we are provided with a 44292d2a299d2738e4369508ea1296981a2f1f8aadbdjsollen@google.com // negative top and positive bottom parameter then this test will return 44392d2a299d2738e4369508ea1296981a2f1f8aadbdjsollen@google.com // false even though it will be clipped. We have chosen to exclude that 44492d2a299d2738e4369508ea1296981a2f1f8aadbdjsollen@google.com // check as it is rare and would result double the comparisons. 44592d2a299d2738e4369508ea1296981a2f1f8aadbdjsollen@google.com return SkScalarToCompareType(top) >= clipR.fBottom 44692d2a299d2738e4369508ea1296981a2f1f8aadbdjsollen@google.com || SkScalarToCompareType(bottom) <= clipR.fTop; 44792d2a299d2738e4369508ea1296981a2f1f8aadbdjsollen@google.com } 4488a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 4498a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Return the bounds of the current clip (in local coordinates) in the 4508a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com bounds parameter, and return true if it is non-empty. This can be useful 4518a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com in a way similar to quickReject, in that it tells you that drawing 4528a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com outside of these bounds will be clipped out. 4538a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 4548a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com bool getClipBounds(SkRect* bounds, EdgeType et = kAA_EdgeType) const; 4558a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 456bcb671c82a7341253864cda3a5c46d396402d7fbtomhudson@google.com /** Return the bounds of the current clip, in device coordinates; returns 457bcb671c82a7341253864cda3a5c46d396402d7fbtomhudson@google.com true if non-empty. Maybe faster than getting the clip explicitly and 458bcb671c82a7341253864cda3a5c46d396402d7fbtomhudson@google.com then taking its bounds. 459bcb671c82a7341253864cda3a5c46d396402d7fbtomhudson@google.com */ 460bcb671c82a7341253864cda3a5c46d396402d7fbtomhudson@google.com bool getClipDeviceBounds(SkIRect* bounds) const; 46174b461961607fa57a150a9282c410ef0cab38764vandebo@chromium.org 462bcb671c82a7341253864cda3a5c46d396402d7fbtomhudson@google.com 4638a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Fill the entire canvas' bitmap (restricted to the current clip) with the 464845fdaca174f4675e9acc164b510e3a5ffa9053creed@android.com specified ARGB color, using the specified mode. 4658a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param a the alpha component (0..255) of the color to fill the canvas 4668a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param r the red component (0..255) of the color to fill the canvas 4678a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param g the green component (0..255) of the color to fill the canvas 4688a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param b the blue component (0..255) of the color to fill the canvas 4698a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param mode the mode to apply the color in (defaults to SrcOver) 4708a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 4718a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com void drawARGB(U8CPU a, U8CPU r, U8CPU g, U8CPU b, 472845fdaca174f4675e9acc164b510e3a5ffa9053creed@android.com SkXfermode::Mode mode = SkXfermode::kSrcOver_Mode); 4738a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 4748a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Fill the entire canvas' bitmap (restricted to the current clip) with the 475845fdaca174f4675e9acc164b510e3a5ffa9053creed@android.com specified color and mode. 4768a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param color the color to draw with 4778a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param mode the mode to apply the color in (defaults to SrcOver) 4788a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 4798a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com void drawColor(SkColor color, 480845fdaca174f4675e9acc164b510e3a5ffa9053creed@android.com SkXfermode::Mode mode = SkXfermode::kSrcOver_Mode); 4818a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 4822a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com /** 4832a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com * This erases the entire drawing surface to the specified color, 4842a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com * irrespective of the clip. It does not blend with the previous pixels, 4852a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com * but always overwrites them. 4862a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com * 4872a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com * It is roughly equivalent to the following: 4882a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com * canvas.save(); 4892a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com * canvas.clipRect(hugeRect, kReplace_Op); 4902a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com * paint.setColor(color); 4912a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com * paint.setXfermodeMode(kSrc_Mode); 4922a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com * canvas.drawPaint(paint); 4932a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com * canvas.restore(); 4942a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com * though it is almost always much more efficient. 4952a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com */ 4962a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com virtual void clear(SkColor); 4972a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com 4982a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com /** 4992a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com * Fill the entire canvas' bitmap (restricted to the current clip) with the 5002a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com * specified paint. 5012a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com * @param paint The paint used to fill the canvas 5022a98181f048c11f21f52fbd99f803f5fd6118261reed@google.com */ 5038a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual void drawPaint(const SkPaint& paint); 5048a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 5058a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com enum PointMode { 5068a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** drawPoints draws each point separately */ 5078a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com kPoints_PointMode, 5088a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** drawPoints draws each pair of points as a line segment */ 5098a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com kLines_PointMode, 5108a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** drawPoints draws the array of points as a polygon */ 5118a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com kPolygon_PointMode 5128a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com }; 5138a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 5148a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draw a series of points, interpreted based on the PointMode mode. For 5158a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com all modes, the count parameter is interpreted as the total number of 5168a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com points. For kLine mode, count/2 line segments are drawn. 5178a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com For kPoint mode, each point is drawn centered at its coordinate, and its 5188a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com size is specified by the paint's stroke-width. It draws as a square, 5198a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com unless the paint's cap-type is round, in which the points are drawn as 5208a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com circles. 5218a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com For kLine mode, each pair of points is drawn as a line segment, 5228a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com respecting the paint's settings for cap/join/width. 5238a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com For kPolygon mode, the entire array is drawn as a series of connected 5248a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com line segments. 5258a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com Note that, while similar, kLine and kPolygon modes draw slightly 5268a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com differently than the equivalent path built with a series of moveto, 5278a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com lineto calls, in that the path will draw all of its contours at once, 5288a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com with no interactions if contours intersect each other (think XOR 5298a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com xfermode). drawPoints always draws each element one at a time. 5308a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param mode PointMode specifying how to draw the array of points. 5318a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param count The number of points in the array 5328a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param pts Array of points to draw 5338a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param paint The paint used to draw the points 5348a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 5358a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual void drawPoints(PointMode mode, size_t count, const SkPoint pts[], 5368a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkPaint& paint); 5378a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 5388a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Helper method for drawing a single point. See drawPoints() for a more 5398a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com details. 5408a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 5418a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com void drawPoint(SkScalar x, SkScalar y, const SkPaint& paint); 5424b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com 5438a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draws a single pixel in the specified color. 5448a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param x The X coordinate of which pixel to draw 5458a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param y The Y coordiante of which pixel to draw 5468a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param color The color to draw 5478a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 5488a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com void drawPoint(SkScalar x, SkScalar y, SkColor color); 5498a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 5508a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draw a line segment with the specified start and stop x,y coordinates, 5518a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com using the specified paint. NOTE: since a line is always "framed", the 5528a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com paint's Style is ignored. 5538a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param x0 The x-coordinate of the start point of the line 5548a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param y0 The y-coordinate of the start point of the line 5558a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param x1 The x-coordinate of the end point of the line 5568a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param y1 The y-coordinate of the end point of the line 5578a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param paint The paint used to draw the line 5588a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 5598a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com void drawLine(SkScalar x0, SkScalar y0, SkScalar x1, SkScalar y1, 5608a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkPaint& paint); 5618a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 5628a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draw the specified rectangle using the specified paint. The rectangle 5638a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com will be filled or stroked based on the Style in the paint. 5648a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param rect The rect to be drawn 5658a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param paint The paint used to draw the rect 5668a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 5678a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual void drawRect(const SkRect& rect, const SkPaint& paint); 5688a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 5698a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draw the specified rectangle using the specified paint. The rectangle 5708a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com will be filled or framed based on the Style in the paint. 5718a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param rect The rect to be drawn 5728a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param paint The paint used to draw the rect 5738a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 5748a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com void drawIRect(const SkIRect& rect, const SkPaint& paint) 5758a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com { 5768a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkRect r; 5778a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com r.set(rect); // promotes the ints to scalars 5788a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com this->drawRect(r, paint); 5798a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com } 5804b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com 5818a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draw the specified rectangle using the specified paint. The rectangle 5828a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com will be filled or framed based on the Style in the paint. 5838a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param left The left side of the rectangle to be drawn 5848a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param top The top side of the rectangle to be drawn 5858a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param right The right side of the rectangle to be drawn 5868a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param bottom The bottom side of the rectangle to be drawn 5878a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param paint The paint used to draw the rect 5888a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 5898a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com void drawRectCoords(SkScalar left, SkScalar top, SkScalar right, 5908a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkScalar bottom, const SkPaint& paint); 5918a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 5928a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draw the specified oval using the specified paint. The oval will be 5938a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com filled or framed based on the Style in the paint. 5948a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param oval The rectangle bounds of the oval to be drawn 5958a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param paint The paint used to draw the oval 5968a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 5978a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com void drawOval(const SkRect& oval, const SkPaint&); 5988a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 5998a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draw the specified circle using the specified paint. If radius is <= 0, 6008a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com then nothing will be drawn. The circle will be filled 6018a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com or framed based on the Style in the paint. 6028a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param cx The x-coordinate of the center of the cirle to be drawn 6038a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param cy The y-coordinate of the center of the cirle to be drawn 6048a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param radius The radius of the cirle to be drawn 6058a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param paint The paint used to draw the circle 6068a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 6078a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com void drawCircle(SkScalar cx, SkScalar cy, SkScalar radius, 6088a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkPaint& paint); 6098a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 6108a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draw the specified arc, which will be scaled to fit inside the 6118a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com specified oval. If the sweep angle is >= 360, then the oval is drawn 6128a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com completely. Note that this differs slightly from SkPath::arcTo, which 6138a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com treats the sweep angle mod 360. 6148a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param oval The bounds of oval used to define the shape of the arc 6158a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param startAngle Starting angle (in degrees) where the arc begins 6168a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param sweepAngle Sweep angle (in degrees) measured clockwise 6178a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param useCenter true means include the center of the oval. For filling 6188a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com this will draw a wedge. False means just use the arc. 6198a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param paint The paint used to draw the arc 6208a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 6218a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com void drawArc(const SkRect& oval, SkScalar startAngle, SkScalar sweepAngle, 6228a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com bool useCenter, const SkPaint& paint); 6238a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 6248a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draw the specified round-rect using the specified paint. The round-rect 6258a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com will be filled or framed based on the Style in the paint. 6268a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param rect The rectangular bounds of the roundRect to be drawn 6278a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param rx The x-radius of the oval used to round the corners 6288a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param ry The y-radius of the oval used to round the corners 6298a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param paint The paint used to draw the roundRect 6308a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 6318a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com void drawRoundRect(const SkRect& rect, SkScalar rx, SkScalar ry, 6328a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkPaint& paint); 6338a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 6348a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draw the specified path using the specified paint. The path will be 6358a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com filled or framed based on the Style in the paint. 6368a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param path The path to be drawn 6378a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param paint The paint used to draw the path 6388a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 6398a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual void drawPath(const SkPath& path, const SkPaint& paint); 6408a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 6418a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draw the specified bitmap, with its top/left corner at (x,y), using the 6428a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com specified paint, transformed by the current matrix. Note: if the paint 6438a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com contains a maskfilter that generates a mask which extends beyond the 6448a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com bitmap's original width/height, then the bitmap will be drawn as if it 6458a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com were in a Shader with CLAMP mode. Thus the color outside of the original 6468a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com width/height will be the edge color replicated. 6478a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param bitmap The bitmap to be drawn 6488a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param left The position of the left side of the bitmap being drawn 6498a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param top The position of the top side of the bitmap being drawn 6508a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param paint The paint used to draw the bitmap, or NULL 6518a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 6528a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual void drawBitmap(const SkBitmap& bitmap, SkScalar left, SkScalar top, 6538a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkPaint* paint = NULL); 6548a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 6558a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draw the specified bitmap, with the specified matrix applied (before the 6568a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com canvas' matrix is applied). 6578a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param bitmap The bitmap to be drawn 6588a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param src Optional: specify the subset of the bitmap to be drawn 6598a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param dst The destination rectangle where the scaled/translated 6608a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com image will be drawn 6618a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param paint The paint used to draw the bitmap, or NULL 6628a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 6638a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual void drawBitmapRect(const SkBitmap& bitmap, const SkIRect* src, 6648a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkRect& dst, const SkPaint* paint = NULL); 6658a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 6668a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual void drawBitmapMatrix(const SkBitmap& bitmap, const SkMatrix& m, 6678a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkPaint* paint = NULL); 6684b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com 669f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com /** 670f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com * Draw the bitmap stretched differentially to fit into dst. 671f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com * center is a rect within the bitmap, and logically divides the bitmap 672f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com * into 9 sections (3x3). For example, if the middle pixel of a [5x5] 673f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com * bitmap is the "center", then the center-rect should be [2, 2, 3, 3]. 674f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com * 675f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com * If the dst is >= the bitmap size, then... 676f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com * - The 4 corners are not stretch at all. 677f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com * - The sides are stretch in only one axis. 678f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com * - The center is stretch in both axes. 679f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com * Else, for each axis where dst < bitmap, 680f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com * - The corners shrink proportionally 681f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com * - The sides (along the shrink axis) and center are not drawn 682f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com */ 683f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com virtual void drawBitmapNine(const SkBitmap& bitmap, const SkIRect& center, 684f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com const SkRect& dst, const SkPaint* paint = NULL); 685f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com 6868a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draw the specified bitmap, with its top/left corner at (x,y), 6878a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com NOT transformed by the current matrix. Note: if the paint 6888a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com contains a maskfilter that generates a mask which extends beyond the 6898a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com bitmap's original width/height, then the bitmap will be drawn as if it 6908a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com were in a Shader with CLAMP mode. Thus the color outside of the original 6918a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com width/height will be the edge color replicated. 6928a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param bitmap The bitmap to be drawn 6938a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param left The position of the left side of the bitmap being drawn 6948a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param top The position of the top side of the bitmap being drawn 6958a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param paint The paint used to draw the bitmap, or NULL 6968a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 6978a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual void drawSprite(const SkBitmap& bitmap, int left, int top, 6988a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkPaint* paint = NULL); 6998a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 7008a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draw the text, with origin at (x,y), using the specified paint. 7018a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com The origin is interpreted based on the Align setting in the paint. 7028a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param text The text to be drawn 7038a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param byteLength The number of bytes to read from the text parameter 7048a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param x The x-coordinate of the origin of the text being drawn 7058a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param y The y-coordinate of the origin of the text being drawn 7068a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param paint The paint used for the text (e.g. color, size, style) 7078a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 7088a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual void drawText(const void* text, size_t byteLength, SkScalar x, 7098a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkScalar y, const SkPaint& paint); 7108a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 7118a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draw the text, with each character/glyph origin specified by the pos[] 7124b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com array. The origin is interpreted by the Align setting in the paint. 7138a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param text The text to be drawn 7148a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param byteLength The number of bytes to read from the text parameter 7158a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param pos Array of positions, used to position each character 7168a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param paint The paint used for the text (e.g. color, size, style) 7178a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 7188a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual void drawPosText(const void* text, size_t byteLength, 7198a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkPoint pos[], const SkPaint& paint); 7204b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com 7218a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draw the text, with each character/glyph origin specified by the x 7228a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com coordinate taken from the xpos[] array, and the y from the constY param. 7234b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com The origin is interpreted by the Align setting in the paint. 7248a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param text The text to be drawn 7258a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param byteLength The number of bytes to read from the text parameter 7268a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param xpos Array of x-positions, used to position each character 7278a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param constY The shared Y coordinate for all of the positions 7288a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param paint The paint used for the text (e.g. color, size, style) 7298a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 7308a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual void drawPosTextH(const void* text, size_t byteLength, 7318a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkScalar xpos[], SkScalar constY, 7328a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkPaint& paint); 7334b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com 7348a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draw the text, with origin at (x,y), using the specified paint, along 7358a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com the specified path. The paint's Align setting determins where along the 7368a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com path to start the text. 7378a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param text The text to be drawn 7388a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param byteLength The number of bytes to read from the text parameter 7398a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param path The path the text should follow for its baseline 7408a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param hOffset The distance along the path to add to the text's 7418a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com starting position 7428a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param vOffset The distance above(-) or below(+) the path to 7438a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com position the text 7448a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param paint The paint used for the text 7458a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 7468a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com void drawTextOnPathHV(const void* text, size_t byteLength, 7478a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkPath& path, SkScalar hOffset, 7488a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkScalar vOffset, const SkPaint& paint); 7498a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 7508a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draw the text, with origin at (x,y), using the specified paint, along 7518a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com the specified path. The paint's Align setting determins where along the 7528a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com path to start the text. 7538a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param text The text to be drawn 7548a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param byteLength The number of bytes to read from the text parameter 7558a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param path The path the text should follow for its baseline 7568a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param matrix (may be null) Applied to the text before it is 7578a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com mapped onto the path 7588a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param paint The paint used for the text 7598a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 7608a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual void drawTextOnPath(const void* text, size_t byteLength, 7618a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkPath& path, const SkMatrix* matrix, 7628a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkPaint& paint); 7638a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 76456c69773aea56c6c6bd47bc7e7970dd081205184djsollen@google.com#ifdef SK_BUILD_FOR_ANDROID 765cd9d69b9ce7eb301a9fd8d91b9f95fd99b07bae5djsollen@google.com /** Draw the text on path, with each character/glyph origin specified by the pos[] 766cd9d69b9ce7eb301a9fd8d91b9f95fd99b07bae5djsollen@google.com array. The origin is interpreted by the Align setting in the paint. 767cd9d69b9ce7eb301a9fd8d91b9f95fd99b07bae5djsollen@google.com @param text The text to be drawn 768cd9d69b9ce7eb301a9fd8d91b9f95fd99b07bae5djsollen@google.com @param byteLength The number of bytes to read from the text parameter 769cd9d69b9ce7eb301a9fd8d91b9f95fd99b07bae5djsollen@google.com @param pos Array of positions, used to position each character 770cd9d69b9ce7eb301a9fd8d91b9f95fd99b07bae5djsollen@google.com @param paint The paint used for the text (e.g. color, size, style) 771cd9d69b9ce7eb301a9fd8d91b9f95fd99b07bae5djsollen@google.com @param path The path to draw on 772cd9d69b9ce7eb301a9fd8d91b9f95fd99b07bae5djsollen@google.com @param matrix The canvas matrix 773cd9d69b9ce7eb301a9fd8d91b9f95fd99b07bae5djsollen@google.com */ 774cd9d69b9ce7eb301a9fd8d91b9f95fd99b07bae5djsollen@google.com void drawPosTextOnPath(const void* text, size_t byteLength, 775cd9d69b9ce7eb301a9fd8d91b9f95fd99b07bae5djsollen@google.com const SkPoint pos[], const SkPaint& paint, 776cd9d69b9ce7eb301a9fd8d91b9f95fd99b07bae5djsollen@google.com const SkPath& path, const SkMatrix* matrix); 777cd9d69b9ce7eb301a9fd8d91b9f95fd99b07bae5djsollen@google.com#endif 778cd9d69b9ce7eb301a9fd8d91b9f95fd99b07bae5djsollen@google.com 7798a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draw the picture into this canvas. This method effective brackets the 7808a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com playback of the picture's draw calls with save/restore, so the state 7818a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com of this canvas will be unchanged after this call. This contrasts with 7828a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com the more immediate method SkPicture::draw(), which does not bracket 7838a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com the canvas with save/restore, thus the canvas may be left in a changed 7848a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com state after the call. 7858a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param picture The recorded drawing commands to playback into this 7868a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com canvas. 7878a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 7888a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual void drawPicture(SkPicture& picture); 7894b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com 7908a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com enum VertexMode { 7918a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com kTriangles_VertexMode, 7928a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com kTriangleStrip_VertexMode, 7938a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com kTriangleFan_VertexMode 7948a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com }; 7954b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com 7968a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Draw the array of vertices, interpreted as triangles (based on mode). 7978a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param vmode How to interpret the array of vertices 7988a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param vertexCount The number of points in the vertices array (and 7998a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com corresponding texs and colors arrays if non-null) 8008a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param vertices Array of vertices for the mesh 8018a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param texs May be null. If not null, specifies the coordinate 8028a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com in texture space for each vertex. 8038a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param colors May be null. If not null, specifies a color for each 8048a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com vertex, to be interpolated across the triangle. 8058a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param xmode Used if both texs and colors are present. In this 8068a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com case the colors are combined with the texture using mode, 8078a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com before being drawn using the paint. If mode is null, then 808845fdaca174f4675e9acc164b510e3a5ffa9053creed@android.com kMultiply_Mode is used. 8098a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param indices If not null, array of indices to reference into the 8108a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com vertex (texs, colors) array. 8118a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param indexCount number of entries in the indices array (if not null) 8124b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com @param paint Specifies the shader/texture if present. 8138a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 8148a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual void drawVertices(VertexMode vmode, int vertexCount, 8158a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkPoint vertices[], const SkPoint texs[], 8168a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkColor colors[], SkXfermode* xmode, 8178a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const uint16_t indices[], int indexCount, 8188a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkPaint& paint); 8198a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 820cb60844b34766aad4151df5e87c144d4a57e9abereed@android.com /** Send a blob of data to the canvas. 821cb60844b34766aad4151df5e87c144d4a57e9abereed@android.com For canvases that draw, this call is effectively a no-op, as the data 822cb60844b34766aad4151df5e87c144d4a57e9abereed@android.com is not parsed, but just ignored. However, this call exists for 823cb60844b34766aad4151df5e87c144d4a57e9abereed@android.com subclasses like SkPicture's recording canvas, that can store the data 824cb60844b34766aad4151df5e87c144d4a57e9abereed@android.com and then play it back later (via another call to drawData). 825cb60844b34766aad4151df5e87c144d4a57e9abereed@android.com */ 826cb60844b34766aad4151df5e87c144d4a57e9abereed@android.com virtual void drawData(const void* data, size_t length); 827cb60844b34766aad4151df5e87c144d4a57e9abereed@android.com 8288a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com ////////////////////////////////////////////////////////////////////////// 8294b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com 8308a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Get the current bounder object. 8318a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com The bounder's reference count is unchaged. 8328a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @return the canva's bounder (or NULL). 8338a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 8348a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkBounder* getBounder() const { return fBounder; } 8358a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 8368a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Set a new bounder (or NULL). 8378a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com Pass NULL to clear any previous bounder. 8388a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com As a convenience, the parameter passed is also returned. 8398a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com If a previous bounder exists, its reference count is decremented. 8408a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com If bounder is not NULL, its reference count is incremented. 8418a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param bounder the new bounder (or NULL) to be installed in the canvas 8428a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @return the set bounder object 8438a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 8448a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual SkBounder* setBounder(SkBounder* bounder); 8454b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com 8468a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Get the current filter object. The filter's reference count is not 847dc3381fc8194a6192af39539c6ac9787b20209d3reed@android.com affected. The filter is saved/restored, just like the matrix and clip. 8488a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @return the canvas' filter (or NULL). 8498a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 8508a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkDrawFilter* getDrawFilter() const; 8514b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com 8528a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Set the new filter (or NULL). Pass NULL to clear any existing filter. 8538a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com As a convenience, the parameter is returned. If an existing filter 8548a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com exists, its refcnt is decrement. If the new filter is not null, its 855dc3381fc8194a6192af39539c6ac9787b20209d3reed@android.com refcnt is incremented. The filter is saved/restored, just like the 856dc3381fc8194a6192af39539c6ac9787b20209d3reed@android.com matrix and clip. 8578a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @param filter the new filter (or NULL) 8588a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @return the new filter 8598a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 8608a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com virtual SkDrawFilter* setDrawFilter(SkDrawFilter* filter); 8618a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 8628a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com ////////////////////////////////////////////////////////////////////////// 8638a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 8648a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Return the current matrix on the canvas. 8658a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com This does not account for the translate in any of the devices. 8668a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com @return The current matrix on the canvas. 8678a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 868a907ac3e3e3458fbb5d673c3feafb31fd7647b38junov@chromium.org const SkMatrix& getTotalMatrix() const; 8698a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 870bcb671c82a7341253864cda3a5c46d396402d7fbtomhudson@google.com enum ClipType { 871bcb671c82a7341253864cda3a5c46d396402d7fbtomhudson@google.com kEmpty_ClipType = 0, 872bcb671c82a7341253864cda3a5c46d396402d7fbtomhudson@google.com kRect_ClipType, 873bcb671c82a7341253864cda3a5c46d396402d7fbtomhudson@google.com kComplex_ClipType 874bcb671c82a7341253864cda3a5c46d396402d7fbtomhudson@google.com }; 875bcb671c82a7341253864cda3a5c46d396402d7fbtomhudson@google.com 876bcb671c82a7341253864cda3a5c46d396402d7fbtomhudson@google.com /** Returns a description of the total clip; may be cheaper than 877bcb671c82a7341253864cda3a5c46d396402d7fbtomhudson@google.com getting the clip and querying it directly. 878bcb671c82a7341253864cda3a5c46d396402d7fbtomhudson@google.com */ 879bcb671c82a7341253864cda3a5c46d396402d7fbtomhudson@google.com ClipType getClipType() const; 880bcb671c82a7341253864cda3a5c46d396402d7fbtomhudson@google.com 8818a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Return the current device clip (concatenation of all clip calls). 882a707f6087455834fab5525a0c656cc5b6df2ff29reed@google.com * This does not account for the translate in any of the devices. 883a707f6087455834fab5525a0c656cc5b6df2ff29reed@google.com * @return the current device clip (concatenation of all clip calls). 8845e2457ef2eba0c3f2e4c8fc89be7f36659e4f3b1reed@google.com * 885a707f6087455834fab5525a0c656cc5b6df2ff29reed@google.com * DEPRECATED -- call getClipDeviceBounds() instead. 8865e2457ef2eba0c3f2e4c8fc89be7f36659e4f3b1reed@google.com */ 887a707f6087455834fab5525a0c656cc5b6df2ff29reed@google.com const SkRegion& getTotalClip() const; 8885e2457ef2eba0c3f2e4c8fc89be7f36659e4f3b1reed@google.com 88990c07ea1d0aa6b7f20252c43fe23ee5ddc1d23cbreed@google.com void setExternalMatrix(const SkMatrix* = NULL); 89090c07ea1d0aa6b7f20252c43fe23ee5ddc1d23cbreed@google.com 89190c07ea1d0aa6b7f20252c43fe23ee5ddc1d23cbreed@google.com class ClipVisitor { 89290c07ea1d0aa6b7f20252c43fe23ee5ddc1d23cbreed@google.com public: 89390c07ea1d0aa6b7f20252c43fe23ee5ddc1d23cbreed@google.com virtual void clipRect(const SkRect&, SkRegion::Op, bool antialias) = 0; 89490c07ea1d0aa6b7f20252c43fe23ee5ddc1d23cbreed@google.com virtual void clipPath(const SkPath&, SkRegion::Op, bool antialias) = 0; 89590c07ea1d0aa6b7f20252c43fe23ee5ddc1d23cbreed@google.com }; 89690c07ea1d0aa6b7f20252c43fe23ee5ddc1d23cbreed@google.com 8975e2457ef2eba0c3f2e4c8fc89be7f36659e4f3b1reed@google.com /** 89890c07ea1d0aa6b7f20252c43fe23ee5ddc1d23cbreed@google.com * Replays the clip operations, back to front, that have been applied to 89990c07ea1d0aa6b7f20252c43fe23ee5ddc1d23cbreed@google.com * the canvas, calling the appropriate method on the visitor for each 90090c07ea1d0aa6b7f20252c43fe23ee5ddc1d23cbreed@google.com * clip. All clips have already been transformed into device space. 9017d7ca79c3e6e6be7b7849b0d9a7fe26effb89c38reed@google.com */ 90290c07ea1d0aa6b7f20252c43fe23ee5ddc1d23cbreed@google.com void replayClips(ClipVisitor*) const; 9038a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 9048a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /////////////////////////////////////////////////////////////////////////// 9058a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 9068a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** After calling saveLayer(), there can be any number of devices that make 9078a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com up the top-most drawing area. LayerIter can be used to iterate through 9088a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com those devices. Note that the iterator is only valid until the next API 9098a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com call made on the canvas. Ownership of all pointers in the iterator stays 9108a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com with the canvas, so none of them should be modified or deleted. 9118a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 9127ffb1b21abcc7bbed5a0fc711f6dd7b9dbb4f577ctguil@chromium.org class SK_API LayerIter /*: SkNoncopyable*/ { 9138a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com public: 9148a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Initialize iterator with canvas, and set values for 1st device */ 9158a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com LayerIter(SkCanvas*, bool skipEmptyClips); 9168a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com ~LayerIter(); 9174b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com 9188a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Return true if the iterator is done */ 9198a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com bool done() const { return fDone; } 9208a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /** Cycle to the next device */ 9218a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com void next(); 9224b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com 9238a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com // These reflect the current device in the iterator 9248a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 9258a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkDevice* device() const; 9268a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkMatrix& matrix() const; 9278a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkRegion& clip() const; 9288a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkPaint& paint() const; 9298a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com int x() const; 9308a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com int y() const; 9314b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com 9328a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com private: 9338a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com // used to embed the SkDrawIter object directly in our instance, w/o 9348a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com // having to expose that class def to the public. There is an assert 9358a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com // in our constructor to ensure that fStorage is large enough 9368a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com // (though needs to be a compile-time-assert!). We use intptr_t to work 9378a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com // safely with 32 and 64 bit machines (to ensure the storage is enough) 938f2b98d67dcb6fcb3120feede9c72016fc7b3ead8reed@android.com intptr_t fStorage[32]; 9398a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com class SkDrawIter* fImpl; // this points at fStorage 9408a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkPaint fDefaultPaint; 9418a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com bool fDone; 9428a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com }; 9438a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 9448a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.comprotected: 94574b461961607fa57a150a9282c410ef0cab38764vandebo@chromium.org // Returns the canvas to be used by DrawIter. Default implementation 9464370aedf7f55af74e9ebb4ad1c2e010c08236dfajunov@google.com // returns this. Subclasses that encapsulate an indirect canvas may 9474370aedf7f55af74e9ebb4ad1c2e010c08236dfajunov@google.com // need to overload this method. The impl must keep track of this, as it 9484370aedf7f55af74e9ebb4ad1c2e010c08236dfajunov@google.com // is not released or deleted by the caller. 9494370aedf7f55af74e9ebb4ad1c2e010c08236dfajunov@google.com virtual SkCanvas* canvasForDrawIter(); 9504370aedf7f55af74e9ebb4ad1c2e010c08236dfajunov@google.com 9518a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com // all of the drawBitmap variants call this guy 95249794c0cbd934545854a7b4091af5af7dfb46570reed@google.com void commonDrawBitmap(const SkBitmap&, const SkIRect*, const SkMatrix&, 95349794c0cbd934545854a7b4091af5af7dfb46570reed@google.com const SkPaint& paint); 9544b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com 955a907ac3e3e3458fbb5d673c3feafb31fd7647b38junov@chromium.org // Clip rectangle bounds. Called internally by saveLayer. 956a907ac3e3e3458fbb5d673c3feafb31fd7647b38junov@chromium.org // returns false if the entire rectangle is entirely clipped out 957a907ac3e3e3458fbb5d673c3feafb31fd7647b38junov@chromium.org bool clipRectBounds(const SkRect* bounds, SaveFlags flags, 95849794c0cbd934545854a7b4091af5af7dfb46570reed@google.com SkIRect* intersection); 959a907ac3e3e3458fbb5d673c3feafb31fd7647b38junov@chromium.org 9608a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.comprivate: 9618a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com class MCRec; 9628a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 9635c3d1471e4908706cd053a5e2ea9ded3a6c2eaebreed@google.com SkClipStack fClipStack; 9648a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkDeque fMCStack; 9658a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com // points to top of stack 9668a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com MCRec* fMCRec; 9678a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com // the first N recs that can fit here mean we won't call malloc 9688a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com uint32_t fMCRecStorage[32]; 9698a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 9708a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkBounder* fBounder; 971199f108f14a5f60a9c2205ffa79b26102a206ad0reed@android.com SkDevice* fLastDeviceToGainFocus; 972b0a7ace7cb2a7559bbc254a7c93698bc71bbd245junov@chromium.org int fSaveLayerCount; // number of successful saveLayer calls 9738a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 974d302f1401b3c9aea094804bad4e76de98782cfe8bsalomon@google.com void prepareForDeviceDraw(SkDevice*, const SkMatrix&, const SkRegion&, 975d302f1401b3c9aea094804bad4e76de98782cfe8bsalomon@google.com const SkClipStack& clipStack); 9764b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com 9778a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com bool fDeviceCMDirty; // cleared by updateDeviceCMCache() 9788a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com void updateDeviceCMCache(); 9798a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 9808a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com friend class SkDrawIter; // needs setupDrawForLayerDevice() 9818926b169f6a0dfa4c2129a98ec2aee205f0c8527reed@google.com friend class AutoDrawLooper; 9828a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 98374b461961607fa57a150a9282c410ef0cab38764vandebo@chromium.org SkDevice* createLayerDevice(SkBitmap::Config, int width, int height, 984e97f0856a8044866b12527819d14cdfbcdfd96f2bsalomon@google.com bool isOpaque); 985e97f0856a8044866b12527819d14cdfbcdfd96f2bsalomon@google.com 9868a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkDevice* init(SkDevice*); 987f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com 988f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com // internal methods are not virtual, so they can safely be called by other 989f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com // canvas apis, without confusing subclasses (like SkPictureRecording) 990f2b98d67dcb6fcb3120feede9c72016fc7b3ead8reed@android.com void internalDrawBitmap(const SkBitmap&, const SkIRect*, const SkMatrix& m, 9918a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkPaint* paint); 992f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com void internalDrawBitmapRect(const SkBitmap& bitmap, const SkIRect* src, 993f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com const SkRect& dst, const SkPaint* paint); 994f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com void internalDrawBitmapNine(const SkBitmap& bitmap, const SkIRect& center, 995f0b5e1190af9807a027c0adba2f1380663c8e910reed@google.com const SkRect& dst, const SkPaint* paint); 996fa6ac938e64fe11b442d05fe8a90ddac2d1951f9bsalomon@google.com void internalDrawPaint(const SkPaint& paint); 9978926b169f6a0dfa4c2129a98ec2aee205f0c8527reed@google.com int internalSaveLayer(const SkRect* bounds, const SkPaint* paint, 9988926b169f6a0dfa4c2129a98ec2aee205f0c8527reed@google.com SaveFlags, bool justForImageFilter); 9998926b169f6a0dfa4c2129a98ec2aee205f0c8527reed@google.com void internalDrawDevice(SkDevice*, int x, int y, const SkPaint*); 1000fa6ac938e64fe11b442d05fe8a90ddac2d1951f9bsalomon@google.com 10018a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com // shared by save() and saveLayer() 10028a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com int internalSave(SaveFlags flags); 10038a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com void internalRestore(); 100452c748b1691f02f90b27c35bc05074fcef709e66bungeman@google.com static void DrawRect(const SkDraw& draw, const SkPaint& paint, 100552c748b1691f02f90b27c35bc05074fcef709e66bungeman@google.com const SkRect& r, SkScalar textSize); 100652c748b1691f02f90b27c35bc05074fcef709e66bungeman@google.com static void DrawTextDecorations(const SkDraw& draw, const SkPaint& paint, 100752c748b1691f02f90b27c35bc05074fcef709e66bungeman@google.com const char text[], size_t byteLength, 100852c748b1691f02f90b27c35bc05074fcef709e66bungeman@google.com SkScalar x, SkScalar y); 10094b226023832011bc3bcdd1e5092ff0645ad0bdeereed@google.com 10108a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com /* These maintain a cache of the clip bounds in local coordinates, 10118a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com (converted to 2s-compliment if floats are slow). 10128a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com */ 10138a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com mutable SkRectCompareType fLocalBoundsCompareType; 10148a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com mutable bool fLocalBoundsCompareTypeDirty; 10158a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 1016ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com mutable SkRectCompareType fLocalBoundsCompareTypeBW; 1017ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com mutable bool fLocalBoundsCompareTypeDirtyBW; 1018ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com 1019ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com /* Get the local clip bounds with an anti-aliased edge. 1020ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com */ 10218a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com const SkRectCompareType& getLocalClipBoundsCompareType() const { 1022ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com return getLocalClipBoundsCompareType(kAA_EdgeType); 1023ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com } 1024ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com 1025ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com const SkRectCompareType& getLocalClipBoundsCompareType(EdgeType et) const { 1026ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com if (et == kAA_EdgeType) { 1027ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com if (fLocalBoundsCompareTypeDirty) { 1028ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com this->computeLocalClipBoundsCompareType(et); 1029ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com fLocalBoundsCompareTypeDirty = false; 1030ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com } 1031ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com return fLocalBoundsCompareType; 1032ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com } else { 1033ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com if (fLocalBoundsCompareTypeDirtyBW) { 1034ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com this->computeLocalClipBoundsCompareType(et); 1035ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com fLocalBoundsCompareTypeDirtyBW = false; 1036ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com } 1037ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com return fLocalBoundsCompareTypeBW; 10388a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com } 10398a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com } 1040ba09de4c4be66cc07790f23b0f3a925f47340e3ereed@android.com void computeLocalClipBoundsCompareType(EdgeType et) const; 1041f2b98d67dcb6fcb3120feede9c72016fc7b3ead8reed@android.com 1042f2b98d67dcb6fcb3120feede9c72016fc7b3ead8reed@android.com SkMatrix fExternalMatrix, fExternalInverse; 1043f2b98d67dcb6fcb3120feede9c72016fc7b3ead8reed@android.com bool fUseExternalMatrix; 10445c3d1471e4908706cd053a5e2ea9ded3a6c2eaebreed@google.com 10455c3d1471e4908706cd053a5e2ea9ded3a6c2eaebreed@google.com class AutoValidateClip : ::SkNoncopyable { 10465c3d1471e4908706cd053a5e2ea9ded3a6c2eaebreed@google.com public: 10475c3d1471e4908706cd053a5e2ea9ded3a6c2eaebreed@google.com explicit AutoValidateClip(SkCanvas* canvas) : fCanvas(canvas) { 10485c3d1471e4908706cd053a5e2ea9ded3a6c2eaebreed@google.com fCanvas->validateClip(); 10495c3d1471e4908706cd053a5e2ea9ded3a6c2eaebreed@google.com } 10505c3d1471e4908706cd053a5e2ea9ded3a6c2eaebreed@google.com ~AutoValidateClip() { fCanvas->validateClip(); } 10515c3d1471e4908706cd053a5e2ea9ded3a6c2eaebreed@google.com 10525c3d1471e4908706cd053a5e2ea9ded3a6c2eaebreed@google.com private: 10535c3d1471e4908706cd053a5e2ea9ded3a6c2eaebreed@google.com const SkCanvas* fCanvas; 10545c3d1471e4908706cd053a5e2ea9ded3a6c2eaebreed@google.com }; 10555c3d1471e4908706cd053a5e2ea9ded3a6c2eaebreed@google.com 10565c3d1471e4908706cd053a5e2ea9ded3a6c2eaebreed@google.com#ifdef SK_DEBUG 10575c3d1471e4908706cd053a5e2ea9ded3a6c2eaebreed@google.com void validateClip() const; 10585c3d1471e4908706cd053a5e2ea9ded3a6c2eaebreed@google.com#else 10595c3d1471e4908706cd053a5e2ea9ded3a6c2eaebreed@google.com void validateClip() const {} 10605c3d1471e4908706cd053a5e2ea9ded3a6c2eaebreed@google.com#endif 10618a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com}; 10628a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 10638a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com/** Stack helper class to automatically call restoreToCount() on the canvas 10648a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com when this object goes out of scope. Use this to guarantee that the canvas 10658a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com is restored to a known state. 10668a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com*/ 10678a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.comclass SkAutoCanvasRestore : SkNoncopyable { 10688a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.compublic: 10698a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkAutoCanvasRestore(SkCanvas* canvas, bool doSave) : fCanvas(canvas) { 10708a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkASSERT(canvas); 10718a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com fSaveCount = canvas->getSaveCount(); 10728a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com if (doSave) { 10738a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com canvas->save(); 10748a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com } 10758a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com } 10768a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com ~SkAutoCanvasRestore() { 10778a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com fCanvas->restoreToCount(fSaveCount); 10788a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com } 10798a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 10808a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.comprivate: 10818a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com SkCanvas* fCanvas; 10828a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com int fSaveCount; 10838a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com}; 10848a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com 10858a1c16ff38322f0210116fa7293eb8817c7e477ereed@android.com#endif 1086