Canvas.java revision 95d49149cc7fff87a18449fa661454c1b5ddbd30
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 425c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita private long mNativeCanvasWrapper; 43c677675e9c465dc1de21ecf2e0421835c7eb55b4Florin Malita 44ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov /** @hide */ 455c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita public long getNativeCanvasWrapper() { 465c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return mNativeCanvasWrapper; 47c677675e9c465dc1de21ecf2e0421835c7eb55b4Florin Malita } 48ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 49e0aa84b7dc087e999e20055dcc04cb6a48d5bd62Romain Guy // may be null 50e0aa84b7dc087e999e20055dcc04cb6a48d5bd62Romain Guy private Bitmap mBitmap; 51ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // optional field set by the caller 53ce0537b80087a6225273040a987414b1dd081aa0Romain Guy private DrawFilter mDrawFilter; 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 55ce0537b80087a6225273040a987414b1dd081aa0Romain Guy /** 56ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * @hide 57ce0537b80087a6225273040a987414b1dd081aa0Romain Guy */ 58ce0537b80087a6225273040a987414b1dd081aa0Romain Guy protected int mDensity = Bitmap.DENSITY_NONE; 590d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn 60ce0537b80087a6225273040a987414b1dd081aa0Romain Guy /** 61ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * Used to determine when compatibility scaling is in effect. 62ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * 63ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * @hide 64ce0537b80087a6225273040a987414b1dd081aa0Romain Guy */ 65ce0537b80087a6225273040a987414b1dd081aa0Romain Guy protected int mScreenDensity = Bitmap.DENSITY_NONE; 6611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Used by native code 68f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy @SuppressWarnings("UnusedDeclaration") 69e0aa84b7dc087e999e20055dcc04cb6a48d5bd62Romain Guy private int mSurfaceFormat; 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 71da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio /** 72da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * Flag for drawTextRun indicating left-to-right run direction. 73da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * @hide 74da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio */ 75da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio public static final int DIRECTION_LTR = 0; 76da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio 77da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio /** 78da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * Flag for drawTextRun indicating right-to-left run direction. 79da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * @hide 80da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio */ 81da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio public static final int DIRECTION_RTL = 1; 82da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio 83f61970fc79e9c5cf340fa942597628242361864aRomain Guy // Maximum bitmap size as defined in Skia's native code 84f61970fc79e9c5cf340fa942597628242361864aRomain Guy // (see SkCanvas.cpp, SkDraw.cpp) 85f61970fc79e9c5cf340fa942597628242361864aRomain Guy private static final int MAXMIMUM_BITMAP_SIZE = 32766; 86f61970fc79e9c5cf340fa942597628242361864aRomain Guy 874a317db43d2bbc992284dd1f651751f13734d017Romain Guy // This field is used to finalize the native Canvas properly 88e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy private final CanvasFinalizer mFinalizer; 89e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 90ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov private static final class CanvasFinalizer { 915c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita private long mNativeCanvasWrapper; 92e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 9336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat public CanvasFinalizer(long nativeCanvas) { 945c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita mNativeCanvasWrapper = nativeCanvas; 95e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 96e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 97e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy @Override 98e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy protected void finalize() throws Throwable { 993b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy try { 100ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov dispose(); 1013b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy } finally { 1023b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy super.finalize(); 103e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 104e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 105ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 106ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov public void dispose() { 1075c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita if (mNativeCanvasWrapper != 0) { 1085c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita finalizer(mNativeCanvasWrapper); 1095c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita mNativeCanvasWrapper = 0; 110ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov } 111ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov } 112e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 113e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 114f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Construct an empty raster canvas. Use setBitmap() to specify a bitmap to 11696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * draw into. The initial target density is {@link Bitmap#DENSITY_NONE}; 11796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * this will typically be replaced when a target bitmap is set for the 11896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * canvas. 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Canvas() { 121003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy if (!isHardwareAccelerated()) { 122003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy // 0 means no native bitmap 1235c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita mNativeCanvasWrapper = initRaster(0); 1245c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita mFinalizer = new CanvasFinalizer(mNativeCanvasWrapper); 125003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy } else { 126003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy mFinalizer = null; 127003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy } 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Construct a canvas with the specified bitmap to draw into. The bitmap 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * must be mutable. 13396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * 13496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>The initial target density of the canvas is the same as the given 13596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * bitmap's density. 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap Specifies a mutable bitmap for the canvas to draw into. 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Canvas(Bitmap bitmap) { 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!bitmap.isMutable()) { 141f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy throw new IllegalStateException("Immutable bitmap passed to Canvas constructor"); 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1431abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 1445c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita mNativeCanvasWrapper = initRaster(bitmap.ni()); 1455c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita mFinalizer = new CanvasFinalizer(mNativeCanvasWrapper); 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBitmap = bitmap; 14796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn mDensity = bitmap.mDensity; 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 149ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 150ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov /** @hide */ 15136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat public Canvas(long nativeCanvas) { 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (nativeCanvas == 0) { 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(); 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1555c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita mNativeCanvasWrapper = initCanvas(nativeCanvas); 1565c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita mFinalizer = new CanvasFinalizer(mNativeCanvasWrapper); 15796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn mDensity = Bitmap.getDefaultDensity(); 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 159163935113919a184122b8b3bd672ef08c8df65dcRomain Guy 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 161091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik * Returns null. 162c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * 163091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik * @deprecated This method is not supported and should not be invoked. 164c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * 165091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik * @hide 166091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik */ 167091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik @Deprecated 168091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik protected GL getGL() { 169091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik return null; 170091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik } 171091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik 172091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik /** 1732d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * Indicates whether this Canvas uses hardware acceleration. 1742d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * 1752d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * Note that this method does not define what type of hardware acceleration 1762d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * may or may not be used. 1772d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * 1782d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * @return True if drawing operations are hardware accelerated, 1792d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * false otherwise. 1802d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy */ 1812d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy public boolean isHardwareAccelerated() { 182163935113919a184122b8b3bd672ef08c8df65dcRomain Guy return false; 183caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed } 184163935113919a184122b8b3bd672ef08c8df65dcRomain Guy 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1863bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * Specify a bitmap for the canvas to draw into. All canvas state such as 1873bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * layers, filters, and the save/restore stack are reset with the exception 1883bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * of the current matrix and clip stack. Additionally, as a side-effect 1893bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * the canvas' target density is updated to match that of the bitmap. 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap Specifies a mutable bitmap for the canvas to draw into. 19296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @see #setDensity(int) 19396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @see #getDensity() 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setBitmap(Bitmap bitmap) { 196163935113919a184122b8b3bd672ef08c8df65dcRomain Guy if (isHardwareAccelerated()) { 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Can't set a bitmap device on a GL canvas"); 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 200fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger if (bitmap == null) { 2015c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_setBitmap(mNativeCanvasWrapper, 0, false); 202fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger mDensity = Bitmap.DENSITY_NONE; 203fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger } else { 2040965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy if (!bitmap.isMutable()) { 2050965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy throw new IllegalStateException(); 2060965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy } 2071abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 208fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger 2095c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_setBitmap(mNativeCanvasWrapper, bitmap.ni(), true); 2100965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy mDensity = bitmap.mDensity; 2110965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy } 2120965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBitmap = bitmap; 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 215c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2175c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita * setBitmap() variant for native callers with a raw bitmap handle. 2185c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita */ 2195c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita private void setNativeBitmap(long bitmapHandle) { 2205c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_setBitmap(mNativeCanvasWrapper, bitmapHandle, false); 2215c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita } 2225c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita 2235c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita /** 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the viewport dimensions if this canvas is GL based. If it is not, 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this method is ignored and no exception is thrown. 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 227163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @param width The width of the viewport 228163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @param height The height of the viewport 229c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * 230163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @hide 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 232797b95b26bbb7557678af78b9a2a61830158920fChris Craik public void setViewport(int width, int height) {} 233797b95b26bbb7557678af78b9a2a61830158920fChris Craik 234797b95b26bbb7557678af78b9a2a61830158920fChris Craik /** 235797b95b26bbb7557678af78b9a2a61830158920fChris Craik * @hide 236797b95b26bbb7557678af78b9a2a61830158920fChris Craik */ 237797b95b26bbb7557678af78b9a2a61830158920fChris Craik public void initializeLight(float lightX, float lightY, float lightZ, float lightRadius) {} 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the device that the current layer draws into is opaque 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (i.e. does not support per-pixel alpha). 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the device that the current layer draws into is opaque 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 24595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public boolean isOpaque() { 24695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_isOpaque(mNativeCanvasWrapper); 24795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the width of the current drawing layer 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the width of the current drawing layer 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 25495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int getWidth() { 25595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_getWidth(mNativeCanvasWrapper); 25695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the height of the current drawing layer 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the height of the current drawing layer 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 26395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int getHeight() { 26495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_getHeight(mNativeCanvasWrapper); 26595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 26896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>Returns the target density of the canvas. The default density is 26996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * derived from the density of its backing bitmap, or 27096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * {@link Bitmap#DENSITY_NONE} if there is not one.</p> 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 27296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @return Returns the current target density of the canvas, which is used 27396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * to determine the scaling factor when drawing a bitmap into it. 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 27511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #setDensity(int) 27611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see Bitmap#getDensity() 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 27811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getDensity() { 27911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return mDensity; 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 28396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>Specifies the density for this Canvas' backing bitmap. This modifies 28496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * the target density of the canvas itself, as well as the density of its 28596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * backing bitmap via {@link Bitmap#setDensity(int) Bitmap.setDensity(int)}. 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 28796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @param density The new target density of the canvas, which is used 28896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * to determine the scaling factor when drawing a bitmap into it. Use 28996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * {@link Bitmap#DENSITY_NONE} to disable bitmap scaling. 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 29111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #getDensity() 29211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see Bitmap#setDensity(int) 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 29411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public void setDensity(int density) { 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mBitmap != null) { 29611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn mBitmap.setDensity(density); 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 29811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn mDensity = density; 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3010d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn /** @hide */ 3020d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn public void setScreenDensity(int density) { 3030d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn mScreenDensity = density; 3040d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn } 305f61970fc79e9c5cf340fa942597628242361864aRomain Guy 306f61970fc79e9c5cf340fa942597628242361864aRomain Guy /** 307f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Returns the maximum allowed width for bitmaps drawn with this canvas. 308f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Attempting to draw with a bitmap wider than this value will result 309f61970fc79e9c5cf340fa942597628242361864aRomain Guy * in an error. 310f61970fc79e9c5cf340fa942597628242361864aRomain Guy * 311f61970fc79e9c5cf340fa942597628242361864aRomain Guy * @see #getMaximumBitmapHeight() 312f61970fc79e9c5cf340fa942597628242361864aRomain Guy */ 313f61970fc79e9c5cf340fa942597628242361864aRomain Guy public int getMaximumBitmapWidth() { 314f61970fc79e9c5cf340fa942597628242361864aRomain Guy return MAXMIMUM_BITMAP_SIZE; 315f61970fc79e9c5cf340fa942597628242361864aRomain Guy } 3160d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn 317f61970fc79e9c5cf340fa942597628242361864aRomain Guy /** 318f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Returns the maximum allowed height for bitmaps drawn with this canvas. 319f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Attempting to draw with a bitmap taller than this value will result 320f61970fc79e9c5cf340fa942597628242361864aRomain Guy * in an error. 321f61970fc79e9c5cf340fa942597628242361864aRomain Guy * 322f61970fc79e9c5cf340fa942597628242361864aRomain Guy * @see #getMaximumBitmapWidth() 323f61970fc79e9c5cf340fa942597628242361864aRomain Guy */ 324f61970fc79e9c5cf340fa942597628242361864aRomain Guy public int getMaximumBitmapHeight() { 325f61970fc79e9c5cf340fa942597628242361864aRomain Guy return MAXMIMUM_BITMAP_SIZE; 326f61970fc79e9c5cf340fa942597628242361864aRomain Guy } 327f61970fc79e9c5cf340fa942597628242361864aRomain Guy 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // the SAVE_FLAG constants must match their native equivalents 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** restore the current matrix when restore() is called */ 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MATRIX_SAVE_FLAG = 0x01; 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** restore the current clip when restore() is called */ 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CLIP_SAVE_FLAG = 0x02; 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** the layer needs to per-pixel alpha */ 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int HAS_ALPHA_LAYER_SAVE_FLAG = 0x04; 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** the layer needs to 8-bits per color component */ 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FULL_COLOR_LAYER_SAVE_FLAG = 0x08; 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** clip against the layer's bounds */ 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CLIP_TO_LAYER_SAVE_FLAG = 0x10; 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** restore everything when restore() is called */ 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ALL_SAVE_FLAG = 0x1F; 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Saves the current matrix and clip onto a private stack. Subsequent 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calls to translate,scale,rotate,skew,concat or clipRect,clipPath 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will all operate as usual, but when the balancing call to restore() 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is made, those calls will be forgotten, and the settings that existed 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * before the save() will be reinstated. 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The value to pass to restoreToCount() to balance this save() 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 35295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int save() { 35395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_save(mNativeCanvasWrapper, MATRIX_SAVE_FLAG | CLIP_SAVE_FLAG); 35495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Based on saveFlags, can save the current matrix and clip onto a private 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * stack. Subsequent calls to translate,scale,rotate,skew,concat or 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect,clipPath will all operate as usual, but when the balancing 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * call to restore() is made, those calls will be forgotten, and the 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * settings that existed before the save() will be reinstated. 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveFlags flag bits that specify which parts of the Canvas state 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to save/restore 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The value to pass to restoreToCount() to balance this save() 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 36795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int save(int saveFlags) { 36895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_save(mNativeCanvasWrapper, saveFlags); 36995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This behaves the same as save(), but in addition it allocates an 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * offscreen bitmap. All drawing calls are directed there, and only when 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the balancing call to restore() is made is that offscreen transfered to 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the canvas (or the previous layer). Subsequent calls to translate, 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * scale, rotate, skew, concat or clipRect, clipPath all operate on this 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * copy. When the balancing call to restore() is made, this copy is 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * deleted and the previous matrix/clip state is restored. 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds May be null. The maximum size the offscreen bitmap 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * needs to be (in local coordinates) 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint This is copied, and is applied to the offscreen when 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * restore() is called. 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveFlags see _SAVE_FLAG constants 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return value to pass to restoreToCount() to balance this save() 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int saveLayer(RectF bounds, Paint paint, int saveFlags) { 38895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_saveLayer(mNativeCanvasWrapper, 38995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita bounds.left, bounds.top, bounds.right, bounds.bottom, 390f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint != null ? paint.mNativePaint : 0, 391f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy saveFlags); 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 393c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 394c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 395c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Convenience for saveLayer(bounds, paint, {@link #ALL_SAVE_FLAG}) 396c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 397c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik public int saveLayer(RectF bounds, Paint paint) { 398c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayer(bounds, paint, ALL_SAVE_FLAG); 399c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 400c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper version of saveLayer() that takes 4 values rather than a RectF. 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 404f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public int saveLayer(float left, float top, float right, float bottom, Paint paint, 405f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy int saveFlags) { 4065c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_saveLayer(mNativeCanvasWrapper, left, top, right, bottom, 407f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint != null ? paint.mNativePaint : 0, 408f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy saveFlags); 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 412c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Convenience for saveLayer(left, top, right, bottom, paint, {@link #ALL_SAVE_FLAG}) 413c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 414c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik public int saveLayer(float left, float top, float right, float bottom, Paint paint) { 415c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayer(left, top, right, bottom, paint, ALL_SAVE_FLAG); 416c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 417c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 418c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This behaves the same as save(), but in addition it allocates an 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * offscreen bitmap. All drawing calls are directed there, and only when 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the balancing call to restore() is made is that offscreen transfered to 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the canvas (or the previous layer). Subsequent calls to translate, 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * scale, rotate, skew, concat or clipRect, clipPath all operate on this 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * copy. When the balancing call to restore() is made, this copy is 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * deleted and the previous matrix/clip state is restored. 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds The maximum size the offscreen bitmap needs to be 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (in local coordinates) 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param alpha The alpha to apply to the offscreen when when it is 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawn during restore() 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveFlags see _SAVE_FLAG constants 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return value to pass to restoreToCount() to balance this call 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int saveLayerAlpha(RectF bounds, int alpha, int saveFlags) { 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project alpha = Math.min(255, Math.max(0, alpha)); 43695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_saveLayerAlpha(mNativeCanvasWrapper, 43795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita bounds.left, bounds.top, bounds.right, bounds.bottom, 43895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita alpha, saveFlags); 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 440c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 441c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 442c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Convenience for saveLayerAlpha(bounds, alpha, {@link #ALL_SAVE_FLAG}) 443c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 444c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik public int saveLayerAlpha(RectF bounds, int alpha) { 445c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayerAlpha(bounds, alpha, ALL_SAVE_FLAG); 446c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 447c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for saveLayerAlpha() that takes 4 values instead of a RectF. 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 451f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public int saveLayerAlpha(float left, float top, float right, float bottom, int alpha, 452f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy int saveFlags) { 4535c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_saveLayerAlpha(mNativeCanvasWrapper, left, top, right, bottom, 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project alpha, saveFlags); 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 458c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Helper for saveLayerAlpha(left, top, right, bottom, alpha, {@link #ALL_SAVE_FLAG}) 459c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 460c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik public int saveLayerAlpha(float left, float top, float right, float bottom, int alpha) { 461c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayerAlpha(left, top, right, bottom, alpha, ALL_SAVE_FLAG); 462c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 463c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 464c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This call balances a previous call to save(), and is used to remove all 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * modifications to the matrix/clip state since the last save call. It is 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an error to call restore() more times than save() was called. 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 46995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void restore() { 47095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_restore(mNativeCanvasWrapper); 47195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the number of matrix/clip states on the Canvas' private stack. 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This will equal # save() calls - # restore() calls. 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 47795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int getSaveCount() { 47895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_getSaveCount(mNativeCanvasWrapper); 47995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Efficient way to pop any calls to save() that happened after the save 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * count reached saveCount. It is an error for saveCount to be less than 1. 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Example: 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * int count = canvas.save(); 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ... // more calls potentially to save() 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * canvas.restoreToCount(count); 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * // now the canvas is back in the same state it was before the initial 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * // call to save(). 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveCount The save level to restore to. 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 49495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void restoreToCount(int saveCount) { 49595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_restoreToCount(mNativeCanvasWrapper, saveCount); 49695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified translation 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dx The distance to translate in X 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dy The distance to translate in Y 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 50495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void translate(float dx, float dy) { 50595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_translate(mNativeCanvasWrapper, dx, dy); 50695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified scale. 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to scale in X 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to scale in Y 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 51495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void scale(float sx, float sy) { 51595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_scale(mNativeCanvasWrapper, sx, sy); 51695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified scale. 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to scale in X 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to scale in Y 523cc3ec6cdb2b892eb29513e72d8b205acbe997b25Gilles Debunne * @param px The x-coord for the pivot point (unchanged by the scale) 524cc3ec6cdb2b892eb29513e72d8b205acbe997b25Gilles Debunne * @param py The y-coord for the pivot point (unchanged by the scale) 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void scale(float sx, float sy, float px, float py) { 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(px, py); 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project scale(sx, sy); 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(-px, -py); 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified rotation. 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param degrees The amount to rotate, in degrees 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 53795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void rotate(float degrees) { 53895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_rotate(mNativeCanvasWrapper, degrees); 53995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified rotation. 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param degrees The amount to rotate, in degrees 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param px The x-coord for the pivot point (unchanged by the rotation) 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param py The y-coord for the pivot point (unchanged by the rotation) 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void rotate(float degrees, float px, float py) { 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(px, py); 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project rotate(degrees); 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(-px, -py); 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified skew. 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to skew in X 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to skew in Y 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 56095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void skew(float sx, float sy) { 56195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_skew(mNativeCanvasWrapper, sx, sy); 56295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5654e7b772b733593fbe25c733e95b8dcea293234b6Romain Guy * Preconcat the current matrix with the specified matrix. If the specified 5664e7b772b733593fbe25c733e95b8dcea293234b6Romain Guy * matrix is null, this method does nothing. 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix to preconcatenate with the current matrix 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void concat(Matrix matrix) { 5715c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita if (matrix != null) native_concat(mNativeCanvasWrapper, matrix.native_instance); 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Completely replace the current matrix with the specified matrix. If the 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * matrix parameter is null, then the current matrix is reset to identity. 577f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * 578f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * <strong>Note:</strong> it is recommended to use {@link #concat(Matrix)}, 579f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * {@link #scale(float, float)}, {@link #translate(float, float)} and 580f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * {@link #rotate(float)} instead of this method. 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix to replace the current matrix with. If it is 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * null, set the current matrix to identity. 584f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * 585f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * @see #concat(Matrix) 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setMatrix(Matrix matrix) { 5885c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_setMatrix(mNativeCanvasWrapper, 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project matrix == null ? 0 : matrix.native_instance); 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return, in ctm, the current transformation matrix. This does not alter 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the matrix in the canvas, but just returns a copy of it. 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 596f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void getMatrix(Matrix ctm) { 5985c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_getCTM(mNativeCanvasWrapper, ctm.native_instance); 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 60041030da16856c8869e1e51d4a0405432fa96614eRomain Guy 60141030da16856c8869e1e51d4a0405432fa96614eRomain Guy /** 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a new matrix with a copy of the canvas' current transformation 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * matrix. 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 60565447287cb4112cf74483c87be70bcd00b622e2dRomain Guy @Deprecated 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final Matrix getMatrix() { 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Matrix m = new Matrix(); 608f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy //noinspection deprecation 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getMatrix(m); 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return m; 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle. 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rect to intersect with the current clip 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipRect(RectF rect, Region.Op op) { 6215c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom, 622f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy op.nativeInt); 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle, which is 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipRect(Rect rect, Region.Op op) { 6345c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom, 635f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy op.nativeInt); 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 64595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public boolean clipRect(RectF rect) { 64695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_clipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom, 64795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita Region.Op.INTERSECT.nativeInt); 64895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 64995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 65795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public boolean clipRect(Rect rect) { 65895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_clipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom, 65995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita Region.Op.INTERSECT.nativeInt); 66095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify 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 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 677f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public boolean clipRect(float left, float top, float right, float bottom, Region.Op op) { 6785c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipRect(mNativeCanvasWrapper, left, top, right, bottom, op.nativeInt); 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current clip 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 69495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public boolean clipRect(float left, float top, float right, float bottom) { 69595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_clipRect(mNativeCanvasWrapper, left, top, right, bottom, 69695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita Region.Op.INTERSECT.nativeInt); 69795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 698f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current clip 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 71295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public boolean clipRect(int left, int top, int right, int bottom) { 71395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_clipRect(mNativeCanvasWrapper, left, top, right, bottom, 71495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita Region.Op.INTERSECT.nativeInt); 71595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 716f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified path. 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to operate on the current clip 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipPath(Path path, Region.Op op) { 7255c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipPath(mNativeCanvasWrapper, path.ni(), op.nativeInt); 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified path. 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to intersect with the current clip 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipPath(Path path) { 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return clipPath(path, Region.Op.INTERSECT); 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified region. Note that unlike 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect() and clipPath() which transform their arguments by the 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, clipRegion() assumes its argument is already in the 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinate system of the current layer's bitmap, and so not 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * transformation is performed. 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param region The region to operate on the current clip, based on op 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 7480d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * 7490d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * @deprecated Unlike all other clip calls this API does not respect the 7500d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * current matrix. Use {@link #clipRect(Rect)} as an alternative. 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipRegion(Region region, Region.Op op) { 7535c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipRegion(mNativeCanvasWrapper, region.ni(), op.nativeInt); 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified region. Note that unlike 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect() and clipPath() which transform their arguments by the 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, clipRegion() assumes its argument is already in the 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinate system of the current layer's bitmap, and so not 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * transformation is performed. 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param region The region to operate on the current clip, based on op 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 7650d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * 7660d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * @deprecated Unlike all other clip calls this API does not respect the 7670d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * current matrix. Use {@link #clipRect(Rect)} as an alternative. 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipRegion(Region region) { 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return clipRegion(region, Region.Op.INTERSECT); 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public DrawFilter getDrawFilter() { 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mDrawFilter; 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setDrawFilter(DrawFilter filter) { 77836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeFilter = 0; 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (filter != null) { 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeFilter = filter.mNativeInt; 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDrawFilter = filter; 7835c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita nativeSetDrawFilter(mNativeCanvasWrapper, nativeFilter); 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum EdgeType { 787d320001807168f5565bab9807ef13c111096bbb3Chet Haase 788d320001807168f5565bab9807ef13c111096bbb3Chet Haase /** 789d320001807168f5565bab9807ef13c111096bbb3Chet Haase * Black-and-White: Treat edges by just rounding to nearest pixel boundary 790d320001807168f5565bab9807ef13c111096bbb3Chet Haase */ 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project BW(0), //!< treat edges by just rounding to nearest pixel boundary 792d320001807168f5565bab9807ef13c111096bbb3Chet Haase 793d320001807168f5565bab9807ef13c111096bbb3Chet Haase /** 794d320001807168f5565bab9807ef13c111096bbb3Chet Haase * Antialiased: Treat edges by rounding-out, since they may be antialiased 795d320001807168f5565bab9807ef13c111096bbb3Chet Haase */ 796d320001807168f5565bab9807ef13c111096bbb3Chet Haase AA(1); 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EdgeType(int nativeInt) { 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = nativeInt; 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 801c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy 802c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy /** 803c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy * @hide 804c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy */ 805c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy public final int nativeInt; 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified rectangle, after being transformed by the 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect the rect to compare with the current clip 815d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 816d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 817d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the rect (transformed by the canvas' matrix) 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean quickReject(RectF rect, EdgeType type) { 82295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_quickReject(mNativeCanvasWrapper, 82395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita rect.left, rect.top, rect.right, rect.bottom); 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified path, after being transformed by the 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). Note: for speed it may 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * return false even if the path itself might not intersect the clip 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (i.e. the bounds of the path intersects, but the path does not). 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to compare with the current clip 835d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 836d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 837d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the path (transformed by the canvas' matrix) 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean quickReject(Path path, EdgeType type) { 8425c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_quickReject(mNativeCanvasWrapper, path.ni()); 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified rectangle, after being transformed by the 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to compare with the 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to compare with the current 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to compare with the 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to compare with the 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 859d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 860d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 861d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the rect (transformed by the canvas' matrix) 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 865ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger public boolean quickReject(float left, float top, float right, float bottom, 866ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger EdgeType type) { 8675c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_quickReject(mNativeCanvasWrapper, left, top, right, bottom); 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 871708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * Return the bounds of the current clip (in local coordinates) in the 872708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * bounds parameter, and return true if it is non-empty. This can be useful 873708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * in a way similar to quickReject, in that it tells you that drawing 874708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * outside of these bounds will be clipped out. 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds Return the clip bounds here. If it is null, ignore it but 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * still return true if the current clip is non-empty. 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the current clip is non-empty. 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean getClipBounds(Rect bounds) { 8815c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_getClipBounds(mNativeCanvasWrapper, bounds); 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 885708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * Retrieve the bounds of the current clip (in local coordinates). 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the clip bounds, or [0, 0, 0, 0] if the clip is empty. 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final Rect getClipBounds() { 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect r = new Rect(); 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getClipBounds(r); 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return r; 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified RGB color, using srcover porterduff mode. 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r red component (0..255) of the color to draw onto the canvas 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param g green component (0..255) of the color to draw onto the canvas 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param b blue component (0..255) of the color to draw onto the canvas 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRGB(int r, int g, int b) { 9045c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawRGB(mNativeCanvasWrapper, r, g, b); 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified ARGB color, using srcover porterduff mode. 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param a alpha component (0..255) of the color to draw onto the canvas 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r red component (0..255) of the color to draw onto the canvas 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param g green component (0..255) of the color to draw onto the canvas 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param b blue component (0..255) of the color to draw onto the canvas 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawARGB(int a, int r, int g, int b) { 9175c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawARGB(mNativeCanvasWrapper, a, r, g, b); 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified color, using srcover porterduff mode. 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param color the color to draw onto the canvas 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawColor(int color) { 9275c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawColor(mNativeCanvasWrapper, color); 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified color and porter-duff xfermode. 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param color the color to draw with 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode the porter-duff mode to apply to the color 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawColor(int color, PorterDuff.Mode mode) { 9385c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawColor(mNativeCanvasWrapper, color, mode.nativeInt); 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified paint. This is equivalent (but faster) to drawing an 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * infinitely large rectangle with the specified paint. 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw onto the canvas 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPaint(Paint paint) { 9495c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawPaint(mNativeCanvasWrapper, paint.mNativePaint); 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a series of points. Each point is centered at the coordinate 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified by pts[], and its diameter is specified by the paint's stroke 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * width (as transformed by the canvas' CTM), with special treatment for 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a stroke width of 0, which always draws exactly 1 pixel (or at most 4 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if antialiasing is enabled). The shape of the point is controlled by 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the paint's Cap type. The shape is a square, unless the cap type is 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Round, in which case the shape is a circle. 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pts Array of points to draw [x0 y0 x1 y1 x2 y2 ...] 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Number of values to skip before starting to draw. 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of values to process, after skipping offset 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of them. Since one point uses two values, the number of 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * "points" that are drawn is really (count >> 1). 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the points 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 96895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void drawPoints(float[] pts, int offset, int count, Paint paint) { 96995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_drawPoints(mNativeCanvasWrapper, pts, offset, count, paint.mNativePaint); 97095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for drawPoints() that assumes you want to draw the entire array 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPoints(float[] pts, Paint paint) { 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPoints(pts, 0, pts.length, paint); 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for drawPoints() for drawing a single point. 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 98295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void drawPoint(float x, float y, Paint paint) { 98395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_drawPoint(mNativeCanvasWrapper, x, y, paint.mNativePaint); 98495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a line segment with the specified start and stop x,y coordinates, 988a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * using the specified paint. 989a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * 990a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * <p>Note that since a line is always "framed", the Style is ignored in the paint.</p> 991a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * 992a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * <p>Degenerate lines (length is 0) will not be drawn.</p> 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startX The x-coordinate of the start point of the line 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startY The y-coordinate of the start point of the line 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the line 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 998f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawLine(float startX, float startY, float stopX, float stopY, Paint paint) { 9995c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawLine(mNativeCanvasWrapper, startX, startY, stopX, stopY, paint.mNativePaint); 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a series of lines. Each line is taken from 4 consecutive values 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the pts array. Thus to draw 1 line, the array must contain at least 4 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * values. This is logically the same as drawing the array as follows: 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawLine(pts[0], pts[1], pts[2], pts[3]) followed by 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawLine(pts[4], pts[5], pts[6], pts[7]) and so on. 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pts Array of points to draw [x0 y0 x1 y1 x2 y2 ...] 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Number of values in the array to skip before drawing. 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of values in the array to process, after 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * skipping "offset" of them. Since each line uses 4 values, 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the number of "lines" that are drawn is really 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (count >> 2). 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the points 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 101795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void drawLines(float[] pts, int offset, int count, Paint paint) { 101895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_drawLines(mNativeCanvasWrapper, pts, offset, count, paint.mNativePaint); 101995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawLines(float[] pts, Paint paint) { 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawLines(pts, 0, pts.length, paint); 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified paint. The rectangle will 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be filled or framed based on the Style in the paint. 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rect to be drawn 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rect 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRect(RectF rect, Paint paint) { 103395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_drawRect(mNativeCanvasWrapper, 103495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita rect.left, rect.top, rect.right, rect.bottom, paint.mNativePaint); 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified Paint. The rectangle 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be filled or framed based on the Style in the paint. 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r The rectangle to be drawn. 10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rectangle 10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRect(Rect r, Paint paint) { 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawRect(r.left, r.top, r.right, r.bottom, paint); 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified paint. The rectangle will 10519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be filled or framed based on the Style in the paint. 10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to be drawn 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top side of the rectangle to be drawn 10559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to be drawn 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom side of the rectangle to be drawn 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rect 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1059f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawRect(float left, float top, float right, float bottom, Paint paint) { 10605c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawRect(mNativeCanvasWrapper, left, top, right, bottom, paint.mNativePaint); 10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified oval using the specified paint. The oval will be 10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * filled or framed based on the Style in the paint. 10669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param oval The rectangle bounds of the oval to be drawn 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawOval(RectF oval, Paint paint) { 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (oval == null) { 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10735c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawOval(mNativeCanvasWrapper, oval, paint.mNativePaint); 10749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified circle using the specified paint. If radius is <= 0, 10789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then nothing will be drawn. The circle will be filled or framed based 10799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on the Style in the paint. 10809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cx The x-coordinate of the center of the cirle to be drawn 10829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cy The y-coordinate of the center of the cirle to be drawn 10839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param radius The radius of the cirle to be drawn 10849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the circle 10859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawCircle(float cx, float cy, float radius, Paint paint) { 10875c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawCircle(mNativeCanvasWrapper, cx, cy, radius, paint.mNativePaint); 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10914a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>Draw the specified arc, which will be scaled to fit inside the 10924a317db43d2bbc992284dd1f651751f13734d017Romain Guy * specified oval.</p> 10934a317db43d2bbc992284dd1f651751f13734d017Romain Guy * 10944a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>If the start angle is negative or >= 360, the start angle is treated 10954a317db43d2bbc992284dd1f651751f13734d017Romain Guy * as start angle modulo 360.</p> 10964a317db43d2bbc992284dd1f651751f13734d017Romain Guy * 10974a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>If the sweep angle is >= 360, then the oval is drawn 10989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completely. Note that this differs slightly from SkPath::arcTo, which 10994a317db43d2bbc992284dd1f651751f13734d017Romain Guy * treats the sweep angle modulo 360. If the sweep angle is negative, 11004a317db43d2bbc992284dd1f651751f13734d017Romain Guy * the sweep angle is treated as sweep angle modulo 360</p> 11014a317db43d2bbc992284dd1f651751f13734d017Romain Guy * 11024a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>The arc is drawn clockwise. An angle of 0 degrees correspond to the 11034a317db43d2bbc992284dd1f651751f13734d017Romain Guy * geometric angle of 0 degrees (3 o'clock on a watch.)</p> 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param oval The bounds of oval used to define the shape and size 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the arc 11079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startAngle Starting angle (in degrees) where the arc begins 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sweepAngle Sweep angle (in degrees) measured clockwise 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param useCenter If true, include the center of the oval in the arc, and 11109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project close it if it is being stroked. This will draw a wedge 11119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the arc 11129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1113f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawArc(RectF oval, float startAngle, float sweepAngle, boolean useCenter, 1114f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy Paint paint) { 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (oval == null) { 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11185c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawArc(mNativeCanvasWrapper, oval, startAngle, sweepAngle, 1119f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy useCenter, paint.mNativePaint); 11209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified round-rect using the specified paint. The roundrect 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be filled or framed based on the Style in the paint. 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangular bounds of the roundRect to be drawn 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rx The x-radius of the oval used to round the corners 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param ry The y-radius of the oval used to round the corners 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the roundRect 11309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRoundRect(RectF rect, float rx, float ry, Paint paint) { 11324d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik drawRoundRect(rect.left, rect.top, rect.right, rect.bottom, rx, ry, paint); 11334d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik } 11344d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik 11354d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik /** 11364d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * Draw the specified round-rect using the specified paint. The roundrect 11374d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * will be filled or framed based on the Style in the paint. 11384d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * 11394d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * @param rx The x-radius of the oval used to round the corners 11404d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * @param ry The y-radius of the oval used to round the corners 11414d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * @param paint The paint used to draw the roundRect 11424d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik */ 11434d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik public void drawRoundRect(float left, float top, float right, float bottom, float rx, float ry, 11444d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik Paint paint) { 11455c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawRoundRect(mNativeCanvasWrapper, left, top, right, bottom, rx, ry, paint.mNativePaint); 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified path using the specified paint. The path will be 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * filled or framed based on the Style in the paint. 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to be drawn 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the path 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPath(Path path, Paint paint) { 11565c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawPath(mNativeCanvasWrapper, path.ni(), paint.mNativePaint); 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11581abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik 11591abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik /** 11601abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * @hide 11611abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik */ 11621abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik protected static void throwIfCannotDraw(Bitmap bitmap) { 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bitmap.isRecycled()) { 1164f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy throw new RuntimeException("Canvas: trying to use a recycled bitmap " + bitmap); 11659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11661abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik if (!bitmap.isPremultiplied() && bitmap.getConfig() == Bitmap.Config.ARGB_8888 && 11671abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik bitmap.hasAlpha()) { 11681abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throw new RuntimeException("Canvas: trying to use a non-premultiplied bitmap " 11691abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik + bitmap); 11701abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik } 11719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1174deba785f122a47915756ffd991f5540d952cf937Romain Guy * Draws the specified bitmap as an N-patch (most often, a 9-patches.) 1175deba785f122a47915756ffd991f5540d952cf937Romain Guy * 11763b748a44c6bd2ea05fe16839caf73dbe50bd7ae9Romain Guy * @param patch The ninepatch object to render 1177deba785f122a47915756ffd991f5540d952cf937Romain Guy * @param dst The destination rectangle. 1178deba785f122a47915756ffd991f5540d952cf937Romain Guy * @param paint The paint to draw the bitmap with. may be null 1179deba785f122a47915756ffd991f5540d952cf937Romain Guy * 1180deba785f122a47915756ffd991f5540d952cf937Romain Guy * @hide 1181deba785f122a47915756ffd991f5540d952cf937Romain Guy */ 1182f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy public void drawPatch(NinePatch patch, Rect dst, Paint paint) { 1183f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy patch.drawSoftware(this, dst, paint); 1184f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy } 1185f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy 1186f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy /** 1187f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * Draws the specified bitmap as an N-patch (most often, a 9-patches.) 1188f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * 1189f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @param patch The ninepatch object to render 1190f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @param dst The destination rectangle. 1191f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @param paint The paint to draw the bitmap with. may be null 1192f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * 1193f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @hide 1194f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy */ 11953b748a44c6bd2ea05fe16839caf73dbe50bd7ae9Romain Guy public void drawPatch(NinePatch patch, RectF dst, Paint paint) { 1196f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy patch.drawSoftware(this, dst, paint); 1197f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy } 1198f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy 1199deba785f122a47915756ffd991f5540d952cf937Romain Guy /** 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, with its top/left corner at (x,y), using 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified paint, transformed by the current matrix. 120211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 120311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 12049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 12069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 12079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 120911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>If the bitmap and canvas have different densities, this function 121011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * will take care of automatically scaling the bitmap to draw at the 121111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * same density as the canvas. 121211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 12139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The position of the left side of the bitmap being drawn 12159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The position of the top side of the bitmap being drawn 12169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the bitmap (may be null) 12179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(Bitmap bitmap, float left, float top, Paint paint) { 12191abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 12205c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawBitmap(mNativeCanvasWrapper, bitmap.ni(), left, top, 1221f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy paint != null ? paint.mNativePaint : 0, mDensity, mScreenDensity, bitmap.mDensity); 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, scaling/translating automatically to fill 12269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the destination rectangle. If the source rectangle is not null, it 12279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specifies the subset of the bitmap to draw. 122811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 122911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 12309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 12319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 12329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 12339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 12349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 123511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>This function <em>ignores the density associated with the bitmap</em>. 123611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * This is because the source and destination rectangle coordinate 123711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * spaces are in their respective densities, so must already have the 123811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * appropriate scaling factor applied. 123911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 12419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param src May be null. The subset of the bitmap to be drawn 12429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dst The rectangle that the bitmap will be scaled/translated 12439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to fit into 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 12459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(Bitmap bitmap, Rect src, RectF dst, Paint paint) { 12479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (dst == null) { 12489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 12499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12501abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 12515c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawBitmap(mNativeCanvasWrapper, bitmap.ni(), src, dst, 1252f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy paint != null ? paint.mNativePaint : 0, mScreenDensity, bitmap.mDensity); 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, scaling/translating automatically to fill 12579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the destination rectangle. If the source rectangle is not null, it 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specifies the subset of the bitmap to draw. 125911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 126011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 12619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 12629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 12639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 126611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>This function <em>ignores the density associated with the bitmap</em>. 126711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * This is because the source and destination rectangle coordinate 126811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * spaces are in their respective densities, so must already have the 126911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * appropriate scaling factor applied. 127011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param src May be null. The subset of the bitmap to be drawn 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dst The rectangle that the bitmap will be scaled/translated 12749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to fit into 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 12769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(Bitmap bitmap, Rect src, Rect dst, Paint paint) { 12789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (dst == null) { 12799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 12809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12811abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 12825c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawBitmap(mNativeCanvasWrapper, bitmap.ni(), src, dst, 1283f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint != null ? paint.mNativePaint : 0, mScreenDensity, bitmap.mDensity); 12849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Treat the specified array of colors as a bitmap, and draw it. This gives 12889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the same result as first creating a bitmap from the array, and then 12899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawing it, but this method avoids explicitly creating a bitmap object 12909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * which can be more efficient if the colors are changing often. 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors Array of colors representing the pixels of the bitmap 12939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Offset into the array of colors for the first pixel 129483d522290e56f614d0d9373d47c2b54b9e207795Brad Fitzpatrick * @param stride The number of colors in the array between rows (must be 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * >= width or <= -width). 12969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The X coordinate for where to draw the bitmap 12979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The Y coordinate for where to draw the bitmap 12989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The width of the bitmap 12999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The height of the bitmap 13009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hasAlpha True if the alpha channel of the colors contains valid 13019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * values. If false, the alpha byte is ignored (assumed to 13029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be 0xFF for every pixel). 13039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 1304cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * 1305cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * @deprecated Usage with a {@link #isHardwareAccelerated() hardware accelerated} canvas 1306cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * requires an internal copy of color buffer contents every time this method is called. Using a 1307cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * Bitmap avoids this copy, and allows the application to more explicitly control the lifetime 1308cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * and copies of pixel data. 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1310cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik @Deprecated 1311f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawBitmap(int[] colors, int offset, int stride, float x, float y, 1312f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy int width, int height, boolean hasAlpha, Paint paint) { 13139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // check for valid input 13149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width < 0) { 13159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("width must be >= 0"); 13169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (height < 0) { 13189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("height must be >= 0"); 13199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (Math.abs(stride) < width) { 13219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("abs(stride) must be >= width"); 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int lastScanline = offset + (height - 1) * stride; 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = colors.length; 13259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (offset < 0 || (offset + width > length) || lastScanline < 0 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (lastScanline + width > length)) { 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 13289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // quick escape if there's nothing to draw 13309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width == 0 || height == 0) { 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // punch down to native for the actual draw 13345c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawBitmap(mNativeCanvasWrapper, colors, offset, stride, x, y, width, height, hasAlpha, 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint != null ? paint.mNativePaint : 0); 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1337cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik 1338cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik /** 1339cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * Legacy version of drawBitmap(int[] colors, ...) that took ints for x,y 1340cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * 1341cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * @deprecated Usage with a {@link #isHardwareAccelerated() hardware accelerated} canvas 1342cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * requires an internal copy of color buffer contents every time this method is called. Using a 1343cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * Bitmap avoids this copy, and allows the application to more explicitly control the lifetime 1344cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * and copies of pixel data. 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1346cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik @Deprecated 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(int[] colors, int offset, int stride, int x, int y, 1348f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy int width, int height, boolean hasAlpha, Paint paint) { 13499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // call through to the common float version 13509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawBitmap(colors, offset, stride, (float)x, (float)y, width, height, 13519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project hasAlpha, paint); 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1353cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik 13549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the bitmap using the specified matrix. 13569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to draw 13589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix used to transform the bitmap when it is drawn 13599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 13609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(Bitmap bitmap, Matrix matrix, Paint paint) { 13625c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita nativeDrawBitmapMatrix(mNativeCanvasWrapper, bitmap.ni(), matrix.ni(), 13639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint != null ? paint.mNativePaint : 0); 13649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13655a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy 13665a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy /** 13675a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy * @hide 13685a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy */ 13695a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy protected static void checkRange(int length, int offset, int count) { 13709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((offset | count) < 0 || offset + count > length) { 13719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 13729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the bitmap through the mesh, where mesh vertices are evenly 13779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed across the bitmap. There are meshWidth+1 vertices across, and 13789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * meshHeight+1 vertices down. The verts array is accessed in row-major 13799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * order, so that the first meshWidth+1 vertices are distributed across the 13809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * top of the bitmap from left to right. A more general version of this 13815d11676414b3606792e23c269cf75b44faa1a2afChris Craik * method is drawVertices(). 13829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to draw using the mesh 13849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param meshWidth The number of columns in the mesh. Nothing is drawn if 13859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this is 0 13869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param meshHeight The number of rows in the mesh. Nothing is drawn if 13879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this is 0 13889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param verts Array of x,y pairs, specifying where the mesh should be 13899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawn. There must be at least 13905d11676414b3606792e23c269cf75b44faa1a2afChris Craik * (meshWidth+1) * (meshHeight+1) * 2 + vertOffset values 13919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the array 13929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertOffset Number of verts elements to skip before drawing 13939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors May be null. Specifies a color at each vertex, which is 13949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * interpolated across the cell, and whose values are 13959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * multiplied by the corresponding bitmap colors. If not null, 13969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * there must be at least (meshWidth+1) * (meshHeight+1) + 13979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * colorOffset values in the array. 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colorOffset Number of color elements to skip before drawing 13999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmapMesh(Bitmap bitmap, int meshWidth, int meshHeight, 1402f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy float[] verts, int vertOffset, int[] colors, int colorOffset, Paint paint) { 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((meshWidth | meshHeight | vertOffset | colorOffset) < 0) { 14049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 14059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (meshWidth == 0 || meshHeight == 0) { 14079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 14089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int count = (meshWidth + 1) * (meshHeight + 1); 14109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we mul by 2 since we need two floats per vertex 14119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(verts.length, vertOffset, count * 2); 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (colors != null) { 14139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // no mul by 2, since we need only 1 color per vertex 14149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(colors.length, colorOffset, count); 14159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14165c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita nativeDrawBitmapMesh(mNativeCanvasWrapper, bitmap.ni(), meshWidth, meshHeight, 1417f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy verts, vertOffset, colors, colorOffset, 1418f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint != null ? paint.mNativePaint : 0); 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1420f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 14219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum VertexMode { 14229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLES(0), 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLE_STRIP(1), 14249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLE_FAN(2); 14259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project VertexMode(int nativeInt) { 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = nativeInt; 14289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1429a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy 1430a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy /** 1431a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy * @hide 1432a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy */ 1433a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy public final int nativeInt; 14349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the array of vertices, interpreted as triangles (based on mode). The 14389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * verts array is required, and specifies the x,y pairs for each vertex. If 14399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * texs is non-null, then it is used to specify the coordinate in shader 14409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinates to use at each vertex (the paint must have a shader in this 14419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * case). If there is no texs array, but there is a color array, then each 14429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color is interpolated across its corresponding triangle in a gradient. If 14439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * both texs and colors arrays are present, then they behave as before, but 14449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the resulting color at each pixels is the result of multiplying the 14459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * colors from the shader and the color-gradient together. The indices array 14469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is optional, but if it is present, then it is used to specify the index 14479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of each triangle, rather than just walking through the arrays in order. 14489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode How to interpret the array of vertices 14509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertexCount The number of values in the vertices array (and 14519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * corresponding texs and colors arrays if non-null). Each logical 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex is two values (x, y), vertexCount must be a multiple of 2. 14539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param verts Array of vertices for the mesh 14549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertOffset Number of values in the verts to skip before drawing. 14559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param texs May be null. If not null, specifies the coordinates to sample 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * into the current shader (e.g. bitmap tile or gradient) 14579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param texOffset Number of values in texs to skip before drawing. 14589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors May be null. If not null, specifies a color for each 14599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex, to be interpolated across the triangle. 14609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colorOffset Number of values in colors to skip before drawing. 14619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param indices If not null, array of indices to reference into the 14629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex (texs, colors) array. 14639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param indexCount number of entries in the indices array (if not null). 14649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint Specifies the shader to use if the texs array is non-null. 14659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1466f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawVertices(VertexMode mode, int vertexCount, float[] verts, int vertOffset, 1467f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy float[] texs, int texOffset, int[] colors, int colorOffset, 1468f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy short[] indices, int indexOffset, int indexCount, Paint paint) { 14699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(verts.length, vertOffset, vertexCount); 14709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (texs != null) { 14719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(texs.length, texOffset, vertexCount); 14729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (colors != null) { 147492ce5734b52ef014c80cc6335112a027188b3eb6Erik Faye-Lund checkRange(colors.length, colorOffset, vertexCount / 2); 14759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (indices != null) { 14779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(indices.length, indexOffset, indexCount); 14789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14795c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita nativeDrawVertices(mNativeCanvasWrapper, mode.nativeInt, vertexCount, verts, 1480f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy vertOffset, texs, texOffset, colors, colorOffset, 1481f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy indices, indexOffset, indexCount, paint.mNativePaint); 14829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 148336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat 14849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. The 14869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin is interpreted based on the Align setting in the paint. 14879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 14899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 14909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of the origin of the text being drawn 14919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 14929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1493f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawText(char[] text, int index, int count, float x, float y, Paint paint) { 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((index | count | (index + count) | 14959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project (text.length - index - count)) < 0) { 14969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 14979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14985c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, text, index, count, x, y, paint.mBidiFlags, 1499a033630e805c407080221e20b236b6054f324670Raph Levien paint.mNativePaint, paint.mNativeTypeface); 15009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. The 15049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin is interpreted based on the Align setting in the paint. 15059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 15079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 15089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of the origin of the text being drawn 15099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 15109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1511f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt public void drawText(String text, float x, float y, Paint paint) { 15125c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, text, 0, text.length(), x, y, paint.mBidiFlags, 1513a033630e805c407080221e20b236b6054f324670Raph Levien paint.mNativePaint, paint.mNativeTypeface); 1514f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 15159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. 15189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The origin is interpreted based on the Align setting in the paint. 15199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param start The index of the first character in text to draw 15229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param end (end - 1) is the index of the last character in text to draw 15239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 15249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of the origin of the text being drawn 15259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1527f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawText(String text, int start, int end, float x, float y, Paint paint) { 15289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((start | end | (end - start) | (text.length() - end)) < 0) { 15299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 15309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15315c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, text, start, end, x, y, paint.mBidiFlags, 1532a033630e805c407080221e20b236b6054f324670Raph Levien paint.mNativePaint, paint.mNativeTypeface); 15339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified range of text, specified by start/end, with its 15379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin at (x,y), in the specified Paint. The origin is interpreted 15389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * based on the Align setting in the Paint. 15399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 15419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param start The index of the first character in text to draw 15429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param end (end - 1) is the index of the last character in text 15439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to draw 15449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of origin for where to draw the text 15459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of origin for where to draw the text 15469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 15479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1548f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawText(CharSequence text, int start, int end, float x, float y, Paint paint) { 15499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (text instanceof String || text instanceof SpannedString || 15509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project text instanceof SpannableString) { 15515c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, text.toString(), start, end, x, y, 1552a033630e805c407080221e20b236b6054f324670Raph Levien paint.mBidiFlags, paint.mNativePaint, paint.mNativeTypeface); 1553f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else if (text instanceof GraphicsOperations) { 15549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ((GraphicsOperations) text).drawText(this, start, end, x, y, 1555f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint); 1556f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else { 1557f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt char[] buf = TemporaryBuffer.obtain(end - start); 1558f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt TextUtils.getChars(text, start, end, buf, 0); 15595c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, buf, 0, end - start, x, y, 1560a033630e805c407080221e20b236b6054f324670Raph Levien paint.mBidiFlags, paint.mNativePaint, paint.mNativeTypeface); 1561f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt TemporaryBuffer.recycle(buf); 15629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1563f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1564f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1565f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1566f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * Render a run of all LTR or all RTL text, with shaping. This does not run 1567f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * bidi on the provided text, but renders it as a uniform right-to-left or 1568f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * left-to-right run, as indicated by dir. Alignment of the text is as 1569f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * determined by the Paint's TextAlign value. 1570f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * 1571f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param text the text to render 15720c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param index the start of the text to render 15730c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param count the count of chars to render 15740c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param contextIndex the start of the context for shaping. Must be 15750c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * no greater than index. 15760c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param contextCount the number of characters in the context for shaping. 15770c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * ContexIndex + contextCount must be no less than index 15780c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * + count. 1579f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param x the x position at which to draw the text 1580f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param y the y position at which to draw the text 1581da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * @param dir the run direction, either {@link #DIRECTION_LTR} or 1582da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * {@link #DIRECTION_RTL}. 1583f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param paint the paint 1584f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @hide 1585f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt */ 1586f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawTextRun(char[] text, int index, int count, int contextIndex, int contextCount, 1587da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio float x, float y, int dir, Paint paint) { 1588f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1589f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text == null) { 1590f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("text is null"); 1591f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1592f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (paint == null) { 1593f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("paint is null"); 1594f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 15950c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt if ((index | count | text.length - index - count) < 0) { 1596f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new IndexOutOfBoundsException(); 1597f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1598da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio if (dir != DIRECTION_LTR && dir != DIRECTION_RTL) { 1599da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio throw new IllegalArgumentException("unknown dir: " + dir); 1600da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio } 1601f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 16025c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawTextRun(mNativeCanvasWrapper, text, index, count, 1603a033630e805c407080221e20b236b6054f324670Raph Levien contextIndex, contextCount, x, y, dir, paint.mNativePaint, paint.mNativeTypeface); 1604f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1605f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1606f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1607f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * Render a run of all LTR or all RTL text, with shaping. This does not run 1608f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * bidi on the provided text, but renders it as a uniform right-to-left or 1609f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * left-to-right run, as indicated by dir. Alignment of the text is as 1610f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * determined by the Paint's TextAlign value. 16110c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * 1612f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param text the text to render 1613f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param start the start of the text to render. Data before this position 1614f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * can be used for shaping context. 1615f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param end the end of the text to render. Data at or after this 1616f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * position can be used for shaping context. 1617f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param x the x position at which to draw the text 1618f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param y the y position at which to draw the text 1619da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * @param dir the run direction, either 0 for LTR or 1 for RTL. 1620f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param paint the paint 1621f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @hide 1622f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt */ 1623f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawTextRun(CharSequence text, int start, int end, int contextStart, int contextEnd, 1624da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio float x, float y, int dir, Paint paint) { 1625f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1626f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text == null) { 1627f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("text is null"); 1628f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1629f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (paint == null) { 1630f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("paint is null"); 1631f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1632f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if ((start | end | end - start | text.length() - end) < 0) { 1633f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new IndexOutOfBoundsException(); 1634f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1635f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1636da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio int flags = dir == 0 ? 0 : 1; 1637da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio 1638f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text instanceof String || text instanceof SpannedString || 1639f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt text instanceof SpannableString) { 16405c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawTextRun(mNativeCanvasWrapper, text.toString(), start, end, 1641a033630e805c407080221e20b236b6054f324670Raph Levien contextStart, contextEnd, x, y, flags, paint.mNativePaint, paint.mNativeTypeface); 1642f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else if (text instanceof GraphicsOperations) { 16430c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt ((GraphicsOperations) text).drawTextRun(this, start, end, 1644da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio contextStart, contextEnd, x, y, flags, paint); 1645f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else { 16460c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int contextLen = contextEnd - contextStart; 16470c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int len = end - start; 16480c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt char[] buf = TemporaryBuffer.obtain(contextLen); 16490c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt TextUtils.getChars(text, contextStart, contextEnd, buf, 0); 16505c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawTextRun(mNativeCanvasWrapper, buf, start - contextStart, len, 1651a033630e805c407080221e20b236b6054f324670Raph Levien 0, contextLen, x, y, flags, paint.mNativePaint, paint.mNativeTypeface); 16529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TemporaryBuffer.recycle(buf); 16539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text in the array, with each character's origin specified by 16589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the pos array. 165962b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * 166062b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * This method does not support glyph composition and decomposition and 166162b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * should therefore not be used to render complex scripts. 16629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 16649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index The index of the first character to draw 16659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of characters to draw, starting from index. 16669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pos Array of [x,y] positions, used to position each 16679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * character 16689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 16699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1670f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 1671f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawPosText(char[] text, int index, int count, float[] pos, Paint paint) { 16729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (index < 0 || index + count > text.length || count*2 > pos.length) { 16739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 16749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16755c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawPosText(mNativeCanvasWrapper, text, index, count, pos, 1676f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint.mNativePaint); 16779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text in the array, with each character's origin specified by 16819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the pos array. 168262b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * 168362b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * This method does not support glyph composition and decomposition and 168462b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * should therefore not be used to render complex scripts. 16859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 16879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pos Array of [x,y] positions, used to position each character 16889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 16899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1690f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 16919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPosText(String text, float[] pos, Paint paint) { 16929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (text.length()*2 > pos.length) { 16939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 16949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16955c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawPosText(mNativeCanvasWrapper, text, pos, paint.mNativePaint); 16969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint, along 17009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified path. The paint's Align setting determins where along the 17019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * path to start the text. 17029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 17049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path the text should follow for its baseline 17059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hOffset The distance along the path to add to the text's 17069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * starting position 17079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vOffset The distance above(-) or below(+) the path to position 17089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the text 17099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 17109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawTextOnPath(char[] text, int index, int count, Path path, 1712f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy float hOffset, float vOffset, Paint paint) { 17139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (index < 0 || index + count > text.length) { 17149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 17159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17165c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawTextOnPath(mNativeCanvasWrapper, text, index, count, 1717f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy path.ni(), hOffset, vOffset, 1718f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint.mBidiFlags, paint.mNativePaint); 17199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint, along 17239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified path. The paint's Align setting determins where along the 17249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * path to start the text. 17259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 17279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path the text should follow for its baseline 17289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hOffset The distance along the path to add to the text's 17299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * starting position 17309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vOffset The distance above(-) or below(+) the path to position 17319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the text 17329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 17339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1734f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawTextOnPath(String text, Path path, float hOffset, float vOffset, Paint paint) { 17359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (text.length() > 0) { 17365c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawTextOnPath(mNativeCanvasWrapper, text, path.ni(), hOffset, vOffset, 1737da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio paint.mBidiFlags, paint.mNativePaint); 17389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Save the canvas state, draw the picture, and restore the canvas state. 17439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This differs from picture.draw(canvas), which does not perform any 17449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * save/restore. 1745cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * 1746cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * <p> 1747cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * <strong>Note:</strong> This forces the picture to internally call 1748cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * {@link Picture#endRecording} in order to prepare for playback. 17499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param picture The picture to be drawn 17519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPicture(Picture picture) { 17539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project picture.endRecording(); 1754667fe1039feae068d3333de8fb7115313f4a517bJonathan Dixon int restoreCount = save(); 1755667fe1039feae068d3333de8fb7115313f4a517bJonathan Dixon picture.draw(this); 1756667fe1039feae068d3333de8fb7115313f4a517bJonathan Dixon restoreToCount(restoreCount); 17579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the picture, stretched to fit into the dst rectangle. 17619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPicture(Picture picture, RectF dst) { 17639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project save(); 17649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(dst.left, dst.top); 17659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (picture.getWidth() > 0 && picture.getHeight() > 0) { 1766f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy scale(dst.width() / picture.getWidth(), dst.height() / picture.getHeight()); 17679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPicture(picture); 17699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project restore(); 17709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the picture, stretched to fit into the dst rectangle. 17749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPicture(Picture picture, Rect dst) { 17769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project save(); 17779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(dst.left, dst.top); 17789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (picture.getWidth() > 0 && picture.getHeight() > 0) { 1779f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy scale((float) dst.width() / picture.getWidth(), 1780f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy (float) dst.height() / picture.getHeight()); 17819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPicture(picture); 17839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project restore(); 17849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1785da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy 1786da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy /** 1787ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov * Releases the resources associated with this canvas. 1788ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov * 1789ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov * @hide 1790ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov */ 1791ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov public void release() { 1792ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov mFinalizer.dispose(); 1793ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov } 1794ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 1795ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov /** 1796163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * Free up as much memory as possible from private caches (e.g. fonts, images) 1797caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed * 1798163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @hide 1799caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed */ 1800caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed public static native void freeCaches(); 1801caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed 180230ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio /** 180330ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * Free up text layout caches 180430ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * 180530ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * @hide 180630ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio */ 180730ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio public static native void freeTextLayoutCaches(); 180830ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio 180936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native long initRaster(long nativeBitmapOrZero); 18105c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita private static native long initCanvas(long canvasHandle); 18115c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita private static native void native_setBitmap(long canvasHandle, 18125c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita long bitmapHandle, 18135c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita boolean copyState); 181495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native boolean native_isOpaque(long canvasHandle); 181595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native int native_getWidth(long canvasHandle); 181695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native int native_getHeight(long canvasHandle); 181795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita 181895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native int native_save(long canvasHandle, int saveFlags); 181936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native int native_saveLayer(long nativeCanvas, float l, 18209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float t, float r, float b, 182136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint, 182236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int layerFlags); 182336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native int native_saveLayerAlpha(long nativeCanvas, float l, 18249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float t, float r, float b, 18259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int alpha, int layerFlags); 182695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_restore(long canvasHandle); 182795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_restoreToCount(long canvasHandle, 182895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita int saveCount); 182995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native int native_getSaveCount(long canvasHandle); 183095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita 183195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_translate(long canvasHandle, 183295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita float dx, float dy); 183395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_scale(long canvasHandle, 183495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita float sx, float sy); 183595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_rotate(long canvasHandle, float degrees); 183695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_skew(long canvasHandle, 183795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita float sx, float sy); 183836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_concat(long nativeCanvas, 183936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix); 184036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_setMatrix(long nativeCanvas, 184136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix); 184236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_clipRect(long nativeCanvas, 18439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 18449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float right, float bottom, 18459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 184636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_clipPath(long nativeCanvas, 184736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePath, 18489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 184936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_clipRegion(long nativeCanvas, 185036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeRegion, 18519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 185236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeSetDrawFilter(long nativeCanvas, 185336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeFilter); 185436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_getClipBounds(long nativeCanvas, 18559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect bounds); 185636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_getCTM(long nativeCanvas, 185736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix); 185836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_quickReject(long nativeCanvas, 185936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePath); 186036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_quickReject(long nativeCanvas, 18619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 1862ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger float right, float bottom); 186336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawRGB(long nativeCanvas, int r, int g, 18649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int b); 186536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawARGB(long nativeCanvas, int a, int r, 18669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int g, int b); 186736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawColor(long nativeCanvas, int color); 186836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawColor(long nativeCanvas, int color, 18699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mode); 187036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawPaint(long nativeCanvas, 187136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 187295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_drawPoint(long canvasHandle, float x, float y, 187395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita long paintHandle); 187495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_drawPoints(long canvasHandle, float[] pts, 187595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita int offset, int count, 187695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita long paintHandle); 187736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawLine(long nativeCanvas, float startX, 18789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float startY, float stopX, 187936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float stopY, long nativePaint); 188095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_drawLines(long canvasHandle, float[] pts, 188195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita int offset, int count, 188295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita long paintHandle); 188336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawRect(long nativeCanvas, float left, 18849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float top, float right, 188536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float bottom, 188636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 188736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawOval(long nativeCanvas, RectF oval, 188836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 188936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawCircle(long nativeCanvas, float cx, 18909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float cy, float radius, 189136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 189236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawArc(long nativeCanvas, RectF oval, 18939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float startAngle, float sweep, 189436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat boolean useCenter, 189536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 189636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawRoundRect(long nativeCanvas, 18974d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik float left, float top, float right, float bottom, 18984d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik float rx, float ry, long nativePaint); 189936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawPath(long nativeCanvas, 190036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePath, 190136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 190236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private native void native_drawBitmap(long nativeCanvas, long nativeBitmap, 19039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 190436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaintOrZero, 19050d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int canvasDensity, 19060d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int screenDensity, 19070d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int bitmapDensity); 190836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private native void native_drawBitmap(long nativeCanvas, long nativeBitmap, 19099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect src, RectF dst, 191036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaintOrZero, 19110d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int screenDensity, 19120d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int bitmapDensity); 191336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawBitmap(long nativeCanvas, 191436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeBitmap, 19159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect src, Rect dst, 191636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaintOrZero, 19170d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int screenDensity, 19180d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int bitmapDensity); 191936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawBitmap(long nativeCanvas, int[] colors, 19209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offset, int stride, float x, 19219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float y, int width, int height, 19229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean hasAlpha, 192336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaintOrZero); 192436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeDrawBitmapMatrix(long nativeCanvas, 192536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeBitmap, 192636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix, 192736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 192836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeDrawBitmapMesh(long nativeCanvas, 192936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeBitmap, 19309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int meshWidth, int meshHeight, 19319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] verts, int vertOffset, 193236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int[] colors, int colorOffset, 193336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 193436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeDrawVertices(long nativeCanvas, int mode, int n, 19359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] verts, int vertOffset, float[] texs, int texOffset, 19369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] colors, int colorOffset, short[] indices, 193736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int indexOffset, int indexCount, long nativePaint); 193836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat 193936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawText(long nativeCanvas, char[] text, 19409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int index, int count, float x, 194136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float y, int flags, long nativePaint, 194236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeTypeface); 194336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawText(long nativeCanvas, String text, 19449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int start, int end, float x, 194536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float y, int flags, long nativePaint, 194636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeTypeface); 1947fcf2be1846935e7983ea2fe87fdd4d7af27764b6Fabrice Di Meglio 194836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextRun(long nativeCanvas, String text, 19490c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int start, int end, int contextStart, int contextEnd, 195036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float x, float y, int flags, long nativePaint, long nativeTypeface); 1951f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 195236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextRun(long nativeCanvas, char[] text, 19530c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int start, int count, int contextStart, int contextCount, 195436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float x, float y, int flags, long nativePaint, long nativeTypeface); 1955f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 195636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawPosText(long nativeCanvas, 19579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char[] text, int index, 19589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int count, float[] pos, 195936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 196036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawPosText(long nativeCanvas, 19619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String text, float[] pos, 196236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 196336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextOnPath(long nativeCanvas, 19649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char[] text, int index, 196536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int count, long nativePath, 19669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float hOffset, 1967da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio float vOffset, int bidiFlags, 196836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 196936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextOnPath(long nativeCanvas, 197036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat String text, long nativePath, 197136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float hOffset, 197236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float vOffset, 197336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int flags, long nativePaint); 197436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void finalizer(long nativeCanvas); 19759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1976