Canvas.java revision c306ad61a791bae34ed83b339f27cb67a1d91b53
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.graphics; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.text.GraphicsOperations; 20f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Feltimport android.text.SpannableString; 21f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Feltimport android.text.SpannedString; 22f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Feltimport android.text.TextUtils; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 24091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craikimport javax.microedition.khronos.opengles.GL; 25091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The Canvas class holds the "draw" calls. To draw something, you need 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4 basic components: A Bitmap to hold the pixels, a Canvas to host 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the draw calls (writing into the bitmap), a drawing primitive (e.g. Rect, 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Path, text, Bitmap), and a paint (to describe the colors and styles for the 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawing). 3261fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * 3361fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * <div class="special reference"> 3461fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * <h3>Developer Guides</h3> 3561fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * <p>For more information about how to use Canvas, read the 3661fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * <a href="{@docRoot}guide/topics/graphics/2d-graphics.html"> 3761fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * Canvas and Drawables</a> developer guide.</p></div> 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class Canvas { 40ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 41fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger // assigned in constructors or setBitmap, freed in finalizer 42ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov /** @hide */ 4336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat public long mNativeCanvas; 44ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 45e0aa84b7dc087e999e20055dcc04cb6a48d5bd62Romain Guy // may be null 46e0aa84b7dc087e999e20055dcc04cb6a48d5bd62Romain Guy private Bitmap mBitmap; 47ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // optional field set by the caller 49ce0537b80087a6225273040a987414b1dd081aa0Romain Guy private DrawFilter mDrawFilter; 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 51ce0537b80087a6225273040a987414b1dd081aa0Romain Guy /** 52ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * @hide 53ce0537b80087a6225273040a987414b1dd081aa0Romain Guy */ 54ce0537b80087a6225273040a987414b1dd081aa0Romain Guy protected int mDensity = Bitmap.DENSITY_NONE; 550d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn 56ce0537b80087a6225273040a987414b1dd081aa0Romain Guy /** 57ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * Used to determine when compatibility scaling is in effect. 58ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * 59ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * @hide 60ce0537b80087a6225273040a987414b1dd081aa0Romain Guy */ 61ce0537b80087a6225273040a987414b1dd081aa0Romain Guy protected int mScreenDensity = Bitmap.DENSITY_NONE; 6211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Used by native code 64f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy @SuppressWarnings("UnusedDeclaration") 65e0aa84b7dc087e999e20055dcc04cb6a48d5bd62Romain Guy private int mSurfaceFormat; 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 67da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio /** 68da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * Flag for drawTextRun indicating left-to-right run direction. 69da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * @hide 70da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio */ 71da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio public static final int DIRECTION_LTR = 0; 72da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio 73da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio /** 74da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * Flag for drawTextRun indicating right-to-left run direction. 75da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * @hide 76da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio */ 77da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio public static final int DIRECTION_RTL = 1; 78da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio 79f61970fc79e9c5cf340fa942597628242361864aRomain Guy // Maximum bitmap size as defined in Skia's native code 80f61970fc79e9c5cf340fa942597628242361864aRomain Guy // (see SkCanvas.cpp, SkDraw.cpp) 81f61970fc79e9c5cf340fa942597628242361864aRomain Guy private static final int MAXMIMUM_BITMAP_SIZE = 32766; 82f61970fc79e9c5cf340fa942597628242361864aRomain Guy 834a317db43d2bbc992284dd1f651751f13734d017Romain Guy // This field is used to finalize the native Canvas properly 84e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy private final CanvasFinalizer mFinalizer; 85e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 86ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov private static final class CanvasFinalizer { 8736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private long mNativeCanvas; 88e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 8936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat public CanvasFinalizer(long nativeCanvas) { 90e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy mNativeCanvas = nativeCanvas; 91e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 92e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 93e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy @Override 94e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy protected void finalize() throws Throwable { 953b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy try { 96ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov dispose(); 973b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy } finally { 983b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy super.finalize(); 99e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 100e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 101ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 102ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov public void dispose() { 103ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov if (mNativeCanvas != 0) { 104ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov finalizer(mNativeCanvas); 105ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov mNativeCanvas = 0; 106ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov } 107ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov } 108e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 109e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 110f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Construct an empty raster canvas. Use setBitmap() to specify a bitmap to 11296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * draw into. The initial target density is {@link Bitmap#DENSITY_NONE}; 11396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * this will typically be replaced when a target bitmap is set for the 11496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * canvas. 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Canvas() { 117003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy if (!isHardwareAccelerated()) { 118003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy // 0 means no native bitmap 119003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy mNativeCanvas = initRaster(0); 120003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy mFinalizer = new CanvasFinalizer(mNativeCanvas); 121003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy } else { 122003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy mFinalizer = null; 123003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy } 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Construct a canvas with the specified bitmap to draw into. The bitmap 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * must be mutable. 12996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * 13096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>The initial target density of the canvas is the same as the given 13196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * bitmap's density. 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap Specifies a mutable bitmap for the canvas to draw into. 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Canvas(Bitmap bitmap) { 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!bitmap.isMutable()) { 137f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy throw new IllegalStateException("Immutable bitmap passed to Canvas constructor"); 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1391abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNativeCanvas = initRaster(bitmap.ni()); 141e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy mFinalizer = new CanvasFinalizer(mNativeCanvas); 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBitmap = bitmap; 14396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn mDensity = bitmap.mDensity; 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 145ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 146ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov /** @hide */ 14736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat public Canvas(long nativeCanvas) { 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (nativeCanvas == 0) { 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(); 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNativeCanvas = nativeCanvas; 152ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov mFinalizer = new CanvasFinalizer(mNativeCanvas); 15396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn mDensity = Bitmap.getDefaultDensity(); 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 155163935113919a184122b8b3bd672ef08c8df65dcRomain Guy 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 157fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger * Replace existing canvas while ensuring that the swap has occurred before 158fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger * the previous native canvas is unreferenced. 159fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger */ 16036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private void safeCanvasSwap(long nativeCanvas, boolean copyState) { 16136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat final long oldCanvas = mNativeCanvas; 162fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger mNativeCanvas = nativeCanvas; 163fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger mFinalizer.mNativeCanvas = nativeCanvas; 1643bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger if (copyState) { 1653bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger copyNativeCanvasState(oldCanvas, mNativeCanvas); 1663bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger } 167fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger finalizer(oldCanvas); 168fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger } 169ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 170ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov /** 171091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik * Returns null. 172c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * 173091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik * @deprecated This method is not supported and should not be invoked. 174c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * 175091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik * @hide 176091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik */ 177091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik @Deprecated 178091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik protected GL getGL() { 179091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik return null; 180091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik } 181091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik 182091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik /** 1832d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * Indicates whether this Canvas uses hardware acceleration. 1842d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * 1852d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * Note that this method does not define what type of hardware acceleration 1862d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * may or may not be used. 1872d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * 1882d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * @return True if drawing operations are hardware accelerated, 1892d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * false otherwise. 1902d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy */ 1912d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy public boolean isHardwareAccelerated() { 192163935113919a184122b8b3bd672ef08c8df65dcRomain Guy return false; 193caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed } 194163935113919a184122b8b3bd672ef08c8df65dcRomain Guy 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1963bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * Specify a bitmap for the canvas to draw into. All canvas state such as 1973bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * layers, filters, and the save/restore stack are reset with the exception 1983bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * of the current matrix and clip stack. Additionally, as a side-effect 1993bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * the canvas' target density is updated to match that of the bitmap. 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap Specifies a mutable bitmap for the canvas to draw into. 20296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @see #setDensity(int) 20396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @see #getDensity() 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setBitmap(Bitmap bitmap) { 206163935113919a184122b8b3bd672ef08c8df65dcRomain Guy if (isHardwareAccelerated()) { 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Can't set a bitmap device on a GL canvas"); 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 210fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger if (bitmap == null) { 2113bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger safeCanvasSwap(initRaster(0), false); 212fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger mDensity = Bitmap.DENSITY_NONE; 213fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger } else { 2140965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy if (!bitmap.isMutable()) { 2150965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy throw new IllegalStateException(); 2160965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy } 2171abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 218fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger 2193bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger safeCanvasSwap(initRaster(bitmap.ni()), true); 2200965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy mDensity = bitmap.mDensity; 2210965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy } 2220965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBitmap = bitmap; 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 225c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the viewport dimensions if this canvas is GL based. If it is not, 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this method is ignored and no exception is thrown. 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 230163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @param width The width of the viewport 231163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @param height The height of the viewport 232c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * 233163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @hide 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setViewport(int width, int height) { 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the device that the current layer draws into is opaque 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (i.e. does not support per-pixel alpha). 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the device that the current layer draws into is opaque 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native boolean isOpaque(); 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the width of the current drawing layer 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the width of the current drawing layer 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native int getWidth(); 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the height of the current drawing layer 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the height of the current drawing layer 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native int getHeight(); 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 26196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>Returns the target density of the canvas. The default density is 26296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * derived from the density of its backing bitmap, or 26396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * {@link Bitmap#DENSITY_NONE} if there is not one.</p> 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 26596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @return Returns the current target density of the canvas, which is used 26696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * to determine the scaling factor when drawing a bitmap into it. 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 26811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #setDensity(int) 26911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see Bitmap#getDensity() 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 27111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getDensity() { 27211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return mDensity; 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 27696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>Specifies the density for this Canvas' backing bitmap. This modifies 27796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * the target density of the canvas itself, as well as the density of its 27896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * backing bitmap via {@link Bitmap#setDensity(int) Bitmap.setDensity(int)}. 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 28096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @param density The new target density of the canvas, which is used 28196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * to determine the scaling factor when drawing a bitmap into it. Use 28296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * {@link Bitmap#DENSITY_NONE} to disable bitmap scaling. 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 28411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #getDensity() 28511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see Bitmap#setDensity(int) 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 28711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public void setDensity(int density) { 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mBitmap != null) { 28911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn mBitmap.setDensity(density); 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 29111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn mDensity = density; 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2940d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn /** @hide */ 2950d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn public void setScreenDensity(int density) { 2960d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn mScreenDensity = density; 2970d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn } 298f61970fc79e9c5cf340fa942597628242361864aRomain Guy 299f61970fc79e9c5cf340fa942597628242361864aRomain Guy /** 300f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Returns the maximum allowed width for bitmaps drawn with this canvas. 301f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Attempting to draw with a bitmap wider than this value will result 302f61970fc79e9c5cf340fa942597628242361864aRomain Guy * in an error. 303f61970fc79e9c5cf340fa942597628242361864aRomain Guy * 304f61970fc79e9c5cf340fa942597628242361864aRomain Guy * @see #getMaximumBitmapHeight() 305f61970fc79e9c5cf340fa942597628242361864aRomain Guy */ 306f61970fc79e9c5cf340fa942597628242361864aRomain Guy public int getMaximumBitmapWidth() { 307f61970fc79e9c5cf340fa942597628242361864aRomain Guy return MAXMIMUM_BITMAP_SIZE; 308f61970fc79e9c5cf340fa942597628242361864aRomain Guy } 3090d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn 310f61970fc79e9c5cf340fa942597628242361864aRomain Guy /** 311f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Returns the maximum allowed height for bitmaps drawn with this canvas. 312f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Attempting to draw with a bitmap taller than this value will result 313f61970fc79e9c5cf340fa942597628242361864aRomain Guy * in an error. 314f61970fc79e9c5cf340fa942597628242361864aRomain Guy * 315f61970fc79e9c5cf340fa942597628242361864aRomain Guy * @see #getMaximumBitmapWidth() 316f61970fc79e9c5cf340fa942597628242361864aRomain Guy */ 317f61970fc79e9c5cf340fa942597628242361864aRomain Guy public int getMaximumBitmapHeight() { 318f61970fc79e9c5cf340fa942597628242361864aRomain Guy return MAXMIMUM_BITMAP_SIZE; 319f61970fc79e9c5cf340fa942597628242361864aRomain Guy } 320f61970fc79e9c5cf340fa942597628242361864aRomain Guy 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // the SAVE_FLAG constants must match their native equivalents 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** restore the current matrix when restore() is called */ 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MATRIX_SAVE_FLAG = 0x01; 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** restore the current clip when restore() is called */ 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CLIP_SAVE_FLAG = 0x02; 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** the layer needs to per-pixel alpha */ 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int HAS_ALPHA_LAYER_SAVE_FLAG = 0x04; 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** the layer needs to 8-bits per color component */ 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FULL_COLOR_LAYER_SAVE_FLAG = 0x08; 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** clip against the layer's bounds */ 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CLIP_TO_LAYER_SAVE_FLAG = 0x10; 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** restore everything when restore() is called */ 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ALL_SAVE_FLAG = 0x1F; 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Saves the current matrix and clip onto a private stack. Subsequent 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calls to translate,scale,rotate,skew,concat or clipRect,clipPath 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will all operate as usual, but when the balancing call to restore() 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is made, those calls will be forgotten, and the settings that existed 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * before the save() will be reinstated. 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The value to pass to restoreToCount() to balance this save() 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native int save(); 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Based on saveFlags, can save the current matrix and clip onto a private 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * stack. Subsequent calls to translate,scale,rotate,skew,concat or 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect,clipPath will all operate as usual, but when the balancing 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * call to restore() is made, those calls will be forgotten, and the 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * settings that existed before the save() will be reinstated. 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveFlags flag bits that specify which parts of the Canvas state 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to save/restore 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The value to pass to restoreToCount() to balance this save() 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native int save(int saveFlags); 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This behaves the same as save(), but in addition it allocates an 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * offscreen bitmap. All drawing calls are directed there, and only when 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the balancing call to restore() is made is that offscreen transfered to 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the canvas (or the previous layer). Subsequent calls to translate, 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * scale, rotate, skew, concat or clipRect, clipPath all operate on this 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * copy. When the balancing call to restore() is made, this copy is 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * deleted and the previous matrix/clip state is restored. 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds May be null. The maximum size the offscreen bitmap 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * needs to be (in local coordinates) 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint This is copied, and is applied to the offscreen when 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * restore() is called. 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveFlags see _SAVE_FLAG constants 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return value to pass to restoreToCount() to balance this save() 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int saveLayer(RectF bounds, Paint paint, int saveFlags) { 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_saveLayer(mNativeCanvas, bounds, 378f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint != null ? paint.mNativePaint : 0, 379f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy saveFlags); 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 381c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 382c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 383c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Convenience for saveLayer(bounds, paint, {@link #ALL_SAVE_FLAG}) 384c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 385c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik public int saveLayer(RectF bounds, Paint paint) { 386c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayer(bounds, paint, ALL_SAVE_FLAG); 387c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 388c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper version of saveLayer() that takes 4 values rather than a RectF. 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 392f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public int saveLayer(float left, float top, float right, float bottom, Paint paint, 393f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy int saveFlags) { 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_saveLayer(mNativeCanvas, left, top, right, bottom, 395f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint != null ? paint.mNativePaint : 0, 396f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy saveFlags); 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 400c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Convenience for saveLayer(left, top, right, bottom, paint, {@link #ALL_SAVE_FLAG}) 401c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 402c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik public int saveLayer(float left, float top, float right, float bottom, Paint paint) { 403c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayer(left, top, right, bottom, paint, ALL_SAVE_FLAG); 404c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 405c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 406c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This behaves the same as save(), but in addition it allocates an 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * offscreen bitmap. All drawing calls are directed there, and only when 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the balancing call to restore() is made is that offscreen transfered to 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the canvas (or the previous layer). Subsequent calls to translate, 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * scale, rotate, skew, concat or clipRect, clipPath all operate on this 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * copy. When the balancing call to restore() is made, this copy is 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * deleted and the previous matrix/clip state is restored. 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds The maximum size the offscreen bitmap needs to be 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (in local coordinates) 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param alpha The alpha to apply to the offscreen when when it is 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawn during restore() 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveFlags see _SAVE_FLAG constants 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return value to pass to restoreToCount() to balance this call 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int saveLayerAlpha(RectF bounds, int alpha, int saveFlags) { 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project alpha = Math.min(255, Math.max(0, alpha)); 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_saveLayerAlpha(mNativeCanvas, bounds, alpha, saveFlags); 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 426c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 427c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 428c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Convenience for saveLayerAlpha(bounds, alpha, {@link #ALL_SAVE_FLAG}) 429c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 430c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik public int saveLayerAlpha(RectF bounds, int alpha) { 431c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayerAlpha(bounds, alpha, ALL_SAVE_FLAG); 432c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 433c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for saveLayerAlpha() that takes 4 values instead of a RectF. 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 437f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public int saveLayerAlpha(float left, float top, float right, float bottom, int alpha, 438f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy int saveFlags) { 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_saveLayerAlpha(mNativeCanvas, left, top, right, bottom, 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project alpha, saveFlags); 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 444c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Helper for saveLayerAlpha(left, top, right, bottom, alpha, {@link #ALL_SAVE_FLAG}) 445c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 446c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik public int saveLayerAlpha(float left, float top, float right, float bottom, int alpha) { 447c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayerAlpha(left, top, right, bottom, alpha, ALL_SAVE_FLAG); 448c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 449c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 450c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This call balances a previous call to save(), and is used to remove all 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * modifications to the matrix/clip state since the last save call. It is 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an error to call restore() more times than save() was called. 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void restore(); 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the number of matrix/clip states on the Canvas' private stack. 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This will equal # save() calls - # restore() calls. 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native int getSaveCount(); 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Efficient way to pop any calls to save() that happened after the save 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * count reached saveCount. It is an error for saveCount to be less than 1. 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Example: 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * int count = canvas.save(); 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ... // more calls potentially to save() 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * canvas.restoreToCount(count); 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * // now the canvas is back in the same state it was before the initial 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * // call to save(). 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveCount The save level to restore to. 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void restoreToCount(int saveCount); 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified translation 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dx The distance to translate in X 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dy The distance to translate in Y 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void translate(float dx, float dy); 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified scale. 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to scale in X 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to scale in Y 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void scale(float sx, float sy); 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified scale. 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to scale in X 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to scale in Y 499cc3ec6cdb2b892eb29513e72d8b205acbe997b25Gilles Debunne * @param px The x-coord for the pivot point (unchanged by the scale) 500cc3ec6cdb2b892eb29513e72d8b205acbe997b25Gilles Debunne * @param py The y-coord for the pivot point (unchanged by the scale) 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void scale(float sx, float sy, float px, float py) { 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(px, py); 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project scale(sx, sy); 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(-px, -py); 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified rotation. 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param degrees The amount to rotate, in degrees 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void rotate(float degrees); 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified rotation. 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param degrees The amount to rotate, in degrees 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param px The x-coord for the pivot point (unchanged by the rotation) 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param py The y-coord for the pivot point (unchanged by the rotation) 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void rotate(float degrees, float px, float py) { 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(px, py); 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project rotate(degrees); 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(-px, -py); 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified skew. 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to skew in X 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to skew in Y 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void skew(float sx, float sy); 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5374e7b772b733593fbe25c733e95b8dcea293234b6Romain Guy * Preconcat the current matrix with the specified matrix. If the specified 5384e7b772b733593fbe25c733e95b8dcea293234b6Romain Guy * matrix is null, this method does nothing. 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix to preconcatenate with the current matrix 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void concat(Matrix matrix) { 5434e7b772b733593fbe25c733e95b8dcea293234b6Romain Guy if (matrix != null) native_concat(mNativeCanvas, matrix.native_instance); 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Completely replace the current matrix with the specified matrix. If the 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * matrix parameter is null, then the current matrix is reset to identity. 549f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * 550f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * <strong>Note:</strong> it is recommended to use {@link #concat(Matrix)}, 551f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * {@link #scale(float, float)}, {@link #translate(float, float)} and 552f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * {@link #rotate(float)} instead of this method. 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix to replace the current matrix with. If it is 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * null, set the current matrix to identity. 556f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * 557f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * @see #concat(Matrix) 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setMatrix(Matrix matrix) { 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_setMatrix(mNativeCanvas, 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project matrix == null ? 0 : matrix.native_instance); 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return, in ctm, the current transformation matrix. This does not alter 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the matrix in the canvas, but just returns a copy of it. 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 568f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void getMatrix(Matrix ctm) { 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_getCTM(mNativeCanvas, ctm.native_instance); 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 57241030da16856c8869e1e51d4a0405432fa96614eRomain Guy 57341030da16856c8869e1e51d4a0405432fa96614eRomain Guy /** 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a new matrix with a copy of the canvas' current transformation 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * matrix. 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 57765447287cb4112cf74483c87be70bcd00b622e2dRomain Guy @Deprecated 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final Matrix getMatrix() { 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Matrix m = new Matrix(); 580f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy //noinspection deprecation 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getMatrix(m); 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return m; 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle. 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rect to intersect with the current clip 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipRect(RectF rect, Region.Op op) { 593f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy return native_clipRect(mNativeCanvas, rect.left, rect.top, rect.right, rect.bottom, 594f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy op.nativeInt); 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle, which is 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipRect(Rect rect, Region.Op op) { 606f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy return native_clipRect(mNativeCanvas, rect.left, rect.top, rect.right, rect.bottom, 607f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy op.nativeInt); 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native boolean clipRect(RectF rect); 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native boolean clipRect(Rect rect); 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle, which is 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 643f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public boolean clipRect(float left, float top, float right, float bottom, Region.Op op) { 644f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy return native_clipRect(mNativeCanvas, left, top, right, bottom, op.nativeInt); 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current clip 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 660f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public native boolean clipRect(float left, float top, float right, float bottom); 661f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current clip 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 675f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public native boolean clipRect(int left, int top, int right, int bottom); 676f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified path. 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to operate on the current clip 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipPath(Path path, Region.Op op) { 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_clipPath(mNativeCanvas, path.ni(), op.nativeInt); 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified path. 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to intersect with the current clip 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipPath(Path path) { 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return clipPath(path, Region.Op.INTERSECT); 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified region. Note that unlike 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect() and clipPath() which transform their arguments by the 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, clipRegion() assumes its argument is already in the 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinate system of the current layer's bitmap, and so not 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * transformation is performed. 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param region The region to operate on the current clip, based on op 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipRegion(Region region, Region.Op op) { 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_clipRegion(mNativeCanvas, region.ni(), op.nativeInt); 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified region. Note that unlike 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect() and clipPath() which transform their arguments by the 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, clipRegion() assumes its argument is already in the 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinate system of the current layer's bitmap, and so not 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * transformation is performed. 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param region The region to operate on the current clip, based on op 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipRegion(Region region) { 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return clipRegion(region, Region.Op.INTERSECT); 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public DrawFilter getDrawFilter() { 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mDrawFilter; 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setDrawFilter(DrawFilter filter) { 73236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeFilter = 0; 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (filter != null) { 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeFilter = filter.mNativeInt; 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDrawFilter = filter; 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeSetDrawFilter(mNativeCanvas, nativeFilter); 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum EdgeType { 741d320001807168f5565bab9807ef13c111096bbb3Chet Haase 742d320001807168f5565bab9807ef13c111096bbb3Chet Haase /** 743d320001807168f5565bab9807ef13c111096bbb3Chet Haase * Black-and-White: Treat edges by just rounding to nearest pixel boundary 744d320001807168f5565bab9807ef13c111096bbb3Chet Haase */ 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project BW(0), //!< treat edges by just rounding to nearest pixel boundary 746d320001807168f5565bab9807ef13c111096bbb3Chet Haase 747d320001807168f5565bab9807ef13c111096bbb3Chet Haase /** 748d320001807168f5565bab9807ef13c111096bbb3Chet Haase * Antialiased: Treat edges by rounding-out, since they may be antialiased 749d320001807168f5565bab9807ef13c111096bbb3Chet Haase */ 750d320001807168f5565bab9807ef13c111096bbb3Chet Haase AA(1); 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EdgeType(int nativeInt) { 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = nativeInt; 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 755c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy 756c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy /** 757c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy * @hide 758c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy */ 759c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy public final int nativeInt; 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified rectangle, after being transformed by the 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect the rect to compare with the current clip 769d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 770d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 771d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the rect (transformed by the canvas' matrix) 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean quickReject(RectF rect, EdgeType type) { 776ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger return native_quickReject(mNativeCanvas, rect); 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified path, after being transformed by the 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). Note: for speed it may 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * return false even if the path itself might not intersect the clip 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (i.e. the bounds of the path intersects, but the path does not). 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to compare with the current clip 788d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 789d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 790d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the path (transformed by the canvas' matrix) 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean quickReject(Path path, EdgeType type) { 795ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger return native_quickReject(mNativeCanvas, path.ni()); 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified rectangle, after being transformed by the 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to compare with the 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to compare with the current 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to compare with the 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to compare with the 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 812d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 813d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 814d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the rect (transformed by the canvas' matrix) 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 818ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger public boolean quickReject(float left, float top, float right, float bottom, 819ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger EdgeType type) { 820ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger return native_quickReject(mNativeCanvas, left, top, right, bottom); 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 824708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * Return the bounds of the current clip (in local coordinates) in the 825708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * bounds parameter, and return true if it is non-empty. This can be useful 826708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * in a way similar to quickReject, in that it tells you that drawing 827708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * outside of these bounds will be clipped out. 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds Return the clip bounds here. If it is null, ignore it but 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * still return true if the current clip is non-empty. 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the current clip is non-empty. 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean getClipBounds(Rect bounds) { 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_getClipBounds(mNativeCanvas, bounds); 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 838708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * Retrieve the bounds of the current clip (in local coordinates). 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the clip bounds, or [0, 0, 0, 0] if the clip is empty. 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final Rect getClipBounds() { 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect r = new Rect(); 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getClipBounds(r); 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return r; 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified RGB color, using srcover porterduff mode. 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r red component (0..255) of the color to draw onto the canvas 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param g green component (0..255) of the color to draw onto the canvas 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param b blue component (0..255) of the color to draw onto the canvas 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRGB(int r, int g, int b) { 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawRGB(mNativeCanvas, r, g, b); 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified ARGB color, using srcover porterduff mode. 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param a alpha component (0..255) of the color to draw onto the canvas 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r red component (0..255) of the color to draw onto the canvas 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param g green component (0..255) of the color to draw onto the canvas 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param b blue component (0..255) of the color to draw onto the canvas 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawARGB(int a, int r, int g, int b) { 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawARGB(mNativeCanvas, a, r, g, b); 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified color, using srcover porterduff mode. 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param color the color to draw onto the canvas 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawColor(int color) { 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawColor(mNativeCanvas, color); 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified color and porter-duff xfermode. 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param color the color to draw with 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode the porter-duff mode to apply to the color 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawColor(int color, PorterDuff.Mode mode) { 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawColor(mNativeCanvas, color, mode.nativeInt); 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified paint. This is equivalent (but faster) to drawing an 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * infinitely large rectangle with the specified paint. 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw onto the canvas 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPaint(Paint paint) { 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawPaint(mNativeCanvas, paint.mNativePaint); 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a series of points. Each point is centered at the coordinate 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified by pts[], and its diameter is specified by the paint's stroke 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * width (as transformed by the canvas' CTM), with special treatment for 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a stroke width of 0, which always draws exactly 1 pixel (or at most 4 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if antialiasing is enabled). The shape of the point is controlled by 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the paint's Cap type. The shape is a square, unless the cap type is 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Round, in which case the shape is a circle. 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pts Array of points to draw [x0 y0 x1 y1 x2 y2 ...] 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Number of values to skip before starting to draw. 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of values to process, after skipping offset 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of them. Since one point uses two values, the number of 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * "points" that are drawn is really (count >> 1). 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the points 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 921f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public native void drawPoints(float[] pts, int offset, int count, Paint paint); 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for drawPoints() that assumes you want to draw the entire array 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPoints(float[] pts, Paint paint) { 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPoints(pts, 0, pts.length, paint); 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for drawPoints() for drawing a single point. 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void drawPoint(float x, float y, Paint paint); 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a line segment with the specified start and stop x,y coordinates, 937a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * using the specified paint. 938a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * 939a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * <p>Note that since a line is always "framed", the Style is ignored in the paint.</p> 940a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * 941a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * <p>Degenerate lines (length is 0) will not be drawn.</p> 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startX The x-coordinate of the start point of the line 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startY The y-coordinate of the start point of the line 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the line 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 947f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawLine(float startX, float startY, float stopX, float stopY, Paint paint) { 948f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy native_drawLine(mNativeCanvas, startX, startY, stopX, stopY, paint.mNativePaint); 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a series of lines. Each line is taken from 4 consecutive values 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the pts array. Thus to draw 1 line, the array must contain at least 4 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * values. This is logically the same as drawing the array as follows: 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawLine(pts[0], pts[1], pts[2], pts[3]) followed by 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawLine(pts[4], pts[5], pts[6], pts[7]) and so on. 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pts Array of points to draw [x0 y0 x1 y1 x2 y2 ...] 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Number of values in the array to skip before drawing. 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of values in the array to process, after 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * skipping "offset" of them. Since each line uses 4 values, 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the number of "lines" that are drawn is really 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (count >> 2). 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the points 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 966f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public native void drawLines(float[] pts, int offset, int count, Paint paint); 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawLines(float[] pts, Paint paint) { 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawLines(pts, 0, pts.length, paint); 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified paint. The rectangle will 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be filled or framed based on the Style in the paint. 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rect to be drawn 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rect 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRect(RectF rect, Paint paint) { 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawRect(mNativeCanvas, rect, paint.mNativePaint); 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified Paint. The rectangle 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be filled or framed based on the Style in the paint. 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r The rectangle to be drawn. 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rectangle 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRect(Rect r, Paint paint) { 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawRect(r.left, r.top, r.right, r.bottom, paint); 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified paint. The rectangle will 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be filled or framed based on the Style in the paint. 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to be drawn 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top side of the rectangle to be drawn 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to be drawn 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom side of the rectangle to be drawn 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rect 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1005f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawRect(float left, float top, float right, float bottom, Paint paint) { 1006f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy native_drawRect(mNativeCanvas, left, top, right, bottom, paint.mNativePaint); 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified oval using the specified paint. The oval will be 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * filled or framed based on the Style in the paint. 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param oval The rectangle bounds of the oval to be drawn 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawOval(RectF oval, Paint paint) { 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (oval == null) { 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawOval(mNativeCanvas, oval, paint.mNativePaint); 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified circle using the specified paint. If radius is <= 0, 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then nothing will be drawn. The circle will be filled or framed based 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on the Style in the paint. 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cx The x-coordinate of the center of the cirle to be drawn 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cy The y-coordinate of the center of the cirle to be drawn 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param radius The radius of the cirle to be drawn 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the circle 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawCircle(float cx, float cy, float radius, Paint paint) { 1033f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy native_drawCircle(mNativeCanvas, cx, cy, radius, paint.mNativePaint); 10349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10374a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>Draw the specified arc, which will be scaled to fit inside the 10384a317db43d2bbc992284dd1f651751f13734d017Romain Guy * specified oval.</p> 10394a317db43d2bbc992284dd1f651751f13734d017Romain Guy * 10404a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>If the start angle is negative or >= 360, the start angle is treated 10414a317db43d2bbc992284dd1f651751f13734d017Romain Guy * as start angle modulo 360.</p> 10424a317db43d2bbc992284dd1f651751f13734d017Romain Guy * 10434a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>If the sweep angle is >= 360, then the oval is drawn 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completely. Note that this differs slightly from SkPath::arcTo, which 10454a317db43d2bbc992284dd1f651751f13734d017Romain Guy * treats the sweep angle modulo 360. If the sweep angle is negative, 10464a317db43d2bbc992284dd1f651751f13734d017Romain Guy * the sweep angle is treated as sweep angle modulo 360</p> 10474a317db43d2bbc992284dd1f651751f13734d017Romain Guy * 10484a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>The arc is drawn clockwise. An angle of 0 degrees correspond to the 10494a317db43d2bbc992284dd1f651751f13734d017Romain Guy * geometric angle of 0 degrees (3 o'clock on a watch.)</p> 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param oval The bounds of oval used to define the shape and size 10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the arc 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startAngle Starting angle (in degrees) where the arc begins 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sweepAngle Sweep angle (in degrees) measured clockwise 10559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param useCenter If true, include the center of the oval in the arc, and 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project close it if it is being stroked. This will draw a wedge 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the arc 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1059f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawArc(RectF oval, float startAngle, float sweepAngle, boolean useCenter, 1060f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy Paint paint) { 10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (oval == null) { 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawArc(mNativeCanvas, oval, startAngle, sweepAngle, 1065f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy useCenter, paint.mNativePaint); 10669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified round-rect using the specified paint. The roundrect 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be filled or framed based on the Style in the paint. 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangular bounds of the roundRect to be drawn 10739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rx The x-radius of the oval used to round the corners 10749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param ry The y-radius of the oval used to round the corners 10759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the roundRect 10769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRoundRect(RectF rect, float rx, float ry, Paint paint) { 10789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (rect == null) { 10799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 10809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawRoundRect(mNativeCanvas, rect, rx, ry, 10829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint.mNativePaint); 10839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified path using the specified paint. The path will be 10879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * filled or framed based on the Style in the paint. 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to be drawn 10909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the path 10919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPath(Path path, Paint paint) { 10939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawPath(mNativeCanvas, path.ni(), paint.mNativePaint); 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10951abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik 10961abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik /** 10971abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * @hide 10981abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik */ 10991abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik protected static void throwIfCannotDraw(Bitmap bitmap) { 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bitmap.isRecycled()) { 1101f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy throw new RuntimeException("Canvas: trying to use a recycled bitmap " + bitmap); 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11031abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik if (!bitmap.isPremultiplied() && bitmap.getConfig() == Bitmap.Config.ARGB_8888 && 11041abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik bitmap.hasAlpha()) { 11051abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throw new RuntimeException("Canvas: trying to use a non-premultiplied bitmap " 11061abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik + bitmap); 11071abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik } 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1111deba785f122a47915756ffd991f5540d952cf937Romain Guy * Draws the specified bitmap as an N-patch (most often, a 9-patches.) 1112deba785f122a47915756ffd991f5540d952cf937Romain Guy * 11133b748a44c6bd2ea05fe16839caf73dbe50bd7ae9Romain Guy * @param patch The ninepatch object to render 1114deba785f122a47915756ffd991f5540d952cf937Romain Guy * @param dst The destination rectangle. 1115deba785f122a47915756ffd991f5540d952cf937Romain Guy * @param paint The paint to draw the bitmap with. may be null 1116deba785f122a47915756ffd991f5540d952cf937Romain Guy * 1117deba785f122a47915756ffd991f5540d952cf937Romain Guy * @hide 1118deba785f122a47915756ffd991f5540d952cf937Romain Guy */ 1119f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy public void drawPatch(NinePatch patch, Rect dst, Paint paint) { 1120f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy patch.drawSoftware(this, dst, paint); 1121f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy } 1122f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy 1123f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy /** 1124f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * Draws the specified bitmap as an N-patch (most often, a 9-patches.) 1125f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * 1126f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @param patch The ninepatch object to render 1127f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @param dst The destination rectangle. 1128f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @param paint The paint to draw the bitmap with. may be null 1129f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * 1130f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @hide 1131f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy */ 11323b748a44c6bd2ea05fe16839caf73dbe50bd7ae9Romain Guy public void drawPatch(NinePatch patch, RectF dst, Paint paint) { 1133f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy patch.drawSoftware(this, dst, paint); 1134f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy } 1135f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy 1136deba785f122a47915756ffd991f5540d952cf937Romain Guy /** 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, with its top/left corner at (x,y), using 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified paint, transformed by the current matrix. 113911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 114011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 11459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 114611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>If the bitmap and canvas have different densities, this function 114711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * will take care of automatically scaling the bitmap to draw at the 114811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * same density as the canvas. 114911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The position of the left side of the bitmap being drawn 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The position of the top side of the bitmap being drawn 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the bitmap (may be null) 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(Bitmap bitmap, float left, float top, Paint paint) { 11561abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawBitmap(mNativeCanvas, bitmap.ni(), left, top, 1158f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy paint != null ? paint.mNativePaint : 0, mDensity, mScreenDensity, bitmap.mDensity); 11599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, scaling/translating automatically to fill 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the destination rectangle. If the source rectangle is not null, it 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specifies the subset of the bitmap to draw. 116511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 116611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 11679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 11689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 11699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 11709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 11719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 117211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>This function <em>ignores the density associated with the bitmap</em>. 117311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * This is because the source and destination rectangle coordinate 117411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * spaces are in their respective densities, so must already have the 117511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * appropriate scaling factor applied. 117611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param src May be null. The subset of the bitmap to be drawn 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dst The rectangle that the bitmap will be scaled/translated 11809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to fit into 11819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(Bitmap bitmap, Rect src, RectF dst, Paint paint) { 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (dst == null) { 11859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 11869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11871abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 11889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawBitmap(mNativeCanvas, bitmap.ni(), src, dst, 1189f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy paint != null ? paint.mNativePaint : 0, mScreenDensity, bitmap.mDensity); 11909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, scaling/translating automatically to fill 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the destination rectangle. If the source rectangle is not null, it 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specifies the subset of the bitmap to draw. 119611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 119711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 12029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 120311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>This function <em>ignores the density associated with the bitmap</em>. 120411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * This is because the source and destination rectangle coordinate 120511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * spaces are in their respective densities, so must already have the 120611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * appropriate scaling factor applied. 120711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 12099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param src May be null. The subset of the bitmap to be drawn 12109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dst The rectangle that the bitmap will be scaled/translated 12119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to fit into 12129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 12139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(Bitmap bitmap, Rect src, Rect dst, Paint paint) { 12159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (dst == null) { 12169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 12179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12181abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 12199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawBitmap(mNativeCanvas, bitmap.ni(), src, dst, 1220f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint != null ? paint.mNativePaint : 0, mScreenDensity, bitmap.mDensity); 12219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Treat the specified array of colors as a bitmap, and draw it. This gives 12259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the same result as first creating a bitmap from the array, and then 12269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawing it, but this method avoids explicitly creating a bitmap object 12279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * which can be more efficient if the colors are changing often. 12289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors Array of colors representing the pixels of the bitmap 12309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Offset into the array of colors for the first pixel 123183d522290e56f614d0d9373d47c2b54b9e207795Brad Fitzpatrick * @param stride The number of colors in the array between rows (must be 12329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * >= width or <= -width). 12339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The X coordinate for where to draw the bitmap 12349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The Y coordinate for where to draw the bitmap 12359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The width of the bitmap 12369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The height of the bitmap 12379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hasAlpha True if the alpha channel of the colors contains valid 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * values. If false, the alpha byte is ignored (assumed to 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be 0xFF for every pixel). 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 1241cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * 1242cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * @deprecated Usage with a {@link #isHardwareAccelerated() hardware accelerated} canvas 1243cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * requires an internal copy of color buffer contents every time this method is called. Using a 1244cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * Bitmap avoids this copy, and allows the application to more explicitly control the lifetime 1245cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * and copies of pixel data. 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1247cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik @Deprecated 1248f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawBitmap(int[] colors, int offset, int stride, float x, float y, 1249f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy int width, int height, boolean hasAlpha, Paint paint) { 12509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // check for valid input 12519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width < 0) { 12529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("width must be >= 0"); 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (height < 0) { 12559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("height must be >= 0"); 12569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (Math.abs(stride) < width) { 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("abs(stride) must be >= width"); 12599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int lastScanline = offset + (height - 1) * stride; 12619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = colors.length; 12629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (offset < 0 || (offset + width > length) || lastScanline < 0 12639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (lastScanline + width > length)) { 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // quick escape if there's nothing to draw 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width == 0 || height == 0) { 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // punch down to native for the actual draw 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawBitmap(mNativeCanvas, colors, offset, stride, x, y, width, height, hasAlpha, 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint != null ? paint.mNativePaint : 0); 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1274cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik 1275cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik /** 1276cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * Legacy version of drawBitmap(int[] colors, ...) that took ints for x,y 1277cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * 1278cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * @deprecated Usage with a {@link #isHardwareAccelerated() hardware accelerated} canvas 1279cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * requires an internal copy of color buffer contents every time this method is called. Using a 1280cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * Bitmap avoids this copy, and allows the application to more explicitly control the lifetime 1281cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * and copies of pixel data. 12829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1283cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik @Deprecated 12849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(int[] colors, int offset, int stride, int x, int y, 1285f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy int width, int height, boolean hasAlpha, Paint paint) { 12869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // call through to the common float version 12879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawBitmap(colors, offset, stride, (float)x, (float)y, width, height, 12889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project hasAlpha, paint); 12899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1290cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the bitmap using the specified matrix. 12939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to draw 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix used to transform the bitmap when it is drawn 12969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 12979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(Bitmap bitmap, Matrix matrix, Paint paint) { 12999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeDrawBitmapMatrix(mNativeCanvas, bitmap.ni(), matrix.ni(), 13009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint != null ? paint.mNativePaint : 0); 13019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13025a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy 13035a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy /** 13045a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy * @hide 13055a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy */ 13065a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy protected static void checkRange(int length, int offset, int count) { 13079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((offset | count) < 0 || offset + count > length) { 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the bitmap through the mesh, where mesh vertices are evenly 13149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed across the bitmap. There are meshWidth+1 vertices across, and 13159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * meshHeight+1 vertices down. The verts array is accessed in row-major 13169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * order, so that the first meshWidth+1 vertices are distributed across the 13179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * top of the bitmap from left to right. A more general version of this 13185d11676414b3606792e23c269cf75b44faa1a2afChris Craik * method is drawVertices(). 13199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to draw using the mesh 13219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param meshWidth The number of columns in the mesh. Nothing is drawn if 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this is 0 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param meshHeight The number of rows in the mesh. Nothing is drawn if 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this is 0 13259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param verts Array of x,y pairs, specifying where the mesh should be 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawn. There must be at least 13275d11676414b3606792e23c269cf75b44faa1a2afChris Craik * (meshWidth+1) * (meshHeight+1) * 2 + vertOffset values 13289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the array 13299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertOffset Number of verts elements to skip before drawing 13309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors May be null. Specifies a color at each vertex, which is 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * interpolated across the cell, and whose values are 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * multiplied by the corresponding bitmap colors. If not null, 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * there must be at least (meshWidth+1) * (meshHeight+1) + 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * colorOffset values in the array. 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colorOffset Number of color elements to skip before drawing 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmapMesh(Bitmap bitmap, int meshWidth, int meshHeight, 1339f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy float[] verts, int vertOffset, int[] colors, int colorOffset, Paint paint) { 13409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((meshWidth | meshHeight | vertOffset | colorOffset) < 0) { 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (meshWidth == 0 || meshHeight == 0) { 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int count = (meshWidth + 1) * (meshHeight + 1); 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we mul by 2 since we need two floats per vertex 13489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(verts.length, vertOffset, count * 2); 13499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (colors != null) { 13509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // no mul by 2, since we need only 1 color per vertex 13519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(colors.length, colorOffset, count); 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeDrawBitmapMesh(mNativeCanvas, bitmap.ni(), meshWidth, meshHeight, 1354f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy verts, vertOffset, colors, colorOffset, 1355f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint != null ? paint.mNativePaint : 0); 13569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1357f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 13589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum VertexMode { 13599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLES(0), 13609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLE_STRIP(1), 13619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLE_FAN(2); 13629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project VertexMode(int nativeInt) { 13649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = nativeInt; 13659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1366a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy 1367a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy /** 1368a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy * @hide 1369a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy */ 1370a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy public final int nativeInt; 13719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the array of vertices, interpreted as triangles (based on mode). The 13759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * verts array is required, and specifies the x,y pairs for each vertex. If 13769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * texs is non-null, then it is used to specify the coordinate in shader 13779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinates to use at each vertex (the paint must have a shader in this 13789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * case). If there is no texs array, but there is a color array, then each 13799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color is interpolated across its corresponding triangle in a gradient. If 13809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * both texs and colors arrays are present, then they behave as before, but 13819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the resulting color at each pixels is the result of multiplying the 13829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * colors from the shader and the color-gradient together. The indices array 13839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is optional, but if it is present, then it is used to specify the index 13849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of each triangle, rather than just walking through the arrays in order. 13859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode How to interpret the array of vertices 13879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertexCount The number of values in the vertices array (and 13889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * corresponding texs and colors arrays if non-null). Each logical 13899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex is two values (x, y), vertexCount must be a multiple of 2. 13909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param verts Array of vertices for the mesh 13919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertOffset Number of values in the verts to skip before drawing. 13929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param texs May be null. If not null, specifies the coordinates to sample 13939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * into the current shader (e.g. bitmap tile or gradient) 13949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param texOffset Number of values in texs to skip before drawing. 13959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors May be null. If not null, specifies a color for each 13969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex, to be interpolated across the triangle. 13979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colorOffset Number of values in colors to skip before drawing. 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param indices If not null, array of indices to reference into the 13999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex (texs, colors) array. 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param indexCount number of entries in the indices array (if not null). 14019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint Specifies the shader to use if the texs array is non-null. 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1403f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawVertices(VertexMode mode, int vertexCount, float[] verts, int vertOffset, 1404f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy float[] texs, int texOffset, int[] colors, int colorOffset, 1405f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy short[] indices, int indexOffset, int indexCount, Paint paint) { 14069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(verts.length, vertOffset, vertexCount); 14079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (texs != null) { 14089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(texs.length, texOffset, vertexCount); 14099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (colors != null) { 141192ce5734b52ef014c80cc6335112a027188b3eb6Erik Faye-Lund checkRange(colors.length, colorOffset, vertexCount / 2); 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (indices != null) { 14149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(indices.length, indexOffset, indexCount); 14159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeDrawVertices(mNativeCanvas, mode.nativeInt, vertexCount, verts, 1417f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy vertOffset, texs, texOffset, colors, colorOffset, 1418f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy indices, indexOffset, indexCount, paint.mNativePaint); 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 142036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat 14219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. The 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin is interpreted based on the Align setting in the paint. 14249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 14269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of the origin of the text being drawn 14289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 14299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1430f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawText(char[] text, int index, int count, float x, float y, Paint paint) { 14319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((index | count | (index + count) | 14329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project (text.length - index - count)) < 0) { 14339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 14349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1435da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio native_drawText(mNativeCanvas, text, index, count, x, y, paint.mBidiFlags, 1436a033630e805c407080221e20b236b6054f324670Raph Levien paint.mNativePaint, paint.mNativeTypeface); 14379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. The 14419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin is interpreted based on the Align setting in the paint. 14429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 14449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 14459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of the origin of the text being drawn 14469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 14479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1448f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt public void drawText(String text, float x, float y, Paint paint) { 1449da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio native_drawText(mNativeCanvas, text, 0, text.length(), x, y, paint.mBidiFlags, 1450a033630e805c407080221e20b236b6054f324670Raph Levien paint.mNativePaint, paint.mNativeTypeface); 1451f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. 14559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The origin is interpreted based on the Align setting in the paint. 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 14589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param start The index of the first character in text to draw 14599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param end (end - 1) is the index of the last character in text to draw 14609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 14619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of the origin of the text being drawn 14629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 14639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1464f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawText(String text, int start, int end, float x, float y, Paint paint) { 14659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((start | end | (end - start) | (text.length() - end)) < 0) { 14669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 14679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1468da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio native_drawText(mNativeCanvas, text, start, end, x, y, paint.mBidiFlags, 1469a033630e805c407080221e20b236b6054f324670Raph Levien paint.mNativePaint, paint.mNativeTypeface); 14709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified range of text, specified by start/end, with its 14749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin at (x,y), in the specified Paint. The origin is interpreted 14759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * based on the Align setting in the Paint. 14769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 14789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param start The index of the first character in text to draw 14799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param end (end - 1) is the index of the last character in text 14809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to draw 14819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of origin for where to draw the text 14829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of origin for where to draw the text 14839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 14849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1485f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawText(CharSequence text, int start, int end, float x, float y, Paint paint) { 14869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (text instanceof String || text instanceof SpannedString || 14879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project text instanceof SpannableString) { 1488da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio native_drawText(mNativeCanvas, text.toString(), start, end, x, y, 1489a033630e805c407080221e20b236b6054f324670Raph Levien paint.mBidiFlags, paint.mNativePaint, paint.mNativeTypeface); 1490f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else if (text instanceof GraphicsOperations) { 14919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ((GraphicsOperations) text).drawText(this, start, end, x, y, 1492f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint); 1493f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else { 1494f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt char[] buf = TemporaryBuffer.obtain(end - start); 1495f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt TextUtils.getChars(text, start, end, buf, 0); 1496da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio native_drawText(mNativeCanvas, buf, 0, end - start, x, y, 1497a033630e805c407080221e20b236b6054f324670Raph Levien paint.mBidiFlags, paint.mNativePaint, paint.mNativeTypeface); 1498f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt TemporaryBuffer.recycle(buf); 14999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1500f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1501f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1502f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1503f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * Render a run of all LTR or all RTL text, with shaping. This does not run 1504f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * bidi on the provided text, but renders it as a uniform right-to-left or 1505f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * left-to-right run, as indicated by dir. Alignment of the text is as 1506f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * determined by the Paint's TextAlign value. 1507f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * 1508f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param text the text to render 15090c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param index the start of the text to render 15100c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param count the count of chars to render 15110c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param contextIndex the start of the context for shaping. Must be 15120c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * no greater than index. 15130c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param contextCount the number of characters in the context for shaping. 15140c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * ContexIndex + contextCount must be no less than index 15150c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * + count. 1516f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param x the x position at which to draw the text 1517f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param y the y position at which to draw the text 1518da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * @param dir the run direction, either {@link #DIRECTION_LTR} or 1519da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * {@link #DIRECTION_RTL}. 1520f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param paint the paint 1521f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @hide 1522f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt */ 1523f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawTextRun(char[] text, int index, int count, int contextIndex, int contextCount, 1524da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio float x, float y, int dir, Paint paint) { 1525f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1526f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text == null) { 1527f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("text is null"); 1528f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1529f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (paint == null) { 1530f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("paint is null"); 1531f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 15320c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt if ((index | count | text.length - index - count) < 0) { 1533f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new IndexOutOfBoundsException(); 1534f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1535da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio if (dir != DIRECTION_LTR && dir != DIRECTION_RTL) { 1536da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio throw new IllegalArgumentException("unknown dir: " + dir); 1537da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio } 1538f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 15390c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt native_drawTextRun(mNativeCanvas, text, index, count, 1540a033630e805c407080221e20b236b6054f324670Raph Levien contextIndex, contextCount, x, y, dir, paint.mNativePaint, paint.mNativeTypeface); 1541f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1542f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1543f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1544f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * Render a run of all LTR or all RTL text, with shaping. This does not run 1545f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * bidi on the provided text, but renders it as a uniform right-to-left or 1546f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * left-to-right run, as indicated by dir. Alignment of the text is as 1547f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * determined by the Paint's TextAlign value. 15480c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * 1549f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param text the text to render 1550f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param start the start of the text to render. Data before this position 1551f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * can be used for shaping context. 1552f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param end the end of the text to render. Data at or after this 1553f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * position can be used for shaping context. 1554f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param x the x position at which to draw the text 1555f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param y the y position at which to draw the text 1556da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * @param dir the run direction, either 0 for LTR or 1 for RTL. 1557f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param paint the paint 1558f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @hide 1559f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt */ 1560f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawTextRun(CharSequence text, int start, int end, int contextStart, int contextEnd, 1561da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio float x, float y, int dir, Paint paint) { 1562f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1563f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text == null) { 1564f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("text is null"); 1565f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1566f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (paint == null) { 1567f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("paint is null"); 1568f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1569f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if ((start | end | end - start | text.length() - end) < 0) { 1570f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new IndexOutOfBoundsException(); 1571f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1572f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1573da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio int flags = dir == 0 ? 0 : 1; 1574da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio 1575f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text instanceof String || text instanceof SpannedString || 1576f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt text instanceof SpannableString) { 15770c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt native_drawTextRun(mNativeCanvas, text.toString(), start, end, 1578a033630e805c407080221e20b236b6054f324670Raph Levien contextStart, contextEnd, x, y, flags, paint.mNativePaint, paint.mNativeTypeface); 1579f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else if (text instanceof GraphicsOperations) { 15800c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt ((GraphicsOperations) text).drawTextRun(this, start, end, 1581da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio contextStart, contextEnd, x, y, flags, paint); 1582f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else { 15830c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int contextLen = contextEnd - contextStart; 15840c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int len = end - start; 15850c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt char[] buf = TemporaryBuffer.obtain(contextLen); 15860c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt TextUtils.getChars(text, contextStart, contextEnd, buf, 0); 15870c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt native_drawTextRun(mNativeCanvas, buf, start - contextStart, len, 1588a033630e805c407080221e20b236b6054f324670Raph Levien 0, contextLen, x, y, flags, paint.mNativePaint, paint.mNativeTypeface); 15899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TemporaryBuffer.recycle(buf); 15909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text in the array, with each character's origin specified by 15959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the pos array. 159662b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * 159762b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * This method does not support glyph composition and decomposition and 159862b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * should therefore not be used to render complex scripts. 15999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 16019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index The index of the first character to draw 16029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of characters to draw, starting from index. 16039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pos Array of [x,y] positions, used to position each 16049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * character 16059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 16069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1607f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 1608f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawPosText(char[] text, int index, int count, float[] pos, Paint paint) { 16099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (index < 0 || index + count > text.length || count*2 > pos.length) { 16109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 16119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawPosText(mNativeCanvas, text, index, count, pos, 1613f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint.mNativePaint); 16149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text in the array, with each character's origin specified by 16189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the pos array. 161962b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * 162062b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * This method does not support glyph composition and decomposition and 162162b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * should therefore not be used to render complex scripts. 16229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 16249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pos Array of [x,y] positions, used to position each character 16259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 16269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1627f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 16289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPosText(String text, float[] pos, Paint paint) { 16299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (text.length()*2 > pos.length) { 16309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 16319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawPosText(mNativeCanvas, text, pos, paint.mNativePaint); 16339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint, along 16379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified path. The paint's Align setting determins where along the 16389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * path to start the text. 16399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 16419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path the text should follow for its baseline 16429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hOffset The distance along the path to add to the text's 16439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * starting position 16449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vOffset The distance above(-) or below(+) the path to position 16459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the text 16469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 16479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawTextOnPath(char[] text, int index, int count, Path path, 1649f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy float hOffset, float vOffset, Paint paint) { 16509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (index < 0 || index + count > text.length) { 16519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 16529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawTextOnPath(mNativeCanvas, text, index, count, 1654f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy path.ni(), hOffset, vOffset, 1655f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint.mBidiFlags, paint.mNativePaint); 16569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint, along 16609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified path. The paint's Align setting determins where along the 16619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * path to start the text. 16629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 16649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path the text should follow for its baseline 16659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hOffset The distance along the path to add to the text's 16669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * starting position 16679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vOffset The distance above(-) or below(+) the path to position 16689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the text 16699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 16709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1671f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawTextOnPath(String text, Path path, float hOffset, float vOffset, Paint paint) { 16729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (text.length() > 0) { 1673f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy native_drawTextOnPath(mNativeCanvas, text, path.ni(), hOffset, vOffset, 1674da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio paint.mBidiFlags, paint.mNativePaint); 16759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Save the canvas state, draw the picture, and restore the canvas state. 16809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This differs from picture.draw(canvas), which does not perform any 16819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * save/restore. 1682cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * 1683cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * <p> 1684cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * <strong>Note:</strong> This forces the picture to internally call 1685cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * {@link Picture#endRecording} in order to prepare for playback. 16869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param picture The picture to be drawn 16889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPicture(Picture picture) { 16909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project picture.endRecording(); 1691667fe1039feae068d3333de8fb7115313f4a517bJonathan Dixon int restoreCount = save(); 1692667fe1039feae068d3333de8fb7115313f4a517bJonathan Dixon picture.draw(this); 1693667fe1039feae068d3333de8fb7115313f4a517bJonathan Dixon restoreToCount(restoreCount); 16949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the picture, stretched to fit into the dst rectangle. 16989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPicture(Picture picture, RectF dst) { 17009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project save(); 17019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(dst.left, dst.top); 17029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (picture.getWidth() > 0 && picture.getHeight() > 0) { 1703f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy scale(dst.width() / picture.getWidth(), dst.height() / picture.getHeight()); 17049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPicture(picture); 17069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project restore(); 17079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the picture, stretched to fit into the dst rectangle. 17119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPicture(Picture picture, Rect dst) { 17139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project save(); 17149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(dst.left, dst.top); 17159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (picture.getWidth() > 0 && picture.getHeight() > 0) { 1716f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy scale((float) dst.width() / picture.getWidth(), 1717f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy (float) dst.height() / picture.getHeight()); 17189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPicture(picture); 17209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project restore(); 17219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1722da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy 1723da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy /** 1724ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov * Releases the resources associated with this canvas. 1725ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov * 1726ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov * @hide 1727ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov */ 1728ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov public void release() { 1729ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov mFinalizer.dispose(); 1730ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov } 1731ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 1732ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov /** 1733163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * Free up as much memory as possible from private caches (e.g. fonts, images) 1734caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed * 1735163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @hide 1736caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed */ 1737caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed public static native void freeCaches(); 1738caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed 173930ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio /** 174030ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * Free up text layout caches 174130ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * 174230ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * @hide 174330ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio */ 174430ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio public static native void freeTextLayoutCaches(); 174530ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio 174636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native long initRaster(long nativeBitmapOrZero); 174736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void copyNativeCanvasState(long nativeSrcCanvas, 174836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeDstCanvas); 174936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native int native_saveLayer(long nativeCanvas, 175036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat RectF bounds, 175136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint, 175236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int layerFlags); 175336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native int native_saveLayer(long nativeCanvas, float l, 17549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float t, float r, float b, 175536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint, 175636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int layerFlags); 175736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native int native_saveLayerAlpha(long nativeCanvas, 17589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project RectF bounds, int alpha, 17599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int layerFlags); 176036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native int native_saveLayerAlpha(long nativeCanvas, float l, 17619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float t, float r, float b, 17629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int alpha, int layerFlags); 17639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 176436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_concat(long nativeCanvas, 176536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix); 176636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_setMatrix(long nativeCanvas, 176736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix); 176836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_clipRect(long nativeCanvas, 17699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 17709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float right, float bottom, 17719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 177236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_clipPath(long nativeCanvas, 177336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePath, 17749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 177536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_clipRegion(long nativeCanvas, 177636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeRegion, 17779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 177836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeSetDrawFilter(long nativeCanvas, 177936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeFilter); 178036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_getClipBounds(long nativeCanvas, 17819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect bounds); 178236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_getCTM(long nativeCanvas, 178336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix); 178436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_quickReject(long nativeCanvas, 1785ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger RectF rect); 178636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_quickReject(long nativeCanvas, 178736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePath); 178836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_quickReject(long nativeCanvas, 17899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 1790ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger float right, float bottom); 179136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawRGB(long nativeCanvas, int r, int g, 17929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int b); 179336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawARGB(long nativeCanvas, int a, int r, 17949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int g, int b); 179536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawColor(long nativeCanvas, int color); 179636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawColor(long nativeCanvas, int color, 17979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mode); 179836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawPaint(long nativeCanvas, 179936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 180036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawLine(long nativeCanvas, float startX, 18019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float startY, float stopX, 180236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float stopY, long nativePaint); 180336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawRect(long nativeCanvas, RectF rect, 180436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 180536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawRect(long nativeCanvas, float left, 18069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float top, float right, 180736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float bottom, 180836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 180936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawOval(long nativeCanvas, RectF oval, 181036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 181136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawCircle(long nativeCanvas, float cx, 18129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float cy, float radius, 181336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 181436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawArc(long nativeCanvas, RectF oval, 18159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float startAngle, float sweep, 181636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat boolean useCenter, 181736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 181836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawRoundRect(long nativeCanvas, 18199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project RectF rect, float rx, 182036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float ry, long nativePaint); 182136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawPath(long nativeCanvas, 182236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePath, 182336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 182436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private native void native_drawBitmap(long nativeCanvas, long nativeBitmap, 18259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 182636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaintOrZero, 18270d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int canvasDensity, 18280d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int screenDensity, 18290d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int bitmapDensity); 183036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private native void native_drawBitmap(long nativeCanvas, long nativeBitmap, 18319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect src, RectF dst, 183236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaintOrZero, 18330d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int screenDensity, 18340d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int bitmapDensity); 183536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawBitmap(long nativeCanvas, 183636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeBitmap, 18379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect src, Rect dst, 183836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaintOrZero, 18390d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int screenDensity, 18400d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int bitmapDensity); 184136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawBitmap(long nativeCanvas, int[] colors, 18429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offset, int stride, float x, 18439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float y, int width, int height, 18449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean hasAlpha, 184536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaintOrZero); 184636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeDrawBitmapMatrix(long nativeCanvas, 184736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeBitmap, 184836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix, 184936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 185036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeDrawBitmapMesh(long nativeCanvas, 185136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeBitmap, 18529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int meshWidth, int meshHeight, 18539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] verts, int vertOffset, 185436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int[] colors, int colorOffset, 185536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 185636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeDrawVertices(long nativeCanvas, int mode, int n, 18579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] verts, int vertOffset, float[] texs, int texOffset, 18589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] colors, int colorOffset, short[] indices, 185936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int indexOffset, int indexCount, long nativePaint); 186036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat 186136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawText(long nativeCanvas, char[] text, 18629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int index, int count, float x, 186336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float y, int flags, long nativePaint, 186436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeTypeface); 186536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawText(long nativeCanvas, String text, 18669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int start, int end, float x, 186736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float y, int flags, long nativePaint, 186836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeTypeface); 1869fcf2be1846935e7983ea2fe87fdd4d7af27764b6Fabrice Di Meglio 187036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextRun(long nativeCanvas, String text, 18710c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int start, int end, int contextStart, int contextEnd, 187236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float x, float y, int flags, long nativePaint, long nativeTypeface); 1873f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 187436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextRun(long nativeCanvas, char[] text, 18750c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int start, int count, int contextStart, int contextCount, 187636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float x, float y, int flags, long nativePaint, long nativeTypeface); 1877f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 187836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawPosText(long nativeCanvas, 18799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char[] text, int index, 18809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int count, float[] pos, 188136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 188236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawPosText(long nativeCanvas, 18839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String text, float[] pos, 188436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 188536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextOnPath(long nativeCanvas, 18869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char[] text, int index, 188736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int count, long nativePath, 18889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float hOffset, 1889da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio float vOffset, int bidiFlags, 189036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 189136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextOnPath(long nativeCanvas, 189236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat String text, long nativePath, 189336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float hOffset, 189436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float vOffset, 189536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int flags, long nativePaint); 189636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void finalizer(long nativeCanvas); 18979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1898