Bitmap.java revision 9066cfe9886ac131c34d59ed0e2d287b0e3c0087
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.os.Parcelable; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Parcel; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.nio.Buffer; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.nio.ByteBuffer; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.nio.ShortBuffer; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.nio.IntBuffer; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.io.OutputStream; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic final class Bitmap implements Parcelable { 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Indicates that the bitmap was created for an unknown pixel density. 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see Bitmap#getDensityScale() 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see Bitmap#setDensityScale(float) 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide pending API council approval 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final float DENSITY_SCALE_UNKNOWN = -1.0f; 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Note: mNativeBitmap is used by FaceDetector_jni.cpp 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Don't change/rename without updating FaceDetector_jni.cpp 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final int mNativeBitmap; 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final boolean mIsMutable; 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private byte[] mNinePatchChunk; // may be null 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mWidth = -1; 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mHeight = -1; 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mRecycled; 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static volatile Matrix sScaleMatrix; 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private float mDensityScale = DENSITY_SCALE_UNKNOWN; 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mAutoScaling; 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @noinspection UnusedDeclaration 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Private constructor that must received an already allocated native 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bitmap int (pointer). 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project This can be called from JNI code. 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Bitmap(int nativeBitmap, boolean isMutable, byte[] ninePatchChunk) { 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (nativeBitmap == 0) { 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("internal error: native bitmap is 0"); 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we delete this in our finalizer 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNativeBitmap = nativeBitmap; 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mIsMutable = isMutable; 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNinePatchChunk = ninePatchChunk; 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Returns the density scale for this bitmap, expressed as a factor of 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the default density (160.) For instance, a bitmap designed for 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * displays with a density of 240 will have a density scale of 1.5 whereas a bitmap 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * designed for a density of 160 will have a density scale of 1.0.</p> 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The default density scale is {@link #DENSITY_SCALE_UNKNOWN}.</p> 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A scaling factor of the default density (160) or {@link #DENSITY_SCALE_UNKNOWN} 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if the scaling factor is unknown. 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setDensityScale(float) 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #isAutoScalingEnabled() 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setAutoScalingEnabled(boolean) 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.util.DisplayMetrics#DEFAULT_DENSITY 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.util.DisplayMetrics#density 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #DENSITY_SCALE_UNKNOWN 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide pending API council approval 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public float getDensityScale() { 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mDensityScale; 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Specifies the density scale for this bitmap, expressed as a factor of 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the default density (160.) For instance, a bitmap designed for 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * displays with a density of 240 will have a density scale of 1.5 whereas a bitmap 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * designed for a density of 160 will have a density scale of 1.0.</p> 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param densityScale The density scaling factor to use with this bitmap or 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #DENSITY_SCALE_UNKNOWN} if the factor is unknown. 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getDensityScale() 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #isAutoScalingEnabled() 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setAutoScalingEnabled(boolean) 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.util.DisplayMetrics#DEFAULT_DENSITY 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.util.DisplayMetrics#density 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #DENSITY_SCALE_UNKNOWN 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide pending API council approval 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setDensityScale(float densityScale) { 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mDensityScale = densityScale; 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </p>Indicates whether this bitmap will be automatically be scaled at the 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * target's density at drawing time. If auto scaling is enabled, this bitmap 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be drawn with the following scale factor:</p> 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <pre>scale = (bitmap density scale factor) / (target density scale factor)</pre> 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Auto scaling is turned off by default. If auto scaling is enabled but the 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bitmap has an unknown density scale, then the bitmap will never be automatically 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * scaled at drawing time.</p> 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return True if the bitmap must be scaled at drawing time, false otherwise. 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setAutoScalingEnabled(boolean) 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getDensityScale() 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setDensityScale(float) 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide pending API council approval 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isAutoScalingEnabled() { 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mAutoScaling; 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Enables or disables auto scaling for this bitmap. When auto scaling is enabled, 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap will be scaled at drawing time to accomodate the drawing target's pixel 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * density. The final scale factor for this bitmap is thus defined:</p> 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <pre>scale = (bitmap density scale factor) / (target density scale factor)</pre> 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>If auto scaling is enabled but the bitmap has an unknown density scale, then 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap will never be automatically scaled at drawing time.</p> 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param autoScalingEnabled True to scale the bitmap at drawing time, false otherwise. 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide pending API council approval 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setAutoScalingEnabled(boolean autoScalingEnabled) { 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mAutoScaling = autoScalingEnabled; 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the nine patch chunk. 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param chunk The definition of the nine patch 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setNinePatchChunk(byte[] chunk) { 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNinePatchChunk = chunk; 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Free up the memory associated with this bitmap's pixels, and mark the 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bitmap as "dead", meaning it will throw an exception if getPixels() or 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * setPixels() is called, and will draw nothing. This operation cannot be 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * reversed, so it should only be called if you are sure there are no 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * further uses for the bitmap. This is an advanced call, and normally need 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not be called, since the normal GC process will free up this memory when 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * there are no more references to this bitmap. 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void recycle() { 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!mRecycled) { 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeRecycle(mNativeBitmap); 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNinePatchChunk = null; 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRecycled = true; 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if this bitmap has been recycled. If so, then it is an error 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to try to access its pixels, and the bitmap will not draw. 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the bitmap has been recycled 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean isRecycled() { 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mRecycled; 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is called by methods that want to throw an exception if the bitmap 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has already been recycled. 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void checkRecycled(String errorMessage) { 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRecycled) { 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(errorMessage); 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Common code for checking that x and y are >= 0 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x x coordinate to ensure is >= 0 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y y coordinate to ensure is >= 0 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void checkXYSign(int x, int y) { 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (x < 0) { 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("x must be >= 0"); 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (y < 0) { 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("y must be >= 0"); 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Common code for checking that width and height are > 0 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width width to ensure is > 0 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height height to ensure is > 0 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void checkWidthHeight(int width, int height) { 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width <= 0) { 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("width must be > 0"); 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (height <= 0) { 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("height must be > 0"); 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum Config { 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // these native values must match up with the enum in SkBitmap.h 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ALPHA_8 (2), 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project RGB_565 (4), 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ARGB_4444 (5), 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ARGB_8888 (6); 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Config(int ni) { 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = ni; 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int nativeInt; 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* package */ static Config nativeToConfig(int ni) { 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sConfigs[ni]; 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static Config sConfigs[] = { 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project null, null, ALPHA_8, null, RGB_565, ARGB_4444, ARGB_8888 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copy the bitmap's pixels into the specified buffer (allocated by the 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller). An exception is thrown if the buffer is not large enough to 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * hold all of the pixels (taking into account the number of bytes per 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pixel) or if the Buffer subclass is not one of the support types 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (ByteBuffer, ShortBuffer, IntBuffer). 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void copyPixelsToBuffer(Buffer dst) { 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int elements = dst.remaining(); 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int shift; 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (dst instanceof ByteBuffer) { 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 0; 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (dst instanceof ShortBuffer) { 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 1; 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (dst instanceof IntBuffer) { 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 2; 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("unsupported Buffer subclass"); 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long bufferSize = (long)elements << shift; 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long pixelSize = (long)getRowBytes() * getHeight(); 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bufferSize < pixelSize) { 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Buffer not large enough for pixels"); 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeCopyPixelsToBuffer(mNativeBitmap, dst); 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // now update the buffer's position 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int position = dst.position(); 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project position += pixelSize >> shift; 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dst.position(position); 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copy the pixels from the buffer, beginning at the current position, 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * overwriting the bitmap's pixels. The data in the buffer is not changed 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in any way (unlike setPixels(), which converts from unpremultipled 32bit 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to whatever the bitmap's native format is. 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void copyPixelsFromBuffer(Buffer src) { 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("copyPixelsFromBuffer called on recycled bitmap"); 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int elements = src.remaining(); 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int shift; 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (src instanceof ByteBuffer) { 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 0; 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (src instanceof ShortBuffer) { 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 1; 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (src instanceof IntBuffer) { 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 2; 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("unsupported Buffer subclass"); 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long bufferBytes = (long)elements << shift; 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long bitmapBytes = (long)getRowBytes() * getHeight(); 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bufferBytes < bitmapBytes) { 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Buffer not large enough for pixels"); 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeCopyPixelsFromBuffer(mNativeBitmap, src); 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tries to make a new bitmap based on the dimensions of this bitmap, 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * setting the new bitmap's config to the one specified, and then copying 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this bitmap's pixels into the new bitmap. If the conversion is not 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supported, or the allocator fails, then this returns NULL. 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The desired config for the resulting bitmap 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param isMutable True if the resulting bitmap should be mutable (i.e. 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * its pixels can be modified) 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the new bitmap, or null if the copy could not be made. 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap copy(Config config, boolean isMutable) { 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't copy a recycled bitmap"); 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeCopy(mNativeBitmap, config.nativeInt, isMutable); 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createScaledBitmap(Bitmap src, int dstWidth, 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int dstHeight, boolean filter) { 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Matrix m; 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (Bitmap.class) { 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // small pool of just 1 matrix 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m = sScaleMatrix; 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sScaleMatrix = null; 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (m == null) { 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m = new Matrix(); 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int width = src.getWidth(); 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int height = src.getHeight(); 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final float sx = dstWidth / (float)width; 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final float sy = dstHeight / (float)height; 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m.setScale(sx, sy); 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap b = Bitmap.createBitmap(src, 0, 0, width, height, m, filter); 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (Bitmap.class) { 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // do we need to check for null? why not just assign everytime? 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sScaleMatrix == null) { 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sScaleMatrix = m; 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return b; 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns an immutable bitmap from the source bitmap. The new bitmap may 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be the same object as source, or a copy may have been made. 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(Bitmap src) { 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return createBitmap(src, 0, 0, src.getWidth(), src.getHeight()); 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns an immutable bitmap from the specified subset of the source 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bitmap. The new bitmap may be the same object as source, or a copy may 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * have been made. 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param source The bitmap we are subsetting 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate of the first pixel in source 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate of the first pixel in source 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The number of pixels in each row 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The number of rows 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(Bitmap source, int x, int y, int width, int height) { 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return createBitmap(source, x, y, width, height, null, false); 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns an immutable bitmap from subset of the source bitmap, 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * transformed by the optional matrix. 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param source The bitmap we are subsetting 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate of the first pixel in source 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate of the first pixel in source 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The number of pixels in each row 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The number of rows 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param m Option matrix to be applied to the pixels 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param filter true if the source should be filtered. 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Only applies if the matrix contains more than just 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * translation. 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A bitmap that represents the specified subset of source 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if the x, y, width, height values are 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * outside of the dimensions of the source bitmap. 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(Bitmap source, int x, int y, int width, int height, 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Matrix m, boolean filter) { 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkXYSign(x, y); 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkWidthHeight(width, height); 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (x + width > source.getWidth()) { 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("x + width must be <= bitmap.width()"); 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (y + height > source.getHeight()) { 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("y + height must be <= bitmap.height()"); 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // check if we can just return our argument unchanged 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!source.isMutable() && x == 0 && y == 0 && width == source.getWidth() && 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project height == source.getHeight() && (m == null || m.isIdentity())) { 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return source; 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int neww = width; 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int newh = height; 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Canvas canvas = new Canvas(); 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap bitmap; 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Paint paint; 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect srcR = new Rect(x, y, x + width, y + height); 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project RectF dstR = new RectF(0, 0, width, height); 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (m == null || m.isIdentity()) { 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bitmap = createBitmap(neww, newh, 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project source.hasAlpha() ? Config.ARGB_8888 : Config.RGB_565); 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint = null; // not needed 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* the dst should have alpha if the src does, or if our matrix 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project doesn't preserve rectness 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean hasAlpha = source.hasAlpha() || !m.rectStaysRect(); 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project RectF deviceR = new RectF(); 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m.mapRect(deviceR, dstR); 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project neww = Math.round(deviceR.width()); 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project newh = Math.round(deviceR.height()); 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bitmap = createBitmap(neww, newh, hasAlpha ? Config.ARGB_8888 : Config.RGB_565); 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (hasAlpha) { 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bitmap.eraseColor(0); 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project canvas.translate(-deviceR.left, -deviceR.top); 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project canvas.concat(m); 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint = new Paint(); 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint.setFilterBitmap(filter); 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!m.rectStaysRect()) { 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint.setAntiAlias(true); 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project canvas.setBitmap(bitmap); 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project canvas.drawBitmap(source, srcR, dstR, paint); 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // The new bitmap was created from a known bitmap source so assume that 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // they use the same density scale 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bitmap.setDensityScale(source.getDensityScale()); 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bitmap.setAutoScalingEnabled(source.isAutoScalingEnabled()); 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bitmap; 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a mutable bitmap with the specified width and height. 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The width of the bitmap 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The height of the bitmap 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The bitmap config to create. 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if the width or height are <= 0 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(int width, int height, Config config) { 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap bm = nativeCreate(null, 0, width, width, height, config.nativeInt, true); 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bm.eraseColor(0); // start with black/transparent pixels 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bm; 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a immutable bitmap with the specified width and height, with each 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pixel value set to the corresponding value in the colors array. 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors Array of {@link Color} used to initialize the pixels. 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Number of values to skip before the first color in the 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * array of colors. 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stride Number of colors in the array between rows (must be >= 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * width or <= -width). 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The width of the bitmap 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The height of the bitmap 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The bitmap config to create. If the config does not 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * support per-pixel alpha (e.g. RGB_565), then the alpha 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bytes in the colors[] will be ignored (assumed to be FF) 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if the width or height are <= 0, or if 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the color array's length is less than the number of pixels. 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(int colors[], int offset, int stride, 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int width, int height, Config config) { 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkWidthHeight(width, height); 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (Math.abs(stride) < width) { 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("abs(stride) must be >= width"); 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int lastScanline = offset + (height - 1) * stride; 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = colors.length; 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (offset < 0 || (offset + width > length) || lastScanline < 0 || 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project (lastScanline + width > length)) { 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeCreate(colors, offset, stride, width, height, 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project config.nativeInt, false); 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a immutable bitmap with the specified width and height, with each 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pixel value set to the corresponding value in the colors array. 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors Array of {@link Color} used to initialize the pixels. 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This array must be at least as large as width * height. 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The width of the bitmap 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The height of the bitmap 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The bitmap config to create. If the config does not 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * support per-pixel alpha (e.g. RGB_565), then the alpha 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bytes in the colors[] will be ignored (assumed to be FF) 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if the width or height are <= 0, or if 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the color array's length is less than the number of pixels. 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(int colors[], int width, int height, Config config) { 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return createBitmap(colors, 0, width, width, height, config); 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns an optional array of private data, used by the UI system for 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * some bitmaps. Not intended to be called by applications. 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public byte[] getNinePatchChunk() { 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mNinePatchChunk; 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Specifies the known formats a bitmap can be compressed into 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum CompressFormat { 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project JPEG (0), 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PNG (1); 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project CompressFormat(int nativeInt) { 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = nativeInt; 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int nativeInt; 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Number of bytes of temp storage we use for communicating between the 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * native compressor and the java OutputStream. 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final static int WORKING_COMPRESS_STORAGE = 4096; 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write a compressed version of the bitmap to the specified outputstream. 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this returns true, the bitmap can be reconstructed by passing a 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * corresponding inputstream to BitmapFactory.decodeStream(). Note: not 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * all Formats support all bitmap configs directly, so it is possible that 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the returned bitmap from BitmapFactory could be in a different bitdepth, 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and/or may have lost per-pixel alpha (e.g. JPEG only supports opaque 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pixels). 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param format The format of the compressed image 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param quality Hint to the compressor, 0-100. 0 meaning compress for 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * small size, 100 meaning compress for max quality. Some 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * formats, like PNG which is lossless, will ignore the 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * quality setting 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stream The outputstream to write the compressed data. 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if successfully compressed to the specified stream. 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean compress(CompressFormat format, int quality, OutputStream stream) { 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't compress a recycled bitmap"); 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // do explicit check before calling the native method 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (stream == null) { 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (quality < 0 || quality > 100) { 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("quality must be 0..100"); 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeCompress(mNativeBitmap, format.nativeInt, quality, 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project stream, new byte[WORKING_COMPRESS_STORAGE]); 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if the bitmap is marked as mutable (i.e. can be drawn into) 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean isMutable() { 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mIsMutable; 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Returns the bitmap's width */ 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final int getWidth() { 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mWidth == -1 ? mWidth = nativeWidth(mNativeBitmap) : mWidth; 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Returns the bitmap's height */ 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final int getHeight() { 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mHeight == -1 ? mHeight = nativeHeight(mNativeBitmap) : mHeight; 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Convenience method that returns the width of this bitmap divided 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * by the density scale factor. 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The scaled width of this bitmap, according to the density scale factor. 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide pending API council approval 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getScaledWidth() { 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final float scale = getDensityScale(); 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return scale == DENSITY_SCALE_UNKNOWN ? getWidth() : (int) (getWidth() / scale); 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Convenience method that returns the height of this bitmap divided 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * by the density scale factor. 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The scaled height of this bitmap, according to the density scale factor. 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide pending API council approval 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getScaledHeight() { 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final float scale = getDensityScale(); 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return scale == DENSITY_SCALE_UNKNOWN ? getWidth() : (int) (getHeight() / scale); 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the number of bytes between rows in the bitmap's pixels. Note that 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this refers to the pixels as stored natively by the bitmap. If you call 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * getPixels() or setPixels(), then the pixels are uniformly treated as 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 32bit values, packed according to the Color class. 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return number of bytes between rows of the native bitmap pixels. 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final int getRowBytes() { 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeRowBytes(mNativeBitmap); 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If the bitmap's internal config is in one of the public formats, return 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that config, otherwise return null. 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final Config getConfig() { 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Config.nativeToConfig(nativeConfig(mNativeBitmap)); 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Returns true if the bitmap's pixels support levels of alpha */ 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean hasAlpha() { 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeHasAlpha(mNativeBitmap); 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fills the bitmap's pixels with the specified {@link Color}. 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException if the bitmap is not mutable. 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void eraseColor(int c) { 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't erase a recycled bitmap"); 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!isMutable()) { 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException("cannot erase immutable bitmaps"); 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeErase(mNativeBitmap, c); 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the {@link Color} at the specified location. Throws an exception 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if x or y are out of bounds (negative or >= to the width or height 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * respectively). 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate (0...width-1) of the pixel to return 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate (0...height-1) of the pixel to return 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The argb {@link Color} at the specified coordinate 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if x, y exceed the bitmap's bounds 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPixel(int x, int y) { 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't call getPixel() on a recycled bitmap"); 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkPixelAccess(x, y); 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeGetPixel(mNativeBitmap, x, y); 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns in pixels[] a copy of the data in the bitmap. Each value is 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a packed int representing a {@link Color}. The stride parameter allows 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the caller to allow for gaps in the returned pixels array between 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * rows. For normal packed results, just pass width for the stride value. 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pixels The array to receive the bitmap's colors 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset The first index to write into pixels[] 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stride The number of entries in pixels[] to skip between 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * rows (must be >= bitmap's width). Can be negative. 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate of the first pixel to read from 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate of the first pixel to read from 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The number of pixels to read from each row 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The number of rows to read 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if x, y, width, height exceed the 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bounds of the bitmap, or if abs(stride) < width. 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws ArrayIndexOutOfBoundsException if the pixels array is too small 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to receive the specified number of pixels. 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void getPixels(int[] pixels, int offset, int stride, 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int x, int y, int width, int height) { 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't call getPixels() on a recycled bitmap"); 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width == 0 || height == 0) { 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; // nothing to do 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkPixelsAccess(x, y, width, height, offset, stride, pixels); 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeGetPixels(mNativeBitmap, pixels, offset, stride, 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project x, y, width, height); 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Shared code to check for illegal arguments passed to getPixel() 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or setPixel() 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x x coordinate of the pixel 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y y coordinate of the pixel 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void checkPixelAccess(int x, int y) { 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkXYSign(x, y); 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (x >= getWidth()) { 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("x must be < bitmap.width()"); 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (y >= getHeight()) { 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("y must be < bitmap.height()"); 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Shared code to check for illegal arguments passed to getPixels() 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or setPixels() 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x left edge of the area of pixels to access 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y top edge of the area of pixels to access 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width width of the area of pixels to access 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height height of the area of pixels to access 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset offset into pixels[] array 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stride number of elements in pixels[] between each logical row 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pixels array to hold the area of pixels being accessed 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void checkPixelsAccess(int x, int y, int width, int height, 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offset, int stride, int pixels[]) { 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkXYSign(x, y); 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width < 0) { 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("width must be >= 0"); 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (height < 0) { 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("height must be >= 0"); 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (x + width > getWidth()) { 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException( 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "x + width must be <= bitmap.width()"); 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (y + height > getHeight()) { 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException( 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "y + height must be <= bitmap.height()"); 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (Math.abs(stride) < width) { 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("abs(stride) must be >= width"); 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int lastScanline = offset + (height - 1) * stride; 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = pixels.length; 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (offset < 0 || (offset + width > length) 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || lastScanline < 0 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (lastScanline + width > length)) { 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write the specified {@link Color} into the bitmap (assuming it is 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mutable) at the x,y coordinate. 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate of the pixel to replace (0...width-1) 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate of the pixel to replace (0...height-1) 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param color The {@link Color} to write into the bitmap 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException if the bitmap is not mutable 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if x, y are outside of the bitmap's 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bounds. 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setPixel(int x, int y, int color) { 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't call setPixel() on a recycled bitmap"); 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!isMutable()) { 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(); 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkPixelAccess(x, y); 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeSetPixel(mNativeBitmap, x, y, color); 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Replace pixels in the bitmap with the colors in the array. Each element 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the array is a packed int prepresenting a {@link Color} 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pixels The colors to write to the bitmap 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset The index of the first color to read from pixels[] 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stride The number of colors in pixels[] to skip between rows. 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normally this value will be the same as the width of 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap, but it can be larger (or negative). 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate of the first pixel to write to in 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap. 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate of the first pixel to write to in 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap. 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The number of colors to copy from pixels[] per row 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The number of rows to write to the bitmap 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException if the bitmap is not mutable 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if x, y, width, height are outside of 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap's bounds. 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws ArrayIndexOutOfBoundsException if the pixels array is too small 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to receive the specified number of pixels. 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setPixels(int[] pixels, int offset, int stride, 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int x, int y, int width, int height) { 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't call setPixels() on a recycled bitmap"); 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!isMutable()) { 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(); 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width == 0 || height == 0) { 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; // nothing to do 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkPixelsAccess(x, y, width, height, offset, stride, pixels); 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeSetPixels(mNativeBitmap, pixels, offset, stride, 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project x, y, width, height); 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final Parcelable.Creator<Bitmap> CREATOR 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project = new Parcelable.Creator<Bitmap>() { 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Rebuilds a bitmap previously stored with writeToParcel(). 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param p Parcel object to read the bitmap from 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new bitmap created from the data in the parcel 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap createFromParcel(Parcel p) { 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap bm = nativeCreateFromParcel(p); 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bm == null) { 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Failed to unparcel Bitmap"); 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bm; 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap[] newArray(int size) { 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new Bitmap[size]; 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * No special parcel contents. 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int describeContents() { 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write the bitmap and its pixels to the parcel. The bitmap can be 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * rebuilt from the parcel by calling CREATOR.createFromParcel(). 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param p Parcel object to write the bitmap data into 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void writeToParcel(Parcel p, int flags) { 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't parcel a recycled bitmap"); 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!nativeWriteToParcel(mNativeBitmap, mIsMutable, p)) { 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("native writeToParcel failed"); 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a new bitmap that captures the alpha values of the original. 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This may be drawn with Canvas.drawBitmap(), where the color(s) will be 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * taken from the paint that is passed to the draw call. 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return new bitmap containing the alpha channel of the original bitmap. 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap extractAlpha() { 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return extractAlpha(null, null); 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a new bitmap that captures the alpha values of the original. 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * These values may be affected by the optional Paint parameter, which 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can contain its own alpha, and may also contain a MaskFilter which 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * could change the actual dimensions of the resulting bitmap (e.g. 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a blur maskfilter might enlarge the resulting bitmap). If offsetXY 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is not null, it returns the amount to offset the returned bitmap so 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that it will logically align with the original. For example, if the 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * paint contains a blur of radius 2, then offsetXY[] would contains 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * -2, -2, so that drawing the alpha bitmap offset by (-2, -2) and then 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawing the original would result in the blur visually aligning with 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the original. 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint Optional paint used to modify the alpha values in the 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * resulting bitmap. Pass null for default behavior. 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offsetXY Optional array that returns the X (index 0) and Y 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (index 1) offset needed to position the returned bitmap 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * so that it visually lines up with the original. 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return new bitmap containing the (optionally modified by paint) alpha 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * channel of the original bitmap. This may be drawn with 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Canvas.drawBitmap(), where the color(s) will be taken from the 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * paint that is passed to the draw call. 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap extractAlpha(Paint paint, int[] offsetXY) { 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't extractAlpha on a recycled bitmap"); 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativePaint = paint != null ? paint.mNativePaint : 0; 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap bm = nativeExtractAlpha(mNativeBitmap, nativePaint, offsetXY); 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bm == null) { 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Failed to extractAlpha on Bitmap"); 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bm; 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void finalize() throws Throwable { 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeDestructor(mNativeBitmap); 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } finally { 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.finalize(); 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //////////// native methods 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native Bitmap nativeCreate(int[] colors, int offset, 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int stride, int width, int height, 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativeConfig, boolean mutable); 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native Bitmap nativeCopy(int srcBitmap, int nativeConfig, 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean isMutable); 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeDestructor(int nativeBitmap); 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeRecycle(int nativeBitmap); 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean nativeCompress(int nativeBitmap, int format, 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int quality, OutputStream stream, 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte[] tempStorage); 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeErase(int nativeBitmap, int color); 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int nativeWidth(int nativeBitmap); 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int nativeHeight(int nativeBitmap); 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int nativeRowBytes(int nativeBitmap); 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int nativeConfig(int nativeBitmap); 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean nativeHasAlpha(int nativeBitmap); 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int nativeGetPixel(int nativeBitmap, int x, int y); 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeGetPixels(int nativeBitmap, int[] pixels, 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offset, int stride, int x, 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int y, int width, int height); 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeSetPixel(int nativeBitmap, int x, int y, 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int color); 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeSetPixels(int nativeBitmap, int[] colors, 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offset, int stride, int x, 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int y, int width, int height); 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeCopyPixelsToBuffer(int nativeBitmap, 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Buffer dst); 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeCopyPixelsFromBuffer(int nb, Buffer src); 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native Bitmap nativeCreateFromParcel(Parcel p); 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // returns true on success 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean nativeWriteToParcel(int nativeBitmap, 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean isMutable, 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Parcel p); 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // returns a new bitmap built from the native bitmap's alpha, and the paint 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native Bitmap nativeExtractAlpha(int nativeBitmap, 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativePaint, 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] offsetXY); 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* package */ final int ni() { 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mNativeBitmap; 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 976