Canvas.java revision 775873a66a946fae2b0535abb51df9817bd1b20c
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 1980756e38882720860db52f1fcc21fa1505a02abfTor Norbyeimport android.annotation.ColorInt; 20ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabreseimport android.annotation.IntDef; 21ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabreseimport android.annotation.NonNull; 22ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabreseimport android.annotation.Nullable; 23b3ec733bb830f2d4425825d93f9ed95f284e9145Tor Norbyeimport android.annotation.Size; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.text.GraphicsOperations; 25f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Feltimport android.text.SpannableString; 26f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Feltimport android.text.SpannedString; 27f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Feltimport android.text.TextUtils; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 29ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabreseimport java.lang.annotation.Retention; 30ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabreseimport java.lang.annotation.RetentionPolicy; 31ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese 32091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craikimport javax.microedition.khronos.opengles.GL; 33091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik 34775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhlerimport libcore.util.NativeAllocationRegistry; 35775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The Canvas class holds the "draw" calls. To draw something, you need 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4 basic components: A Bitmap to hold the pixels, a Canvas to host 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the draw calls (writing into the bitmap), a drawing primitive (e.g. Rect, 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Path, text, Bitmap), and a paint (to describe the colors and styles for the 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawing). 4261fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * 4361fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * <div class="special reference"> 4461fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * <h3>Developer Guides</h3> 4561fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * <p>For more information about how to use Canvas, read the 4661fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * <a href="{@docRoot}guide/topics/graphics/2d-graphics.html"> 4761fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * Canvas and Drawables</a> developer guide.</p></div> 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class Canvas { 503891f3ad598561d5a82c07795e1fee7f1d3612d1Chris Craik /** @hide */ 513891f3ad598561d5a82c07795e1fee7f1d3612d1Chris Craik public static boolean sCompatibilityRestore = false; 52ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 538dfaa4904205772cdceee63ef3989bcdedf1a914Tom Hudson /** 548dfaa4904205772cdceee63ef3989bcdedf1a914Tom Hudson * Should only be assigned in constructors (or setBitmap if software canvas), 55775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler * freed by NativeAllocation. 568dfaa4904205772cdceee63ef3989bcdedf1a914Tom Hudson * @hide 578dfaa4904205772cdceee63ef3989bcdedf1a914Tom Hudson */ 588dfaa4904205772cdceee63ef3989bcdedf1a914Tom Hudson protected long mNativeCanvasWrapper; 59c677675e9c465dc1de21ecf2e0421835c7eb55b4Florin Malita 60ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov /** @hide */ 615c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita public long getNativeCanvasWrapper() { 625c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return mNativeCanvasWrapper; 63c677675e9c465dc1de21ecf2e0421835c7eb55b4Florin Malita } 64ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 65a753f4c6cb8558795e673df1896532cd148781e2Chris Craik /** @hide */ 66a753f4c6cb8558795e673df1896532cd148781e2Chris Craik public boolean isRecordingFor(Object o) { return false; } 67a753f4c6cb8558795e673df1896532cd148781e2Chris Craik 68e0aa84b7dc087e999e20055dcc04cb6a48d5bd62Romain Guy // may be null 69e0aa84b7dc087e999e20055dcc04cb6a48d5bd62Romain Guy private Bitmap mBitmap; 70ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // optional field set by the caller 72ce0537b80087a6225273040a987414b1dd081aa0Romain Guy private DrawFilter mDrawFilter; 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 74ce0537b80087a6225273040a987414b1dd081aa0Romain Guy /** 75ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * @hide 76ce0537b80087a6225273040a987414b1dd081aa0Romain Guy */ 77ce0537b80087a6225273040a987414b1dd081aa0Romain Guy protected int mDensity = Bitmap.DENSITY_NONE; 780d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn 79ce0537b80087a6225273040a987414b1dd081aa0Romain Guy /** 80ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * Used to determine when compatibility scaling is in effect. 81051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 82ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * @hide 83ce0537b80087a6225273040a987414b1dd081aa0Romain Guy */ 84ce0537b80087a6225273040a987414b1dd081aa0Romain Guy protected int mScreenDensity = Bitmap.DENSITY_NONE; 85051910b9f998030dacb8a0722588cc715813fde1Raph Levien 86f61970fc79e9c5cf340fa942597628242361864aRomain Guy // Maximum bitmap size as defined in Skia's native code 87f61970fc79e9c5cf340fa942597628242361864aRomain Guy // (see SkCanvas.cpp, SkDraw.cpp) 88f61970fc79e9c5cf340fa942597628242361864aRomain Guy private static final int MAXMIMUM_BITMAP_SIZE = 32766; 89f61970fc79e9c5cf340fa942597628242361864aRomain Guy 90775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler // The approximate size of the native allocation associated with 91775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler // a Canvas object. 92775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler private static final long NATIVE_ALLOCATION_SIZE = 525; 93e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 94775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler private static final NativeAllocationRegistry sRegistry = new NativeAllocationRegistry( 95775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler getNativeFinalizer(), NATIVE_ALLOCATION_SIZE); 96ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 97775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler // This field is used to finalize the native Canvas properly 98775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler private Runnable mFinalizer; 99e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 100f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Construct an empty raster canvas. Use setBitmap() to specify a bitmap to 10296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * draw into. The initial target density is {@link Bitmap#DENSITY_NONE}; 10396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * this will typically be replaced when a target bitmap is set for the 10496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * canvas. 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Canvas() { 107003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy if (!isHardwareAccelerated()) { 108003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy // 0 means no native bitmap 109c1b33d665c8caf5760f68c45c6ca0baa649b832aJohn Reck mNativeCanvasWrapper = initRaster(null); 110775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler mFinalizer = sRegistry.registerNativeAllocation(this, mNativeCanvasWrapper); 111003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy } else { 112003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy mFinalizer = null; 113003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy } 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Construct a canvas with the specified bitmap to draw into. The bitmap 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * must be mutable. 119051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 12096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>The initial target density of the canvas is the same as the given 12196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * bitmap's density. 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap Specifies a mutable bitmap for the canvas to draw into. 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 125ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public Canvas(@NonNull Bitmap bitmap) { 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!bitmap.isMutable()) { 127f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy throw new IllegalStateException("Immutable bitmap passed to Canvas constructor"); 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1291abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 130c1b33d665c8caf5760f68c45c6ca0baa649b832aJohn Reck mNativeCanvasWrapper = initRaster(bitmap); 131775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler mFinalizer = sRegistry.registerNativeAllocation(this, mNativeCanvasWrapper); 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBitmap = bitmap; 13396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn mDensity = bitmap.mDensity; 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 135ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 136ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov /** @hide */ 13736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat public Canvas(long nativeCanvas) { 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (nativeCanvas == 0) { 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(); 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1418872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger mNativeCanvasWrapper = nativeCanvas; 142775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler mFinalizer = sRegistry.registerNativeAllocation(this, mNativeCanvasWrapper); 14396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn mDensity = Bitmap.getDefaultDensity(); 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 145163935113919a184122b8b3bd672ef08c8df65dcRomain Guy 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 147091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik * Returns null. 148c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * 149091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik * @deprecated This method is not supported and should not be invoked. 150c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * 151091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik * @hide 152091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik */ 153091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik @Deprecated 154091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik protected GL getGL() { 155091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik return null; 156091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik } 157091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik 158091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik /** 1592d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * Indicates whether this Canvas uses hardware acceleration. 160051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 1612d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * Note that this method does not define what type of hardware acceleration 1622d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * may or may not be used. 163051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 1642d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * @return True if drawing operations are hardware accelerated, 1652d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * false otherwise. 1662d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy */ 1672d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy public boolean isHardwareAccelerated() { 168163935113919a184122b8b3bd672ef08c8df65dcRomain Guy return false; 169caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed } 170163935113919a184122b8b3bd672ef08c8df65dcRomain Guy 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 172051910b9f998030dacb8a0722588cc715813fde1Raph Levien * Specify a bitmap for the canvas to draw into. All canvas state such as 1733bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * layers, filters, and the save/restore stack are reset with the exception 1743bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * of the current matrix and clip stack. Additionally, as a side-effect 1753bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * the canvas' target density is updated to match that of the bitmap. 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap Specifies a mutable bitmap for the canvas to draw into. 17896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @see #setDensity(int) 17996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @see #getDensity() 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 181ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void setBitmap(@Nullable Bitmap bitmap) { 182163935113919a184122b8b3bd672ef08c8df65dcRomain Guy if (isHardwareAccelerated()) { 18396890564bdbd2f2a41dfc323fc8b3938fb335639Chris Craik throw new RuntimeException("Can't set a bitmap device on a HW accelerated canvas"); 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 186fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger if (bitmap == null) { 187c1b33d665c8caf5760f68c45c6ca0baa649b832aJohn Reck native_setBitmap(mNativeCanvasWrapper, null); 188fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger mDensity = Bitmap.DENSITY_NONE; 189fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger } else { 1900965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy if (!bitmap.isMutable()) { 1910965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy throw new IllegalStateException(); 1920965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy } 1931abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 194fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger 195c1b33d665c8caf5760f68c45c6ca0baa649b832aJohn Reck native_setBitmap(mNativeCanvasWrapper, bitmap); 1960965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy mDensity = bitmap.mDensity; 1970965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy } 1980965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBitmap = bitmap; 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 201c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 202cce47eb580d666ead1f6095d1e3b65233592bbaaChris Craik /** @hide */ 2036578a989566e585eee053095dc80e2552e125db2Derek Sollenberger public void setHighContrastText(boolean highContrastText) { 2046578a989566e585eee053095dc80e2552e125db2Derek Sollenberger native_setHighContrastText(mNativeCanvasWrapper, highContrastText); 2056578a989566e585eee053095dc80e2552e125db2Derek Sollenberger } 206cce47eb580d666ead1f6095d1e3b65233592bbaaChris Craik 2078afd0f245cc0c4a0366f39f41b5f78e47ee83be3Chris Craik /** @hide */ 2088afd0f245cc0c4a0366f39f41b5f78e47ee83be3Chris Craik public void insertReorderBarrier() {} 2098afd0f245cc0c4a0366f39f41b5f78e47ee83be3Chris Craik 2108afd0f245cc0c4a0366f39f41b5f78e47ee83be3Chris Craik /** @hide */ 2118afd0f245cc0c4a0366f39f41b5f78e47ee83be3Chris Craik public void insertInorderBarrier() {} 2128afd0f245cc0c4a0366f39f41b5f78e47ee83be3Chris Craik 213797b95b26bbb7557678af78b9a2a61830158920fChris Craik /** 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the device that the current layer draws into is opaque 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (i.e. does not support per-pixel alpha). 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the device that the current layer draws into is opaque 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 21995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public boolean isOpaque() { 22095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_isOpaque(mNativeCanvasWrapper); 22195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the width of the current drawing layer 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the width of the current drawing layer 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 22895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int getWidth() { 22995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_getWidth(mNativeCanvasWrapper); 23095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the height of the current drawing layer 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the height of the current drawing layer 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 23795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int getHeight() { 23895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_getHeight(mNativeCanvasWrapper); 23995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 24296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>Returns the target density of the canvas. The default density is 24396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * derived from the density of its backing bitmap, or 24496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * {@link Bitmap#DENSITY_NONE} if there is not one.</p> 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 24696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @return Returns the current target density of the canvas, which is used 24796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * to determine the scaling factor when drawing a bitmap into it. 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 24911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #setDensity(int) 250051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @see Bitmap#getDensity() 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 25211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getDensity() { 25311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return mDensity; 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 25796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>Specifies the density for this Canvas' backing bitmap. This modifies 25896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * the target density of the canvas itself, as well as the density of its 25996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * backing bitmap via {@link Bitmap#setDensity(int) Bitmap.setDensity(int)}. 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 26196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @param density The new target density of the canvas, which is used 26296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * to determine the scaling factor when drawing a bitmap into it. Use 26396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * {@link Bitmap#DENSITY_NONE} to disable bitmap scaling. 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 26511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #getDensity() 266051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @see Bitmap#setDensity(int) 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 26811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public void setDensity(int density) { 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mBitmap != null) { 27011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn mBitmap.setDensity(density); 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 27211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn mDensity = density; 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2750d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn /** @hide */ 2760d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn public void setScreenDensity(int density) { 2770d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn mScreenDensity = density; 2780d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn } 279f61970fc79e9c5cf340fa942597628242361864aRomain Guy 280f61970fc79e9c5cf340fa942597628242361864aRomain Guy /** 281f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Returns the maximum allowed width for bitmaps drawn with this canvas. 282f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Attempting to draw with a bitmap wider than this value will result 283f61970fc79e9c5cf340fa942597628242361864aRomain Guy * in an error. 284051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 285051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @see #getMaximumBitmapHeight() 286f61970fc79e9c5cf340fa942597628242361864aRomain Guy */ 287f61970fc79e9c5cf340fa942597628242361864aRomain Guy public int getMaximumBitmapWidth() { 288f61970fc79e9c5cf340fa942597628242361864aRomain Guy return MAXMIMUM_BITMAP_SIZE; 289f61970fc79e9c5cf340fa942597628242361864aRomain Guy } 290051910b9f998030dacb8a0722588cc715813fde1Raph Levien 291f61970fc79e9c5cf340fa942597628242361864aRomain Guy /** 292f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Returns the maximum allowed height for bitmaps drawn with this canvas. 293f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Attempting to draw with a bitmap taller than this value will result 294f61970fc79e9c5cf340fa942597628242361864aRomain Guy * in an error. 295051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 296051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @see #getMaximumBitmapWidth() 297f61970fc79e9c5cf340fa942597628242361864aRomain Guy */ 298f61970fc79e9c5cf340fa942597628242361864aRomain Guy public int getMaximumBitmapHeight() { 299f61970fc79e9c5cf340fa942597628242361864aRomain Guy return MAXMIMUM_BITMAP_SIZE; 300f61970fc79e9c5cf340fa942597628242361864aRomain Guy } 301f61970fc79e9c5cf340fa942597628242361864aRomain Guy 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // the SAVE_FLAG constants must match their native equivalents 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 304ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese /** @hide */ 305ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @IntDef(flag = true, 306ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese value = { 307ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese MATRIX_SAVE_FLAG, 308ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese CLIP_SAVE_FLAG, 309ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese HAS_ALPHA_LAYER_SAVE_FLAG, 310ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese FULL_COLOR_LAYER_SAVE_FLAG, 311ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese CLIP_TO_LAYER_SAVE_FLAG, 312ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese ALL_SAVE_FLAG 313ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese }) 314ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Retention(RetentionPolicy.SOURCE) 315ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public @interface Saveflags {} 316ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese 317f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik /** 318f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Restore the current matrix when restore() is called. 319f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik */ 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MATRIX_SAVE_FLAG = 0x01; 321f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik 322f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik /** 323f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Restore the current clip when restore() is called. 324f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik */ 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CLIP_SAVE_FLAG = 0x02; 326f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik 327f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik /** 328f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * The layer requires a per-pixel alpha channel. 329f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik */ 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int HAS_ALPHA_LAYER_SAVE_FLAG = 0x04; 331f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik 332f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik /** 333f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * The layer requires full 8-bit precision for each color channel. 334f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik */ 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FULL_COLOR_LAYER_SAVE_FLAG = 0x08; 336f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik 337f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik /** 338f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Clip drawing to the bounds of the offscreen layer, omit at your own peril. 339f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p class="note"><strong>Note:</strong> it is strongly recommended to not 340f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * omit this flag for any call to <code>saveLayer()</code> and 341f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <code>saveLayerAlpha()</code> variants. Not passing this flag generally 342f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * triggers extremely poor performance with hardware accelerated rendering. 343f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik */ 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CLIP_TO_LAYER_SAVE_FLAG = 0x10; 345f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik 346f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik /** 347f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Restore everything when restore() is called (standard save flags). 348f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p class="note"><strong>Note:</strong> for performance reasons, it is 349f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * strongly recommended to pass this - the complete set of flags - to any 350f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * call to <code>saveLayer()</code> and <code>saveLayerAlpha()</code> 351f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * variants. 352f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik */ 353051910b9f998030dacb8a0722588cc715813fde1Raph Levien public static final int ALL_SAVE_FLAG = 0x1F; 354051910b9f998030dacb8a0722588cc715813fde1Raph Levien 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 356f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Saves the current matrix and clip onto a private stack. 357f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p> 358f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Subsequent calls to translate,scale,rotate,skew,concat or clipRect, 359f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * clipPath will all operate as usual, but when the balancing call to 360f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * restore() is made, those calls will be forgotten, and the settings that 361f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * existed before the save() will be reinstated. 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The value to pass to restoreToCount() to balance this save() 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 36595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int save() { 36695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_save(mNativeCanvasWrapper, MATRIX_SAVE_FLAG | CLIP_SAVE_FLAG); 36795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 368051910b9f998030dacb8a0722588cc715813fde1Raph Levien 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Based on saveFlags, can save the current matrix and clip onto a private 371f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * stack. 372f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p class="note"><strong>Note:</strong> if possible, use the 373f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * parameter-less save(). It is simpler and faster than individually 374f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * disabling the saving of matrix or clip with this method. 375f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p> 376f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Subsequent calls to translate,scale,rotate,skew,concat or clipRect, 377f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * clipPath will all operate as usual, but when the balancing call to 378f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * restore() is made, those calls will be forgotten, and the settings that 379f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * existed before the save() will be reinstated. 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveFlags flag bits that specify which parts of the Canvas state 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to save/restore 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The value to pass to restoreToCount() to balance this save() 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 385ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int save(@Saveflags int saveFlags) { 38695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_save(mNativeCanvasWrapper, saveFlags); 38795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 390f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * This behaves the same as save(), but in addition it allocates and 391f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * redirects drawing to an offscreen bitmap. 392f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p class="note"><strong>Note:</strong> this method is very expensive, 393f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * incurring more than double rendering cost for contained content. Avoid 394f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * using this method, especially if the bounds provided are large, or if 395f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * the {@link #CLIP_TO_LAYER_SAVE_FLAG} is omitted from the 396f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * {@code saveFlags} parameter. It is recommended to use a 397f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * {@link android.view.View#LAYER_TYPE_HARDWARE hardware layer} on a View 398f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * to apply an xfermode, color filter, or alpha, as it will perform much 399f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * better than this method. 400f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p> 401f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * All drawing calls are directed to a newly allocated offscreen bitmap. 402f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Only when the balancing call to restore() is made, is that offscreen 403f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * buffer drawn back to the current target of the Canvas (either the 404f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * screen, it's target Bitmap, or the previous layer). 405f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p> 406f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Attributes of the Paint - {@link Paint#getAlpha() alpha}, 407f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * {@link Paint#getXfermode() Xfermode}, and 408f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * {@link Paint#getColorFilter() ColorFilter} are applied when the 409f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * offscreen bitmap is drawn back when restore() is called. 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. 415f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * @param saveFlags see _SAVE_FLAG constants, generally {@link #ALL_SAVE_FLAG} is recommended 416f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * for performance reasons. 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return value to pass to restoreToCount() to balance this save() 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 419ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int saveLayer(@Nullable RectF bounds, @Nullable Paint paint, @Saveflags int saveFlags) { 4209bc13a353fa8fac323839268789ef661b219530cChris Craik if (bounds == null) { 4219bc13a353fa8fac323839268789ef661b219530cChris Craik bounds = new RectF(getClipBounds()); 4229bc13a353fa8fac323839268789ef661b219530cChris Craik } 4239bc13a353fa8fac323839268789ef661b219530cChris Craik return saveLayer(bounds.left, bounds.top, bounds.right, bounds.bottom, paint, saveFlags); 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 425c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 426c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 427c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Convenience for saveLayer(bounds, paint, {@link #ALL_SAVE_FLAG}) 428c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 429ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int saveLayer(@Nullable RectF bounds, @Nullable Paint paint) { 430c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayer(bounds, paint, ALL_SAVE_FLAG); 431c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 432c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper version of saveLayer() that takes 4 values rather than a RectF. 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 436ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int saveLayer(float left, float top, float right, float bottom, @Nullable Paint paint, 437ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Saveflags int saveFlags) { 4385c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_saveLayer(mNativeCanvasWrapper, left, top, right, bottom, 439dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint != null ? paint.getNativeInstance() : 0, 440f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy saveFlags); 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 444c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Convenience for saveLayer(left, top, right, bottom, paint, {@link #ALL_SAVE_FLAG}) 445c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 446ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int saveLayer(float left, float top, float right, float bottom, @Nullable Paint paint) { 447c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayer(left, top, right, bottom, paint, ALL_SAVE_FLAG); 448c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 449c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 450c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 451f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * This behaves the same as save(), but in addition it allocates and 452f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * redirects drawing to an offscreen bitmap. 453f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p class="note"><strong>Note:</strong> this method is very expensive, 454f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * incurring more than double rendering cost for contained content. Avoid 455f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * using this method, especially if the bounds provided are large, or if 456f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * the {@link #CLIP_TO_LAYER_SAVE_FLAG} is omitted from the 457f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * {@code saveFlags} parameter. It is recommended to use a 458f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * {@link android.view.View#LAYER_TYPE_HARDWARE hardware layer} on a View 459f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * to apply an xfermode, color filter, or alpha, as it will perform much 460f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * better than this method. 461f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p> 462f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * All drawing calls are directed to a newly allocated offscreen bitmap. 463f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Only when the balancing call to restore() is made, is that offscreen 464f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * buffer drawn back to the current target of the Canvas (either the 465f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * screen, it's target Bitmap, or the previous layer). 466f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p> 467f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * The {@code alpha} parameter is applied when the offscreen bitmap is 468f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * drawn back when restore() is called. 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds The maximum size the offscreen bitmap needs to be 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (in local coordinates) 4720d3d1f825f399c62f2ba236b53bef17581e03a16Sungsoo Lim * @param alpha The alpha to apply to the offscreen when it is 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawn during restore() 474f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * @param saveFlags see _SAVE_FLAG constants, generally {@link #ALL_SAVE_FLAG} is recommended 475f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * for performance reasons. 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return value to pass to restoreToCount() to balance this call 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4789bc13a353fa8fac323839268789ef661b219530cChris Craik public int saveLayerAlpha(@Nullable RectF bounds, int alpha, @Saveflags int saveFlags) { 4799bc13a353fa8fac323839268789ef661b219530cChris Craik if (bounds == null) { 4809bc13a353fa8fac323839268789ef661b219530cChris Craik bounds = new RectF(getClipBounds()); 4819bc13a353fa8fac323839268789ef661b219530cChris Craik } 4829bc13a353fa8fac323839268789ef661b219530cChris Craik return saveLayerAlpha(bounds.left, bounds.top, bounds.right, bounds.bottom, alpha, saveFlags); 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 484c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 485c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 486c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Convenience for saveLayerAlpha(bounds, alpha, {@link #ALL_SAVE_FLAG}) 487c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 4889bc13a353fa8fac323839268789ef661b219530cChris Craik public int saveLayerAlpha(@Nullable RectF bounds, int alpha) { 489c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayerAlpha(bounds, alpha, ALL_SAVE_FLAG); 490c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 491c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for saveLayerAlpha() that takes 4 values instead of a RectF. 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 495f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public int saveLayerAlpha(float left, float top, float right, float bottom, int alpha, 496ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Saveflags int saveFlags) { 4979bc13a353fa8fac323839268789ef661b219530cChris Craik alpha = Math.min(255, Math.max(0, alpha)); 4985c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_saveLayerAlpha(mNativeCanvasWrapper, left, top, right, bottom, 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project alpha, saveFlags); 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 503c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Helper for saveLayerAlpha(left, top, right, bottom, alpha, {@link #ALL_SAVE_FLAG}) 504c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 505c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik public int saveLayerAlpha(float left, float top, float right, float bottom, int alpha) { 506c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayerAlpha(left, top, right, bottom, alpha, ALL_SAVE_FLAG); 507c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 508c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 509c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This call balances a previous call to save(), and is used to remove all 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * modifications to the matrix/clip state since the last save call. It is 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an error to call restore() more times than save() was called. 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 51495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void restore() { 5153891f3ad598561d5a82c07795e1fee7f1d3612d1Chris Craik boolean throwOnUnderflow = !sCompatibilityRestore || !isHardwareAccelerated(); 5163891f3ad598561d5a82c07795e1fee7f1d3612d1Chris Craik native_restore(mNativeCanvasWrapper, throwOnUnderflow); 51795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the number of matrix/clip states on the Canvas' private stack. 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This will equal # save() calls - # restore() calls. 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 52395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int getSaveCount() { 52495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_getSaveCount(mNativeCanvasWrapper); 52595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Efficient way to pop any calls to save() that happened after the save 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * count reached saveCount. It is an error for saveCount to be less than 1. 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Example: 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * int count = canvas.save(); 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ... // more calls potentially to save() 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * canvas.restoreToCount(count); 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * // now the canvas is back in the same state it was before the initial 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * // call to save(). 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveCount The save level to restore to. 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 54095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void restoreToCount(int saveCount) { 5413891f3ad598561d5a82c07795e1fee7f1d3612d1Chris Craik boolean throwOnUnderflow = !sCompatibilityRestore || !isHardwareAccelerated(); 5423891f3ad598561d5a82c07795e1fee7f1d3612d1Chris Craik native_restoreToCount(mNativeCanvasWrapper, saveCount, throwOnUnderflow); 54395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified translation 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dx The distance to translate in X 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dy The distance to translate in Y 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 55195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void translate(float dx, float dy) { 55295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_translate(mNativeCanvasWrapper, dx, dy); 55395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified scale. 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to scale in X 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to scale in Y 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 56195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void scale(float sx, float sy) { 56295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_scale(mNativeCanvasWrapper, sx, sy); 56395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified scale. 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to scale in X 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to scale in Y 570cc3ec6cdb2b892eb29513e72d8b205acbe997b25Gilles Debunne * @param px The x-coord for the pivot point (unchanged by the scale) 571cc3ec6cdb2b892eb29513e72d8b205acbe997b25Gilles Debunne * @param py The y-coord for the pivot point (unchanged by the scale) 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void scale(float sx, float sy, float px, float py) { 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(px, py); 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project scale(sx, sy); 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(-px, -py); 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified rotation. 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param degrees The amount to rotate, in degrees 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 58495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void rotate(float degrees) { 58595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_rotate(mNativeCanvasWrapper, degrees); 58695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified rotation. 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param degrees The amount to rotate, in degrees 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param px The x-coord for the pivot point (unchanged by the rotation) 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param py The y-coord for the pivot point (unchanged by the rotation) 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void rotate(float degrees, float px, float py) { 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(px, py); 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project rotate(degrees); 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(-px, -py); 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified skew. 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to skew in X 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to skew in Y 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 60795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void skew(float sx, float sy) { 60895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_skew(mNativeCanvasWrapper, sx, sy); 60995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6124e7b772b733593fbe25c733e95b8dcea293234b6Romain Guy * Preconcat the current matrix with the specified matrix. If the specified 6134e7b772b733593fbe25c733e95b8dcea293234b6Romain Guy * matrix is null, this method does nothing. 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix to preconcatenate with the current matrix 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 617ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void concat(@Nullable Matrix matrix) { 6185c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita if (matrix != null) native_concat(mNativeCanvasWrapper, matrix.native_instance); 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 620051910b9f998030dacb8a0722588cc715813fde1Raph Levien 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Completely replace the current matrix with the specified matrix. If the 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * matrix parameter is null, then the current matrix is reset to identity. 624051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 625f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * <strong>Note:</strong> it is recommended to use {@link #concat(Matrix)}, 626f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * {@link #scale(float, float)}, {@link #translate(float, float)} and 627f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * {@link #rotate(float)} instead of this method. 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix to replace the current matrix with. If it is 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * null, set the current matrix to identity. 631051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 632051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @see #concat(Matrix) 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 634ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void setMatrix(@Nullable Matrix matrix) { 6355c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_setMatrix(mNativeCanvasWrapper, 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project matrix == null ? 0 : matrix.native_instance); 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 638051910b9f998030dacb8a0722588cc715813fde1Raph Levien 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return, in ctm, the current transformation matrix. This does not alter 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the matrix in the canvas, but just returns a copy of it. 642eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * 643eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * @deprecated {@link #isHardwareAccelerated() Hardware accelerated} canvases may have any 644eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * matrix when passed to a View or Drawable, as it is implementation defined where in the 645eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * hierarchy such canvases are created. It is recommended in such cases to either draw contents 646eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * irrespective of the current matrix, or to track relevant transform state outside of the 647eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * canvas. 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 649f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 650ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void getMatrix(@NonNull Matrix ctm) { 6515c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_getCTM(mNativeCanvasWrapper, ctm.native_instance); 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 65341030da16856c8869e1e51d4a0405432fa96614eRomain Guy 65441030da16856c8869e1e51d4a0405432fa96614eRomain Guy /** 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a new matrix with a copy of the canvas' current transformation 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * matrix. 657eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * 658eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * @deprecated {@link #isHardwareAccelerated() Hardware accelerated} canvases may have any 659eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * matrix when passed to a View or Drawable, as it is implementation defined where in the 660eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * hierarchy such canvases are created. It is recommended in such cases to either draw contents 661eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * irrespective of the current matrix, or to track relevant transform state outside of the 662eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * canvas. 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 66465447287cb4112cf74483c87be70bcd00b622e2dRomain Guy @Deprecated 665ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public final @NonNull Matrix getMatrix() { 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Matrix m = new Matrix(); 667f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy //noinspection deprecation 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getMatrix(m); 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return m; 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 671051910b9f998030dacb8a0722588cc715813fde1Raph Levien 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle. 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rect to intersect with the current clip 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 679ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRect(@NonNull RectF rect, @NonNull Region.Op op) { 6805c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom, 681f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy op.nativeInt); 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle, which is 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 692ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRect(@NonNull Rect rect, @NonNull Region.Op op) { 6935c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom, 694f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy op.nativeInt); 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 704ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRect(@NonNull RectF rect) { 70595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_clipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom, 70695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita Region.Op.INTERSECT.nativeInt); 70795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 70895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 716ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRect(@NonNull Rect rect) { 71795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_clipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom, 71895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita Region.Op.INTERSECT.nativeInt); 71995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 720051910b9f998030dacb8a0722588cc715813fde1Raph Levien 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle, which is 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 736ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRect(float left, float top, float right, float bottom, 737ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Region.Op op) { 7385c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipRect(mNativeCanvasWrapper, left, top, right, bottom, op.nativeInt); 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current clip 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 75495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public boolean clipRect(float left, float top, float right, float bottom) { 75595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_clipRect(mNativeCanvasWrapper, left, top, right, bottom, 75695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita Region.Op.INTERSECT.nativeInt); 75795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 758f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current clip 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 77295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public boolean clipRect(int left, int top, int right, int bottom) { 77395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_clipRect(mNativeCanvasWrapper, left, top, right, bottom, 77495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita Region.Op.INTERSECT.nativeInt); 77595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 776f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified path. 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to operate on the current clip 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 784ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipPath(@NonNull Path path, @NonNull Region.Op op) { 7855c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipPath(mNativeCanvasWrapper, path.ni(), op.nativeInt); 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 787051910b9f998030dacb8a0722588cc715813fde1Raph Levien 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified path. 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to intersect with the current clip 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 794ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipPath(@NonNull Path path) { 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return clipPath(path, Region.Op.INTERSECT); 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 797051910b9f998030dacb8a0722588cc715813fde1Raph Levien 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified region. Note that unlike 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect() and clipPath() which transform their arguments by the 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, clipRegion() assumes its argument is already in the 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinate system of the current layer's bitmap, and so not 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * transformation is performed. 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param region The region to operate on the current clip, based on op 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 8080d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * 8090d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * @deprecated Unlike all other clip calls this API does not respect the 8100d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * current matrix. Use {@link #clipRect(Rect)} as an alternative. 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 812eda57925cafdf1dab451e70052dea27846f368b4Chris Craik @Deprecated 813ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRegion(@NonNull Region region, @NonNull Region.Op op) { 8145c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipRegion(mNativeCanvasWrapper, region.ni(), op.nativeInt); 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified region. Note that unlike 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect() and clipPath() which transform their arguments by the 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, clipRegion() assumes its argument is already in the 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinate system of the current layer's bitmap, and so not 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * transformation is performed. 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param region The region to operate on the current clip, based on op 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 8260d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * 8270d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * @deprecated Unlike all other clip calls this API does not respect the 8280d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * current matrix. Use {@link #clipRect(Rect)} as an alternative. 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 830eda57925cafdf1dab451e70052dea27846f368b4Chris Craik @Deprecated 831ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRegion(@NonNull Region region) { 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return clipRegion(region, Region.Op.INTERSECT); 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 834051910b9f998030dacb8a0722588cc715813fde1Raph Levien 835ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public @Nullable DrawFilter getDrawFilter() { 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mDrawFilter; 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 838051910b9f998030dacb8a0722588cc715813fde1Raph Levien 839ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void setDrawFilter(@Nullable DrawFilter filter) { 84036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeFilter = 0; 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (filter != null) { 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeFilter = filter.mNativeInt; 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDrawFilter = filter; 8455c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita nativeSetDrawFilter(mNativeCanvasWrapper, nativeFilter); 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum EdgeType { 849d320001807168f5565bab9807ef13c111096bbb3Chet Haase 850d320001807168f5565bab9807ef13c111096bbb3Chet Haase /** 851d320001807168f5565bab9807ef13c111096bbb3Chet Haase * Black-and-White: Treat edges by just rounding to nearest pixel boundary 852d320001807168f5565bab9807ef13c111096bbb3Chet Haase */ 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project BW(0), //!< treat edges by just rounding to nearest pixel boundary 854d320001807168f5565bab9807ef13c111096bbb3Chet Haase 855d320001807168f5565bab9807ef13c111096bbb3Chet Haase /** 856d320001807168f5565bab9807ef13c111096bbb3Chet Haase * Antialiased: Treat edges by rounding-out, since they may be antialiased 857d320001807168f5565bab9807ef13c111096bbb3Chet Haase */ 858d320001807168f5565bab9807ef13c111096bbb3Chet Haase AA(1); 859051910b9f998030dacb8a0722588cc715813fde1Raph Levien 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EdgeType(int nativeInt) { 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = nativeInt; 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 863c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy 864c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy /** 865c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy * @hide 866c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy */ 867c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy public final int nativeInt; 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified rectangle, after being transformed by the 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect the rect to compare with the current clip 877d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 878d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 879d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the rect (transformed by the canvas' matrix) 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 883ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean quickReject(@NonNull RectF rect, @NonNull EdgeType type) { 88495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_quickReject(mNativeCanvasWrapper, 88595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita rect.left, rect.top, rect.right, rect.bottom); 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified path, after being transformed by the 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). Note: for speed it may 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * return false even if the path itself might not intersect the clip 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (i.e. the bounds of the path intersects, but the path does not). 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to compare with the current clip 897d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 898d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 899d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the path (transformed by the canvas' matrix) 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 903ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean quickReject(@NonNull Path path, @NonNull EdgeType type) { 9045c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_quickReject(mNativeCanvasWrapper, path.ni()); 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified rectangle, after being transformed by the 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to compare with the 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to compare with the current 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to compare with the 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to compare with the 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 921d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 922d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 923d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the rect (transformed by the canvas' matrix) 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 927ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger public boolean quickReject(float left, float top, float right, float bottom, 928ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull EdgeType type) { 9295c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_quickReject(mNativeCanvasWrapper, left, top, right, bottom); 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 933708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * Return the bounds of the current clip (in local coordinates) in the 934708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * bounds parameter, and return true if it is non-empty. This can be useful 935708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * in a way similar to quickReject, in that it tells you that drawing 936708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * outside of these bounds will be clipped out. 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds Return the clip bounds here. If it is null, ignore it but 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * still return true if the current clip is non-empty. 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the current clip is non-empty. 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 942ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean getClipBounds(@Nullable Rect bounds) { 9435c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_getClipBounds(mNativeCanvasWrapper, bounds); 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 945051910b9f998030dacb8a0722588cc715813fde1Raph Levien 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 947708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * Retrieve the bounds of the current clip (in local coordinates). 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the clip bounds, or [0, 0, 0, 0] if the clip is empty. 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 951ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public final @NonNull Rect getClipBounds() { 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect r = new Rect(); 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getClipBounds(r); 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return r; 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 956051910b9f998030dacb8a0722588cc715813fde1Raph Levien 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified RGB color, using srcover porterduff mode. 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r red component (0..255) of the color to draw onto the canvas 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param g green component (0..255) of the color to draw onto the canvas 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param b blue component (0..255) of the color to draw onto the canvas 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRGB(int r, int g, int b) { 9668872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger drawColor(Color.rgb(r, g, b)); 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified ARGB color, using srcover porterduff mode. 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param a alpha component (0..255) of the color to draw onto the canvas 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r red component (0..255) of the color to draw onto the canvas 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param g green component (0..255) of the color to draw onto the canvas 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param b blue component (0..255) of the color to draw onto the canvas 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawARGB(int a, int r, int g, int b) { 9798872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger drawColor(Color.argb(a, r, g, b)); 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified color, using srcover porterduff mode. 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param color the color to draw onto the canvas 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 98880756e38882720860db52f1fcc21fa1505a02abfTor Norbye public void drawColor(@ColorInt int color) { 9898872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger native_drawColor(mNativeCanvasWrapper, color, PorterDuff.Mode.SRC_OVER.nativeInt); 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified color and porter-duff xfermode. 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param color the color to draw with 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode the porter-duff mode to apply to the color 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 99980756e38882720860db52f1fcc21fa1505a02abfTor Norbye public void drawColor(@ColorInt int color, @NonNull PorterDuff.Mode mode) { 10005c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawColor(mNativeCanvasWrapper, color, mode.nativeInt); 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified paint. This is equivalent (but faster) to drawing an 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * infinitely large rectangle with the specified paint. 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw onto the canvas 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1010ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPaint(@NonNull Paint paint) { 1011dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger native_drawPaint(mNativeCanvasWrapper, paint.getNativeInstance()); 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1013051910b9f998030dacb8a0722588cc715813fde1Raph Levien 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a series of points. Each point is centered at the coordinate 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified by pts[], and its diameter is specified by the paint's stroke 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * width (as transformed by the canvas' CTM), with special treatment for 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a stroke width of 0, which always draws exactly 1 pixel (or at most 4 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if antialiasing is enabled). The shape of the point is controlled by 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the paint's Cap type. The shape is a square, unless the cap type is 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Round, in which case the shape is a circle. 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pts Array of points to draw [x0 y0 x1 y1 x2 y2 ...] 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Number of values to skip before starting to draw. 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of values to process, after skipping offset 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of them. Since one point uses two values, the number of 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * "points" that are drawn is really (count >> 1). 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the points 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1030b3ec733bb830f2d4425825d93f9ed95f284e9145Tor Norbye public void drawPoints(@Size(multiple=2) float[] pts, int offset, int count, 1031b3ec733bb830f2d4425825d93f9ed95f284e9145Tor Norbye @NonNull Paint paint) { 1032dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger native_drawPoints(mNativeCanvasWrapper, pts, offset, count, paint.getNativeInstance()); 103395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 10349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for drawPoints() that assumes you want to draw the entire array 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1038b3ec733bb830f2d4425825d93f9ed95f284e9145Tor Norbye public void drawPoints(@Size(multiple=2) @NonNull float[] pts, @NonNull Paint paint) { 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPoints(pts, 0, pts.length, paint); 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for drawPoints() for drawing a single point. 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1045ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPoint(float x, float y, @NonNull Paint paint) { 1046dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger native_drawPoint(mNativeCanvasWrapper, x, y, paint.getNativeInstance()); 104795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a line segment with the specified start and stop x,y coordinates, 1051a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * using the specified paint. 1052a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * 1053a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * <p>Note that since a line is always "framed", the Style is ignored in the paint.</p> 1054a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * 1055a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * <p>Degenerate lines (length is 0) will not be drawn.</p> 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startX The x-coordinate of the start point of the line 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startY The y-coordinate of the start point of the line 10599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the line 10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1061ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawLine(float startX, float startY, float stopX, float stopY, 1062ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 1063dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger native_drawLine(mNativeCanvasWrapper, startX, startY, stopX, stopY, paint.getNativeInstance()); 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a series of lines. Each line is taken from 4 consecutive values 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the pts array. Thus to draw 1 line, the array must contain at least 4 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * values. This is logically the same as drawing the array as follows: 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawLine(pts[0], pts[1], pts[2], pts[3]) followed by 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawLine(pts[4], pts[5], pts[6], pts[7]) and so on. 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pts Array of points to draw [x0 y0 x1 y1 x2 y2 ...] 10749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Number of values in the array to skip before drawing. 10759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of values in the array to process, after 10769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * skipping "offset" of them. Since each line uses 4 values, 10779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the number of "lines" that are drawn is really 10789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (count >> 2). 10799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the points 10809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 108192c11864c7b4901db90f88ec025d9a773454e7f6Chris Craik public void drawLines(@Size(multiple=4) @NonNull float[] pts, int offset, int count, 108292c11864c7b4901db90f88ec025d9a773454e7f6Chris Craik @NonNull Paint paint) { 1083dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger native_drawLines(mNativeCanvasWrapper, pts, offset, count, paint.getNativeInstance()); 108495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 10859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 108692c11864c7b4901db90f88ec025d9a773454e7f6Chris Craik public void drawLines(@Size(multiple=4) @NonNull float[] pts, @NonNull Paint paint) { 10879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawLines(pts, 0, pts.length, paint); 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified paint. The rectangle will 10929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be filled or framed based on the Style in the paint. 10939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rect to be drawn 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rect 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1097ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawRect(@NonNull RectF rect, @NonNull Paint paint) { 109895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_drawRect(mNativeCanvasWrapper, 1099dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger rect.left, rect.top, rect.right, rect.bottom, paint.getNativeInstance()); 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified Paint. The rectangle 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be filled or framed based on the Style in the paint. 11059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r The rectangle to be drawn. 11079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rectangle 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1109ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawRect(@NonNull Rect r, @NonNull Paint paint) { 11109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawRect(r.left, r.top, r.right, r.bottom, paint); 11119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1112051910b9f998030dacb8a0722588cc715813fde1Raph Levien 11139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified paint. The rectangle will 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be filled or framed based on the Style in the paint. 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to be drawn 11199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top side of the rectangle to be drawn 11209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to be drawn 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom side of the rectangle to be drawn 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rect 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1124ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawRect(float left, float top, float right, float bottom, @NonNull Paint paint) { 1125dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger native_drawRect(mNativeCanvasWrapper, left, top, right, bottom, paint.getNativeInstance()); 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified oval using the specified paint. The oval will be 11309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * filled or framed based on the Style in the paint. 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param oval The rectangle bounds of the oval to be drawn 11339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1134ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawOval(@NonNull RectF oval, @NonNull Paint paint) { 11359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (oval == null) { 11369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 113824609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese drawOval(oval.left, oval.top, oval.right, oval.bottom, paint); 113924609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese } 114024609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese 114124609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese /** 114224609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * Draw the specified oval using the specified paint. The oval will be 114324609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * filled or framed based on the Style in the paint. 114424609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese */ 114524609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese public void drawOval(float left, float top, float right, float bottom, @NonNull Paint paint) { 1146dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger native_drawOval(mNativeCanvasWrapper, left, top, right, bottom, paint.getNativeInstance()); 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified circle using the specified paint. If radius is <= 0, 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then nothing will be drawn. The circle will be filled or framed based 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on the Style in the paint. 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cx The x-coordinate of the center of the cirle to be drawn 11559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cy The y-coordinate of the center of the cirle to be drawn 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param radius The radius of the cirle to be drawn 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the circle 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1159ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawCircle(float cx, float cy, float radius, @NonNull Paint paint) { 1160dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger native_drawCircle(mNativeCanvasWrapper, cx, cy, radius, paint.getNativeInstance()); 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11644a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>Draw the specified arc, which will be scaled to fit inside the 11654a317db43d2bbc992284dd1f651751f13734d017Romain Guy * specified oval.</p> 1166051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 11674a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>If the start angle is negative or >= 360, the start angle is treated 11684a317db43d2bbc992284dd1f651751f13734d017Romain Guy * as start angle modulo 360.</p> 1169051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 11704a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>If the sweep angle is >= 360, then the oval is drawn 11719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completely. Note that this differs slightly from SkPath::arcTo, which 11724a317db43d2bbc992284dd1f651751f13734d017Romain Guy * treats the sweep angle modulo 360. If the sweep angle is negative, 11734a317db43d2bbc992284dd1f651751f13734d017Romain Guy * the sweep angle is treated as sweep angle modulo 360</p> 1174051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 11754a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>The arc is drawn clockwise. An angle of 0 degrees correspond to the 11764a317db43d2bbc992284dd1f651751f13734d017Romain Guy * geometric angle of 0 degrees (3 o'clock on a watch.)</p> 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param oval The bounds of oval used to define the shape and size 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the arc 11809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startAngle Starting angle (in degrees) where the arc begins 11819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sweepAngle Sweep angle (in degrees) measured clockwise 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param useCenter If true, include the center of the oval in the arc, and 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project close it if it is being stroked. This will draw a wedge 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the arc 11859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1186ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawArc(@NonNull RectF oval, float startAngle, float sweepAngle, boolean useCenter, 1187ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 118824609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese drawArc(oval.left, oval.top, oval.right, oval.bottom, startAngle, sweepAngle, useCenter, 118924609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese paint); 119024609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese } 119124609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese 119224609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese /** 119324609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * <p>Draw the specified arc, which will be scaled to fit inside the 119424609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * specified oval.</p> 119524609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * 119624609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * <p>If the start angle is negative or >= 360, the start angle is treated 119724609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * as start angle modulo 360.</p> 119824609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * 119924609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * <p>If the sweep angle is >= 360, then the oval is drawn 120024609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * completely. Note that this differs slightly from SkPath::arcTo, which 120124609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * treats the sweep angle modulo 360. If the sweep angle is negative, 120224609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * the sweep angle is treated as sweep angle modulo 360</p> 120324609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * 120424609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * <p>The arc is drawn clockwise. An angle of 0 degrees correspond to the 120524609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * geometric angle of 0 degrees (3 o'clock on a watch.)</p> 120624609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * 120724609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * @param startAngle Starting angle (in degrees) where the arc begins 120824609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * @param sweepAngle Sweep angle (in degrees) measured clockwise 120924609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * @param useCenter If true, include the center of the oval in the arc, and 121024609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese close it if it is being stroked. This will draw a wedge 121124609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * @param paint The paint used to draw the arc 121224609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese */ 121324609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese public void drawArc(float left, float top, float right, float bottom, float startAngle, 121424609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese float sweepAngle, boolean useCenter, @NonNull Paint paint) { 121524609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese native_drawArc(mNativeCanvasWrapper, left, top, right, bottom, startAngle, sweepAngle, 1216dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger useCenter, paint.getNativeInstance()); 12179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified round-rect using the specified paint. The roundrect 12219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be filled or framed based on the Style in the paint. 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangular bounds of the roundRect to be drawn 12249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rx The x-radius of the oval used to round the corners 12259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param ry The y-radius of the oval used to round the corners 12269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the roundRect 12279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1228ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawRoundRect(@NonNull RectF rect, float rx, float ry, @NonNull Paint paint) { 12294d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik drawRoundRect(rect.left, rect.top, rect.right, rect.bottom, rx, ry, paint); 12304d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik } 12314d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik 12324d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik /** 12334d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * Draw the specified round-rect using the specified paint. The roundrect 12344d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * will be filled or framed based on the Style in the paint. 12354d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * 12364d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * @param rx The x-radius of the oval used to round the corners 12374d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * @param ry The y-radius of the oval used to round the corners 12384d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * @param paint The paint used to draw the roundRect 12394d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik */ 12404d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik public void drawRoundRect(float left, float top, float right, float bottom, float rx, float ry, 1241ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 1242dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger native_drawRoundRect(mNativeCanvasWrapper, left, top, right, bottom, rx, ry, paint.getNativeInstance()); 12439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified path using the specified paint. The path will be 12479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * filled or framed based on the Style in the paint. 12489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to be drawn 12509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the path 12519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1252ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPath(@NonNull Path path, @NonNull Paint paint) { 125394394b3fb048d5349a77b57950ab7f6b6e92ce34Derek Sollenberger if (path.isSimplePath && path.rects != null) { 125494394b3fb048d5349a77b57950ab7f6b6e92ce34Derek Sollenberger native_drawRegion(mNativeCanvasWrapper, path.rects.mNativeRegion, paint.getNativeInstance()); 125594394b3fb048d5349a77b57950ab7f6b6e92ce34Derek Sollenberger } else { 125694394b3fb048d5349a77b57950ab7f6b6e92ce34Derek Sollenberger native_drawPath(mNativeCanvasWrapper, path.ni(), paint.getNativeInstance()); 125794394b3fb048d5349a77b57950ab7f6b6e92ce34Derek Sollenberger } 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12591abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik 12601abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik /** 12611abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * @hide 12621abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik */ 12631abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik protected static void throwIfCannotDraw(Bitmap bitmap) { 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bitmap.isRecycled()) { 1265f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy throw new RuntimeException("Canvas: trying to use a recycled bitmap " + bitmap); 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12671abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik if (!bitmap.isPremultiplied() && bitmap.getConfig() == Bitmap.Config.ARGB_8888 && 12681abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik bitmap.hasAlpha()) { 12691abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throw new RuntimeException("Canvas: trying to use a non-premultiplied bitmap " 12701abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik + bitmap); 12711abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik } 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1275deba785f122a47915756ffd991f5540d952cf937Romain Guy * Draws the specified bitmap as an N-patch (most often, a 9-patches.) 1276deba785f122a47915756ffd991f5540d952cf937Romain Guy * 12773b748a44c6bd2ea05fe16839caf73dbe50bd7ae9Romain Guy * @param patch The ninepatch object to render 1278deba785f122a47915756ffd991f5540d952cf937Romain Guy * @param dst The destination rectangle. 1279deba785f122a47915756ffd991f5540d952cf937Romain Guy * @param paint The paint to draw the bitmap with. may be null 1280051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 1281deba785f122a47915756ffd991f5540d952cf937Romain Guy * @hide 1282deba785f122a47915756ffd991f5540d952cf937Romain Guy */ 1283ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPatch(@NonNull NinePatch patch, @NonNull Rect dst, @Nullable Paint paint) { 12844c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger Bitmap bitmap = patch.getBitmap(); 12854c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger throwIfCannotDraw(bitmap); 12864c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger final long nativePaint = paint == null ? 0 : paint.getNativeInstance(); 12874c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger native_drawNinePatch(mNativeCanvasWrapper, bitmap.getNativeInstance(), patch.mNativeChunk, 12884c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger dst.left, dst.top, dst.right, dst.bottom, nativePaint, 12894c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger mDensity, patch.getDensity()); 1290f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy } 1291f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy 1292f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy /** 1293f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * Draws the specified bitmap as an N-patch (most often, a 9-patches.) 1294f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * 1295f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @param patch The ninepatch object to render 1296f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @param dst The destination rectangle. 1297f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @param paint The paint to draw the bitmap with. may be null 1298f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * 1299f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @hide 1300f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy */ 1301ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPatch(@NonNull NinePatch patch, @NonNull RectF dst, @Nullable Paint paint) { 13024c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger Bitmap bitmap = patch.getBitmap(); 13034c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger throwIfCannotDraw(bitmap); 13044c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger final long nativePaint = paint == null ? 0 : paint.getNativeInstance(); 13054c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger native_drawNinePatch(mNativeCanvasWrapper, bitmap.getNativeInstance(), patch.mNativeChunk, 13064c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger dst.left, dst.top, dst.right, dst.bottom, nativePaint, 13074c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger mDensity, patch.getDensity()); 1308f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy } 1309f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy 1310deba785f122a47915756ffd991f5540d952cf937Romain Guy /** 13119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, with its top/left corner at (x,y), using 13129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified paint, transformed by the current matrix. 1313051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 131411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 13159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 13169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 13179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 13189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 13199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 132011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>If the bitmap and canvas have different densities, this function 132111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * will take care of automatically scaling the bitmap to draw at the 132211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * same density as the canvas. 1323051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 13259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The position of the left side of the bitmap being drawn 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The position of the top side of the bitmap being drawn 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the bitmap (may be null) 13289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1329ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull Bitmap bitmap, float left, float top, @Nullable Paint paint) { 13301abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 13317c103a36f60b690e3fe83c40210e1cb0c76bba43John Reck native_drawBitmap(mNativeCanvasWrapper, bitmap, left, top, 1332dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint != null ? paint.getNativeInstance() : 0, mDensity, mScreenDensity, bitmap.mDensity); 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, scaling/translating automatically to fill 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the destination rectangle. If the source rectangle is not null, it 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specifies the subset of the bitmap to draw. 1339051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 134011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 134611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>This function <em>ignores the density associated with the bitmap</em>. 134711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * This is because the source and destination rectangle coordinate 134811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * spaces are in their respective densities, so must already have the 134911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * appropriate scaling factor applied. 1350051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 13519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param src May be null. The subset of the bitmap to be drawn 13539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dst The rectangle that the bitmap will be scaled/translated 13549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to fit into 13559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 13569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1357ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull Bitmap bitmap, @Nullable Rect src, @NonNull RectF dst, 1358ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Nullable Paint paint) { 13598872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger if (dst == null) { 13608872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger throw new NullPointerException(); 13618872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } 13628872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger throwIfCannotDraw(bitmap); 1363dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger final long nativePaint = paint == null ? 0 : paint.getNativeInstance(); 13648872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger 13658872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger float left, top, right, bottom; 13668872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger if (src == null) { 13678872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger left = top = 0; 13688872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger right = bitmap.getWidth(); 13698872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bottom = bitmap.getHeight(); 13708872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } else { 13718872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger left = src.left; 13728872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger right = src.right; 13738872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger top = src.top; 13748872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bottom = src.bottom; 13758872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } 13768872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger 13777c103a36f60b690e3fe83c40210e1cb0c76bba43John Reck native_drawBitmap(mNativeCanvasWrapper, bitmap, left, top, right, bottom, 13788872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger dst.left, dst.top, dst.right, dst.bottom, nativePaint, mScreenDensity, 13798872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bitmap.mDensity); 13808872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } 13819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, scaling/translating automatically to fill 13849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the destination rectangle. If the source rectangle is not null, it 13859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specifies the subset of the bitmap to draw. 1386051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 138711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 13889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 13899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 13909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 13919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 13929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 139311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>This function <em>ignores the density associated with the bitmap</em>. 139411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * This is because the source and destination rectangle coordinate 139511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * spaces are in their respective densities, so must already have the 139611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * appropriate scaling factor applied. 1397051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 13999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param src May be null. The subset of the bitmap to be drawn 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dst The rectangle that the bitmap will be scaled/translated 14019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to fit into 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1404ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull Bitmap bitmap, @Nullable Rect src, @NonNull Rect dst, 1405ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Nullable Paint paint) { 14069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (dst == null) { 14079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 14089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14091abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 1410dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger final long nativePaint = paint == null ? 0 : paint.getNativeInstance(); 14118872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger 14128872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger int left, top, right, bottom; 14138872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger if (src == null) { 14148872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger left = top = 0; 14158872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger right = bitmap.getWidth(); 14168872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bottom = bitmap.getHeight(); 14178872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } else { 14188872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger left = src.left; 14198872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger right = src.right; 14208872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger top = src.top; 14218872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bottom = src.bottom; 14228872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } 14238872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger 14247c103a36f60b690e3fe83c40210e1cb0c76bba43John Reck native_drawBitmap(mNativeCanvasWrapper, bitmap, left, top, right, bottom, 14258872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger dst.left, dst.top, dst.right, dst.bottom, nativePaint, mScreenDensity, 14268872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bitmap.mDensity); 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1428051910b9f998030dacb8a0722588cc715813fde1Raph Levien 14299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Treat the specified array of colors as a bitmap, and draw it. This gives 14319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the same result as first creating a bitmap from the array, and then 14329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawing it, but this method avoids explicitly creating a bitmap object 14339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * which can be more efficient if the colors are changing often. 14349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors Array of colors representing the pixels of the bitmap 14369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Offset into the array of colors for the first pixel 143783d522290e56f614d0d9373d47c2b54b9e207795Brad Fitzpatrick * @param stride The number of colors in the array between rows (must be 14389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * >= width or <= -width). 14399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The X coordinate for where to draw the bitmap 14409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The Y coordinate for where to draw the bitmap 14419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The width of the bitmap 14429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The height of the bitmap 14439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hasAlpha True if the alpha channel of the colors contains valid 14449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * values. If false, the alpha byte is ignored (assumed to 14459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be 0xFF for every pixel). 14469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 1447cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * 1448cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * @deprecated Usage with a {@link #isHardwareAccelerated() hardware accelerated} canvas 1449cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * requires an internal copy of color buffer contents every time this method is called. Using a 1450cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * Bitmap avoids this copy, and allows the application to more explicitly control the lifetime 1451cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * and copies of pixel data. 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1453cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik @Deprecated 1454ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull int[] colors, int offset, int stride, float x, float y, 1455ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese int width, int height, boolean hasAlpha, @Nullable Paint paint) { 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // check for valid input 14579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width < 0) { 14589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("width must be >= 0"); 14599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (height < 0) { 14619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("height must be >= 0"); 14629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (Math.abs(stride) < width) { 14649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("abs(stride) must be >= width"); 14659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int lastScanline = offset + (height - 1) * stride; 14679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = colors.length; 14689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (offset < 0 || (offset + width > length) || lastScanline < 0 14699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (lastScanline + width > length)) { 14709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 14719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // quick escape if there's nothing to draw 14739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width == 0 || height == 0) { 14749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 14759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // punch down to native for the actual draw 14775c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawBitmap(mNativeCanvasWrapper, colors, offset, stride, x, y, width, height, hasAlpha, 1478dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint != null ? paint.getNativeInstance() : 0); 14799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1480cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik 1481cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik /** 1482cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * Legacy version of drawBitmap(int[] colors, ...) that took ints for x,y 1483cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * 1484cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * @deprecated Usage with a {@link #isHardwareAccelerated() hardware accelerated} canvas 1485cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * requires an internal copy of color buffer contents every time this method is called. Using a 1486cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * Bitmap avoids this copy, and allows the application to more explicitly control the lifetime 1487cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * and copies of pixel data. 14889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1489cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik @Deprecated 1490ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull int[] colors, int offset, int stride, int x, int y, 1491ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese int width, int height, boolean hasAlpha, @Nullable Paint paint) { 14929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // call through to the common float version 14939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawBitmap(colors, offset, stride, (float)x, (float)y, width, height, 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project hasAlpha, paint); 14959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1496cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik 14979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the bitmap using the specified matrix. 14999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to draw 15019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix used to transform the bitmap when it is drawn 15029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 15039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1504ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull Bitmap bitmap, @NonNull Matrix matrix, @Nullable Paint paint) { 15057c103a36f60b690e3fe83c40210e1cb0c76bba43John Reck nativeDrawBitmapMatrix(mNativeCanvasWrapper, bitmap, matrix.ni(), 1506dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint != null ? paint.getNativeInstance() : 0); 15079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15085a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy 15095a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy /** 15105a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy * @hide 15115a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy */ 15125a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy protected static void checkRange(int length, int offset, int count) { 15139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((offset | count) < 0 || offset + count > length) { 15149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 15159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1517051910b9f998030dacb8a0722588cc715813fde1Raph Levien 15189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the bitmap through the mesh, where mesh vertices are evenly 15209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed across the bitmap. There are meshWidth+1 vertices across, and 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * meshHeight+1 vertices down. The verts array is accessed in row-major 15229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * order, so that the first meshWidth+1 vertices are distributed across the 15239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * top of the bitmap from left to right. A more general version of this 15245d11676414b3606792e23c269cf75b44faa1a2afChris Craik * method is drawVertices(). 15259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to draw using the mesh 15279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param meshWidth The number of columns in the mesh. Nothing is drawn if 15289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this is 0 15299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param meshHeight The number of rows in the mesh. Nothing is drawn if 15309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this is 0 15319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param verts Array of x,y pairs, specifying where the mesh should be 15329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawn. There must be at least 15335d11676414b3606792e23c269cf75b44faa1a2afChris Craik * (meshWidth+1) * (meshHeight+1) * 2 + vertOffset values 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the array 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertOffset Number of verts elements to skip before drawing 15369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors May be null. Specifies a color at each vertex, which is 15379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * interpolated across the cell, and whose values are 15389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * multiplied by the corresponding bitmap colors. If not null, 15399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * there must be at least (meshWidth+1) * (meshHeight+1) + 15409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * colorOffset values in the array. 15419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colorOffset Number of color elements to skip before drawing 15429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 15439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1544ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmapMesh(@NonNull Bitmap bitmap, int meshWidth, int meshHeight, 1545ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull float[] verts, int vertOffset, @Nullable int[] colors, int colorOffset, 1546ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Nullable Paint paint) { 15479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((meshWidth | meshHeight | vertOffset | colorOffset) < 0) { 15489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 15499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (meshWidth == 0 || meshHeight == 0) { 15519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 15529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int count = (meshWidth + 1) * (meshHeight + 1); 15549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we mul by 2 since we need two floats per vertex 15559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(verts.length, vertOffset, count * 2); 15569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (colors != null) { 15579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // no mul by 2, since we need only 1 color per vertex 15589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(colors.length, colorOffset, count); 15599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15607c103a36f60b690e3fe83c40210e1cb0c76bba43John Reck nativeDrawBitmapMesh(mNativeCanvasWrapper, bitmap, meshWidth, meshHeight, 1561f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy verts, vertOffset, colors, colorOffset, 1562dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint != null ? paint.getNativeInstance() : 0); 15639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1564f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 15659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum VertexMode { 15669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLES(0), 15679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLE_STRIP(1), 15689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLE_FAN(2); 1569051910b9f998030dacb8a0722588cc715813fde1Raph Levien 15709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project VertexMode(int nativeInt) { 15719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = nativeInt; 15729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1573a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy 1574a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy /** 1575a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy * @hide 1576a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy */ 1577a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy public final int nativeInt; 15789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1579051910b9f998030dacb8a0722588cc715813fde1Raph Levien 15809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the array of vertices, interpreted as triangles (based on mode). The 15829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * verts array is required, and specifies the x,y pairs for each vertex. If 15839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * texs is non-null, then it is used to specify the coordinate in shader 15849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinates to use at each vertex (the paint must have a shader in this 15859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * case). If there is no texs array, but there is a color array, then each 15869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color is interpolated across its corresponding triangle in a gradient. If 15879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * both texs and colors arrays are present, then they behave as before, but 15889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the resulting color at each pixels is the result of multiplying the 15899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * colors from the shader and the color-gradient together. The indices array 15909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is optional, but if it is present, then it is used to specify the index 15919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of each triangle, rather than just walking through the arrays in order. 15929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode How to interpret the array of vertices 15949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertexCount The number of values in the vertices array (and 15959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * corresponding texs and colors arrays if non-null). Each logical 15969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex is two values (x, y), vertexCount must be a multiple of 2. 15979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param verts Array of vertices for the mesh 15989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertOffset Number of values in the verts to skip before drawing. 15999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param texs May be null. If not null, specifies the coordinates to sample 16009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * into the current shader (e.g. bitmap tile or gradient) 16019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param texOffset Number of values in texs to skip before drawing. 16029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors May be null. If not null, specifies a color for each 16039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex, to be interpolated across the triangle. 16049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colorOffset Number of values in colors to skip before drawing. 16059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param indices If not null, array of indices to reference into the 16069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex (texs, colors) array. 16079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param indexCount number of entries in the indices array (if not null). 1608051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @param paint Specifies the shader to use if the texs array is non-null. 16099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1610ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawVertices(@NonNull VertexMode mode, int vertexCount, @NonNull float[] verts, 1611ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese int vertOffset, @Nullable float[] texs, int texOffset, @Nullable int[] colors, 1612ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese int colorOffset, @Nullable short[] indices, int indexOffset, int indexCount, 1613ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 16149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(verts.length, vertOffset, vertexCount); 16158dfaa4904205772cdceee63ef3989bcdedf1a914Tom Hudson if (isHardwareAccelerated()) { 16168dfaa4904205772cdceee63ef3989bcdedf1a914Tom Hudson return; 16178dfaa4904205772cdceee63ef3989bcdedf1a914Tom Hudson } 16189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (texs != null) { 16199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(texs.length, texOffset, vertexCount); 16209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (colors != null) { 162292ce5734b52ef014c80cc6335112a027188b3eb6Erik Faye-Lund checkRange(colors.length, colorOffset, vertexCount / 2); 16239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (indices != null) { 16259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(indices.length, indexOffset, indexCount); 16269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16275c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita nativeDrawVertices(mNativeCanvasWrapper, mode.nativeInt, vertexCount, verts, 1628f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy vertOffset, texs, texOffset, colors, colorOffset, 1629dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger indices, indexOffset, indexCount, paint.getNativeInstance()); 16309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 163136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat 16329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. The 16349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin is interpreted based on the Align setting in the paint. 16359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 16379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 16385dc973cb03889c58988703b58aefbd2397fb02c3Alan Viverette * @param y The y-coordinate of the baseline of the text being drawn 16399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 16409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1641ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawText(@NonNull char[] text, int index, int count, float x, float y, 1642ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 16439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((index | count | (index + count) | 16449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project (text.length - index - count)) < 0) { 16459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 16469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16475c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, text, index, count, x, y, paint.mBidiFlags, 1648dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint.getNativeInstance(), paint.mNativeTypeface); 16499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. The 16539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin is interpreted based on the Align setting in the paint. 16549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 16569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 16575dc973cb03889c58988703b58aefbd2397fb02c3Alan Viverette * @param y The y-coordinate of the baseline of the text being drawn 16589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 16599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1660ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawText(@NonNull String text, float x, float y, @NonNull Paint paint) { 16615c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, text, 0, text.length(), x, y, paint.mBidiFlags, 1662dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint.getNativeInstance(), paint.mNativeTypeface); 1663f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 16649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. 16679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The origin is interpreted based on the Align setting in the paint. 16689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 16709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param start The index of the first character in text to draw 16719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param end (end - 1) is the index of the last character in text to draw 16729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 16735dc973cb03889c58988703b58aefbd2397fb02c3Alan Viverette * @param y The y-coordinate of the baseline of the text being drawn 16749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 16759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1676ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawText(@NonNull String text, int start, int end, float x, float y, 1677ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 16789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((start | end | (end - start) | (text.length() - end)) < 0) { 16799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 16809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16815c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, text, start, end, x, y, paint.mBidiFlags, 1682dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint.getNativeInstance(), paint.mNativeTypeface); 16839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified range of text, specified by start/end, with its 16879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin at (x,y), in the specified Paint. The origin is interpreted 16889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * based on the Align setting in the Paint. 16899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 16919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param start The index of the first character in text to draw 16929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param end (end - 1) is the index of the last character in text 16939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to draw 16949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of origin for where to draw the text 16959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of origin for where to draw the text 16969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 16979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1698ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawText(@NonNull CharSequence text, int start, int end, float x, float y, 1699ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 1700d82f8a9a3869448e6d7d4b3fc962e34e33a1ba0eRaph Levien if ((start | end | (end - start) | (text.length() - end)) < 0) { 1701d82f8a9a3869448e6d7d4b3fc962e34e33a1ba0eRaph Levien throw new IndexOutOfBoundsException(); 1702d82f8a9a3869448e6d7d4b3fc962e34e33a1ba0eRaph Levien } 17039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (text instanceof String || text instanceof SpannedString || 17049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project text instanceof SpannableString) { 17055c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, text.toString(), start, end, x, y, 1706dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint.mBidiFlags, paint.getNativeInstance(), paint.mNativeTypeface); 1707f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else if (text instanceof GraphicsOperations) { 17089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ((GraphicsOperations) text).drawText(this, start, end, x, y, 1709f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint); 1710f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else { 1711f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt char[] buf = TemporaryBuffer.obtain(end - start); 1712f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt TextUtils.getChars(text, start, end, buf, 0); 17135c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, buf, 0, end - start, x, y, 1714dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint.mBidiFlags, paint.getNativeInstance(), paint.mNativeTypeface); 1715f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt TemporaryBuffer.recycle(buf); 17169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1717f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1718f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1719f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1720c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * Draw a run of text, all in a single direction, with optional context for complex text 1721c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * shaping. 1722c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * 1723c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * <p>See {@link #drawTextRun(CharSequence, int, int, int, int, float, float, boolean, Paint)} 1724c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * for more details. This method uses a character array rather than CharSequence to 1725c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * represent the string. Also, to be consistent with the pattern established in 1726c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * {@link #drawText}, in this method {@code count} and {@code contextCount} are used rather 1727c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * than offsets of the end position; {@code count = end - start, contextCount = contextEnd - 1728c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * contextStart}. 1729051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 1730f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param text the text to render 17310c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param index the start of the text to render 17320c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param count the count of chars to render 17330c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param contextIndex the start of the context for shaping. Must be 17340c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * no greater than index. 17350c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param contextCount the number of characters in the context for shaping. 1736f2122ef549dd73f68bdbe4d6767f6516935024d0Keisuke Kuroyanagi * contexIndex + contextCount must be no less than index + count. 1737f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param x the x position at which to draw the text 1738f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param y the y position at which to draw the text 1739051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @param isRtl whether the run is in RTL direction 1740f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param paint the paint 1741f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt */ 1742ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawTextRun(@NonNull char[] text, int index, int count, int contextIndex, 1743051910b9f998030dacb8a0722588cc715813fde1Raph Levien int contextCount, float x, float y, boolean isRtl, @NonNull Paint paint) { 1744f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1745f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text == null) { 1746f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("text is null"); 1747f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1748f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (paint == null) { 1749f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("paint is null"); 1750f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1751f2122ef549dd73f68bdbe4d6767f6516935024d0Keisuke Kuroyanagi if ((index | count | contextIndex | contextCount | index - contextIndex 1752f2122ef549dd73f68bdbe4d6767f6516935024d0Keisuke Kuroyanagi | (contextIndex + contextCount) - (index + count) 1753f2122ef549dd73f68bdbe4d6767f6516935024d0Keisuke Kuroyanagi | text.length - (contextIndex + contextCount)) < 0) { 1754f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new IndexOutOfBoundsException(); 1755f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1756f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1757f2122ef549dd73f68bdbe4d6767f6516935024d0Keisuke Kuroyanagi native_drawTextRun(mNativeCanvasWrapper, text, index, count, contextIndex, contextCount, 1758f2122ef549dd73f68bdbe4d6767f6516935024d0Keisuke Kuroyanagi x, y, isRtl, paint.getNativeInstance(), paint.mNativeTypeface); 1759f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1760f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1761f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1762c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * Draw a run of text, all in a single direction, with optional context for complex text 1763c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * shaping. 1764c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * 1765c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * <p>The run of text includes the characters from {@code start} to {@code end} in the text. In 1766c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * addition, the range {@code contextStart} to {@code contextEnd} is used as context for the 1767c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * purpose of complex text shaping, such as Arabic text potentially shaped differently based on 1768c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * the text next to it. 1769c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * 1770c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * <p>All text outside the range {@code contextStart..contextEnd} is ignored. The text between 1771c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * {@code start} and {@code end} will be laid out and drawn. 1772c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * 1773c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * <p>The direction of the run is explicitly specified by {@code isRtl}. Thus, this method is 1774c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * suitable only for runs of a single direction. Alignment of the text is as determined by the 1775c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * Paint's TextAlign value. Further, {@code 0 <= contextStart <= start <= end <= contextEnd 1776c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * <= text.length} must hold on entry. 1777c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * 1778c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * <p>Also see {@link android.graphics.Paint#getRunAdvance} for a corresponding method to 1779c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * measure the text; the advance width of the text drawn matches the value obtained from that 1780c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * method. 17810c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * 1782f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param text the text to render 1783f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param start the start of the text to render. Data before this position 1784f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * can be used for shaping context. 1785f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param end the end of the text to render. Data at or after this 1786f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * position can be used for shaping context. 1787c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * @param contextStart the index of the start of the shaping context 1788c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * @param contextEnd the index of the end of the shaping context 1789f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param x the x position at which to draw the text 1790f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param y the y position at which to draw the text 1791051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @param isRtl whether the run is in RTL direction 1792f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param paint the paint 1793c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * 1794c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * @see #drawTextRun(char[], int, int, int, int, float, float, boolean, Paint) 1795f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt */ 1796ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawTextRun(@NonNull CharSequence text, int start, int end, int contextStart, 1797051910b9f998030dacb8a0722588cc715813fde1Raph Levien int contextEnd, float x, float y, boolean isRtl, @NonNull Paint paint) { 1798f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1799f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text == null) { 1800f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("text is null"); 1801f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1802f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (paint == null) { 1803f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("paint is null"); 1804f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1805f2122ef549dd73f68bdbe4d6767f6516935024d0Keisuke Kuroyanagi if ((start | end | contextStart | contextEnd | start - contextStart | end - start 1806f2122ef549dd73f68bdbe4d6767f6516935024d0Keisuke Kuroyanagi | contextEnd - end | text.length() - contextEnd) < 0) { 1807f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new IndexOutOfBoundsException(); 1808f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1809f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1810f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text instanceof String || text instanceof SpannedString || 1811f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt text instanceof SpannableString) { 1812f2122ef549dd73f68bdbe4d6767f6516935024d0Keisuke Kuroyanagi native_drawTextRun(mNativeCanvasWrapper, text.toString(), start, end, contextStart, 1813f2122ef549dd73f68bdbe4d6767f6516935024d0Keisuke Kuroyanagi contextEnd, x, y, isRtl, paint.getNativeInstance(), paint.mNativeTypeface); 1814f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else if (text instanceof GraphicsOperations) { 18150c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt ((GraphicsOperations) text).drawTextRun(this, start, end, 1816051910b9f998030dacb8a0722588cc715813fde1Raph Levien contextStart, contextEnd, x, y, isRtl, paint); 1817f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else { 18180c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int contextLen = contextEnd - contextStart; 18190c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int len = end - start; 18200c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt char[] buf = TemporaryBuffer.obtain(contextLen); 18210c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt TextUtils.getChars(text, contextStart, contextEnd, buf, 0); 18225c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawTextRun(mNativeCanvasWrapper, buf, start - contextStart, len, 1823dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger 0, contextLen, x, y, isRtl, paint.getNativeInstance(), paint.mNativeTypeface); 18249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TemporaryBuffer.recycle(buf); 18259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text in the array, with each character's origin specified by 18309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the pos array. 1831051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 18329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 18339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index The index of the first character to draw 18349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of characters to draw, starting from index. 18359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pos Array of [x,y] positions, used to position each 18369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * character 18379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 1838eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * 1839eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * @deprecated This method does not support glyph composition and decomposition and 1840eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * should therefore not be used to render complex scripts. It also doesn't 1841eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * handle supplementary characters (eg emoji). 18429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1843f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 1844b3ec733bb830f2d4425825d93f9ed95f284e9145Tor Norbye public void drawPosText(@NonNull char[] text, int index, int count, 1845b3ec733bb830f2d4425825d93f9ed95f284e9145Tor Norbye @NonNull @Size(multiple=2) float[] pos, 1846ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 18479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (index < 0 || index + count > text.length || count*2 > pos.length) { 18489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 18499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18503f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien for (int i = 0; i < count; i++) { 18513f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien drawText(text, index + i, 1, pos[i * 2], pos[i * 2 + 1], paint); 18523f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien } 18539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text in the array, with each character's origin specified by 18579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the pos array. 1858051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 18599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 18609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pos Array of [x,y] positions, used to position each character 18619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 1862eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * 1863eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * @deprecated This method does not support glyph composition and decomposition and 1864eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * should therefore not be used to render complex scripts. It also doesn't 1865eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * handle supplementary characters (eg emoji). 18669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1867f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 1868b3ec733bb830f2d4425825d93f9ed95f284e9145Tor Norbye public void drawPosText(@NonNull String text, @NonNull @Size(multiple=2) float[] pos, 1869b3ec733bb830f2d4425825d93f9ed95f284e9145Tor Norbye @NonNull Paint paint) { 18703f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien drawPosText(text.toCharArray(), 0, text.length(), pos, paint); 18719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint, along 18759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified path. The paint's Align setting determins where along the 18769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * path to start the text. 18779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 18799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path the text should follow for its baseline 18809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hOffset The distance along the path to add to the text's 18819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * starting position 18829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vOffset The distance above(-) or below(+) the path to position 18839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the text 18849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 18859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1886ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawTextOnPath(@NonNull char[] text, int index, int count, @NonNull Path path, 1887ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese float hOffset, float vOffset, @NonNull Paint paint) { 18889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (index < 0 || index + count > text.length) { 18899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 18909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18915c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawTextOnPath(mNativeCanvasWrapper, text, index, count, 1892f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy path.ni(), hOffset, vOffset, 1893dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint.mBidiFlags, paint.getNativeInstance(), paint.mNativeTypeface); 18949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint, along 18989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified path. The paint's Align setting determins where along the 18999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * path to start the text. 19009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 19019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 19029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path the text should follow for its baseline 19039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hOffset The distance along the path to add to the text's 19049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * starting position 19059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vOffset The distance above(-) or below(+) the path to position 19069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the text 19079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 19089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1909ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawTextOnPath(@NonNull String text, @NonNull Path path, float hOffset, 1910ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese float vOffset, @NonNull Paint paint) { 19119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (text.length() > 0) { 19125c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawTextOnPath(mNativeCanvasWrapper, text, path.ni(), hOffset, vOffset, 1913dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint.mBidiFlags, paint.getNativeInstance(), paint.mNativeTypeface); 19149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Save the canvas state, draw the picture, and restore the canvas state. 19199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This differs from picture.draw(canvas), which does not perform any 19209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * save/restore. 1921cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * 1922cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * <p> 1923cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * <strong>Note:</strong> This forces the picture to internally call 1924cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * {@link Picture#endRecording} in order to prepare for playback. 1925051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 19269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param picture The picture to be drawn 19279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1928ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPicture(@NonNull Picture picture) { 19299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project picture.endRecording(); 1930667fe1039feae068d3333de8fb7115313f4a517bJonathan Dixon int restoreCount = save(); 1931667fe1039feae068d3333de8fb7115313f4a517bJonathan Dixon picture.draw(this); 1932667fe1039feae068d3333de8fb7115313f4a517bJonathan Dixon restoreToCount(restoreCount); 19339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1934051910b9f998030dacb8a0722588cc715813fde1Raph Levien 19359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the picture, stretched to fit into the dst rectangle. 19379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1938ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPicture(@NonNull Picture picture, @NonNull RectF dst) { 19399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project save(); 19409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(dst.left, dst.top); 19419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (picture.getWidth() > 0 && picture.getHeight() > 0) { 1942f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy scale(dst.width() / picture.getWidth(), dst.height() / picture.getHeight()); 19439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPicture(picture); 19459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project restore(); 19469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1947051910b9f998030dacb8a0722588cc715813fde1Raph Levien 19489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the picture, stretched to fit into the dst rectangle. 19509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1951ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPicture(@NonNull Picture picture, @NonNull Rect dst) { 19529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project save(); 19539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(dst.left, dst.top); 19549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (picture.getWidth() > 0 && picture.getHeight() > 0) { 1955f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy scale((float) dst.width() / picture.getWidth(), 1956f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy (float) dst.height() / picture.getHeight()); 19579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPicture(picture); 19599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project restore(); 19609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1961da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy 1962da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy /** 1963ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov * Releases the resources associated with this canvas. 1964ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov * 1965ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov * @hide 1966ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov */ 1967ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov public void release() { 1968775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler mNativeCanvasWrapper = 0; 1969775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler if (mFinalizer != null) { 1970775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler mFinalizer.run(); 1971775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler mFinalizer = null; 1972775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler } 1973ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov } 1974ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 1975ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov /** 1976163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * Free up as much memory as possible from private caches (e.g. fonts, images) 1977caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed * 1978163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @hide 1979caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed */ 1980caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed public static native void freeCaches(); 1981caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed 198230ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio /** 198330ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * Free up text layout caches 198430ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * 198530ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * @hide 198630ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio */ 198730ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio public static native void freeTextLayoutCaches(); 198830ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio 1989c1b33d665c8caf5760f68c45c6ca0baa649b832aJohn Reck private static native long initRaster(Bitmap bitmap); 19905c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita private static native void native_setBitmap(long canvasHandle, 1991c1b33d665c8caf5760f68c45c6ca0baa649b832aJohn Reck Bitmap bitmap); 199295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native boolean native_isOpaque(long canvasHandle); 19936578a989566e585eee053095dc80e2552e125db2Derek Sollenberger private static native void native_setHighContrastText(long renderer, boolean highContrastText); 199495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native int native_getWidth(long canvasHandle); 199595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native int native_getHeight(long canvasHandle); 199695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita 199795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native int native_save(long canvasHandle, int saveFlags); 199836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native int native_saveLayer(long nativeCanvas, float l, 19999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float t, float r, float b, 200036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint, 200136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int layerFlags); 200236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native int native_saveLayerAlpha(long nativeCanvas, float l, 20039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float t, float r, float b, 20049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int alpha, int layerFlags); 20053891f3ad598561d5a82c07795e1fee7f1d3612d1Chris Craik private static native void native_restore(long canvasHandle, boolean tolerateUnderflow); 200695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_restoreToCount(long canvasHandle, 20073891f3ad598561d5a82c07795e1fee7f1d3612d1Chris Craik int saveCount, 20083891f3ad598561d5a82c07795e1fee7f1d3612d1Chris Craik boolean tolerateUnderflow); 200995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native int native_getSaveCount(long canvasHandle); 201095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita 201195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_translate(long canvasHandle, 201295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita float dx, float dy); 201395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_scale(long canvasHandle, 201495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita float sx, float sy); 201595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_rotate(long canvasHandle, float degrees); 201695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_skew(long canvasHandle, 201795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita float sx, float sy); 201836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_concat(long nativeCanvas, 201936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix); 202036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_setMatrix(long nativeCanvas, 202136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix); 202236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_clipRect(long nativeCanvas, 20239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 20249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float right, float bottom, 20259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 202636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_clipPath(long nativeCanvas, 202736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePath, 20289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 202936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_clipRegion(long nativeCanvas, 203036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeRegion, 20319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 203236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeSetDrawFilter(long nativeCanvas, 203336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeFilter); 203436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_getClipBounds(long nativeCanvas, 20359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect bounds); 203636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_getCTM(long nativeCanvas, 203736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix); 203836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_quickReject(long nativeCanvas, 203936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePath); 204036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_quickReject(long nativeCanvas, 20419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 2042ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger float right, float bottom); 204336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawColor(long nativeCanvas, int color, 20449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mode); 204536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawPaint(long nativeCanvas, 204636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 204795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_drawPoint(long canvasHandle, float x, float y, 204895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita long paintHandle); 204995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_drawPoints(long canvasHandle, float[] pts, 205095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita int offset, int count, 205195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita long paintHandle); 205236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawLine(long nativeCanvas, float startX, 20539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float startY, float stopX, 205436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float stopY, long nativePaint); 205595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_drawLines(long canvasHandle, float[] pts, 205695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita int offset, int count, 205795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita long paintHandle); 205836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawRect(long nativeCanvas, float left, 20599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float top, float right, 206036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float bottom, 206136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 206224609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese private static native void native_drawOval(long nativeCanvas, float left, float top, 206324609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese float right, float bottom, long nativePaint); 206436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawCircle(long nativeCanvas, float cx, 20659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float cy, float radius, 206636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 206724609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese private static native void native_drawArc(long nativeCanvas, float left, float top, 206824609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese float right, float bottom, 206924609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese float startAngle, float sweep, boolean useCenter, 207036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 207136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawRoundRect(long nativeCanvas, 20724d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik float left, float top, float right, float bottom, 20734d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik float rx, float ry, long nativePaint); 207436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawPath(long nativeCanvas, 207536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePath, 207636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 207794394b3fb048d5349a77b57950ab7f6b6e92ce34Derek Sollenberger private static native void native_drawRegion(long nativeCanvas, 207894394b3fb048d5349a77b57950ab7f6b6e92ce34Derek Sollenberger long nativeRegion, long nativePaint); 20794c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger private native void native_drawNinePatch(long nativeCanvas, long nativeBitmap, 20804c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger long ninePatch, float dstLeft, float dstTop, float dstRight, float dstBottom, 20814c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger long nativePaintOrZero, int screenDensity, int bitmapDensity); 20827c103a36f60b690e3fe83c40210e1cb0c76bba43John Reck private native void native_drawBitmap(long nativeCanvas, Bitmap bitmap, 20839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 208436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaintOrZero, 20850d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int canvasDensity, 20860d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int screenDensity, 20870d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int bitmapDensity); 20887c103a36f60b690e3fe83c40210e1cb0c76bba43John Reck private native void native_drawBitmap(long nativeCanvas, Bitmap bitmap, 20898872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger float srcLeft, float srcTop, float srcRight, float srcBottom, 20908872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger float dstLeft, float dstTop, float dstRight, float dstBottom, 20918872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger long nativePaintOrZero, int screenDensity, int bitmapDensity); 209236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawBitmap(long nativeCanvas, int[] colors, 20939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offset, int stride, float x, 20949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float y, int width, int height, 20959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean hasAlpha, 209636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaintOrZero); 209736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeDrawBitmapMatrix(long nativeCanvas, 20987c103a36f60b690e3fe83c40210e1cb0c76bba43John Reck Bitmap bitmap, 209936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix, 210036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 210136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeDrawBitmapMesh(long nativeCanvas, 21027c103a36f60b690e3fe83c40210e1cb0c76bba43John Reck Bitmap bitmap, 21039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int meshWidth, int meshHeight, 21049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] verts, int vertOffset, 210536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int[] colors, int colorOffset, 210636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 210736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeDrawVertices(long nativeCanvas, int mode, int n, 21089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] verts, int vertOffset, float[] texs, int texOffset, 21099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] colors, int colorOffset, short[] indices, 211036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int indexOffset, int indexCount, long nativePaint); 211136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat 211236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawText(long nativeCanvas, char[] text, 21139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int index, int count, float x, 211436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float y, int flags, long nativePaint, 211536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeTypeface); 211636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawText(long nativeCanvas, String text, 21179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int start, int end, float x, 211836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float y, int flags, long nativePaint, 211936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeTypeface); 2120fcf2be1846935e7983ea2fe87fdd4d7af27764b6Fabrice Di Meglio 212136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextRun(long nativeCanvas, String text, 21220c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int start, int end, int contextStart, int contextEnd, 2123051910b9f998030dacb8a0722588cc715813fde1Raph Levien float x, float y, boolean isRtl, long nativePaint, long nativeTypeface); 2124f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 212536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextRun(long nativeCanvas, char[] text, 21260c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int start, int count, int contextStart, int contextCount, 2127051910b9f998030dacb8a0722588cc715813fde1Raph Levien float x, float y, boolean isRtl, long nativePaint, long nativeTypeface); 2128f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 212936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextOnPath(long nativeCanvas, 21309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char[] text, int index, 213136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int count, long nativePath, 21329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float hOffset, 2133da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio float vOffset, int bidiFlags, 21349d2b5e1930bfc4b1da1c865843c247c708ea1565Raph Levien long nativePaint, long nativeTypeface); 213536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextOnPath(long nativeCanvas, 213636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat String text, long nativePath, 213736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float hOffset, 213836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float vOffset, 21399d2b5e1930bfc4b1da1c865843c247c708ea1565Raph Levien int flags, long nativePaint, long nativeTypeface); 2140775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler private static native long getNativeFinalizer(); 21419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 2142