Bitmap.java revision feeea8f07c854e6b0ae2fec3aa2d239c17f32b5b
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.Parcel; 208cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chenimport android.os.Parcelable; 212784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackbornimport android.util.DisplayMetrics; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 238cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chenimport java.io.OutputStream; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.nio.Buffer; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.nio.ByteBuffer; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.nio.IntBuffer; 278cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chenimport java.nio.ShortBuffer; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic final class Bitmap implements Parcelable { 30e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Indicates that the bitmap was created for an unknown pixel density. 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see Bitmap#getDensity() 3511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see Bitmap#setDensity(int) 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public static final int DENSITY_NONE = 0; 3811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 39ce0537b80087a6225273040a987414b1dd081aa0Romain Guy /** 40ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * Note: mNativeBitmap is used by FaceDetector_jni.cpp 41ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * Don't change/rename without updating FaceDetector_jni.cpp 42ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * 43ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * @hide 44ce0537b80087a6225273040a987414b1dd081aa0Romain Guy */ 45ce0537b80087a6225273040a987414b1dd081aa0Romain Guy public final int mNativeBitmap; 468cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 47e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy /** 48e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy * Backing buffer for the Bitmap. 49e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy * Made public for quick access from drawing methods -- do NOT modify 50e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy * from outside this class. 51e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy * 52e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy * @hide 53e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy */ 54e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy public byte[] mBuffer; 55e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 562361098da3b9d9c3eeed410dc72ba62c0e9177cfRomain Guy @SuppressWarnings({"FieldCanBeLocal", "UnusedDeclaration"}) // Keep to finalize native resources 57e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy private final BitmapFinalizer mFinalizer; 58e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final boolean mIsMutable; 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private byte[] mNinePatchChunk; // may be null 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mWidth = -1; 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mHeight = -1; 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mRecycled; 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn // Package-scoped for fast access. 6696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn /*package*/ int mDensity = sDefaultDensity = getDefaultDensity(); 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn private static volatile Matrix sScaleMatrix; 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn private static volatile int sDefaultDensity = -1; 7102890fd0f98b3b8d98baf0bda1ea906afd723d8bRomain Guy 7296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn /** 7396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * For backwards compatibility, allows the app layer to change the default 7496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * density when running old apps. 7596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @hide 7696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn */ 7796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn public static void setDefaultDensity(int density) { 7896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn sDefaultDensity = density; 7996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn } 8096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn 8196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn /*package*/ static int getDefaultDensity() { 8296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn if (sDefaultDensity >= 0) { 8396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn return sDefaultDensity; 8496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn } 8596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn sDefaultDensity = DisplayMetrics.DENSITY_DEVICE; 8696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn return sDefaultDensity; 8796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn } 8896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @noinspection UnusedDeclaration 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* Private constructor that must received an already allocated native 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bitmap int (pointer). 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project This can be called from JNI code. 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 97e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy private Bitmap(int nativeBitmap, byte[] buffer, boolean isMutable, byte[] ninePatchChunk, 98e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy int density) { 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (nativeBitmap == 0) { 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("internal error: native bitmap is 0"); 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1028cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 103e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy mBuffer = buffer; 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we delete this in our finalizer 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNativeBitmap = nativeBitmap; 106e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy mFinalizer = new BitmapFinalizer(nativeBitmap); 107e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mIsMutable = isMutable; 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNinePatchChunk = ninePatchChunk; 110de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn if (density >= 0) { 111de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn mDensity = density; 112de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn } 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Returns the density for this bitmap.</p> 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>The default density is the same density as the current display, 11996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * unless the current application does not support different screen 12096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * densities in which case it is 12196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * {@link android.util.DisplayMetrics#DENSITY_DEFAULT}. Note that 12296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * compatibility mode is determined by the application that was initially 12396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * loaded into a process -- applications that share the same process should 12496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * all have the same compatibility, or ensure they explicitly set the 12596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * density of their bitmaps appropriately.</p> 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @return A scaling factor of the default density or {@link #DENSITY_NONE} 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if the scaling factor is unknown. 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #setDensity(int) 131a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn * @see android.util.DisplayMetrics#DENSITY_DEFAULT 13211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see android.util.DisplayMetrics#densityDpi 13311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #DENSITY_NONE 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getDensity() { 13611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return mDensity; 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Specifies the density for this bitmap. When the bitmap is 14111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * drawn to a Canvas that also has a density, it will be scaled 14211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * appropriately.</p> 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @param density The density scaling factor to use with this bitmap or 14511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * {@link #DENSITY_NONE} if the density is unknown. 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #getDensity() 148a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn * @see android.util.DisplayMetrics#DENSITY_DEFAULT 14911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see android.util.DisplayMetrics#densityDpi 15011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #DENSITY_NONE 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public void setDensity(int density) { 15311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn mDensity = density; 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the nine patch chunk. 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param chunk The definition of the nine patch 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setNinePatchChunk(byte[] chunk) { 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNinePatchChunk = chunk; 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1668cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 168a383b3f646cbc1fd870f2694d4fac24340834916Patrick Dubroy * Free the native object associated with this bitmap, and clear the 169a383b3f646cbc1fd870f2694d4fac24340834916Patrick Dubroy * reference to the pixel data. This will not free the pixel data synchronously; 170a383b3f646cbc1fd870f2694d4fac24340834916Patrick Dubroy * it simply allows it to be garbage collected if there are no other references. 171a383b3f646cbc1fd870f2694d4fac24340834916Patrick Dubroy * The bitmap is marked as "dead", meaning it will throw an exception if 172a383b3f646cbc1fd870f2694d4fac24340834916Patrick Dubroy * getPixels() or setPixels() is called, and will draw nothing. This operation 173a383b3f646cbc1fd870f2694d4fac24340834916Patrick Dubroy * cannot be reversed, so it should only be called if you are sure there are no 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * further uses for the bitmap. This is an advanced call, and normally need 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not be called, since the normal GC process will free up this memory when 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * there are no more references to this bitmap. 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void recycle() { 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!mRecycled) { 180e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy mBuffer = null; 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeRecycle(mNativeBitmap); 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNinePatchChunk = null; 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRecycled = true; 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if this bitmap has been recycled. If so, then it is an error 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to try to access its pixels, and the bitmap will not draw. 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the bitmap has been recycled 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean isRecycled() { 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mRecycled; 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1968cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1980bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy * Returns the generation ID of this bitmap. The generation ID changes 1990bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy * whenever the bitmap is modified. This can be used as an efficient way to 2000bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy * check if a bitmap has changed. 2010bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy * 2020bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy * @return The current generation ID for this bitmap. 2030bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy * 2040bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy * @hide 2050bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy */ 2060bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy public int getGenerationId() { 2070bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy return nativeGenerationId(mNativeBitmap); 2080bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy } 2090bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy 2100bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy /** 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is called by methods that want to throw an exception if the bitmap 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has already been recycled. 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void checkRecycled(String errorMessage) { 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRecycled) { 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(errorMessage); 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2198cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Common code for checking that x and y are >= 0 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x x coordinate to ensure is >= 0 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y y coordinate to ensure is >= 0 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void checkXYSign(int x, int y) { 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (x < 0) { 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("x must be >= 0"); 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (y < 0) { 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("y must be >= 0"); 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Common code for checking that width and height are > 0 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width width to ensure is > 0 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height height to ensure is > 0 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void checkWidthHeight(int width, int height) { 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width <= 0) { 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("width must be > 0"); 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (height <= 0) { 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("height must be > 0"); 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum Config { 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // these native values must match up with the enum in SkBitmap.h 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ALPHA_8 (2), 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project RGB_565 (4), 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ARGB_4444 (5), 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ARGB_8888 (6); 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Config(int ni) { 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = ni; 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int nativeInt; 2618cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* package */ static Config nativeToConfig(int ni) { 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sConfigs[ni]; 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2658cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static Config sConfigs[] = { 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project null, null, ALPHA_8, null, RGB_565, ARGB_4444, ARGB_8888 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2708cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copy the bitmap's pixels into the specified buffer (allocated by the 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller). An exception is thrown if the buffer is not large enough to 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * hold all of the pixels (taking into account the number of bytes per 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pixel) or if the Buffer subclass is not one of the support types 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (ByteBuffer, ShortBuffer, IntBuffer). 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void copyPixelsToBuffer(Buffer dst) { 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int elements = dst.remaining(); 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int shift; 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (dst instanceof ByteBuffer) { 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 0; 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (dst instanceof ShortBuffer) { 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 1; 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (dst instanceof IntBuffer) { 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 2; 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("unsupported Buffer subclass"); 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2908cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long bufferSize = (long)elements << shift; 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long pixelSize = (long)getRowBytes() * getHeight(); 2938cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bufferSize < pixelSize) { 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Buffer not large enough for pixels"); 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2978cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeCopyPixelsToBuffer(mNativeBitmap, dst); 2998cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // now update the buffer's position 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int position = dst.position(); 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project position += pixelSize >> shift; 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dst.position(position); 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copy the pixels from the buffer, beginning at the current position, 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * overwriting the bitmap's pixels. The data in the buffer is not changed 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in any way (unlike setPixels(), which converts from unpremultipled 32bit 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to whatever the bitmap's native format is. 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void copyPixelsFromBuffer(Buffer src) { 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("copyPixelsFromBuffer called on recycled bitmap"); 3148cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int elements = src.remaining(); 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int shift; 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (src instanceof ByteBuffer) { 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 0; 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (src instanceof ShortBuffer) { 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 1; 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (src instanceof IntBuffer) { 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 2; 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("unsupported Buffer subclass"); 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3268cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long bufferBytes = (long)elements << shift; 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long bitmapBytes = (long)getRowBytes() * getHeight(); 3298cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bufferBytes < bitmapBytes) { 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Buffer not large enough for pixels"); 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3338cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeCopyPixelsFromBuffer(mNativeBitmap, src); 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3368cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tries to make a new bitmap based on the dimensions of this bitmap, 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * setting the new bitmap's config to the one specified, and then copying 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this bitmap's pixels into the new bitmap. If the conversion is not 34196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * supported, or the allocator fails, then this returns NULL. The returned 34296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * bitmap initially has the same density as the original. 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The desired config for the resulting bitmap 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param isMutable True if the resulting bitmap should be mutable (i.e. 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * its pixels can be modified) 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the new bitmap, or null if the copy could not be made. 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap copy(Config config, boolean isMutable) { 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't copy a recycled bitmap"); 35196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn Bitmap b = nativeCopy(mNativeBitmap, config.nativeInt, isMutable); 35296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn if (b != null) { 35396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn b.mDensity = mDensity; 35496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn } 35596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn return b; 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 35802d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick /** 35902d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick * Creates a new bitmap, scaled from an existing bitmap. 36002d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick * 36102d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick * @param src The source bitmap. 36202d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick * @param dstWidth The new bitmap's desired width. 36302d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick * @param dstHeight The new bitmap's desired height. 36402d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick * @param filter true if the source should be filtered. 36502d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick * @return the new scaled bitmap. 36602d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick */ 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createScaledBitmap(Bitmap src, int dstWidth, 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int dstHeight, boolean filter) { 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Matrix m; 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (Bitmap.class) { 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // small pool of just 1 matrix 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m = sScaleMatrix; 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sScaleMatrix = null; 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (m == null) { 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m = new Matrix(); 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3798cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int width = src.getWidth(); 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int height = src.getHeight(); 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final float sx = dstWidth / (float)width; 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final float sy = dstHeight / (float)height; 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m.setScale(sx, sy); 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap b = Bitmap.createBitmap(src, 0, 0, width, height, m, filter); 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (Bitmap.class) { 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // do we need to check for null? why not just assign everytime? 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sScaleMatrix == null) { 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sScaleMatrix = m; 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3948cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen return b; 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3968cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns an immutable bitmap from the source bitmap. The new bitmap may 39996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * be the same object as source, or a copy may have been made. It is 40096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * initialized with the same density as the original bitmap. 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(Bitmap src) { 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return createBitmap(src, 0, 0, src.getWidth(), src.getHeight()); 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns an immutable bitmap from the specified subset of the source 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bitmap. The new bitmap may be the same object as source, or a copy may 40996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * have been made. It is 41096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * initialized with the same density as the original bitmap. 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param source The bitmap we are subsetting 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate of the first pixel in source 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate of the first pixel in source 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The number of pixels in each row 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The number of rows 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(Bitmap source, int x, int y, int width, int height) { 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return createBitmap(source, x, y, width, height, null, false); 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4218cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns an immutable bitmap from subset of the source bitmap, 42496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * transformed by the optional matrix. It is 42596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * initialized with the same density as the original bitmap. 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param source The bitmap we are subsetting 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate of the first pixel in source 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate of the first pixel in source 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The number of pixels in each row 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The number of rows 43260b88edea7132ddce90f2dced07c6706f1502270Ken Shirriff * @param m Optional matrix to be applied to the pixels 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param filter true if the source should be filtered. 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Only applies if the matrix contains more than just 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * translation. 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A bitmap that represents the specified subset of source 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if the x, y, width, height values are 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * outside of the dimensions of the source bitmap. 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(Bitmap source, int x, int y, int width, int height, 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Matrix m, boolean filter) { 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkXYSign(x, y); 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkWidthHeight(width, height); 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (x + width > source.getWidth()) { 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("x + width must be <= bitmap.width()"); 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (y + height > source.getHeight()) { 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("y + height must be <= bitmap.height()"); 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // check if we can just return our argument unchanged 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!source.isMutable() && x == 0 && y == 0 && width == source.getWidth() && 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project height == source.getHeight() && (m == null || m.isIdentity())) { 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return source; 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4578cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int neww = width; 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int newh = height; 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Canvas canvas = new Canvas(); 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap bitmap; 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Paint paint; 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect srcR = new Rect(x, y, x + width, y + height); 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project RectF dstR = new RectF(0, 0, width, height); 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 467feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy Config newConfig = Config.ARGB_8888; 468feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy final Config config = source.getConfig(); 469feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy // GIF files generate null configs, assume ARGB_8888 470feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy if (config != null) { 471feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy switch (config) { 472feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy case RGB_565: 473feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy newConfig = Config.RGB_565; 474feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy break; 475feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy case ALPHA_8: 476feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy newConfig = Config.ALPHA_8; 477feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy break; 478feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy case ARGB_4444: 479feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy case ARGB_8888: 480feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy default: 481feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy newConfig = Config.ARGB_8888; 482feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy break; 483feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy } 484feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy } 485d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (m == null || m.isIdentity()) { 487d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy bitmap = createBitmap(neww, newh, newConfig, source.hasAlpha()); 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint = null; // not needed 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 490d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy final boolean transformed = !m.rectStaysRect(); 491d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project RectF deviceR = new RectF(); 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m.mapRect(deviceR, dstR); 494d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project neww = Math.round(deviceR.width()); 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project newh = Math.round(deviceR.height()); 497d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 498d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy bitmap = createBitmap(neww, newh, transformed ? Config.ARGB_8888 : newConfig, 499d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy transformed || source.hasAlpha()); 500d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project canvas.translate(-deviceR.left, -deviceR.top); 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project canvas.concat(m); 503d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint = new Paint(); 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint.setFilterBitmap(filter); 506d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy if (transformed) { 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint.setAntiAlias(true); 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 51096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // The new bitmap was created from a known bitmap source so assume that 51211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn // they use the same density 51311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn bitmap.mDensity = source.mDensity; 51496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn 51596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn canvas.setBitmap(bitmap); 51696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn canvas.drawBitmap(source, srcR, dstR, paint); 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bitmap; 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5208cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 52296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * Returns a mutable bitmap with the specified width and height. Its 52396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * initial density is as per {@link #getDensity}. 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The width of the bitmap 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The height of the bitmap 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The bitmap config to create. 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if the width or height are <= 0 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(int width, int height, Config config) { 531d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy return createBitmap(width, height, config, true); 532d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy } 533d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 534d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy /** 535d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * Returns a mutable bitmap with the specified width and height. Its 536d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * initial density is as per {@link #getDensity}. 537d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * 538d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * @param width The width of the bitmap 539d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * @param height The height of the bitmap 540d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * @param config The bitmap config to create. 541d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * @param hasAlpha If the bitmap is ARGB_8888 this flag can be used to mark the 542d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * bitmap as opaque. Doing so will clear the bitmap in black 543d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * instead of transparent. 544d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * 545d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * @throws IllegalArgumentException if the width or height are <= 0 546d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy */ 547d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy private static Bitmap createBitmap(int width, int height, Config config, boolean hasAlpha) { 548e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy if (width <= 0 || height <= 0) { 549e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy throw new IllegalArgumentException("width and height must be > 0"); 550e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap bm = nativeCreate(null, 0, width, width, height, config.nativeInt, true); 552d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy if (config == Config.ARGB_8888 && !hasAlpha) { 553d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy bm.eraseColor(0xff000000); 554d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy nativeSetHasAlpha(bm.mNativeBitmap, hasAlpha); 555d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy } else { 556d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy bm.eraseColor(0); 557d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy } 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bm; 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5608cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a immutable bitmap with the specified width and height, with each 56396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * pixel value set to the corresponding value in the colors array. Its 56496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * initial density is as per {@link #getDensity}. 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors Array of {@link Color} used to initialize the pixels. 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Number of values to skip before the first color in the 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * array of colors. 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stride Number of colors in the array between rows (must be >= 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * width or <= -width). 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The width of the bitmap 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The height of the bitmap 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The bitmap config to create. If the config does not 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * support per-pixel alpha (e.g. RGB_565), then the alpha 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bytes in the colors[] will be ignored (assumed to be FF) 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if the width or height are <= 0, or if 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the color array's length is less than the number of pixels. 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(int colors[], int offset, int stride, 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int width, int height, Config config) { 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkWidthHeight(width, height); 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (Math.abs(stride) < width) { 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("abs(stride) must be >= width"); 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int lastScanline = offset + (height - 1) * stride; 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = colors.length; 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (offset < 0 || (offset + width > length) || lastScanline < 0 || 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project (lastScanline + width > length)) { 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 592e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy if (width <= 0 || height <= 0) { 593e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy throw new IllegalArgumentException("width and height must be > 0"); 594e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeCreate(colors, offset, stride, width, height, 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project config.nativeInt, false); 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a immutable bitmap with the specified width and height, with each 60196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * pixel value set to the corresponding value in the colors array. Its 60296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * initial density is as per {@link #getDensity}. 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors Array of {@link Color} used to initialize the pixels. 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This array must be at least as large as width * height. 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The width of the bitmap 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The height of the bitmap 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The bitmap config to create. If the config does not 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * support per-pixel alpha (e.g. RGB_565), then the alpha 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bytes in the colors[] will be ignored (assumed to be FF) 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if the width or height are <= 0, or if 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the color array's length is less than the number of pixels. 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(int colors[], int width, int height, Config config) { 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return createBitmap(colors, 0, width, width, height, config); 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns an optional array of private data, used by the UI system for 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * some bitmaps. Not intended to be called by applications. 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public byte[] getNinePatchChunk() { 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mNinePatchChunk; 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Specifies the known formats a bitmap can be compressed into 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum CompressFormat { 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project JPEG (0), 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project PNG (1); 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project CompressFormat(int nativeInt) { 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = nativeInt; 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int nativeInt; 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Number of bytes of temp storage we use for communicating between the 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * native compressor and the java OutputStream. 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final static int WORKING_COMPRESS_STORAGE = 4096; 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write a compressed version of the bitmap to the specified outputstream. 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this returns true, the bitmap can be reconstructed by passing a 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * corresponding inputstream to BitmapFactory.decodeStream(). Note: not 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * all Formats support all bitmap configs directly, so it is possible that 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the returned bitmap from BitmapFactory could be in a different bitdepth, 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and/or may have lost per-pixel alpha (e.g. JPEG only supports opaque 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pixels). 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param format The format of the compressed image 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param quality Hint to the compressor, 0-100. 0 meaning compress for 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * small size, 100 meaning compress for max quality. Some 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * formats, like PNG which is lossless, will ignore the 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * quality setting 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stream The outputstream to write the compressed data. 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if successfully compressed to the specified stream. 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean compress(CompressFormat format, int quality, OutputStream stream) { 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't compress a recycled bitmap"); 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // do explicit check before calling the native method 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (stream == null) { 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (quality < 0 || quality > 100) { 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("quality must be 0..100"); 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeCompress(mNativeBitmap, format.nativeInt, quality, 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project stream, new byte[WORKING_COMPRESS_STORAGE]); 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6748cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if the bitmap is marked as mutable (i.e. can be drawn into) 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean isMutable() { 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mIsMutable; 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Returns the bitmap's width */ 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final int getWidth() { 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mWidth == -1 ? mWidth = nativeWidth(mNativeBitmap) : mWidth; 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Returns the bitmap's height */ 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final int getHeight() { 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mHeight == -1 ? mHeight = nativeHeight(mNativeBitmap) : mHeight; 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6918cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 69311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * Convenience for calling {@link #getScaledWidth(int)} with the target 69411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * density of the given {@link Canvas}. 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6962784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn public int getScaledWidth(Canvas canvas) { 69711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return scaleFromDensity(getWidth(), mDensity, canvas.mDensity); 6982784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn } 6992784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn 7002784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn /** 70111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * Convenience for calling {@link #getScaledHeight(int)} with the target 70211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * density of the given {@link Canvas}. 7032784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn */ 7042784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn public int getScaledHeight(Canvas canvas) { 70511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return scaleFromDensity(getHeight(), mDensity, canvas.mDensity); 70611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn } 70711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 70811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn /** 70911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * Convenience for calling {@link #getScaledWidth(int)} with the target 71011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * density of the given {@link DisplayMetrics}. 71111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn */ 71211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getScaledWidth(DisplayMetrics metrics) { 71311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return scaleFromDensity(getWidth(), mDensity, metrics.densityDpi); 71411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn } 71511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 71611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn /** 71711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * Convenience for calling {@link #getScaledHeight(int)} with the target 71811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * density of the given {@link DisplayMetrics}. 71911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn */ 72011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getScaledHeight(DisplayMetrics metrics) { 72111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return scaleFromDensity(getHeight(), mDensity, metrics.densityDpi); 7222784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn } 7232784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn 7242784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn /** 7252784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn * Convenience method that returns the width of this bitmap divided 7262784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn * by the density scale factor. 7272784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn * 72811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @param targetDensity The density of the target canvas of the bitmap. 7292784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn * @return The scaled width of this bitmap, according to the density scale factor. 7302784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn */ 73111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getScaledWidth(int targetDensity) { 73211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return scaleFromDensity(getWidth(), mDensity, targetDensity); 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Convenience method that returns the height of this bitmap divided 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * by the density scale factor. 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 73911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @param targetDensity The density of the target canvas of the bitmap. 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The scaled height of this bitmap, according to the density scale factor. 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 74211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getScaledHeight(int targetDensity) { 74311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return scaleFromDensity(getHeight(), mDensity, targetDensity); 74411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn } 74511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 74611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn /** 74711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @hide 74811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn */ 74911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn static public int scaleFromDensity(int size, int sdensity, int tdensity) { 75011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn if (sdensity == DENSITY_NONE || sdensity == tdensity) { 75111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return size; 7522784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn } 75311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 75411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn // Scale by tdensity / sdensity, rounding up. 75511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return ( (size * tdensity) + (sdensity >> 1) ) / sdensity; 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 75711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the number of bytes between rows in the bitmap's pixels. Note that 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this refers to the pixels as stored natively by the bitmap. If you call 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * getPixels() or setPixels(), then the pixels are uniformly treated as 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 32bit values, packed according to the Color class. 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return number of bytes between rows of the native bitmap pixels. 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final int getRowBytes() { 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeRowBytes(mNativeBitmap); 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7698cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If the bitmap's internal config is in one of the public formats, return 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that config, otherwise return null. 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final Config getConfig() { 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Config.nativeToConfig(nativeConfig(mNativeBitmap)); 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 778a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed /** Returns true if the bitmap's config supports per-pixel alpha, and 779a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * if the pixels may contain non-opaque alpha values. For some configs, 780a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * this is always false (e.g. RGB_565), since they do not support per-pixel 781a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * alpha. However, for configs that do, the bitmap may be flagged to be 782a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * known that all of its pixels are opaque. In this case hasAlpha() will 783a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * also return false. If a config such as ARGB_8888 is not so flagged, 784a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * it will return true by default. 785a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed */ 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean hasAlpha() { 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeHasAlpha(mNativeBitmap); 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 791a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * Tell the bitmap if all of the pixels are known to be opaque (false) 792a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * or if some of the pixels may contain non-opaque alpha values (true). 793a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * Note, for some configs (e.g. RGB_565) this call is ignore, since it does 794a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * not support per-pixel alpha values. 795a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * 796a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * This is meant as a drawing hint, as in some cases a bitmap that is known 797a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * to be opaque can take a faster drawing case than one that may have 798a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * non-opaque per-pixel alpha values. 799a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * 800a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * @hide 801a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed */ 802a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed public void setHasAlpha(boolean hasAlpha) { 803a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed nativeSetHasAlpha(mNativeBitmap, hasAlpha); 804a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed } 805a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed 806a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed /** 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fills the bitmap's pixels with the specified {@link Color}. 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException if the bitmap is not mutable. 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void eraseColor(int c) { 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't erase a recycled bitmap"); 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!isMutable()) { 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException("cannot erase immutable bitmaps"); 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeErase(mNativeBitmap, c); 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the {@link Color} at the specified location. Throws an exception 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if x or y are out of bounds (negative or >= to the width or height 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * respectively). 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate (0...width-1) of the pixel to return 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate (0...height-1) of the pixel to return 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The argb {@link Color} at the specified coordinate 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if x, y exceed the bitmap's bounds 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPixel(int x, int y) { 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't call getPixel() on a recycled bitmap"); 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkPixelAccess(x, y); 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeGetPixel(mNativeBitmap, x, y); 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8348cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns in pixels[] a copy of the data in the bitmap. Each value is 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a packed int representing a {@link Color}. The stride parameter allows 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the caller to allow for gaps in the returned pixels array between 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * rows. For normal packed results, just pass width for the stride value. 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pixels The array to receive the bitmap's colors 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset The first index to write into pixels[] 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stride The number of entries in pixels[] to skip between 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * rows (must be >= bitmap's width). Can be negative. 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate of the first pixel to read from 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate of the first pixel to read from 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The number of pixels to read from each row 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The number of rows to read 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if x, y, width, height exceed the 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bounds of the bitmap, or if abs(stride) < width. 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws ArrayIndexOutOfBoundsException if the pixels array is too small 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to receive the specified number of pixels. 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void getPixels(int[] pixels, int offset, int stride, 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int x, int y, int width, int height) { 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't call getPixels() on a recycled bitmap"); 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width == 0 || height == 0) { 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; // nothing to do 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkPixelsAccess(x, y, width, height, offset, stride, pixels); 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeGetPixels(mNativeBitmap, pixels, offset, stride, 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project x, y, width, height); 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8668cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Shared code to check for illegal arguments passed to getPixel() 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or setPixel() 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x x coordinate of the pixel 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y y coordinate of the pixel 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void checkPixelAccess(int x, int y) { 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkXYSign(x, y); 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (x >= getWidth()) { 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("x must be < bitmap.width()"); 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (y >= getHeight()) { 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("y must be < bitmap.height()"); 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Shared code to check for illegal arguments passed to getPixels() 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or setPixels() 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x left edge of the area of pixels to access 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y top edge of the area of pixels to access 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width width of the area of pixels to access 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height height of the area of pixels to access 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset offset into pixels[] array 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stride number of elements in pixels[] between each logical row 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pixels array to hold the area of pixels being accessed 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void checkPixelsAccess(int x, int y, int width, int height, 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offset, int stride, int pixels[]) { 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkXYSign(x, y); 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width < 0) { 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("width must be >= 0"); 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (height < 0) { 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("height must be >= 0"); 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (x + width > getWidth()) { 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException( 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "x + width must be <= bitmap.width()"); 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (y + height > getHeight()) { 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException( 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "y + height must be <= bitmap.height()"); 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (Math.abs(stride) < width) { 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("abs(stride) must be >= width"); 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int lastScanline = offset + (height - 1) * stride; 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = pixels.length; 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (offset < 0 || (offset + width > length) 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || lastScanline < 0 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (lastScanline + width > length)) { 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9238cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write the specified {@link Color} into the bitmap (assuming it is 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mutable) at the x,y coordinate. 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate of the pixel to replace (0...width-1) 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate of the pixel to replace (0...height-1) 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param color The {@link Color} to write into the bitmap 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException if the bitmap is not mutable 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if x, y are outside of the bitmap's 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bounds. 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setPixel(int x, int y, int color) { 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't call setPixel() on a recycled bitmap"); 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!isMutable()) { 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(); 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkPixelAccess(x, y); 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeSetPixel(mNativeBitmap, x, y, color); 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9438cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Replace pixels in the bitmap with the colors in the array. Each element 9468cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * in the array is a packed int prepresenting a {@link Color} 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pixels The colors to write to the bitmap 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset The index of the first color to read from pixels[] 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stride The number of colors in pixels[] to skip between rows. 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normally this value will be the same as the width of 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap, but it can be larger (or negative). 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate of the first pixel to write to in 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap. 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate of the first pixel to write to in 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap. 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The number of colors to copy from pixels[] per row 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The number of rows to write to the bitmap 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException if the bitmap is not mutable 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if x, y, width, height are outside of 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap's bounds. 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws ArrayIndexOutOfBoundsException if the pixels array is too small 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to receive the specified number of pixels. 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setPixels(int[] pixels, int offset, int stride, 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int x, int y, int width, int height) { 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't call setPixels() on a recycled bitmap"); 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!isMutable()) { 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(); 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width == 0 || height == 0) { 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; // nothing to do 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkPixelsAccess(x, y, width, height, offset, stride, pixels); 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeSetPixels(mNativeBitmap, pixels, offset, stride, 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project x, y, width, height); 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9788cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final Parcelable.Creator<Bitmap> CREATOR 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project = new Parcelable.Creator<Bitmap>() { 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Rebuilds a bitmap previously stored with writeToParcel(). 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param p Parcel object to read the bitmap from 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new bitmap created from the data in the parcel 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap createFromParcel(Parcel p) { 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap bm = nativeCreateFromParcel(p); 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bm == null) { 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Failed to unparcel Bitmap"); 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bm; 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap[] newArray(int size) { 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new Bitmap[size]; 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * No special parcel contents. 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int describeContents() { 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write the bitmap and its pixels to the parcel. The bitmap can be 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * rebuilt from the parcel by calling CREATOR.createFromParcel(). 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param p Parcel object to write the bitmap data into 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void writeToParcel(Parcel p, int flags) { 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't parcel a recycled bitmap"); 1013de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn if (!nativeWriteToParcel(mNativeBitmap, mIsMutable, mDensity, p)) { 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("native writeToParcel failed"); 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a new bitmap that captures the alpha values of the original. 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This may be drawn with Canvas.drawBitmap(), where the color(s) will be 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * taken from the paint that is passed to the draw call. 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return new bitmap containing the alpha channel of the original bitmap. 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap extractAlpha() { 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return extractAlpha(null, null); 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10288cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a new bitmap that captures the alpha values of the original. 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * These values may be affected by the optional Paint parameter, which 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can contain its own alpha, and may also contain a MaskFilter which 10339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * could change the actual dimensions of the resulting bitmap (e.g. 10349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a blur maskfilter might enlarge the resulting bitmap). If offsetXY 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is not null, it returns the amount to offset the returned bitmap so 10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that it will logically align with the original. For example, if the 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * paint contains a blur of radius 2, then offsetXY[] would contains 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * -2, -2, so that drawing the alpha bitmap offset by (-2, -2) and then 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawing the original would result in the blur visually aligning with 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the original. 104196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * 104296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>The initial density of the returned bitmap is the same as the original's. 104396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint Optional paint used to modify the alpha values in the 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * resulting bitmap. Pass null for default behavior. 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offsetXY Optional array that returns the X (index 0) and Y 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (index 1) offset needed to position the returned bitmap 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * so that it visually lines up with the original. 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return new bitmap containing the (optionally modified by paint) alpha 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * channel of the original bitmap. This may be drawn with 10519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Canvas.drawBitmap(), where the color(s) will be taken from the 10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * paint that is passed to the draw call. 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap extractAlpha(Paint paint, int[] offsetXY) { 10559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't extractAlpha on a recycled bitmap"); 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativePaint = paint != null ? paint.mNativePaint : 0; 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap bm = nativeExtractAlpha(mNativeBitmap, nativePaint, offsetXY); 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bm == null) { 10599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Failed to extractAlpha on Bitmap"); 10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 106196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn bm.mDensity = mDensity; 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bm; 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10658cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen /** 106676d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed * Given another bitmap, return true if it has the same dimensions, config, 106776d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed * and pixel data as this bitmap. If any of those differ, return false. 106876d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed * If other is null, return false. 106976d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed * 107076d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed * @hide (just needed internally right now) 107176d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed */ 107276d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed public boolean sameAs(Bitmap other) { 107376d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed return this == other || 107476d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed (other != null && 107576d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed nativeSameAs(mNativeBitmap, other.mNativeBitmap)); 107676d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed } 107776d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed 107876d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed /** 10798cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * Rebuilds any caches associated with the bitmap that are used for 10808cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * drawing it. In the case of purgeable bitmaps, this call will attempt to 10818cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * ensure that the pixels have been decoded. 10828cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * If this is called on more than one bitmap in sequence, the priority is 10838cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * given in LRU order (i.e. the last bitmap called will be given highest 10848cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * priority). 10858cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * 10868cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * For bitmaps with no associated caches, this call is effectively a no-op, 10878cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * and therefore is harmless. 10888cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen */ 10898cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen public void prepareToDraw() { 10908cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen nativePrepareToDraw(mNativeBitmap); 10918cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen } 10928cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 1093e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy private static class BitmapFinalizer { 1094e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy private final int mNativeBitmap; 109502890fd0f98b3b8d98baf0bda1ea906afd723d8bRomain Guy 1096e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy BitmapFinalizer(int nativeBitmap) { 1097e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy mNativeBitmap = nativeBitmap; 109802890fd0f98b3b8d98baf0bda1ea906afd723d8bRomain Guy } 109902890fd0f98b3b8d98baf0bda1ea906afd723d8bRomain Guy 110002890fd0f98b3b8d98baf0bda1ea906afd723d8bRomain Guy @Override 1101e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy public void finalize() { 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeDestructor(mNativeBitmap); 11039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11058cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //////////// native methods 11079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native Bitmap nativeCreate(int[] colors, int offset, 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int stride, int width, int height, 11109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativeConfig, boolean mutable); 11119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native Bitmap nativeCopy(int srcBitmap, int nativeConfig, 11129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean isMutable); 11139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeDestructor(int nativeBitmap); 11149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeRecycle(int nativeBitmap); 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean nativeCompress(int nativeBitmap, int format, 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int quality, OutputStream stream, 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte[] tempStorage); 11199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeErase(int nativeBitmap, int color); 11209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int nativeWidth(int nativeBitmap); 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int nativeHeight(int nativeBitmap); 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int nativeRowBytes(int nativeBitmap); 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int nativeConfig(int nativeBitmap); 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean nativeHasAlpha(int nativeBitmap); 11258cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int nativeGetPixel(int nativeBitmap, int x, int y); 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeGetPixels(int nativeBitmap, int[] pixels, 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offset, int stride, int x, 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int y, int width, int height); 11308cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeSetPixel(int nativeBitmap, int x, int y, 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int color); 11339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeSetPixels(int nativeBitmap, int[] colors, 11349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offset, int stride, int x, 11359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int y, int width, int height); 11369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeCopyPixelsToBuffer(int nativeBitmap, 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Buffer dst); 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeCopyPixelsFromBuffer(int nb, Buffer src); 11390bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy private static native int nativeGenerationId(int nativeBitmap); 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native Bitmap nativeCreateFromParcel(Parcel p); 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // returns true on success 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean nativeWriteToParcel(int nativeBitmap, 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean isMutable, 1145de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn int density, 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Parcel p); 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // returns a new bitmap built from the native bitmap's alpha, and the paint 11489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native Bitmap nativeExtractAlpha(int nativeBitmap, 11499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativePaint, 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] offsetXY); 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11528cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen private static native void nativePrepareToDraw(int nativeBitmap); 1153a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed private static native void nativeSetHasAlpha(int nBitmap, boolean hasAlpha); 115476d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed private static native boolean nativeSameAs(int nb0, int nb1); 1155d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* package */ final int ni() { 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mNativeBitmap; 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1160