Canvas.java revision 8b9ed44f8d559be2590b25cb4b72d2aefd3b3784
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 94f6765f3965ce669458e0bb5d2e226d4233a1acb3Andreas Gampe // Use a Holder to allow static initialization of Canvas in the boot image. 95f6765f3965ce669458e0bb5d2e226d4233a1acb3Andreas Gampe private static class NoImagePreloadHolder { 96f6765f3965ce669458e0bb5d2e226d4233a1acb3Andreas Gampe public static final NativeAllocationRegistry sRegistry = new NativeAllocationRegistry( 970ebdbb4a8470bb77f38c33a42c220ecb8a7adcc6Richard Uhler Canvas.class.getClassLoader(), getNativeFinalizer(), NATIVE_ALLOCATION_SIZE); 98f6765f3965ce669458e0bb5d2e226d4233a1acb3Andreas Gampe } 99ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 100775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler // This field is used to finalize the native Canvas properly 101775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler private Runnable mFinalizer; 102e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 103f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Construct an empty raster canvas. Use setBitmap() to specify a bitmap to 10596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * draw into. The initial target density is {@link Bitmap#DENSITY_NONE}; 10696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * this will typically be replaced when a target bitmap is set for the 10796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * canvas. 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Canvas() { 110003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy if (!isHardwareAccelerated()) { 111003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy // 0 means no native bitmap 112c1b33d665c8caf5760f68c45c6ca0baa649b832aJohn Reck mNativeCanvasWrapper = initRaster(null); 113f6765f3965ce669458e0bb5d2e226d4233a1acb3Andreas Gampe mFinalizer = NoImagePreloadHolder.sRegistry.registerNativeAllocation( 114f6765f3965ce669458e0bb5d2e226d4233a1acb3Andreas Gampe this, mNativeCanvasWrapper); 115003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy } else { 116003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy mFinalizer = null; 117003123004f7b23b3dc472d5c40b8c1a16df37a54Romain Guy } 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Construct a canvas with the specified bitmap to draw into. The bitmap 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * must be mutable. 123051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 12496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>The initial target density of the canvas is the same as the given 12596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * bitmap's density. 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap Specifies a mutable bitmap for the canvas to draw into. 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 129ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public Canvas(@NonNull Bitmap bitmap) { 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!bitmap.isMutable()) { 131f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy throw new IllegalStateException("Immutable bitmap passed to Canvas constructor"); 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1331abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 134c1b33d665c8caf5760f68c45c6ca0baa649b832aJohn Reck mNativeCanvasWrapper = initRaster(bitmap); 135f6765f3965ce669458e0bb5d2e226d4233a1acb3Andreas Gampe mFinalizer = NoImagePreloadHolder.sRegistry.registerNativeAllocation( 136f6765f3965ce669458e0bb5d2e226d4233a1acb3Andreas Gampe this, mNativeCanvasWrapper); 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBitmap = bitmap; 13896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn mDensity = bitmap.mDensity; 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 140ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 141ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov /** @hide */ 14236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat public Canvas(long nativeCanvas) { 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (nativeCanvas == 0) { 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(); 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1468872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger mNativeCanvasWrapper = nativeCanvas; 147f6765f3965ce669458e0bb5d2e226d4233a1acb3Andreas Gampe mFinalizer = NoImagePreloadHolder.sRegistry.registerNativeAllocation( 148f6765f3965ce669458e0bb5d2e226d4233a1acb3Andreas Gampe this, mNativeCanvasWrapper); 14996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn mDensity = Bitmap.getDefaultDensity(); 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 151163935113919a184122b8b3bd672ef08c8df65dcRomain Guy 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 153091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik * Returns null. 154c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * 155091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik * @deprecated This method is not supported and should not be invoked. 156c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * 157091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik * @hide 158091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik */ 159091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik @Deprecated 160091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik protected GL getGL() { 161091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik return null; 162091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik } 163091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik 164091ddb1374e3bcdac129c1df5ef2555cf5c2183eChris Craik /** 1652d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * Indicates whether this Canvas uses hardware acceleration. 166051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 1672d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * Note that this method does not define what type of hardware acceleration 1682d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * may or may not be used. 169051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 1702d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * @return True if drawing operations are hardware accelerated, 1712d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * false otherwise. 1722d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy */ 1732d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy public boolean isHardwareAccelerated() { 174163935113919a184122b8b3bd672ef08c8df65dcRomain Guy return false; 175caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed } 176163935113919a184122b8b3bd672ef08c8df65dcRomain Guy 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 178051910b9f998030dacb8a0722588cc715813fde1Raph Levien * Specify a bitmap for the canvas to draw into. All canvas state such as 1793bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * layers, filters, and the save/restore stack are reset with the exception 1803bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * of the current matrix and clip stack. Additionally, as a side-effect 1813bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * the canvas' target density is updated to match that of the bitmap. 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap Specifies a mutable bitmap for the canvas to draw into. 18496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @see #setDensity(int) 18596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @see #getDensity() 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 187ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void setBitmap(@Nullable Bitmap bitmap) { 188163935113919a184122b8b3bd672ef08c8df65dcRomain Guy if (isHardwareAccelerated()) { 18996890564bdbd2f2a41dfc323fc8b3938fb335639Chris Craik throw new RuntimeException("Can't set a bitmap device on a HW accelerated canvas"); 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 192fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger if (bitmap == null) { 193c1b33d665c8caf5760f68c45c6ca0baa649b832aJohn Reck native_setBitmap(mNativeCanvasWrapper, null); 194fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger mDensity = Bitmap.DENSITY_NONE; 195fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger } else { 1960965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy if (!bitmap.isMutable()) { 1970965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy throw new IllegalStateException(); 1980965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy } 1991abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 200fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger 201c1b33d665c8caf5760f68c45c6ca0baa649b832aJohn Reck native_setBitmap(mNativeCanvasWrapper, bitmap); 2020965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy mDensity = bitmap.mDensity; 2030965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy } 2040965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBitmap = bitmap; 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 207c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 208cce47eb580d666ead1f6095d1e3b65233592bbaaChris Craik /** @hide */ 2096578a989566e585eee053095dc80e2552e125db2Derek Sollenberger public void setHighContrastText(boolean highContrastText) { 2106578a989566e585eee053095dc80e2552e125db2Derek Sollenberger native_setHighContrastText(mNativeCanvasWrapper, highContrastText); 2116578a989566e585eee053095dc80e2552e125db2Derek Sollenberger } 212cce47eb580d666ead1f6095d1e3b65233592bbaaChris Craik 2138afd0f245cc0c4a0366f39f41b5f78e47ee83be3Chris Craik /** @hide */ 2148afd0f245cc0c4a0366f39f41b5f78e47ee83be3Chris Craik public void insertReorderBarrier() {} 2158afd0f245cc0c4a0366f39f41b5f78e47ee83be3Chris Craik 2168afd0f245cc0c4a0366f39f41b5f78e47ee83be3Chris Craik /** @hide */ 2178afd0f245cc0c4a0366f39f41b5f78e47ee83be3Chris Craik public void insertInorderBarrier() {} 2188afd0f245cc0c4a0366f39f41b5f78e47ee83be3Chris Craik 219797b95b26bbb7557678af78b9a2a61830158920fChris Craik /** 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the device that the current layer draws into is opaque 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (i.e. does not support per-pixel alpha). 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the device that the current layer draws into is opaque 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 22595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public boolean isOpaque() { 22695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_isOpaque(mNativeCanvasWrapper); 22795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the width of the current drawing layer 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the width of the current drawing layer 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 23495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int getWidth() { 23595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_getWidth(mNativeCanvasWrapper); 23695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the height of the current drawing layer 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the height of the current drawing layer 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 24395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int getHeight() { 24495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_getHeight(mNativeCanvasWrapper); 24595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 24896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>Returns the target density of the canvas. The default density is 24996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * derived from the density of its backing bitmap, or 25096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * {@link Bitmap#DENSITY_NONE} if there is not one.</p> 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 25296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @return Returns the current target density of the canvas, which is used 25396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * to determine the scaling factor when drawing a bitmap into it. 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 25511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #setDensity(int) 256051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @see Bitmap#getDensity() 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 25811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getDensity() { 25911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return mDensity; 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 26396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>Specifies the density for this Canvas' backing bitmap. This modifies 26496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * the target density of the canvas itself, as well as the density of its 26596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * backing bitmap via {@link Bitmap#setDensity(int) Bitmap.setDensity(int)}. 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 26796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @param density The new target density of the canvas, which is used 26896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * to determine the scaling factor when drawing a bitmap into it. Use 26996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * {@link Bitmap#DENSITY_NONE} to disable bitmap scaling. 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 27111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #getDensity() 272051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @see Bitmap#setDensity(int) 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 27411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public void setDensity(int density) { 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mBitmap != null) { 27611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn mBitmap.setDensity(density); 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 27811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn mDensity = density; 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2810d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn /** @hide */ 2820d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn public void setScreenDensity(int density) { 2830d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn mScreenDensity = density; 2840d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn } 285f61970fc79e9c5cf340fa942597628242361864aRomain Guy 286f61970fc79e9c5cf340fa942597628242361864aRomain Guy /** 287f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Returns the maximum allowed width for bitmaps drawn with this canvas. 288f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Attempting to draw with a bitmap wider than this value will result 289f61970fc79e9c5cf340fa942597628242361864aRomain Guy * in an error. 290051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 291051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @see #getMaximumBitmapHeight() 292f61970fc79e9c5cf340fa942597628242361864aRomain Guy */ 293f61970fc79e9c5cf340fa942597628242361864aRomain Guy public int getMaximumBitmapWidth() { 294f61970fc79e9c5cf340fa942597628242361864aRomain Guy return MAXMIMUM_BITMAP_SIZE; 295f61970fc79e9c5cf340fa942597628242361864aRomain Guy } 296051910b9f998030dacb8a0722588cc715813fde1Raph Levien 297f61970fc79e9c5cf340fa942597628242361864aRomain Guy /** 298f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Returns the maximum allowed height for bitmaps drawn with this canvas. 299f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Attempting to draw with a bitmap taller than this value will result 300f61970fc79e9c5cf340fa942597628242361864aRomain Guy * in an error. 301051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 302051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @see #getMaximumBitmapWidth() 303f61970fc79e9c5cf340fa942597628242361864aRomain Guy */ 304f61970fc79e9c5cf340fa942597628242361864aRomain Guy public int getMaximumBitmapHeight() { 305f61970fc79e9c5cf340fa942597628242361864aRomain Guy return MAXMIMUM_BITMAP_SIZE; 306f61970fc79e9c5cf340fa942597628242361864aRomain Guy } 307f61970fc79e9c5cf340fa942597628242361864aRomain Guy 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // the SAVE_FLAG constants must match their native equivalents 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 310ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese /** @hide */ 311ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @IntDef(flag = true, 312ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese value = { 313ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese MATRIX_SAVE_FLAG, 314ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese CLIP_SAVE_FLAG, 315ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese HAS_ALPHA_LAYER_SAVE_FLAG, 316ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese FULL_COLOR_LAYER_SAVE_FLAG, 317ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese CLIP_TO_LAYER_SAVE_FLAG, 318ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese ALL_SAVE_FLAG 319ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese }) 320ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Retention(RetentionPolicy.SOURCE) 321ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public @interface Saveflags {} 322ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese 323f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik /** 324f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Restore the current matrix when restore() is called. 325f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik */ 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MATRIX_SAVE_FLAG = 0x01; 327f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik 328f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik /** 329f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Restore the current clip when restore() is called. 330f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik */ 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CLIP_SAVE_FLAG = 0x02; 332f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik 333f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik /** 334f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * The layer requires a per-pixel alpha channel. 335f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik */ 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int HAS_ALPHA_LAYER_SAVE_FLAG = 0x04; 337f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik 338f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik /** 339f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * The layer requires full 8-bit precision for each color channel. 340f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik */ 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FULL_COLOR_LAYER_SAVE_FLAG = 0x08; 342f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik 343f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik /** 344f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Clip drawing to the bounds of the offscreen layer, omit at your own peril. 345f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p class="note"><strong>Note:</strong> it is strongly recommended to not 346f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * omit this flag for any call to <code>saveLayer()</code> and 347f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <code>saveLayerAlpha()</code> variants. Not passing this flag generally 348f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * triggers extremely poor performance with hardware accelerated rendering. 349f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik */ 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CLIP_TO_LAYER_SAVE_FLAG = 0x10; 351f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik 352f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik /** 353f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Restore everything when restore() is called (standard save flags). 354f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p class="note"><strong>Note:</strong> for performance reasons, it is 355f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * strongly recommended to pass this - the complete set of flags - to any 356f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * call to <code>saveLayer()</code> and <code>saveLayerAlpha()</code> 357f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * variants. 358f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik */ 359051910b9f998030dacb8a0722588cc715813fde1Raph Levien public static final int ALL_SAVE_FLAG = 0x1F; 360051910b9f998030dacb8a0722588cc715813fde1Raph Levien 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 362f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Saves the current matrix and clip onto a private stack. 363f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p> 364f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Subsequent calls to translate,scale,rotate,skew,concat or clipRect, 365f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * clipPath will all operate as usual, but when the balancing call to 366f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * restore() is made, those calls will be forgotten, and the settings that 367f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * existed before the save() will be reinstated. 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The value to pass to restoreToCount() to balance this save() 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 37195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int save() { 37295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_save(mNativeCanvasWrapper, MATRIX_SAVE_FLAG | CLIP_SAVE_FLAG); 37395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 374051910b9f998030dacb8a0722588cc715813fde1Raph Levien 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Based on saveFlags, can save the current matrix and clip onto a private 377f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * stack. 378f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p class="note"><strong>Note:</strong> if possible, use the 379f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * parameter-less save(). It is simpler and faster than individually 380f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * disabling the saving of matrix or clip with this method. 381f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p> 382f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Subsequent calls to translate,scale,rotate,skew,concat or clipRect, 383f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * clipPath will all operate as usual, but when the balancing call to 384f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * restore() is made, those calls will be forgotten, and the settings that 385f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * existed before the save() will be reinstated. 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveFlags flag bits that specify which parts of the Canvas state 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to save/restore 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The value to pass to restoreToCount() to balance this save() 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 391ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int save(@Saveflags int saveFlags) { 39295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_save(mNativeCanvasWrapper, saveFlags); 39395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 396f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * This behaves the same as save(), but in addition it allocates and 397f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * redirects drawing to an offscreen bitmap. 398f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p class="note"><strong>Note:</strong> this method is very expensive, 399f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * incurring more than double rendering cost for contained content. Avoid 400f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * using this method, especially if the bounds provided are large, or if 401f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * the {@link #CLIP_TO_LAYER_SAVE_FLAG} is omitted from the 402f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * {@code saveFlags} parameter. It is recommended to use a 403f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * {@link android.view.View#LAYER_TYPE_HARDWARE hardware layer} on a View 404f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * to apply an xfermode, color filter, or alpha, as it will perform much 405f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * better than this method. 406f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p> 407f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * All drawing calls are directed to a newly allocated offscreen bitmap. 408f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Only when the balancing call to restore() is made, is that offscreen 409f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * buffer drawn back to the current target of the Canvas (either the 410f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * screen, it's target Bitmap, or the previous layer). 411f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p> 412f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Attributes of the Paint - {@link Paint#getAlpha() alpha}, 413f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * {@link Paint#getXfermode() Xfermode}, and 414f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * {@link Paint#getColorFilter() ColorFilter} are applied when the 415f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * offscreen bitmap is drawn back when restore() is called. 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds May be null. The maximum size the offscreen bitmap 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * needs to be (in local coordinates) 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint This is copied, and is applied to the offscreen when 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * restore() is called. 421f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * @param saveFlags see _SAVE_FLAG constants, generally {@link #ALL_SAVE_FLAG} is recommended 422f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * for performance reasons. 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return value to pass to restoreToCount() to balance this save() 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 425ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int saveLayer(@Nullable RectF bounds, @Nullable Paint paint, @Saveflags int saveFlags) { 4269bc13a353fa8fac323839268789ef661b219530cChris Craik if (bounds == null) { 4279bc13a353fa8fac323839268789ef661b219530cChris Craik bounds = new RectF(getClipBounds()); 4289bc13a353fa8fac323839268789ef661b219530cChris Craik } 4299bc13a353fa8fac323839268789ef661b219530cChris Craik return saveLayer(bounds.left, bounds.top, bounds.right, bounds.bottom, paint, saveFlags); 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 431c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 432c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 433c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Convenience for saveLayer(bounds, paint, {@link #ALL_SAVE_FLAG}) 434c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 435ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int saveLayer(@Nullable RectF bounds, @Nullable Paint paint) { 436c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayer(bounds, paint, ALL_SAVE_FLAG); 437c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 438c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper version of saveLayer() that takes 4 values rather than a RectF. 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 442ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int saveLayer(float left, float top, float right, float bottom, @Nullable Paint paint, 443ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Saveflags int saveFlags) { 4445c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_saveLayer(mNativeCanvasWrapper, left, top, right, bottom, 445dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint != null ? paint.getNativeInstance() : 0, 446f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy saveFlags); 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 450c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Convenience for saveLayer(left, top, right, bottom, paint, {@link #ALL_SAVE_FLAG}) 451c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 452ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public int saveLayer(float left, float top, float right, float bottom, @Nullable Paint paint) { 453c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayer(left, top, right, bottom, paint, ALL_SAVE_FLAG); 454c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 455c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 456c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 457f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * This behaves the same as save(), but in addition it allocates and 458f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * redirects drawing to an offscreen bitmap. 459f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p class="note"><strong>Note:</strong> this method is very expensive, 460f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * incurring more than double rendering cost for contained content. Avoid 461f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * using this method, especially if the bounds provided are large, or if 462f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * the {@link #CLIP_TO_LAYER_SAVE_FLAG} is omitted from the 463f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * {@code saveFlags} parameter. It is recommended to use a 464f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * {@link android.view.View#LAYER_TYPE_HARDWARE hardware layer} on a View 465f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * to apply an xfermode, color filter, or alpha, as it will perform much 466f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * better than this method. 467f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p> 468f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * All drawing calls are directed to a newly allocated offscreen bitmap. 469f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * Only when the balancing call to restore() is made, is that offscreen 470f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * buffer drawn back to the current target of the Canvas (either the 471f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * screen, it's target Bitmap, or the previous layer). 472f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * <p> 473f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * The {@code alpha} parameter is applied when the offscreen bitmap is 474f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * drawn back when restore() is called. 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds The maximum size the offscreen bitmap needs to be 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (in local coordinates) 4780d3d1f825f399c62f2ba236b53bef17581e03a16Sungsoo Lim * @param alpha The alpha to apply to the offscreen when it is 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawn during restore() 480f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * @param saveFlags see _SAVE_FLAG constants, generally {@link #ALL_SAVE_FLAG} is recommended 481f37a364a530c5c055cf4634f0b0463454a252b0fChris Craik * for performance reasons. 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return value to pass to restoreToCount() to balance this call 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4849bc13a353fa8fac323839268789ef661b219530cChris Craik public int saveLayerAlpha(@Nullable RectF bounds, int alpha, @Saveflags int saveFlags) { 4859bc13a353fa8fac323839268789ef661b219530cChris Craik if (bounds == null) { 4869bc13a353fa8fac323839268789ef661b219530cChris Craik bounds = new RectF(getClipBounds()); 4879bc13a353fa8fac323839268789ef661b219530cChris Craik } 4889bc13a353fa8fac323839268789ef661b219530cChris Craik return saveLayerAlpha(bounds.left, bounds.top, bounds.right, bounds.bottom, alpha, saveFlags); 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 490c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 491c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 492c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Convenience for saveLayerAlpha(bounds, alpha, {@link #ALL_SAVE_FLAG}) 493c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 4949bc13a353fa8fac323839268789ef661b219530cChris Craik public int saveLayerAlpha(@Nullable RectF bounds, int alpha) { 495c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayerAlpha(bounds, alpha, ALL_SAVE_FLAG); 496c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 497c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for saveLayerAlpha() that takes 4 values instead of a RectF. 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 501f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public int saveLayerAlpha(float left, float top, float right, float bottom, int alpha, 502ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Saveflags int saveFlags) { 5039bc13a353fa8fac323839268789ef661b219530cChris Craik alpha = Math.min(255, Math.max(0, alpha)); 5045c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_saveLayerAlpha(mNativeCanvasWrapper, left, top, right, bottom, 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project alpha, saveFlags); 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 509c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik * Helper for saveLayerAlpha(left, top, right, bottom, alpha, {@link #ALL_SAVE_FLAG}) 510c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik */ 511c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik public int saveLayerAlpha(float left, float top, float right, float bottom, int alpha) { 512c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik return saveLayerAlpha(left, top, right, bottom, alpha, ALL_SAVE_FLAG); 513c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik } 514c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik 515c306ad61a791bae34ed83b339f27cb67a1d91b53Chris Craik /** 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This call balances a previous call to save(), and is used to remove all 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * modifications to the matrix/clip state since the last save call. It is 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an error to call restore() more times than save() was called. 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 52095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void restore() { 5213891f3ad598561d5a82c07795e1fee7f1d3612d1Chris Craik boolean throwOnUnderflow = !sCompatibilityRestore || !isHardwareAccelerated(); 5223891f3ad598561d5a82c07795e1fee7f1d3612d1Chris Craik native_restore(mNativeCanvasWrapper, throwOnUnderflow); 52395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the number of matrix/clip states on the Canvas' private stack. 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This will equal # save() calls - # restore() calls. 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 52995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public int getSaveCount() { 53095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_getSaveCount(mNativeCanvasWrapper); 53195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Efficient way to pop any calls to save() that happened after the save 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * count reached saveCount. It is an error for saveCount to be less than 1. 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Example: 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * int count = canvas.save(); 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ... // more calls potentially to save() 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * canvas.restoreToCount(count); 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * // now the canvas is back in the same state it was before the initial 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * // call to save(). 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveCount The save level to restore to. 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 54695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void restoreToCount(int saveCount) { 5473891f3ad598561d5a82c07795e1fee7f1d3612d1Chris Craik boolean throwOnUnderflow = !sCompatibilityRestore || !isHardwareAccelerated(); 5483891f3ad598561d5a82c07795e1fee7f1d3612d1Chris Craik native_restoreToCount(mNativeCanvasWrapper, saveCount, throwOnUnderflow); 54995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified translation 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dx The distance to translate in X 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dy The distance to translate in Y 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 55795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void translate(float dx, float dy) { 55841f864ec45c4fc5c490936fd145c4b087c076646John Reck if (dx == 0.0f && dy == 0.0f) return; 55995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_translate(mNativeCanvasWrapper, dx, dy); 56095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified scale. 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to scale in X 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to scale in Y 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 56895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void scale(float sx, float sy) { 56941f864ec45c4fc5c490936fd145c4b087c076646John Reck if (sx == 1.0f && sy == 1.0f) return; 57095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_scale(mNativeCanvasWrapper, sx, sy); 57195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified scale. 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to scale in X 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to scale in Y 578cc3ec6cdb2b892eb29513e72d8b205acbe997b25Gilles Debunne * @param px The x-coord for the pivot point (unchanged by the scale) 579cc3ec6cdb2b892eb29513e72d8b205acbe997b25Gilles Debunne * @param py The y-coord for the pivot point (unchanged by the scale) 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void scale(float sx, float sy, float px, float py) { 58241f864ec45c4fc5c490936fd145c4b087c076646John Reck if (sx == 1.0f && sy == 1.0f) return; 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(px, py); 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project scale(sx, sy); 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(-px, -py); 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 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 */ 59395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void rotate(float degrees) { 59441f864ec45c4fc5c490936fd145c4b087c076646John Reck if (degrees == 0.0f) return; 59595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_rotate(mNativeCanvasWrapper, degrees); 59695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified rotation. 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param degrees The amount to rotate, in degrees 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param px The x-coord for the pivot point (unchanged by the rotation) 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param py The y-coord for the pivot point (unchanged by the rotation) 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void rotate(float degrees, float px, float py) { 60641f864ec45c4fc5c490936fd145c4b087c076646John Reck if (degrees == 0.0f) return; 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(px, py); 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project rotate(degrees); 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(-px, -py); 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified skew. 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to skew in X 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to skew in Y 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 61895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public void skew(float sx, float sy) { 61941f864ec45c4fc5c490936fd145c4b087c076646John Reck if (sx == 0.0f && sy == 0.0f) return; 62095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_skew(mNativeCanvasWrapper, sx, sy); 62195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6244e7b772b733593fbe25c733e95b8dcea293234b6Romain Guy * Preconcat the current matrix with the specified matrix. If the specified 6254e7b772b733593fbe25c733e95b8dcea293234b6Romain Guy * matrix is null, this method does nothing. 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix to preconcatenate with the current matrix 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 629ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void concat(@Nullable Matrix matrix) { 6305c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita if (matrix != null) native_concat(mNativeCanvasWrapper, matrix.native_instance); 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 632051910b9f998030dacb8a0722588cc715813fde1Raph Levien 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Completely replace the current matrix with the specified matrix. If the 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * matrix parameter is null, then the current matrix is reset to identity. 636051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 637f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * <strong>Note:</strong> it is recommended to use {@link #concat(Matrix)}, 638f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * {@link #scale(float, float)}, {@link #translate(float, float)} and 639f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * {@link #rotate(float)} instead of this method. 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix to replace the current matrix with. If it is 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * null, set the current matrix to identity. 643051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 644051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @see #concat(Matrix) 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 646ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void setMatrix(@Nullable Matrix matrix) { 6475c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_setMatrix(mNativeCanvasWrapper, 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project matrix == null ? 0 : matrix.native_instance); 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 650051910b9f998030dacb8a0722588cc715813fde1Raph Levien 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return, in ctm, the current transformation matrix. This does not alter 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the matrix in the canvas, but just returns a copy of it. 654eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * 655eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * @deprecated {@link #isHardwareAccelerated() Hardware accelerated} canvases may have any 656eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * matrix when passed to a View or Drawable, as it is implementation defined where in the 657eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * hierarchy such canvases are created. It is recommended in such cases to either draw contents 658eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * irrespective of the current matrix, or to track relevant transform state outside of the 659eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * canvas. 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 661f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 662ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void getMatrix(@NonNull Matrix ctm) { 6635c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_getCTM(mNativeCanvasWrapper, ctm.native_instance); 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 66541030da16856c8869e1e51d4a0405432fa96614eRomain Guy 66641030da16856c8869e1e51d4a0405432fa96614eRomain Guy /** 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a new matrix with a copy of the canvas' current transformation 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * matrix. 669eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * 670eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * @deprecated {@link #isHardwareAccelerated() Hardware accelerated} canvases may have any 671eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * matrix when passed to a View or Drawable, as it is implementation defined where in the 672eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * hierarchy such canvases are created. It is recommended in such cases to either draw contents 673eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * irrespective of the current matrix, or to track relevant transform state outside of the 674eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * canvas. 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 67665447287cb4112cf74483c87be70bcd00b622e2dRomain Guy @Deprecated 677ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public final @NonNull Matrix getMatrix() { 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Matrix m = new Matrix(); 679f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy //noinspection deprecation 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getMatrix(m); 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return m; 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 683051910b9f998030dacb8a0722588cc715813fde1Raph Levien 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle. 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rect to intersect with the current clip 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 691ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRect(@NonNull RectF rect, @NonNull Region.Op op) { 6925c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom, 693f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy op.nativeInt); 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle, which is 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 704ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRect(@NonNull Rect rect, @NonNull Region.Op op) { 7055c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom, 706f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy op.nativeInt); 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 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 RectF rect) { 71795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_clipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom, 71895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita Region.Op.INTERSECT.nativeInt); 71995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 72095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect 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 rect The rectangle to intersect with the current clip. 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 728ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRect(@NonNull Rect rect) { 72995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_clipRect(mNativeCanvasWrapper, rect.left, rect.top, rect.right, rect.bottom, 73095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita Region.Op.INTERSECT.nativeInt); 73195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 732051910b9f998030dacb8a0722588cc715813fde1Raph Levien 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle, which is 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 748ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRect(float left, float top, float right, float bottom, 749ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Region.Op op) { 7505c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipRect(mNativeCanvasWrapper, left, top, right, bottom, op.nativeInt); 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current clip 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 76695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public boolean clipRect(float left, float top, float right, float bottom) { 76795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_clipRect(mNativeCanvasWrapper, left, top, right, bottom, 76895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita Region.Op.INTERSECT.nativeInt); 76995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 770f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current clip 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 78495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita public boolean clipRect(int left, int top, int right, int bottom) { 78595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_clipRect(mNativeCanvasWrapper, left, top, right, bottom, 78695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita Region.Op.INTERSECT.nativeInt); 78795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 788f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified path. 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to operate on the current clip 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 796ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipPath(@NonNull Path path, @NonNull Region.Op op) { 797a6a8557d6e6c8ecc170767b7552979dbdb4254efsergeyv return native_clipPath(mNativeCanvasWrapper, path.readOnlyNI(), op.nativeInt); 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 799051910b9f998030dacb8a0722588cc715813fde1Raph Levien 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified path. 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to intersect with the current clip 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 806ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipPath(@NonNull Path path) { 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return clipPath(path, Region.Op.INTERSECT); 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 809051910b9f998030dacb8a0722588cc715813fde1Raph Levien 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified region. Note that unlike 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect() and clipPath() which transform their arguments by the 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, clipRegion() assumes its argument is already in the 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinate system of the current layer's bitmap, and so not 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * transformation is performed. 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param region The region to operate on the current clip, based on op 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 8200d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * 8210d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * @deprecated Unlike all other clip calls this API does not respect the 8220d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * current matrix. Use {@link #clipRect(Rect)} as an alternative. 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 824eda57925cafdf1dab451e70052dea27846f368b4Chris Craik @Deprecated 825ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRegion(@NonNull Region region, @NonNull Region.Op op) { 8265c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_clipRegion(mNativeCanvasWrapper, region.ni(), op.nativeInt); 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified region. Note that unlike 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect() and clipPath() which transform their arguments by the 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, clipRegion() assumes its argument is already in the 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinate system of the current layer's bitmap, and so not 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * transformation is performed. 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param region The region to operate on the current clip, based on op 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 8380d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * 8390d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * @deprecated Unlike all other clip calls this API does not respect the 8400d181540e0c96da454f45e65987f690b27b929d9Derek Sollenberger * current matrix. Use {@link #clipRect(Rect)} as an alternative. 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 842eda57925cafdf1dab451e70052dea27846f368b4Chris Craik @Deprecated 843ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean clipRegion(@NonNull Region region) { 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return clipRegion(region, Region.Op.INTERSECT); 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 846051910b9f998030dacb8a0722588cc715813fde1Raph Levien 847ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public @Nullable DrawFilter getDrawFilter() { 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mDrawFilter; 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 850051910b9f998030dacb8a0722588cc715813fde1Raph Levien 851ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void setDrawFilter(@Nullable DrawFilter filter) { 85236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeFilter = 0; 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (filter != null) { 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeFilter = filter.mNativeInt; 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDrawFilter = filter; 8575c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita nativeSetDrawFilter(mNativeCanvasWrapper, nativeFilter); 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8608b9ed44f8d559be2590b25cb4b72d2aefd3b3784Chet Haase /** 8618b9ed44f8d559be2590b25cb4b72d2aefd3b3784Chet Haase * Constant values used as parameters to {@code quickReject()} calls. These values 8628b9ed44f8d559be2590b25cb4b72d2aefd3b3784Chet Haase * specify how much space around the shape should be accounted for, depending on whether 8638b9ed44f8d559be2590b25cb4b72d2aefd3b3784Chet Haase * the shaped area is antialiased or not. 8648b9ed44f8d559be2590b25cb4b72d2aefd3b3784Chet Haase * 8658b9ed44f8d559be2590b25cb4b72d2aefd3b3784Chet Haase * @see #quickReject(float, float, float, float, EdgeType) 8668b9ed44f8d559be2590b25cb4b72d2aefd3b3784Chet Haase * @see #quickReject(Path, EdgeType) 8678b9ed44f8d559be2590b25cb4b72d2aefd3b3784Chet Haase * @see #quickReject(RectF, EdgeType) 8688b9ed44f8d559be2590b25cb4b72d2aefd3b3784Chet Haase */ 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum EdgeType { 870d320001807168f5565bab9807ef13c111096bbb3Chet Haase 871d320001807168f5565bab9807ef13c111096bbb3Chet Haase /** 872d320001807168f5565bab9807ef13c111096bbb3Chet Haase * Black-and-White: Treat edges by just rounding to nearest pixel boundary 873d320001807168f5565bab9807ef13c111096bbb3Chet Haase */ 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project BW(0), //!< treat edges by just rounding to nearest pixel boundary 875d320001807168f5565bab9807ef13c111096bbb3Chet Haase 876d320001807168f5565bab9807ef13c111096bbb3Chet Haase /** 877d320001807168f5565bab9807ef13c111096bbb3Chet Haase * Antialiased: Treat edges by rounding-out, since they may be antialiased 878d320001807168f5565bab9807ef13c111096bbb3Chet Haase */ 879d320001807168f5565bab9807ef13c111096bbb3Chet Haase AA(1); 880051910b9f998030dacb8a0722588cc715813fde1Raph Levien 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EdgeType(int nativeInt) { 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = nativeInt; 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 884c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy 885c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy /** 886c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy * @hide 887c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy */ 888c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy public final int nativeInt; 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified rectangle, after being transformed by the 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect the rect to compare with the current clip 898d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 899d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 900d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the rect (transformed by the canvas' matrix) 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 904ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean quickReject(@NonNull RectF rect, @NonNull EdgeType type) { 90595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita return native_quickReject(mNativeCanvasWrapper, 90695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita rect.left, rect.top, rect.right, rect.bottom); 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified path, after being transformed by the 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). Note: for speed it may 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * return false even if the path itself might not intersect the clip 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (i.e. the bounds of the path intersects, but the path does not). 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to compare with the current clip 918d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 919d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 920d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the path (transformed by the canvas' matrix) 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 924ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean quickReject(@NonNull Path path, @NonNull EdgeType type) { 925a6a8557d6e6c8ecc170767b7552979dbdb4254efsergeyv return native_quickReject(mNativeCanvasWrapper, path.readOnlyNI()); 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified rectangle, after being transformed by the 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to compare with the 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to compare with the current 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to compare with the 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to compare with the 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 942d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 943d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 944d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the rect (transformed by the canvas' matrix) 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 948ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger public boolean quickReject(float left, float top, float right, float bottom, 949ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull EdgeType type) { 9505c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_quickReject(mNativeCanvasWrapper, left, top, right, bottom); 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 954708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * Return the bounds of the current clip (in local coordinates) in the 955708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * bounds parameter, and return true if it is non-empty. This can be useful 956708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * in a way similar to quickReject, in that it tells you that drawing 957708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * outside of these bounds will be clipped out. 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds Return the clip bounds here. If it is null, ignore it but 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * still return true if the current clip is non-empty. 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the current clip is non-empty. 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 963ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public boolean getClipBounds(@Nullable Rect bounds) { 9645c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita return native_getClipBounds(mNativeCanvasWrapper, bounds); 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 966051910b9f998030dacb8a0722588cc715813fde1Raph Levien 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 968708144e828b1a549567ce50cd8ed3cda62930501Derek Sollenberger * Retrieve the bounds of the current clip (in local coordinates). 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the clip bounds, or [0, 0, 0, 0] if the clip is empty. 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 972ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public final @NonNull Rect getClipBounds() { 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect r = new Rect(); 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getClipBounds(r); 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return r; 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 977051910b9f998030dacb8a0722588cc715813fde1Raph Levien 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified RGB color, using srcover porterduff mode. 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r red component (0..255) of the color to draw onto the canvas 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param g green component (0..255) of the color to draw onto the canvas 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param b blue component (0..255) of the color to draw onto the canvas 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRGB(int r, int g, int b) { 9878872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger drawColor(Color.rgb(r, g, b)); 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified ARGB color, using srcover porterduff mode. 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param a alpha component (0..255) of the color to draw onto the canvas 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r red component (0..255) of the color to draw onto the canvas 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param g green component (0..255) of the color to draw onto the canvas 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param b blue component (0..255) of the color to draw onto the canvas 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawARGB(int a, int r, int g, int b) { 10008872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger drawColor(Color.argb(a, r, g, b)); 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 the 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified color, using srcover porterduff mode. 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param color the color to draw onto the canvas 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 100980756e38882720860db52f1fcc21fa1505a02abfTor Norbye public void drawColor(@ColorInt int color) { 10108872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger native_drawColor(mNativeCanvasWrapper, color, PorterDuff.Mode.SRC_OVER.nativeInt); 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified color and porter-duff xfermode. 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param color the color to draw with 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode the porter-duff mode to apply to the color 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 102080756e38882720860db52f1fcc21fa1505a02abfTor Norbye public void drawColor(@ColorInt int color, @NonNull PorterDuff.Mode mode) { 10215c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawColor(mNativeCanvasWrapper, color, mode.nativeInt); 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified paint. This is equivalent (but faster) to drawing an 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * infinitely large rectangle with the specified paint. 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw onto the canvas 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1031ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPaint(@NonNull Paint paint) { 1032dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger native_drawPaint(mNativeCanvasWrapper, paint.getNativeInstance()); 10339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1034051910b9f998030dacb8a0722588cc715813fde1Raph Levien 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a series of points. Each point is centered at the coordinate 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified by pts[], and its diameter is specified by the paint's stroke 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * width (as transformed by the canvas' CTM), with special treatment for 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a stroke width of 0, which always draws exactly 1 pixel (or at most 4 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if antialiasing is enabled). The shape of the point is controlled by 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the paint's Cap type. The shape is a square, unless the cap type is 10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Round, in which case the shape is a circle. 10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pts Array of points to draw [x0 y0 x1 y1 x2 y2 ...] 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Number of values to skip before starting to draw. 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of values to process, after skipping offset 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of them. Since one point uses two values, the number of 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * "points" that are drawn is really (count >> 1). 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the points 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1051b3ec733bb830f2d4425825d93f9ed95f284e9145Tor Norbye public void drawPoints(@Size(multiple=2) float[] pts, int offset, int count, 1052b3ec733bb830f2d4425825d93f9ed95f284e9145Tor Norbye @NonNull Paint paint) { 1053dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger native_drawPoints(mNativeCanvasWrapper, pts, offset, count, paint.getNativeInstance()); 105495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 10559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for drawPoints() that assumes you want to draw the entire array 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1059b3ec733bb830f2d4425825d93f9ed95f284e9145Tor Norbye public void drawPoints(@Size(multiple=2) @NonNull float[] pts, @NonNull Paint paint) { 10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPoints(pts, 0, pts.length, paint); 10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for drawPoints() for drawing a single point. 10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1066ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPoint(float x, float y, @NonNull Paint paint) { 1067dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger native_drawPoint(mNativeCanvasWrapper, x, y, paint.getNativeInstance()); 106895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a line segment with the specified start and stop x,y coordinates, 1072a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * using the specified paint. 1073a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * 1074a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * <p>Note that since a line is always "framed", the Style is ignored in the paint.</p> 1075a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * 1076a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * <p>Degenerate lines (length is 0) will not be drawn.</p> 10779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startX The x-coordinate of the start point of the line 10799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startY The y-coordinate of the start point of the line 10809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the line 10819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1082ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawLine(float startX, float startY, float stopX, float stopY, 1083ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 1084dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger native_drawLine(mNativeCanvasWrapper, startX, startY, stopX, stopY, paint.getNativeInstance()); 10859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a series of lines. Each line is taken from 4 consecutive values 10899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the pts array. Thus to draw 1 line, the array must contain at least 4 10909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * values. This is logically the same as drawing the array as follows: 10919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawLine(pts[0], pts[1], pts[2], pts[3]) followed by 10929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawLine(pts[4], pts[5], pts[6], pts[7]) and so on. 10939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pts Array of points to draw [x0 y0 x1 y1 x2 y2 ...] 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Number of values in the array to skip before drawing. 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of values in the array to process, after 10979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * skipping "offset" of them. Since each line uses 4 values, 10989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the number of "lines" that are drawn is really 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (count >> 2). 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the points 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 110292c11864c7b4901db90f88ec025d9a773454e7f6Chris Craik public void drawLines(@Size(multiple=4) @NonNull float[] pts, int offset, int count, 110392c11864c7b4901db90f88ec025d9a773454e7f6Chris Craik @NonNull Paint paint) { 1104dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger native_drawLines(mNativeCanvasWrapper, pts, offset, count, paint.getNativeInstance()); 110595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita } 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 110792c11864c7b4901db90f88ec025d9a773454e7f6Chris Craik public void drawLines(@Size(multiple=4) @NonNull float[] pts, @NonNull Paint paint) { 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawLines(pts, 0, pts.length, paint); 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified paint. The rectangle will 11139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be filled or framed based on the Style in the paint. 11149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rect to be drawn 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rect 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1118ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawRect(@NonNull RectF rect, @NonNull Paint paint) { 111995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita native_drawRect(mNativeCanvasWrapper, 1120dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger rect.left, rect.top, rect.right, rect.bottom, paint.getNativeInstance()); 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified Paint. The rectangle 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be filled or framed based on the Style in the paint. 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r The rectangle to be drawn. 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rectangle 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1130ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawRect(@NonNull Rect r, @NonNull Paint paint) { 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawRect(r.left, r.top, r.right, r.bottom, paint); 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1133051910b9f998030dacb8a0722588cc715813fde1Raph Levien 11349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified paint. The rectangle will 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be filled or framed based on the Style in the paint. 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to be drawn 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top side of the rectangle to be drawn 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to be drawn 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom side of the rectangle to be drawn 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rect 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1145ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawRect(float left, float top, float right, float bottom, @NonNull Paint paint) { 1146dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger native_drawRect(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 oval using the specified paint. The oval will be 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * filled or framed based on the Style in the paint. 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param oval The rectangle bounds of the oval to be drawn 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1155ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawOval(@NonNull RectF oval, @NonNull Paint paint) { 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (oval == null) { 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 115924609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese drawOval(oval.left, oval.top, oval.right, oval.bottom, paint); 116024609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese } 116124609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese 116224609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese /** 116324609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * Draw the specified oval using the specified paint. The oval will be 116424609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * filled or framed based on the Style in the paint. 116524609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese */ 116624609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese public void drawOval(float left, float top, float right, float bottom, @NonNull Paint paint) { 1167dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger native_drawOval(mNativeCanvasWrapper, left, top, right, bottom, paint.getNativeInstance()); 11689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified circle using the specified paint. If radius is <= 0, 11729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then nothing will be drawn. The circle will be filled or framed based 11739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on the Style in the paint. 11749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cx The x-coordinate of the center of the cirle to be drawn 11769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cy The y-coordinate of the center of the cirle to be drawn 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param radius The radius of the cirle to be drawn 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the circle 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1180ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawCircle(float cx, float cy, float radius, @NonNull Paint paint) { 1181dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger native_drawCircle(mNativeCanvasWrapper, cx, cy, radius, paint.getNativeInstance()); 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11854a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>Draw the specified arc, which will be scaled to fit inside the 11864a317db43d2bbc992284dd1f651751f13734d017Romain Guy * specified oval.</p> 1187051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 11884a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>If the start angle is negative or >= 360, the start angle is treated 11894a317db43d2bbc992284dd1f651751f13734d017Romain Guy * as start angle modulo 360.</p> 1190051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 11914a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>If the sweep angle is >= 360, then the oval is drawn 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completely. Note that this differs slightly from SkPath::arcTo, which 11934a317db43d2bbc992284dd1f651751f13734d017Romain Guy * treats the sweep angle modulo 360. If the sweep angle is negative, 11944a317db43d2bbc992284dd1f651751f13734d017Romain Guy * the sweep angle is treated as sweep angle modulo 360</p> 1195051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 11964a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>The arc is drawn clockwise. An angle of 0 degrees correspond to the 11974a317db43d2bbc992284dd1f651751f13734d017Romain Guy * geometric angle of 0 degrees (3 o'clock on a watch.)</p> 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param oval The bounds of oval used to define the shape and size 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the arc 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startAngle Starting angle (in degrees) where the arc begins 12029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sweepAngle Sweep angle (in degrees) measured clockwise 12039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param useCenter If true, include the center of the oval in the arc, and 12049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project close it if it is being stroked. This will draw a wedge 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the arc 12069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1207ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawArc(@NonNull RectF oval, float startAngle, float sweepAngle, boolean useCenter, 1208ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 120924609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese drawArc(oval.left, oval.top, oval.right, oval.bottom, startAngle, sweepAngle, useCenter, 121024609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese paint); 121124609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese } 121224609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese 121324609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese /** 121424609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * <p>Draw the specified arc, which will be scaled to fit inside the 121524609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * specified oval.</p> 121624609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * 121724609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * <p>If the start angle is negative or >= 360, the start angle is treated 121824609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * as start angle modulo 360.</p> 121924609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * 122024609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * <p>If the sweep angle is >= 360, then the oval is drawn 122124609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * completely. Note that this differs slightly from SkPath::arcTo, which 122224609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * treats the sweep angle modulo 360. If the sweep angle is negative, 122324609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * the sweep angle is treated as sweep angle modulo 360</p> 122424609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * 122524609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * <p>The arc is drawn clockwise. An angle of 0 degrees correspond to the 122624609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * geometric angle of 0 degrees (3 o'clock on a watch.)</p> 122724609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * 122824609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * @param startAngle Starting angle (in degrees) where the arc begins 122924609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * @param sweepAngle Sweep angle (in degrees) measured clockwise 123024609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * @param useCenter If true, include the center of the oval in the arc, and 123124609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese close it if it is being stroked. This will draw a wedge 123224609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese * @param paint The paint used to draw the arc 123324609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese */ 123424609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese public void drawArc(float left, float top, float right, float bottom, float startAngle, 123524609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese float sweepAngle, boolean useCenter, @NonNull Paint paint) { 123624609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese native_drawArc(mNativeCanvasWrapper, left, top, right, bottom, startAngle, sweepAngle, 1237dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger useCenter, paint.getNativeInstance()); 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified round-rect using the specified paint. The roundrect 12429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be filled or framed based on the Style in the paint. 12439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangular bounds of the roundRect to be drawn 12459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rx The x-radius of the oval used to round the corners 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param ry The y-radius of the oval used to round the corners 12479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the roundRect 12489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1249ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawRoundRect(@NonNull RectF rect, float rx, float ry, @NonNull Paint paint) { 12504d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik drawRoundRect(rect.left, rect.top, rect.right, rect.bottom, rx, ry, paint); 12514d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik } 12524d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik 12534d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik /** 12544d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * Draw the specified round-rect using the specified paint. The roundrect 12554d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * will be filled or framed based on the Style in the paint. 12564d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * 12574d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * @param rx The x-radius of the oval used to round the corners 12584d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * @param ry The y-radius of the oval used to round the corners 12594d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik * @param paint The paint used to draw the roundRect 12604d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik */ 12614d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik public void drawRoundRect(float left, float top, float right, float bottom, float rx, float ry, 1262ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 1263dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger native_drawRoundRect(mNativeCanvasWrapper, left, top, right, bottom, rx, ry, paint.getNativeInstance()); 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified path using the specified paint. The path will be 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * filled or framed based on the Style in the paint. 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to be drawn 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the path 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1273ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPath(@NonNull Path path, @NonNull Paint paint) { 127494394b3fb048d5349a77b57950ab7f6b6e92ce34Derek Sollenberger if (path.isSimplePath && path.rects != null) { 127594394b3fb048d5349a77b57950ab7f6b6e92ce34Derek Sollenberger native_drawRegion(mNativeCanvasWrapper, path.rects.mNativeRegion, paint.getNativeInstance()); 127694394b3fb048d5349a77b57950ab7f6b6e92ce34Derek Sollenberger } else { 1277a6a8557d6e6c8ecc170767b7552979dbdb4254efsergeyv native_drawPath(mNativeCanvasWrapper, path.readOnlyNI(), paint.getNativeInstance()); 127894394b3fb048d5349a77b57950ab7f6b6e92ce34Derek Sollenberger } 12799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12801abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik 12811abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik /** 12821abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * @hide 12831abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik */ 12843d8298e1a8b35dadb0a383aadb9a545ecab463e2sergeyv protected void throwIfCannotDraw(Bitmap bitmap) { 12859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bitmap.isRecycled()) { 1286f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy throw new RuntimeException("Canvas: trying to use a recycled bitmap " + bitmap); 12879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12881abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik if (!bitmap.isPremultiplied() && bitmap.getConfig() == Bitmap.Config.ARGB_8888 && 12891abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik bitmap.hasAlpha()) { 12901abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throw new RuntimeException("Canvas: trying to use a non-premultiplied bitmap " 12911abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik + bitmap); 12921abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik } 12939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1296deba785f122a47915756ffd991f5540d952cf937Romain Guy * Draws the specified bitmap as an N-patch (most often, a 9-patches.) 1297deba785f122a47915756ffd991f5540d952cf937Romain Guy * 12983b748a44c6bd2ea05fe16839caf73dbe50bd7ae9Romain Guy * @param patch The ninepatch object to render 1299deba785f122a47915756ffd991f5540d952cf937Romain Guy * @param dst The destination rectangle. 1300deba785f122a47915756ffd991f5540d952cf937Romain Guy * @param paint The paint to draw the bitmap with. may be null 1301051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 1302deba785f122a47915756ffd991f5540d952cf937Romain Guy * @hide 1303deba785f122a47915756ffd991f5540d952cf937Romain Guy */ 1304ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPatch(@NonNull NinePatch patch, @NonNull Rect dst, @Nullable Paint paint) { 13054c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger Bitmap bitmap = patch.getBitmap(); 13064c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger throwIfCannotDraw(bitmap); 13074c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger final long nativePaint = paint == null ? 0 : paint.getNativeInstance(); 13084c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger native_drawNinePatch(mNativeCanvasWrapper, bitmap.getNativeInstance(), patch.mNativeChunk, 13094c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger dst.left, dst.top, dst.right, dst.bottom, nativePaint, 13104c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger mDensity, patch.getDensity()); 1311f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy } 1312f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy 1313f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy /** 1314f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * Draws the specified bitmap as an N-patch (most often, a 9-patches.) 1315f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * 1316f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @param patch The ninepatch object to render 1317f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @param dst The destination rectangle. 1318f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @param paint The paint to draw the bitmap with. may be null 1319f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * 1320f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy * @hide 1321f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy */ 1322ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPatch(@NonNull NinePatch patch, @NonNull RectF dst, @Nullable Paint paint) { 13234c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger Bitmap bitmap = patch.getBitmap(); 13244c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger throwIfCannotDraw(bitmap); 13254c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger final long nativePaint = paint == null ? 0 : paint.getNativeInstance(); 13264c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger native_drawNinePatch(mNativeCanvasWrapper, bitmap.getNativeInstance(), patch.mNativeChunk, 13274c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger dst.left, dst.top, dst.right, dst.bottom, nativePaint, 13284c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger mDensity, patch.getDensity()); 1329f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy } 1330f3187b7df158d2de36955ddcc666ba4b8544a2ceRomain Guy 1331deba785f122a47915756ffd991f5540d952cf937Romain Guy /** 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, with its top/left corner at (x,y), using 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified paint, transformed by the current matrix. 1334051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 133511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 13399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 13409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 134111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>If the bitmap and canvas have different densities, this function 134211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * will take care of automatically scaling the bitmap to draw at the 134311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * same density as the canvas. 1344051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The position of the left side of the bitmap being drawn 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The position of the top side of the bitmap being drawn 13489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the bitmap (may be null) 13499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1350ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull Bitmap bitmap, float left, float top, @Nullable Paint paint) { 13511abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 13527c103a36f60b690e3fe83c40210e1cb0c76bba43John Reck native_drawBitmap(mNativeCanvasWrapper, bitmap, left, top, 1353dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint != null ? paint.getNativeInstance() : 0, mDensity, mScreenDensity, bitmap.mDensity); 13549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, scaling/translating automatically to fill 13589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the destination rectangle. If the source rectangle is not null, it 13599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specifies the subset of the bitmap to draw. 1360051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 136111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 13629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 13639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 13649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 13659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 13669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 136711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>This function <em>ignores the density associated with the bitmap</em>. 136811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * This is because the source and destination rectangle coordinate 136911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * spaces are in their respective densities, so must already have the 137011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * appropriate scaling factor applied. 1371051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 13729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 13739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param src May be null. The subset of the bitmap to be drawn 13749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dst The rectangle that the bitmap will be scaled/translated 13759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to fit into 13769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 13779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1378ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull Bitmap bitmap, @Nullable Rect src, @NonNull RectF dst, 1379ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Nullable Paint paint) { 13808872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger if (dst == null) { 13818872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger throw new NullPointerException(); 13828872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } 13838872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger throwIfCannotDraw(bitmap); 1384dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger final long nativePaint = paint == null ? 0 : paint.getNativeInstance(); 13858872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger 13868872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger float left, top, right, bottom; 13878872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger if (src == null) { 13888872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger left = top = 0; 13898872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger right = bitmap.getWidth(); 13908872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bottom = bitmap.getHeight(); 13918872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } else { 13928872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger left = src.left; 13938872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger right = src.right; 13948872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger top = src.top; 13958872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bottom = src.bottom; 13968872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } 13978872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger 13987c103a36f60b690e3fe83c40210e1cb0c76bba43John Reck native_drawBitmap(mNativeCanvasWrapper, bitmap, left, top, right, bottom, 13998872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger dst.left, dst.top, dst.right, dst.bottom, nativePaint, mScreenDensity, 14008872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bitmap.mDensity); 14018872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, scaling/translating automatically to fill 14059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the destination rectangle. If the source rectangle is not null, it 14069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specifies the subset of the bitmap to draw. 1407051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 140811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 14099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 14109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 14119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 14139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 141411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>This function <em>ignores the density associated with the bitmap</em>. 141511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * This is because the source and destination rectangle coordinate 141611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * spaces are in their respective densities, so must already have the 141711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * appropriate scaling factor applied. 1418051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 14209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param src May be null. The subset of the bitmap to be drawn 14219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dst The rectangle that the bitmap will be scaled/translated 14229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to fit into 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 14249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1425ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull Bitmap bitmap, @Nullable Rect src, @NonNull Rect dst, 1426ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Nullable Paint paint) { 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (dst == null) { 14289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 14299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14301abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throwIfCannotDraw(bitmap); 1431dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger final long nativePaint = paint == null ? 0 : paint.getNativeInstance(); 14328872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger 14338872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger int left, top, right, bottom; 14348872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger if (src == null) { 14358872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger left = top = 0; 14368872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger right = bitmap.getWidth(); 14378872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bottom = bitmap.getHeight(); 14388872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } else { 14398872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger left = src.left; 14408872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger right = src.right; 14418872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger top = src.top; 14428872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bottom = src.bottom; 14438872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger } 14448872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger 14457c103a36f60b690e3fe83c40210e1cb0c76bba43John Reck native_drawBitmap(mNativeCanvasWrapper, bitmap, left, top, right, bottom, 14468872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger dst.left, dst.top, dst.right, dst.bottom, nativePaint, mScreenDensity, 14478872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger bitmap.mDensity); 14489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1449051910b9f998030dacb8a0722588cc715813fde1Raph Levien 14509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Treat the specified array of colors as a bitmap, and draw it. This gives 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the same result as first creating a bitmap from the array, and then 14539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawing it, but this method avoids explicitly creating a bitmap object 14549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * which can be more efficient if the colors are changing often. 14559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors Array of colors representing the pixels of the bitmap 14579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Offset into the array of colors for the first pixel 145883d522290e56f614d0d9373d47c2b54b9e207795Brad Fitzpatrick * @param stride The number of colors in the array between rows (must be 14599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * >= width or <= -width). 14609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The X coordinate for where to draw the bitmap 14619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The Y coordinate for where to draw the bitmap 14629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The width of the bitmap 14639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The height of the bitmap 14649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hasAlpha True if the alpha channel of the colors contains valid 14659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * values. If false, the alpha byte is ignored (assumed to 14669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be 0xFF for every pixel). 14679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 1468cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * 1469cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * @deprecated Usage with a {@link #isHardwareAccelerated() hardware accelerated} canvas 1470cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * requires an internal copy of color buffer contents every time this method is called. Using a 1471cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * Bitmap avoids this copy, and allows the application to more explicitly control the lifetime 1472cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * and copies of pixel data. 14739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1474cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik @Deprecated 1475ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull int[] colors, int offset, int stride, float x, float y, 1476ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese int width, int height, boolean hasAlpha, @Nullable Paint paint) { 14779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // check for valid input 14789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width < 0) { 14799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("width must be >= 0"); 14809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (height < 0) { 14829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("height must be >= 0"); 14839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (Math.abs(stride) < width) { 14859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("abs(stride) must be >= width"); 14869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int lastScanline = offset + (height - 1) * stride; 14889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = colors.length; 14899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (offset < 0 || (offset + width > length) || lastScanline < 0 14909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (lastScanline + width > length)) { 14919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 14929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // quick escape if there's nothing to draw 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width == 0 || height == 0) { 14959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 14969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // punch down to native for the actual draw 14985c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawBitmap(mNativeCanvasWrapper, colors, offset, stride, x, y, width, height, hasAlpha, 1499dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint != null ? paint.getNativeInstance() : 0); 15009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1501cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik 1502cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik /** 1503cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * Legacy version of drawBitmap(int[] colors, ...) that took ints for x,y 1504cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * 1505cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * @deprecated Usage with a {@link #isHardwareAccelerated() hardware accelerated} canvas 1506cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * requires an internal copy of color buffer contents every time this method is called. Using a 1507cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * Bitmap avoids this copy, and allows the application to more explicitly control the lifetime 1508cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik * and copies of pixel data. 15099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1510cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik @Deprecated 1511ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull int[] colors, int offset, int stride, int x, int y, 1512ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese int width, int height, boolean hasAlpha, @Nullable Paint paint) { 15139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // call through to the common float version 15149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawBitmap(colors, offset, stride, (float)x, (float)y, width, height, 15159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project hasAlpha, paint); 15169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1517cd23df6a08cf7a9bdee11e703f40bca5904d779dChris Craik 15189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the bitmap using the specified matrix. 15209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to draw 15229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix used to transform the bitmap when it is drawn 15239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 15249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1525ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmap(@NonNull Bitmap bitmap, @NonNull Matrix matrix, @Nullable Paint paint) { 15267c103a36f60b690e3fe83c40210e1cb0c76bba43John Reck nativeDrawBitmapMatrix(mNativeCanvasWrapper, bitmap, matrix.ni(), 1527dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint != null ? paint.getNativeInstance() : 0); 15289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15295a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy 15305a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy /** 15315a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy * @hide 15325a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy */ 15335a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy protected static void checkRange(int length, int offset, int count) { 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((offset | count) < 0 || offset + count > length) { 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 15369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1538051910b9f998030dacb8a0722588cc715813fde1Raph Levien 15399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the bitmap through the mesh, where mesh vertices are evenly 15419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed across the bitmap. There are meshWidth+1 vertices across, and 15429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * meshHeight+1 vertices down. The verts array is accessed in row-major 15439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * order, so that the first meshWidth+1 vertices are distributed across the 15449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * top of the bitmap from left to right. A more general version of this 15455d11676414b3606792e23c269cf75b44faa1a2afChris Craik * method is drawVertices(). 15469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to draw using the mesh 15489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param meshWidth The number of columns in the mesh. Nothing is drawn if 15499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this is 0 15509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param meshHeight The number of rows in the mesh. Nothing is drawn if 15519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this is 0 15529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param verts Array of x,y pairs, specifying where the mesh should be 15539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawn. There must be at least 15545d11676414b3606792e23c269cf75b44faa1a2afChris Craik * (meshWidth+1) * (meshHeight+1) * 2 + vertOffset values 15559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the array 15569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertOffset Number of verts elements to skip before drawing 15579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors May be null. Specifies a color at each vertex, which is 15589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * interpolated across the cell, and whose values are 15599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * multiplied by the corresponding bitmap colors. If not null, 15609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * there must be at least (meshWidth+1) * (meshHeight+1) + 15619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * colorOffset values in the array. 15629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colorOffset Number of color elements to skip before drawing 15639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 15649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1565ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawBitmapMesh(@NonNull Bitmap bitmap, int meshWidth, int meshHeight, 1566ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull float[] verts, int vertOffset, @Nullable int[] colors, int colorOffset, 1567ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @Nullable Paint paint) { 15689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((meshWidth | meshHeight | vertOffset | colorOffset) < 0) { 15699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 15709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (meshWidth == 0 || meshHeight == 0) { 15729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 15739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int count = (meshWidth + 1) * (meshHeight + 1); 15759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we mul by 2 since we need two floats per vertex 15769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(verts.length, vertOffset, count * 2); 15779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (colors != null) { 15789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // no mul by 2, since we need only 1 color per vertex 15799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(colors.length, colorOffset, count); 15809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15817c103a36f60b690e3fe83c40210e1cb0c76bba43John Reck nativeDrawBitmapMesh(mNativeCanvasWrapper, bitmap, meshWidth, meshHeight, 1582f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy verts, vertOffset, colors, colorOffset, 1583dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint != null ? paint.getNativeInstance() : 0); 15849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1585f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 15869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum VertexMode { 15879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLES(0), 15889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLE_STRIP(1), 15899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLE_FAN(2); 1590051910b9f998030dacb8a0722588cc715813fde1Raph Levien 15919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project VertexMode(int nativeInt) { 15929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = nativeInt; 15939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1594a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy 1595a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy /** 1596a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy * @hide 1597a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy */ 1598a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy public final int nativeInt; 15999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1600051910b9f998030dacb8a0722588cc715813fde1Raph Levien 16019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the array of vertices, interpreted as triangles (based on mode). The 16039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * verts array is required, and specifies the x,y pairs for each vertex. If 16049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * texs is non-null, then it is used to specify the coordinate in shader 16059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinates to use at each vertex (the paint must have a shader in this 16069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * case). If there is no texs array, but there is a color array, then each 16079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color is interpolated across its corresponding triangle in a gradient. If 16089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * both texs and colors arrays are present, then they behave as before, but 16099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the resulting color at each pixels is the result of multiplying the 16109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * colors from the shader and the color-gradient together. The indices array 16119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is optional, but if it is present, then it is used to specify the index 16129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of each triangle, rather than just walking through the arrays in order. 16139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode How to interpret the array of vertices 16159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertexCount The number of values in the vertices array (and 16169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * corresponding texs and colors arrays if non-null). Each logical 16179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex is two values (x, y), vertexCount must be a multiple of 2. 16189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param verts Array of vertices for the mesh 16199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertOffset Number of values in the verts to skip before drawing. 16209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param texs May be null. If not null, specifies the coordinates to sample 16219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * into the current shader (e.g. bitmap tile or gradient) 16229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param texOffset Number of values in texs to skip before drawing. 16239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors May be null. If not null, specifies a color for each 16249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex, to be interpolated across the triangle. 16259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colorOffset Number of values in colors to skip before drawing. 16269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param indices If not null, array of indices to reference into the 16279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex (texs, colors) array. 16289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param indexCount number of entries in the indices array (if not null). 1629051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @param paint Specifies the shader to use if the texs array is non-null. 16309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1631ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawVertices(@NonNull VertexMode mode, int vertexCount, @NonNull float[] verts, 1632ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese int vertOffset, @Nullable float[] texs, int texOffset, @Nullable int[] colors, 1633ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese int colorOffset, @Nullable short[] indices, int indexOffset, int indexCount, 1634ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 16359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(verts.length, vertOffset, vertexCount); 16368dfaa4904205772cdceee63ef3989bcdedf1a914Tom Hudson if (isHardwareAccelerated()) { 16378dfaa4904205772cdceee63ef3989bcdedf1a914Tom Hudson return; 16388dfaa4904205772cdceee63ef3989bcdedf1a914Tom Hudson } 16399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (texs != null) { 16409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(texs.length, texOffset, vertexCount); 16419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (colors != null) { 164392ce5734b52ef014c80cc6335112a027188b3eb6Erik Faye-Lund checkRange(colors.length, colorOffset, vertexCount / 2); 16449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (indices != null) { 16469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(indices.length, indexOffset, indexCount); 16479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16485c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita nativeDrawVertices(mNativeCanvasWrapper, mode.nativeInt, vertexCount, verts, 1649f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy vertOffset, texs, texOffset, colors, colorOffset, 1650dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger indices, indexOffset, indexCount, paint.getNativeInstance()); 16519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 165236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat 16539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. The 16559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin is interpreted based on the Align setting in the paint. 16569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 16589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 16595dc973cb03889c58988703b58aefbd2397fb02c3Alan Viverette * @param y The y-coordinate of the baseline of the text being drawn 16609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 16619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1662ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawText(@NonNull char[] text, int index, int count, float x, float y, 1663ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 16649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((index | count | (index + count) | 16659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project (text.length - index - count)) < 0) { 16669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 16679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16685c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, text, index, count, x, y, paint.mBidiFlags, 1669dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint.getNativeInstance(), paint.mNativeTypeface); 16709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. The 16749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin is interpreted based on the Align setting in the paint. 16759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 16779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 16785dc973cb03889c58988703b58aefbd2397fb02c3Alan Viverette * @param y The y-coordinate of the baseline of the text being drawn 16799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 16809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1681ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawText(@NonNull String text, float x, float y, @NonNull Paint paint) { 16825c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, text, 0, text.length(), x, y, paint.mBidiFlags, 1683dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint.getNativeInstance(), paint.mNativeTypeface); 1684f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 16859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. 16889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The origin is interpreted 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 to draw 16939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 16945dc973cb03889c58988703b58aefbd2397fb02c3Alan Viverette * @param y The y-coordinate of the baseline of the text being drawn 16959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 16969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1697ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawText(@NonNull String text, int start, int end, float x, float y, 1698ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 16999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((start | end | (end - start) | (text.length() - end)) < 0) { 17009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 17019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17025c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, text, start, end, x, y, paint.mBidiFlags, 1703dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint.getNativeInstance(), paint.mNativeTypeface); 17049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified range of text, specified by start/end, with its 17089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin at (x,y), in the specified Paint. The origin is interpreted 17099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * based on the Align setting in the Paint. 17109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 17129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param start The index of the first character in text to draw 17139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param end (end - 1) is the index of the last character in text 17149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to draw 17159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of origin for where to draw the text 17169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of origin for where to draw the text 17179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 17189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1719ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawText(@NonNull CharSequence text, int start, int end, float x, float y, 1720ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 1721d82f8a9a3869448e6d7d4b3fc962e34e33a1ba0eRaph Levien if ((start | end | (end - start) | (text.length() - end)) < 0) { 1722d82f8a9a3869448e6d7d4b3fc962e34e33a1ba0eRaph Levien throw new IndexOutOfBoundsException(); 1723d82f8a9a3869448e6d7d4b3fc962e34e33a1ba0eRaph Levien } 17249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (text instanceof String || text instanceof SpannedString || 17259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project text instanceof SpannableString) { 17265c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, text.toString(), start, end, x, y, 1727dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint.mBidiFlags, paint.getNativeInstance(), paint.mNativeTypeface); 1728f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else if (text instanceof GraphicsOperations) { 17299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ((GraphicsOperations) text).drawText(this, start, end, x, y, 1730f296dca95f09be9832b5dcc79717986525d2b6cbRomain Guy paint); 1731f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else { 1732f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt char[] buf = TemporaryBuffer.obtain(end - start); 1733f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt TextUtils.getChars(text, start, end, buf, 0); 17345c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawText(mNativeCanvasWrapper, buf, 0, end - start, x, y, 1735dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint.mBidiFlags, paint.getNativeInstance(), paint.mNativeTypeface); 1736f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt TemporaryBuffer.recycle(buf); 17379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1738f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1739f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1740f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1741c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * Draw a run of text, all in a single direction, with optional context for complex text 1742c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * shaping. 1743c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * 1744c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * <p>See {@link #drawTextRun(CharSequence, int, int, int, int, float, float, boolean, Paint)} 1745c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * for more details. This method uses a character array rather than CharSequence to 1746c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * represent the string. Also, to be consistent with the pattern established in 1747c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * {@link #drawText}, in this method {@code count} and {@code contextCount} are used rather 1748c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * than offsets of the end position; {@code count = end - start, contextCount = contextEnd - 1749c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * contextStart}. 1750051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 1751f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param text the text to render 17520c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param index the start of the text to render 17530c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param count the count of chars to render 17540c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param contextIndex the start of the context for shaping. Must be 17550c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * no greater than index. 17560c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param contextCount the number of characters in the context for shaping. 1757f2122ef549dd73f68bdbe4d6767f6516935024d0Keisuke Kuroyanagi * contexIndex + contextCount must be no less than index + count. 1758f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param x the x position at which to draw the text 1759f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param y the y position at which to draw the text 1760051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @param isRtl whether the run is in RTL direction 1761f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param paint the paint 1762f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt */ 1763ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawTextRun(@NonNull char[] text, int index, int count, int contextIndex, 1764051910b9f998030dacb8a0722588cc715813fde1Raph Levien int contextCount, float x, float y, boolean isRtl, @NonNull Paint paint) { 1765f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1766f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text == null) { 1767f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("text is null"); 1768f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1769f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (paint == null) { 1770f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("paint is null"); 1771f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1772f2122ef549dd73f68bdbe4d6767f6516935024d0Keisuke Kuroyanagi if ((index | count | contextIndex | contextCount | index - contextIndex 1773f2122ef549dd73f68bdbe4d6767f6516935024d0Keisuke Kuroyanagi | (contextIndex + contextCount) - (index + count) 1774f2122ef549dd73f68bdbe4d6767f6516935024d0Keisuke Kuroyanagi | text.length - (contextIndex + contextCount)) < 0) { 1775f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new IndexOutOfBoundsException(); 1776f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1777f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1778f2122ef549dd73f68bdbe4d6767f6516935024d0Keisuke Kuroyanagi native_drawTextRun(mNativeCanvasWrapper, text, index, count, contextIndex, contextCount, 1779f2122ef549dd73f68bdbe4d6767f6516935024d0Keisuke Kuroyanagi x, y, isRtl, paint.getNativeInstance(), paint.mNativeTypeface); 1780f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1781f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1782f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1783c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * Draw a run of text, all in a single direction, with optional context for complex text 1784c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * shaping. 1785c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * 1786c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * <p>The run of text includes the characters from {@code start} to {@code end} in the text. In 1787c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * addition, the range {@code contextStart} to {@code contextEnd} is used as context for the 1788c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * purpose of complex text shaping, such as Arabic text potentially shaped differently based on 1789c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * the text next to it. 1790c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * 1791c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * <p>All text outside the range {@code contextStart..contextEnd} is ignored. The text between 1792c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * {@code start} and {@code end} will be laid out and drawn. 1793c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * 1794c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * <p>The direction of the run is explicitly specified by {@code isRtl}. Thus, this method is 1795c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * suitable only for runs of a single direction. Alignment of the text is as determined by the 1796c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * Paint's TextAlign value. Further, {@code 0 <= contextStart <= start <= end <= contextEnd 1797c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * <= text.length} must hold on entry. 1798c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * 1799c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * <p>Also see {@link android.graphics.Paint#getRunAdvance} for a corresponding method to 1800c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * measure the text; the advance width of the text drawn matches the value obtained from that 1801c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * method. 18020c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * 1803f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param text the text to render 1804f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param start the start of the text to render. Data before this position 1805f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * can be used for shaping context. 1806f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param end the end of the text to render. Data at or after this 1807f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * position can be used for shaping context. 1808c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * @param contextStart the index of the start of the shaping context 1809c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * @param contextEnd the index of the end of the shaping context 1810f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param x the x position at which to draw the text 1811f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param y the y position at which to draw the text 1812051910b9f998030dacb8a0722588cc715813fde1Raph Levien * @param isRtl whether the run is in RTL direction 1813f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param paint the paint 1814c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * 1815c6abf5bff6bbfafa1f133644f02a5d50d5269b7fRaph Levien * @see #drawTextRun(char[], int, int, int, int, float, float, boolean, Paint) 1816f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt */ 1817ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawTextRun(@NonNull CharSequence text, int start, int end, int contextStart, 1818051910b9f998030dacb8a0722588cc715813fde1Raph Levien int contextEnd, float x, float y, boolean isRtl, @NonNull Paint paint) { 1819f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1820f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text == null) { 1821f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("text is null"); 1822f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1823f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (paint == null) { 1824f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("paint is null"); 1825f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1826f2122ef549dd73f68bdbe4d6767f6516935024d0Keisuke Kuroyanagi if ((start | end | contextStart | contextEnd | start - contextStart | end - start 1827f2122ef549dd73f68bdbe4d6767f6516935024d0Keisuke Kuroyanagi | contextEnd - end | text.length() - contextEnd) < 0) { 1828f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new IndexOutOfBoundsException(); 1829f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1830f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1831f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text instanceof String || text instanceof SpannedString || 1832f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt text instanceof SpannableString) { 1833f2122ef549dd73f68bdbe4d6767f6516935024d0Keisuke Kuroyanagi native_drawTextRun(mNativeCanvasWrapper, text.toString(), start, end, contextStart, 1834f2122ef549dd73f68bdbe4d6767f6516935024d0Keisuke Kuroyanagi contextEnd, x, y, isRtl, paint.getNativeInstance(), paint.mNativeTypeface); 1835f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else if (text instanceof GraphicsOperations) { 18360c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt ((GraphicsOperations) text).drawTextRun(this, start, end, 1837051910b9f998030dacb8a0722588cc715813fde1Raph Levien contextStart, contextEnd, x, y, isRtl, paint); 1838f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else { 18390c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int contextLen = contextEnd - contextStart; 18400c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int len = end - start; 18410c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt char[] buf = TemporaryBuffer.obtain(contextLen); 18420c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt TextUtils.getChars(text, contextStart, contextEnd, buf, 0); 18435c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawTextRun(mNativeCanvasWrapper, buf, start - contextStart, len, 1844dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger 0, contextLen, x, y, isRtl, paint.getNativeInstance(), paint.mNativeTypeface); 18459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TemporaryBuffer.recycle(buf); 18469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text in the array, with each character's origin specified by 18519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the pos array. 1852051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 18539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 18549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index The index of the first character to draw 18559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of characters to draw, starting from index. 18569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pos Array of [x,y] positions, used to position each 18579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * character 18589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 1859eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * 1860eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * @deprecated This method does not support glyph composition and decomposition and 1861eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * should therefore not be used to render complex scripts. It also doesn't 1862eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * handle supplementary characters (eg emoji). 18639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1864f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 1865b3ec733bb830f2d4425825d93f9ed95f284e9145Tor Norbye public void drawPosText(@NonNull char[] text, int index, int count, 1866b3ec733bb830f2d4425825d93f9ed95f284e9145Tor Norbye @NonNull @Size(multiple=2) float[] pos, 1867ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese @NonNull Paint paint) { 18689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (index < 0 || index + count > text.length || count*2 > pos.length) { 18699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 18709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18713f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien for (int i = 0; i < count; i++) { 18723f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien drawText(text, index + i, 1, pos[i * 2], pos[i * 2 + 1], paint); 18733f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien } 18749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text in the array, with each character's origin specified by 18789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the pos array. 1879051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 18809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 18819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pos Array of [x,y] positions, used to position each character 18829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 1883eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * 1884eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * @deprecated This method does not support glyph composition and decomposition and 1885eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * should therefore not be used to render complex scripts. It also doesn't 1886eda57925cafdf1dab451e70052dea27846f368b4Chris Craik * handle supplementary characters (eg emoji). 18879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1888f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 1889b3ec733bb830f2d4425825d93f9ed95f284e9145Tor Norbye public void drawPosText(@NonNull String text, @NonNull @Size(multiple=2) float[] pos, 1890b3ec733bb830f2d4425825d93f9ed95f284e9145Tor Norbye @NonNull Paint paint) { 18913f0d6167227d6d2cdd85f7718d92db859b443e92Raph Levien drawPosText(text.toCharArray(), 0, text.length(), pos, paint); 18929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint, along 18969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified path. The paint's Align setting determins where along the 18979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * path to start the text. 18989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 19009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path the text should follow for its baseline 19019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hOffset The distance along the path to add to the text's 19029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * starting position 19039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vOffset The distance above(-) or below(+) the path to position 19049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the text 19059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 19069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1907ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawTextOnPath(@NonNull char[] text, int index, int count, @NonNull Path path, 1908ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese float hOffset, float vOffset, @NonNull Paint paint) { 19099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (index < 0 || index + count > text.length) { 19109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 19119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19125c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita native_drawTextOnPath(mNativeCanvasWrapper, text, index, count, 1913a6a8557d6e6c8ecc170767b7552979dbdb4254efsergeyv path.readOnlyNI(), hOffset, vOffset, 1914dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint.mBidiFlags, paint.getNativeInstance(), paint.mNativeTypeface); 19159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint, along 19199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified path. The paint's Align setting determins where along the 19209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * path to start the text. 19219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 19229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 19239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path the text should follow for its baseline 19249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hOffset The distance along the path to add to the text's 19259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * starting position 19269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vOffset The distance above(-) or below(+) the path to position 19279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the text 19289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 19299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1930ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawTextOnPath(@NonNull String text, @NonNull Path path, float hOffset, 1931ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese float vOffset, @NonNull Paint paint) { 19329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (text.length() > 0) { 1933a6a8557d6e6c8ecc170767b7552979dbdb4254efsergeyv native_drawTextOnPath(mNativeCanvasWrapper, text, path.readOnlyNI(), hOffset, vOffset, 1934dfba4d3d11bbf47dff45f94d61d4d97510b3034aDerek Sollenberger paint.mBidiFlags, paint.getNativeInstance(), paint.mNativeTypeface); 19359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Save the canvas state, draw the picture, and restore the canvas state. 19409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This differs from picture.draw(canvas), which does not perform any 19419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * save/restore. 1942cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * 1943cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * <p> 1944cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * <strong>Note:</strong> This forces the picture to internally call 1945cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * {@link Picture#endRecording} in order to prepare for playback. 1946051910b9f998030dacb8a0722588cc715813fde1Raph Levien * 19479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param picture The picture to be drawn 19489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1949ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPicture(@NonNull Picture picture) { 19509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project picture.endRecording(); 1951667fe1039feae068d3333de8fb7115313f4a517bJonathan Dixon int restoreCount = save(); 1952667fe1039feae068d3333de8fb7115313f4a517bJonathan Dixon picture.draw(this); 1953667fe1039feae068d3333de8fb7115313f4a517bJonathan Dixon restoreToCount(restoreCount); 19549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1955051910b9f998030dacb8a0722588cc715813fde1Raph Levien 19569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the picture, stretched to fit into the dst rectangle. 19589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1959ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPicture(@NonNull Picture picture, @NonNull RectF dst) { 19609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project save(); 19619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(dst.left, dst.top); 19629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (picture.getWidth() > 0 && picture.getHeight() > 0) { 1963f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy scale(dst.width() / picture.getWidth(), dst.height() / picture.getHeight()); 19649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPicture(picture); 19669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project restore(); 19679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1968051910b9f998030dacb8a0722588cc715813fde1Raph Levien 19699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the picture, stretched to fit into the dst rectangle. 19719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1972ff7215aa0cb28a4815126b056f34b2bd29e5c651Antonio Calabrese public void drawPicture(@NonNull Picture picture, @NonNull Rect dst) { 19739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project save(); 19749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(dst.left, dst.top); 19759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (picture.getWidth() > 0 && picture.getHeight() > 0) { 1976f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy scale((float) dst.width() / picture.getWidth(), 1977f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy (float) dst.height() / picture.getHeight()); 19789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPicture(picture); 19809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project restore(); 19819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1982da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy 1983da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy /** 1984ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov * Releases the resources associated with this canvas. 1985ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov * 1986ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov * @hide 1987ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov */ 1988ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov public void release() { 1989775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler mNativeCanvasWrapper = 0; 1990775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler if (mFinalizer != null) { 1991775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler mFinalizer.run(); 1992775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler mFinalizer = null; 1993775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler } 1994ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov } 1995ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov 1996ff4adde5737be08d3e2d03fbe588c591d27d4a74Svetoslav Ganov /** 1997163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * Free up as much memory as possible from private caches (e.g. fonts, images) 1998caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed * 1999163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @hide 2000caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed */ 2001caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed public static native void freeCaches(); 2002caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed 200330ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio /** 200430ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * Free up text layout caches 200530ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * 200630ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * @hide 200730ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio */ 200830ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio public static native void freeTextLayoutCaches(); 200930ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio 2010c1b33d665c8caf5760f68c45c6ca0baa649b832aJohn Reck private static native long initRaster(Bitmap bitmap); 20115c3d927e17e98e8fd4a9f3c86f7f4def0bcfa816Florin Malita private static native void native_setBitmap(long canvasHandle, 2012c1b33d665c8caf5760f68c45c6ca0baa649b832aJohn Reck Bitmap bitmap); 201395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native boolean native_isOpaque(long canvasHandle); 20146578a989566e585eee053095dc80e2552e125db2Derek Sollenberger private static native void native_setHighContrastText(long renderer, boolean highContrastText); 201595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native int native_getWidth(long canvasHandle); 201695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native int native_getHeight(long canvasHandle); 201795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita 201895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native int native_save(long canvasHandle, int saveFlags); 201936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native int native_saveLayer(long nativeCanvas, float l, 20209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float t, float r, float b, 202136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint, 202236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int layerFlags); 202336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native int native_saveLayerAlpha(long nativeCanvas, float l, 20249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float t, float r, float b, 20259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int alpha, int layerFlags); 20263891f3ad598561d5a82c07795e1fee7f1d3612d1Chris Craik private static native void native_restore(long canvasHandle, boolean tolerateUnderflow); 202795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_restoreToCount(long canvasHandle, 20283891f3ad598561d5a82c07795e1fee7f1d3612d1Chris Craik int saveCount, 20293891f3ad598561d5a82c07795e1fee7f1d3612d1Chris Craik boolean tolerateUnderflow); 203095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native int native_getSaveCount(long canvasHandle); 203195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita 203295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_translate(long canvasHandle, 203395d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita float dx, float dy); 203495d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_scale(long canvasHandle, 203595d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita float sx, float sy); 203695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_rotate(long canvasHandle, float degrees); 203795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_skew(long canvasHandle, 203895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita float sx, float sy); 203936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_concat(long nativeCanvas, 204036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix); 204136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_setMatrix(long nativeCanvas, 204236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix); 204336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_clipRect(long nativeCanvas, 20449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 20459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float right, float bottom, 20469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 204736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_clipPath(long nativeCanvas, 204836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePath, 20499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 205036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_clipRegion(long nativeCanvas, 205136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeRegion, 20529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 205336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeSetDrawFilter(long nativeCanvas, 205436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeFilter); 205536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_getClipBounds(long nativeCanvas, 20569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect bounds); 205736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_getCTM(long nativeCanvas, 205836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix); 205936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_quickReject(long nativeCanvas, 206036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePath); 206136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native boolean native_quickReject(long nativeCanvas, 20629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 2063ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger float right, float bottom); 206436bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawColor(long nativeCanvas, int color, 20659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mode); 206636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawPaint(long nativeCanvas, 206736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 206895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_drawPoint(long canvasHandle, float x, float y, 206995d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita long paintHandle); 207095d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_drawPoints(long canvasHandle, float[] pts, 207195d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita int offset, int count, 207295d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita long paintHandle); 207336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawLine(long nativeCanvas, float startX, 20749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float startY, float stopX, 207536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float stopY, long nativePaint); 207695d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita private static native void native_drawLines(long canvasHandle, float[] pts, 207795d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita int offset, int count, 207895d49149cc7fff87a18449fa661454c1b5ddbd30Florin Malita long paintHandle); 207936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawRect(long nativeCanvas, float left, 20809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float top, float right, 208136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float bottom, 208236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 208324609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese private static native void native_drawOval(long nativeCanvas, float left, float top, 208424609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese float right, float bottom, long nativePaint); 208536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawCircle(long nativeCanvas, float cx, 20869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float cy, float radius, 208736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 208824609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese private static native void native_drawArc(long nativeCanvas, float left, float top, 208924609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese float right, float bottom, 209024609581330bc350f797179e3c1a59789c645ec2Antonio Calabrese float startAngle, float sweep, boolean useCenter, 209136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 209236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawRoundRect(long nativeCanvas, 20934d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik float left, float top, float right, float bottom, 20944d1c1538e2422d0a5b19ad1cd2fb353ed6279a88Chris Craik float rx, float ry, long nativePaint); 209536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawPath(long nativeCanvas, 209636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePath, 209736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 209894394b3fb048d5349a77b57950ab7f6b6e92ce34Derek Sollenberger private static native void native_drawRegion(long nativeCanvas, 209994394b3fb048d5349a77b57950ab7f6b6e92ce34Derek Sollenberger long nativeRegion, long nativePaint); 21004c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger private native void native_drawNinePatch(long nativeCanvas, long nativeBitmap, 21014c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger long ninePatch, float dstLeft, float dstTop, float dstRight, float dstBottom, 21024c5efe9290543b723b76a8bd48518da1ae1dcb26Derek Sollenberger long nativePaintOrZero, int screenDensity, int bitmapDensity); 21037c103a36f60b690e3fe83c40210e1cb0c76bba43John Reck private native void native_drawBitmap(long nativeCanvas, Bitmap bitmap, 21049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 210536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaintOrZero, 21060d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int canvasDensity, 21070d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int screenDensity, 21080d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int bitmapDensity); 21097c103a36f60b690e3fe83c40210e1cb0c76bba43John Reck private native void native_drawBitmap(long nativeCanvas, Bitmap bitmap, 21108872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger float srcLeft, float srcTop, float srcRight, float srcBottom, 21118872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger float dstLeft, float dstTop, float dstRight, float dstBottom, 21128872b38ef403cc2c44aca07d392f5e9426fd7f54Derek Sollenberger long nativePaintOrZero, int screenDensity, int bitmapDensity); 211336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawBitmap(long nativeCanvas, int[] colors, 21149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offset, int stride, float x, 21159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float y, int width, int height, 21169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean hasAlpha, 211736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaintOrZero); 211836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeDrawBitmapMatrix(long nativeCanvas, 21197c103a36f60b690e3fe83c40210e1cb0c76bba43John Reck Bitmap bitmap, 212036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeMatrix, 212136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 212236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeDrawBitmapMesh(long nativeCanvas, 21237c103a36f60b690e3fe83c40210e1cb0c76bba43John Reck Bitmap bitmap, 21249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int meshWidth, int meshHeight, 21259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] verts, int vertOffset, 212636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int[] colors, int colorOffset, 212736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativePaint); 212836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void nativeDrawVertices(long nativeCanvas, int mode, int n, 21299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] verts, int vertOffset, float[] texs, int texOffset, 21309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] colors, int colorOffset, short[] indices, 213136bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int indexOffset, int indexCount, long nativePaint); 213236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat 213336bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawText(long nativeCanvas, char[] text, 21349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int index, int count, float x, 213536bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float y, int flags, long nativePaint, 213636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeTypeface); 213736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawText(long nativeCanvas, String text, 21389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int start, int end, float x, 213936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float y, int flags, long nativePaint, 214036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat long nativeTypeface); 2141fcf2be1846935e7983ea2fe87fdd4d7af27764b6Fabrice Di Meglio 214236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextRun(long nativeCanvas, String text, 21430c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int start, int end, int contextStart, int contextEnd, 2144051910b9f998030dacb8a0722588cc715813fde1Raph Levien float x, float y, boolean isRtl, long nativePaint, long nativeTypeface); 2145f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 214636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextRun(long nativeCanvas, char[] text, 21470c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int start, int count, int contextStart, int contextCount, 2148051910b9f998030dacb8a0722588cc715813fde1Raph Levien float x, float y, boolean isRtl, long nativePaint, long nativeTypeface); 2149f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 215036bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextOnPath(long nativeCanvas, 21519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char[] text, int index, 215236bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat int count, long nativePath, 21539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float hOffset, 2154da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio float vOffset, int bidiFlags, 21559d2b5e1930bfc4b1da1c865843c247c708ea1565Raph Levien long nativePaint, long nativeTypeface); 215636bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat private static native void native_drawTextOnPath(long nativeCanvas, 215736bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat String text, long nativePath, 215836bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float hOffset, 215936bef0bf30d6bae48cf3837df351075ca4fce654Ashok Bhat float vOffset, 21609d2b5e1930bfc4b1da1c865843c247c708ea1565Raph Levien int flags, long nativePaint, long nativeTypeface); 2161775873a66a946fae2b0535abb51df9817bd1b20cRichard Uhler private static native long getNativeFinalizer(); 21629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 2163