Canvas.java revision 5a7b466a2b4b7ced739bd5c31e022de61650545a
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). 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class Canvas { 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // assigned in constructors, freed in finalizer 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int mNativeCanvas; 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Our native canvas can be either a raster, gl, or picture canvas. 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project If we are raster, then mGL will be null, and mBitmap may or may not be 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project present (our default constructor creates a raster canvas but no 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project java-bitmap is). If we are a gl-based, then mBitmap will be null, and 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mGL will not be null. Thus both cannot be non-null, but its possible 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for both to be null. 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Bitmap mBitmap; // if not null, mGL must be null 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"}) 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mSurfaceFormat; 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 66f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * Flag for drawTextRun indicating left-to-right run direction. 67f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @hide 68f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt */ 69f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt public static final int DIRECTION_LTR = 0; 70f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 71f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 72f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * Flag for drawTextRun indicating right-to-left run direction. 73f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @hide 74f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt */ 75f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt public static final int DIRECTION_RTL = 1; 76f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 77e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy private final CanvasFinalizer mFinalizer; 78e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 79e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy private static class CanvasFinalizer { 80e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy private final int mNativeCanvas; 81e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 82e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy public CanvasFinalizer(int nativeCanvas) { 83e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy mNativeCanvas = nativeCanvas; 84e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 85e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 86e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy @Override 87e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy protected void finalize() throws Throwable { 883b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy try { 893b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy if (mNativeCanvas != 0) { 903b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy finalizer(mNativeCanvas); 913b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy } 923b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy } finally { 933b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy super.finalize(); 94e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 95e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 96e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 97e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 98f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Construct an empty raster canvas. Use setBitmap() to specify a bitmap to 10096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * draw into. The initial target density is {@link Bitmap#DENSITY_NONE}; 10196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * this will typically be replaced when a target bitmap is set for the 10296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * canvas. 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Canvas() { 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // 0 means no native bitmap 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNativeCanvas = initRaster(0); 107e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy mFinalizer = new CanvasFinalizer(0); 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Construct a canvas with the specified bitmap to draw into. The bitmap 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * must be mutable. 11396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * 11496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>The initial target density of the canvas is the same as the given 11596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * bitmap's density. 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap Specifies a mutable bitmap for the canvas to draw into. 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Canvas(Bitmap bitmap) { 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!bitmap.isMutable()) { 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException( 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "Immutable bitmap passed to Canvas constructor"); 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throwIfRecycled(bitmap); 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNativeCanvas = initRaster(bitmap.ni()); 126e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy mFinalizer = new CanvasFinalizer(mNativeCanvas); 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBitmap = bitmap; 12896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn mDensity = bitmap.mDensity; 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 131163935113919a184122b8b3bd672ef08c8df65dcRomain Guy Canvas(int nativeCanvas) { 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (nativeCanvas == 0) { 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(); 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNativeCanvas = nativeCanvas; 136e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy mFinalizer = new CanvasFinalizer(nativeCanvas); 13796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn mDensity = Bitmap.getDefaultDensity(); 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 139163935113919a184122b8b3bd672ef08c8df65dcRomain Guy 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 141163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * Returns null. 14296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * 143163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @deprecated This method is not supported and should not be invoked. 1443b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy * 1453b703f2d11f20efaa953ad31d6c97fe3561efb03Romain Guy * @hide 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 147cc3ec6cdb2b892eb29513e72d8b205acbe997b25Gilles Debunne @Deprecated 148163935113919a184122b8b3bd672ef08c8df65dcRomain Guy protected GL getGL() { 149163935113919a184122b8b3bd672ef08c8df65dcRomain Guy return null; 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1512d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy 1522d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy /** 1532d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * Indicates whether this Canvas uses hardware acceleration. 1542d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * 1552d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * Note that this method does not define what type of hardware acceleration 1562d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * may or may not be used. 1572d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * 1582d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * @return True if drawing operations are hardware accelerated, 1592d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * false otherwise. 1602d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy */ 1612d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy public boolean isHardwareAccelerated() { 162163935113919a184122b8b3bd672ef08c8df65dcRomain Guy return false; 163caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed } 164163935113919a184122b8b3bd672ef08c8df65dcRomain Guy 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * Specify a bitmap for the canvas to draw into. As a side-effect, also 16796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * updates the canvas's target density to match that of the bitmap. 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap Specifies a mutable bitmap for the canvas to draw into. 17096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * 17196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @see #setDensity(int) 17296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @see #getDensity() 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setBitmap(Bitmap bitmap) { 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!bitmap.isMutable()) { 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(); 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 178163935113919a184122b8b3bd672ef08c8df65dcRomain Guy if (isHardwareAccelerated()) { 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Can't set a bitmap device on a GL canvas"); 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throwIfRecycled(bitmap); 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_setBitmap(mNativeCanvas, bitmap.ni()); 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBitmap = bitmap; 18596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn mDensity = bitmap.mDensity; 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the viewport dimensions if this canvas is GL based. If it is not, 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this method is ignored and no exception is thrown. 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 192163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @param width The width of the viewport 193163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @param height The height of the viewport 1942d6145993e19d2bb664766dbaf3c1e9ad3d12cdcRomain Guy * 195163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @hide 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setViewport(int width, int height) { 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the device that the current layer draws into is opaque 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (i.e. does not support per-pixel alpha). 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the device that the current layer draws into is opaque 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native boolean isOpaque(); 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the width of the current drawing layer 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the width of the current drawing layer 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native int getWidth(); 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the height of the current drawing layer 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the height of the current drawing layer 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native int getHeight(); 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 22396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>Returns the target density of the canvas. The default density is 22496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * derived from the density of its backing bitmap, or 22596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * {@link Bitmap#DENSITY_NONE} if there is not one.</p> 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @return Returns the current target density of the canvas, which is used 22896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * to determine the scaling factor when drawing a bitmap into it. 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 23011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #setDensity(int) 23111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see Bitmap#getDensity() 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 23311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getDensity() { 23411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return mDensity; 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 23896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>Specifies the density for this Canvas' backing bitmap. This modifies 23996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * the target density of the canvas itself, as well as the density of its 24096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * backing bitmap via {@link Bitmap#setDensity(int) Bitmap.setDensity(int)}. 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 24296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @param density The new target density of the canvas, which is used 24396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * to determine the scaling factor when drawing a bitmap into it. Use 24496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * {@link Bitmap#DENSITY_NONE} to disable bitmap scaling. 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 24611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #getDensity() 24711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see Bitmap#setDensity(int) 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 24911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public void setDensity(int density) { 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mBitmap != null) { 25111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn mBitmap.setDensity(density); 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 25311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn mDensity = density; 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2560d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn /** @hide */ 2570d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn public void setScreenDensity(int density) { 2580d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn mScreenDensity = density; 2590d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn } 2600d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // the SAVE_FLAG constants must match their native equivalents 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** restore the current matrix when restore() is called */ 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int MATRIX_SAVE_FLAG = 0x01; 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** restore the current clip when restore() is called */ 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CLIP_SAVE_FLAG = 0x02; 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** the layer needs to per-pixel alpha */ 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int HAS_ALPHA_LAYER_SAVE_FLAG = 0x04; 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** the layer needs to 8-bits per color component */ 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int FULL_COLOR_LAYER_SAVE_FLAG = 0x08; 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** clip against the layer's bounds */ 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int CLIP_TO_LAYER_SAVE_FLAG = 0x10; 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** restore everything when restore() is called */ 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ALL_SAVE_FLAG = 0x1F; 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Saves the current matrix and clip onto a private stack. Subsequent 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calls to translate,scale,rotate,skew,concat or clipRect,clipPath 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will all operate as usual, but when the balancing call to restore() 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is made, those calls will be forgotten, and the settings that existed 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * before the save() will be reinstated. 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The value to pass to restoreToCount() to balance this save() 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native int save(); 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Based on saveFlags, can save the current matrix and clip onto a private 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * stack. Subsequent calls to translate,scale,rotate,skew,concat or 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect,clipPath will all operate as usual, but when the balancing 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * call to restore() is made, those calls will be forgotten, and the 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * settings that existed before the save() will be reinstated. 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveFlags flag bits that specify which parts of the Canvas state 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to save/restore 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The value to pass to restoreToCount() to balance this save() 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native int save(int saveFlags); 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This behaves the same as save(), but in addition it allocates an 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * offscreen bitmap. All drawing calls are directed there, and only when 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the balancing call to restore() is made is that offscreen transfered to 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the canvas (or the previous layer). Subsequent calls to translate, 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * scale, rotate, skew, concat or clipRect, clipPath all operate on this 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * copy. When the balancing call to restore() is made, this copy is 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * deleted and the previous matrix/clip state is restored. 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds May be null. The maximum size the offscreen bitmap 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * needs to be (in local coordinates) 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint This is copied, and is applied to the offscreen when 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * restore() is called. 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveFlags see _SAVE_FLAG constants 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return value to pass to restoreToCount() to balance this save() 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int saveLayer(RectF bounds, Paint paint, int saveFlags) { 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_saveLayer(mNativeCanvas, bounds, 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint != null ? paint.mNativePaint : 0, 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project saveFlags); 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper version of saveLayer() that takes 4 values rather than a RectF. 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int saveLayer(float left, float top, float right, float bottom, 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Paint paint, int saveFlags) { 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_saveLayer(mNativeCanvas, left, top, right, bottom, 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint != null ? paint.mNativePaint : 0, 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project saveFlags); 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This behaves the same as save(), but in addition it allocates an 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * offscreen bitmap. All drawing calls are directed there, and only when 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the balancing call to restore() is made is that offscreen transfered to 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the canvas (or the previous layer). Subsequent calls to translate, 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * scale, rotate, skew, concat or clipRect, clipPath all operate on this 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * copy. When the balancing call to restore() is made, this copy is 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * deleted and the previous matrix/clip state is restored. 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds The maximum size the offscreen bitmap needs to be 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (in local coordinates) 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param alpha The alpha to apply to the offscreen when when it is 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawn during restore() 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveFlags see _SAVE_FLAG constants 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return value to pass to restoreToCount() to balance this call 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int saveLayerAlpha(RectF bounds, int alpha, int saveFlags) { 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project alpha = Math.min(255, Math.max(0, alpha)); 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_saveLayerAlpha(mNativeCanvas, bounds, alpha, saveFlags); 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for saveLayerAlpha() that takes 4 values instead of a RectF. 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int saveLayerAlpha(float left, float top, float right, float bottom, 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int alpha, int saveFlags) { 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_saveLayerAlpha(mNativeCanvas, left, top, right, bottom, 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project alpha, saveFlags); 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This call balances a previous call to save(), and is used to remove all 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * modifications to the matrix/clip state since the last save call. It is 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an error to call restore() more times than save() was called. 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void restore(); 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the number of matrix/clip states on the Canvas' private stack. 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This will equal # save() calls - # restore() calls. 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native int getSaveCount(); 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Efficient way to pop any calls to save() that happened after the save 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * count reached saveCount. It is an error for saveCount to be less than 1. 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Example: 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * int count = canvas.save(); 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ... // more calls potentially to save() 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * canvas.restoreToCount(count); 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * // now the canvas is back in the same state it was before the initial 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * // call to save(). 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param saveCount The save level to restore to. 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void restoreToCount(int saveCount); 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified translation 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dx The distance to translate in X 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dy The distance to translate in Y 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void translate(float dx, float dy); 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified scale. 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to scale in X 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to scale in Y 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void scale(float sx, float sy); 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified scale. 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to scale in X 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to scale in Y 411cc3ec6cdb2b892eb29513e72d8b205acbe997b25Gilles Debunne * @param px The x-coord for the pivot point (unchanged by the scale) 412cc3ec6cdb2b892eb29513e72d8b205acbe997b25Gilles Debunne * @param py The y-coord for the pivot point (unchanged by the scale) 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void scale(float sx, float sy, float px, float py) { 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(px, py); 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project scale(sx, sy); 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(-px, -py); 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified rotation. 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param degrees The amount to rotate, in degrees 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void rotate(float degrees); 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified rotation. 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param degrees The amount to rotate, in degrees 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param px The x-coord for the pivot point (unchanged by the rotation) 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param py The y-coord for the pivot point (unchanged by the rotation) 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final void rotate(float degrees, float px, float py) { 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(px, py); 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project rotate(degrees); 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(-px, -py); 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified skew. 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sx The amount to skew in X 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sy The amount to skew in Y 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void skew(float sx, float sy); 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Preconcat the current matrix with the specified matrix. 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix to preconcatenate with the current matrix 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void concat(Matrix matrix) { 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_concat(mNativeCanvas, matrix.native_instance); 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Completely replace the current matrix with the specified matrix. If the 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * matrix parameter is null, then the current matrix is reset to identity. 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix to replace the current matrix with. If it is 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * null, set the current matrix to identity. 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setMatrix(Matrix matrix) { 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_setMatrix(mNativeCanvas, 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project matrix == null ? 0 : matrix.native_instance); 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return, in ctm, the current transformation matrix. This does not alter 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the matrix in the canvas, but just returns a copy of it. 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void getMatrix(Matrix ctm) { 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_getCTM(mNativeCanvas, ctm.native_instance); 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 47641030da16856c8869e1e51d4a0405432fa96614eRomain Guy 47741030da16856c8869e1e51d4a0405432fa96614eRomain Guy /** 47841030da16856c8869e1e51d4a0405432fa96614eRomain Guy * Returns a pointer to an internal 4x4 native matrix. The returned 47941030da16856c8869e1e51d4a0405432fa96614eRomain Guy * pointer is a pointer to an array of 16 floats. 48041030da16856c8869e1e51d4a0405432fa96614eRomain Guy * 48141030da16856c8869e1e51d4a0405432fa96614eRomain Guy * @hide 48241030da16856c8869e1e51d4a0405432fa96614eRomain Guy */ 48341030da16856c8869e1e51d4a0405432fa96614eRomain Guy public int getNativeMatrix() { 48441030da16856c8869e1e51d4a0405432fa96614eRomain Guy return 0; 48541030da16856c8869e1e51d4a0405432fa96614eRomain Guy } 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a new matrix with a copy of the canvas' current transformation 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * matrix. 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final Matrix getMatrix() { 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Matrix m = new Matrix(); 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getMatrix(m); 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return m; 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle. 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rect to intersect with the current clip 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipRect(RectF rect, Region.Op op) { 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_clipRect(mNativeCanvas, 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project rect.left, rect.top, rect.right, rect.bottom, 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project op.nativeInt); 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle, which is 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipRect(Rect rect, Region.Op op) { 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_clipRect(mNativeCanvas, 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project rect.left, rect.top, rect.right, rect.bottom, 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project op.nativeInt); 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native boolean clipRect(RectF rect); 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangle to intersect with the current clip. 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native boolean clipRect(Rect rect); 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified rectangle, which is 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipRect(float left, float top, float right, float bottom, 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Region.Op op) { 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_clipRect(mNativeCanvas, left, top, right, bottom, 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project op.nativeInt); 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified rectangle, which is 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * expressed in local coordinates. 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to intersect with the 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current clip 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native boolean clipRect(float left, float top, 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float right, float bottom); 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 left The left side of the rectangle to intersect with the 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to intersect with the current clip 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to intersect with the 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to intersect with the current 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting clip is non-empty 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native boolean clipRect(int left, int top, 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int right, int bottom); 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified path. 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to operate on the current clip 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipPath(Path path, Region.Op op) { 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_clipPath(mNativeCanvas, path.ni(), op.nativeInt); 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified path. 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to intersect with the current clip 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipPath(Path path) { 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return clipPath(path, Region.Op.INTERSECT); 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Modify the current clip with the specified region. Note that unlike 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect() and clipPath() which transform their arguments by the 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, clipRegion() assumes its argument is already in the 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinate system of the current layer's bitmap, and so not 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * transformation is performed. 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param region The region to operate on the current clip, based on op 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param op How the clip is modified 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipRegion(Region region, Region.Op op) { 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_clipRegion(mNativeCanvas, region.ni(), op.nativeInt); 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Intersect the current clip with the specified region. Note that unlike 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clipRect() and clipPath() which transform their arguments by the 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, clipRegion() assumes its argument is already in the 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinate system of the current layer's bitmap, and so not 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * transformation is performed. 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param region The region to operate on the current clip, based on op 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the resulting is non-empty 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean clipRegion(Region region) { 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return clipRegion(region, Region.Op.INTERSECT); 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public DrawFilter getDrawFilter() { 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mDrawFilter; 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setDrawFilter(DrawFilter filter) { 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativeFilter = 0; 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (filter != null) { 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeFilter = filter.mNativeInt; 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDrawFilter = filter; 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeSetDrawFilter(mNativeCanvas, nativeFilter); 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum EdgeType { 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project BW(0), //!< treat edges by just rounding to nearest pixel boundary 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project AA(1); //!< treat edges by rounding-out, since they may be antialiased 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EdgeType(int nativeInt) { 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = nativeInt; 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 665c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy 666c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy /** 667c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy * @hide 668c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy */ 669c7d53494f1fbd9f9d74af89053ff9fdb1ccbac6cRomain Guy public final int nativeInt; 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified rectangle, after being transformed by the 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect the rect to compare with the current clip 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param type specifies how to treat the edges (BW or antialiased) 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the rect (transformed by the canvas' matrix) 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean quickReject(RectF rect, EdgeType type) { 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_quickReject(mNativeCanvas, rect, type.nativeInt); 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified path, after being transformed by the 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). Note: for speed it may 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * return false even if the path itself might not intersect the clip 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (i.e. the bounds of the path intersects, but the path does not). 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to compare with the current clip 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param type true if the path should be considered antialiased, 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * since that means it may 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * affect a larger area (more pixels) than 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * non-antialiased. 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the path (transformed by the canvas' matrix) 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean quickReject(Path path, EdgeType type) { 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_quickReject(mNativeCanvas, path.ni(), type.nativeInt); 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if the specified rectangle, after being transformed by the 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current matrix, would lie completely outside of the current clip. Call 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this to check if an area you intend to draw into is clipped out (and 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * therefore you can skip making the draw calls). 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to compare with the 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top of the rectangle to compare with the current 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * clip 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to compare with the 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom of the rectangle to compare with the 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * current clip 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param type true if the rect should be considered antialiased, 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * since that means it may affect a larger area (more 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pixels) than non-antialiased. 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the rect (transformed by the canvas' matrix) 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * does not intersect with the canvas' clip 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean quickReject(float left, float top, float right, float bottom, 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project EdgeType type) { 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_quickReject(mNativeCanvas, left, top, right, bottom, 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project type.nativeInt); 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the clip bounds, returning true if they are non-empty. 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bounds Return the clip bounds here. If it is null, ignore it but 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * still return true if the current clip is non-empty. 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the current clip is non-empty. 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean getClipBounds(Rect bounds) { 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return native_getClipBounds(mNativeCanvas, bounds); 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the clip bounds. 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the clip bounds, or [0, 0, 0, 0] if the clip is empty. 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final Rect getClipBounds() { 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect r = new Rect(); 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getClipBounds(r); 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return r; 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified RGB color, using srcover porterduff mode. 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r red component (0..255) of the color to draw onto the canvas 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param g green component (0..255) of the color to draw onto the canvas 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param b blue component (0..255) of the color to draw onto the canvas 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRGB(int r, int g, int b) { 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawRGB(mNativeCanvas, r, g, b); 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified ARGB color, using srcover porterduff mode. 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param a alpha component (0..255) of the color to draw onto the canvas 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r red component (0..255) of the color to draw onto the canvas 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param g green component (0..255) of the color to draw onto the canvas 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param b blue component (0..255) of the color to draw onto the canvas 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawARGB(int a, int r, int g, int b) { 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawARGB(mNativeCanvas, a, r, g, b); 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified color, using srcover porterduff mode. 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param color the color to draw onto the canvas 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawColor(int color) { 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawColor(mNativeCanvas, color); 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with the 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified color and porter-duff xfermode. 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param color the color to draw with 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode the porter-duff mode to apply to the color 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawColor(int color, PorterDuff.Mode mode) { 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawColor(mNativeCanvas, color, mode.nativeInt); 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fill the entire canvas' bitmap (restricted to the current clip) with 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified paint. This is equivalent (but faster) to drawing an 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * infinitely large rectangle with the specified paint. 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw onto the canvas 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPaint(Paint paint) { 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawPaint(mNativeCanvas, paint.mNativePaint); 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a series of points. Each point is centered at the coordinate 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified by pts[], and its diameter is specified by the paint's stroke 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * width (as transformed by the canvas' CTM), with special treatment for 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a stroke width of 0, which always draws exactly 1 pixel (or at most 4 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if antialiasing is enabled). The shape of the point is controlled by 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the paint's Cap type. The shape is a square, unless the cap type is 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Round, in which case the shape is a circle. 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pts Array of points to draw [x0 y0 x1 y1 x2 y2 ...] 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Number of values to skip before starting to draw. 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of values to process, after skipping offset 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of them. Since one point uses two values, the number of 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * "points" that are drawn is really (count >> 1). 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the points 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void drawPoints(float[] pts, int offset, int count, 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Paint paint); 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for drawPoints() that assumes you want to draw the entire array 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPoints(float[] pts, Paint paint) { 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPoints(pts, 0, pts.length, paint); 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Helper for drawPoints() for drawing a single point. 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void drawPoint(float x, float y, Paint paint); 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a line segment with the specified start and stop x,y coordinates, 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * using the specified paint. NOTE: since a line is always "framed", the 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Style is ignored in the paint. 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startX The x-coordinate of the start point of the line 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startY The y-coordinate of the start point of the line 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the line 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawLine(float startX, float startY, float stopX, float stopY, 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Paint paint) { 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawLine(mNativeCanvas, startX, startY, stopX, stopY, 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint.mNativePaint); 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw a series of lines. Each line is taken from 4 consecutive values 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the pts array. Thus to draw 1 line, the array must contain at least 4 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * values. This is logically the same as drawing the array as follows: 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawLine(pts[0], pts[1], pts[2], pts[3]) followed by 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawLine(pts[4], pts[5], pts[6], pts[7]) and so on. 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pts Array of points to draw [x0 y0 x1 y1 x2 y2 ...] 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Number of values in the array to skip before drawing. 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of values in the array to process, after 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * skipping "offset" of them. Since each line uses 4 values, 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the number of "lines" that are drawn is really 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (count >> 2). 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the points 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native void drawLines(float[] pts, int offset, int count, 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Paint paint); 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawLines(float[] pts, Paint paint) { 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawLines(pts, 0, pts.length, paint); 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified paint. The rectangle will 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be filled or framed based on the Style in the paint. 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rect to be drawn 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rect 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRect(RectF rect, Paint paint) { 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawRect(mNativeCanvas, rect, paint.mNativePaint); 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified Paint. The rectangle 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be filled or framed based on the Style in the paint. 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param r The rectangle to be drawn. 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rectangle 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRect(Rect r, Paint paint) { 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawRect(r.left, r.top, r.right, r.bottom, paint); 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified Rect using the specified paint. The rectangle will 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be filled or framed based on the Style in the paint. 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The left side of the rectangle to be drawn 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The top side of the rectangle to be drawn 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param right The right side of the rectangle to be drawn 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bottom The bottom side of the rectangle to be drawn 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the rect 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRect(float left, float top, float right, float bottom, 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Paint paint) { 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawRect(mNativeCanvas, left, top, right, bottom, 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint.mNativePaint); 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified oval using the specified paint. The oval will be 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * filled or framed based on the Style in the paint. 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param oval The rectangle bounds of the oval to be drawn 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawOval(RectF oval, Paint paint) { 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (oval == null) { 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawOval(mNativeCanvas, oval, paint.mNativePaint); 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified circle using the specified paint. If radius is <= 0, 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then nothing will be drawn. The circle will be filled or framed based 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on the Style in the paint. 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cx The x-coordinate of the center of the cirle to be drawn 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param cy The y-coordinate of the center of the cirle to be drawn 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param radius The radius of the cirle to be drawn 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the circle 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawCircle(float cx, float cy, float radius, Paint paint) { 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawCircle(mNativeCanvas, cx, cy, radius, 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint.mNativePaint); 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified arc, which will be scaled to fit inside the 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specified oval. If the sweep angle is >= 360, then the oval is drawn 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * completely. Note that this differs slightly from SkPath::arcTo, which 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * treats the sweep angle mod 360. 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param oval The bounds of oval used to define the shape and size 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the arc 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param startAngle Starting angle (in degrees) where the arc begins 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param sweepAngle Sweep angle (in degrees) measured clockwise 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param useCenter If true, include the center of the oval in the arc, and 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project close it if it is being stroked. This will draw a wedge 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the arc 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawArc(RectF oval, float startAngle, float sweepAngle, 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean useCenter, Paint paint) { 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (oval == null) { 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawArc(mNativeCanvas, oval, startAngle, sweepAngle, 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project useCenter, paint.mNativePaint); 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified round-rect using the specified paint. The roundrect 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be filled or framed based on the Style in the paint. 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rect The rectangular bounds of the roundRect to be drawn 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rx The x-radius of the oval used to round the corners 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param ry The y-radius of the oval used to round the corners 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the roundRect 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawRoundRect(RectF rect, float rx, float ry, Paint paint) { 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (rect == null) { 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawRoundRect(mNativeCanvas, rect, rx, ry, 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint.mNativePaint); 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified path using the specified paint. The path will be 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * filled or framed based on the Style in the paint. 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path to be drawn 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the path 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPath(Path path, Paint paint) { 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawPath(mNativeCanvas, path.ni(), paint.mNativePaint); 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void throwIfRecycled(Bitmap bitmap) { 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bitmap.isRecycled()) { 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException( 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "Canvas: trying to use a recycled bitmap " + bitmap); 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1006deba785f122a47915756ffd991f5540d952cf937Romain Guy * Draws the specified bitmap as an N-patch (most often, a 9-patches.) 1007deba785f122a47915756ffd991f5540d952cf937Romain Guy * 1008deba785f122a47915756ffd991f5540d952cf937Romain Guy * Note: Only supported by hardware accelerated canvas at the moment. 1009deba785f122a47915756ffd991f5540d952cf937Romain Guy * 1010deba785f122a47915756ffd991f5540d952cf937Romain Guy * @param bitmap The bitmap to draw as an N-patch 1011deba785f122a47915756ffd991f5540d952cf937Romain Guy * @param chunks The patches information (matches the native struct Res_png_9patch) 1012deba785f122a47915756ffd991f5540d952cf937Romain Guy * @param dst The destination rectangle. 1013deba785f122a47915756ffd991f5540d952cf937Romain Guy * @param paint The paint to draw the bitmap with. may be null 1014deba785f122a47915756ffd991f5540d952cf937Romain Guy * 1015deba785f122a47915756ffd991f5540d952cf937Romain Guy * @hide 1016deba785f122a47915756ffd991f5540d952cf937Romain Guy */ 1017deba785f122a47915756ffd991f5540d952cf937Romain Guy public void drawPatch(Bitmap bitmap, byte[] chunks, RectF dst, Paint paint) { 1018deba785f122a47915756ffd991f5540d952cf937Romain Guy } 1019deba785f122a47915756ffd991f5540d952cf937Romain Guy 1020deba785f122a47915756ffd991f5540d952cf937Romain Guy /** 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, with its top/left corner at (x,y), using 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified paint, transformed by the current matrix. 102311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 102411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 103011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>If the bitmap and canvas have different densities, this function 103111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * will take care of automatically scaling the bitmap to draw at the 103211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * same density as the canvas. 103311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 10349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param left The position of the left side of the bitmap being drawn 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param top The position of the top side of the bitmap being drawn 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used to draw the bitmap (may be null) 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(Bitmap bitmap, float left, float top, Paint paint) { 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throwIfRecycled(bitmap); 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawBitmap(mNativeCanvas, bitmap.ni(), left, top, 10420d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn paint != null ? paint.mNativePaint : 0, mDensity, mScreenDensity, 10430d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn bitmap.mDensity); 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, scaling/translating automatically to fill 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the destination rectangle. If the source rectangle is not null, it 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specifies the subset of the bitmap to draw. 105011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 105111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 10559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 105711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>This function <em>ignores the density associated with the bitmap</em>. 105811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * This is because the source and destination rectangle coordinate 105911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * spaces are in their respective densities, so must already have the 106011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * appropriate scaling factor applied. 106111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param src May be null. The subset of the bitmap to be drawn 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dst The rectangle that the bitmap will be scaled/translated 10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to fit into 10669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(Bitmap bitmap, Rect src, RectF dst, Paint paint) { 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (dst == null) { 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throwIfRecycled(bitmap); 10739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawBitmap(mNativeCanvas, bitmap.ni(), src, dst, 10740d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn paint != null ? paint.mNativePaint : 0, 10750d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn mScreenDensity, bitmap.mDensity); 10769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified bitmap, scaling/translating automatically to fill 10809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the destination rectangle. If the source rectangle is not null, it 10819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specifies the subset of the bitmap to draw. 108211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 108311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Note: if the paint contains a maskfilter that generates a mask which 10849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * extends beyond the bitmap's original width/height (e.g. BlurMaskFilter), 10859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the bitmap will be drawn as if it were in a Shader with CLAMP mode. 10869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Thus the color outside of the original width/height will be the edge 10879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color replicated. 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 108911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>This function <em>ignores the density associated with the bitmap</em>. 109011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * This is because the source and destination rectangle coordinate 109111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * spaces are in their respective densities, so must already have the 109211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * appropriate scaling factor applied. 109311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to be drawn 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param src May be null. The subset of the bitmap to be drawn 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dst The rectangle that the bitmap will be scaled/translated 10979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to fit into 10989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(Bitmap bitmap, Rect src, Rect dst, Paint paint) { 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (dst == null) { 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 11039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throwIfRecycled(bitmap); 11059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawBitmap(mNativeCanvas, bitmap.ni(), src, dst, 11060d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn paint != null ? paint.mNativePaint : 0, 11070d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn mScreenDensity, bitmap.mDensity); 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Treat the specified array of colors as a bitmap, and draw it. This gives 11129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the same result as first creating a bitmap from the array, and then 11139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawing it, but this method avoids explicitly creating a bitmap object 11149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * which can be more efficient if the colors are changing often. 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors Array of colors representing the pixels of the bitmap 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Offset into the array of colors for the first pixel 111883d522290e56f614d0d9373d47c2b54b9e207795Brad Fitzpatrick * @param stride The number of colors in the array between rows (must be 11199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * >= width or <= -width). 11209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The X coordinate for where to draw the bitmap 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The Y coordinate for where to draw the bitmap 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The width of the bitmap 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The height of the bitmap 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hasAlpha True if the alpha channel of the colors contains valid 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * values. If false, the alpha byte is ignored (assumed to 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be 0xFF for every pixel). 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(int[] colors, int offset, int stride, float x, 11309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float y, int width, int height, boolean hasAlpha, 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Paint paint) { 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // check for valid input 11339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width < 0) { 11349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("width must be >= 0"); 11359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (height < 0) { 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("height must be >= 0"); 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (Math.abs(stride) < width) { 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("abs(stride) must be >= width"); 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int lastScanline = offset + (height - 1) * stride; 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = colors.length; 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (offset < 0 || (offset + width > length) || lastScanline < 0 11459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (lastScanline + width > length)) { 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // quick escape if there's nothing to draw 11499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width == 0 || height == 0) { 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // punch down to native for the actual draw 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawBitmap(mNativeCanvas, colors, offset, stride, x, y, width, height, hasAlpha, 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint != null ? paint.mNativePaint : 0); 11559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Legacy version of drawBitmap(int[] colors, ...) that took ints for x,y 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(int[] colors, int offset, int stride, int x, int y, 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int width, int height, boolean hasAlpha, 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Paint paint) { 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // call through to the common float version 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawBitmap(colors, offset, stride, (float)x, (float)y, width, height, 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project hasAlpha, paint); 11659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the bitmap using the specified matrix. 11699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to draw 11719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param matrix The matrix used to transform the bitmap when it is drawn 11729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 11739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmap(Bitmap bitmap, Matrix matrix, Paint paint) { 11759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeDrawBitmapMatrix(mNativeCanvas, bitmap.ni(), matrix.ni(), 11769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint != null ? paint.mNativePaint : 0); 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11785a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy 11795a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy /** 11805a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy * @hide 11815a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy */ 11825a7b466a2b4b7ced739bd5c31e022de61650545aRomain Guy protected static void checkRange(int length, int offset, int count) { 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((offset | count) < 0 || offset + count > length) { 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 11859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the bitmap through the mesh, where mesh vertices are evenly 11909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed across the bitmap. There are meshWidth+1 vertices across, and 11919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * meshHeight+1 vertices down. The verts array is accessed in row-major 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * order, so that the first meshWidth+1 vertices are distributed across the 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * top of the bitmap from left to right. A more general version of this 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * methid is drawVertices(). 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bitmap The bitmap to draw using the mesh 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param meshWidth The number of columns in the mesh. Nothing is drawn if 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this is 0 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param meshHeight The number of rows in the mesh. Nothing is drawn if 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this is 0 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param verts Array of x,y pairs, specifying where the mesh should be 12029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawn. There must be at least 12039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (meshWidth+1) * (meshHeight+1) * 2 + meshOffset values 12049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the array 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertOffset Number of verts elements to skip before drawing 12069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors May be null. Specifies a color at each vertex, which is 12079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * interpolated across the cell, and whose values are 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * multiplied by the corresponding bitmap colors. If not null, 12099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * there must be at least (meshWidth+1) * (meshHeight+1) + 12109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * colorOffset values in the array. 12119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colorOffset Number of color elements to skip before drawing 12129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint May be null. The paint used to draw the bitmap 12139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawBitmapMesh(Bitmap bitmap, int meshWidth, int meshHeight, 12159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] verts, int vertOffset, 12169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] colors, int colorOffset, Paint paint) { 12179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((meshWidth | meshHeight | vertOffset | colorOffset) < 0) { 12189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 12199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (meshWidth == 0 || meshHeight == 0) { 12219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int count = (meshWidth + 1) * (meshHeight + 1); 12249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we mul by 2 since we need two floats per vertex 12259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(verts.length, vertOffset, count * 2); 12269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (colors != null) { 12279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // no mul by 2, since we need only 1 color per vertex 12289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(colors.length, colorOffset, count); 12299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeDrawBitmapMesh(mNativeCanvas, bitmap.ni(), meshWidth, meshHeight, 12319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project verts, vertOffset, colors, colorOffset, 12329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint != null ? paint.mNativePaint : 0); 12339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum VertexMode { 12369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLES(0), 12379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLE_STRIP(1), 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TRIANGLE_FAN(2); 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project VertexMode(int nativeInt) { 12419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = nativeInt; 12429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int nativeInt; 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the array of vertices, interpreted as triangles (based on mode). The 12489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * verts array is required, and specifies the x,y pairs for each vertex. If 12499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * texs is non-null, then it is used to specify the coordinate in shader 12509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * coordinates to use at each vertex (the paint must have a shader in this 12519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * case). If there is no texs array, but there is a color array, then each 12529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * color is interpolated across its corresponding triangle in a gradient. If 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * both texs and colors arrays are present, then they behave as before, but 12549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the resulting color at each pixels is the result of multiplying the 12559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * colors from the shader and the color-gradient together. The indices array 12569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is optional, but if it is present, then it is used to specify the index 12579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of each triangle, rather than just walking through the arrays in order. 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param mode How to interpret the array of vertices 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertexCount The number of values in the vertices array (and 12619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * corresponding texs and colors arrays if non-null). Each logical 12629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex is two values (x, y), vertexCount must be a multiple of 2. 12639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param verts Array of vertices for the mesh 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vertOffset Number of values in the verts to skip before drawing. 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param texs May be null. If not null, specifies the coordinates to sample 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * into the current shader (e.g. bitmap tile or gradient) 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param texOffset Number of values in texs to skip before drawing. 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors May be null. If not null, specifies a color for each 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex, to be interpolated across the triangle. 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colorOffset Number of values in colors to skip before drawing. 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param indices If not null, array of indices to reference into the 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * vertex (texs, colors) array. 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param indexCount number of entries in the indices array (if not null). 12749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint Specifies the shader to use if the texs array is non-null. 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawVertices(VertexMode mode, int vertexCount, 12779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] verts, int vertOffset, 12789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] texs, int texOffset, 12799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] colors, int colorOffset, 12809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project short[] indices, int indexOffset, 12819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int indexCount, Paint paint) { 12829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(verts.length, vertOffset, vertexCount); 12839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (texs != null) { 12849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(texs.length, texOffset, vertexCount); 12859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (colors != null) { 128792ce5734b52ef014c80cc6335112a027188b3eb6Erik Faye-Lund checkRange(colors.length, colorOffset, vertexCount / 2); 12889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (indices != null) { 12909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRange(indices.length, indexOffset, indexCount); 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeDrawVertices(mNativeCanvas, mode.nativeInt, vertexCount, verts, 12939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project vertOffset, texs, texOffset, colors, colorOffset, 12949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project indices, indexOffset, indexCount, paint.mNativePaint); 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. The 12999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin is interpreted based on the Align setting in the paint. 13009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 13029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 13039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of the origin of the text being drawn 13049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 13059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawText(char[] text, int index, int count, float x, float y, 13079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Paint paint) { 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((index | count | (index + count) | 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project (text.length - index - count)) < 0) { 13109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 13119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1312f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt native_drawText(mNativeCanvas, text, index, count, x, y, paint.mBidiFlags, 1313f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt paint.mNativePaint); 13149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. The 13189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin is interpreted based on the Align setting in the paint. 13199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 13219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of the origin of the text being drawn 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1325f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt public void drawText(String text, float x, float y, Paint paint) { 1326f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt native_drawText(mNativeCanvas, text, 0, text.length(), x, y, paint.mBidiFlags, 1327f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt paint.mNativePaint); 1328f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 13299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint. 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The origin is interpreted based on the Align setting in the paint. 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param start The index of the first character in text to draw 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param end (end - 1) is the index of the last character in text to draw 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of the origin of the text being drawn 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of the origin of the text being drawn 13399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 13409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawText(String text, int start, int end, float x, float y, 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Paint paint) { 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if ((start | end | (end - start) | (text.length() - end)) < 0) { 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1346f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt native_drawText(mNativeCanvas, text, start, end, x, y, paint.mBidiFlags, 1347f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt paint.mNativePaint); 13489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the specified range of text, specified by start/end, with its 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * origin at (x,y), in the specified Paint. The origin is interpreted 13539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * based on the Align setting in the Paint. 13549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 13569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param start The index of the first character in text to draw 13579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param end (end - 1) is the index of the last character in text 13589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to draw 13599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x-coordinate of origin for where to draw the text 13609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y-coordinate of origin for where to draw the text 13619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 13629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawText(CharSequence text, int start, int end, float x, 13649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float y, Paint paint) { 13659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (text instanceof String || text instanceof SpannedString || 13669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project text instanceof SpannableString) { 13679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawText(mNativeCanvas, text.toString(), start, end, x, y, 1368f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt paint.mBidiFlags, paint.mNativePaint); 1369f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else if (text instanceof GraphicsOperations) { 13709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ((GraphicsOperations) text).drawText(this, start, end, x, y, 13719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint); 1372f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else { 1373f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt char[] buf = TemporaryBuffer.obtain(end - start); 1374f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt TextUtils.getChars(text, start, end, buf, 0); 1375f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt native_drawText(mNativeCanvas, buf, 0, end - start, x, y, 1376f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt paint.mBidiFlags, paint.mNativePaint); 1377f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt TemporaryBuffer.recycle(buf); 13789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1379f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1380f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1381f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1382f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * Render a run of all LTR or all RTL text, with shaping. This does not run 1383f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * bidi on the provided text, but renders it as a uniform right-to-left or 1384f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * left-to-right run, as indicated by dir. Alignment of the text is as 1385f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * determined by the Paint's TextAlign value. 1386f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * 1387f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param text the text to render 13880c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param index the start of the text to render 13890c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param count the count of chars to render 13900c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param contextIndex the start of the context for shaping. Must be 13910c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * no greater than index. 13920c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param contextCount the number of characters in the context for shaping. 13930c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * ContexIndex + contextCount must be no less than index 13940c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * + count. 1395f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param x the x position at which to draw the text 1396f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param y the y position at which to draw the text 13970c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * @param dir the run direction, either {@link #DIRECTION_LTR} or 13980c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * {@link #DIRECTION_RTL}. 1399f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param paint the paint 1400f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @hide 1401f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt */ 14020c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt public void drawTextRun(char[] text, int index, int count, 14030c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int contextIndex, int contextCount, float x, float y, int dir, 1404f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt Paint paint) { 1405f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1406f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text == null) { 1407f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("text is null"); 1408f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1409f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (paint == null) { 1410f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("paint is null"); 1411f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 14120c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt if ((index | count | text.length - index - count) < 0) { 1413f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new IndexOutOfBoundsException(); 1414f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1415f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (dir != DIRECTION_LTR && dir != DIRECTION_RTL) { 1416f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new IllegalArgumentException("unknown dir: " + dir); 1417f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1418f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 14190c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt native_drawTextRun(mNativeCanvas, text, index, count, 14200c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt contextIndex, contextCount, x, y, dir, paint.mNativePaint); 1421f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1422f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1423f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt /** 1424f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * Render a run of all LTR or all RTL text, with shaping. This does not run 1425f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * bidi on the provided text, but renders it as a uniform right-to-left or 1426f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * left-to-right run, as indicated by dir. Alignment of the text is as 1427f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * determined by the Paint's TextAlign value. 14280c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt * 1429f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param text the text to render 1430f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param start the start of the text to render. Data before this position 1431f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * can be used for shaping context. 1432f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param end the end of the text to render. Data at or after this 1433f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * position can be used for shaping context. 1434f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param x the x position at which to draw the text 1435f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param y the y position at which to draw the text 1436f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param dir the run direction, either 0 for LTR or 1 for RTL. 1437f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @param paint the paint 1438f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt * @hide 1439f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt */ 14400c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt public void drawTextRun(CharSequence text, int start, int end, 14410c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int contextStart, int contextEnd, float x, float y, int dir, 14420c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt Paint paint) { 1443f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1444f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text == null) { 1445f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("text is null"); 1446f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1447f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (paint == null) { 1448f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new NullPointerException("paint is null"); 1449f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1450f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if ((start | end | end - start | text.length() - end) < 0) { 1451f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt throw new IndexOutOfBoundsException(); 1452f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } 1453f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1454f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt int flags = dir == 0 ? 0 : 1; 1455f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 1456f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt if (text instanceof String || text instanceof SpannedString || 1457f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt text instanceof SpannableString) { 14580c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt native_drawTextRun(mNativeCanvas, text.toString(), start, end, 14590c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt contextStart, contextEnd, x, y, flags, paint.mNativePaint); 1460f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else if (text instanceof GraphicsOperations) { 14610c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt ((GraphicsOperations) text).drawTextRun(this, start, end, 14620c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt contextStart, contextEnd, x, y, flags, paint); 1463f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt } else { 14640c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int contextLen = contextEnd - contextStart; 14650c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int len = end - start; 14660c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt char[] buf = TemporaryBuffer.obtain(contextLen); 14670c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt TextUtils.getChars(text, contextStart, contextEnd, buf, 0); 14680c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt native_drawTextRun(mNativeCanvas, buf, start - contextStart, len, 14690c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt 0, contextLen, x, y, flags, paint.mNativePaint); 14709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project TemporaryBuffer.recycle(buf); 14719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text in the array, with each character's origin specified by 14769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the pos array. 14779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 14799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index The index of the first character to draw 14809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param count The number of characters to draw, starting from index. 14819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pos Array of [x,y] positions, used to position each 14829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * character 14839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 14849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPosText(char[] text, int index, int count, float[] pos, 14869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Paint paint) { 14879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (index < 0 || index + count > text.length || count*2 > pos.length) { 14889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IndexOutOfBoundsException(); 14899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawPosText(mNativeCanvas, text, index, count, pos, 14919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint.mNativePaint); 14929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text in the array, with each character's origin specified by 14969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the pos array. 14979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 14999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pos Array of [x,y] positions, used to position each character 15009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 15019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPosText(String text, float[] pos, Paint paint) { 15039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (text.length()*2 > pos.length) { 15049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 15059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawPosText(mNativeCanvas, text, pos, paint.mNativePaint); 15079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint, along 15119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified path. The paint's Align setting determins where along the 15129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * path to start the text. 15139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 15159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path the text should follow for its baseline 15169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hOffset The distance along the path to add to the text's 15179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * starting position 15189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vOffset The distance above(-) or below(+) the path to position 15199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the text 15209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawTextOnPath(char[] text, int index, int count, Path path, 15239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float hOffset, float vOffset, Paint paint) { 15249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (index < 0 || index + count > text.length) { 15259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawTextOnPath(mNativeCanvas, text, index, count, 15289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project path.ni(), hOffset, vOffset, 15294beb8ff7175ebd14b96942724a658f407d0b9951Doug Felt paint.mBidiFlags, paint.mNativePaint); 15309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the text, with origin at (x,y), using the specified paint, along 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the specified path. The paint's Align setting determins where along the 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * path to start the text. 15369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param text The text to be drawn 15389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param path The path the text should follow for its baseline 15399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hOffset The distance along the path to add to the text's 15409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * starting position 15419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param vOffset The distance above(-) or below(+) the path to position 15429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the text 15439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint The paint used for the text (e.g. color, size, style) 15449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawTextOnPath(String text, Path path, float hOffset, 15469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float vOffset, Paint paint) { 15479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (text.length() > 0) { 15489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawTextOnPath(mNativeCanvas, text, path.ni(), 15494beb8ff7175ebd14b96942724a658f407d0b9951Doug Felt hOffset, vOffset, paint.mBidiFlags, 15504beb8ff7175ebd14b96942724a658f407d0b9951Doug Felt paint.mNativePaint); 15519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Save the canvas state, draw the picture, and restore the canvas state. 15569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This differs from picture.draw(canvas), which does not perform any 15579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * save/restore. 15589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param picture The picture to be drawn 15609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPicture(Picture picture) { 15629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project picture.endRecording(); 15639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project native_drawPicture(mNativeCanvas, picture.ni()); 15649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the picture, stretched to fit into the dst rectangle. 15689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPicture(Picture picture, RectF dst) { 15709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project save(); 15719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(dst.left, dst.top); 15729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (picture.getWidth() > 0 && picture.getHeight() > 0) { 15739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project scale(dst.width() / picture.getWidth(), 15749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dst.height() / picture.getHeight()); 15759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPicture(picture); 15779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project restore(); 15789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Draw the picture, stretched to fit into the dst rectangle. 15829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void drawPicture(Picture picture, Rect dst) { 15849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project save(); 15859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project translate(dst.left, dst.top); 15869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (picture.getWidth() > 0 && picture.getHeight() > 0) { 15879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project scale((float)dst.width() / picture.getWidth(), 15889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project (float)dst.height() / picture.getHeight()); 15899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project drawPicture(picture); 15919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project restore(); 15929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1593da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy 1594da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy /** 1595da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * <p>Acquires the Canvas context. After invoking this method, the Canvas 1596da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * context can be modified by the caller. For instance, if you acquire 1597da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * the context of an OpenGL Canvas you can reset the GL viewport, scissor, 1598da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * etc.</p> 1599da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * 1600da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * <p>A call to {@link #acquireContext()} should aways be followed by 1601da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * a call to {@link #releaseContext()}, preferrably using a try block:</p> 1602da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * 1603da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * <pre> 1604da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * try { 1605da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * if (canvas.acquireContext()) { 1606da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * // Use the canvas and/or its context 1607da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * } 1608da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * } finally { 1609da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * canvas.releaseContext(); 1610da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * } 1611da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * </pre> 1612da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * 1613da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * <p>Acquiring the context can be an expensive operation and should not 1614da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * be done unless absolutely necessary.</p> 1615da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * 1616da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * <p>Applications should never invoke this method directly.</p> 1617da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * 1618da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * @return True if the context could be acquired successfully, false 1619da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * otherwise (if the context is already acquired for instance.) 1620da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * 1621da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * @see #releaseContext() 1622da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * 1623da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * @hide 1624da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy */ 1625da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy public boolean acquireContext() { 1626da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy return false; 1627da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy } 1628da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy 1629da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy /** 1630da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * <p>Release the context acquired with {@link #acquireContext()}.</p> 1631da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * 1632da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * @see #acquireContext() 1633da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * 1634da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy * @hide 1635da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy */ 1636da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy public void releaseContext() { 1637da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy } 1638da8532c6f48b4c10b5e2ccb9e08690341efa1616Romain Guy 1639caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed /** 1640163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * Free up as much memory as possible from private caches (e.g. fonts, images) 1641caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed * 1642163935113919a184122b8b3bd672ef08c8df65dcRomain Guy * @hide 1643caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed */ 1644caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed public static native void freeCaches(); 1645caf0df1b7f99736aed1a0b923ef278fc4fd0fccaMike Reed 16469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int initRaster(int nativeBitmapOrZero); 16479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_setBitmap(int nativeCanvas, int bitmap); 16489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int native_saveLayer(int nativeCanvas, RectF bounds, 16499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int paint, int layerFlags); 16509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int native_saveLayer(int nativeCanvas, float l, 16519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float t, float r, float b, 16529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int paint, int layerFlags); 16539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int native_saveLayerAlpha(int nativeCanvas, 16549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project RectF bounds, int alpha, 16559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int layerFlags); 16569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int native_saveLayerAlpha(int nativeCanvas, float l, 16579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float t, float r, float b, 16589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int alpha, int layerFlags); 16599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_concat(int nCanvas, int nMatrix); 16619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_setMatrix(int nCanvas, int nMatrix); 16629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean native_clipRect(int nCanvas, 16639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 16649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float right, float bottom, 16659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 16669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean native_clipPath(int nativeCanvas, 16679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativePath, 16689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 16699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean native_clipRegion(int nativeCanvas, 16709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativeRegion, 16719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int regionOp); 16729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeSetDrawFilter(int nativeCanvas, 16739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativeFilter); 16749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean native_getClipBounds(int nativeCanvas, 16759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect bounds); 16769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_getCTM(int canvas, int matrix); 16779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean native_quickReject(int nativeCanvas, 16789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project RectF rect, 16799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int native_edgeType); 16809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean native_quickReject(int nativeCanvas, 16819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int path, 16829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int native_edgeType); 16839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean native_quickReject(int nativeCanvas, 16849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 16859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float right, float bottom, 16869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int native_edgeType); 16879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawRGB(int nativeCanvas, int r, int g, 16889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int b); 16899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawARGB(int nativeCanvas, int a, int r, 16909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int g, int b); 16919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawColor(int nativeCanvas, int color); 16929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawColor(int nativeCanvas, int color, 16939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mode); 16949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawPaint(int nativeCanvas, int paint); 16959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawLine(int nativeCanvas, float startX, 16969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float startY, float stopX, 16979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float stopY, int paint); 16989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawRect(int nativeCanvas, RectF rect, 16999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int paint); 17009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawRect(int nativeCanvas, float left, 17019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float top, float right, 17029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float bottom, int paint); 17039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawOval(int nativeCanvas, RectF oval, 17049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int paint); 17059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawCircle(int nativeCanvas, float cx, 17069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float cy, float radius, 17079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int paint); 17089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawArc(int nativeCanvas, RectF oval, 17099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float startAngle, float sweep, 17109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean useCenter, int paint); 17119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawRoundRect(int nativeCanvas, 17129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project RectF rect, float rx, 17139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float ry, int paint); 17149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawPath(int nativeCanvas, int path, 17159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int paint); 17169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native void native_drawBitmap(int nativeCanvas, int bitmap, 17179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float left, float top, 171811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn int nativePaintOrZero, 17190d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int canvasDensity, 17200d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int screenDensity, 17210d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int bitmapDensity); 17229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native void native_drawBitmap(int nativeCanvas, int bitmap, 17239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect src, RectF dst, 17240d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int nativePaintOrZero, 17250d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int screenDensity, 17260d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int bitmapDensity); 17279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawBitmap(int nativeCanvas, int bitmap, 17289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect src, Rect dst, 17290d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int nativePaintOrZero, 17300d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int screenDensity, 17310d221012ff5fd314711c00ed30e9b807b9c454c1Dianne Hackborn int bitmapDensity); 17329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawBitmap(int nativeCanvas, int[] colors, 17339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offset, int stride, float x, 17349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float y, int width, int height, 17359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean hasAlpha, 17369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativePaintOrZero); 17379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeDrawBitmapMatrix(int nCanvas, int nBitmap, 17389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nMatrix, int nPaint); 17399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeDrawBitmapMesh(int nCanvas, int nBitmap, 17409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int meshWidth, int meshHeight, 17419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] verts, int vertOffset, 17429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] colors, int colorOffset, int nPaint); 17439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeDrawVertices(int nCanvas, int mode, int n, 17449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float[] verts, int vertOffset, float[] texs, int texOffset, 17459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] colors, int colorOffset, short[] indices, 17469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int indexOffset, int indexCount, int nPaint); 17479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawText(int nativeCanvas, char[] text, 17499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int index, int count, float x, 1750f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt float y, int flags, int paint); 17519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawText(int nativeCanvas, String text, 17529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int start, int end, float x, 1753f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt float y, int flags, int paint); 1754f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 17550c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt private static native void native_drawTextRun(int nativeCanvas, String text, 17560c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int start, int end, int contextStart, int contextEnd, 17570c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt float x, float y, int flags, int paint); 1758f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 17590c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt private static native void native_drawTextRun(int nativeCanvas, char[] text, 17600c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt int start, int count, int contextStart, int contextCount, 17610c702b88c5d0d4380930b920f5be6e66dd95a0d8Doug Felt float x, float y, int flags, int paint); 1762f47d7405bbcb25d7cdf89ebb059f41520fe9ab87Doug Felt 17639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawPosText(int nativeCanvas, 17649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char[] text, int index, 17659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int count, float[] pos, 17669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int paint); 17679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawPosText(int nativeCanvas, 17689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String text, float[] pos, 17699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int paint); 17709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawTextOnPath(int nativeCanvas, 17719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project char[] text, int index, 17729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int count, int path, 17739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project float hOffset, 17744beb8ff7175ebd14b96942724a658f407d0b9951Doug Felt float vOffset, int bidiFlags, 17754beb8ff7175ebd14b96942724a658f407d0b9951Doug Felt int paint); 17769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawTextOnPath(int nativeCanvas, 17779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String text, int path, 17784beb8ff7175ebd14b96942724a658f407d0b9951Doug Felt float hOffset, 17794beb8ff7175ebd14b96942724a658f407d0b9951Doug Felt float vOffset, 17804beb8ff7175ebd14b96942724a658f407d0b9951Doug Felt int flags, int paint); 17819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void native_drawPicture(int nativeCanvas, 17829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativePicture); 17839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void finalizer(int nativeCanvas); 17849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1785