Canvas.java revision 96890564bdbd2f2a41dfc323fc8b3938fb335639
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 /** 253797b95b26bbb7557678af78b9a2a61830158920fChris Craik * @hide 254797b95b26bbb7557678af78b9a2a61830158920fChris Craik */ 255797b95b26bbb7557678af78b9a2a61830158920fChris Craik public void initializeLight(float lightX, float lightY, float lightZ, float lightRadius) {} 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the device that the current layer draws into is opaque 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (i.e. does not support per-pixel alpha). 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the device that the current layer draws into is opaque 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 26395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public boolean isOpaque() { 26495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_isOpaque(mNativeCanvasWrapper); 26595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the width of the current drawing layer 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the width of the current drawing layer 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 27295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int getWidth() { 27395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_getWidth(mNativeCanvasWrapper); 27495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the height of the current drawing layer 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the height of the current drawing layer 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 28195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int getHeight() { 28295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_getHeight(mNativeCanvasWrapper); 28395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 28696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>Returns the target density of the canvas. The default density is 28796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * derived from the density of its backing bitmap, or 28896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * {@link Bitmap#DENSITY_NONE} if there is not one.</p> 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 29096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @return Returns the current target density of the canvas, which is used 29196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * to determine the scaling factor when drawing a bitmap into it. 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 29311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #setDensity(int) 294051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @see Bitmap#getDensity() 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 29611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getDensity() { 29711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return mDensity; 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 30196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>Specifies the density for this Canvas' backing bitmap. This modifies 30296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * the target density of the canvas itself, as well as the density of its 30396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * backing bitmap via {@link Bitmap#setDensity(int) Bitmap.setDensity(int)}. 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 30596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @param density The new target density of the canvas, which is used 30696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * to determine the scaling factor when drawing a bitmap into it. Use 30796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * {@link Bitmap#DENSITY_NONE} to disable bitmap scaling. 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 30911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #getDensity() 310051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @see Bitmap#setDensity(int) 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 31211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public void setDensity(int density) { 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mBitmap != null) { 31411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn mBitmap.setDensity(density); 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 31611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn mDensity = density; 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3190d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn /** @hide */ 3200d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn public void setScreenDensity(int density) { 3210d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn mScreenDensity = density; 3220d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn } 323f61970fc79e9c5cf340fa942597628242361864aRomain Guy 324f61970fc79e9c5cf340fa942597628242361864aRomain Guy /** 325f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Returns the maximum allowed width for bitmaps drawn with this canvas. 326f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Attempting to draw with a bitmap wider than this value will result 327f61970fc79e9c5cf340fa942597628242361864aRomain Guy * in an error. 328051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 329051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @see #getMaximumBitmapHeight() 330f61970fc79e9c5cf340fa942597628242361864aRomain Guy */ 331f61970fc79e9c5cf340fa942597628242361864aRomain Guy public int getMaximumBitmapWidth() { 332f61970fc79e9c5cf340fa942597628242361864aRomain Guy return MAXMIMUM_BITMAP_SIZE; 333f61970fc79e9c5cf340fa942597628242361864aRomain Guy } 334051910b9f998030dacb8a0722588cc715813fde1Raph Levien 335f61970fc79e9c5cf340fa942597628242361864aRomain Guy /** 336f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Returns the maximum allowed height for bitmaps drawn with this canvas. 337f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Attempting to draw with a bitmap taller than this value will result 338f61970fc79e9c5cf340fa942597628242361864aRomain Guy * in an error. 339051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 340051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @see #getMaximumBitmapWidth() 341f61970fc79e9c5cf340fa942597628242361864aRomain Guy */ 342f61970fc79e9c5cf340fa942597628242361864aRomain Guy public int getMaximumBitmapHeight() { 343f61970fc79e9c5cf340fa942597628242361864aRomain Guy return MAXMIMUM_BITMAP_SIZE; 344f61970fc79e9c5cf340fa942597628242361864aRomain Guy } 345f61970fc79e9c5cf340fa942597628242361864aRomain Guy 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // the SAVE_FLAG constants must match their native equivalents 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 348ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese /** @hide */ 349ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @IntDef(flag = true, 350ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese value = { 351ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese MATRIX_SAVE_FLAG, 352ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese CLIP_SAVE_FLAG, 353ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese HAS_ALPHA_LAYER_SAVE_FLAG, 354ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese FULL_COLOR_LAYER_SAVE_FLAG, 355ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese CLIP_TO_LAYER_SAVE_FLAG, 356ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese ALL_SAVE_FLAG 357ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese }) 358ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Retention(RetentionPolicy.SOURCE) 359ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public @interface Saveflags {} 360ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** restore the current matrix when restore() is called */ 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MATRIX_SAVE_FLAG = 0x01; 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** restore the current clip when restore() is called */ 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CLIP_SAVE_FLAG = 0x02; 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** the layer needs to per-pixel alpha */ 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int HAS_ALPHA_LAYER_SAVE_FLAG = 0x04; 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** the layer needs to 8-bits per color component */ 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FULL_COLOR_LAYER_SAVE_FLAG = 0x08; 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** clip against the layer's bounds */ 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CLIP_TO_LAYER_SAVE_FLAG = 0x10; 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** restore everything when restore() is called */ 372051910b9f998030dacb8a0722588cc715813fde1Raph Levien public static final int ALL_SAVE_FLAG = 0x1F; 373051910b9f998030dacb8a0722588cc715813fde1Raph Levien 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Saves the current matrix and clip onto a private stack. Subsequent 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calls to translate,scale,rotate,skew,concat or clipRect,clipPath 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will all operate as usual, but when the balancing call to restore() 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is made, those calls will be forgotten, and the settings that existed 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * before the save() will be reinstated. 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The value to pass to restoreToCount() to balance this save() 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 38395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int save() { 38495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_save(mNativeCanvasWrapper, MATRIX_SAVE_FLAG | CLIP_SAVE_FLAG); 38595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 386051910b9f998030dacb8a0722588cc715813fde1Raph Levien 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Based on saveFlags, can save the current matrix and clip onto a private 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * stack. Subsequent calls to translate,scale,rotate,skew,concat or 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect,clipPath will all operate as usual, but when the balancing 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * call to restore() is made, those calls will be forgotten, and the 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * settings that existed before the save() will be reinstated. 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveFlags flag bits that specify which parts of the Canvas state 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to save/restore 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The value to pass to restoreToCount() to balance this save() 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 398ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int save(@Saveflags int saveFlags) { 39995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_save(mNativeCanvasWrapper, saveFlags); 40095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This behaves the same as save(), but in addition it allocates an 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * offscreen bitmap. All drawing calls are directed there, and only when 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the balancing call to restore() is made is that offscreen transfered to 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the canvas (or the previous layer). Subsequent calls to translate, 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * scale, rotate, skew, concat or clipRect, clipPath all operate on this 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * copy. When the balancing call to restore() is made, this copy is 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * deleted and the previous matrix/clip state is restored. 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds May be null. The maximum size the offscreen bitmap 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * needs to be (in local coordinates) 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint This is copied, and is applied to the offscreen when 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * restore() is called. 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveFlags see _SAVE_FLAG constants 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return value to pass to restoreToCount() to balance this save() 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 418ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int saveLayer(@Nullable RectF bounds, @Nullable Paint paint, @Saveflags int saveFlags) { 41995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_saveLayer(mNativeCanvasWrapper, 42095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita bounds.left, bounds.top, bounds.right, bounds.bottom, 421f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint != null ? paint.mNativePaint : 0, 422f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy saveFlags); 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 424c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 425c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 426c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Convenience for saveLayer(bounds, paint, {@link #ALL_SAVE_FLAG}) 427c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 428ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int saveLayer(@Nullable RectF bounds, @Nullable Paint paint) { 429c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayer(bounds, paint, ALL_SAVE_FLAG); 430c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 431c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper version of saveLayer() that takes 4 values rather than a RectF. 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 435ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int saveLayer(float left, float top, float right, float bottom, @Nullable Paint paint, 436ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Saveflags int saveFlags) { 4375c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_saveLayer(mNativeCanvasWrapper, left, top, right, bottom, 438f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint != null ? paint.mNativePaint : 0, 439f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy saveFlags); 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 443c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Convenience for saveLayer(left, top, right, bottom, paint, {@link #ALL_SAVE_FLAG}) 444c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 445ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int saveLayer(float left, float top, float right, float bottom, @Nullable Paint paint) { 446c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayer(left, top, right, bottom, paint, ALL_SAVE_FLAG); 447c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 448c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 449c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This behaves the same as save(), but in addition it allocates an 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * offscreen bitmap. All drawing calls are directed there, and only when 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the balancing call to restore() is made is that offscreen transfered to 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the canvas (or the previous layer). Subsequent calls to translate, 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * scale, rotate, skew, concat or clipRect, clipPath all operate on this 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * copy. When the balancing call to restore() is made, this copy is 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * deleted and the previous matrix/clip state is restored. 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds The maximum size the offscreen bitmap needs to be 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (in local coordinates) 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param alpha The alpha to apply to the offscreen when when it is 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawn during restore() 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveFlags see _SAVE_FLAG constants 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return value to pass to restoreToCount() to balance this call 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 465ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int saveLayerAlpha(@NonNull RectF bounds, int alpha, @Saveflags int saveFlags) { 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project alpha = Math.min(255, Math.max(0, alpha)); 46795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_saveLayerAlpha(mNativeCanvasWrapper, 46895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita bounds.left, bounds.top, bounds.right, bounds.bottom, 46995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita alpha, saveFlags); 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 471c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 472c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 473c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Convenience for saveLayerAlpha(bounds, alpha, {@link #ALL_SAVE_FLAG}) 474c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 475ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int saveLayerAlpha(@NonNull RectF bounds, int alpha) { 476c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayerAlpha(bounds, alpha, ALL_SAVE_FLAG); 477c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 478c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for saveLayerAlpha() that takes 4 values instead of a RectF. 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 482f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public int saveLayerAlpha(float left, float top, float right, float bottom, int alpha, 483ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Saveflags int saveFlags) { 4845c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_saveLayerAlpha(mNativeCanvasWrapper, left, top, right, bottom, 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project alpha, saveFlags); 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 489c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Helper for saveLayerAlpha(left, top, right, bottom, alpha, {@link #ALL_SAVE_FLAG}) 490c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 491c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik public int saveLayerAlpha(float left, float top, float right, float bottom, int alpha) { 492c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayerAlpha(left, top, right, bottom, alpha, ALL_SAVE_FLAG); 493c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 494c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 495c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This call balances a previous call to save(), and is used to remove all 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * modifications to the matrix/clip state since the last save call. It is 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an error to call restore() more times than save() was called. 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 50095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void restore() { 50195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_restore(mNativeCanvasWrapper); 50295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the number of matrix/clip states on the Canvas' private stack. 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This will equal # save() calls - # restore() calls. 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 50895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int getSaveCount() { 50995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_getSaveCount(mNativeCanvasWrapper); 51095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Efficient way to pop any calls to save() that happened after the save 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * count reached saveCount. It is an error for saveCount to be less than 1. 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Example: 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * int count = canvas.save(); 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ... // more calls potentially to save() 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * canvas.restoreToCount(count); 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * // now the canvas is back in the same state it was before the initial 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * // call to save(). 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveCount The save level to restore to. 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 52595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void restoreToCount(int saveCount) { 52695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_restoreToCount(mNativeCanvasWrapper, saveCount); 52795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified translation 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dx The distance to translate in X 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dy The distance to translate in Y 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 53595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void translate(float dx, float dy) { 53695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_translate(mNativeCanvasWrapper, dx, dy); 53795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified scale. 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to scale in X 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to scale in Y 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 54595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void scale(float sx, float sy) { 54695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_scale(mNativeCanvasWrapper, sx, sy); 54795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified scale. 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to scale in X 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to scale in Y 554cc3ec6cdb2b892eb29513e72d8b205acbe997b25Gilles Debunne * @param px The x-coord for the pivot point (unchanged by the scale) 555cc3ec6cdb2b892eb29513e72d8b205acbe997b25Gilles Debunne * @param py The y-coord for the pivot point (unchanged by the scale) 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void scale(float sx, float sy, float px, float py) { 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(px, py); 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project scale(sx, sy); 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(-px, -py); 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified rotation. 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param degrees The amount to rotate, in degrees 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 56895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void rotate(float degrees) { 56995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_rotate(mNativeCanvasWrapper, degrees); 57095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified rotation. 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param degrees The amount to rotate, in degrees 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param px The x-coord for the pivot point (unchanged by the rotation) 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param py The y-coord for the pivot point (unchanged by the rotation) 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void rotate(float degrees, float px, float py) { 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(px, py); 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project rotate(degrees); 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(-px, -py); 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified skew. 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to skew in X 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to skew in Y 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 59195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void skew(float sx, float sy) { 59295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_skew(mNativeCanvasWrapper, sx, sy); 59395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5964e7b772b733593fbe25c733e95b8dcea293234b6Romain Guy * Preconcat the current matrix with the specified matrix. If the specified 5974e7b772b733593fbe25c733e95b8dcea293234b6Romain Guy * matrix is null, this method does nothing. 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix to preconcatenate with the current matrix 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 601ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void concat(@Nullable Matrix matrix) { 6025c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita if (matrix != null) native_concat(mNativeCanvasWrapper, matrix.native_instance); 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 604051910b9f998030dacb8a0722588cc715813fde1Raph Levien 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Completely replace the current matrix with the specified matrix. If the 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * matrix parameter is null, then the current matrix is reset to identity. 608051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 609f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * <strong>Note:</strong> it is recommended to use {@link #concat(Matrix)}, 610f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * {@link #scale(float, float)}, {@link #translate(float, float)} and 611f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * {@link #rotate(float)} instead of this method. 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix to replace the current matrix with. If it is 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * null, set the current matrix to identity. 615051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 616051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @see #concat(Matrix) 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 618ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void setMatrix(@Nullable Matrix matrix) { 6195c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_setMatrix(mNativeCanvasWrapper, 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project matrix == null ? 0 : matrix.native_instance); 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 622051910b9f998030dacb8a0722588cc715813fde1Raph Levien 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return, in ctm, the current transformation matrix. This does not alter 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the matrix in the canvas, but just returns a copy of it. 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 627f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 628ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void getMatrix(@NonNull Matrix ctm) { 6295c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_getCTM(mNativeCanvasWrapper, ctm.native_instance); 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 63141030da16856c8869e1e51d4a0405432fa96614eRomain Guy 63241030da16856c8869e1e51d4a0405432fa96614eRomain Guy /** 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a new matrix with a copy of the canvas' current transformation 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * matrix. 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 63665447287cb4112cf74483c87be70bcd00b622e2dRomain Guy @Deprecated 637ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public final @NonNull Matrix getMatrix() { 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Matrix m = new Matrix(); 639f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy //noinspection deprecation 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getMatrix(m); 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return m; 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 643051910b9f998030dacb8a0722588cc715813fde1Raph Levien 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle. 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rect to intersect with the current clip 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 651ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRect(@NonNull RectF rect, @NonNull Region.Op op) { 6525c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom, 653f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy op.nativeInt); 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle, which is 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 664ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRect(@NonNull Rect rect, @NonNull Region.Op op) { 6655c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom, 666f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy op.nativeInt); 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 676ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRect(@NonNull RectF rect) { 67795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_clipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom, 67895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita Region.Op.INTERSECT.nativeInt); 67995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 68095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 688ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRect(@NonNull Rect rect) { 68995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_clipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom, 69095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita Region.Op.INTERSECT.nativeInt); 69195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 692051910b9f998030dacb8a0722588cc715813fde1Raph Levien 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle, which is 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 708ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRect(float left, float top, float right, float bottom, 709ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Region.Op op) { 7105c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipRect(mNativeCanvasWrapper, left, top, right, bottom, op.nativeInt); 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current clip 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 72695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public boolean clipRect(float left, float top, float right, float bottom) { 72795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_clipRect(mNativeCanvasWrapper, left, top, right, bottom, 72895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita Region.Op.INTERSECT.nativeInt); 72995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 730f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current clip 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 74495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public boolean clipRect(int left, int top, int right, int bottom) { 74595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_clipRect(mNativeCanvasWrapper, left, top, right, bottom, 74695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita Region.Op.INTERSECT.nativeInt); 74795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 748f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified path. 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to operate on the current clip 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 756ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipPath(@NonNull Path path, @NonNull Region.Op op) { 7575c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipPath(mNativeCanvasWrapper, path.ni(), op.nativeInt); 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 759051910b9f998030dacb8a0722588cc715813fde1Raph Levien 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified path. 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to intersect with the current clip 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 766ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipPath(@NonNull Path path) { 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return clipPath(path, Region.Op.INTERSECT); 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 769051910b9f998030dacb8a0722588cc715813fde1Raph Levien 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified region. Note that unlike 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect() and clipPath() which transform their arguments by the 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, clipRegion() assumes its argument is already in the 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinate system of the current layer's bitmap, and so not 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * transformation is performed. 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param region The region to operate on the current clip, based on op 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 7800d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * 7810d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * @deprecated Unlike all other clip calls this API does not respect the 7820d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * current matrix. Use {@link #clipRect(Rect)} as an alternative. 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 784ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRegion(@NonNull Region region, @NonNull Region.Op op) { 7855c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipRegion(mNativeCanvasWrapper, region.ni(), op.nativeInt); 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified region. Note that unlike 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect() and clipPath() which transform their arguments by the 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, clipRegion() assumes its argument is already in the 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinate system of the current layer's bitmap, and so not 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * transformation is performed. 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param region The region to operate on the current clip, based on op 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 7970d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * 7980d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * @deprecated Unlike all other clip calls this API does not respect the 7990d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * current matrix. Use {@link #clipRect(Rect)} as an alternative. 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 801ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRegion(@NonNull Region region) { 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return clipRegion(region, Region.Op.INTERSECT); 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 804051910b9f998030dacb8a0722588cc715813fde1Raph Levien 805ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public @Nullable DrawFilter getDrawFilter() { 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mDrawFilter; 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 808051910b9f998030dacb8a0722588cc715813fde1Raph Levien 809ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void setDrawFilter(@Nullable DrawFilter filter) { 81036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeFilter = 0; 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (filter != null) { 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeFilter = filter.mNativeInt; 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDrawFilter = filter; 8155c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita nativeSetDrawFilter(mNativeCanvasWrapper, nativeFilter); 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum EdgeType { 819d320001807168f5565bab9807ef13c111096bbb3Chet Haase 820d320001807168f5565bab9807ef13c111096bbb3Chet Haase /** 821d320001807168f5565bab9807ef13c111096bbb3Chet Haase * Black-and-White: Treat edges by just rounding to nearest pixel boundary 822d320001807168f5565bab9807ef13c111096bbb3Chet Haase */ 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project BW(0), //!< treat edges by just rounding to nearest pixel boundary 824d320001807168f5565bab9807ef13c111096bbb3Chet Haase 825d320001807168f5565bab9807ef13c111096bbb3Chet Haase /** 826d320001807168f5565bab9807ef13c111096bbb3Chet Haase * Antialiased: Treat edges by rounding-out, since they may be antialiased 827d320001807168f5565bab9807ef13c111096bbb3Chet Haase */ 828d320001807168f5565bab9807ef13c111096bbb3Chet Haase AA(1); 829051910b9f998030dacb8a0722588cc715813fde1Raph Levien 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EdgeType(int nativeInt) { 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = nativeInt; 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 833c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy 834c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy /** 835c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy * @hide 836c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy */ 837c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy public final int nativeInt; 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified rectangle, after being transformed by the 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect the rect to compare with the current clip 847d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 848d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 849d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the rect (transformed by the canvas' matrix) 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 853ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean quickReject(@NonNull RectF rect, @NonNull EdgeType type) { 85495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_quickReject(mNativeCanvasWrapper, 85595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita rect.left, rect.top, rect.right, rect.bottom); 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified path, after being transformed by the 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). Note: for speed it may 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * return false even if the path itself might not intersect the clip 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (i.e. the bounds of the path intersects, but the path does not). 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to compare with the current clip 867d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 868d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 869d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the path (transformed by the canvas' matrix) 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 873ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean quickReject(@NonNull Path path, @NonNull EdgeType type) { 8745c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_quickReject(mNativeCanvasWrapper, path.ni()); 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified rectangle, after being transformed by the 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to compare with the 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to compare with the current 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to compare with the 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to compare with the 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 891d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 892d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 893d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the rect (transformed by the canvas' matrix) 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 897ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger public boolean quickReject(float left, float top, float right, float bottom, 898ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull EdgeType type) { 8995c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_quickReject(mNativeCanvasWrapper, left, top, right, bottom); 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 903708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * Return the bounds of the current clip (in local coordinates) in the 904708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * bounds parameter, and return true if it is non-empty. This can be useful 905708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * in a way similar to quickReject, in that it tells you that drawing 906708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * outside of these bounds will be clipped out. 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds Return the clip bounds here. If it is null, ignore it but 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * still return true if the current clip is non-empty. 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the current clip is non-empty. 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 912ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean getClipBounds(@Nullable Rect bounds) { 9135c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_getClipBounds(mNativeCanvasWrapper, bounds); 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 915051910b9f998030dacb8a0722588cc715813fde1Raph Levien 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 917708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * Retrieve the bounds of the current clip (in local coordinates). 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the clip bounds, or [0, 0, 0, 0] if the clip is empty. 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 921ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public final @NonNull Rect getClipBounds() { 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect r = new Rect(); 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getClipBounds(r); 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return r; 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 926051910b9f998030dacb8a0722588cc715813fde1Raph Levien 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified RGB color, using srcover porterduff mode. 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r red component (0..255) of the color to draw onto the canvas 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param g green component (0..255) of the color to draw onto the canvas 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param b blue component (0..255) of the color to draw onto the canvas 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRGB(int r, int g, int b) { 9368872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger drawColor(Color.rgb(r, g, b)); 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified ARGB color, using srcover porterduff mode. 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param a alpha component (0..255) of the color to draw onto the canvas 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r red component (0..255) of the color to draw onto the canvas 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param g green component (0..255) of the color to draw onto the canvas 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param b blue component (0..255) of the color to draw onto the canvas 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawARGB(int a, int r, int g, int b) { 9498872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger drawColor(Color.argb(a, r, g, b)); 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified color, using srcover porterduff mode. 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param color the color to draw onto the canvas 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawColor(int color) { 9598872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger native_drawColor(mNativeCanvasWrapper, color, PorterDuff.Mode.SRC_OVER.nativeInt); 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified color and porter-duff xfermode. 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param color the color to draw with 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode the porter-duff mode to apply to the color 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 969ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawColor(int color, @NonNull PorterDuff.Mode mode) { 9705c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawColor(mNativeCanvasWrapper, color, mode.nativeInt); 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified paint. This is equivalent (but faster) to drawing an 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * infinitely large rectangle with the specified paint. 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw onto the canvas 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 980ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPaint(@NonNull Paint paint) { 9815c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawPaint(mNativeCanvasWrapper, paint.mNativePaint); 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 983051910b9f998030dacb8a0722588cc715813fde1Raph Levien 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a series of points. Each point is centered at the coordinate 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified by pts[], and its diameter is specified by the paint's stroke 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * width (as transformed by the canvas' CTM), with special treatment for 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a stroke width of 0, which always draws exactly 1 pixel (or at most 4 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if antialiasing is enabled). The shape of the point is controlled by 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the paint's Cap type. The shape is a square, unless the cap type is 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Round, in which case the shape is a circle. 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pts Array of points to draw [x0 y0 x1 y1 x2 y2 ...] 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Number of values to skip before starting to draw. 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of values to process, after skipping offset 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of them. Since one point uses two values, the number of 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * "points" that are drawn is really (count >> 1). 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the points 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1000ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPoints(float[] pts, int offset, int count, @NonNull Paint paint) { 100195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_drawPoints(mNativeCanvasWrapper, pts, offset, count, paint.mNativePaint); 100295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for drawPoints() that assumes you want to draw the entire array 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1007ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPoints(@NonNull float[] pts, @NonNull Paint paint) { 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPoints(pts, 0, pts.length, paint); 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for drawPoints() for drawing a single point. 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1014ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPoint(float x, float y, @NonNull Paint paint) { 101595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_drawPoint(mNativeCanvasWrapper, x, y, paint.mNativePaint); 101695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a line segment with the specified start and stop x,y coordinates, 1020a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * using the specified paint. 1021a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * 1022a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * <p>Note that since a line is always "framed", the Style is ignored in the paint.</p> 1023a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * 1024a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * <p>Degenerate lines (length is 0) will not be drawn.</p> 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startX The x-coordinate of the start point of the line 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startY The y-coordinate of the start point of the line 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the line 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1030ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawLine(float startX, float startY, float stopX, float stopY, 1031ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 10325c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawLine(mNativeCanvasWrapper, startX, startY, stopX, stopY, paint.mNativePaint); 10339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a series of lines. Each line is taken from 4 consecutive values 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the pts array. Thus to draw 1 line, the array must contain at least 4 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * values. This is logically the same as drawing the array as follows: 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawLine(pts[0], pts[1], pts[2], pts[3]) followed by 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawLine(pts[4], pts[5], pts[6], pts[7]) and so on. 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pts Array of points to draw [x0 y0 x1 y1 x2 y2 ...] 10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Number of values in the array to skip before drawing. 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of values in the array to process, after 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * skipping "offset" of them. Since each line uses 4 values, 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the number of "lines" that are drawn is really 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (count >> 2). 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the points 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 105095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void drawLines(float[] pts, int offset, int count, Paint paint) { 105195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_drawLines(mNativeCanvasWrapper, pts, offset, count, paint.mNativePaint); 105295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1054ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawLines(@NonNull float[] pts, @NonNull Paint paint) { 10559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawLines(pts, 0, pts.length, paint); 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified paint. The rectangle will 10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be filled or framed based on the Style in the paint. 10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rect to be drawn 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rect 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1065ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawRect(@NonNull RectF rect, @NonNull Paint paint) { 106695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_drawRect(mNativeCanvasWrapper, 106795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita rect.left, rect.top, rect.right, rect.bottom, paint.mNativePaint); 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified Paint. The rectangle 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be filled or framed based on the Style in the paint. 10739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r The rectangle to be drawn. 10759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rectangle 10769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1077ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawRect(@NonNull Rect r, @NonNull Paint paint) { 10789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawRect(r.left, r.top, r.right, r.bottom, paint); 10799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1080051910b9f998030dacb8a0722588cc715813fde1Raph Levien 10819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified paint. The rectangle will 10849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be filled or framed based on the Style in the paint. 10859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to be drawn 10879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top side of the rectangle to be drawn 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to be drawn 10899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom side of the rectangle to be drawn 10909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rect 10919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1092ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawRect(float left, float top, float right, float bottom, @NonNull Paint paint) { 10935c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawRect(mNativeCanvasWrapper, left, top, right, bottom, paint.mNativePaint); 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified oval using the specified paint. The oval will be 10989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * filled or framed based on the Style in the paint. 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param oval The rectangle bounds of the oval to be drawn 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1102ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawOval(@NonNull RectF oval, @NonNull Paint paint) { 11039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (oval == null) { 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 11059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 110624609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese drawOval(oval.left, oval.top, oval.right, oval.bottom, paint); 110724609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese } 110824609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese 110924609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese /** 111024609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * Draw the specified oval using the specified paint. The oval will be 111124609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * filled or framed based on the Style in the paint. 111224609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese */ 111324609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese public void drawOval(float left, float top, float right, float bottom, @NonNull Paint paint) { 111424609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese native_drawOval(mNativeCanvasWrapper, left, top, right, bottom, paint.mNativePaint); 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified circle using the specified paint. If radius is <= 0, 11199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then nothing will be drawn. The circle will be filled or framed based 11209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on the Style in the paint. 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cx The x-coordinate of the center of the cirle to be drawn 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cy The y-coordinate of the center of the cirle to be drawn 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param radius The radius of the cirle to be drawn 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the circle 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1127ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawCircle(float cx, float cy, float radius, @NonNull Paint paint) { 11285c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawCircle(mNativeCanvasWrapper, cx, cy, radius, paint.mNativePaint); 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11324a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>Draw the specified arc, which will be scaled to fit inside the 11334a317db43d2bbc992284dd1f651751f13734d017Romain Guy * specified oval.</p> 1134051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 11354a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>If the start angle is negative or >= 360, the start angle is treated 11364a317db43d2bbc992284dd1f651751f13734d017Romain Guy * as start angle modulo 360.</p> 1137051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 11384a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>If the sweep angle is >= 360, then the oval is drawn 11399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completely. Note that this differs slightly from SkPath::arcTo, which 11404a317db43d2bbc992284dd1f651751f13734d017Romain Guy * treats the sweep angle modulo 360. If the sweep angle is negative, 11414a317db43d2bbc992284dd1f651751f13734d017Romain Guy * the sweep angle is treated as sweep angle modulo 360</p> 1142051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 11434a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>The arc is drawn clockwise. An angle of 0 degrees correspond to the 11444a317db43d2bbc992284dd1f651751f13734d017Romain Guy * geometric angle of 0 degrees (3 o'clock on a watch.)</p> 11459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param oval The bounds of oval used to define the shape and size 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the arc 11489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startAngle Starting angle (in degrees) where the arc begins 11499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sweepAngle Sweep angle (in degrees) measured clockwise 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param useCenter If true, include the center of the oval in the arc, and 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project close it if it is being stroked. This will draw a wedge 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the arc 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1154ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawArc(@NonNull RectF oval, float startAngle, float sweepAngle, boolean useCenter, 1155ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 115624609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese drawArc(oval.left, oval.top, oval.right, oval.bottom, startAngle, sweepAngle, useCenter, 115724609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese paint); 115824609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese } 115924609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese 116024609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese /** 116124609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * <p>Draw the specified arc, which will be scaled to fit inside the 116224609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * specified oval.</p> 116324609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * 116424609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * <p>If the start angle is negative or >= 360, the start angle is treated 116524609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * as start angle modulo 360.</p> 116624609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * 116724609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * <p>If the sweep angle is >= 360, then the oval is drawn 116824609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * completely. Note that this differs slightly from SkPath::arcTo, which 116924609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * treats the sweep angle modulo 360. If the sweep angle is negative, 117024609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * the sweep angle is treated as sweep angle modulo 360</p> 117124609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * 117224609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * <p>The arc is drawn clockwise. An angle of 0 degrees correspond to the 117324609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * geometric angle of 0 degrees (3 o'clock on a watch.)</p> 117424609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * 117524609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * @param startAngle Starting angle (in degrees) where the arc begins 117624609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * @param sweepAngle Sweep angle (in degrees) measured clockwise 117724609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * @param useCenter If true, include the center of the oval in the arc, and 117824609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese close it if it is being stroked. This will draw a wedge 117924609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * @param paint The paint used to draw the arc 118024609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese */ 118124609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese public void drawArc(float left, float top, float right, float bottom, float startAngle, 118224609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese float sweepAngle, boolean useCenter, @NonNull Paint paint) { 118324609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese native_drawArc(mNativeCanvasWrapper, left, top, right, bottom, startAngle, sweepAngle, 1184f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy useCenter, paint.mNativePaint); 11859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified round-rect using the specified paint. The roundrect 11899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be filled or framed based on the Style in the paint. 11909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangular bounds of the roundRect to be drawn 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rx The x-radius of the oval used to round the corners 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param ry The y-radius of the oval used to round the corners 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the roundRect 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1196ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawRoundRect(@NonNull RectF rect, float rx, float ry, @NonNull Paint paint) { 11974d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik drawRoundRect(rect.left, rect.top, rect.right, rect.bottom, rx, ry, paint); 11984d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik } 11994d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik 12004d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik /** 12014d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * Draw the specified round-rect using the specified paint. The roundrect 12024d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * will be filled or framed based on the Style in the paint. 12034d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * 12044d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * @param rx The x-radius of the oval used to round the corners 12054d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * @param ry The y-radius of the oval used to round the corners 12064d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * @param paint The paint used to draw the roundRect 12074d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik */ 12084d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik public void drawRoundRect(float left, float top, float right, float bottom, float rx, float ry, 1209ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 12105c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawRoundRect(mNativeCanvasWrapper, left, top, right, bottom, rx, ry, paint.mNativePaint); 12119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified path using the specified paint. The path will be 12159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * filled or framed based on the Style in the paint. 12169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to be drawn 12189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the path 12199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1220ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPath(@NonNull Path path, @NonNull Paint paint) { 12215c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawPath(mNativeCanvasWrapper, path.ni(), paint.mNativePaint); 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12231abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik 12241abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik /** 12251abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * @hide 12261abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik */ 12271abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik protected static void throwIfCannotDraw(Bitmap bitmap) { 12289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bitmap.isRecycled()) { 1229f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy throw new RuntimeException("Canvas: trying to use a recycled bitmap " + bitmap); 12309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12311abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik if (!bitmap.isPremultiplied() && bitmap.getConfig() == Bitmap.Config.ARGB_8888 && 12321abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik bitmap.hasAlpha()) { 12331abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throw new RuntimeException("Canvas: trying to use a non-premultiplied bitmap " 12341abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik + bitmap); 12351abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik } 12369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1239deba785f122a47915756ffd991f5540d952cf937Romain Guy * Draws the specified bitmap as an N-patch (most often, a 9-patches.) 1240deba785f122a47915756ffd991f5540d952cf937Romain Guy * 12413b748a44c6bd2ea05fe16839caf73dbe50bd7ae9Romain Guy * @param patch The ninepatch object to render 1242deba785f122a47915756ffd991f5540d952cf937Romain Guy * @param dst The destination rectangle. 1243deba785f122a47915756ffd991f5540d952cf937Romain Guy * @param paint The paint to draw the bitmap with. may be null 1244051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 1245deba785f122a47915756ffd991f5540d952cf937Romain Guy * @hide 1246deba785f122a47915756ffd991f5540d952cf937Romain Guy */ 1247ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPatch(@NonNull NinePatch patch, @NonNull Rect dst, @Nullable Paint paint) { 1248f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy patch.drawSoftware(this, dst, paint); 1249f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy } 1250f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy 1251f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy /** 1252f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * Draws the specified bitmap as an N-patch (most often, a 9-patches.) 1253f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * 1254f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @param patch The ninepatch object to render 1255f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @param dst The destination rectangle. 1256f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @param paint The paint to draw the bitmap with. may be null 1257f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * 1258f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @hide 1259f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy */ 1260ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPatch(@NonNull NinePatch patch, @NonNull RectF dst, @Nullable Paint paint) { 1261f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy patch.drawSoftware(this, dst, paint); 1262f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy } 1263f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy 1264deba785f122a47915756ffd991f5540d952cf937Romain Guy /** 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, with its top/left corner at (x,y), using 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified paint, transformed by the current matrix. 1267051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 126811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 127411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>If the bitmap and canvas have different densities, this function 127511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * will take care of automatically scaling the bitmap to draw at the 127611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * same density as the canvas. 1277051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 12789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 12799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The position of the left side of the bitmap being drawn 12809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The position of the top side of the bitmap being drawn 12819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the bitmap (may be null) 12829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1283ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull Bitmap bitmap, float left, float top, @Nullable Paint paint) { 12841abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 12855c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawBitmap(mNativeCanvasWrapper, bitmap.ni(), left, top, 1286f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy paint != null ? paint.mNativePaint : 0, mDensity, mScreenDensity, bitmap.mDensity); 12879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, scaling/translating automatically to fill 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the destination rectangle. If the source rectangle is not null, it 12929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specifies the subset of the bitmap to draw. 1293051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 129411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 12969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 12979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 12989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 12999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 130011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>This function <em>ignores the density associated with the bitmap</em>. 130111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * This is because the source and destination rectangle coordinate 130211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * spaces are in their respective densities, so must already have the 130311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * appropriate scaling factor applied. 1304051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 13059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 13069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param src May be null. The subset of the bitmap to be drawn 13079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dst The rectangle that the bitmap will be scaled/translated 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to fit into 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 13109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1311ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull Bitmap bitmap, @Nullable Rect src, @NonNull RectF dst, 1312ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Nullable Paint paint) { 13138872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger if (dst == null) { 13148872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger throw new NullPointerException(); 13158872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } 13168872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger throwIfCannotDraw(bitmap); 13178872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger final long nativePaint = paint == null ? 0 : paint.mNativePaint; 13188872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger 13198872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger float left, top, right, bottom; 13208872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger if (src == null) { 13218872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger left = top = 0; 13228872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger right = bitmap.getWidth(); 13238872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bottom = bitmap.getHeight(); 13248872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } else { 13258872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger left = src.left; 13268872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger right = src.right; 13278872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger top = src.top; 13288872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bottom = src.bottom; 13298872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } 13308872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger 13318872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger native_drawBitmap(mNativeCanvasWrapper, bitmap.ni(), left, top, right, bottom, 13328872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger dst.left, dst.top, dst.right, dst.bottom, nativePaint, mScreenDensity, 13338872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bitmap.mDensity); 13348872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, scaling/translating automatically to fill 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the destination rectangle. If the source rectangle is not null, it 13399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specifies the subset of the bitmap to draw. 1340051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 134111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 134711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>This function <em>ignores the density associated with the bitmap</em>. 134811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * This is because the source and destination rectangle coordinate 134911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * spaces are in their respective densities, so must already have the 135011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * appropriate scaling factor applied. 1351051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 13539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param src May be null. The subset of the bitmap to be drawn 13549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dst The rectangle that the bitmap will be scaled/translated 13559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to fit into 13569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 13579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1358ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull Bitmap bitmap, @Nullable Rect src, @NonNull Rect dst, 1359ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Nullable Paint paint) { 13609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (dst == null) { 13619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 13629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13631abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 13648872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger final long nativePaint = paint == null ? 0 : paint.mNativePaint; 13658872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger 13668872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger int left, top, right, bottom; 13678872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger if (src == null) { 13688872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger left = top = 0; 13698872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger right = bitmap.getWidth(); 13708872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bottom = bitmap.getHeight(); 13718872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } else { 13728872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger left = src.left; 13738872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger right = src.right; 13748872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger top = src.top; 13758872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bottom = src.bottom; 13768872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } 13778872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger 13788872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger native_drawBitmap(mNativeCanvasWrapper, bitmap.ni(), left, top, right, bottom, 13798872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger dst.left, dst.top, dst.right, dst.bottom, nativePaint, mScreenDensity, 13808872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bitmap.mDensity); 13819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1382051910b9f998030dacb8a0722588cc715813fde1Raph Levien 13839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Treat the specified array of colors as a bitmap, and draw it. This gives 13859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the same result as first creating a bitmap from the array, and then 13869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawing it, but this method avoids explicitly creating a bitmap object 13879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * which can be more efficient if the colors are changing often. 13889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors Array of colors representing the pixels of the bitmap 13909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Offset into the array of colors for the first pixel 139183d522290e56f614d0d9373d47c2b54b9e207795Brad Fitzpatrick * @param stride The number of colors in the array between rows (must be 13929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * >= width or <= -width). 13939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The X coordinate for where to draw the bitmap 13949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The Y coordinate for where to draw the bitmap 13959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The width of the bitmap 13969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The height of the bitmap 13979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hasAlpha True if the alpha channel of the colors contains valid 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * values. If false, the alpha byte is ignored (assumed to 13999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be 0xFF for every pixel). 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 1401cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * 1402cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * @deprecated Usage with a {@link #isHardwareAccelerated() hardware accelerated} canvas 1403cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * requires an internal copy of color buffer contents every time this method is called. Using a 1404cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * Bitmap avoids this copy, and allows the application to more explicitly control the lifetime 1405cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * and copies of pixel data. 14069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1407cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik @Deprecated 1408ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull int[] colors, int offset, int stride, float x, float y, 1409ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese int width, int height, boolean hasAlpha, @Nullable Paint paint) { 14109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // check for valid input 14119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width < 0) { 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("width must be >= 0"); 14139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (height < 0) { 14159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("height must be >= 0"); 14169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (Math.abs(stride) < width) { 14189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("abs(stride) must be >= width"); 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int lastScanline = offset + (height - 1) * stride; 14219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = colors.length; 14229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (offset < 0 || (offset + width > length) || lastScanline < 0 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (lastScanline + width > length)) { 14249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 14259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // quick escape if there's nothing to draw 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width == 0 || height == 0) { 14289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 14299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // punch down to native for the actual draw 14315c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawBitmap(mNativeCanvasWrapper, colors, offset, stride, x, y, width, height, hasAlpha, 14329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint != null ? paint.mNativePaint : 0); 14339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1434cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik 1435cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik /** 1436cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * Legacy version of drawBitmap(int[] colors, ...) that took ints for x,y 1437cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * 1438cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * @deprecated Usage with a {@link #isHardwareAccelerated() hardware accelerated} canvas 1439cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * requires an internal copy of color buffer contents every time this method is called. Using a 1440cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * Bitmap avoids this copy, and allows the application to more explicitly control the lifetime 1441cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * and copies of pixel data. 14429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1443cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik @Deprecated 1444ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull int[] colors, int offset, int stride, int x, int y, 1445ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese int width, int height, boolean hasAlpha, @Nullable Paint paint) { 14469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // call through to the common float version 14479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawBitmap(colors, offset, stride, (float)x, (float)y, width, height, 14489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project hasAlpha, paint); 14499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1450cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik 14519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the bitmap using the specified matrix. 14539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to draw 14559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix used to transform the bitmap when it is drawn 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 14579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1458ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull Bitmap bitmap, @NonNull Matrix matrix, @Nullable Paint paint) { 14595c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita nativeDrawBitmapMatrix(mNativeCanvasWrapper, bitmap.ni(), matrix.ni(), 14609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint != null ? paint.mNativePaint : 0); 14619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14625a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy 14635a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy /** 14645a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy * @hide 14655a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy */ 14665a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy protected static void checkRange(int length, int offset, int count) { 14679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((offset | count) < 0 || offset + count > length) { 14689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 14699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1471051910b9f998030dacb8a0722588cc715813fde1Raph Levien 14729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the bitmap through the mesh, where mesh vertices are evenly 14749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed across the bitmap. There are meshWidth+1 vertices across, and 14759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * meshHeight+1 vertices down. The verts array is accessed in row-major 14769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * order, so that the first meshWidth+1 vertices are distributed across the 14779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * top of the bitmap from left to right. A more general version of this 14785d11676414b3606792e23c269cf75b44faa1a2afChris Craik * method is drawVertices(). 14799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to draw using the mesh 14819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param meshWidth The number of columns in the mesh. Nothing is drawn if 14829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this is 0 14839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param meshHeight The number of rows in the mesh. Nothing is drawn if 14849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this is 0 14859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param verts Array of x,y pairs, specifying where the mesh should be 14869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawn. There must be at least 14875d11676414b3606792e23c269cf75b44faa1a2afChris Craik * (meshWidth+1) * (meshHeight+1) * 2 + vertOffset values 14889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the array 14899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertOffset Number of verts elements to skip before drawing 14909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors May be null. Specifies a color at each vertex, which is 14919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * interpolated across the cell, and whose values are 14929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * multiplied by the corresponding bitmap colors. If not null, 14939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * there must be at least (meshWidth+1) * (meshHeight+1) + 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * colorOffset values in the array. 14959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colorOffset Number of color elements to skip before drawing 14969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 14979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1498ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmapMesh(@NonNull Bitmap bitmap, int meshWidth, int meshHeight, 1499ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull float[] verts, int vertOffset, @Nullable int[] colors, int colorOffset, 1500ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Nullable Paint paint) { 15019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((meshWidth | meshHeight | vertOffset | colorOffset) < 0) { 15029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 15039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (meshWidth == 0 || meshHeight == 0) { 15059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 15069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int count = (meshWidth + 1) * (meshHeight + 1); 15089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we mul by 2 since we need two floats per vertex 15099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(verts.length, vertOffset, count * 2); 15109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (colors != null) { 15119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // no mul by 2, since we need only 1 color per vertex 15129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(colors.length, colorOffset, count); 15139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15145c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita nativeDrawBitmapMesh(mNativeCanvasWrapper, bitmap.ni(), meshWidth, meshHeight, 1515f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy verts, vertOffset, colors, colorOffset, 1516f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint != null ? paint.mNativePaint : 0); 15179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1518f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 15199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum VertexMode { 15209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLES(0), 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLE_STRIP(1), 15229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLE_FAN(2); 1523051910b9f998030dacb8a0722588cc715813fde1Raph Levien 15249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project VertexMode(int nativeInt) { 15259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = nativeInt; 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1527a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy 1528a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy /** 1529a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy * @hide 1530a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy */ 1531a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy public final int nativeInt; 15329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1533051910b9f998030dacb8a0722588cc715813fde1Raph Levien 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the array of vertices, interpreted as triangles (based on mode). The 15369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * verts array is required, and specifies the x,y pairs for each vertex. If 15379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * texs is non-null, then it is used to specify the coordinate in shader 15389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinates to use at each vertex (the paint must have a shader in this 15399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * case). If there is no texs array, but there is a color array, then each 15409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color is interpolated across its corresponding triangle in a gradient. If 15419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * both texs and colors arrays are present, then they behave as before, but 15429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the resulting color at each pixels is the result of multiplying the 15439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * colors from the shader and the color-gradient together. The indices array 15449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is optional, but if it is present, then it is used to specify the index 15459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of each triangle, rather than just walking through the arrays in order. 15469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode How to interpret the array of vertices 15489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertexCount The number of values in the vertices array (and 15499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * corresponding texs and colors arrays if non-null). Each logical 15509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex is two values (x, y), vertexCount must be a multiple of 2. 15519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param verts Array of vertices for the mesh 15529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertOffset Number of values in the verts to skip before drawing. 15539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param texs May be null. If not null, specifies the coordinates to sample 15549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * into the current shader (e.g. bitmap tile or gradient) 15559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param texOffset Number of values in texs to skip before drawing. 15569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors May be null. If not null, specifies a color for each 15579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex, to be interpolated across the triangle. 15589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colorOffset Number of values in colors to skip before drawing. 15599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param indices If not null, array of indices to reference into the 15609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex (texs, colors) array. 15619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param indexCount number of entries in the indices array (if not null). 1562051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @param paint Specifies the shader to use if the texs array is non-null. 15639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1564ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawVertices(@NonNull VertexMode mode, int vertexCount, @NonNull float[] verts, 1565ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese int vertOffset, @Nullable float[] texs, int texOffset, @Nullable int[] colors, 1566ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese int colorOffset, @Nullable short[] indices, int indexOffset, int indexCount, 1567ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 15689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(verts.length, vertOffset, vertexCount); 15699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (texs != null) { 15709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(texs.length, texOffset, vertexCount); 15719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (colors != null) { 157392ce5734b52ef014c80cc6335112a027188b3eb6Erik Faye-Lund checkRange(colors.length, colorOffset, vertexCount / 2); 15749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (indices != null) { 15769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(indices.length, indexOffset, indexCount); 15779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15785c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita nativeDrawVertices(mNativeCanvasWrapper, mode.nativeInt, vertexCount, verts, 1579f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy vertOffset, texs, texOffset, colors, colorOffset, 1580f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy indices, indexOffset, indexCount, paint.mNativePaint); 15819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 158236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat 15839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. The 15859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin is interpreted based on the Align setting in the paint. 15869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 15889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 15899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of the origin of the text being drawn 15909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 15919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1592ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawText(@NonNull char[] text, int index, int count, float x, float y, 1593ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 15949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((index | count | (index + count) | 15959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project (text.length - index - count)) < 0) { 15969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 15979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15985c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, text, index, count, x, y, paint.mBidiFlags, 1599a033630e805c407080221e20b236b6054f324670Raph Levien paint.mNativePaint, paint.mNativeTypeface); 16009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. The 16049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin is interpreted based on the Align setting in the paint. 16059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 16079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 16089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of the origin of the text being drawn 16099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 16109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1611ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawText(@NonNull String text, float x, float y, @NonNull Paint paint) { 16125c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, text, 0, text.length(), x, y, paint.mBidiFlags, 1613a033630e805c407080221e20b236b6054f324670Raph Levien paint.mNativePaint, paint.mNativeTypeface); 1614f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 16159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. 16189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The origin is interpreted based on the Align setting in the paint. 16199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 16219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param start The index of the first character in text to draw 16229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param end (end - 1) is the index of the last character in text to draw 16239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 16249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of the origin of the text being drawn 16259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 16269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1627ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawText(@NonNull String text, int start, int end, float x, float y, 1628ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 16299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((start | end | (end - start) | (text.length() - end)) < 0) { 16309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 16319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16325c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, text, start, end, x, y, paint.mBidiFlags, 1633a033630e805c407080221e20b236b6054f324670Raph Levien paint.mNativePaint, paint.mNativeTypeface); 16349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified range of text, specified by start/end, with its 16389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin at (x,y), in the specified Paint. The origin is interpreted 16399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * based on the Align setting in the Paint. 16409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 16429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param start The index of the first character in text to draw 16439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param end (end - 1) is the index of the last character in text 16449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to draw 16459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of origin for where to draw the text 16469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of origin for where to draw the text 16479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 16489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1649ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawText(@NonNull CharSequence text, int start, int end, float x, float y, 1650ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 16519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (text instanceof String || text instanceof SpannedString || 16529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project text instanceof SpannableString) { 16535c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, text.toString(), start, end, x, y, 1654a033630e805c407080221e20b236b6054f324670Raph Levien paint.mBidiFlags, paint.mNativePaint, paint.mNativeTypeface); 1655f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else if (text instanceof GraphicsOperations) { 16569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ((GraphicsOperations) text).drawText(this, start, end, x, y, 1657f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint); 1658f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else { 1659f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt char[] buf = TemporaryBuffer.obtain(end - start); 1660f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt TextUtils.getChars(text, start, end, buf, 0); 16615c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, buf, 0, end - start, x, y, 1662a033630e805c407080221e20b236b6054f324670Raph Levien paint.mBidiFlags, paint.mNativePaint, paint.mNativeTypeface); 1663f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt TemporaryBuffer.recycle(buf); 16649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1665f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1666f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1667f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1668f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * Render a run of all LTR or all RTL text, with shaping. This does not run 1669f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * bidi on the provided text, but renders it as a uniform right-to-left or 1670f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * left-to-right run, as indicated by dir. Alignment of the text is as 1671f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * determined by the Paint's TextAlign value. 1672051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 1673f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param text the text to render 16740c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param index the start of the text to render 16750c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param count the count of chars to render 16760c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param contextIndex the start of the context for shaping. Must be 16770c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * no greater than index. 16780c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param contextCount the number of characters in the context for shaping. 16790c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * ContexIndex + contextCount must be no less than index 16800c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * + count. 1681f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param x the x position at which to draw the text 1682f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param y the y position at which to draw the text 1683051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @param isRtl whether the run is in RTL direction 1684f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param paint the paint 1685f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @hide 1686f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt */ 1687ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawTextRun(@NonNull char[] text, int index, int count, int contextIndex, 1688051910b9f998030dacb8a0722588cc715813fde1Raph Levien int contextCount, float x, float y, boolean isRtl, @NonNull Paint paint) { 1689f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1690f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text == null) { 1691f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("text is null"); 1692f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1693f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (paint == null) { 1694f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("paint is null"); 1695f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 16960c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt if ((index | count | text.length - index - count) < 0) { 1697f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new IndexOutOfBoundsException(); 1698f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1699f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 17005c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawTextRun(mNativeCanvasWrapper, text, index, count, 1701051910b9f998030dacb8a0722588cc715813fde1Raph Levien contextIndex, contextCount, x, y, isRtl, paint.mNativePaint, paint.mNativeTypeface); 1702f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1703f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1704f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1705f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * Render a run of all LTR or all RTL text, with shaping. This does not run 1706f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * bidi on the provided text, but renders it as a uniform right-to-left or 1707f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * left-to-right run, as indicated by dir. Alignment of the text is as 1708f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * determined by the Paint's TextAlign value. 17090c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * 1710f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param text the text to render 1711f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param start the start of the text to render. Data before this position 1712f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * can be used for shaping context. 1713f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param end the end of the text to render. Data at or after this 1714f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * position can be used for shaping context. 1715f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param x the x position at which to draw the text 1716f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param y the y position at which to draw the text 1717051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @param isRtl whether the run is in RTL direction 1718f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param paint the paint 1719f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @hide 1720f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt */ 1721ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawTextRun(@NonNull CharSequence text, int start, int end, int contextStart, 1722051910b9f998030dacb8a0722588cc715813fde1Raph Levien int contextEnd, float x, float y, boolean isRtl, @NonNull Paint paint) { 1723f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1724f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text == null) { 1725f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("text is null"); 1726f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1727f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (paint == null) { 1728f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("paint is null"); 1729f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1730f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if ((start | end | end - start | text.length() - end) < 0) { 1731f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new IndexOutOfBoundsException(); 1732f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1733f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1734f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text instanceof String || text instanceof SpannedString || 1735f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt text instanceof SpannableString) { 17365c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawTextRun(mNativeCanvasWrapper, text.toString(), start, end, 1737051910b9f998030dacb8a0722588cc715813fde1Raph Levien contextStart, contextEnd, x, y, isRtl, paint.mNativePaint, paint.mNativeTypeface); 1738f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else if (text instanceof GraphicsOperations) { 17390c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt ((GraphicsOperations) text).drawTextRun(this, start, end, 1740051910b9f998030dacb8a0722588cc715813fde1Raph Levien contextStart, contextEnd, x, y, isRtl, paint); 1741f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else { 17420c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int contextLen = contextEnd - contextStart; 17430c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int len = end - start; 17440c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt char[] buf = TemporaryBuffer.obtain(contextLen); 17450c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt TextUtils.getChars(text, contextStart, contextEnd, buf, 0); 17465c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawTextRun(mNativeCanvasWrapper, buf, start - contextStart, len, 1747051910b9f998030dacb8a0722588cc715813fde1Raph Levien 0, contextLen, x, y, isRtl, paint.mNativePaint, paint.mNativeTypeface); 17489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TemporaryBuffer.recycle(buf); 17499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text in the array, with each character's origin specified by 17549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the pos array. 1755051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 175662b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * This method does not support glyph composition and decomposition and 17573f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien * should therefore not be used to render complex scripts. It also doesn't 17583f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien * handle supplementary characters (eg emoji). 17599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 17619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index The index of the first character to draw 17629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of characters to draw, starting from index. 17639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pos Array of [x,y] positions, used to position each 17649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * character 17659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 17669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1767f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 1768ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPosText(@NonNull char[] text, int index, int count, @NonNull float[] pos, 1769ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 17709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (index < 0 || index + count > text.length || count*2 > pos.length) { 17719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 17729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17733f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien for (int i = 0; i < count; i++) { 17743f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien drawText(text, index + i, 1, pos[i * 2], pos[i * 2 + 1], paint); 17753f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien } 17769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text in the array, with each character's origin specified by 17809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the pos array. 1781051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 178262b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * This method does not support glyph composition and decomposition and 17833f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien * should therefore not be used to render complex scripts. It also doesn't 17843f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien * handle supplementary characters (eg emoji). 17859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 17879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pos Array of [x,y] positions, used to position each character 17889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 17899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1790f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 1791ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPosText(@NonNull String text, @NonNull float[] pos, @NonNull Paint paint) { 17923f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien drawPosText(text.toCharArray(), 0, text.length(), pos, paint); 17939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint, along 17979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified path. The paint's Align setting determins where along the 17989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * path to start the text. 17999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 18019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path the text should follow for its baseline 18029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hOffset The distance along the path to add to the text's 18039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * starting position 18049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vOffset The distance above(-) or below(+) the path to position 18059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the text 18069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 18079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1808ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawTextOnPath(@NonNull char[] text, int index, int count, @NonNull Path path, 1809ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese float hOffset, float vOffset, @NonNull Paint paint) { 18109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (index < 0 || index + count > text.length) { 18119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 18129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18135c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawTextOnPath(mNativeCanvasWrapper, text, index, count, 1814f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy path.ni(), hOffset, vOffset, 18159d2b5e1930bfc4b1da1c865843c247c708ea1565Raph Levien paint.mBidiFlags, paint.mNativePaint, paint.mNativeTypeface); 18169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint, along 18209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified path. The paint's Align setting determins where along the 18219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * path to start the text. 18229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 18249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path the text should follow for its baseline 18259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hOffset The distance along the path to add to the text's 18269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * starting position 18279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vOffset The distance above(-) or below(+) the path to position 18289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the text 18299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 18309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1831ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawTextOnPath(@NonNull String text, @NonNull Path path, float hOffset, 1832ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese float vOffset, @NonNull Paint paint) { 18339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (text.length() > 0) { 18345c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawTextOnPath(mNativeCanvasWrapper, text, path.ni(), hOffset, vOffset, 18359d2b5e1930bfc4b1da1c865843c247c708ea1565Raph Levien paint.mBidiFlags, paint.mNativePaint, paint.mNativeTypeface); 18369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Save the canvas state, draw the picture, and restore the canvas state. 18419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This differs from picture.draw(canvas), which does not perform any 18429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * save/restore. 1843cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * 1844cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * <p> 1845cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * <strong>Note:</strong> This forces the picture to internally call 1846cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * {@link Picture#endRecording} in order to prepare for playback. 1847051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 18489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param picture The picture to be drawn 18499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1850ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPicture(@NonNull Picture picture) { 18519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project picture.endRecording(); 1852667fe1039feae068d3333de8fb7115313f4a517bJonathan Dixon int restoreCount = save(); 1853667fe1039feae068d3333de8fb7115313f4a517bJonathan Dixon picture.draw(this); 1854667fe1039feae068d3333de8fb7115313f4a517bJonathan Dixon restoreToCount(restoreCount); 18559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1856051910b9f998030dacb8a0722588cc715813fde1Raph Levien 18579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the picture, stretched to fit into the dst rectangle. 18599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1860ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPicture(@NonNull Picture picture, @NonNull RectF dst) { 18619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project save(); 18629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(dst.left, dst.top); 18639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (picture.getWidth() > 0 && picture.getHeight() > 0) { 1864f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy scale(dst.width() / picture.getWidth(), dst.height() / picture.getHeight()); 18659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPicture(picture); 18679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project restore(); 18689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1869051910b9f998030dacb8a0722588cc715813fde1Raph Levien 18709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the picture, stretched to fit into the dst rectangle. 18729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1873ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPicture(@NonNull Picture picture, @NonNull Rect dst) { 18749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project save(); 18759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(dst.left, dst.top); 18769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (picture.getWidth() > 0 && picture.getHeight() > 0) { 1877f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy scale((float) dst.width() / picture.getWidth(), 1878f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy (float) dst.height() / picture.getHeight()); 18799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPicture(picture); 18819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project restore(); 18829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1883da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy 1884da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy /** 1885ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov * Releases the resources associated with this canvas. 1886ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov * 1887ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov * @hide 1888ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov */ 1889ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov public void release() { 1890ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov mFinalizer.dispose(); 1891ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov } 1892ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 1893ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov /** 1894163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * Free up as much memory as possible from private caches (e.g. fonts, images) 1895caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed * 1896163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @hide 1897caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed */ 1898caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed public static native void freeCaches(); 1899caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed 190030ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio /** 190130ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * Free up text layout caches 190230ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * 190330ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * @hide 190430ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio */ 190530ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio public static native void freeTextLayoutCaches(); 190630ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio 190736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native long initRaster(long nativeBitmapOrZero); 19085c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita private static native void native_setBitmap(long canvasHandle, 19095c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita long bitmapHandle, 19105c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita boolean copyState); 191195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native boolean native_isOpaque(long canvasHandle); 191295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native int native_getWidth(long canvasHandle); 191395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native int native_getHeight(long canvasHandle); 191495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita 191595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native int native_save(long canvasHandle, int saveFlags); 191636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native int native_saveLayer(long nativeCanvas, float l, 19179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float t, float r, float b, 191836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint, 191936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int layerFlags); 192036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native int native_saveLayerAlpha(long nativeCanvas, float l, 19219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float t, float r, float b, 19229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int alpha, int layerFlags); 192395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_restore(long canvasHandle); 192495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_restoreToCount(long canvasHandle, 192595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita int saveCount); 192695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native int native_getSaveCount(long canvasHandle); 192795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita 192895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_translate(long canvasHandle, 192995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita float dx, float dy); 193095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_scale(long canvasHandle, 193195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita float sx, float sy); 193295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_rotate(long canvasHandle, float degrees); 193395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_skew(long canvasHandle, 193495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita float sx, float sy); 193536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_concat(long nativeCanvas, 193636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix); 193736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_setMatrix(long nativeCanvas, 193836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix); 193936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_clipRect(long nativeCanvas, 19409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 19419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float right, float bottom, 19429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 194336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_clipPath(long nativeCanvas, 194436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePath, 19459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 194636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_clipRegion(long nativeCanvas, 194736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeRegion, 19489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 194936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeSetDrawFilter(long nativeCanvas, 195036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeFilter); 195136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_getClipBounds(long nativeCanvas, 19529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect bounds); 195336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_getCTM(long nativeCanvas, 195436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix); 195536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_quickReject(long nativeCanvas, 195636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePath); 195736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_quickReject(long nativeCanvas, 19589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 1959ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger float right, float bottom); 196036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawColor(long nativeCanvas, int color, 19619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mode); 196236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawPaint(long nativeCanvas, 196336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 196495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_drawPoint(long canvasHandle, float x, float y, 196595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita long paintHandle); 196695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_drawPoints(long canvasHandle, float[] pts, 196795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita int offset, int count, 196895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita long paintHandle); 196936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawLine(long nativeCanvas, float startX, 19709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float startY, float stopX, 197136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float stopY, long nativePaint); 197295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_drawLines(long canvasHandle, float[] pts, 197395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita int offset, int count, 197495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita long paintHandle); 197536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawRect(long nativeCanvas, float left, 19769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float top, float right, 197736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float bottom, 197836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 197924609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese private static native void native_drawOval(long nativeCanvas, float left, float top, 198024609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese float right, float bottom, long nativePaint); 198136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawCircle(long nativeCanvas, float cx, 19829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float cy, float radius, 198336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 198424609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese private static native void native_drawArc(long nativeCanvas, float left, float top, 198524609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese float right, float bottom, 198624609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese float startAngle, float sweep, boolean useCenter, 198736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 198836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawRoundRect(long nativeCanvas, 19894d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik float left, float top, float right, float bottom, 19904d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik float rx, float ry, long nativePaint); 199136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawPath(long nativeCanvas, 199236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePath, 199336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 199436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private native void native_drawBitmap(long nativeCanvas, long nativeBitmap, 19959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 199636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaintOrZero, 19970d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int canvasDensity, 19980d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int screenDensity, 19990d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int bitmapDensity); 200036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private native void native_drawBitmap(long nativeCanvas, long nativeBitmap, 20018872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger float srcLeft, float srcTop, float srcRight, float srcBottom, 20028872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger float dstLeft, float dstTop, float dstRight, float dstBottom, 20038872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger long nativePaintOrZero, int screenDensity, int bitmapDensity); 200436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawBitmap(long nativeCanvas, int[] colors, 20059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offset, int stride, float x, 20069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float y, int width, int height, 20079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean hasAlpha, 200836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaintOrZero); 200936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeDrawBitmapMatrix(long nativeCanvas, 201036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeBitmap, 201136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix, 201236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 201336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeDrawBitmapMesh(long nativeCanvas, 201436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeBitmap, 20159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int meshWidth, int meshHeight, 20169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] verts, int vertOffset, 201736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int[] colors, int colorOffset, 201836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 201936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeDrawVertices(long nativeCanvas, int mode, int n, 20209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] verts, int vertOffset, float[] texs, int texOffset, 20219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] colors, int colorOffset, short[] indices, 202236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int indexOffset, int indexCount, long nativePaint); 202336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat 202436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawText(long nativeCanvas, char[] text, 20259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int index, int count, float x, 202636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float y, int flags, long nativePaint, 202736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeTypeface); 202836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawText(long nativeCanvas, String text, 20299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int start, int end, float x, 203036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float y, int flags, long nativePaint, 203136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeTypeface); 2032fcf2be1846935e7983ea2fe87fdd4d7af27764b6Fabrice Di Meglio 203336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextRun(long nativeCanvas, String text, 20340c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int start, int end, int contextStart, int contextEnd, 2035051910b9f998030dacb8a0722588cc715813fde1Raph Levien float x, float y, boolean isRtl, long nativePaint, long nativeTypeface); 2036f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 203736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextRun(long nativeCanvas, char[] text, 20380c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int start, int count, int contextStart, int contextCount, 2039051910b9f998030dacb8a0722588cc715813fde1Raph Levien float x, float y, boolean isRtl, long nativePaint, long nativeTypeface); 2040f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 204136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextOnPath(long nativeCanvas, 20429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char[] text, int index, 204336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int count, long nativePath, 20449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float hOffset, 2045da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio float vOffset, int bidiFlags, 20469d2b5e1930bfc4b1da1c865843c247c708ea1565Raph Levien long nativePaint, long nativeTypeface); 204736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextOnPath(long nativeCanvas, 204836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat String text, long nativePath, 204936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float hOffset, 205036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float vOffset, 20519d2b5e1930bfc4b1da1c865843c247c708ea1565Raph Levien int flags, long nativePaint, long nativeTypeface); 205236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void finalizer(long nativeCanvas); 20539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 2054