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; 22ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani 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 { 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Indicates that the bitmap was created for an unknown pixel density. 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see Bitmap#getDensity() 3411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see Bitmap#setDensity(int) 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public static final int DENSITY_NONE = 0; 3711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 38ce0537b80087a6225273040a987414b1dd081aa0Romain Guy /** 39ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * Note: mNativeBitmap is used by FaceDetector_jni.cpp 40ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * Don't change/rename without updating FaceDetector_jni.cpp 41ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * 42ce0537b80087a6225273040a987414b1dd081aa0Romain Guy * @hide 43ce0537b80087a6225273040a987414b1dd081aa0Romain Guy */ 44ce0537b80087a6225273040a987414b1dd081aa0Romain Guy public final int mNativeBitmap; 458cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 46e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy /** 47e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy * Backing buffer for the Bitmap. 48e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy * Made public for quick access from drawing methods -- do NOT modify 49e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy * from outside this class. 50e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy * 51e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy * @hide 52e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy */ 53e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy public byte[] mBuffer; 54e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 552361098da3b9d9c3eeed410dc72ba62c0e9177cfRomain Guy @SuppressWarnings({"FieldCanBeLocal", "UnusedDeclaration"}) // Keep to finalize native resources 56e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy private final BitmapFinalizer mFinalizer; 57e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final boolean mIsMutable; 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private byte[] mNinePatchChunk; // may be null 60ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani private int[] mLayoutBounds; // 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. 66dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn int mDensity = 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 } 803849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy 813849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy 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 } 88dde331cebd87982faded6818ad5f9927ff994c96Dianne 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 */ 973849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy Bitmap(int nativeBitmap, byte[] buffer, boolean isMutable, byte[] ninePatchChunk, 98e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy int density) { 99ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani this(nativeBitmap, buffer, isMutable, ninePatchChunk, null, density); 100ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani } 101ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani 102ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani /** 103ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani * @noinspection UnusedDeclaration 104ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani */ 105ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani /* Private constructor that must received an already allocated native 106ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani bitmap int (pointer). 107ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani 108ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani This can be called from JNI code. 109ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani */ 1103849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy Bitmap(int nativeBitmap, byte[] buffer, boolean isMutable, byte[] ninePatchChunk, 111ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani int[] layoutBounds, int density) { 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (nativeBitmap == 0) { 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("internal error: native bitmap is 0"); 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1158cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 116e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy mBuffer = buffer; 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we delete this in our finalizer 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNativeBitmap = nativeBitmap; 119e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy mFinalizer = new BitmapFinalizer(nativeBitmap); 120e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mIsMutable = isMutable; 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNinePatchChunk = ninePatchChunk; 123ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani mLayoutBounds = layoutBounds; 124de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn if (density >= 0) { 125de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn mDensity = density; 126de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn } 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Returns the density for this bitmap.</p> 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>The default density is the same density as the current display, 13396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * unless the current application does not support different screen 13496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * densities in which case it is 13596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * {@link android.util.DisplayMetrics#DENSITY_DEFAULT}. Note that 13696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * compatibility mode is determined by the application that was initially 13796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * loaded into a process -- applications that share the same process should 13896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * all have the same compatibility, or ensure they explicitly set the 13996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * density of their bitmaps appropriately.</p> 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @return A scaling factor of the default density or {@link #DENSITY_NONE} 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if the scaling factor is unknown. 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #setDensity(int) 145a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn * @see android.util.DisplayMetrics#DENSITY_DEFAULT 14611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see android.util.DisplayMetrics#densityDpi 14711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #DENSITY_NONE 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getDensity() { 15011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return mDensity; 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Specifies the density for this bitmap. When the bitmap is 15511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * drawn to a Canvas that also has a density, it will be scaled 15611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * appropriately.</p> 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @param density The density scaling factor to use with this bitmap or 15911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * {@link #DENSITY_NONE} if the density is unknown. 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #getDensity() 162a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn * @see android.util.DisplayMetrics#DENSITY_DEFAULT 16311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see android.util.DisplayMetrics#densityDpi 16411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #DENSITY_NONE 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public void setDensity(int density) { 16711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn mDensity = density; 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the nine patch chunk. 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param chunk The definition of the nine patch 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setNinePatchChunk(byte[] chunk) { 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNinePatchChunk = chunk; 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1808cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 182ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani * Sets the layout bounds as an array of left, top, right, bottom integers 18317471d730f20ee785c9c48a99eb331a40550612bRomain Guy * @param bounds the array containing the padding values 184ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani * 185ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani * @hide 186ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani */ 187ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani public void setLayoutBounds(int[] bounds) { 188ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani mLayoutBounds = bounds; 189ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani } 190ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani 191ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani /** 192a383b3f646cbc1fd870f2694d4fac24340834916Patrick Dubroy * Free the native object associated with this bitmap, and clear the 193a383b3f646cbc1fd870f2694d4fac24340834916Patrick Dubroy * reference to the pixel data. This will not free the pixel data synchronously; 194a383b3f646cbc1fd870f2694d4fac24340834916Patrick Dubroy * it simply allows it to be garbage collected if there are no other references. 195a383b3f646cbc1fd870f2694d4fac24340834916Patrick Dubroy * The bitmap is marked as "dead", meaning it will throw an exception if 196a383b3f646cbc1fd870f2694d4fac24340834916Patrick Dubroy * getPixels() or setPixels() is called, and will draw nothing. This operation 197a383b3f646cbc1fd870f2694d4fac24340834916Patrick Dubroy * cannot be reversed, so it should only be called if you are sure there are no 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * further uses for the bitmap. This is an advanced call, and normally need 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not be called, since the normal GC process will free up this memory when 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * there are no more references to this bitmap. 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void recycle() { 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!mRecycled) { 204547e66531d521eb1eadac87edb0f79f8c2f1bbe0Chet Haase if (nativeRecycle(mNativeBitmap)) { 205547e66531d521eb1eadac87edb0f79f8c2f1bbe0Chet Haase // return value indicates whether native pixel object was actually recycled. 206547e66531d521eb1eadac87edb0f79f8c2f1bbe0Chet Haase // false indicates that it is still in use at the native level and these 207547e66531d521eb1eadac87edb0f79f8c2f1bbe0Chet Haase // objects should not be collected now. They will be collected later when the 208547e66531d521eb1eadac87edb0f79f8c2f1bbe0Chet Haase // Bitmap itself is collected. 209547e66531d521eb1eadac87edb0f79f8c2f1bbe0Chet Haase mBuffer = null; 210547e66531d521eb1eadac87edb0f79f8c2f1bbe0Chet Haase mNinePatchChunk = null; 211547e66531d521eb1eadac87edb0f79f8c2f1bbe0Chet Haase } 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRecycled = true; 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if this bitmap has been recycled. If so, then it is an error 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to try to access its pixels, and the bitmap will not draw. 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the bitmap has been recycled 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean isRecycled() { 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mRecycled; 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2258cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2270bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy * Returns the generation ID of this bitmap. The generation ID changes 2280bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy * whenever the bitmap is modified. This can be used as an efficient way to 2290bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy * check if a bitmap has changed. 2300bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy * 2310bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy * @return The current generation ID for this bitmap. 2320bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy */ 2330bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy public int getGenerationId() { 2340bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy return nativeGenerationId(mNativeBitmap); 2350bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy } 2360bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy 2370bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy /** 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is called by methods that want to throw an exception if the bitmap 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has already been recycled. 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void checkRecycled(String errorMessage) { 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRecycled) { 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(errorMessage); 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2468cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Common code for checking that x and y are >= 0 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x x coordinate to ensure is >= 0 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y y coordinate to ensure is >= 0 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void checkXYSign(int x, int y) { 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (x < 0) { 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("x must be >= 0"); 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (y < 0) { 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("y must be >= 0"); 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Common code for checking that width and height are > 0 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width width to ensure is > 0 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height height to ensure is > 0 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void checkWidthHeight(int width, int height) { 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width <= 0) { 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("width must be > 0"); 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (height <= 0) { 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("height must be > 0"); 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 277676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy /** 278676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * Possible bitmap configurations. A bitmap configuration describes 279676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * how pixels are stored. This affects the quality (color depth) as 280676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * well as the ability to display transparent/translucent colors. 281676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy */ 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum Config { 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // these native values must match up with the enum in SkBitmap.h 284676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy 285676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy /** 286676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * Each pixel is stored as a single translucency (alpha) channel. 287676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * This is very useful to efficiently store masks for instance. 288676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * No color information is stored. 289676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * With this configuration, each pixel requires 1 byte of memory. 290676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy */ 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ALPHA_8 (2), 292676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy 293676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy /** 294676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * Each pixel is stored on 2 bytes and only the RGB channels are 295676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * encoded: red is stored with 5 bits of precision (32 possible 296676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * values), green is stored with 6 bits of precision (64 possible 297676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * values) and blue is stored with 5 bits of precision. 298676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * 299676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * This configuration can produce slight visual artifacts depending 300676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * on the configuration of the source. For instance, without 301676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * dithering, the result might show a greenish tint. To get better 302676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * results dithering should be applied. 303676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * 304676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * This configuration may be useful when using opaque bitmaps 305676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * that do not require high color fidelity. 306676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy */ 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project RGB_565 (4), 308676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy 309676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy /** 310676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * Each pixel is stored on 2 bytes. The three RGB color channels 311676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * and the alpha channel (translucency) are stored with a 4 bits 312676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * precision (16 possible values.) 313676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * 314676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * This configuration is mostly useful if the application needs 315676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * to store translucency information but also needs to save 316676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * memory. 317676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * 318676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * It is recommended to use {@link #ARGB_8888} instead of this 319676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * configuration. 320676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * 321676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * @deprecated Because of the poor quality of this configuration, 322676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * it is advised to use {@link #ARGB_8888} instead. 323676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy */ 324676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy @Deprecated 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ARGB_4444 (5), 326676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy 327676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy /** 328676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * Each pixel is stored on 4 bytes. Each channel (RGB and alpha 329676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * for translucency) is stored with 8 bits of precision (256 330676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * possible values.) 331676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * 332676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * This configuration is very flexible and offers the best 333676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * quality. It should be used whenever possible. 334676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy */ 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ARGB_8888 (6); 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 337676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy final int nativeInt; 338676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy 339676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy @SuppressWarnings({"deprecation"}) 340676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy private static Config sConfigs[] = { 341676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy null, null, ALPHA_8, null, RGB_565, ARGB_4444, ARGB_8888 342676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy }; 343676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Config(int ni) { 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = ni; 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3478cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 348676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy static Config nativeToConfig(int ni) { 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sConfigs[ni]; 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3528cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3543849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * <p>Copy the bitmap's pixels into the specified buffer (allocated by the 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller). An exception is thrown if the buffer is not large enough to 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * hold all of the pixels (taking into account the number of bytes per 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pixel) or if the Buffer subclass is not one of the support types 3583849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * (ByteBuffer, ShortBuffer, IntBuffer).</p> 3593849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * <p>The content of the bitmap is copied into the buffer as-is. This means 3603849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * that if this bitmap stores its pixels pre-multiplied 3613849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * (see {@link #isPremultiplied()}, the values in the buffer will also be 3623849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * pre-multiplied.</p> 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void copyPixelsToBuffer(Buffer dst) { 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int elements = dst.remaining(); 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int shift; 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (dst instanceof ByteBuffer) { 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 0; 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (dst instanceof ShortBuffer) { 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 1; 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (dst instanceof IntBuffer) { 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 2; 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("unsupported Buffer subclass"); 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3768cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long bufferSize = (long)elements << shift; 378f7f9d9c39df22ad6929f001f07588469f77e8bf5Jesse Wilson long pixelSize = getByteCount(); 3798cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bufferSize < pixelSize) { 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Buffer not large enough for pixels"); 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3838cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeCopyPixelsToBuffer(mNativeBitmap, dst); 3858cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // now update the buffer's position 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int position = dst.position(); 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project position += pixelSize >> shift; 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dst.position(position); 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3933849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * <p>Copy the pixels from the buffer, beginning at the current position, 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * overwriting the bitmap's pixels. The data in the buffer is not changed 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in any way (unlike setPixels(), which converts from unpremultipled 32bit 3963849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * to whatever the bitmap's native format is.</p> 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void copyPixelsFromBuffer(Buffer src) { 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("copyPixelsFromBuffer called on recycled bitmap"); 4008cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int elements = src.remaining(); 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int shift; 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (src instanceof ByteBuffer) { 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 0; 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (src instanceof ShortBuffer) { 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 1; 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (src instanceof IntBuffer) { 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 2; 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("unsupported Buffer subclass"); 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4128cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 4133849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy long bufferBytes = (long) elements << shift; 414f7f9d9c39df22ad6929f001f07588469f77e8bf5Jesse Wilson long bitmapBytes = getByteCount(); 4158cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bufferBytes < bitmapBytes) { 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Buffer not large enough for pixels"); 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4198cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeCopyPixelsFromBuffer(mNativeBitmap, src); 42155adc145d460be4b21de0d77be1f6076c3591e3cMarco Nelissen 42255adc145d460be4b21de0d77be1f6076c3591e3cMarco Nelissen // now update the buffer's position 42355adc145d460be4b21de0d77be1f6076c3591e3cMarco Nelissen int position = src.position(); 42455adc145d460be4b21de0d77be1f6076c3591e3cMarco Nelissen position += bitmapBytes >> shift; 42555adc145d460be4b21de0d77be1f6076c3591e3cMarco Nelissen src.position(position); 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4278cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tries to make a new bitmap based on the dimensions of this bitmap, 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * setting the new bitmap's config to the one specified, and then copying 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this bitmap's pixels into the new bitmap. If the conversion is not 43296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * supported, or the allocator fails, then this returns NULL. The returned 43396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * bitmap initially has the same density as the original. 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The desired config for the resulting bitmap 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param isMutable True if the resulting bitmap should be mutable (i.e. 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * its pixels can be modified) 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the new bitmap, or null if the copy could not be made. 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap copy(Config config, boolean isMutable) { 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't copy a recycled bitmap"); 44296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn Bitmap b = nativeCopy(mNativeBitmap, config.nativeInt, isMutable); 44396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn if (b != null) { 44496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn b.mDensity = mDensity; 44596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn } 44696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn return b; 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 44902d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick /** 450f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * Creates a new bitmap, scaled from an existing bitmap, when possible. If the 451f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * specified width and height are the same as the current width and height of 452f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * the source btimap, the source bitmap is returned and now new bitmap is 453f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * created. 45402d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick * 45502d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick * @param src The source bitmap. 45602d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick * @param dstWidth The new bitmap's desired width. 45702d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick * @param dstHeight The new bitmap's desired height. 45802d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick * @param filter true if the source should be filtered. 459f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * @return The new scaled bitmap or the source bitmap if no scaling is required. 46002d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick */ 461f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy public static Bitmap createScaledBitmap(Bitmap src, int dstWidth, int dstHeight, 462f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy boolean filter) { 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Matrix m; 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (Bitmap.class) { 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // small pool of just 1 matrix 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m = sScaleMatrix; 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sScaleMatrix = null; 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (m == null) { 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m = new Matrix(); 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4738cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int width = src.getWidth(); 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int height = src.getHeight(); 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final float sx = dstWidth / (float)width; 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final float sy = dstHeight / (float)height; 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m.setScale(sx, sy); 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap b = Bitmap.createBitmap(src, 0, 0, width, height, m, filter); 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (Bitmap.class) { 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // do we need to check for null? why not just assign everytime? 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sScaleMatrix == null) { 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sScaleMatrix = m; 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4888cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen return b; 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4908cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns an immutable bitmap from the source bitmap. The new bitmap may 49396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * be the same object as source, or a copy may have been made. It is 49496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * initialized with the same density as the original bitmap. 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(Bitmap src) { 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return createBitmap(src, 0, 0, src.getWidth(), src.getHeight()); 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns an immutable bitmap from the specified subset of the source 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bitmap. The new bitmap may be the same object as source, or a copy may 503f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * have been made. It is initialized with the same density as the original 504f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * bitmap. 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param source The bitmap we are subsetting 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate of the first pixel in source 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate of the first pixel in source 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The number of pixels in each row 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The number of rows 511f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * @return A copy of a subset of the source bitmap or the source bitmap itself. 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(Bitmap source, int x, int y, int width, int height) { 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return createBitmap(source, x, y, width, height, null, false); 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5168cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns an immutable bitmap from subset of the source bitmap, 519f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * transformed by the optional matrix. The new bitmap may be the 520f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * same object as source, or a copy may have been made. It is 52196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * initialized with the same density as the original bitmap. 522f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * 523f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * If the source bitmap is immutable and the requested subset is the 524f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * same as the source bitmap itself, then the source bitmap is 525f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * returned and no new bitmap is created. 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param source The bitmap we are subsetting 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate of the first pixel in source 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate of the first pixel in source 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The number of pixels in each row 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The number of rows 53260b88edea7132ddce90f2dced07c6706f1502270Ken Shirriff * @param m Optional matrix to be applied to the pixels 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param filter true if the source should be filtered. 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Only applies if the matrix contains more than just 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * translation. 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A bitmap that represents the specified subset of source 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if the x, y, width, height values are 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * outside of the dimensions of the source bitmap. 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(Bitmap source, int x, int y, int width, int height, 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Matrix m, boolean filter) { 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkXYSign(x, y); 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkWidthHeight(width, height); 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (x + width > source.getWidth()) { 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("x + width must be <= bitmap.width()"); 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (y + height > source.getHeight()) { 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("y + height must be <= bitmap.height()"); 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // check if we can just return our argument unchanged 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!source.isMutable() && x == 0 && y == 0 && width == source.getWidth() && 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project height == source.getHeight() && (m == null || m.isIdentity())) { 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return source; 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5578cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int neww = width; 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int newh = height; 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Canvas canvas = new Canvas(); 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap bitmap; 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Paint paint; 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect srcR = new Rect(x, y, x + width, y + height); 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project RectF dstR = new RectF(0, 0, width, height); 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 567feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy Config newConfig = Config.ARGB_8888; 568feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy final Config config = source.getConfig(); 569feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy // GIF files generate null configs, assume ARGB_8888 570feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy if (config != null) { 571feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy switch (config) { 572feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy case RGB_565: 573feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy newConfig = Config.RGB_565; 574feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy break; 575feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy case ALPHA_8: 576feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy newConfig = Config.ALPHA_8; 577feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy break; 578676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy //noinspection deprecation 579feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy case ARGB_4444: 580feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy case ARGB_8888: 581feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy default: 582feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy newConfig = Config.ARGB_8888; 583feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy break; 584feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy } 585feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy } 586d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (m == null || m.isIdentity()) { 588d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy bitmap = createBitmap(neww, newh, newConfig, source.hasAlpha()); 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint = null; // not needed 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 591d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy final boolean transformed = !m.rectStaysRect(); 592d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project RectF deviceR = new RectF(); 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m.mapRect(deviceR, dstR); 595d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project neww = Math.round(deviceR.width()); 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project newh = Math.round(deviceR.height()); 598d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 599d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy bitmap = createBitmap(neww, newh, transformed ? Config.ARGB_8888 : newConfig, 600d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy transformed || source.hasAlpha()); 601d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project canvas.translate(-deviceR.left, -deviceR.top); 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project canvas.concat(m); 604d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint = new Paint(); 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint.setFilterBitmap(filter); 607d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy if (transformed) { 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint.setAntiAlias(true); 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 61196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // The new bitmap was created from a known bitmap source so assume that 61311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn // they use the same density 61411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn bitmap.mDensity = source.mDensity; 61596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn 61696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn canvas.setBitmap(bitmap); 61796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn canvas.drawBitmap(source, srcR, dstR, paint); 6186311d0a079702b29984c0d31937345be105e1a5eDianne Hackborn canvas.setBitmap(null); 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bitmap; 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6228cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 62496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * Returns a mutable bitmap with the specified width and height. Its 62596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * initial density is as per {@link #getDensity}. 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The width of the bitmap 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The height of the bitmap 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The bitmap config to create. 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if the width or height are <= 0 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(int width, int height, Config config) { 633d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy return createBitmap(width, height, config, true); 634d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy } 635d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 636d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy /** 637d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * Returns a mutable bitmap with the specified width and height. Its 638dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * initial density is determined from the given {@link DisplayMetrics}. 639dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * 640dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param display Display metrics for the display this bitmap will be 641dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * drawn on. 642dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param width The width of the bitmap 643dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param height The height of the bitmap 644dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param config The bitmap config to create. 645dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @throws IllegalArgumentException if the width or height are <= 0 646dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn */ 647dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn public static Bitmap createBitmap(DisplayMetrics display, int width, 648dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn int height, Config config) { 649dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn return createBitmap(display, width, height, config, true); 650dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn } 651dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn 652dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn /** 653dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * Returns a mutable bitmap with the specified width and height. Its 654d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * initial density is as per {@link #getDensity}. 655d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * 656d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * @param width The width of the bitmap 657d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * @param height The height of the bitmap 658d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * @param config The bitmap config to create. 659d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * @param hasAlpha If the bitmap is ARGB_8888 this flag can be used to mark the 660d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * bitmap as opaque. Doing so will clear the bitmap in black 661d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * instead of transparent. 662d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * 663d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * @throws IllegalArgumentException if the width or height are <= 0 664d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy */ 665d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy private static Bitmap createBitmap(int width, int height, Config config, boolean hasAlpha) { 666dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn return createBitmap(null, width, height, config, hasAlpha); 667dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn } 668dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn 669dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn /** 670dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * Returns a mutable bitmap with the specified width and height. Its 671dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * initial density is determined from the given {@link DisplayMetrics}. 672dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * 673dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param display Display metrics for the display this bitmap will be 674dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * drawn on. 675dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param width The width of the bitmap 676dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param height The height of the bitmap 677dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param config The bitmap config to create. 678dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param hasAlpha If the bitmap is ARGB_8888 this flag can be used to mark the 679dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * bitmap as opaque. Doing so will clear the bitmap in black 680dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * instead of transparent. 681dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * 682dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @throws IllegalArgumentException if the width or height are <= 0 683dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn */ 684dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn private static Bitmap createBitmap(DisplayMetrics display, int width, int height, 685dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn Config config, boolean hasAlpha) { 686e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy if (width <= 0 || height <= 0) { 687e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy throw new IllegalArgumentException("width and height must be > 0"); 688e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap bm = nativeCreate(null, 0, width, width, height, config.nativeInt, true); 690dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn if (display != null) { 691dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn bm.mDensity = display.densityDpi; 692dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn } 693d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy if (config == Config.ARGB_8888 && !hasAlpha) { 6941373a8eb581fe3c8e9a036e69042015f98a7e346Christopher Tate nativeErase(bm.mNativeBitmap, 0xff000000); 695d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy nativeSetHasAlpha(bm.mNativeBitmap, hasAlpha); 696d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy } else { 6971373a8eb581fe3c8e9a036e69042015f98a7e346Christopher Tate // No need to initialize it to zeroes; it is backed by a VM byte array 6981373a8eb581fe3c8e9a036e69042015f98a7e346Christopher Tate // which is by definition preinitialized to all zeroes. 6991373a8eb581fe3c8e9a036e69042015f98a7e346Christopher Tate // 7001373a8eb581fe3c8e9a036e69042015f98a7e346Christopher Tate //nativeErase(bm.mNativeBitmap, 0); 701d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy } 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bm; 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7048cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a immutable bitmap with the specified width and height, with each 70796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * pixel value set to the corresponding value in the colors array. Its 70896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * initial density is as per {@link #getDensity}. 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors Array of {@link Color} used to initialize the pixels. 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Number of values to skip before the first color in the 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * array of colors. 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stride Number of colors in the array between rows (must be >= 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * width or <= -width). 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The width of the bitmap 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The height of the bitmap 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The bitmap config to create. If the config does not 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * support per-pixel alpha (e.g. RGB_565), then the alpha 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bytes in the colors[] will be ignored (assumed to be FF) 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if the width or height are <= 0, or if 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the color array's length is less than the number of pixels. 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(int colors[], int offset, int stride, 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int width, int height, Config config) { 725dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn return createBitmap(null, colors, offset, stride, width, height, config); 726dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn } 727dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn 728dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn /** 729dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * Returns a immutable bitmap with the specified width and height, with each 730dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * pixel value set to the corresponding value in the colors array. Its 731dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * initial density is determined from the given {@link DisplayMetrics}. 732dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * 733dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param display Display metrics for the display this bitmap will be 734dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * drawn on. 735dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param colors Array of {@link Color} used to initialize the pixels. 736dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param offset Number of values to skip before the first color in the 737dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * array of colors. 738dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param stride Number of colors in the array between rows (must be >= 739dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * width or <= -width). 740dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param width The width of the bitmap 741dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param height The height of the bitmap 742dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param config The bitmap config to create. If the config does not 743dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * support per-pixel alpha (e.g. RGB_565), then the alpha 744dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * bytes in the colors[] will be ignored (assumed to be FF) 745dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @throws IllegalArgumentException if the width or height are <= 0, or if 746dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * the color array's length is less than the number of pixels. 747dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn */ 748dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn public static Bitmap createBitmap(DisplayMetrics display, int colors[], 749dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn int offset, int stride, int width, int height, Config config) { 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkWidthHeight(width, height); 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (Math.abs(stride) < width) { 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("abs(stride) must be >= width"); 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int lastScanline = offset + (height - 1) * stride; 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = colors.length; 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (offset < 0 || (offset + width > length) || lastScanline < 0 || 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project (lastScanline + width > length)) { 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 761e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy if (width <= 0 || height <= 0) { 762e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy throw new IllegalArgumentException("width and height must be > 0"); 763e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 764dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn Bitmap bm = nativeCreate(colors, offset, stride, width, height, 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project config.nativeInt, false); 766dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn if (display != null) { 767dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn bm.mDensity = display.densityDpi; 768dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn } 769dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn return bm; 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a immutable bitmap with the specified width and height, with each 77496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * pixel value set to the corresponding value in the colors array. Its 77596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * initial density is as per {@link #getDensity}. 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors Array of {@link Color} used to initialize the pixels. 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This array must be at least as large as width * height. 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The width of the bitmap 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The height of the bitmap 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The bitmap config to create. If the config does not 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * support per-pixel alpha (e.g. RGB_565), then the alpha 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bytes in the colors[] will be ignored (assumed to be FF) 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if the width or height are <= 0, or if 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the color array's length is less than the number of pixels. 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(int colors[], int width, int height, Config config) { 788dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn return createBitmap(null, colors, 0, width, width, height, config); 789dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn } 790dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn 791dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn /** 792dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * Returns a immutable bitmap with the specified width and height, with each 793dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * pixel value set to the corresponding value in the colors array. Its 794dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * initial density is determined from the given {@link DisplayMetrics}. 795dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * 796dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param display Display metrics for the display this bitmap will be 797dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * drawn on. 798dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param colors Array of {@link Color} used to initialize the pixels. 799dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * This array must be at least as large as width * height. 800dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param width The width of the bitmap 801dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param height The height of the bitmap 802dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param config The bitmap config to create. If the config does not 803dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * support per-pixel alpha (e.g. RGB_565), then the alpha 804dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * bytes in the colors[] will be ignored (assumed to be FF) 805dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @throws IllegalArgumentException if the width or height are <= 0, or if 806dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * the color array's length is less than the number of pixels. 807dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn */ 808dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn public static Bitmap createBitmap(DisplayMetrics display, int colors[], 809dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn int width, int height, Config config) { 810dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn return createBitmap(display, colors, 0, width, width, height, config); 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns an optional array of private data, used by the UI system for 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * some bitmaps. Not intended to be called by applications. 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public byte[] getNinePatchChunk() { 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mNinePatchChunk; 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 822ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani * @hide 823ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani * @return the layout padding [left, right, top, bottom] 824ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani */ 825ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani public int[] getLayoutBounds() { 826ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani return mLayoutBounds; 827ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani } 828ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani 829ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani /** 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Specifies the known formats a bitmap can be compressed into 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum CompressFormat { 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project JPEG (0), 8342305ac9e4a262ed09fd034ae417e9b1dda4c0ccbVikas Arora PNG (1), 8352305ac9e4a262ed09fd034ae417e9b1dda4c0ccbVikas Arora WEBP (2); 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project CompressFormat(int nativeInt) { 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = nativeInt; 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int nativeInt; 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Number of bytes of temp storage we use for communicating between the 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * native compressor and the java OutputStream. 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final static int WORKING_COMPRESS_STORAGE = 4096; 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write a compressed version of the bitmap to the specified outputstream. 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this returns true, the bitmap can be reconstructed by passing a 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * corresponding inputstream to BitmapFactory.decodeStream(). Note: not 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * all Formats support all bitmap configs directly, so it is possible that 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the returned bitmap from BitmapFactory could be in a different bitdepth, 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and/or may have lost per-pixel alpha (e.g. JPEG only supports opaque 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pixels). 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param format The format of the compressed image 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param quality Hint to the compressor, 0-100. 0 meaning compress for 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * small size, 100 meaning compress for max quality. Some 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * formats, like PNG which is lossless, will ignore the 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * quality setting 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stream The outputstream to write the compressed data. 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if successfully compressed to the specified stream. 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean compress(CompressFormat format, int quality, OutputStream stream) { 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't compress a recycled bitmap"); 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // do explicit check before calling the native method 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (stream == null) { 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (quality < 0 || quality > 100) { 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("quality must be 0..100"); 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeCompress(mNativeBitmap, format.nativeInt, quality, 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project stream, new byte[WORKING_COMPRESS_STORAGE]); 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8788cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if the bitmap is marked as mutable (i.e. can be drawn into) 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean isMutable() { 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mIsMutable; 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8863849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy /** 8873849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * <p>Indicates whether pixels stored in this bitmaps are stored pre-multiplied. 8883849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * When a pixel is pre-multiplied, the RGB components have been multiplied by 8893849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * the alpha component. For instance, if the original color is a 50% 8903849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * translucent red <code>(128, 255, 0, 0)</code>, the pre-multiplied form is 8913849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * <code>(128, 128, 0, 0)</code>.</p> 8923849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * 8933849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * <p>This method always returns false if {@link #getConfig()} is 8944ff0cf4b83605bff630c4e6f1fabe4f72a3f93a1Romain Guy * {@link Bitmap.Config#RGB_565}.</p> 8954ff0cf4b83605bff630c4e6f1fabe4f72a3f93a1Romain Guy * 8964ff0cf4b83605bff630c4e6f1fabe4f72a3f93a1Romain Guy * <p>This method only returns true if {@link #hasAlpha()} returns true. 8974ff0cf4b83605bff630c4e6f1fabe4f72a3f93a1Romain Guy * A bitmap with no alpha channel can be used both as a pre-multiplied and 8984ff0cf4b83605bff630c4e6f1fabe4f72a3f93a1Romain Guy * as a non pre-multiplied bitmap.</p> 8993849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * 9003849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * @return true if the underlying pixels have been pre-multiplied, false 9013849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * otherwise 9023849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy */ 9033849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy public final boolean isPremultiplied() { 9044ff0cf4b83605bff630c4e6f1fabe4f72a3f93a1Romain Guy return getConfig() != Config.RGB_565 && hasAlpha(); 9053849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy } 9063849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Returns the bitmap's width */ 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final int getWidth() { 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mWidth == -1 ? mWidth = nativeWidth(mNativeBitmap) : mWidth; 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Returns the bitmap's height */ 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final int getHeight() { 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mHeight == -1 ? mHeight = nativeHeight(mNativeBitmap) : mHeight; 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9168cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 91811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * Convenience for calling {@link #getScaledWidth(int)} with the target 91911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * density of the given {@link Canvas}. 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9212784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn public int getScaledWidth(Canvas canvas) { 92211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return scaleFromDensity(getWidth(), mDensity, canvas.mDensity); 9232784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn } 9242784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn 9252784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn /** 92611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * Convenience for calling {@link #getScaledHeight(int)} with the target 92711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * density of the given {@link Canvas}. 9282784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn */ 9292784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn public int getScaledHeight(Canvas canvas) { 93011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return scaleFromDensity(getHeight(), mDensity, canvas.mDensity); 93111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn } 93211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 93311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn /** 93411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * Convenience for calling {@link #getScaledWidth(int)} with the target 93511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * density of the given {@link DisplayMetrics}. 93611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn */ 93711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getScaledWidth(DisplayMetrics metrics) { 93811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return scaleFromDensity(getWidth(), mDensity, metrics.densityDpi); 93911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn } 94011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 94111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn /** 94211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * Convenience for calling {@link #getScaledHeight(int)} with the target 94311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * density of the given {@link DisplayMetrics}. 94411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn */ 94511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getScaledHeight(DisplayMetrics metrics) { 94611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return scaleFromDensity(getHeight(), mDensity, metrics.densityDpi); 9472784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn } 9482784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn 9492784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn /** 9502784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn * Convenience method that returns the width of this bitmap divided 9512784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn * by the density scale factor. 9522784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn * 95311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @param targetDensity The density of the target canvas of the bitmap. 9542784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn * @return The scaled width of this bitmap, according to the density scale factor. 9552784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn */ 95611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getScaledWidth(int targetDensity) { 95711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return scaleFromDensity(getWidth(), mDensity, targetDensity); 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Convenience method that returns the height of this bitmap divided 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * by the density scale factor. 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 96411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @param targetDensity The density of the target canvas of the bitmap. 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The scaled height of this bitmap, according to the density scale factor. 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 96711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getScaledHeight(int targetDensity) { 96811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return scaleFromDensity(getHeight(), mDensity, targetDensity); 96911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn } 97011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 97111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn /** 97211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @hide 97311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn */ 97411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn static public int scaleFromDensity(int size, int sdensity, int tdensity) { 9750b68477f8287fe5ddac1beb1c9d0811ded034dadRomain Guy if (sdensity == DENSITY_NONE || tdensity == DENSITY_NONE || sdensity == tdensity) { 97611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return size; 9772784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn } 97811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 97911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn // Scale by tdensity / sdensity, rounding up. 980366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy return ((size * tdensity) + (sdensity >> 1)) / sdensity; 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 98211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the number of bytes between rows in the bitmap's pixels. Note that 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this refers to the pixels as stored natively by the bitmap. If you call 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * getPixels() or setPixels(), then the pixels are uniformly treated as 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 32bit values, packed according to the Color class. 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return number of bytes between rows of the native bitmap pixels. 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final int getRowBytes() { 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeRowBytes(mNativeBitmap); 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9948cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 996f7f9d9c39df22ad6929f001f07588469f77e8bf5Jesse Wilson * Returns the number of bytes used to store this bitmap's pixels. 997f7f9d9c39df22ad6929f001f07588469f77e8bf5Jesse Wilson */ 998f7f9d9c39df22ad6929f001f07588469f77e8bf5Jesse Wilson public final int getByteCount() { 999f7f9d9c39df22ad6929f001f07588469f77e8bf5Jesse Wilson // int result permits bitmaps up to 46,340 x 46,340 1000f7f9d9c39df22ad6929f001f07588469f77e8bf5Jesse Wilson return getRowBytes() * getHeight(); 1001f7f9d9c39df22ad6929f001f07588469f77e8bf5Jesse Wilson } 1002f7f9d9c39df22ad6929f001f07588469f77e8bf5Jesse Wilson 1003f7f9d9c39df22ad6929f001f07588469f77e8bf5Jesse Wilson /** 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If the bitmap's internal config is in one of the public formats, return 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that config, otherwise return null. 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final Config getConfig() { 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Config.nativeToConfig(nativeConfig(mNativeBitmap)); 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1011a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed /** Returns true if the bitmap's config supports per-pixel alpha, and 1012a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * if the pixels may contain non-opaque alpha values. For some configs, 1013a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * this is always false (e.g. RGB_565), since they do not support per-pixel 1014a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * alpha. However, for configs that do, the bitmap may be flagged to be 1015a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * known that all of its pixels are opaque. In this case hasAlpha() will 1016a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * also return false. If a config such as ARGB_8888 is not so flagged, 1017a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * it will return true by default. 1018a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed */ 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean hasAlpha() { 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeHasAlpha(mNativeBitmap); 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1024a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * Tell the bitmap if all of the pixels are known to be opaque (false) 1025a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * or if some of the pixels may contain non-opaque alpha values (true). 1026366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy * Note, for some configs (e.g. RGB_565) this call is ignored, since it 1027366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy * does not support per-pixel alpha values. 1028a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * 1029a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * This is meant as a drawing hint, as in some cases a bitmap that is known 1030a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * to be opaque can take a faster drawing case than one that may have 1031a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * non-opaque per-pixel alpha values. 1032a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed */ 1033a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed public void setHasAlpha(boolean hasAlpha) { 1034a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed nativeSetHasAlpha(mNativeBitmap, hasAlpha); 1035a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed } 1036a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed 1037a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed /** 1038713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * Indicates whether the renderer responsible for drawing this 1039713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * bitmap should attempt to use mipmaps when this bitmap is drawn 1040713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * scaled down. 1041713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 1042713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * If you know that you are going to draw this bitmap at less than 1043713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 50% of its original size, you may be able to obtain a higher 1044713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * quality 1045713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 1046713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * This property is only a suggestion that can be ignored by the 1047713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * renderer. It is not guaranteed to have any effect. 1048713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 1049713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * @return true if the renderer should attempt to use mipmaps, 1050713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * false otherwise 1051713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 1052713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * @see #setHasMipMap(boolean) 1053713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy */ 1054713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy public final boolean hasMipMap() { 1055713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy return nativeHasMipMap(mNativeBitmap); 1056713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy } 1057713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy 1058713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy /** 1059713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * Set a hint for the renderer responsible for drawing this bitmap 1060713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * indicating that it should attempt to use mipmaps when this bitmap 1061713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * is drawn scaled down. 1062713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 1063713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * If you know that you are going to draw this bitmap at less than 1064713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 50% of its original size, you may be able to obtain a higher 1065713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * quality by turning this property on. 1066713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 1067713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * Note that if the renderer respects this hint it might have to 1068713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * allocate extra memory to hold the mipmap levels for this bitmap. 1069713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 1070713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * This property is only a suggestion that can be ignored by the 1071713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * renderer. It is not guaranteed to have any effect. 1072713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 1073713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * @param hasMipMap indicates whether the renderer should attempt 1074713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * to use mipmaps 1075713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 1076713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * @see #hasMipMap() 1077713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy */ 1078713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy public final void setHasMipMap(boolean hasMipMap) { 1079713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy nativeSetHasMipMap(mNativeBitmap, hasMipMap); 1080713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy } 1081713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy 1082713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy /** 10839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fills the bitmap's pixels with the specified {@link Color}. 10849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException if the bitmap is not mutable. 10869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void eraseColor(int c) { 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't erase a recycled bitmap"); 10899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!isMutable()) { 10909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException("cannot erase immutable bitmaps"); 10919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeErase(mNativeBitmap, c); 10939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the {@link Color} at the specified location. Throws an exception 10979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if x or y are out of bounds (negative or >= to the width or height 10983849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * respectively). The returned color is a non-premultiplied ARGB value. 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate (0...width-1) of the pixel to return 11019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate (0...height-1) of the pixel to return 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The argb {@link Color} at the specified coordinate 11039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if x, y exceed the bitmap's bounds 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPixel(int x, int y) { 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't call getPixel() on a recycled bitmap"); 11079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkPixelAccess(x, y); 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeGetPixel(mNativeBitmap, x, y); 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11108cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 11119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns in pixels[] a copy of the data in the bitmap. Each value is 11139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a packed int representing a {@link Color}. The stride parameter allows 11149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the caller to allow for gaps in the returned pixels array between 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * rows. For normal packed results, just pass width for the stride value. 11163849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * The returned colors are non-premultiplied ARGB values. 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pixels The array to receive the bitmap's colors 11199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset The first index to write into pixels[] 11209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stride The number of entries in pixels[] to skip between 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * rows (must be >= bitmap's width). Can be negative. 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate of the first pixel to read from 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate of the first pixel to read from 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The number of pixels to read from each row 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The number of rows to read 11283849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if x, y, width, height exceed the 11309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bounds of the bitmap, or if abs(stride) < width. 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws ArrayIndexOutOfBoundsException if the pixels array is too small 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to receive the specified number of pixels. 11339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void getPixels(int[] pixels, int offset, int stride, 11359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int x, int y, int width, int height) { 11369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't call getPixels() on a recycled bitmap"); 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width == 0 || height == 0) { 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; // nothing to do 11399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkPixelsAccess(x, y, width, height, offset, stride, pixels); 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeGetPixels(mNativeBitmap, pixels, offset, stride, 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project x, y, width, height); 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11448cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 11459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Shared code to check for illegal arguments passed to getPixel() 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or setPixel() 11483849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * 11499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x x coordinate of the pixel 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y y coordinate of the pixel 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void checkPixelAccess(int x, int y) { 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkXYSign(x, y); 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (x >= getWidth()) { 11559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("x must be < bitmap.width()"); 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (y >= getHeight()) { 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("y must be < bitmap.height()"); 11599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Shared code to check for illegal arguments passed to getPixels() 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or setPixels() 11659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x left edge of the area of pixels to access 11679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y top edge of the area of pixels to access 11689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width width of the area of pixels to access 11699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height height of the area of pixels to access 11709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset offset into pixels[] array 11719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stride number of elements in pixels[] between each logical row 11729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pixels array to hold the area of pixels being accessed 11739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void checkPixelsAccess(int x, int y, int width, int height, 11759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offset, int stride, int pixels[]) { 11769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkXYSign(x, y); 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width < 0) { 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("width must be >= 0"); 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (height < 0) { 11819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("height must be >= 0"); 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (x + width > getWidth()) { 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException( 11859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "x + width must be <= bitmap.width()"); 11869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (y + height > getHeight()) { 11889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException( 11899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "y + height must be <= bitmap.height()"); 11909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (Math.abs(stride) < width) { 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("abs(stride) must be >= width"); 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int lastScanline = offset + (height - 1) * stride; 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = pixels.length; 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (offset < 0 || (offset + width > length) 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || lastScanline < 0 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (lastScanline + width > length)) { 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12028cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 12039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12043849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * <p>Write the specified {@link Color} into the bitmap (assuming it is 12053849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * mutable) at the x,y coordinate. The color must be a 12063849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * non-premultiplied ARGB value.</p> 12079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate of the pixel to replace (0...width-1) 12099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate of the pixel to replace (0...height-1) 12103849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * @param color The ARGB color to write into the bitmap 12113849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * 12129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException if the bitmap is not mutable 12139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if x, y are outside of the bitmap's 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bounds. 12159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setPixel(int x, int y, int color) { 12179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't call setPixel() on a recycled bitmap"); 12189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!isMutable()) { 12199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(); 12209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkPixelAccess(x, y); 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeSetPixel(mNativeBitmap, x, y, color); 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12248cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 12259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12263849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * <p>Replace pixels in the bitmap with the colors in the array. Each element 12273849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * in the array is a packed int prepresenting a non-premultiplied ARGB 12283849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * {@link Color}.</p> 12299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pixels The colors to write to the bitmap 12319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset The index of the first color to read from pixels[] 12329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stride The number of colors in pixels[] to skip between rows. 12339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normally this value will be the same as the width of 12349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap, but it can be larger (or negative). 12359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate of the first pixel to write to in 12369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap. 12379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate of the first pixel to write to in 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap. 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The number of colors to copy from pixels[] per row 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The number of rows to write to the bitmap 12413849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * 12429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException if the bitmap is not mutable 12439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if x, y, width, height are outside of 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap's bounds. 12459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws ArrayIndexOutOfBoundsException if the pixels array is too small 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to receive the specified number of pixels. 12479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setPixels(int[] pixels, int offset, int stride, 12493849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy int x, int y, int width, int height) { 12509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't call setPixels() on a recycled bitmap"); 12519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!isMutable()) { 12529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(); 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width == 0 || height == 0) { 12559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; // nothing to do 12569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkPixelsAccess(x, y, width, height, offset, stride, pixels); 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeSetPixels(mNativeBitmap, pixels, offset, stride, 12599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project x, y, width, height); 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12618cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 12629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final Parcelable.Creator<Bitmap> CREATOR 12639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project = new Parcelable.Creator<Bitmap>() { 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Rebuilds a bitmap previously stored with writeToParcel(). 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param p Parcel object to read the bitmap from 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new bitmap created from the data in the parcel 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap createFromParcel(Parcel p) { 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap bm = nativeCreateFromParcel(p); 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bm == null) { 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Failed to unparcel Bitmap"); 12749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bm; 12769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap[] newArray(int size) { 12789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new Bitmap[size]; 12799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 12819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * No special parcel contents. 12849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int describeContents() { 1286b6377170960d40e66858d8b4d335a95eac773762Bart Sears return 0; 12879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write the bitmap and its pixels to the parcel. The bitmap can be 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * rebuilt from the parcel by calling CREATOR.createFromParcel(). 12929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param p Parcel object to write the bitmap data into 12939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void writeToParcel(Parcel p, int flags) { 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't parcel a recycled bitmap"); 1296de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn if (!nativeWriteToParcel(mNativeBitmap, mIsMutable, mDensity, p)) { 12979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("native writeToParcel failed"); 12989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a new bitmap that captures the alpha values of the original. 13039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This may be drawn with Canvas.drawBitmap(), where the color(s) will be 13049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * taken from the paint that is passed to the draw call. 13059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return new bitmap containing the alpha channel of the original bitmap. 13079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap extractAlpha() { 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return extractAlpha(null, null); 13109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13118cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 13129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a new bitmap that captures the alpha values of the original. 13149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * These values may be affected by the optional Paint parameter, which 13159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can contain its own alpha, and may also contain a MaskFilter which 13169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * could change the actual dimensions of the resulting bitmap (e.g. 13179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a blur maskfilter might enlarge the resulting bitmap). If offsetXY 13189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is not null, it returns the amount to offset the returned bitmap so 13199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that it will logically align with the original. For example, if the 13209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * paint contains a blur of radius 2, then offsetXY[] would contains 13219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * -2, -2, so that drawing the alpha bitmap offset by (-2, -2) and then 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawing the original would result in the blur visually aligning with 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the original. 132496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * 132596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>The initial density of the returned bitmap is the same as the original's. 132696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint Optional paint used to modify the alpha values in the 13289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * resulting bitmap. Pass null for default behavior. 13299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offsetXY Optional array that returns the X (index 0) and Y 13309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (index 1) offset needed to position the returned bitmap 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * so that it visually lines up with the original. 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return new bitmap containing the (optionally modified by paint) alpha 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * channel of the original bitmap. This may be drawn with 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Canvas.drawBitmap(), where the color(s) will be taken from the 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * paint that is passed to the draw call. 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap extractAlpha(Paint paint, int[] offsetXY) { 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't extractAlpha on a recycled bitmap"); 13399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativePaint = paint != null ? paint.mNativePaint : 0; 13409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap bm = nativeExtractAlpha(mNativeBitmap, nativePaint, offsetXY); 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bm == null) { 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Failed to extractAlpha on Bitmap"); 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 134496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn bm.mDensity = mDensity; 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bm; 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13488cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen /** 134976d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed * Given another bitmap, return true if it has the same dimensions, config, 135076d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed * and pixel data as this bitmap. If any of those differ, return false. 135176d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed * If other is null, return false. 135276d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed */ 135376d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed public boolean sameAs(Bitmap other) { 1354366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy return this == other || (other != null && nativeSameAs(mNativeBitmap, other.mNativeBitmap)); 135576d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed } 135676d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed 135776d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed /** 13588cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * Rebuilds any caches associated with the bitmap that are used for 13598cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * drawing it. In the case of purgeable bitmaps, this call will attempt to 13608cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * ensure that the pixels have been decoded. 13618cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * If this is called on more than one bitmap in sequence, the priority is 13628cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * given in LRU order (i.e. the last bitmap called will be given highest 13638cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * priority). 13648cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * 13658cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * For bitmaps with no associated caches, this call is effectively a no-op, 13668cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * and therefore is harmless. 13678cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen */ 13688cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen public void prepareToDraw() { 13698cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen nativePrepareToDraw(mNativeBitmap); 13708cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen } 13718cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 1372e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy private static class BitmapFinalizer { 1373e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy private final int mNativeBitmap; 137402890fd0f98b3b8d98baf0bda1ea906afd723d8bRomain Guy 1375e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy BitmapFinalizer(int nativeBitmap) { 1376e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy mNativeBitmap = nativeBitmap; 137702890fd0f98b3b8d98baf0bda1ea906afd723d8bRomain Guy } 137802890fd0f98b3b8d98baf0bda1ea906afd723d8bRomain Guy 137902890fd0f98b3b8d98baf0bda1ea906afd723d8bRomain Guy @Override 1380e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy public void finalize() { 1381366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy try { 1382366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy super.finalize(); 1383366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy } catch (Throwable t) { 1384366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy // Ignore 1385366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy } finally { 1386366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy nativeDestructor(mNativeBitmap); 1387366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy } 13889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13908cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 13919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //////////// native methods 13929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native Bitmap nativeCreate(int[] colors, int offset, 13949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int stride, int width, int height, 13959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativeConfig, boolean mutable); 13969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native Bitmap nativeCopy(int srcBitmap, int nativeConfig, 13979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean isMutable); 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeDestructor(int nativeBitmap); 1399547e66531d521eb1eadac87edb0f79f8c2f1bbe0Chet Haase private static native boolean nativeRecycle(int nativeBitmap); 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean nativeCompress(int nativeBitmap, int format, 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int quality, OutputStream stream, 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte[] tempStorage); 14049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeErase(int nativeBitmap, int color); 14059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int nativeWidth(int nativeBitmap); 14069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int nativeHeight(int nativeBitmap); 14079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int nativeRowBytes(int nativeBitmap); 14089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int nativeConfig(int nativeBitmap); 14098cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 14109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int nativeGetPixel(int nativeBitmap, int x, int y); 14119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeGetPixels(int nativeBitmap, int[] pixels, 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offset, int stride, int x, 14139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int y, int width, int height); 14148cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 14159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeSetPixel(int nativeBitmap, int x, int y, 14169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int color); 14179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeSetPixels(int nativeBitmap, int[] colors, 14189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offset, int stride, int x, 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int y, int width, int height); 14209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeCopyPixelsToBuffer(int nativeBitmap, 14219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Buffer dst); 14229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeCopyPixelsFromBuffer(int nb, Buffer src); 14230bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy private static native int nativeGenerationId(int nativeBitmap); 14249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native Bitmap nativeCreateFromParcel(Parcel p); 14269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // returns true on success 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean nativeWriteToParcel(int nativeBitmap, 14289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean isMutable, 1429de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn int density, 14309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Parcel p); 14319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // returns a new bitmap built from the native bitmap's alpha, and the paint 14329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native Bitmap nativeExtractAlpha(int nativeBitmap, 14339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativePaint, 14349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] offsetXY); 14359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14368cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen private static native void nativePrepareToDraw(int nativeBitmap); 1437713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy private static native boolean nativeHasAlpha(int nativeBitmap); 1438a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed private static native void nativeSetHasAlpha(int nBitmap, boolean hasAlpha); 1439713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy private static native boolean nativeHasMipMap(int nativeBitmap); 1440713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy private static native void nativeSetHasMipMap(int nBitmap, boolean hasMipMap); 144176d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed private static native boolean nativeSameAs(int nb0, int nb1); 1442d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 14439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* package */ final int ni() { 14449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mNativeBitmap; 14459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1447