Canvas.java revision 3bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.graphics; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.text.GraphicsOperations; 20f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Feltimport android.text.SpannableString; 21f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Feltimport android.text.SpannedString; 22f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Feltimport android.text.TextUtils; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport javax.microedition.khronos.opengles.GL; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The Canvas class holds the "draw" calls. To draw something, you need 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4 basic components: A Bitmap to hold the pixels, a Canvas to host 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the draw calls (writing into the bitmap), a drawing primitive (e.g. Rect, 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Path, text, Bitmap), and a paint (to describe the colors and styles for the 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawing). 3261fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * 3361fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * <div class="special reference"> 3461fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * <h3>Developer Guides</h3> 3561fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * <p>For more information about how to use Canvas, read the 3661fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * <a href="{@docRoot}guide/topics/graphics/2d-graphics.html"> 3761fd1e8d8c3ccf2d6b7d4af1c19e8f0988d5a1ecJoe Fernandez * Canvas and Drawables</a> developer guide.</p></div> 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class Canvas { 40fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger // assigned in constructors or setBitmap, freed in finalizer 41fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger int mNativeCanvas; 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 43e0aa84b7dc087e999e20055dcc04cb6a48d5bd62Romain Guy // may be null 44e0aa84b7dc087e999e20055dcc04cb6a48d5bd62Romain Guy private Bitmap mBitmap; 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // optional field set by the caller 47ce0537b80087a6225273040a987414b1dd081aa0Romain Guy private DrawFilter mDrawFilter; 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 49ce0537b80087a6225273040a987414b1dd081aa0Romain Guy /** 50ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * @hide 51ce0537b80087a6225273040a987414b1dd081aa0Romain Guy */ 52ce0537b80087a6225273040a987414b1dd081aa0Romain Guy protected int mDensity = Bitmap.DENSITY_NONE; 530d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn 54ce0537b80087a6225273040a987414b1dd081aa0Romain Guy /** 55ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * Used to determine when compatibility scaling is in effect. 56ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * 57ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * @hide 58ce0537b80087a6225273040a987414b1dd081aa0Romain Guy */ 59ce0537b80087a6225273040a987414b1dd081aa0Romain Guy protected int mScreenDensity = Bitmap.DENSITY_NONE; 6011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Used by native code 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SuppressWarnings({"UnusedDeclaration"}) 63e0aa84b7dc087e999e20055dcc04cb6a48d5bd62Romain Guy private int mSurfaceFormat; 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 65da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio /** 66da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * Flag for drawTextRun indicating left-to-right run direction. 67da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * @hide 68da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio */ 69da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio public static final int DIRECTION_LTR = 0; 70da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio 71da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio /** 72da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * Flag for drawTextRun indicating right-to-left run direction. 73da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * @hide 74da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio */ 75da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio public static final int DIRECTION_RTL = 1; 76da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio 77f61970fc79e9c5cf340fa942597628242361864aRomain Guy // Maximum bitmap size as defined in Skia's native code 78f61970fc79e9c5cf340fa942597628242361864aRomain Guy // (see SkCanvas.cpp, SkDraw.cpp) 79f61970fc79e9c5cf340fa942597628242361864aRomain Guy private static final int MAXMIMUM_BITMAP_SIZE = 32766; 80f61970fc79e9c5cf340fa942597628242361864aRomain Guy 814a317db43d2bbc992284dd1f651751f13734d017Romain Guy // This field is used to finalize the native Canvas properly 824a317db43d2bbc992284dd1f651751f13734d017Romain Guy @SuppressWarnings({"UnusedDeclaration"}) 83e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy private final CanvasFinalizer mFinalizer; 84e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 85e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy private static class CanvasFinalizer { 86fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger private int mNativeCanvas; 87e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 88e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy public CanvasFinalizer(int nativeCanvas) { 89e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy mNativeCanvas = nativeCanvas; 90e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 91e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 92e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy @Override 93e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy protected void finalize() throws Throwable { 943b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy try { 953b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy if (mNativeCanvas != 0) { 963b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy finalizer(mNativeCanvas); 973b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy } 983b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy } finally { 993b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy super.finalize(); 100e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 101e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 102e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 103e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 104f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Construct an empty raster canvas. Use setBitmap() to specify a bitmap to 10696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * draw into. The initial target density is {@link Bitmap#DENSITY_NONE}; 10796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * this will typically be replaced when a target bitmap is set for the 10896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * canvas. 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Canvas() { 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // 0 means no native bitmap 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNativeCanvas = initRaster(0); 1132fc941e4650d618ff6e122f28b616d9032ffa134Romain Guy mFinalizer = new CanvasFinalizer(mNativeCanvas); 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Construct a canvas with the specified bitmap to draw into. The bitmap 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * must be mutable. 11996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * 12096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>The initial target density of the canvas is the same as the given 12196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * bitmap's density. 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap Specifies a mutable bitmap for the canvas to draw into. 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Canvas(Bitmap bitmap) { 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!bitmap.isMutable()) { 127f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy throw new IllegalStateException("Immutable bitmap passed to Canvas constructor"); 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throwIfRecycled(bitmap); 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNativeCanvas = initRaster(bitmap.ni()); 131e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy mFinalizer = new CanvasFinalizer(mNativeCanvas); 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBitmap = bitmap; 13396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn mDensity = bitmap.mDensity; 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 136163935113919a184122b8b3bd672ef08c8df65dcRomain Guy Canvas(int nativeCanvas) { 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (nativeCanvas == 0) { 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(); 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNativeCanvas = nativeCanvas; 141e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy mFinalizer = new CanvasFinalizer(nativeCanvas); 14296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn mDensity = Bitmap.getDefaultDensity(); 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 144163935113919a184122b8b3bd672ef08c8df65dcRomain Guy 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 146fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger * Replace existing canvas while ensuring that the swap has occurred before 147fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger * the previous native canvas is unreferenced. 148fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger */ 1493bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger private void safeCanvasSwap(int nativeCanvas, boolean copyState) { 150fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger final int oldCanvas = mNativeCanvas; 151fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger mNativeCanvas = nativeCanvas; 152fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger mFinalizer.mNativeCanvas = nativeCanvas; 1533bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger if (copyState) { 1543bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger copyNativeCanvasState(oldCanvas, mNativeCanvas); 1553bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger } 156fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger finalizer(oldCanvas); 157fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger } 158fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger 159fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger /** 160163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * Returns null. 16196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * 162163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @deprecated This method is not supported and should not be invoked. 1633b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy * 1643b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy * @hide 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 166cc3ec6cdb2b892eb29513e72d8b205acbe997b25Gilles Debunne @Deprecated 167163935113919a184122b8b3bd672ef08c8df65dcRomain Guy protected GL getGL() { 168163935113919a184122b8b3bd672ef08c8df65dcRomain Guy return null; 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1702d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy 1712d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy /** 1722d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * Indicates whether this Canvas uses hardware acceleration. 1732d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * 1742d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * Note that this method does not define what type of hardware acceleration 1752d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * may or may not be used. 1762d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * 1772d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * @return True if drawing operations are hardware accelerated, 1782d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * false otherwise. 1792d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy */ 1802d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy public boolean isHardwareAccelerated() { 181163935113919a184122b8b3bd672ef08c8df65dcRomain Guy return false; 182caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed } 183163935113919a184122b8b3bd672ef08c8df65dcRomain Guy 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1853bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * Specify a bitmap for the canvas to draw into. All canvas state such as 1863bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * layers, filters, and the save/restore stack are reset with the exception 1873bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * of the current matrix and clip stack. Additionally, as a side-effect 1883bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger * the canvas' target density is updated to match that of the bitmap. 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap Specifies a mutable bitmap for the canvas to draw into. 19196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @see #setDensity(int) 19296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @see #getDensity() 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setBitmap(Bitmap bitmap) { 195163935113919a184122b8b3bd672ef08c8df65dcRomain Guy if (isHardwareAccelerated()) { 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Can't set a bitmap device on a GL canvas"); 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger if (bitmap == null) { 2003bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger safeCanvasSwap(initRaster(0), false); 201fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger mDensity = Bitmap.DENSITY_NONE; 202fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger } else { 2030965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy if (!bitmap.isMutable()) { 2040965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy throw new IllegalStateException(); 2050965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy } 2060965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy throwIfRecycled(bitmap); 207fc615a0f643408956fc0dc1b997871e2b27cee7eDerek Sollenberger 2083bd9a6dc6b30ed0ce40ca9087ca0f4b1ca789100Derek Sollenberger safeCanvasSwap(initRaster(bitmap.ni()), true); 2090965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy mDensity = bitmap.mDensity; 2100965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy } 2110965a3244b4c3009d08db2e084cdcb681ef66d26Romain Guy 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBitmap = bitmap; 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the viewport dimensions if this canvas is GL based. If it is not, 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this method is ignored and no exception is thrown. 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 219163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @param width The width of the viewport 220163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @param height The height of the viewport 2212d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * 222163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @hide 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setViewport(int width, int height) { 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the device that the current layer draws into is opaque 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (i.e. does not support per-pixel alpha). 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the device that the current layer draws into is opaque 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native boolean isOpaque(); 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the width of the current drawing layer 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the width of the current drawing layer 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native int getWidth(); 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the height of the current drawing layer 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the height of the current drawing layer 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native int getHeight(); 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 25096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>Returns the target density of the canvas. The default density is 25196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * derived from the density of its backing bitmap, or 25296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * {@link Bitmap#DENSITY_NONE} if there is not one.</p> 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 25496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @return Returns the current target density of the canvas, which is used 25596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * to determine the scaling factor when drawing a bitmap into it. 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 25711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #setDensity(int) 25811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see Bitmap#getDensity() 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 26011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getDensity() { 26111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return mDensity; 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 26596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>Specifies the density for this Canvas' backing bitmap. This modifies 26696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * the target density of the canvas itself, as well as the density of its 26796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * backing bitmap via {@link Bitmap#setDensity(int) Bitmap.setDensity(int)}. 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 26996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @param density The new target density of the canvas, which is used 27096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * to determine the scaling factor when drawing a bitmap into it. Use 27196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * {@link Bitmap#DENSITY_NONE} to disable bitmap scaling. 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 27311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #getDensity() 27411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see Bitmap#setDensity(int) 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 27611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public void setDensity(int density) { 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mBitmap != null) { 27811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn mBitmap.setDensity(density); 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 28011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn mDensity = density; 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2830d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn /** @hide */ 2840d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn public void setScreenDensity(int density) { 2850d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn mScreenDensity = density; 2860d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn } 287f61970fc79e9c5cf340fa942597628242361864aRomain Guy 288f61970fc79e9c5cf340fa942597628242361864aRomain Guy /** 289f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Returns the maximum allowed width for bitmaps drawn with this canvas. 290f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Attempting to draw with a bitmap wider than this value will result 291f61970fc79e9c5cf340fa942597628242361864aRomain Guy * in an error. 292f61970fc79e9c5cf340fa942597628242361864aRomain Guy * 293f61970fc79e9c5cf340fa942597628242361864aRomain Guy * @see #getMaximumBitmapHeight() 294f61970fc79e9c5cf340fa942597628242361864aRomain Guy */ 295f61970fc79e9c5cf340fa942597628242361864aRomain Guy public int getMaximumBitmapWidth() { 296f61970fc79e9c5cf340fa942597628242361864aRomain Guy return MAXMIMUM_BITMAP_SIZE; 297f61970fc79e9c5cf340fa942597628242361864aRomain Guy } 2980d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn 299f61970fc79e9c5cf340fa942597628242361864aRomain Guy /** 300f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Returns the maximum allowed height for bitmaps drawn with this canvas. 301f61970fc79e9c5cf340fa942597628242361864aRomain Guy * Attempting to draw with a bitmap taller than this value will result 302f61970fc79e9c5cf340fa942597628242361864aRomain Guy * in an error. 303f61970fc79e9c5cf340fa942597628242361864aRomain Guy * 304f61970fc79e9c5cf340fa942597628242361864aRomain Guy * @see #getMaximumBitmapWidth() 305f61970fc79e9c5cf340fa942597628242361864aRomain Guy */ 306f61970fc79e9c5cf340fa942597628242361864aRomain Guy public int getMaximumBitmapHeight() { 307f61970fc79e9c5cf340fa942597628242361864aRomain Guy return MAXMIMUM_BITMAP_SIZE; 308f61970fc79e9c5cf340fa942597628242361864aRomain Guy } 309f61970fc79e9c5cf340fa942597628242361864aRomain Guy 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // the SAVE_FLAG constants must match their native equivalents 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** restore the current matrix when restore() is called */ 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MATRIX_SAVE_FLAG = 0x01; 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** restore the current clip when restore() is called */ 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CLIP_SAVE_FLAG = 0x02; 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** the layer needs to per-pixel alpha */ 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int HAS_ALPHA_LAYER_SAVE_FLAG = 0x04; 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** the layer needs to 8-bits per color component */ 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FULL_COLOR_LAYER_SAVE_FLAG = 0x08; 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** clip against the layer's bounds */ 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CLIP_TO_LAYER_SAVE_FLAG = 0x10; 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** restore everything when restore() is called */ 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ALL_SAVE_FLAG = 0x1F; 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Saves the current matrix and clip onto a private stack. Subsequent 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calls to translate,scale,rotate,skew,concat or clipRect,clipPath 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will all operate as usual, but when the balancing call to restore() 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is made, those calls will be forgotten, and the settings that existed 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * before the save() will be reinstated. 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The value to pass to restoreToCount() to balance this save() 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native int save(); 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Based on saveFlags, can save the current matrix and clip onto a private 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * stack. Subsequent calls to translate,scale,rotate,skew,concat or 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect,clipPath will all operate as usual, but when the balancing 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * call to restore() is made, those calls will be forgotten, and the 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * settings that existed before the save() will be reinstated. 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveFlags flag bits that specify which parts of the Canvas state 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to save/restore 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The value to pass to restoreToCount() to balance this save() 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native int save(int saveFlags); 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This behaves the same as save(), but in addition it allocates an 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * offscreen bitmap. All drawing calls are directed there, and only when 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the balancing call to restore() is made is that offscreen transfered to 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the canvas (or the previous layer). Subsequent calls to translate, 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * scale, rotate, skew, concat or clipRect, clipPath all operate on this 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * copy. When the balancing call to restore() is made, this copy is 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * deleted and the previous matrix/clip state is restored. 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds May be null. The maximum size the offscreen bitmap 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * needs to be (in local coordinates) 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint This is copied, and is applied to the offscreen when 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * restore() is called. 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveFlags see _SAVE_FLAG constants 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return value to pass to restoreToCount() to balance this save() 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int saveLayer(RectF bounds, Paint paint, int saveFlags) { 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_saveLayer(mNativeCanvas, bounds, 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint != null ? paint.mNativePaint : 0, 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project saveFlags); 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper version of saveLayer() that takes 4 values rather than a RectF. 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 374f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public int saveLayer(float left, float top, float right, float bottom, Paint paint, 375f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy int saveFlags) { 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_saveLayer(mNativeCanvas, left, top, right, bottom, 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint != null ? paint.mNativePaint : 0, 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project saveFlags); 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This behaves the same as save(), but in addition it allocates an 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * offscreen bitmap. All drawing calls are directed there, and only when 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the balancing call to restore() is made is that offscreen transfered to 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the canvas (or the previous layer). Subsequent calls to translate, 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * scale, rotate, skew, concat or clipRect, clipPath all operate on this 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * copy. When the balancing call to restore() is made, this copy is 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * deleted and the previous matrix/clip state is restored. 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds The maximum size the offscreen bitmap needs to be 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (in local coordinates) 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param alpha The alpha to apply to the offscreen when when it is 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawn during restore() 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveFlags see _SAVE_FLAG constants 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return value to pass to restoreToCount() to balance this call 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int saveLayerAlpha(RectF bounds, int alpha, int saveFlags) { 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project alpha = Math.min(255, Math.max(0, alpha)); 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_saveLayerAlpha(mNativeCanvas, bounds, alpha, saveFlags); 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for saveLayerAlpha() that takes 4 values instead of a RectF. 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 405f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public int saveLayerAlpha(float left, float top, float right, float bottom, int alpha, 406f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy int saveFlags) { 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_saveLayerAlpha(mNativeCanvas, left, top, right, bottom, 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project alpha, saveFlags); 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This call balances a previous call to save(), and is used to remove all 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * modifications to the matrix/clip state since the last save call. It is 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an error to call restore() more times than save() was called. 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void restore(); 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the number of matrix/clip states on the Canvas' private stack. 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This will equal # save() calls - # restore() calls. 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native int getSaveCount(); 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Efficient way to pop any calls to save() that happened after the save 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * count reached saveCount. It is an error for saveCount to be less than 1. 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Example: 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * int count = canvas.save(); 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ... // more calls potentially to save() 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * canvas.restoreToCount(count); 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * // now the canvas is back in the same state it was before the initial 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * // call to save(). 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveCount The save level to restore to. 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void restoreToCount(int saveCount); 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified translation 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dx The distance to translate in X 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dy The distance to translate in Y 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void translate(float dx, float dy); 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified scale. 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to scale in X 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to scale in Y 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void scale(float sx, float sy); 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified scale. 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to scale in X 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to scale in Y 460cc3ec6cdb2b892eb29513e72d8b205acbe997b25Gilles Debunne * @param px The x-coord for the pivot point (unchanged by the scale) 461cc3ec6cdb2b892eb29513e72d8b205acbe997b25Gilles Debunne * @param py The y-coord for the pivot point (unchanged by the scale) 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void scale(float sx, float sy, float px, float py) { 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(px, py); 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project scale(sx, sy); 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(-px, -py); 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified rotation. 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param degrees The amount to rotate, in degrees 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void rotate(float degrees); 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified rotation. 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param degrees The amount to rotate, in degrees 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param px The x-coord for the pivot point (unchanged by the rotation) 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param py The y-coord for the pivot point (unchanged by the rotation) 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void rotate(float degrees, float px, float py) { 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(px, py); 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project rotate(degrees); 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(-px, -py); 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified skew. 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to skew in X 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to skew in Y 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void skew(float sx, float sy); 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified matrix. 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix to preconcatenate with the current matrix 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void concat(Matrix matrix) { 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_concat(mNativeCanvas, matrix.native_instance); 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Completely replace the current matrix with the specified matrix. If the 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * matrix parameter is null, then the current matrix is reset to identity. 509f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * 510f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * <strong>Note:</strong> it is recommended to use {@link #concat(Matrix)}, 511f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * {@link #scale(float, float)}, {@link #translate(float, float)} and 512f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * {@link #rotate(float)} instead of this method. 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix to replace the current matrix with. If it is 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * null, set the current matrix to identity. 516f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * 517f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy * @see #concat(Matrix) 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setMatrix(Matrix matrix) { 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_setMatrix(mNativeCanvas, 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project matrix == null ? 0 : matrix.native_instance); 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return, in ctm, the current transformation matrix. This does not alter 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the matrix in the canvas, but just returns a copy of it. 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 528f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void getMatrix(Matrix ctm) { 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_getCTM(mNativeCanvas, ctm.native_instance); 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 53241030da16856c8869e1e51d4a0405432fa96614eRomain Guy 53341030da16856c8869e1e51d4a0405432fa96614eRomain Guy /** 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a new matrix with a copy of the canvas' current transformation 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * matrix. 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 53765447287cb4112cf74483c87be70bcd00b622e2dRomain Guy @Deprecated 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final Matrix getMatrix() { 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Matrix m = new Matrix(); 540f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy //noinspection deprecation 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getMatrix(m); 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return m; 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle. 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rect to intersect with the current clip 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipRect(RectF rect, Region.Op op) { 553f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy return native_clipRect(mNativeCanvas, rect.left, rect.top, rect.right, rect.bottom, 554f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy op.nativeInt); 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle, which is 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipRect(Rect rect, Region.Op op) { 566f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy return native_clipRect(mNativeCanvas, rect.left, rect.top, rect.right, rect.bottom, 567f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy op.nativeInt); 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native boolean clipRect(RectF rect); 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native boolean clipRect(Rect rect); 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle, which is 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 603f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public boolean clipRect(float left, float top, float right, float bottom, Region.Op op) { 604f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy return native_clipRect(mNativeCanvas, left, top, right, bottom, op.nativeInt); 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current clip 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 620f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public native boolean clipRect(float left, float top, float right, float bottom); 621f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current clip 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 635f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public native boolean clipRect(int left, int top, int right, int bottom); 636f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified path. 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to operate on the current clip 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipPath(Path path, Region.Op op) { 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_clipPath(mNativeCanvas, path.ni(), op.nativeInt); 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified path. 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to intersect with the current clip 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipPath(Path path) { 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return clipPath(path, Region.Op.INTERSECT); 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified region. Note that unlike 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect() and clipPath() which transform their arguments by the 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, clipRegion() assumes its argument is already in the 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinate system of the current layer's bitmap, and so not 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * transformation is performed. 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param region The region to operate on the current clip, based on op 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipRegion(Region region, Region.Op op) { 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_clipRegion(mNativeCanvas, region.ni(), op.nativeInt); 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified region. Note that unlike 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect() and clipPath() which transform their arguments by the 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, clipRegion() assumes its argument is already in the 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinate system of the current layer's bitmap, and so not 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * transformation is performed. 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param region The region to operate on the current clip, based on op 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipRegion(Region region) { 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return clipRegion(region, Region.Op.INTERSECT); 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public DrawFilter getDrawFilter() { 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mDrawFilter; 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setDrawFilter(DrawFilter filter) { 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativeFilter = 0; 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (filter != null) { 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeFilter = filter.mNativeInt; 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDrawFilter = filter; 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeSetDrawFilter(mNativeCanvas, nativeFilter); 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum EdgeType { 701d320001807168f5565bab9807ef13c111096bbb3Chet Haase 702d320001807168f5565bab9807ef13c111096bbb3Chet Haase /** 703d320001807168f5565bab9807ef13c111096bbb3Chet Haase * Black-and-White: Treat edges by just rounding to nearest pixel boundary 704d320001807168f5565bab9807ef13c111096bbb3Chet Haase */ 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project BW(0), //!< treat edges by just rounding to nearest pixel boundary 706d320001807168f5565bab9807ef13c111096bbb3Chet Haase 707d320001807168f5565bab9807ef13c111096bbb3Chet Haase /** 708d320001807168f5565bab9807ef13c111096bbb3Chet Haase * Antialiased: Treat edges by rounding-out, since they may be antialiased 709d320001807168f5565bab9807ef13c111096bbb3Chet Haase */ 710d320001807168f5565bab9807ef13c111096bbb3Chet Haase AA(1); 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EdgeType(int nativeInt) { 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = nativeInt; 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 715c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy 716c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy /** 717c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy * @hide 718c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy */ 719c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy public final int nativeInt; 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified rectangle, after being transformed by the 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect the rect to compare with the current clip 729d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 730d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 731d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the rect (transformed by the canvas' matrix) 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean quickReject(RectF rect, EdgeType type) { 736ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger return native_quickReject(mNativeCanvas, rect); 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified path, after being transformed by the 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). Note: for speed it may 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * return false even if the path itself might not intersect the clip 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (i.e. the bounds of the path intersects, but the path does not). 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to compare with the current clip 748d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 749d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 750d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the path (transformed by the canvas' matrix) 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean quickReject(Path path, EdgeType type) { 755ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger return native_quickReject(mNativeCanvas, path.ni()); 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified rectangle, after being transformed by the 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to compare with the 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to compare with the current 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to compare with the 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to compare with the 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 772d320001807168f5565bab9807ef13c111096bbb3Chet Haase * @param type {@link Canvas.EdgeType#AA} if the path should be considered antialiased, 773d320001807168f5565bab9807ef13c111096bbb3Chet Haase * since that means it may affect a larger area (more pixels) than 774d320001807168f5565bab9807ef13c111096bbb3Chet Haase * non-antialiased ({@link Canvas.EdgeType#BW}). 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the rect (transformed by the canvas' matrix) 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 778ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger public boolean quickReject(float left, float top, float right, float bottom, 779ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger EdgeType type) { 780ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger return native_quickReject(mNativeCanvas, left, top, right, bottom); 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the clip bounds, returning true if they are non-empty. 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds Return the clip bounds here. If it is null, ignore it but 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * still return true if the current clip is non-empty. 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the current clip is non-empty. 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean getClipBounds(Rect bounds) { 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_getClipBounds(mNativeCanvas, bounds); 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the clip bounds. 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the clip bounds, or [0, 0, 0, 0] if the clip is empty. 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final Rect getClipBounds() { 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect r = new Rect(); 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getClipBounds(r); 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return r; 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified RGB color, using srcover porterduff mode. 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r red component (0..255) of the color to draw onto the canvas 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param g green component (0..255) of the color to draw onto the canvas 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param b blue component (0..255) of the color to draw onto the canvas 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRGB(int r, int g, int b) { 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawRGB(mNativeCanvas, r, g, b); 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified ARGB color, using srcover porterduff mode. 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param a alpha component (0..255) of the color to draw onto the canvas 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r red component (0..255) of the color to draw onto the canvas 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param g green component (0..255) of the color to draw onto the canvas 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param b blue component (0..255) of the color to draw onto the canvas 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawARGB(int a, int r, int g, int b) { 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawARGB(mNativeCanvas, a, r, g, b); 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified color, using srcover porterduff mode. 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param color the color to draw onto the canvas 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawColor(int color) { 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawColor(mNativeCanvas, color); 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified color and porter-duff xfermode. 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param color the color to draw with 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode the porter-duff mode to apply to the color 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawColor(int color, PorterDuff.Mode mode) { 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawColor(mNativeCanvas, color, mode.nativeInt); 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified paint. This is equivalent (but faster) to drawing an 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * infinitely large rectangle with the specified paint. 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw onto the canvas 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPaint(Paint paint) { 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawPaint(mNativeCanvas, paint.mNativePaint); 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a series of points. Each point is centered at the coordinate 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified by pts[], and its diameter is specified by the paint's stroke 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * width (as transformed by the canvas' CTM), with special treatment for 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a stroke width of 0, which always draws exactly 1 pixel (or at most 4 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if antialiasing is enabled). The shape of the point is controlled by 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the paint's Cap type. The shape is a square, unless the cap type is 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Round, in which case the shape is a circle. 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pts Array of points to draw [x0 y0 x1 y1 x2 y2 ...] 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Number of values to skip before starting to draw. 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of values to process, after skipping offset 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of them. Since one point uses two values, the number of 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * "points" that are drawn is really (count >> 1). 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the points 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 878f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public native void drawPoints(float[] pts, int offset, int count, Paint paint); 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for drawPoints() that assumes you want to draw the entire array 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPoints(float[] pts, Paint paint) { 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPoints(pts, 0, pts.length, paint); 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for drawPoints() for drawing a single point. 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void drawPoint(float x, float y, Paint paint); 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a line segment with the specified start and stop x,y coordinates, 894a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * using the specified paint. 895a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * 896a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * <p>Note that since a line is always "framed", the Style is ignored in the paint.</p> 897a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * 898a5ef27da958acb84014b9f6ca4622c02be02fe22Chris Craik * <p>Degenerate lines (length is 0) will not be drawn.</p> 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startX The x-coordinate of the start point of the line 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startY The y-coordinate of the start point of the line 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the line 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 904f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawLine(float startX, float startY, float stopX, float stopY, Paint paint) { 905f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy native_drawLine(mNativeCanvas, startX, startY, stopX, stopY, paint.mNativePaint); 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a series of lines. Each line is taken from 4 consecutive values 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the pts array. Thus to draw 1 line, the array must contain at least 4 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * values. This is logically the same as drawing the array as follows: 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawLine(pts[0], pts[1], pts[2], pts[3]) followed by 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawLine(pts[4], pts[5], pts[6], pts[7]) and so on. 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pts Array of points to draw [x0 y0 x1 y1 x2 y2 ...] 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Number of values in the array to skip before drawing. 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of values in the array to process, after 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * skipping "offset" of them. Since each line uses 4 values, 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the number of "lines" that are drawn is really 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (count >> 2). 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the points 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 923f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public native void drawLines(float[] pts, int offset, int count, Paint paint); 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawLines(float[] pts, Paint paint) { 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawLines(pts, 0, pts.length, paint); 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified paint. The rectangle will 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be filled or framed based on the Style in the paint. 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rect to be drawn 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rect 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRect(RectF rect, Paint paint) { 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawRect(mNativeCanvas, rect, paint.mNativePaint); 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified Paint. The rectangle 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be filled or framed based on the Style in the paint. 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r The rectangle to be drawn. 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rectangle 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRect(Rect r, Paint paint) { 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawRect(r.left, r.top, r.right, r.bottom, paint); 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified paint. The rectangle will 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be filled or framed based on the Style in the paint. 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to be drawn 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top side of the rectangle to be drawn 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to be drawn 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom side of the rectangle to be drawn 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rect 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 962f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawRect(float left, float top, float right, float bottom, Paint paint) { 963f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy native_drawRect(mNativeCanvas, left, top, right, bottom, paint.mNativePaint); 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified oval using the specified paint. The oval will be 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * filled or framed based on the Style in the paint. 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param oval The rectangle bounds of the oval to be drawn 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawOval(RectF oval, Paint paint) { 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (oval == null) { 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawOval(mNativeCanvas, oval, paint.mNativePaint); 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified circle using the specified paint. If radius is <= 0, 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then nothing will be drawn. The circle will be filled or framed based 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on the Style in the paint. 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cx The x-coordinate of the center of the cirle to be drawn 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cy The y-coordinate of the center of the cirle to be drawn 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param radius The radius of the cirle to be drawn 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the circle 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawCircle(float cx, float cy, float radius, Paint paint) { 990f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy native_drawCircle(mNativeCanvas, cx, cy, radius, paint.mNativePaint); 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9944a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>Draw the specified arc, which will be scaled to fit inside the 9954a317db43d2bbc992284dd1f651751f13734d017Romain Guy * specified oval.</p> 9964a317db43d2bbc992284dd1f651751f13734d017Romain Guy * 9974a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>If the start angle is negative or >= 360, the start angle is treated 9984a317db43d2bbc992284dd1f651751f13734d017Romain Guy * as start angle modulo 360.</p> 9994a317db43d2bbc992284dd1f651751f13734d017Romain Guy * 10004a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>If the sweep angle is >= 360, then the oval is drawn 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completely. Note that this differs slightly from SkPath::arcTo, which 10024a317db43d2bbc992284dd1f651751f13734d017Romain Guy * treats the sweep angle modulo 360. If the sweep angle is negative, 10034a317db43d2bbc992284dd1f651751f13734d017Romain Guy * the sweep angle is treated as sweep angle modulo 360</p> 10044a317db43d2bbc992284dd1f651751f13734d017Romain Guy * 10054a317db43d2bbc992284dd1f651751f13734d017Romain Guy * <p>The arc is drawn clockwise. An angle of 0 degrees correspond to the 10064a317db43d2bbc992284dd1f651751f13734d017Romain Guy * geometric angle of 0 degrees (3 o'clock on a watch.)</p> 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param oval The bounds of oval used to define the shape and size 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the arc 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startAngle Starting angle (in degrees) where the arc begins 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sweepAngle Sweep angle (in degrees) measured clockwise 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param useCenter If true, include the center of the oval in the arc, and 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project close it if it is being stroked. This will draw a wedge 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the arc 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1016f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawArc(RectF oval, float startAngle, float sweepAngle, boolean useCenter, 1017f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy Paint paint) { 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (oval == null) { 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawArc(mNativeCanvas, oval, startAngle, sweepAngle, 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project useCenter, paint.mNativePaint); 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified round-rect using the specified paint. The roundrect 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be filled or framed based on the Style in the paint. 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangular bounds of the roundRect to be drawn 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rx The x-radius of the oval used to round the corners 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param ry The y-radius of the oval used to round the corners 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the roundRect 10339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRoundRect(RectF rect, float rx, float ry, Paint paint) { 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (rect == null) { 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawRoundRect(mNativeCanvas, rect, rx, ry, 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint.mNativePaint); 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified path using the specified paint. The path will be 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * filled or framed based on the Style in the paint. 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to be drawn 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the path 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPath(Path path, Paint paint) { 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawPath(mNativeCanvas, path.ni(), paint.mNativePaint); 10519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void throwIfRecycled(Bitmap bitmap) { 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bitmap.isRecycled()) { 1055f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy throw new RuntimeException("Canvas: trying to use a recycled bitmap " + bitmap); 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1060deba785f122a47915756ffd991f5540d952cf937Romain Guy * Draws the specified bitmap as an N-patch (most often, a 9-patches.) 1061deba785f122a47915756ffd991f5540d952cf937Romain Guy * 1062deba785f122a47915756ffd991f5540d952cf937Romain Guy * Note: Only supported by hardware accelerated canvas at the moment. 1063deba785f122a47915756ffd991f5540d952cf937Romain Guy * 1064deba785f122a47915756ffd991f5540d952cf937Romain Guy * @param bitmap The bitmap to draw as an N-patch 1065deba785f122a47915756ffd991f5540d952cf937Romain Guy * @param chunks The patches information (matches the native struct Res_png_9patch) 1066deba785f122a47915756ffd991f5540d952cf937Romain Guy * @param dst The destination rectangle. 1067deba785f122a47915756ffd991f5540d952cf937Romain Guy * @param paint The paint to draw the bitmap with. may be null 1068deba785f122a47915756ffd991f5540d952cf937Romain Guy * 1069deba785f122a47915756ffd991f5540d952cf937Romain Guy * @hide 1070deba785f122a47915756ffd991f5540d952cf937Romain Guy */ 1071deba785f122a47915756ffd991f5540d952cf937Romain Guy public void drawPatch(Bitmap bitmap, byte[] chunks, RectF dst, Paint paint) { 1072deba785f122a47915756ffd991f5540d952cf937Romain Guy } 1073deba785f122a47915756ffd991f5540d952cf937Romain Guy 1074deba785f122a47915756ffd991f5540d952cf937Romain Guy /** 10759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, with its top/left corner at (x,y), using 10769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified paint, transformed by the current matrix. 107711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 107811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 10799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 10809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 10819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 10829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 10839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 108411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>If the bitmap and canvas have different densities, this function 108511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * will take care of automatically scaling the bitmap to draw at the 108611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * same density as the canvas. 108711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 10899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The position of the left side of the bitmap being drawn 10909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The position of the top side of the bitmap being drawn 10919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the bitmap (may be null) 10929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(Bitmap bitmap, float left, float top, Paint paint) { 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throwIfRecycled(bitmap); 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawBitmap(mNativeCanvas, bitmap.ni(), left, top, 1096f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy paint != null ? paint.mNativePaint : 0, mDensity, mScreenDensity, bitmap.mDensity); 10979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, scaling/translating automatically to fill 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the destination rectangle. If the source rectangle is not null, it 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specifies the subset of the bitmap to draw. 110311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 110411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 11059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 11079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 111011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>This function <em>ignores the density associated with the bitmap</em>. 111111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * This is because the source and destination rectangle coordinate 111211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * spaces are in their respective densities, so must already have the 111311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * appropriate scaling factor applied. 111411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param src May be null. The subset of the bitmap to be drawn 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dst The rectangle that the bitmap will be scaled/translated 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to fit into 11199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 11209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(Bitmap bitmap, Rect src, RectF dst, Paint paint) { 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (dst == null) { 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throwIfRecycled(bitmap); 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawBitmap(mNativeCanvas, bitmap.ni(), src, dst, 1127f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy paint != null ? paint.mNativePaint : 0, mScreenDensity, bitmap.mDensity); 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, scaling/translating automatically to fill 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the destination rectangle. If the source rectangle is not null, it 11339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specifies the subset of the bitmap to draw. 113411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 113511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 11369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 11399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 114111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>This function <em>ignores the density associated with the bitmap</em>. 114211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * This is because the source and destination rectangle coordinate 114311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * spaces are in their respective densities, so must already have the 114411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * appropriate scaling factor applied. 114511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param src May be null. The subset of the bitmap to be drawn 11489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dst The rectangle that the bitmap will be scaled/translated 11499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to fit into 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(Bitmap bitmap, Rect src, Rect dst, Paint paint) { 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (dst == null) { 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 11559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throwIfRecycled(bitmap); 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawBitmap(mNativeCanvas, bitmap.ni(), src, dst, 1158f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy paint != null ? paint.mNativePaint : 0, mScreenDensity, bitmap.mDensity); 11599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Treat the specified array of colors as a bitmap, and draw it. This gives 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the same result as first creating a bitmap from the array, and then 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawing it, but this method avoids explicitly creating a bitmap object 11659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * which can be more efficient if the colors are changing often. 11669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors Array of colors representing the pixels of the bitmap 11689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Offset into the array of colors for the first pixel 116983d522290e56f614d0d9373d47c2b54b9e207795Brad Fitzpatrick * @param stride The number of colors in the array between rows (must be 11709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * >= width or <= -width). 11719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The X coordinate for where to draw the bitmap 11729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The Y coordinate for where to draw the bitmap 11739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The width of the bitmap 11749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The height of the bitmap 11759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hasAlpha True if the alpha channel of the colors contains valid 11769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * values. If false, the alpha byte is ignored (assumed to 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be 0xFF for every pixel). 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1180f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawBitmap(int[] colors, int offset, int stride, float x, float y, 1181f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy int width, int height, boolean hasAlpha, Paint paint) { 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // check for valid input 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width < 0) { 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("width must be >= 0"); 11859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (height < 0) { 11879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("height must be >= 0"); 11889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (Math.abs(stride) < width) { 11909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("abs(stride) must be >= width"); 11919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int lastScanline = offset + (height - 1) * stride; 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = colors.length; 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (offset < 0 || (offset + width > length) || lastScanline < 0 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (lastScanline + width > length)) { 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // quick escape if there's nothing to draw 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width == 0 || height == 0) { 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // punch down to native for the actual draw 12039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawBitmap(mNativeCanvas, colors, offset, stride, x, y, width, height, hasAlpha, 12049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint != null ? paint.mNativePaint : 0); 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Legacy version of drawBitmap(int[] colors, ...) that took ints for x,y 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(int[] colors, int offset, int stride, int x, int y, 1210f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy int width, int height, boolean hasAlpha, Paint paint) { 12119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // call through to the common float version 12129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawBitmap(colors, offset, stride, (float)x, (float)y, width, height, 12139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project hasAlpha, paint); 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the bitmap using the specified matrix. 12189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to draw 12209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix used to transform the bitmap when it is drawn 12219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(Bitmap bitmap, Matrix matrix, Paint paint) { 12249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeDrawBitmapMatrix(mNativeCanvas, bitmap.ni(), matrix.ni(), 12259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint != null ? paint.mNativePaint : 0); 12269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12275a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy 12285a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy /** 12295a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy * @hide 12305a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy */ 12315a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy protected static void checkRange(int length, int offset, int count) { 12329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((offset | count) < 0 || offset + count > length) { 12339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 12349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the bitmap through the mesh, where mesh vertices are evenly 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed across the bitmap. There are meshWidth+1 vertices across, and 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * meshHeight+1 vertices down. The verts array is accessed in row-major 12419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * order, so that the first meshWidth+1 vertices are distributed across the 12429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * top of the bitmap from left to right. A more general version of this 12435d11676414b3606792e23c269cf75b44faa1a2afChris Craik * method is drawVertices(). 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to draw using the mesh 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param meshWidth The number of columns in the mesh. Nothing is drawn if 12479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this is 0 12489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param meshHeight The number of rows in the mesh. Nothing is drawn if 12499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this is 0 12509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param verts Array of x,y pairs, specifying where the mesh should be 12519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawn. There must be at least 12525d11676414b3606792e23c269cf75b44faa1a2afChris Craik * (meshWidth+1) * (meshHeight+1) * 2 + vertOffset values 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the array 12549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertOffset Number of verts elements to skip before drawing 12559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors May be null. Specifies a color at each vertex, which is 12569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * interpolated across the cell, and whose values are 12579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * multiplied by the corresponding bitmap colors. If not null, 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * there must be at least (meshWidth+1) * (meshHeight+1) + 12599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * colorOffset values in the array. 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colorOffset Number of color elements to skip before drawing 12619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 12629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmapMesh(Bitmap bitmap, int meshWidth, int meshHeight, 1264f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy float[] verts, int vertOffset, int[] colors, int colorOffset, Paint paint) { 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((meshWidth | meshHeight | vertOffset | colorOffset) < 0) { 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (meshWidth == 0 || meshHeight == 0) { 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int count = (meshWidth + 1) * (meshHeight + 1); 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we mul by 2 since we need two floats per vertex 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(verts.length, vertOffset, count * 2); 12749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (colors != null) { 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // no mul by 2, since we need only 1 color per vertex 12769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(colors.length, colorOffset, count); 12779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeDrawBitmapMesh(mNativeCanvas, bitmap.ni(), meshWidth, meshHeight, 12799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project verts, vertOffset, colors, colorOffset, 12809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint != null ? paint.mNativePaint : 0); 12819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1282f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy 12839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum VertexMode { 12849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLES(0), 12859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLE_STRIP(1), 12869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLE_FAN(2); 12879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project VertexMode(int nativeInt) { 12899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = nativeInt; 12909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1291a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy 1292a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy /** 1293a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy * @hide 1294a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy */ 1295a566b7c3aada08d37cf08096c972e3e641bed773Romain Guy public final int nativeInt; 12969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the array of vertices, interpreted as triangles (based on mode). The 13009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * verts array is required, and specifies the x,y pairs for each vertex. If 13019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * texs is non-null, then it is used to specify the coordinate in shader 13029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinates to use at each vertex (the paint must have a shader in this 13039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * case). If there is no texs array, but there is a color array, then each 13049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color is interpolated across its corresponding triangle in a gradient. If 13059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * both texs and colors arrays are present, then they behave as before, but 13069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the resulting color at each pixels is the result of multiplying the 13079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * colors from the shader and the color-gradient together. The indices array 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is optional, but if it is present, then it is used to specify the index 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of each triangle, rather than just walking through the arrays in order. 13109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode How to interpret the array of vertices 13129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertexCount The number of values in the vertices array (and 13139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * corresponding texs and colors arrays if non-null). Each logical 13149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex is two values (x, y), vertexCount must be a multiple of 2. 13159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param verts Array of vertices for the mesh 13169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertOffset Number of values in the verts to skip before drawing. 13179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param texs May be null. If not null, specifies the coordinates to sample 13189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * into the current shader (e.g. bitmap tile or gradient) 13199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param texOffset Number of values in texs to skip before drawing. 13209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors May be null. If not null, specifies a color for each 13219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex, to be interpolated across the triangle. 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colorOffset Number of values in colors to skip before drawing. 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param indices If not null, array of indices to reference into the 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex (texs, colors) array. 13259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param indexCount number of entries in the indices array (if not null). 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint Specifies the shader to use if the texs array is non-null. 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1328f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawVertices(VertexMode mode, int vertexCount, float[] verts, int vertOffset, 1329f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy float[] texs, int texOffset, int[] colors, int colorOffset, 1330f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy short[] indices, int indexOffset, int indexCount, Paint paint) { 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(verts.length, vertOffset, vertexCount); 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (texs != null) { 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(texs.length, texOffset, vertexCount); 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (colors != null) { 133692ce5734b52ef014c80cc6335112a027188b3eb6Erik Faye-Lund checkRange(colors.length, colorOffset, vertexCount / 2); 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (indices != null) { 13399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(indices.length, indexOffset, indexCount); 13409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeDrawVertices(mNativeCanvas, mode.nativeInt, vertexCount, verts, 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project vertOffset, texs, texOffset, colors, colorOffset, 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project indices, indexOffset, indexCount, paint.mNativePaint); 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. The 13489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin is interpreted based on the Align setting in the paint. 13499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 13519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of the origin of the text being drawn 13539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 13549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1355f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawText(char[] text, int index, int count, float x, float y, Paint paint) { 13569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((index | count | (index + count) | 13579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project (text.length - index - count)) < 0) { 13589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 13599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1360da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio native_drawText(mNativeCanvas, text, index, count, x, y, paint.mBidiFlags, 1361da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio paint.mNativePaint); 13629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. The 13669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin is interpreted based on the Align setting in the paint. 13679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 13699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 13709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of the origin of the text being drawn 13719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 13729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1373f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt public void drawText(String text, float x, float y, Paint paint) { 1374da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio native_drawText(mNativeCanvas, text, 0, text.length(), x, y, paint.mBidiFlags, 1375da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio paint.mNativePaint); 1376f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 13779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. 13809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The origin is interpreted based on the Align setting in the paint. 13819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 13839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param start The index of the first character in text to draw 13849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param end (end - 1) is the index of the last character in text to draw 13859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 13869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of the origin of the text being drawn 13879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 13889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1389f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawText(String text, int start, int end, float x, float y, Paint paint) { 13909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((start | end | (end - start) | (text.length() - end)) < 0) { 13919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 13929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1393da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio native_drawText(mNativeCanvas, text, start, end, x, y, paint.mBidiFlags, 1394da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio paint.mNativePaint); 13959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified range of text, specified by start/end, with its 13999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin at (x,y), in the specified Paint. The origin is interpreted 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * based on the Align setting in the Paint. 14019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param start The index of the first character in text to draw 14049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param end (end - 1) is the index of the last character in text 14059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to draw 14069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of origin for where to draw the text 14079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of origin for where to draw the text 14089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 14099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1410f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawText(CharSequence text, int start, int end, float x, float y, Paint paint) { 14119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (text instanceof String || text instanceof SpannedString || 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project text instanceof SpannableString) { 1413da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio native_drawText(mNativeCanvas, text.toString(), start, end, x, y, 1414da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio paint.mBidiFlags, paint.mNativePaint); 1415f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else if (text instanceof GraphicsOperations) { 14169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ((GraphicsOperations) text).drawText(this, start, end, x, y, 14179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint); 1418f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else { 1419f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt char[] buf = TemporaryBuffer.obtain(end - start); 1420f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt TextUtils.getChars(text, start, end, buf, 0); 1421da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio native_drawText(mNativeCanvas, buf, 0, end - start, x, y, 1422da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio paint.mBidiFlags, paint.mNativePaint); 1423f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt TemporaryBuffer.recycle(buf); 14249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1425f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1426f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1427f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1428f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * Render a run of all LTR or all RTL text, with shaping. This does not run 1429f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * bidi on the provided text, but renders it as a uniform right-to-left or 1430f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * left-to-right run, as indicated by dir. Alignment of the text is as 1431f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * determined by the Paint's TextAlign value. 1432f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * 1433f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param text the text to render 14340c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param index the start of the text to render 14350c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param count the count of chars to render 14360c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param contextIndex the start of the context for shaping. Must be 14370c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * no greater than index. 14380c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param contextCount the number of characters in the context for shaping. 14390c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * ContexIndex + contextCount must be no less than index 14400c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * + count. 1441f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param x the x position at which to draw the text 1442f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param y the y position at which to draw the text 1443da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * @param dir the run direction, either {@link #DIRECTION_LTR} or 1444da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * {@link #DIRECTION_RTL}. 1445f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param paint the paint 1446f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @hide 1447f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt */ 1448f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawTextRun(char[] text, int index, int count, int contextIndex, int contextCount, 1449da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio float x, float y, int dir, Paint paint) { 1450f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1451f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text == null) { 1452f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("text is null"); 1453f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1454f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (paint == null) { 1455f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("paint is null"); 1456f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 14570c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt if ((index | count | text.length - index - count) < 0) { 1458f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new IndexOutOfBoundsException(); 1459f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1460da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio if (dir != DIRECTION_LTR && dir != DIRECTION_RTL) { 1461da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio throw new IllegalArgumentException("unknown dir: " + dir); 1462da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio } 1463f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 14640c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt native_drawTextRun(mNativeCanvas, text, index, count, 1465da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio contextIndex, contextCount, x, y, dir, paint.mNativePaint); 1466f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1467f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1468f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1469f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * Render a run of all LTR or all RTL text, with shaping. This does not run 1470f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * bidi on the provided text, but renders it as a uniform right-to-left or 1471f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * left-to-right run, as indicated by dir. Alignment of the text is as 1472f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * determined by the Paint's TextAlign value. 14730c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * 1474f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param text the text to render 1475f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param start the start of the text to render. Data before this position 1476f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * can be used for shaping context. 1477f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param end the end of the text to render. Data at or after this 1478f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * position can be used for shaping context. 1479f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param x the x position at which to draw the text 1480f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param y the y position at which to draw the text 1481da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio * @param dir the run direction, either 0 for LTR or 1 for RTL. 1482f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param paint the paint 1483f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @hide 1484f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt */ 1485f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawTextRun(CharSequence text, int start, int end, int contextStart, int contextEnd, 1486da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio float x, float y, int dir, Paint paint) { 1487f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1488f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text == null) { 1489f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("text is null"); 1490f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1491f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (paint == null) { 1492f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("paint is null"); 1493f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1494f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if ((start | end | end - start | text.length() - end) < 0) { 1495f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new IndexOutOfBoundsException(); 1496f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1497f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1498da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio int flags = dir == 0 ? 0 : 1; 1499da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio 1500f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text instanceof String || text instanceof SpannedString || 1501f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt text instanceof SpannableString) { 15020c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt native_drawTextRun(mNativeCanvas, text.toString(), start, end, 1503da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio contextStart, contextEnd, x, y, flags, paint.mNativePaint); 1504f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else if (text instanceof GraphicsOperations) { 15050c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt ((GraphicsOperations) text).drawTextRun(this, start, end, 1506da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio contextStart, contextEnd, x, y, flags, paint); 1507f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else { 15080c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int contextLen = contextEnd - contextStart; 15090c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int len = end - start; 15100c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt char[] buf = TemporaryBuffer.obtain(contextLen); 15110c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt TextUtils.getChars(text, contextStart, contextEnd, buf, 0); 15120c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt native_drawTextRun(mNativeCanvas, buf, start - contextStart, len, 1513da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio 0, contextLen, x, y, flags, paint.mNativePaint); 15149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TemporaryBuffer.recycle(buf); 15159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text in the array, with each character's origin specified by 15209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the pos array. 152162b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * 152262b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * This method does not support glyph composition and decomposition and 152362b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * should therefore not be used to render complex scripts. 15249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index The index of the first character to draw 15279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of characters to draw, starting from index. 15289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pos Array of [x,y] positions, used to position each 15299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * character 15309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 15319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1532f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 1533f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawPosText(char[] text, int index, int count, float[] pos, Paint paint) { 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (index < 0 || index + count > text.length || count*2 > pos.length) { 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 15369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawPosText(mNativeCanvas, text, index, count, pos, 15389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint.mNativePaint); 15399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text in the array, with each character's origin specified by 15439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the pos array. 154462b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * 154562b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * This method does not support glyph composition and decomposition and 154662b6eaa7f3a8111311a7ee097f278eb55865a499Romain Guy * should therefore not be used to render complex scripts. 15479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 15499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pos Array of [x,y] positions, used to position each character 15509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 15519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1552f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy @Deprecated 15539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPosText(String text, float[] pos, Paint paint) { 15549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (text.length()*2 > pos.length) { 15559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 15569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawPosText(mNativeCanvas, text, pos, paint.mNativePaint); 15589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint, along 15629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified path. The paint's Align setting determins where along the 15639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * path to start the text. 15649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 15669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path the text should follow for its baseline 15679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hOffset The distance along the path to add to the text's 15689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * starting position 15699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vOffset The distance above(-) or below(+) the path to position 15709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the text 15719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 15729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawTextOnPath(char[] text, int index, int count, Path path, 1574f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy float hOffset, float vOffset, Paint paint) { 15759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (index < 0 || index + count > text.length) { 15769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 15779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawTextOnPath(mNativeCanvas, text, index, count, 1579da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio path.ni(), hOffset, vOffset, 1580da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio paint.mBidiFlags, paint.mNativePaint); 15819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint, along 15859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified path. The paint's Align setting determins where along the 15869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * path to start the text. 15879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 15899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path the text should follow for its baseline 15909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hOffset The distance along the path to add to the text's 15919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * starting position 15929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vOffset The distance above(-) or below(+) the path to position 15939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the text 15949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 15959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1596f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy public void drawTextOnPath(String text, Path path, float hOffset, float vOffset, Paint paint) { 15979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (text.length() > 0) { 1598f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy native_drawTextOnPath(mNativeCanvas, text, path.ni(), hOffset, vOffset, 1599da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio paint.mBidiFlags, paint.mNativePaint); 16009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Save the canvas state, draw the picture, and restore the canvas state. 16059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This differs from picture.draw(canvas), which does not perform any 16069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * save/restore. 1607cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * 1608cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * <p> 1609cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * <strong>Note:</strong> This forces the picture to internally call 1610cdac497289fd2c39a352f6167dae3f77cc608cb8Derek Sollenberger * {@link Picture#endRecording} in order to prepare for playback. 16119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param picture The picture to be drawn 16139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPicture(Picture picture) { 16159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project picture.endRecording(); 16169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawPicture(mNativeCanvas, picture.ni()); 16179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the picture, stretched to fit into the dst rectangle. 16219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPicture(Picture picture, RectF dst) { 16239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project save(); 16249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(dst.left, dst.top); 16259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (picture.getWidth() > 0 && picture.getHeight() > 0) { 1626f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy scale(dst.width() / picture.getWidth(), dst.height() / picture.getHeight()); 16279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPicture(picture); 16299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project restore(); 16309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the picture, stretched to fit into the dst rectangle. 16349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPicture(Picture picture, Rect dst) { 16369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project save(); 16379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(dst.left, dst.top); 16389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (picture.getWidth() > 0 && picture.getHeight() > 0) { 1639f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy scale((float) dst.width() / picture.getWidth(), 1640f9d9c065ed75f1196316a9a31f92309f602cef76Romain Guy (float) dst.height() / picture.getHeight()); 16419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPicture(picture); 16439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project restore(); 16449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1645da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy 1646da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy /** 1647163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * Free up as much memory as possible from private caches (e.g. fonts, images) 1648caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed * 1649163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @hide 1650caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed */ 1651caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed public static native void freeCaches(); 1652caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed 165330ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio /** 165430ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * Free up text layout caches 165530ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * 165630ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio * @hide 165730ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio */ 165830ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio public static native void freeTextLayoutCaches(); 165930ca5cd11a23f06f2f8eeaa587685450826f800fFabrice Di Meglio 16609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int initRaster(int nativeBitmapOrZero); 16611b63e60abd3082f539b4e1f4562eec2005383ba5Derek Sollenberger private static native void copyNativeCanvasState(int srcCanvas, int dstCanvas); 16629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int native_saveLayer(int nativeCanvas, RectF bounds, 16639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int paint, int layerFlags); 16649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int native_saveLayer(int nativeCanvas, float l, 16659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float t, float r, float b, 16669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int paint, int layerFlags); 16679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int native_saveLayerAlpha(int nativeCanvas, 16689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project RectF bounds, int alpha, 16699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int layerFlags); 16709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int native_saveLayerAlpha(int nativeCanvas, float l, 16719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float t, float r, float b, 16729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int alpha, int layerFlags); 16739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_concat(int nCanvas, int nMatrix); 16759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_setMatrix(int nCanvas, int nMatrix); 16769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean native_clipRect(int nCanvas, 16779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 16789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float right, float bottom, 16799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 16809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean native_clipPath(int nativeCanvas, 16819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativePath, 16829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 16839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean native_clipRegion(int nativeCanvas, 16849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativeRegion, 16859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 16869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeSetDrawFilter(int nativeCanvas, 16879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativeFilter); 16889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean native_getClipBounds(int nativeCanvas, 16899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect bounds); 16909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_getCTM(int canvas, int matrix); 16919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean native_quickReject(int nativeCanvas, 1692ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger RectF rect); 16939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean native_quickReject(int nativeCanvas, 1694ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger int path); 16959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean native_quickReject(int nativeCanvas, 16969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 1697ca79cf69d09efa0c327e9b1237d86a119aea5da7Derek Sollenberger float right, float bottom); 16989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawRGB(int nativeCanvas, int r, int g, 16999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int b); 17009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawARGB(int nativeCanvas, int a, int r, 17019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int g, int b); 17029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawColor(int nativeCanvas, int color); 17039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawColor(int nativeCanvas, int color, 17049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mode); 17059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawPaint(int nativeCanvas, int paint); 17069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawLine(int nativeCanvas, float startX, 17079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float startY, float stopX, 17089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float stopY, int paint); 17099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawRect(int nativeCanvas, RectF rect, 17109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int paint); 17119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawRect(int nativeCanvas, float left, 17129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float top, float right, 17139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float bottom, int paint); 17149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawOval(int nativeCanvas, RectF oval, 17159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int paint); 17169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawCircle(int nativeCanvas, float cx, 17179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float cy, float radius, 17189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int paint); 17199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawArc(int nativeCanvas, RectF oval, 17209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float startAngle, float sweep, 17219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean useCenter, int paint); 17229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawRoundRect(int nativeCanvas, 17239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project RectF rect, float rx, 17249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float ry, int paint); 17259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawPath(int nativeCanvas, int path, 17269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int paint); 17279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native void native_drawBitmap(int nativeCanvas, int bitmap, 17289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 172911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn int nativePaintOrZero, 17300d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int canvasDensity, 17310d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int screenDensity, 17320d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int bitmapDensity); 17339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native void native_drawBitmap(int nativeCanvas, int bitmap, 17349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect src, RectF dst, 17350d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int nativePaintOrZero, 17360d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int screenDensity, 17370d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int bitmapDensity); 17389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawBitmap(int nativeCanvas, int bitmap, 17399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect src, Rect dst, 17400d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int nativePaintOrZero, 17410d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int screenDensity, 17420d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int bitmapDensity); 17439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawBitmap(int nativeCanvas, int[] colors, 17449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offset, int stride, float x, 17459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float y, int width, int height, 17469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean hasAlpha, 17479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativePaintOrZero); 17489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeDrawBitmapMatrix(int nCanvas, int nBitmap, 17499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nMatrix, int nPaint); 17509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeDrawBitmapMesh(int nCanvas, int nBitmap, 17519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int meshWidth, int meshHeight, 17529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] verts, int vertOffset, 17539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] colors, int colorOffset, int nPaint); 17549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeDrawVertices(int nCanvas, int mode, int n, 17559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] verts, int vertOffset, float[] texs, int texOffset, 17569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] colors, int colorOffset, short[] indices, 17579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int indexOffset, int indexCount, int nPaint); 17589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawText(int nativeCanvas, char[] text, 17609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int index, int count, float x, 1761da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio float y, int flags, int paint); 17629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawText(int nativeCanvas, String text, 17639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int start, int end, float x, 1764da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio float y, int flags, int paint); 1765fcf2be1846935e7983ea2fe87fdd4d7af27764b6Fabrice Di Meglio 17660c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt private static native void native_drawTextRun(int nativeCanvas, String text, 17670c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int start, int end, int contextStart, int contextEnd, 1768da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio float x, float y, int flags, int paint); 1769f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 17700c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt private static native void native_drawTextRun(int nativeCanvas, char[] text, 17710c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int start, int count, int contextStart, int contextCount, 1772da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio float x, float y, int flags, int paint); 1773f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 17749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawPosText(int nativeCanvas, 17759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char[] text, int index, 17769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int count, float[] pos, 17779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int paint); 17789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawPosText(int nativeCanvas, 17799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String text, float[] pos, 17809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int paint); 17819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawTextOnPath(int nativeCanvas, 17829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char[] text, int index, 17839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int count, int path, 17849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float hOffset, 1785da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio float vOffset, int bidiFlags, 17864beb8ff7175ebd14b96942724a658f407d0b9951Doug Felt int paint); 17879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawTextOnPath(int nativeCanvas, 17889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String text, int path, 17894beb8ff7175ebd14b96942724a658f407d0b9951Doug Felt float hOffset, 17904beb8ff7175ebd14b96942724a658f407d0b9951Doug Felt float vOffset, 1791da12f389eb4be0c08ca3fa9ca7663f4977858df5Fabrice Di Meglio int flags, int paint); 17929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawPicture(int nativeCanvas, 17939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativePicture); 17949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void finalizer(int nativeCanvas); 17959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1796