Canvas.java revision f37a364a530c5c055cf4634f0b0463454a252b0f
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 19ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabreseimport android.annotation.IntDef; 20ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabreseimport android.annotation.NonNull; 21ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabreseimport android.annotation.Nullable; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.text.GraphicsOperations; 23f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Feltimport android.text.SpannableString; 24f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Feltimport android.text.SpannedString; 25f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Feltimport android.text.TextUtils; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 27ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabreseimport java.lang.annotation.Retention; 28ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabreseimport java.lang.annotation.RetentionPolicy; 29ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese 30091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craikimport javax.microedition.khronos.opengles.GL; 31091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The Canvas class holds the "draw" calls. To draw something, you need 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4 basic components: A Bitmap to hold the pixels, a Canvas to host 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the draw calls (writing into the bitmap), a drawing primitive (e.g. Rect, 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Path, text, Bitmap), and a paint (to describe the colors and styles for the 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawing). 3861fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * 3961fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * <div class="special reference"> 4061fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * <h3>Developer Guides</h3> 4161fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * <p>For more information about how to use Canvas, read the 4261fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * <a href="{@docRoot}guide/topics/graphics/2d-graphics.html"> 4361fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * Canvas and Drawables</a> developer guide.</p></div> 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class Canvas { 46ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 47fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger // assigned in constructors or setBitmap, freed in finalizer 485c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita private long mNativeCanvasWrapper; 49c677675e9c465dc1de21ecf2e0421835c7eb55b4Florin Malita 50ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov /** @hide */ 515c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita public long getNativeCanvasWrapper() { 525c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return mNativeCanvasWrapper; 53c677675e9c465dc1de21ecf2e0421835c7eb55b4Florin Malita } 54ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 55a753f4c6cb8558795e673df1896532cd148781e2Chris Craik /** @hide */ 56a753f4c6cb8558795e673df1896532cd148781e2Chris Craik public boolean isRecordingFor(Object o) { return false; } 57a753f4c6cb8558795e673df1896532cd148781e2Chris Craik 58e0aa84b7dc087e999e20055dcc04cb6a48d5bd62Romain Guy // may be null 59e0aa84b7dc087e999e20055dcc04cb6a48d5bd62Romain Guy private Bitmap mBitmap; 60ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // optional field set by the caller 62ce0537b80087a6225273040a987414b1dd081aa0Romain Guy private DrawFilter mDrawFilter; 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 64ce0537b80087a6225273040a987414b1dd081aa0Romain Guy /** 65ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * @hide 66ce0537b80087a6225273040a987414b1dd081aa0Romain Guy */ 67ce0537b80087a6225273040a987414b1dd081aa0Romain Guy protected int mDensity = Bitmap.DENSITY_NONE; 680d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn 69ce0537b80087a6225273040a987414b1dd081aa0Romain Guy /** 70ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * Used to determine when compatibility scaling is in effect. 71051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 72ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * @hide 73ce0537b80087a6225273040a987414b1dd081aa0Romain Guy */ 74ce0537b80087a6225273040a987414b1dd081aa0Romain Guy protected int mScreenDensity = Bitmap.DENSITY_NONE; 75051910b9f998030dacb8a0722588cc715813fde1Raph Levien 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Used by native code 77f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy @SuppressWarnings("UnusedDeclaration") 78e0aa84b7dc087e999e20055dcc04cb6a48d5bd62Romain Guy private int mSurfaceFormat; 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 80da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio /** 81da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * Flag for drawTextRun indicating left-to-right run direction. 82da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * @hide 83da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio */ 84da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio public static final int DIRECTION_LTR = 0; 85051910b9f998030dacb8a0722588cc715813fde1Raph Levien 86da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio /** 87da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * Flag for drawTextRun indicating right-to-left run direction. 88da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * @hide 89da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio */ 90da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio public static final int DIRECTION_RTL = 1; 91da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio 92f61970fc79e9c5cf340fa942597628242361864aRomain Guy // Maximum bitmap size as defined in Skia's native code 93f61970fc79e9c5cf340fa942597628242361864aRomain Guy // (see SkCanvas.cpp, SkDraw.cpp) 94f61970fc79e9c5cf340fa942597628242361864aRomain Guy private static final int MAXMIMUM_BITMAP_SIZE = 32766; 95f61970fc79e9c5cf340fa942597628242361864aRomain Guy 964a317db43d2bbc992284dd1f651751f13734d017Romain Guy // This field is used to finalize the native Canvas properly 97e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy private final CanvasFinalizer mFinalizer; 98e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 99ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov private static final class CanvasFinalizer { 1005c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita private long mNativeCanvasWrapper; 101e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 10236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat public CanvasFinalizer(long nativeCanvas) { 1035c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita mNativeCanvasWrapper = nativeCanvas; 104e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 105e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 106e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy @Override 107e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy protected void finalize() throws Throwable { 1083b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy try { 109ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov dispose(); 1103b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy } finally { 1113b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy super.finalize(); 112e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 113e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 114ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 115ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov public void dispose() { 1165c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita if (mNativeCanvasWrapper != 0) { 1175c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita finalizer(mNativeCanvasWrapper); 1185c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita mNativeCanvasWrapper = 0; 119ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov } 120ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov } 121e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 122e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 123f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Construct an empty raster canvas. Use setBitmap() to specify a bitmap to 12596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * draw into. The initial target density is {@link Bitmap#DENSITY_NONE}; 12696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * this will typically be replaced when a target bitmap is set for the 12796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * canvas. 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Canvas() { 130003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy if (!isHardwareAccelerated()) { 131003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy // 0 means no native bitmap 1325c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita mNativeCanvasWrapper = initRaster(0); 1335c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita mFinalizer = new CanvasFinalizer(mNativeCanvasWrapper); 134003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy } else { 135003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy mFinalizer = null; 136003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy } 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Construct a canvas with the specified bitmap to draw into. The bitmap 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * must be mutable. 142051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 14396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>The initial target density of the canvas is the same as the given 14496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * bitmap's density. 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap Specifies a mutable bitmap for the canvas to draw into. 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 148ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public Canvas(@NonNull Bitmap bitmap) { 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!bitmap.isMutable()) { 150f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy throw new IllegalStateException("Immutable bitmap passed to Canvas constructor"); 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1521abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 1535c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita mNativeCanvasWrapper = initRaster(bitmap.ni()); 1545c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita mFinalizer = new CanvasFinalizer(mNativeCanvasWrapper); 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBitmap = bitmap; 15696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn mDensity = bitmap.mDensity; 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 158ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 159ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov /** @hide */ 16036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat public Canvas(long nativeCanvas) { 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (nativeCanvas == 0) { 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(); 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1648872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger mNativeCanvasWrapper = nativeCanvas; 1655c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita mFinalizer = new CanvasFinalizer(mNativeCanvasWrapper); 16696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn mDensity = Bitmap.getDefaultDensity(); 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 168163935113919a184122b8b3bd672ef08c8df65dcRomain Guy 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 170091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik * Returns null. 171c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * 172091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik * @deprecated This method is not supported and should not be invoked. 173c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * 174091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik * @hide 175091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik */ 176091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik @Deprecated 177091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik protected GL getGL() { 178091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik return null; 179091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik } 180091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik 181091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik /** 1822d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * Indicates whether this Canvas uses hardware acceleration. 183051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 1842d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * Note that this method does not define what type of hardware acceleration 1852d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * may or may not be used. 186051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 1872d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * @return True if drawing operations are hardware accelerated, 1882d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * false otherwise. 1892d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy */ 1902d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy public boolean isHardwareAccelerated() { 191163935113919a184122b8b3bd672ef08c8df65dcRomain Guy return false; 192caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed } 193163935113919a184122b8b3bd672ef08c8df65dcRomain Guy 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 195051910b9f998030dacb8a0722588cc715813fde1Raph Levien * Specify a bitmap for the canvas to draw into. All canvas state such as 1963bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * layers, filters, and the save/restore stack are reset with the exception 1973bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * of the current matrix and clip stack. Additionally, as a side-effect 1983bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * the canvas' target density is updated to match that of the bitmap. 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap Specifies a mutable bitmap for the canvas to draw into. 20196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @see #setDensity(int) 20296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @see #getDensity() 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 204ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void setBitmap(@Nullable Bitmap bitmap) { 205163935113919a184122b8b3bd672ef08c8df65dcRomain Guy if (isHardwareAccelerated()) { 20696890564bdbd2f2a41dfc323fc8b3938fb335639Chris Craik throw new RuntimeException("Can't set a bitmap device on a HW accelerated canvas"); 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 209fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger if (bitmap == null) { 2105c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_setBitmap(mNativeCanvasWrapper, 0, false); 211fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger mDensity = Bitmap.DENSITY_NONE; 212fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger } else { 2130965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy if (!bitmap.isMutable()) { 2140965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy throw new IllegalStateException(); 2150965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy } 2161abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 217fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger 2185c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_setBitmap(mNativeCanvasWrapper, bitmap.ni(), true); 2190965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy mDensity = bitmap.mDensity; 2200965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy } 2210965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBitmap = bitmap; 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 224c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2265c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita * setBitmap() variant for native callers with a raw bitmap handle. 2275c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita */ 2285c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita private void setNativeBitmap(long bitmapHandle) { 2295c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_setBitmap(mNativeCanvasWrapper, bitmapHandle, false); 2305c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita } 2315c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita 2325c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita /** 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the viewport dimensions if this canvas is GL based. If it is not, 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this method is ignored and no exception is thrown. 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 236163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @param width The width of the viewport 237163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @param height The height of the viewport 238c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * 239163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @hide 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 241797b95b26bbb7557678af78b9a2a61830158920fChris Craik public void setViewport(int width, int height) {} 242797b95b26bbb7557678af78b9a2a61830158920fChris Craik 243cce47eb580d666ead1f6095d1e3b65233592bbaaChris Craik /** @hide */ 244cce47eb580d666ead1f6095d1e3b65233592bbaaChris Craik public void setHighContrastText(boolean highContrastText) {} 245cce47eb580d666ead1f6095d1e3b65233592bbaaChris Craik 2468afd0f245cc0c4a0366f39f41b5f78e47ee83be3Chris Craik /** @hide */ 2478afd0f245cc0c4a0366f39f41b5f78e47ee83be3Chris Craik public void insertReorderBarrier() {} 2488afd0f245cc0c4a0366f39f41b5f78e47ee83be3Chris Craik 2498afd0f245cc0c4a0366f39f41b5f78e47ee83be3Chris Craik /** @hide */ 2508afd0f245cc0c4a0366f39f41b5f78e47ee83be3Chris Craik public void insertInorderBarrier() {} 2518afd0f245cc0c4a0366f39f41b5f78e47ee83be3Chris Craik 252797b95b26bbb7557678af78b9a2a61830158920fChris Craik /** 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the device that the current layer draws into is opaque 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (i.e. does not support per-pixel alpha). 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the device that the current layer draws into is opaque 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 25895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public boolean isOpaque() { 25995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_isOpaque(mNativeCanvasWrapper); 26095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the width of the current drawing layer 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the width of the current drawing layer 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 26795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int getWidth() { 26895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_getWidth(mNativeCanvasWrapper); 26995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the height of the current drawing layer 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the height of the current drawing layer 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 27695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int getHeight() { 27795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_getHeight(mNativeCanvasWrapper); 27895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 28196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>Returns the target density of the canvas. The default density is 28296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * derived from the density of its backing bitmap, or 28396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * {@link Bitmap#DENSITY_NONE} if there is not one.</p> 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 28596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @return Returns the current target density of the canvas, which is used 28696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * to determine the scaling factor when drawing a bitmap into it. 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 28811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #setDensity(int) 289051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @see Bitmap#getDensity() 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 29111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getDensity() { 29211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return mDensity; 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 29696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>Specifies the density for this Canvas' backing bitmap. This modifies 29796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * the target density of the canvas itself, as well as the density of its 29896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * backing bitmap via {@link Bitmap#setDensity(int) Bitmap.setDensity(int)}. 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 30096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @param density The new target density of the canvas, which is used 30196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * to determine the scaling factor when drawing a bitmap into it. Use 30296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * {@link Bitmap#DENSITY_NONE} to disable bitmap scaling. 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 30411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #getDensity() 305051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @see Bitmap#setDensity(int) 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 30711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public void setDensity(int density) { 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mBitmap != null) { 30911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn mBitmap.setDensity(density); 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 31111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn mDensity = density; 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3140d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn /** @hide */ 3150d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn public void setScreenDensity(int density) { 3160d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn mScreenDensity = density; 3170d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn } 318f61970fc79e9c5cf340fa942597628242361864aRomain Guy 319f61970fc79e9c5cf340fa942597628242361864aRomain Guy /** 320f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Returns the maximum allowed width for bitmaps drawn with this canvas. 321f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Attempting to draw with a bitmap wider than this value will result 322f61970fc79e9c5cf340fa942597628242361864aRomain Guy * in an error. 323051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 324051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @see #getMaximumBitmapHeight() 325f61970fc79e9c5cf340fa942597628242361864aRomain Guy */ 326f61970fc79e9c5cf340fa942597628242361864aRomain Guy public int getMaximumBitmapWidth() { 327f61970fc79e9c5cf340fa942597628242361864aRomain Guy return MAXMIMUM_BITMAP_SIZE; 328f61970fc79e9c5cf340fa942597628242361864aRomain Guy } 329051910b9f998030dacb8a0722588cc715813fde1Raph Levien 330f61970fc79e9c5cf340fa942597628242361864aRomain Guy /** 331f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Returns the maximum allowed height for bitmaps drawn with this canvas. 332f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Attempting to draw with a bitmap taller than this value will result 333f61970fc79e9c5cf340fa942597628242361864aRomain Guy * in an error. 334051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 335051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @see #getMaximumBitmapWidth() 336f61970fc79e9c5cf340fa942597628242361864aRomain Guy */ 337f61970fc79e9c5cf340fa942597628242361864aRomain Guy public int getMaximumBitmapHeight() { 338f61970fc79e9c5cf340fa942597628242361864aRomain Guy return MAXMIMUM_BITMAP_SIZE; 339f61970fc79e9c5cf340fa942597628242361864aRomain Guy } 340f61970fc79e9c5cf340fa942597628242361864aRomain Guy 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // the SAVE_FLAG constants must match their native equivalents 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 343ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese /** @hide */ 344ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @IntDef(flag = true, 345ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese value = { 346ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese MATRIX_SAVE_FLAG, 347ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese CLIP_SAVE_FLAG, 348ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese HAS_ALPHA_LAYER_SAVE_FLAG, 349ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese FULL_COLOR_LAYER_SAVE_FLAG, 350ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese CLIP_TO_LAYER_SAVE_FLAG, 351ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese ALL_SAVE_FLAG 352ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese }) 353ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Retention(RetentionPolicy.SOURCE) 354ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public @interface Saveflags {} 355ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese 356f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik /** 357f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Restore the current matrix when restore() is called. 358f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik */ 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MATRIX_SAVE_FLAG = 0x01; 360f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik 361f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik /** 362f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Restore the current clip when restore() is called. 363f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik */ 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CLIP_SAVE_FLAG = 0x02; 365f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik 366f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik /** 367f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * The layer requires a per-pixel alpha channel. 368f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik */ 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int HAS_ALPHA_LAYER_SAVE_FLAG = 0x04; 370f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik 371f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik /** 372f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * The layer requires full 8-bit precision for each color channel. 373f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik */ 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FULL_COLOR_LAYER_SAVE_FLAG = 0x08; 375f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik 376f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik /** 377f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Clip drawing to the bounds of the offscreen layer, omit at your own peril. 378f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p class="note"><strong>Note:</strong> it is strongly recommended to not 379f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * omit this flag for any call to <code>saveLayer()</code> and 380f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <code>saveLayerAlpha()</code> variants. Not passing this flag generally 381f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * triggers extremely poor performance with hardware accelerated rendering. 382f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik */ 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CLIP_TO_LAYER_SAVE_FLAG = 0x10; 384f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik 385f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik /** 386f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Restore everything when restore() is called (standard save flags). 387f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p class="note"><strong>Note:</strong> for performance reasons, it is 388f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * strongly recommended to pass this - the complete set of flags - to any 389f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * call to <code>saveLayer()</code> and <code>saveLayerAlpha()</code> 390f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * variants. 391f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik */ 392051910b9f998030dacb8a0722588cc715813fde1Raph Levien public static final int ALL_SAVE_FLAG = 0x1F; 393051910b9f998030dacb8a0722588cc715813fde1Raph Levien 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 395f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Saves the current matrix and clip onto a private stack. 396f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p> 397f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Subsequent calls to translate,scale,rotate,skew,concat or clipRect, 398f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * clipPath will all operate as usual, but when the balancing call to 399f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * restore() is made, those calls will be forgotten, and the settings that 400f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * existed before the save() will be reinstated. 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The value to pass to restoreToCount() to balance this save() 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 40495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int save() { 40595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_save(mNativeCanvasWrapper, MATRIX_SAVE_FLAG | CLIP_SAVE_FLAG); 40695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 407051910b9f998030dacb8a0722588cc715813fde1Raph Levien 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Based on saveFlags, can save the current matrix and clip onto a private 410f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * stack. 411f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p class="note"><strong>Note:</strong> if possible, use the 412f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * parameter-less save(). It is simpler and faster than individually 413f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * disabling the saving of matrix or clip with this method. 414f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p> 415f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Subsequent calls to translate,scale,rotate,skew,concat or clipRect, 416f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * clipPath will all operate as usual, but when the balancing call to 417f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * restore() is made, those calls will be forgotten, and the settings that 418f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * existed before the save() will be reinstated. 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveFlags flag bits that specify which parts of the Canvas state 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to save/restore 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The value to pass to restoreToCount() to balance this save() 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 424ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int save(@Saveflags int saveFlags) { 42595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_save(mNativeCanvasWrapper, saveFlags); 42695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 429f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * This behaves the same as save(), but in addition it allocates and 430f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * redirects drawing to an offscreen bitmap. 431f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p class="note"><strong>Note:</strong> this method is very expensive, 432f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * incurring more than double rendering cost for contained content. Avoid 433f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * using this method, especially if the bounds provided are large, or if 434f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * the {@link #CLIP_TO_LAYER_SAVE_FLAG} is omitted from the 435f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * {@code saveFlags} parameter. It is recommended to use a 436f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * {@link android.view.View#LAYER_TYPE_HARDWARE hardware layer} on a View 437f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * to apply an xfermode, color filter, or alpha, as it will perform much 438f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * better than this method. 439f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p> 440f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * All drawing calls are directed to a newly allocated offscreen bitmap. 441f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Only when the balancing call to restore() is made, is that offscreen 442f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * buffer drawn back to the current target of the Canvas (either the 443f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * screen, it's target Bitmap, or the previous layer). 444f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p> 445f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Attributes of the Paint - {@link Paint#getAlpha() alpha}, 446f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * {@link Paint#getXfermode() Xfermode}, and 447f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * {@link Paint#getColorFilter() ColorFilter} are applied when the 448f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * offscreen bitmap is drawn back when restore() is called. 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds May be null. The maximum size the offscreen bitmap 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * needs to be (in local coordinates) 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint This is copied, and is applied to the offscreen when 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * restore() is called. 454f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * @param saveFlags see _SAVE_FLAG constants, generally {@link #ALL_SAVE_FLAG} is recommended 455f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * for performance reasons. 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return value to pass to restoreToCount() to balance this save() 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 458ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int saveLayer(@Nullable RectF bounds, @Nullable Paint paint, @Saveflags int saveFlags) { 4599bc13a353fa8fac323839268789ef661b219530cChris Craik if (bounds == null) { 4609bc13a353fa8fac323839268789ef661b219530cChris Craik bounds = new RectF(getClipBounds()); 4619bc13a353fa8fac323839268789ef661b219530cChris Craik } 4629bc13a353fa8fac323839268789ef661b219530cChris Craik return saveLayer(bounds.left, bounds.top, bounds.right, bounds.bottom, paint, saveFlags); 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 464c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 465c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 466c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Convenience for saveLayer(bounds, paint, {@link #ALL_SAVE_FLAG}) 467c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 468ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int saveLayer(@Nullable RectF bounds, @Nullable Paint paint) { 469c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayer(bounds, paint, ALL_SAVE_FLAG); 470c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 471c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper version of saveLayer() that takes 4 values rather than a RectF. 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 475ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int saveLayer(float left, float top, float right, float bottom, @Nullable Paint paint, 476ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Saveflags int saveFlags) { 4775c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_saveLayer(mNativeCanvasWrapper, left, top, right, bottom, 478f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint != null ? paint.mNativePaint : 0, 479f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy saveFlags); 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 483c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Convenience for saveLayer(left, top, right, bottom, paint, {@link #ALL_SAVE_FLAG}) 484c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 485ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int saveLayer(float left, float top, float right, float bottom, @Nullable Paint paint) { 486c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayer(left, top, right, bottom, paint, ALL_SAVE_FLAG); 487c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 488c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 489c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 490f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * This behaves the same as save(), but in addition it allocates and 491f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * redirects drawing to an offscreen bitmap. 492f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p class="note"><strong>Note:</strong> this method is very expensive, 493f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * incurring more than double rendering cost for contained content. Avoid 494f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * using this method, especially if the bounds provided are large, or if 495f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * the {@link #CLIP_TO_LAYER_SAVE_FLAG} is omitted from the 496f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * {@code saveFlags} parameter. It is recommended to use a 497f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * {@link android.view.View#LAYER_TYPE_HARDWARE hardware layer} on a View 498f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * to apply an xfermode, color filter, or alpha, as it will perform much 499f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * better than this method. 500f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p> 501f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * All drawing calls are directed to a newly allocated offscreen bitmap. 502f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Only when the balancing call to restore() is made, is that offscreen 503f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * buffer drawn back to the current target of the Canvas (either the 504f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * screen, it's target Bitmap, or the previous layer). 505f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p> 506f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * The {@code alpha} parameter is applied when the offscreen bitmap is 507f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * drawn back when restore() is called. 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds The maximum size the offscreen bitmap needs to be 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (in local coordinates) 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param alpha The alpha to apply to the offscreen when when it is 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawn during restore() 513f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * @param saveFlags see _SAVE_FLAG constants, generally {@link #ALL_SAVE_FLAG} is recommended 514f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * for performance reasons. 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return value to pass to restoreToCount() to balance this call 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5179bc13a353fa8fac323839268789ef661b219530cChris Craik public int saveLayerAlpha(@Nullable RectF bounds, int alpha, @Saveflags int saveFlags) { 5189bc13a353fa8fac323839268789ef661b219530cChris Craik if (bounds == null) { 5199bc13a353fa8fac323839268789ef661b219530cChris Craik bounds = new RectF(getClipBounds()); 5209bc13a353fa8fac323839268789ef661b219530cChris Craik } 5219bc13a353fa8fac323839268789ef661b219530cChris Craik return saveLayerAlpha(bounds.left, bounds.top, bounds.right, bounds.bottom, alpha, saveFlags); 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 523c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 524c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 525c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Convenience for saveLayerAlpha(bounds, alpha, {@link #ALL_SAVE_FLAG}) 526c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 5279bc13a353fa8fac323839268789ef661b219530cChris Craik public int saveLayerAlpha(@Nullable RectF bounds, int alpha) { 528c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayerAlpha(bounds, alpha, ALL_SAVE_FLAG); 529c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 530c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for saveLayerAlpha() that takes 4 values instead of a RectF. 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 534f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public int saveLayerAlpha(float left, float top, float right, float bottom, int alpha, 535ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Saveflags int saveFlags) { 5369bc13a353fa8fac323839268789ef661b219530cChris Craik alpha = Math.min(255, Math.max(0, alpha)); 5375c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_saveLayerAlpha(mNativeCanvasWrapper, left, top, right, bottom, 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project alpha, saveFlags); 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 542c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Helper for saveLayerAlpha(left, top, right, bottom, alpha, {@link #ALL_SAVE_FLAG}) 543c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 544c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik public int saveLayerAlpha(float left, float top, float right, float bottom, int alpha) { 545c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayerAlpha(left, top, right, bottom, alpha, ALL_SAVE_FLAG); 546c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 547c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 548c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This call balances a previous call to save(), and is used to remove all 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * modifications to the matrix/clip state since the last save call. It is 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an error to call restore() more times than save() was called. 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 55395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void restore() { 55495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_restore(mNativeCanvasWrapper); 55595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the number of matrix/clip states on the Canvas' private stack. 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This will equal # save() calls - # restore() calls. 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 56195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int getSaveCount() { 56295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_getSaveCount(mNativeCanvasWrapper); 56395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Efficient way to pop any calls to save() that happened after the save 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * count reached saveCount. It is an error for saveCount to be less than 1. 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Example: 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * int count = canvas.save(); 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ... // more calls potentially to save() 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * canvas.restoreToCount(count); 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * // now the canvas is back in the same state it was before the initial 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * // call to save(). 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveCount The save level to restore to. 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 57895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void restoreToCount(int saveCount) { 57995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_restoreToCount(mNativeCanvasWrapper, saveCount); 58095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified translation 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dx The distance to translate in X 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dy The distance to translate in Y 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 58895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void translate(float dx, float dy) { 58995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_translate(mNativeCanvasWrapper, dx, dy); 59095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified scale. 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to scale in X 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to scale in Y 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 59895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void scale(float sx, float sy) { 59995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_scale(mNativeCanvasWrapper, sx, sy); 60095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified scale. 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to scale in X 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to scale in Y 607cc3ec6cdb2b892eb29513e72d8b205acbe997b25Gilles Debunne * @param px The x-coord for the pivot point (unchanged by the scale) 608cc3ec6cdb2b892eb29513e72d8b205acbe997b25Gilles Debunne * @param py The y-coord for the pivot point (unchanged by the scale) 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void scale(float sx, float sy, float px, float py) { 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(px, py); 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project scale(sx, sy); 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(-px, -py); 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified rotation. 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param degrees The amount to rotate, in degrees 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 62195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void rotate(float degrees) { 62295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_rotate(mNativeCanvasWrapper, degrees); 62395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified rotation. 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param degrees The amount to rotate, in degrees 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param px The x-coord for the pivot point (unchanged by the rotation) 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param py The y-coord for the pivot point (unchanged by the rotation) 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void rotate(float degrees, float px, float py) { 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(px, py); 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project rotate(degrees); 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(-px, -py); 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified skew. 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to skew in X 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to skew in Y 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 64495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void skew(float sx, float sy) { 64595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_skew(mNativeCanvasWrapper, sx, sy); 64695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6494e7b772b733593fbe25c733e95b8dcea293234b6Romain Guy * Preconcat the current matrix with the specified matrix. If the specified 6504e7b772b733593fbe25c733e95b8dcea293234b6Romain Guy * matrix is null, this method does nothing. 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix to preconcatenate with the current matrix 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 654ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void concat(@Nullable Matrix matrix) { 6555c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita if (matrix != null) native_concat(mNativeCanvasWrapper, matrix.native_instance); 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 657051910b9f998030dacb8a0722588cc715813fde1Raph Levien 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Completely replace the current matrix with the specified matrix. If the 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * matrix parameter is null, then the current matrix is reset to identity. 661051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 662f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * <strong>Note:</strong> it is recommended to use {@link #concat(Matrix)}, 663f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * {@link #scale(float, float)}, {@link #translate(float, float)} and 664f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * {@link #rotate(float)} instead of this method. 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix to replace the current matrix with. If it is 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * null, set the current matrix to identity. 668051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 669051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @see #concat(Matrix) 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 671ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void setMatrix(@Nullable Matrix matrix) { 6725c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_setMatrix(mNativeCanvasWrapper, 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project matrix == null ? 0 : matrix.native_instance); 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 675051910b9f998030dacb8a0722588cc715813fde1Raph Levien 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return, in ctm, the current transformation matrix. This does not alter 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the matrix in the canvas, but just returns a copy of it. 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 680f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 681ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void getMatrix(@NonNull Matrix ctm) { 6825c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_getCTM(mNativeCanvasWrapper, ctm.native_instance); 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 68441030da16856c8869e1e51d4a0405432fa96614eRomain Guy 68541030da16856c8869e1e51d4a0405432fa96614eRomain Guy /** 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a new matrix with a copy of the canvas' current transformation 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * matrix. 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 68965447287cb4112cf74483c87be70bcd00b622e2dRomain Guy @Deprecated 690ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public final @NonNull Matrix getMatrix() { 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Matrix m = new Matrix(); 692f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy //noinspection deprecation 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getMatrix(m); 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return m; 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 696051910b9f998030dacb8a0722588cc715813fde1Raph Levien 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle. 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rect to intersect with the current clip 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 704ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRect(@NonNull RectF rect, @NonNull Region.Op op) { 7055c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom, 706f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy op.nativeInt); 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle, which is 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 717ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRect(@NonNull Rect rect, @NonNull Region.Op op) { 7185c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom, 719f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy op.nativeInt); 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 729ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRect(@NonNull RectF rect) { 73095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_clipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom, 73195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita Region.Op.INTERSECT.nativeInt); 73295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 73395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 741ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRect(@NonNull Rect rect) { 74295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_clipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom, 74395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita Region.Op.INTERSECT.nativeInt); 74495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 745051910b9f998030dacb8a0722588cc715813fde1Raph Levien 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle, which is 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 761ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRect(float left, float top, float right, float bottom, 762ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Region.Op op) { 7635c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipRect(mNativeCanvasWrapper, left, top, right, bottom, op.nativeInt); 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current clip 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 77995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public boolean clipRect(float left, float top, float right, float bottom) { 78095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_clipRect(mNativeCanvasWrapper, left, top, right, bottom, 78195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita Region.Op.INTERSECT.nativeInt); 78295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 783f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current clip 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 79795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public boolean clipRect(int left, int top, int right, int bottom) { 79895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_clipRect(mNativeCanvasWrapper, left, top, right, bottom, 79995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita Region.Op.INTERSECT.nativeInt); 80095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 801f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified path. 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to operate on the current clip 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 809ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipPath(@NonNull Path path, @NonNull Region.Op op) { 8105c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipPath(mNativeCanvasWrapper, path.ni(), op.nativeInt); 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 812051910b9f998030dacb8a0722588cc715813fde1Raph Levien 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified path. 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to intersect with the current clip 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 819ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipPath(@NonNull Path path) { 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return clipPath(path, Region.Op.INTERSECT); 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 822051910b9f998030dacb8a0722588cc715813fde1Raph Levien 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified region. Note that unlike 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect() and clipPath() which transform their arguments by the 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, clipRegion() assumes its argument is already in the 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinate system of the current layer's bitmap, and so not 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * transformation is performed. 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param region The region to operate on the current clip, based on op 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 8330d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * 8340d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * @deprecated Unlike all other clip calls this API does not respect the 8350d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * current matrix. Use {@link #clipRect(Rect)} as an alternative. 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 837ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRegion(@NonNull Region region, @NonNull Region.Op op) { 8385c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipRegion(mNativeCanvasWrapper, region.ni(), op.nativeInt); 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified region. Note that unlike 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect() and clipPath() which transform their arguments by the 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, clipRegion() assumes its argument is already in the 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinate system of the current layer's bitmap, and so not 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * transformation is performed. 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param region The region to operate on the current clip, based on op 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 8500d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * 8510d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * @deprecated Unlike all other clip calls this API does not respect the 8520d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * current matrix. Use {@link #clipRect(Rect)} as an alternative. 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 854ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRegion(@NonNull Region region) { 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return clipRegion(region, Region.Op.INTERSECT); 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 857051910b9f998030dacb8a0722588cc715813fde1Raph Levien 858ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public @Nullable DrawFilter getDrawFilter() { 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mDrawFilter; 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 861051910b9f998030dacb8a0722588cc715813fde1Raph Levien 862ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void setDrawFilter(@Nullable DrawFilter filter) { 86336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeFilter = 0; 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (filter != null) { 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeFilter = filter.mNativeInt; 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDrawFilter = filter; 8685c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita nativeSetDrawFilter(mNativeCanvasWrapper, nativeFilter); 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum EdgeType { 872d320001807168f5565bab9807ef13c111096bbb3Chet Haase 873d320001807168f5565bab9807ef13c111096bbb3Chet Haase /** 874d320001807168f5565bab9807ef13c111096bbb3Chet Haase * Black-and-White: Treat edges by just rounding to nearest pixel boundary 875d320001807168f5565bab9807ef13c111096bbb3Chet Haase */ 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project BW(0), //!< treat edges by just rounding to nearest pixel boundary 877d320001807168f5565bab9807ef13c111096bbb3Chet Haase 878d320001807168f5565bab9807ef13c111096bbb3Chet Haase /** 879d320001807168f5565bab9807ef13c111096bbb3Chet Haase * Antialiased: Treat edges by rounding-out, since they may be antialiased 880d320001807168f5565bab9807ef13c111096bbb3Chet Haase */ 881d320001807168f5565bab9807ef13c111096bbb3Chet Haase AA(1); 882051910b9f998030dacb8a0722588cc715813fde1Raph Levien 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EdgeType(int nativeInt) { 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = nativeInt; 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 886c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy 887c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy /** 888c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy * @hide 889c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy */ 890c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy public final int nativeInt; 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified rectangle, after being transformed by the 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect the rect to compare with the current clip 900d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 901d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 902d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the rect (transformed by the canvas' matrix) 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 906ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean quickReject(@NonNull RectF rect, @NonNull EdgeType type) { 90795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_quickReject(mNativeCanvasWrapper, 90895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita rect.left, rect.top, rect.right, rect.bottom); 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified path, after being transformed by the 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). Note: for speed it may 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * return false even if the path itself might not intersect the clip 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (i.e. the bounds of the path intersects, but the path does not). 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to compare with the current clip 920d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 921d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 922d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the path (transformed by the canvas' matrix) 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 926ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean quickReject(@NonNull Path path, @NonNull EdgeType type) { 9275c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_quickReject(mNativeCanvasWrapper, path.ni()); 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified rectangle, after being transformed by the 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to compare with the 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to compare with the current 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to compare with the 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to compare with the 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 944d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 945d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 946d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the rect (transformed by the canvas' matrix) 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 950ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger public boolean quickReject(float left, float top, float right, float bottom, 951ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull EdgeType type) { 9525c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_quickReject(mNativeCanvasWrapper, left, top, right, bottom); 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 956708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * Return the bounds of the current clip (in local coordinates) in the 957708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * bounds parameter, and return true if it is non-empty. This can be useful 958708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * in a way similar to quickReject, in that it tells you that drawing 959708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * outside of these bounds will be clipped out. 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds Return the clip bounds here. If it is null, ignore it but 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * still return true if the current clip is non-empty. 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the current clip is non-empty. 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 965ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean getClipBounds(@Nullable Rect bounds) { 9665c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_getClipBounds(mNativeCanvasWrapper, bounds); 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 968051910b9f998030dacb8a0722588cc715813fde1Raph Levien 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 970708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * Retrieve the bounds of the current clip (in local coordinates). 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the clip bounds, or [0, 0, 0, 0] if the clip is empty. 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 974ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public final @NonNull Rect getClipBounds() { 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect r = new Rect(); 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getClipBounds(r); 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return r; 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 979051910b9f998030dacb8a0722588cc715813fde1Raph Levien 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified RGB color, using srcover porterduff mode. 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r red component (0..255) of the color to draw onto the canvas 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param g green component (0..255) of the color to draw onto the canvas 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param b blue component (0..255) of the color to draw onto the canvas 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRGB(int r, int g, int b) { 9898872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger drawColor(Color.rgb(r, g, b)); 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified ARGB color, using srcover porterduff mode. 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param a alpha component (0..255) of the color to draw onto the canvas 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r red component (0..255) of the color to draw onto the canvas 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param g green component (0..255) of the color to draw onto the canvas 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param b blue component (0..255) of the color to draw onto the canvas 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawARGB(int a, int r, int g, int b) { 10028872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger drawColor(Color.argb(a, r, g, b)); 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified color, using srcover porterduff mode. 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param color the color to draw onto the canvas 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawColor(int color) { 10128872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger native_drawColor(mNativeCanvasWrapper, color, PorterDuff.Mode.SRC_OVER.nativeInt); 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified color and porter-duff xfermode. 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param color the color to draw with 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode the porter-duff mode to apply to the color 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1022ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawColor(int color, @NonNull PorterDuff.Mode mode) { 10235c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawColor(mNativeCanvasWrapper, color, mode.nativeInt); 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified paint. This is equivalent (but faster) to drawing an 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * infinitely large rectangle with the specified paint. 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw onto the canvas 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1033ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPaint(@NonNull Paint paint) { 10345c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawPaint(mNativeCanvasWrapper, paint.mNativePaint); 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1036051910b9f998030dacb8a0722588cc715813fde1Raph Levien 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a series of points. Each point is centered at the coordinate 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified by pts[], and its diameter is specified by the paint's stroke 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * width (as transformed by the canvas' CTM), with special treatment for 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a stroke width of 0, which always draws exactly 1 pixel (or at most 4 10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if antialiasing is enabled). The shape of the point is controlled by 10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the paint's Cap type. The shape is a square, unless the cap type is 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Round, in which case the shape is a circle. 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pts Array of points to draw [x0 y0 x1 y1 x2 y2 ...] 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Number of values to skip before starting to draw. 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of values to process, after skipping offset 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of them. Since one point uses two values, the number of 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * "points" that are drawn is really (count >> 1). 10519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the points 10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1053ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPoints(float[] pts, int offset, int count, @NonNull Paint paint) { 105495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_drawPoints(mNativeCanvasWrapper, pts, offset, count, paint.mNativePaint); 105595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for drawPoints() that assumes you want to draw the entire array 10599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1060ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPoints(@NonNull float[] pts, @NonNull Paint paint) { 10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPoints(pts, 0, pts.length, paint); 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for drawPoints() for drawing a single point. 10669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1067ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPoint(float x, float y, @NonNull Paint paint) { 106895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_drawPoint(mNativeCanvasWrapper, x, y, paint.mNativePaint); 106995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a line segment with the specified start and stop x,y coordinates, 1073a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * using the specified paint. 1074a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * 1075a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * <p>Note that since a line is always "framed", the Style is ignored in the paint.</p> 1076a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * 1077a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * <p>Degenerate lines (length is 0) will not be drawn.</p> 10789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startX The x-coordinate of the start point of the line 10809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startY The y-coordinate of the start point of the line 10819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the line 10829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1083ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawLine(float startX, float startY, float stopX, float stopY, 1084ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 10855c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawLine(mNativeCanvasWrapper, startX, startY, stopX, stopY, paint.mNativePaint); 10869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a series of lines. Each line is taken from 4 consecutive values 10909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the pts array. Thus to draw 1 line, the array must contain at least 4 10919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * values. This is logically the same as drawing the array as follows: 10929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawLine(pts[0], pts[1], pts[2], pts[3]) followed by 10939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawLine(pts[4], pts[5], pts[6], pts[7]) and so on. 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pts Array of points to draw [x0 y0 x1 y1 x2 y2 ...] 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Number of values in the array to skip before drawing. 10979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of values in the array to process, after 10989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * skipping "offset" of them. Since each line uses 4 values, 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the number of "lines" that are drawn is really 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (count >> 2). 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the points 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 110395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void drawLines(float[] pts, int offset, int count, Paint paint) { 110495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_drawLines(mNativeCanvasWrapper, pts, offset, count, paint.mNativePaint); 110595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1107ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawLines(@NonNull float[] pts, @NonNull Paint paint) { 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawLines(pts, 0, pts.length, paint); 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified paint. The rectangle will 11139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be filled or framed based on the Style in the paint. 11149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rect to be drawn 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rect 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1118ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawRect(@NonNull RectF rect, @NonNull Paint paint) { 111995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_drawRect(mNativeCanvasWrapper, 112095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita rect.left, rect.top, rect.right, rect.bottom, paint.mNativePaint); 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified Paint. The rectangle 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be filled or framed based on the Style in the paint. 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r The rectangle to be drawn. 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rectangle 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1130ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawRect(@NonNull Rect r, @NonNull Paint paint) { 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawRect(r.left, r.top, r.right, r.bottom, paint); 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1133051910b9f998030dacb8a0722588cc715813fde1Raph Levien 11349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified paint. The rectangle will 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be filled or framed based on the Style in the paint. 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to be drawn 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top side of the rectangle to be drawn 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to be drawn 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom side of the rectangle to be drawn 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rect 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1145ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawRect(float left, float top, float right, float bottom, @NonNull Paint paint) { 11465c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawRect(mNativeCanvasWrapper, left, top, right, bottom, paint.mNativePaint); 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified oval using the specified paint. The oval will be 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * filled or framed based on the Style in the paint. 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param oval The rectangle bounds of the oval to be drawn 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1155ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawOval(@NonNull RectF oval, @NonNull Paint paint) { 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (oval == null) { 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 115924609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese drawOval(oval.left, oval.top, oval.right, oval.bottom, paint); 116024609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese } 116124609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese 116224609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese /** 116324609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * Draw the specified oval using the specified paint. The oval will be 116424609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * filled or framed based on the Style in the paint. 116524609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese */ 116624609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese public void drawOval(float left, float top, float right, float bottom, @NonNull Paint paint) { 116724609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese native_drawOval(mNativeCanvasWrapper, left, top, right, bottom, paint.mNativePaint); 11689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified circle using the specified paint. If radius is <= 0, 11729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then nothing will be drawn. The circle will be filled or framed based 11739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on the Style in the paint. 11749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cx The x-coordinate of the center of the cirle to be drawn 11769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cy The y-coordinate of the center of the cirle to be drawn 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param radius The radius of the cirle to be drawn 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the circle 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1180ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawCircle(float cx, float cy, float radius, @NonNull Paint paint) { 11815c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawCircle(mNativeCanvasWrapper, cx, cy, radius, paint.mNativePaint); 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11854a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>Draw the specified arc, which will be scaled to fit inside the 11864a317db43d2bbc992284dd1f651751f13734d017Romain Guy * specified oval.</p> 1187051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 11884a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>If the start angle is negative or >= 360, the start angle is treated 11894a317db43d2bbc992284dd1f651751f13734d017Romain Guy * as start angle modulo 360.</p> 1190051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 11914a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>If the sweep angle is >= 360, then the oval is drawn 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completely. Note that this differs slightly from SkPath::arcTo, which 11934a317db43d2bbc992284dd1f651751f13734d017Romain Guy * treats the sweep angle modulo 360. If the sweep angle is negative, 11944a317db43d2bbc992284dd1f651751f13734d017Romain Guy * the sweep angle is treated as sweep angle modulo 360</p> 1195051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 11964a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>The arc is drawn clockwise. An angle of 0 degrees correspond to the 11974a317db43d2bbc992284dd1f651751f13734d017Romain Guy * geometric angle of 0 degrees (3 o'clock on a watch.)</p> 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param oval The bounds of oval used to define the shape and size 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the arc 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startAngle Starting angle (in degrees) where the arc begins 12029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sweepAngle Sweep angle (in degrees) measured clockwise 12039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param useCenter If true, include the center of the oval in the arc, and 12049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project close it if it is being stroked. This will draw a wedge 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the arc 12069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1207ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawArc(@NonNull RectF oval, float startAngle, float sweepAngle, boolean useCenter, 1208ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 120924609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese drawArc(oval.left, oval.top, oval.right, oval.bottom, startAngle, sweepAngle, useCenter, 121024609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese paint); 121124609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese } 121224609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese 121324609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese /** 121424609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * <p>Draw the specified arc, which will be scaled to fit inside the 121524609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * specified oval.</p> 121624609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * 121724609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * <p>If the start angle is negative or >= 360, the start angle is treated 121824609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * as start angle modulo 360.</p> 121924609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * 122024609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * <p>If the sweep angle is >= 360, then the oval is drawn 122124609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * completely. Note that this differs slightly from SkPath::arcTo, which 122224609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * treats the sweep angle modulo 360. If the sweep angle is negative, 122324609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * the sweep angle is treated as sweep angle modulo 360</p> 122424609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * 122524609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * <p>The arc is drawn clockwise. An angle of 0 degrees correspond to the 122624609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * geometric angle of 0 degrees (3 o'clock on a watch.)</p> 122724609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * 122824609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * @param startAngle Starting angle (in degrees) where the arc begins 122924609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * @param sweepAngle Sweep angle (in degrees) measured clockwise 123024609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * @param useCenter If true, include the center of the oval in the arc, and 123124609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese close it if it is being stroked. This will draw a wedge 123224609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * @param paint The paint used to draw the arc 123324609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese */ 123424609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese public void drawArc(float left, float top, float right, float bottom, float startAngle, 123524609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese float sweepAngle, boolean useCenter, @NonNull Paint paint) { 123624609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese native_drawArc(mNativeCanvasWrapper, left, top, right, bottom, startAngle, sweepAngle, 1237f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy useCenter, paint.mNativePaint); 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified round-rect using the specified paint. The roundrect 12429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be filled or framed based on the Style in the paint. 12439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangular bounds of the roundRect to be drawn 12459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rx The x-radius of the oval used to round the corners 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param ry The y-radius of the oval used to round the corners 12479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the roundRect 12489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1249ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawRoundRect(@NonNull RectF rect, float rx, float ry, @NonNull Paint paint) { 12504d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik drawRoundRect(rect.left, rect.top, rect.right, rect.bottom, rx, ry, paint); 12514d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik } 12524d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik 12534d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik /** 12544d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * Draw the specified round-rect using the specified paint. The roundrect 12554d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * will be filled or framed based on the Style in the paint. 12564d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * 12574d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * @param rx The x-radius of the oval used to round the corners 12584d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * @param ry The y-radius of the oval used to round the corners 12594d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * @param paint The paint used to draw the roundRect 12604d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik */ 12614d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik public void drawRoundRect(float left, float top, float right, float bottom, float rx, float ry, 1262ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 12635c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawRoundRect(mNativeCanvasWrapper, left, top, right, bottom, rx, ry, paint.mNativePaint); 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified path using the specified paint. The path will be 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * filled or framed based on the Style in the paint. 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to be drawn 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the path 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1273ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPath(@NonNull Path path, @NonNull Paint paint) { 12745c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawPath(mNativeCanvasWrapper, path.ni(), paint.mNativePaint); 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12761abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik 12771abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik /** 12781abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * @hide 12791abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik */ 12801abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik protected static void throwIfCannotDraw(Bitmap bitmap) { 12819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bitmap.isRecycled()) { 1282f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy throw new RuntimeException("Canvas: trying to use a recycled bitmap " + bitmap); 12839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12841abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik if (!bitmap.isPremultiplied() && bitmap.getConfig() == Bitmap.Config.ARGB_8888 && 12851abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik bitmap.hasAlpha()) { 12861abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throw new RuntimeException("Canvas: trying to use a non-premultiplied bitmap " 12871abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik + bitmap); 12881abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik } 12899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1292deba785f122a47915756ffd991f5540d952cf937Romain Guy * Draws the specified bitmap as an N-patch (most often, a 9-patches.) 1293deba785f122a47915756ffd991f5540d952cf937Romain Guy * 12943b748a44c6bd2ea05fe16839caf73dbe50bd7ae9Romain Guy * @param patch The ninepatch object to render 1295deba785f122a47915756ffd991f5540d952cf937Romain Guy * @param dst The destination rectangle. 1296deba785f122a47915756ffd991f5540d952cf937Romain Guy * @param paint The paint to draw the bitmap with. may be null 1297051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 1298deba785f122a47915756ffd991f5540d952cf937Romain Guy * @hide 1299deba785f122a47915756ffd991f5540d952cf937Romain Guy */ 1300ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPatch(@NonNull NinePatch patch, @NonNull Rect dst, @Nullable Paint paint) { 1301f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy patch.drawSoftware(this, dst, paint); 1302f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy } 1303f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy 1304f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy /** 1305f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * Draws the specified bitmap as an N-patch (most often, a 9-patches.) 1306f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * 1307f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @param patch The ninepatch object to render 1308f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @param dst The destination rectangle. 1309f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @param paint The paint to draw the bitmap with. may be null 1310f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * 1311f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @hide 1312f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy */ 1313ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPatch(@NonNull NinePatch patch, @NonNull RectF dst, @Nullable Paint paint) { 1314f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy patch.drawSoftware(this, dst, paint); 1315f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy } 1316f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy 1317deba785f122a47915756ffd991f5540d952cf937Romain Guy /** 13189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, with its top/left corner at (x,y), using 13199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified paint, transformed by the current matrix. 1320051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 132111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 13259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 132711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>If the bitmap and canvas have different densities, this function 132811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * will take care of automatically scaling the bitmap to draw at the 132911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * same density as the canvas. 1330051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The position of the left side of the bitmap being drawn 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The position of the top side of the bitmap being drawn 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the bitmap (may be null) 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1336ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull Bitmap bitmap, float left, float top, @Nullable Paint paint) { 13371abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 13385c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawBitmap(mNativeCanvasWrapper, bitmap.ni(), left, top, 1339f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy paint != null ? paint.mNativePaint : 0, mDensity, mScreenDensity, bitmap.mDensity); 13409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, scaling/translating automatically to fill 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the destination rectangle. If the source rectangle is not null, it 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specifies the subset of the bitmap to draw. 1346051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 134711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 13489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 13499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 13509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 13519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 135311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>This function <em>ignores the density associated with the bitmap</em>. 135411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * This is because the source and destination rectangle coordinate 135511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * spaces are in their respective densities, so must already have the 135611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * appropriate scaling factor applied. 1357051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 13589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 13599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param src May be null. The subset of the bitmap to be drawn 13609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dst The rectangle that the bitmap will be scaled/translated 13619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to fit into 13629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 13639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1364ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull Bitmap bitmap, @Nullable Rect src, @NonNull RectF dst, 1365ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Nullable Paint paint) { 13668872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger if (dst == null) { 13678872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger throw new NullPointerException(); 13688872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } 13698872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger throwIfCannotDraw(bitmap); 13708872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger final long nativePaint = paint == null ? 0 : paint.mNativePaint; 13718872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger 13728872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger float left, top, right, bottom; 13738872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger if (src == null) { 13748872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger left = top = 0; 13758872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger right = bitmap.getWidth(); 13768872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bottom = bitmap.getHeight(); 13778872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } else { 13788872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger left = src.left; 13798872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger right = src.right; 13808872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger top = src.top; 13818872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bottom = src.bottom; 13828872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } 13838872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger 13848872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger native_drawBitmap(mNativeCanvasWrapper, bitmap.ni(), left, top, right, bottom, 13858872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger dst.left, dst.top, dst.right, dst.bottom, nativePaint, mScreenDensity, 13868872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bitmap.mDensity); 13878872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } 13889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, scaling/translating automatically to fill 13919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the destination rectangle. If the source rectangle is not null, it 13929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specifies the subset of the bitmap to draw. 1393051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 139411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 13959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 13969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 13979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 13999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 140011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>This function <em>ignores the density associated with the bitmap</em>. 140111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * This is because the source and destination rectangle coordinate 140211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * spaces are in their respective densities, so must already have the 140311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * appropriate scaling factor applied. 1404051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 14059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 14069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param src May be null. The subset of the bitmap to be drawn 14079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dst The rectangle that the bitmap will be scaled/translated 14089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to fit into 14099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 14109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1411ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull Bitmap bitmap, @Nullable Rect src, @NonNull Rect dst, 1412ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Nullable Paint paint) { 14139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (dst == null) { 14149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 14159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14161abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 14178872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger final long nativePaint = paint == null ? 0 : paint.mNativePaint; 14188872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger 14198872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger int left, top, right, bottom; 14208872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger if (src == null) { 14218872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger left = top = 0; 14228872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger right = bitmap.getWidth(); 14238872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bottom = bitmap.getHeight(); 14248872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } else { 14258872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger left = src.left; 14268872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger right = src.right; 14278872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger top = src.top; 14288872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bottom = src.bottom; 14298872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } 14308872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger 14318872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger native_drawBitmap(mNativeCanvasWrapper, bitmap.ni(), left, top, right, bottom, 14328872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger dst.left, dst.top, dst.right, dst.bottom, nativePaint, mScreenDensity, 14338872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bitmap.mDensity); 14349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1435051910b9f998030dacb8a0722588cc715813fde1Raph Levien 14369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Treat the specified array of colors as a bitmap, and draw it. This gives 14389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the same result as first creating a bitmap from the array, and then 14399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawing it, but this method avoids explicitly creating a bitmap object 14409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * which can be more efficient if the colors are changing often. 14419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors Array of colors representing the pixels of the bitmap 14439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Offset into the array of colors for the first pixel 144483d522290e56f614d0d9373d47c2b54b9e207795Brad Fitzpatrick * @param stride The number of colors in the array between rows (must be 14459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * >= width or <= -width). 14469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The X coordinate for where to draw the bitmap 14479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The Y coordinate for where to draw the bitmap 14489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The width of the bitmap 14499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The height of the bitmap 14509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hasAlpha True if the alpha channel of the colors contains valid 14519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * values. If false, the alpha byte is ignored (assumed to 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be 0xFF for every pixel). 14539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 1454cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * 1455cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * @deprecated Usage with a {@link #isHardwareAccelerated() hardware accelerated} canvas 1456cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * requires an internal copy of color buffer contents every time this method is called. Using a 1457cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * Bitmap avoids this copy, and allows the application to more explicitly control the lifetime 1458cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * and copies of pixel data. 14599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1460cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik @Deprecated 1461ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull int[] colors, int offset, int stride, float x, float y, 1462ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese int width, int height, boolean hasAlpha, @Nullable Paint paint) { 14639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // check for valid input 14649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width < 0) { 14659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("width must be >= 0"); 14669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (height < 0) { 14689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("height must be >= 0"); 14699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (Math.abs(stride) < width) { 14719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("abs(stride) must be >= width"); 14729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int lastScanline = offset + (height - 1) * stride; 14749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = colors.length; 14759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (offset < 0 || (offset + width > length) || lastScanline < 0 14769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (lastScanline + width > length)) { 14779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 14789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // quick escape if there's nothing to draw 14809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width == 0 || height == 0) { 14819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 14829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // punch down to native for the actual draw 14845c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawBitmap(mNativeCanvasWrapper, colors, offset, stride, x, y, width, height, hasAlpha, 14859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint != null ? paint.mNativePaint : 0); 14869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1487cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik 1488cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik /** 1489cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * Legacy version of drawBitmap(int[] colors, ...) that took ints for x,y 1490cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * 1491cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * @deprecated Usage with a {@link #isHardwareAccelerated() hardware accelerated} canvas 1492cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * requires an internal copy of color buffer contents every time this method is called. Using a 1493cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * Bitmap avoids this copy, and allows the application to more explicitly control the lifetime 1494cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * and copies of pixel data. 14959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1496cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik @Deprecated 1497ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull int[] colors, int offset, int stride, int x, int y, 1498ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese int width, int height, boolean hasAlpha, @Nullable Paint paint) { 14999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // call through to the common float version 15009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawBitmap(colors, offset, stride, (float)x, (float)y, width, height, 15019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project hasAlpha, paint); 15029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1503cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik 15049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the bitmap using the specified matrix. 15069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to draw 15089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix used to transform the bitmap when it is drawn 15099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 15109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1511ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull Bitmap bitmap, @NonNull Matrix matrix, @Nullable Paint paint) { 15125c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita nativeDrawBitmapMatrix(mNativeCanvasWrapper, bitmap.ni(), matrix.ni(), 15139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint != null ? paint.mNativePaint : 0); 15149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15155a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy 15165a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy /** 15175a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy * @hide 15185a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy */ 15195a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy protected static void checkRange(int length, int offset, int count) { 15209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((offset | count) < 0 || offset + count > length) { 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 15229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1524051910b9f998030dacb8a0722588cc715813fde1Raph Levien 15259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the bitmap through the mesh, where mesh vertices are evenly 15279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed across the bitmap. There are meshWidth+1 vertices across, and 15289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * meshHeight+1 vertices down. The verts array is accessed in row-major 15299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * order, so that the first meshWidth+1 vertices are distributed across the 15309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * top of the bitmap from left to right. A more general version of this 15315d11676414b3606792e23c269cf75b44faa1a2afChris Craik * method is drawVertices(). 15329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to draw using the mesh 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param meshWidth The number of columns in the mesh. Nothing is drawn if 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this is 0 15369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param meshHeight The number of rows in the mesh. Nothing is drawn if 15379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this is 0 15389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param verts Array of x,y pairs, specifying where the mesh should be 15399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawn. There must be at least 15405d11676414b3606792e23c269cf75b44faa1a2afChris Craik * (meshWidth+1) * (meshHeight+1) * 2 + vertOffset values 15419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the array 15429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertOffset Number of verts elements to skip before drawing 15439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors May be null. Specifies a color at each vertex, which is 15449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * interpolated across the cell, and whose values are 15459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * multiplied by the corresponding bitmap colors. If not null, 15469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * there must be at least (meshWidth+1) * (meshHeight+1) + 15479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * colorOffset values in the array. 15489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colorOffset Number of color elements to skip before drawing 15499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 15509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1551ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmapMesh(@NonNull Bitmap bitmap, int meshWidth, int meshHeight, 1552ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull float[] verts, int vertOffset, @Nullable int[] colors, int colorOffset, 1553ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Nullable Paint paint) { 15549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((meshWidth | meshHeight | vertOffset | colorOffset) < 0) { 15559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 15569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (meshWidth == 0 || meshHeight == 0) { 15589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 15599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int count = (meshWidth + 1) * (meshHeight + 1); 15619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we mul by 2 since we need two floats per vertex 15629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(verts.length, vertOffset, count * 2); 15639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (colors != null) { 15649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // no mul by 2, since we need only 1 color per vertex 15659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(colors.length, colorOffset, count); 15669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15675c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita nativeDrawBitmapMesh(mNativeCanvasWrapper, bitmap.ni(), meshWidth, meshHeight, 1568f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy verts, vertOffset, colors, colorOffset, 1569f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint != null ? paint.mNativePaint : 0); 15709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1571f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 15729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum VertexMode { 15739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLES(0), 15749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLE_STRIP(1), 15759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLE_FAN(2); 1576051910b9f998030dacb8a0722588cc715813fde1Raph Levien 15779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project VertexMode(int nativeInt) { 15789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = nativeInt; 15799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1580a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy 1581a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy /** 1582a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy * @hide 1583a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy */ 1584a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy public final int nativeInt; 15859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1586051910b9f998030dacb8a0722588cc715813fde1Raph Levien 15879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the array of vertices, interpreted as triangles (based on mode). The 15899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * verts array is required, and specifies the x,y pairs for each vertex. If 15909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * texs is non-null, then it is used to specify the coordinate in shader 15919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinates to use at each vertex (the paint must have a shader in this 15929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * case). If there is no texs array, but there is a color array, then each 15939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color is interpolated across its corresponding triangle in a gradient. If 15949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * both texs and colors arrays are present, then they behave as before, but 15959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the resulting color at each pixels is the result of multiplying the 15969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * colors from the shader and the color-gradient together. The indices array 15979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is optional, but if it is present, then it is used to specify the index 15989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of each triangle, rather than just walking through the arrays in order. 15999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode How to interpret the array of vertices 16019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertexCount The number of values in the vertices array (and 16029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * corresponding texs and colors arrays if non-null). Each logical 16039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex is two values (x, y), vertexCount must be a multiple of 2. 16049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param verts Array of vertices for the mesh 16059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertOffset Number of values in the verts to skip before drawing. 16069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param texs May be null. If not null, specifies the coordinates to sample 16079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * into the current shader (e.g. bitmap tile or gradient) 16089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param texOffset Number of values in texs to skip before drawing. 16099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors May be null. If not null, specifies a color for each 16109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex, to be interpolated across the triangle. 16119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colorOffset Number of values in colors to skip before drawing. 16129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param indices If not null, array of indices to reference into the 16139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex (texs, colors) array. 16149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param indexCount number of entries in the indices array (if not null). 1615051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @param paint Specifies the shader to use if the texs array is non-null. 16169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1617ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawVertices(@NonNull VertexMode mode, int vertexCount, @NonNull float[] verts, 1618ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese int vertOffset, @Nullable float[] texs, int texOffset, @Nullable int[] colors, 1619ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese int colorOffset, @Nullable short[] indices, int indexOffset, int indexCount, 1620ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 16219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(verts.length, vertOffset, vertexCount); 16229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (texs != null) { 16239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(texs.length, texOffset, vertexCount); 16249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (colors != null) { 162692ce5734b52ef014c80cc6335112a027188b3eb6Erik Faye-Lund checkRange(colors.length, colorOffset, vertexCount / 2); 16279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (indices != null) { 16299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(indices.length, indexOffset, indexCount); 16309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16315c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita nativeDrawVertices(mNativeCanvasWrapper, mode.nativeInt, vertexCount, verts, 1632f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy vertOffset, texs, texOffset, colors, colorOffset, 1633f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy indices, indexOffset, indexCount, paint.mNativePaint); 16349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 163536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat 16369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. The 16389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin is interpreted based on the Align setting in the paint. 16399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 16419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 16429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of the origin of the text being drawn 16439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 16449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1645ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawText(@NonNull char[] text, int index, int count, float x, float y, 1646ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 16479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((index | count | (index + count) | 16489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project (text.length - index - count)) < 0) { 16499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 16509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16515c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, text, index, count, x, y, paint.mBidiFlags, 1652a033630e805c407080221e20b236b6054f324670Raph Levien paint.mNativePaint, paint.mNativeTypeface); 16539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. The 16579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin is interpreted based on the Align setting in the paint. 16589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 16609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 16619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of the origin of the text being drawn 16629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 16639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1664ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawText(@NonNull String text, float x, float y, @NonNull Paint paint) { 16655c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, text, 0, text.length(), x, y, paint.mBidiFlags, 1666a033630e805c407080221e20b236b6054f324670Raph Levien paint.mNativePaint, paint.mNativeTypeface); 1667f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 16689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. 16719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The origin is interpreted based on the Align setting in the paint. 16729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 16749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param start The index of the first character in text to draw 16759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param end (end - 1) is the index of the last character in text to draw 16769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 16779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of the origin of the text being drawn 16789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 16799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1680ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawText(@NonNull String text, int start, int end, float x, float y, 1681ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 16829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((start | end | (end - start) | (text.length() - end)) < 0) { 16839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 16849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16855c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, text, start, end, x, y, paint.mBidiFlags, 1686a033630e805c407080221e20b236b6054f324670Raph Levien paint.mNativePaint, paint.mNativeTypeface); 16879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified range of text, specified by start/end, with its 16919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin at (x,y), in the specified Paint. The origin is interpreted 16929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * based on the Align setting in the Paint. 16939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 16959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param start The index of the first character in text to draw 16969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param end (end - 1) is the index of the last character in text 16979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to draw 16989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of origin for where to draw the text 16999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of origin for where to draw the text 17009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 17019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1702ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawText(@NonNull CharSequence text, int start, int end, float x, float y, 1703ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 17049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (text instanceof String || text instanceof SpannedString || 17059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project text instanceof SpannableString) { 17065c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, text.toString(), start, end, x, y, 1707a033630e805c407080221e20b236b6054f324670Raph Levien paint.mBidiFlags, paint.mNativePaint, paint.mNativeTypeface); 1708f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else if (text instanceof GraphicsOperations) { 17099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ((GraphicsOperations) text).drawText(this, start, end, x, y, 1710f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint); 1711f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else { 1712f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt char[] buf = TemporaryBuffer.obtain(end - start); 1713f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt TextUtils.getChars(text, start, end, buf, 0); 17145c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, buf, 0, end - start, x, y, 1715a033630e805c407080221e20b236b6054f324670Raph Levien paint.mBidiFlags, paint.mNativePaint, paint.mNativeTypeface); 1716f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt TemporaryBuffer.recycle(buf); 17179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1718f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1719f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1720f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1721f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * Render a run of all LTR or all RTL text, with shaping. This does not run 1722f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * bidi on the provided text, but renders it as a uniform right-to-left or 1723f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * left-to-right run, as indicated by dir. Alignment of the text is as 1724f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * determined by the Paint's TextAlign value. 1725051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 1726f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param text the text to render 17270c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param index the start of the text to render 17280c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param count the count of chars to render 17290c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param contextIndex the start of the context for shaping. Must be 17300c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * no greater than index. 17310c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param contextCount the number of characters in the context for shaping. 17320c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * ContexIndex + contextCount must be no less than index 17330c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * + count. 1734f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param x the x position at which to draw the text 1735f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param y the y position at which to draw the text 1736051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @param isRtl whether the run is in RTL direction 1737f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param paint the paint 1738f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @hide 1739f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt */ 1740ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawTextRun(@NonNull char[] text, int index, int count, int contextIndex, 1741051910b9f998030dacb8a0722588cc715813fde1Raph Levien int contextCount, float x, float y, boolean isRtl, @NonNull Paint paint) { 1742f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1743f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text == null) { 1744f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("text is null"); 1745f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1746f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (paint == null) { 1747f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("paint is null"); 1748f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 17490c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt if ((index | count | text.length - index - count) < 0) { 1750f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new IndexOutOfBoundsException(); 1751f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1752f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 17535c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawTextRun(mNativeCanvasWrapper, text, index, count, 1754051910b9f998030dacb8a0722588cc715813fde1Raph Levien contextIndex, contextCount, x, y, isRtl, paint.mNativePaint, paint.mNativeTypeface); 1755f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1756f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1757f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1758f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * Render a run of all LTR or all RTL text, with shaping. This does not run 1759f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * bidi on the provided text, but renders it as a uniform right-to-left or 1760f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * left-to-right run, as indicated by dir. Alignment of the text is as 1761f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * determined by the Paint's TextAlign value. 17620c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * 1763f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param text the text to render 1764f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param start the start of the text to render. Data before this position 1765f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * can be used for shaping context. 1766f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param end the end of the text to render. Data at or after this 1767f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * position can be used for shaping context. 1768f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param x the x position at which to draw the text 1769f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param y the y position at which to draw the text 1770051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @param isRtl whether the run is in RTL direction 1771f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param paint the paint 1772f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @hide 1773f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt */ 1774ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawTextRun(@NonNull CharSequence text, int start, int end, int contextStart, 1775051910b9f998030dacb8a0722588cc715813fde1Raph Levien int contextEnd, float x, float y, boolean isRtl, @NonNull Paint paint) { 1776f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1777f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text == null) { 1778f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("text is null"); 1779f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1780f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (paint == null) { 1781f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("paint is null"); 1782f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1783f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if ((start | end | end - start | text.length() - end) < 0) { 1784f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new IndexOutOfBoundsException(); 1785f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1786f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1787f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text instanceof String || text instanceof SpannedString || 1788f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt text instanceof SpannableString) { 17895c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawTextRun(mNativeCanvasWrapper, text.toString(), start, end, 1790051910b9f998030dacb8a0722588cc715813fde1Raph Levien contextStart, contextEnd, x, y, isRtl, paint.mNativePaint, paint.mNativeTypeface); 1791f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else if (text instanceof GraphicsOperations) { 17920c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt ((GraphicsOperations) text).drawTextRun(this, start, end, 1793051910b9f998030dacb8a0722588cc715813fde1Raph Levien contextStart, contextEnd, x, y, isRtl, paint); 1794f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else { 17950c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int contextLen = contextEnd - contextStart; 17960c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int len = end - start; 17970c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt char[] buf = TemporaryBuffer.obtain(contextLen); 17980c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt TextUtils.getChars(text, contextStart, contextEnd, buf, 0); 17995c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawTextRun(mNativeCanvasWrapper, buf, start - contextStart, len, 1800051910b9f998030dacb8a0722588cc715813fde1Raph Levien 0, contextLen, x, y, isRtl, paint.mNativePaint, paint.mNativeTypeface); 18019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TemporaryBuffer.recycle(buf); 18029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text in the array, with each character's origin specified by 18079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the pos array. 1808051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 180962b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * This method does not support glyph composition and decomposition and 18103f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien * should therefore not be used to render complex scripts. It also doesn't 18113f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien * handle supplementary characters (eg emoji). 18129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 18149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index The index of the first character to draw 18159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of characters to draw, starting from index. 18169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pos Array of [x,y] positions, used to position each 18179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * character 18189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 18199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1820f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 1821ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPosText(@NonNull char[] text, int index, int count, @NonNull float[] pos, 1822ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 18239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (index < 0 || index + count > text.length || count*2 > pos.length) { 18249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 18259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18263f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien for (int i = 0; i < count; i++) { 18273f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien drawText(text, index + i, 1, pos[i * 2], pos[i * 2 + 1], paint); 18283f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien } 18299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text in the array, with each character's origin specified by 18339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the pos array. 1834051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 183562b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * This method does not support glyph composition and decomposition and 18363f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien * should therefore not be used to render complex scripts. It also doesn't 18373f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien * handle supplementary characters (eg emoji). 18389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 18409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pos Array of [x,y] positions, used to position each character 18419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 18429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1843f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 1844ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPosText(@NonNull String text, @NonNull float[] pos, @NonNull Paint paint) { 18453f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien drawPosText(text.toCharArray(), 0, text.length(), pos, paint); 18469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint, along 18509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified path. The paint's Align setting determins where along the 18519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * path to start the text. 18529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 18549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path the text should follow for its baseline 18559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hOffset The distance along the path to add to the text's 18569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * starting position 18579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vOffset The distance above(-) or below(+) the path to position 18589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the text 18599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 18609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1861ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawTextOnPath(@NonNull char[] text, int index, int count, @NonNull Path path, 1862ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese float hOffset, float vOffset, @NonNull Paint paint) { 18639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (index < 0 || index + count > text.length) { 18649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 18659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18665c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawTextOnPath(mNativeCanvasWrapper, text, index, count, 1867f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy path.ni(), hOffset, vOffset, 18689d2b5e1930bfc4b1da1c865843c247c708ea1565Raph Levien paint.mBidiFlags, paint.mNativePaint, paint.mNativeTypeface); 18699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint, along 18739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified path. The paint's Align setting determins where along the 18749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * path to start the text. 18759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 18779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path the text should follow for its baseline 18789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hOffset The distance along the path to add to the text's 18799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * starting position 18809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vOffset The distance above(-) or below(+) the path to position 18819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the text 18829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 18839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1884ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawTextOnPath(@NonNull String text, @NonNull Path path, float hOffset, 1885ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese float vOffset, @NonNull Paint paint) { 18869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (text.length() > 0) { 18875c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawTextOnPath(mNativeCanvasWrapper, text, path.ni(), hOffset, vOffset, 18889d2b5e1930bfc4b1da1c865843c247c708ea1565Raph Levien paint.mBidiFlags, paint.mNativePaint, paint.mNativeTypeface); 18899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Save the canvas state, draw the picture, and restore the canvas state. 18949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This differs from picture.draw(canvas), which does not perform any 18959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * save/restore. 1896cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * 1897cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * <p> 1898cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * <strong>Note:</strong> This forces the picture to internally call 1899cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * {@link Picture#endRecording} in order to prepare for playback. 1900051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 19019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param picture The picture to be drawn 19029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1903ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPicture(@NonNull Picture picture) { 19049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project picture.endRecording(); 1905667fe1039feae068d3333de8fb7115313f4a517bJonathan Dixon int restoreCount = save(); 1906667fe1039feae068d3333de8fb7115313f4a517bJonathan Dixon picture.draw(this); 1907667fe1039feae068d3333de8fb7115313f4a517bJonathan Dixon restoreToCount(restoreCount); 19089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1909051910b9f998030dacb8a0722588cc715813fde1Raph Levien 19109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the picture, stretched to fit into the dst rectangle. 19129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1913ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPicture(@NonNull Picture picture, @NonNull RectF dst) { 19149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project save(); 19159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(dst.left, dst.top); 19169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (picture.getWidth() > 0 && picture.getHeight() > 0) { 1917f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy scale(dst.width() / picture.getWidth(), dst.height() / picture.getHeight()); 19189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPicture(picture); 19209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project restore(); 19219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1922051910b9f998030dacb8a0722588cc715813fde1Raph Levien 19239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the picture, stretched to fit into the dst rectangle. 19259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1926ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPicture(@NonNull Picture picture, @NonNull Rect dst) { 19279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project save(); 19289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(dst.left, dst.top); 19299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (picture.getWidth() > 0 && picture.getHeight() > 0) { 1930f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy scale((float) dst.width() / picture.getWidth(), 1931f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy (float) dst.height() / picture.getHeight()); 19329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPicture(picture); 19349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project restore(); 19359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1936da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy 1937da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy /** 1938ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov * Releases the resources associated with this canvas. 1939ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov * 1940ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov * @hide 1941ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov */ 1942ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov public void release() { 1943ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov mFinalizer.dispose(); 1944ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov } 1945ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 1946ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov /** 1947163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * Free up as much memory as possible from private caches (e.g. fonts, images) 1948caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed * 1949163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @hide 1950caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed */ 1951caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed public static native void freeCaches(); 1952caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed 195330ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio /** 195430ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * Free up text layout caches 195530ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * 195630ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * @hide 195730ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio */ 195830ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio public static native void freeTextLayoutCaches(); 195930ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio 196036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native long initRaster(long nativeBitmapOrZero); 19615c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita private static native void native_setBitmap(long canvasHandle, 19625c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita long bitmapHandle, 19635c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita boolean copyState); 196495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native boolean native_isOpaque(long canvasHandle); 196595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native int native_getWidth(long canvasHandle); 196695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native int native_getHeight(long canvasHandle); 196795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita 196895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native int native_save(long canvasHandle, int saveFlags); 196936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native int native_saveLayer(long nativeCanvas, float l, 19709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float t, float r, float b, 197136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint, 197236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int layerFlags); 197336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native int native_saveLayerAlpha(long nativeCanvas, float l, 19749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float t, float r, float b, 19759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int alpha, int layerFlags); 197695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_restore(long canvasHandle); 197795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_restoreToCount(long canvasHandle, 197895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita int saveCount); 197995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native int native_getSaveCount(long canvasHandle); 198095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita 198195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_translate(long canvasHandle, 198295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita float dx, float dy); 198395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_scale(long canvasHandle, 198495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita float sx, float sy); 198595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_rotate(long canvasHandle, float degrees); 198695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_skew(long canvasHandle, 198795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita float sx, float sy); 198836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_concat(long nativeCanvas, 198936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix); 199036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_setMatrix(long nativeCanvas, 199136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix); 199236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_clipRect(long nativeCanvas, 19939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 19949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float right, float bottom, 19959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 199636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_clipPath(long nativeCanvas, 199736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePath, 19989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 199936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_clipRegion(long nativeCanvas, 200036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeRegion, 20019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 200236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeSetDrawFilter(long nativeCanvas, 200336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeFilter); 200436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_getClipBounds(long nativeCanvas, 20059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect bounds); 200636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_getCTM(long nativeCanvas, 200736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix); 200836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_quickReject(long nativeCanvas, 200936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePath); 201036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_quickReject(long nativeCanvas, 20119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 2012ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger float right, float bottom); 201336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawColor(long nativeCanvas, int color, 20149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mode); 201536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawPaint(long nativeCanvas, 201636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 201795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_drawPoint(long canvasHandle, float x, float y, 201895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita long paintHandle); 201995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_drawPoints(long canvasHandle, float[] pts, 202095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita int offset, int count, 202195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita long paintHandle); 202236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawLine(long nativeCanvas, float startX, 20239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float startY, float stopX, 202436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float stopY, long nativePaint); 202595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_drawLines(long canvasHandle, float[] pts, 202695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita int offset, int count, 202795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita long paintHandle); 202836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawRect(long nativeCanvas, float left, 20299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float top, float right, 203036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float bottom, 203136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 203224609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese private static native void native_drawOval(long nativeCanvas, float left, float top, 203324609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese float right, float bottom, long nativePaint); 203436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawCircle(long nativeCanvas, float cx, 20359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float cy, float radius, 203636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 203724609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese private static native void native_drawArc(long nativeCanvas, float left, float top, 203824609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese float right, float bottom, 203924609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese float startAngle, float sweep, boolean useCenter, 204036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 204136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawRoundRect(long nativeCanvas, 20424d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik float left, float top, float right, float bottom, 20434d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik float rx, float ry, long nativePaint); 204436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawPath(long nativeCanvas, 204536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePath, 204636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 204736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private native void native_drawBitmap(long nativeCanvas, long nativeBitmap, 20489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 204936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaintOrZero, 20500d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int canvasDensity, 20510d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int screenDensity, 20520d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int bitmapDensity); 205336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private native void native_drawBitmap(long nativeCanvas, long nativeBitmap, 20548872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger float srcLeft, float srcTop, float srcRight, float srcBottom, 20558872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger float dstLeft, float dstTop, float dstRight, float dstBottom, 20568872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger long nativePaintOrZero, int screenDensity, int bitmapDensity); 205736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawBitmap(long nativeCanvas, int[] colors, 20589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offset, int stride, float x, 20599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float y, int width, int height, 20609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean hasAlpha, 206136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaintOrZero); 206236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeDrawBitmapMatrix(long nativeCanvas, 206336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeBitmap, 206436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix, 206536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 206636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeDrawBitmapMesh(long nativeCanvas, 206736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeBitmap, 20689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int meshWidth, int meshHeight, 20699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] verts, int vertOffset, 207036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int[] colors, int colorOffset, 207136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 207236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeDrawVertices(long nativeCanvas, int mode, int n, 20739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] verts, int vertOffset, float[] texs, int texOffset, 20749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] colors, int colorOffset, short[] indices, 207536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int indexOffset, int indexCount, long nativePaint); 207636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat 207736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawText(long nativeCanvas, char[] text, 20789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int index, int count, float x, 207936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float y, int flags, long nativePaint, 208036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeTypeface); 208136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawText(long nativeCanvas, String text, 20829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int start, int end, float x, 208336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float y, int flags, long nativePaint, 208436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeTypeface); 2085fcf2be1846935e7983ea2fe87fdd4d7af27764b6Fabrice Di Meglio 208636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextRun(long nativeCanvas, String text, 20870c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int start, int end, int contextStart, int contextEnd, 2088051910b9f998030dacb8a0722588cc715813fde1Raph Levien float x, float y, boolean isRtl, long nativePaint, long nativeTypeface); 2089f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 209036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextRun(long nativeCanvas, char[] text, 20910c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int start, int count, int contextStart, int contextCount, 2092051910b9f998030dacb8a0722588cc715813fde1Raph Levien float x, float y, boolean isRtl, long nativePaint, long nativeTypeface); 2093f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 209436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextOnPath(long nativeCanvas, 20959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char[] text, int index, 209636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int count, long nativePath, 20979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float hOffset, 2098da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio float vOffset, int bidiFlags, 20999d2b5e1930bfc4b1da1c865843c247c708ea1565Raph Levien long nativePaint, long nativeTypeface); 210036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextOnPath(long nativeCanvas, 210136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat String text, long nativePath, 210236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float hOffset, 210336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float vOffset, 21049d2b5e1930bfc4b1da1c865843c247c708ea1565Raph Levien int flags, long nativePaint, long nativeTypeface); 210536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void finalizer(long nativeCanvas); 21069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 2107