Bitmap.java revision 91f0a455bb6670b59b8d15cc7a9adb0e6d7f146d
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. 480c20c3898a533b7b76f60827cb6ea02e17c5953dChris Craik * Made public for quick access from drawing methods -- do NOT modify 490c20c3898a533b7b76f60827cb6ea02e17c5953dChris Craik * from outside this class 500c20c3898a533b7b76f60827cb6ea02e17c5953dChris Craik * 510c20c3898a533b7b76f60827cb6ea02e17c5953dChris Craik * @hide 52e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy */ 533b748a44c6bd2ea05fe16839caf73dbe50bd7ae9Romain Guy @SuppressWarnings("UnusedDeclaration") // native code only 540c20c3898a533b7b76f60827cb6ea02e17c5953dChris Craik public byte[] mBuffer; 55e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 562361098da3b9d9c3eeed410dc72ba62c0e9177cfRomain Guy @SuppressWarnings({"FieldCanBeLocal", "UnusedDeclaration"}) // Keep to finalize native resources 57e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy private final BitmapFinalizer mFinalizer; 58e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final boolean mIsMutable; 601abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik 611abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik /** 621abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * Represents whether the Bitmap's content is expected to be pre-multiplied. 631abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * Note that isPremultiplied() does not directly return this value, because 641abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * isPremultiplied() may never return true for a 565 Bitmap. 651abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * 661abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * setPremultiplied() does directly set the value so that setConfig() and 671abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * setPremultiplied() aren't order dependent, despite being setters. 681abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik */ 691abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik private boolean mIsPremultiplied; 705e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private byte[] mNinePatchChunk; // may be null 72ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani private int[] mLayoutBounds; // may be null 731abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik private int mWidth; 741abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik private int mHeight; 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mRecycled; 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn // Package-scoped for fast access. 78dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn int mDensity = getDefaultDensity(); 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn private static volatile Matrix sScaleMatrix; 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn private static volatile int sDefaultDensity = -1; 8302890fd0f98b3b8d98baf0bda1ea906afd723d8bRomain Guy 8496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn /** 8596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * For backwards compatibility, allows the app layer to change the default 8696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * density when running old apps. 8796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @hide 8896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn */ 8996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn public static void setDefaultDensity(int density) { 9096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn sDefaultDensity = density; 9196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn } 923849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy 933849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy static int getDefaultDensity() { 9496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn if (sDefaultDensity >= 0) { 9596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn return sDefaultDensity; 9696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn } 971f58497e7dbab1b16e97c73b65559b852d0c2803Romain Guy //noinspection deprecation 9896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn sDefaultDensity = DisplayMetrics.DENSITY_DEVICE; 9996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn return sDefaultDensity; 10096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn } 101dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1039f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik * Private constructor that must received an already allocated native bitmap 1049f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik * int (pointer). 105ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani */ 1069f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik @SuppressWarnings({"UnusedDeclaration"}) // called from JNI 1071abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik Bitmap(int nativeBitmap, byte[] buffer, int width, int height, int density, 1081abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik boolean isMutable, boolean isPremultiplied, 1091abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik byte[] ninePatchChunk, int[] layoutBounds) { 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (nativeBitmap == 0) { 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("internal error: native bitmap is 0"); 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1138cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 1141abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik mWidth = width; 1151abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik mHeight = height; 1161abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik mIsMutable = isMutable; 1171abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik mIsPremultiplied = isPremultiplied; 118e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy mBuffer = buffer; 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // we delete this in our finalizer 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNativeBitmap = nativeBitmap; 121e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy mFinalizer = new BitmapFinalizer(nativeBitmap); 122e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNinePatchChunk = ninePatchChunk; 124ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani mLayoutBounds = layoutBounds; 125de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn if (density >= 0) { 126de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn mDensity = density; 127de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn } 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1311abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * Native bitmap has been reconfigured, so set premult and cached 1321abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * width/height values 1339f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik */ 1349f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik @SuppressWarnings({"UnusedDeclaration"}) // called from JNI 1351abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik void reinit(int width, int height, boolean isPremultiplied) { 1361abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik mWidth = width; 1371abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik mHeight = height; 1381abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik mIsPremultiplied = isPremultiplied; 1399f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik } 1409f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik 1419f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik /** 14211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Returns the density for this bitmap.</p> 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>The default density is the same density as the current display, 14596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * unless the current application does not support different screen 14696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * densities in which case it is 14796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * {@link android.util.DisplayMetrics#DENSITY_DEFAULT}. Note that 14896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * compatibility mode is determined by the application that was initially 14996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * loaded into a process -- applications that share the same process should 15096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * all have the same compatibility, or ensure they explicitly set the 15196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * density of their bitmaps appropriately.</p> 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * @return A scaling factor of the default density or {@link #DENSITY_NONE} 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if the scaling factor is unknown. 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #setDensity(int) 157a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn * @see android.util.DisplayMetrics#DENSITY_DEFAULT 15811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see android.util.DisplayMetrics#densityDpi 15911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #DENSITY_NONE 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getDensity() { 16211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return mDensity; 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * <p>Specifies the density for this bitmap. When the bitmap is 16711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * drawn to a Canvas that also has a density, it will be scaled 16811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * appropriately.</p> 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @param density The density scaling factor to use with this bitmap or 17111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * {@link #DENSITY_NONE} if the density is unknown. 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #getDensity() 174a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn * @see android.util.DisplayMetrics#DENSITY_DEFAULT 17511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see android.util.DisplayMetrics#densityDpi 17611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @see #DENSITY_NONE 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public void setDensity(int density) { 17911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn mDensity = density; 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 181c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik 182c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik /** 183c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * <p>Modifies the bitmap to have a specified width, height, and {@link 184c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * Config}, without affecting the underlying allocation backing the bitmap. 185c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * Bitmap pixel data is not re-initialized for the new configuration.</p> 186c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * 187c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * <p>This method can be used to avoid allocating a new bitmap, instead 188c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * reusing an existing bitmap's allocation for a new configuration of equal 189c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * or lesser size. If the Bitmap's allocation isn't large enough to support 190c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * the new configuration, an IllegalArgumentException will be thrown and the 191c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * bitmap will not be modified.</p> 192c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * 193c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * <p>The result of {@link #getByteCount()} will reflect the new configuration, 194c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * while {@link #getAllocationByteCount()} will reflect that of the initial 195c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * configuration.</p> 196c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * 197c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * <p>WARNING: This method should NOT be called on a bitmap currently used 198c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * by the view system. It does not make guarantees about how the underlying 199c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * pixel buffer is remapped to the new config, just that the allocation is 200c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * reused. Additionally, the view system does not account for bitmap 201c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * properties being modifying during use, e.g. while attached to 202c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * drawables.</p> 203c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * 204c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * @see #setWidth(int) 205c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * @see #setHeight(int) 206c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * @see #setConfig(Config) 207c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik */ 208c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik public void reconfigure(int width, int height, Config config) { 209c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik checkRecycled("Can't call reconfigure() on a recycled bitmap"); 210c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik if (width <= 0 || height <= 0) { 211c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik throw new IllegalArgumentException("width and height must be > 0"); 212c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik } 213c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik if (!isMutable()) { 2149c2cde0583d02ba7551877dbe7a5ecaee6defb56Chris Craik throw new IllegalStateException("only mutable bitmaps may be reconfigured"); 215c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik } 216c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik if (mBuffer == null) { 2171abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik throw new IllegalStateException("native-backed bitmaps may not be reconfigured"); 218c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik } 219c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik 220c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik nativeReconfigure(mNativeBitmap, width, height, config.nativeInt, mBuffer.length); 221c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik mWidth = width; 222c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik mHeight = height; 223c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik } 224c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik 225c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik /** 226c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * <p>Convenience method for calling {@link #reconfigure(int, int, Config)} 227c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * with the current height and config.</p> 228c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * 229c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * <p>WARNING: this method should not be used on bitmaps currently used by 230c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * the view system, see {@link #reconfigure(int, int, Config)} for more 231c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * details.</p> 232c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * 233c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * @see #reconfigure(int, int, Config) 234c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * @see #setHeight(int) 235c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * @see #setConfig(Config) 236c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik */ 237c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik public void setWidth(int width) { 238c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik reconfigure(width, getHeight(), getConfig()); 239c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik } 240c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik 241c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik /** 242c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * <p>Convenience method for calling {@link #reconfigure(int, int, Config)} 243c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * with the current width and config.</p> 244c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * 245c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * <p>WARNING: this method should not be used on bitmaps currently used by 246c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * the view system, see {@link #reconfigure(int, int, Config)} for more 247c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * details.</p> 248c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * 249c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * @see #reconfigure(int, int, Config) 250c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * @see #setWidth(int) 251c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * @see #setConfig(Config) 252c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik */ 253c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik public void setHeight(int height) { 254c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik reconfigure(getWidth(), height, getConfig()); 255c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik } 256c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik 257c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik /** 258c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * <p>Convenience method for calling {@link #reconfigure(int, int, Config)} 259c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * with the current height and width.</p> 260c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * 261c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * <p>WARNING: this method should not be used on bitmaps currently used by 262c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * the view system, see {@link #reconfigure(int, int, Config)} for more 263c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * details.</p> 264c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * 265c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * @see #reconfigure(int, int, Config) 266c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * @see #setWidth(int) 267c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * @see #setHeight(int) 268c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik */ 269c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik public void setConfig(Config config) { 270c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik reconfigure(getWidth(), getHeight(), config); 271c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik } 272c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the nine patch chunk. 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param chunk The definition of the nine patch 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setNinePatchChunk(byte[] chunk) { 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mNinePatchChunk = chunk; 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2838cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 285ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani * Sets the layout bounds as an array of left, top, right, bottom integers 28617471d730f20ee785c9c48a99eb331a40550612bRomain Guy * @param bounds the array containing the padding values 287ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani * 288ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani * @hide 289ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani */ 290ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani public void setLayoutBounds(int[] bounds) { 291ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani mLayoutBounds = bounds; 292ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani } 293ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani 294ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani /** 295a383b3f646cbc1fd870f2694d4fac24340834916Patrick Dubroy * Free the native object associated with this bitmap, and clear the 296a383b3f646cbc1fd870f2694d4fac24340834916Patrick Dubroy * reference to the pixel data. This will not free the pixel data synchronously; 297a383b3f646cbc1fd870f2694d4fac24340834916Patrick Dubroy * it simply allows it to be garbage collected if there are no other references. 298a383b3f646cbc1fd870f2694d4fac24340834916Patrick Dubroy * The bitmap is marked as "dead", meaning it will throw an exception if 299a383b3f646cbc1fd870f2694d4fac24340834916Patrick Dubroy * getPixels() or setPixels() is called, and will draw nothing. This operation 300a383b3f646cbc1fd870f2694d4fac24340834916Patrick Dubroy * cannot be reversed, so it should only be called if you are sure there are no 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * further uses for the bitmap. This is an advanced call, and normally need 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not be called, since the normal GC process will free up this memory when 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * there are no more references to this bitmap. 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void recycle() { 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!mRecycled) { 307547e66531d521eb1eadac87edb0f79f8c2f1bbe0Chet Haase if (nativeRecycle(mNativeBitmap)) { 308547e66531d521eb1eadac87edb0f79f8c2f1bbe0Chet Haase // return value indicates whether native pixel object was actually recycled. 309547e66531d521eb1eadac87edb0f79f8c2f1bbe0Chet Haase // false indicates that it is still in use at the native level and these 310547e66531d521eb1eadac87edb0f79f8c2f1bbe0Chet Haase // objects should not be collected now. They will be collected later when the 311547e66531d521eb1eadac87edb0f79f8c2f1bbe0Chet Haase // Bitmap itself is collected. 312547e66531d521eb1eadac87edb0f79f8c2f1bbe0Chet Haase mBuffer = null; 313547e66531d521eb1eadac87edb0f79f8c2f1bbe0Chet Haase mNinePatchChunk = null; 314547e66531d521eb1eadac87edb0f79f8c2f1bbe0Chet Haase } 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRecycled = true; 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if this bitmap has been recycled. If so, then it is an error 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to try to access its pixels, and the bitmap will not draw. 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the bitmap has been recycled 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean isRecycled() { 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mRecycled; 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3288cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3300bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy * Returns the generation ID of this bitmap. The generation ID changes 3310bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy * whenever the bitmap is modified. This can be used as an efficient way to 3320bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy * check if a bitmap has changed. 3330bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy * 3340bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy * @return The current generation ID for this bitmap. 3350bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy */ 3360bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy public int getGenerationId() { 3370bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy return nativeGenerationId(mNativeBitmap); 3380bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy } 3390bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy 3400bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy /** 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is called by methods that want to throw an exception if the bitmap 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has already been recycled. 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void checkRecycled(String errorMessage) { 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRecycled) { 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(errorMessage); 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3498cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Common code for checking that x and y are >= 0 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x x coordinate to ensure is >= 0 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y y coordinate to ensure is >= 0 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void checkXYSign(int x, int y) { 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (x < 0) { 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("x must be >= 0"); 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (y < 0) { 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("y must be >= 0"); 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Common code for checking that width and height are > 0 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width width to ensure is > 0 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height height to ensure is > 0 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static void checkWidthHeight(int width, int height) { 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width <= 0) { 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("width must be > 0"); 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (height <= 0) { 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("height must be > 0"); 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 380676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy /** 381676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * Possible bitmap configurations. A bitmap configuration describes 382676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * how pixels are stored. This affects the quality (color depth) as 383676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * well as the ability to display transparent/translucent colors. 384676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy */ 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum Config { 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // these native values must match up with the enum in SkBitmap.h 387676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy 388676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy /** 389676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * Each pixel is stored as a single translucency (alpha) channel. 390676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * This is very useful to efficiently store masks for instance. 391676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * No color information is stored. 392676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * With this configuration, each pixel requires 1 byte of memory. 393676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy */ 3945e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III ALPHA_8 (1), 395676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy 396676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy /** 397676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * Each pixel is stored on 2 bytes and only the RGB channels are 398676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * encoded: red is stored with 5 bits of precision (32 possible 399676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * values), green is stored with 6 bits of precision (64 possible 400676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * values) and blue is stored with 5 bits of precision. 401676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * 402676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * This configuration can produce slight visual artifacts depending 403676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * on the configuration of the source. For instance, without 404676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * dithering, the result might show a greenish tint. To get better 405676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * results dithering should be applied. 406676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * 407676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * This configuration may be useful when using opaque bitmaps 408676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * that do not require high color fidelity. 409676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy */ 4105e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III RGB_565 (3), 411676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy 412676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy /** 413676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * Each pixel is stored on 2 bytes. The three RGB color channels 414676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * and the alpha channel (translucency) are stored with a 4 bits 415676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * precision (16 possible values.) 416676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * 417676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * This configuration is mostly useful if the application needs 418676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * to store translucency information but also needs to save 419676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * memory. 420676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * 421676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * It is recommended to use {@link #ARGB_8888} instead of this 422676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * configuration. 42325ba1c86945a441428194d9ebcabbf31be75a45aRomain Guy * 424e8222dddaf2e3da14380101e818d4254899e0c0dChet Haase * Note: as of {@link android.os.Build.VERSION_CODES#KITKAT}, 42525ba1c86945a441428194d9ebcabbf31be75a45aRomain Guy * any bitmap created with this configuration will be created 42625ba1c86945a441428194d9ebcabbf31be75a45aRomain Guy * using {@link #ARGB_8888} instead. 427676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * 428676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * @deprecated Because of the poor quality of this configuration, 429676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * it is advised to use {@link #ARGB_8888} instead. 430676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy */ 431676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy @Deprecated 4325e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III ARGB_4444 (4), 433676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy 434676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy /** 435676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * Each pixel is stored on 4 bytes. Each channel (RGB and alpha 436676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * for translucency) is stored with 8 bits of precision (256 437676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * possible values.) 438676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * 439676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * This configuration is very flexible and offers the best 440676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy * quality. It should be used whenever possible. 441676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy */ 4425e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III ARGB_8888 (5); 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 444676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy final int nativeInt; 445676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy 446676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy @SuppressWarnings({"deprecation"}) 447676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy private static Config sConfigs[] = { 4485e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III null, ALPHA_8, null, RGB_565, ARGB_4444, ARGB_8888 449676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy }; 450676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Config(int ni) { 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = ni; 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4548cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 455676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy static Config nativeToConfig(int ni) { 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sConfigs[ni]; 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4598cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4613849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * <p>Copy the bitmap's pixels into the specified buffer (allocated by the 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * caller). An exception is thrown if the buffer is not large enough to 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * hold all of the pixels (taking into account the number of bytes per 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pixel) or if the Buffer subclass is not one of the support types 4653849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * (ByteBuffer, ShortBuffer, IntBuffer).</p> 4663849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * <p>The content of the bitmap is copied into the buffer as-is. This means 4673849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * that if this bitmap stores its pixels pre-multiplied 4683849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * (see {@link #isPremultiplied()}, the values in the buffer will also be 4693849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * pre-multiplied.</p> 4701f58497e7dbab1b16e97c73b65559b852d0c2803Romain Guy * <p>After this method returns, the current position of the buffer is 4711f58497e7dbab1b16e97c73b65559b852d0c2803Romain Guy * updated: the position is incremented by the number of elements written 4721f58497e7dbab1b16e97c73b65559b852d0c2803Romain Guy * in the buffer.</p> 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void copyPixelsToBuffer(Buffer dst) { 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int elements = dst.remaining(); 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int shift; 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (dst instanceof ByteBuffer) { 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 0; 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (dst instanceof ShortBuffer) { 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 1; 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (dst instanceof IntBuffer) { 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 2; 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("unsupported Buffer subclass"); 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4868cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project long bufferSize = (long)elements << shift; 488f7f9d9c39df22ad6929f001f07588469f77e8bf5Jesse Wilson long pixelSize = getByteCount(); 4898cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bufferSize < pixelSize) { 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Buffer not large enough for pixels"); 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4938cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeCopyPixelsToBuffer(mNativeBitmap, dst); 4958cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // now update the buffer's position 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int position = dst.position(); 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project position += pixelSize >> shift; 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dst.position(position); 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5033849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * <p>Copy the pixels from the buffer, beginning at the current position, 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * overwriting the bitmap's pixels. The data in the buffer is not changed 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in any way (unlike setPixels(), which converts from unpremultipled 32bit 5063849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * to whatever the bitmap's native format is.</p> 5071f58497e7dbab1b16e97c73b65559b852d0c2803Romain Guy * <p>After this method returns, the current position of the buffer is 5081f58497e7dbab1b16e97c73b65559b852d0c2803Romain Guy * updated: the position is incremented by the number of elements read from 5091f58497e7dbab1b16e97c73b65559b852d0c2803Romain Guy * the buffer. If you need to read the bitmap from the buffer again you must 5101f58497e7dbab1b16e97c73b65559b852d0c2803Romain Guy * first rewind the buffer.</p> 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void copyPixelsFromBuffer(Buffer src) { 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("copyPixelsFromBuffer called on recycled bitmap"); 5148cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int elements = src.remaining(); 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int shift; 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (src instanceof ByteBuffer) { 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 0; 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (src instanceof ShortBuffer) { 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 1; 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (src instanceof IntBuffer) { 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project shift = 2; 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("unsupported Buffer subclass"); 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5268cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 5273849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy long bufferBytes = (long) elements << shift; 528f7f9d9c39df22ad6929f001f07588469f77e8bf5Jesse Wilson long bitmapBytes = getByteCount(); 5298cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bufferBytes < bitmapBytes) { 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Buffer not large enough for pixels"); 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5338cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeCopyPixelsFromBuffer(mNativeBitmap, src); 53555adc145d460be4b21de0d77be1f6076c3591e3cMarco Nelissen 53655adc145d460be4b21de0d77be1f6076c3591e3cMarco Nelissen // now update the buffer's position 53755adc145d460be4b21de0d77be1f6076c3591e3cMarco Nelissen int position = src.position(); 53855adc145d460be4b21de0d77be1f6076c3591e3cMarco Nelissen position += bitmapBytes >> shift; 53955adc145d460be4b21de0d77be1f6076c3591e3cMarco Nelissen src.position(position); 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5418cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tries to make a new bitmap based on the dimensions of this bitmap, 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * setting the new bitmap's config to the one specified, and then copying 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this bitmap's pixels into the new bitmap. If the conversion is not 54696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * supported, or the allocator fails, then this returns NULL. The returned 54796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * bitmap initially has the same density as the original. 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The desired config for the resulting bitmap 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param isMutable True if the resulting bitmap should be mutable (i.e. 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * its pixels can be modified) 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the new bitmap, or null if the copy could not be made. 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap copy(Config config, boolean isMutable) { 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't copy a recycled bitmap"); 55696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn Bitmap b = nativeCopy(mNativeBitmap, config.nativeInt, isMutable); 55796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn if (b != null) { 55891f0a455bb6670b59b8d15cc7a9adb0e6d7f146dJohn Reck b.setAlphaAndPremultiplied(hasAlpha(), mIsPremultiplied); 55996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn b.mDensity = mDensity; 56096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn } 56196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn return b; 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 56402d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick /** 565f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * Creates a new bitmap, scaled from an existing bitmap, when possible. If the 566f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * specified width and height are the same as the current width and height of 5679f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik * the source bitmap, the source bitmap is returned and no new bitmap is 568f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * created. 56902d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick * 57002d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick * @param src The source bitmap. 57102d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick * @param dstWidth The new bitmap's desired width. 57202d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick * @param dstHeight The new bitmap's desired height. 57302d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick * @param filter true if the source should be filtered. 574f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * @return The new scaled bitmap or the source bitmap if no scaling is required. 575790552b240c05d58407f7c14acba656b2e85c523Romain Guy * @throws IllegalArgumentException if width is <= 0, or height is <= 0 57602d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick */ 577f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy public static Bitmap createScaledBitmap(Bitmap src, int dstWidth, int dstHeight, 578f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy boolean filter) { 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Matrix m; 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (Bitmap.class) { 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // small pool of just 1 matrix 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m = sScaleMatrix; 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sScaleMatrix = null; 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (m == null) { 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m = new Matrix(); 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5898cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int width = src.getWidth(); 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int height = src.getHeight(); 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final float sx = dstWidth / (float)width; 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final float sy = dstHeight / (float)height; 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m.setScale(sx, sy); 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap b = Bitmap.createBitmap(src, 0, 0, width, height, m, filter); 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (Bitmap.class) { 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // do we need to check for null? why not just assign everytime? 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (sScaleMatrix == null) { 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sScaleMatrix = m; 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6048cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen return b; 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6068cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns an immutable bitmap from the source bitmap. The new bitmap may 60996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * be the same object as source, or a copy may have been made. It is 61096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * initialized with the same density as the original bitmap. 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(Bitmap src) { 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return createBitmap(src, 0, 0, src.getWidth(), src.getHeight()); 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns an immutable bitmap from the specified subset of the source 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bitmap. The new bitmap may be the same object as source, or a copy may 619f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * have been made. It is initialized with the same density as the original 620f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * bitmap. 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param source The bitmap we are subsetting 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate of the first pixel in source 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate of the first pixel in source 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The number of pixels in each row 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The number of rows 627f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * @return A copy of a subset of the source bitmap or the source bitmap itself. 628790552b240c05d58407f7c14acba656b2e85c523Romain Guy * @throws IllegalArgumentException if the x, y, width, height values are 629790552b240c05d58407f7c14acba656b2e85c523Romain Guy * outside of the dimensions of the source bitmap, or width is <= 0, 630790552b240c05d58407f7c14acba656b2e85c523Romain Guy * or height is <= 0 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(Bitmap source, int x, int y, int width, int height) { 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return createBitmap(source, x, y, width, height, null, false); 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6358cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns an immutable bitmap from subset of the source bitmap, 638f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * transformed by the optional matrix. The new bitmap may be the 639f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * same object as source, or a copy may have been made. It is 64096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * initialized with the same density as the original bitmap. 641f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * 642f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * If the source bitmap is immutable and the requested subset is the 643f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * same as the source bitmap itself, then the source bitmap is 644f12f6f058f169ead83a546a1c3a51e49452a30b3Romain Guy * returned and no new bitmap is created. 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param source The bitmap we are subsetting 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate of the first pixel in source 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate of the first pixel in source 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The number of pixels in each row 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The number of rows 65160b88edea7132ddce90f2dced07c6706f1502270Ken Shirriff * @param m Optional matrix to be applied to the pixels 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param filter true if the source should be filtered. 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Only applies if the matrix contains more than just 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * translation. 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A bitmap that represents the specified subset of source 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if the x, y, width, height values are 657790552b240c05d58407f7c14acba656b2e85c523Romain Guy * outside of the dimensions of the source bitmap, or width is <= 0, 658790552b240c05d58407f7c14acba656b2e85c523Romain Guy * or height is <= 0 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(Bitmap source, int x, int y, int width, int height, 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Matrix m, boolean filter) { 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkXYSign(x, y); 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkWidthHeight(width, height); 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (x + width > source.getWidth()) { 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("x + width must be <= bitmap.width()"); 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (y + height > source.getHeight()) { 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("y + height must be <= bitmap.height()"); 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // check if we can just return our argument unchanged 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!source.isMutable() && x == 0 && y == 0 && width == source.getWidth() && 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project height == source.getHeight() && (m == null || m.isIdentity())) { 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return source; 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6778cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int neww = width; 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int newh = height; 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Canvas canvas = new Canvas(); 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap bitmap; 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Paint paint; 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect srcR = new Rect(x, y, x + width, y + height); 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project RectF dstR = new RectF(0, 0, width, height); 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 687feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy Config newConfig = Config.ARGB_8888; 688feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy final Config config = source.getConfig(); 689feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy // GIF files generate null configs, assume ARGB_8888 690feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy if (config != null) { 691feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy switch (config) { 692feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy case RGB_565: 693feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy newConfig = Config.RGB_565; 694feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy break; 695feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy case ALPHA_8: 696feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy newConfig = Config.ALPHA_8; 697feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy break; 698676b17391fb6583e5df944c36b1bd4c1be835689Romain Guy //noinspection deprecation 699feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy case ARGB_4444: 700feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy case ARGB_8888: 701feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy default: 702feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy newConfig = Config.ARGB_8888; 703feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy break; 704feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy } 705feeea8f07c854e6b0ae2fec3aa2d239c17f32b5bRomain Guy } 706d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (m == null || m.isIdentity()) { 708d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy bitmap = createBitmap(neww, newh, newConfig, source.hasAlpha()); 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint = null; // not needed 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 711d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy final boolean transformed = !m.rectStaysRect(); 712d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project RectF deviceR = new RectF(); 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m.mapRect(deviceR, dstR); 715d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project neww = Math.round(deviceR.width()); 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project newh = Math.round(deviceR.height()); 718d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 719d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy bitmap = createBitmap(neww, newh, transformed ? Config.ARGB_8888 : newConfig, 720d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy transformed || source.hasAlpha()); 721d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project canvas.translate(-deviceR.left, -deviceR.top); 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project canvas.concat(m); 724d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint = new Paint(); 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint.setFilterBitmap(filter); 727d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy if (transformed) { 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project paint.setAntiAlias(true); 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7315e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // The new bitmap was created from a known bitmap source so assume that 73311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn // they use the same density 73411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn bitmap.mDensity = source.mDensity; 73591f0a455bb6670b59b8d15cc7a9adb0e6d7f146dJohn Reck bitmap.setAlphaAndPremultiplied(source.hasAlpha(), source.mIsPremultiplied); 7365e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III 73796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn canvas.setBitmap(bitmap); 73896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn canvas.drawBitmap(source, srcR, dstR, paint); 7396311d0a079702b29984c0d31937345be105e1a5eDianne Hackborn canvas.setBitmap(null); 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bitmap; 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7438cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 74596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * Returns a mutable bitmap with the specified width and height. Its 74696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * initial density is as per {@link #getDensity}. 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The width of the bitmap 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The height of the bitmap 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The bitmap config to create. 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if the width or height are <= 0 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(int width, int height, Config config) { 754d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy return createBitmap(width, height, config, true); 755d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy } 756d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 757d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy /** 758d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * Returns a mutable bitmap with the specified width and height. Its 759dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * initial density is determined from the given {@link DisplayMetrics}. 760dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * 761dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param display Display metrics for the display this bitmap will be 762dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * drawn on. 763dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param width The width of the bitmap 764dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param height The height of the bitmap 765dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param config The bitmap config to create. 766dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @throws IllegalArgumentException if the width or height are <= 0 767dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn */ 768dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn public static Bitmap createBitmap(DisplayMetrics display, int width, 769dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn int height, Config config) { 770dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn return createBitmap(display, width, height, config, true); 771dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn } 772dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn 773dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn /** 774dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * Returns a mutable bitmap with the specified width and height. Its 775d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * initial density is as per {@link #getDensity}. 776d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * 777d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * @param width The width of the bitmap 778d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * @param height The height of the bitmap 779d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * @param config The bitmap config to create. 780d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * @param hasAlpha If the bitmap is ARGB_8888 this flag can be used to mark the 781d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * bitmap as opaque. Doing so will clear the bitmap in black 782d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * instead of transparent. 783d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * 784d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy * @throws IllegalArgumentException if the width or height are <= 0 785d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy */ 786d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy private static Bitmap createBitmap(int width, int height, Config config, boolean hasAlpha) { 787dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn return createBitmap(null, width, height, config, hasAlpha); 788dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn } 789dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn 790dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn /** 791dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * Returns a mutable bitmap with the specified width and height. Its 792dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * initial density is determined from the given {@link DisplayMetrics}. 793dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * 794dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param display Display metrics for the display this bitmap will be 795dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * drawn on. 796dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param width The width of the bitmap 797dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param height The height of the bitmap 798dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param config The bitmap config to create. 799dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param hasAlpha If the bitmap is ARGB_8888 this flag can be used to mark the 800dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * bitmap as opaque. Doing so will clear the bitmap in black 801dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * instead of transparent. 802dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * 803dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @throws IllegalArgumentException if the width or height are <= 0 804dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn */ 805dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn private static Bitmap createBitmap(DisplayMetrics display, int width, int height, 806dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn Config config, boolean hasAlpha) { 807e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy if (width <= 0 || height <= 0) { 808e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy throw new IllegalArgumentException("width and height must be > 0"); 809e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap bm = nativeCreate(null, 0, width, width, height, config.nativeInt, true); 811dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn if (display != null) { 812dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn bm.mDensity = display.densityDpi; 813dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn } 8145e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III bm.setHasAlpha(hasAlpha); 815d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy if (config == Config.ARGB_8888 && !hasAlpha) { 8161373a8eb581fe3c8e9a036e69042015f98a7e346Christopher Tate nativeErase(bm.mNativeBitmap, 0xff000000); 817d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy } 8183b748a44c6bd2ea05fe16839caf73dbe50bd7ae9Romain Guy // No need to initialize the bitmap to zeroes with other configs; 8193b748a44c6bd2ea05fe16839caf73dbe50bd7ae9Romain Guy // it is backed by a VM byte array which is by definition preinitialized 8203b748a44c6bd2ea05fe16839caf73dbe50bd7ae9Romain Guy // to all zeroes. 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bm; 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8238cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a immutable bitmap with the specified width and height, with each 82696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * pixel value set to the corresponding value in the colors array. Its 82796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * initial density is as per {@link #getDensity}. 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors Array of {@link Color} used to initialize the pixels. 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset Number of values to skip before the first color in the 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * array of colors. 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stride Number of colors in the array between rows (must be >= 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * width or <= -width). 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The width of the bitmap 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The height of the bitmap 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The bitmap config to create. If the config does not 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * support per-pixel alpha (e.g. RGB_565), then the alpha 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bytes in the colors[] will be ignored (assumed to be FF) 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if the width or height are <= 0, or if 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the color array's length is less than the number of pixels. 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(int colors[], int offset, int stride, 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int width, int height, Config config) { 844dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn return createBitmap(null, colors, offset, stride, width, height, config); 845dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn } 846dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn 847dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn /** 848dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * Returns a immutable bitmap with the specified width and height, with each 849dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * pixel value set to the corresponding value in the colors array. Its 850dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * initial density is determined from the given {@link DisplayMetrics}. 851dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * 852dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param display Display metrics for the display this bitmap will be 853dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * drawn on. 854dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param colors Array of {@link Color} used to initialize the pixels. 855dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param offset Number of values to skip before the first color in the 856dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * array of colors. 857dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param stride Number of colors in the array between rows (must be >= 858dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * width or <= -width). 859dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param width The width of the bitmap 860dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param height The height of the bitmap 861dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param config The bitmap config to create. If the config does not 862dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * support per-pixel alpha (e.g. RGB_565), then the alpha 863dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * bytes in the colors[] will be ignored (assumed to be FF) 864dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @throws IllegalArgumentException if the width or height are <= 0, or if 865dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * the color array's length is less than the number of pixels. 866dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn */ 867dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn public static Bitmap createBitmap(DisplayMetrics display, int colors[], 868dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn int offset, int stride, int width, int height, Config config) { 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkWidthHeight(width, height); 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (Math.abs(stride) < width) { 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("abs(stride) must be >= width"); 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int lastScanline = offset + (height - 1) * stride; 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = colors.length; 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (offset < 0 || (offset + width > length) || lastScanline < 0 || 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project (lastScanline + width > length)) { 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 880e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy if (width <= 0 || height <= 0) { 881e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy throw new IllegalArgumentException("width and height must be > 0"); 882e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy } 883dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn Bitmap bm = nativeCreate(colors, offset, stride, width, height, 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project config.nativeInt, false); 885dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn if (display != null) { 886dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn bm.mDensity = display.densityDpi; 887dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn } 888dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn return bm; 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a immutable bitmap with the specified width and height, with each 89396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * pixel value set to the corresponding value in the colors array. Its 89496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * initial density is as per {@link #getDensity}. 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param colors Array of {@link Color} used to initialize the pixels. 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This array must be at least as large as width * height. 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The width of the bitmap 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The height of the bitmap 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The bitmap config to create. If the config does not 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * support per-pixel alpha (e.g. RGB_565), then the alpha 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bytes in the colors[] will be ignored (assumed to be FF) 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if the width or height are <= 0, or if 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the color array's length is less than the number of pixels. 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Bitmap createBitmap(int colors[], int width, int height, Config config) { 907dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn return createBitmap(null, colors, 0, width, width, height, config); 908dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn } 909dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn 910dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn /** 911dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * Returns a immutable bitmap with the specified width and height, with each 912dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * pixel value set to the corresponding value in the colors array. Its 913dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * initial density is determined from the given {@link DisplayMetrics}. 914dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * 915dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param display Display metrics for the display this bitmap will be 916dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * drawn on. 917dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param colors Array of {@link Color} used to initialize the pixels. 918dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * This array must be at least as large as width * height. 919dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param width The width of the bitmap 920dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param height The height of the bitmap 921dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @param config The bitmap config to create. If the config does not 922dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * support per-pixel alpha (e.g. RGB_565), then the alpha 923dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * bytes in the colors[] will be ignored (assumed to be FF) 924dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * @throws IllegalArgumentException if the width or height are <= 0, or if 925dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn * the color array's length is less than the number of pixels. 926dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn */ 927dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn public static Bitmap createBitmap(DisplayMetrics display, int colors[], 928dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn int width, int height, Config config) { 929dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn return createBitmap(display, colors, 0, width, width, height, config); 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns an optional array of private data, used by the UI system for 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * some bitmaps. Not intended to be called by applications. 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public byte[] getNinePatchChunk() { 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mNinePatchChunk; 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 941ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani * @hide 942ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani * @return the layout padding [left, right, top, bottom] 943ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani */ 944ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani public int[] getLayoutBounds() { 945ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani return mLayoutBounds; 946ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani } 947ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani 948ec4a50428d5f26a22df3edaf7e5b08f41d5cb54bAmith Yamasani /** 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Specifies the known formats a bitmap can be compressed into 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public enum CompressFormat { 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project JPEG (0), 9532305ac9e4a262ed09fd034ae417e9b1dda4c0ccbVikas Arora PNG (1), 9542305ac9e4a262ed09fd034ae417e9b1dda4c0ccbVikas Arora WEBP (2); 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project CompressFormat(int nativeInt) { 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.nativeInt = nativeInt; 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final int nativeInt; 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Number of bytes of temp storage we use for communicating between the 9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * native compressor and the java OutputStream. 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final static int WORKING_COMPRESS_STORAGE = 4096; 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write a compressed version of the bitmap to the specified outputstream. 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this returns true, the bitmap can be reconstructed by passing a 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * corresponding inputstream to BitmapFactory.decodeStream(). Note: not 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * all Formats support all bitmap configs directly, so it is possible that 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the returned bitmap from BitmapFactory could be in a different bitdepth, 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and/or may have lost per-pixel alpha (e.g. JPEG only supports opaque 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * pixels). 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param format The format of the compressed image 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param quality Hint to the compressor, 0-100. 0 meaning compress for 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * small size, 100 meaning compress for max quality. Some 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * formats, like PNG which is lossless, will ignore the 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * quality setting 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stream The outputstream to write the compressed data. 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if successfully compressed to the specified stream. 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean compress(CompressFormat format, int quality, OutputStream stream) { 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't compress a recycled bitmap"); 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // do explicit check before calling the native method 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (stream == null) { 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new NullPointerException(); 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (quality < 0 || quality > 100) { 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("quality must be 0..100"); 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeCompress(mNativeBitmap, format.nativeInt, quality, 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project stream, new byte[WORKING_COMPRESS_STORAGE]); 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9978cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if the bitmap is marked as mutable (i.e. can be drawn into) 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean isMutable() { 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mIsMutable; 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10053849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy /** 10063849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * <p>Indicates whether pixels stored in this bitmaps are stored pre-multiplied. 10073849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * When a pixel is pre-multiplied, the RGB components have been multiplied by 10083849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * the alpha component. For instance, if the original color is a 50% 10093849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * translucent red <code>(128, 255, 0, 0)</code>, the pre-multiplied form is 10103849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * <code>(128, 128, 0, 0)</code>.</p> 10113849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * 10123849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * <p>This method always returns false if {@link #getConfig()} is 10134ff0cf4b83605bff630c4e6f1fabe4f72a3f93a1Romain Guy * {@link Bitmap.Config#RGB_565}.</p> 10144ff0cf4b83605bff630c4e6f1fabe4f72a3f93a1Romain Guy * 10154ff0cf4b83605bff630c4e6f1fabe4f72a3f93a1Romain Guy * <p>This method only returns true if {@link #hasAlpha()} returns true. 10164ff0cf4b83605bff630c4e6f1fabe4f72a3f93a1Romain Guy * A bitmap with no alpha channel can be used both as a pre-multiplied and 10174ff0cf4b83605bff630c4e6f1fabe4f72a3f93a1Romain Guy * as a non pre-multiplied bitmap.</p> 10181abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * 10191abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * <p>Only pre-multiplied bitmaps may be drawn by the view system or 10201abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * {@link Canvas}. If a non-pre-multiplied bitmap with an alpha channel is 10211abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * drawn to a Canvas, a RuntimeException will be thrown.</p> 10221abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * 10233849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * @return true if the underlying pixels have been pre-multiplied, false 10243849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * otherwise 10251abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * 10261abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * @see Bitmap#setPremultiplied(boolean) 10271abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * @see BitmapFactory.Options#inPremultiplied 10283849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy */ 10293849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy public final boolean isPremultiplied() { 10301abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik return mIsPremultiplied && getConfig() != Config.RGB_565 && hasAlpha(); 10311abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik } 10321abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik 10331abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik /** 10341abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * Sets whether the bitmap should treat its data as pre-multiplied. 10351abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * 10361abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * <p>Bitmaps are always treated as pre-multiplied by the view system and 10371abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * {@link Canvas} for performance reasons. Storing un-pre-multiplied data in 10381abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * a Bitmap (through {@link #setPixel}, {@link #setPixels}, or {@link 10391abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * BitmapFactory.Options#inPremultiplied BitmapFactory.Options.inPremultiplied}) 10401abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * can lead to incorrect blending if drawn by the framework.</p> 10411abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * 10421abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * <p>This method will not affect the behavior of a bitmap without an alpha 10431abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * channel, or if {@link #hasAlpha()} returns false.</p> 10441abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * 104592a3283286df3a6c2a27ecde8eddf23abbb87de9Leon Scroggins III * <p>Calling createBitmap() or createScaledBitmap() with a source 10465e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III * Bitmap whose colors are not pre-multiplied may result in a RuntimeException, 10475e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III * since those functions require drawing the source, which is not supported for 10485e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III * un-pre-multiplied Bitmaps.</p> 10495e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III * 10501abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * @see Bitmap#isPremultiplied() 10511abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik * @see BitmapFactory.Options#inPremultiplied 10521abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik */ 10531abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik public final void setPremultiplied(boolean premultiplied) { 10541abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik mIsPremultiplied = premultiplied; 105591f0a455bb6670b59b8d15cc7a9adb0e6d7f146dJohn Reck nativeSetAlphaAndPremultiplied(mNativeBitmap, hasAlpha(), premultiplied); 10565e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III } 10575e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III 10585e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III /** Helper function to set both alpha and premultiplied. **/ 10595e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III private final void setAlphaAndPremultiplied(boolean hasAlpha, boolean premultiplied) { 10605e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III mIsPremultiplied = premultiplied; 10615e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III nativeSetAlphaAndPremultiplied(mNativeBitmap, hasAlpha, premultiplied); 10623849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy } 10633849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Returns the bitmap's width */ 10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final int getWidth() { 10661abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik return mWidth; 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Returns the bitmap's height */ 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final int getHeight() { 10711abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik return mHeight; 10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10738cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 10749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 107511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * Convenience for calling {@link #getScaledWidth(int)} with the target 107611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * density of the given {@link Canvas}. 10779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10782784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn public int getScaledWidth(Canvas canvas) { 107911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return scaleFromDensity(getWidth(), mDensity, canvas.mDensity); 10802784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn } 10812784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn 10822784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn /** 108311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * Convenience for calling {@link #getScaledHeight(int)} with the target 108411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * density of the given {@link Canvas}. 10852784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn */ 10862784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn public int getScaledHeight(Canvas canvas) { 108711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return scaleFromDensity(getHeight(), mDensity, canvas.mDensity); 108811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn } 108911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 109011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn /** 109111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * Convenience for calling {@link #getScaledWidth(int)} with the target 109211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * density of the given {@link DisplayMetrics}. 109311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn */ 109411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getScaledWidth(DisplayMetrics metrics) { 109511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return scaleFromDensity(getWidth(), mDensity, metrics.densityDpi); 109611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn } 109711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 109811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn /** 109911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * Convenience for calling {@link #getScaledHeight(int)} with the target 110011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * density of the given {@link DisplayMetrics}. 110111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn */ 110211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getScaledHeight(DisplayMetrics metrics) { 110311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return scaleFromDensity(getHeight(), mDensity, metrics.densityDpi); 11042784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn } 11052784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn 11062784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn /** 11072784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn * Convenience method that returns the width of this bitmap divided 11082784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn * by the density scale factor. 11092784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn * 111011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @param targetDensity The density of the target canvas of the bitmap. 11112784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn * @return The scaled width of this bitmap, according to the density scale factor. 11122784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn */ 111311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getScaledWidth(int targetDensity) { 111411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return scaleFromDensity(getWidth(), mDensity, targetDensity); 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Convenience method that returns the height of this bitmap divided 11199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * by the density scale factor. 11209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 112111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @param targetDensity The density of the target canvas of the bitmap. 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The scaled height of this bitmap, according to the density scale factor. 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 112411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn public int getScaledHeight(int targetDensity) { 112511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return scaleFromDensity(getHeight(), mDensity, targetDensity); 112611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn } 112711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 112811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn /** 112911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn * @hide 113011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn */ 113111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn static public int scaleFromDensity(int size, int sdensity, int tdensity) { 11320b68477f8287fe5ddac1beb1c9d0811ded034dadRomain Guy if (sdensity == DENSITY_NONE || tdensity == DENSITY_NONE || sdensity == tdensity) { 113311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn return size; 11342784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn } 113511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 113611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn // Scale by tdensity / sdensity, rounding up. 1137366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy return ((size * tdensity) + (sdensity >> 1)) / sdensity; 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 113911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the number of bytes between rows in the bitmap's pixels. Note that 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this refers to the pixels as stored natively by the bitmap. If you call 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * getPixels() or setPixels(), then the pixels are uniformly treated as 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 32bit values, packed according to the Color class. 11459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1146e8222dddaf2e3da14380101e818d4254899e0c0dChet Haase * <p>As of {@link android.os.Build.VERSION_CODES#KITKAT}, this method 11479f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik * should not be used to calculate the memory usage of the bitmap. Instead, 11489f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik * see {@link #getAllocationByteCount()}. 11499f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik * 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return number of bytes between rows of the native bitmap pixels. 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final int getRowBytes() { 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeRowBytes(mNativeBitmap); 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11558cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11579f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik * Returns the minimum number of bytes that can be used to store this bitmap's pixels. 11589f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik * 1159e8222dddaf2e3da14380101e818d4254899e0c0dChet Haase * <p>As of {@link android.os.Build.VERSION_CODES#KITKAT}, the result of this method can 11609f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik * no longer be used to determine memory usage of a bitmap. See {@link 1161c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * #getAllocationByteCount()}.</p> 1162f7f9d9c39df22ad6929f001f07588469f77e8bf5Jesse Wilson */ 1163f7f9d9c39df22ad6929f001f07588469f77e8bf5Jesse Wilson public final int getByteCount() { 1164f7f9d9c39df22ad6929f001f07588469f77e8bf5Jesse Wilson // int result permits bitmaps up to 46,340 x 46,340 1165f7f9d9c39df22ad6929f001f07588469f77e8bf5Jesse Wilson return getRowBytes() * getHeight(); 1166f7f9d9c39df22ad6929f001f07588469f77e8bf5Jesse Wilson } 1167f7f9d9c39df22ad6929f001f07588469f77e8bf5Jesse Wilson 1168f7f9d9c39df22ad6929f001f07588469f77e8bf5Jesse Wilson /** 11699f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik * Returns the size of the allocated memory used to store this bitmap's pixels. 11709f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik * 11719f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik * <p>This can be larger than the result of {@link #getByteCount()} if a bitmap is reused to 1172c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * decode other bitmaps of smaller size, or by manual reconfiguration. See {@link 1173c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * #reconfigure(int, int, Config)}, {@link #setWidth(int)}, {@link #setHeight(int)}, {@link 1174c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * #setConfig(Bitmap.Config)}, and {@link BitmapFactory.Options#inBitmap 1175c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * BitmapFactory.Options.inBitmap}. If a bitmap is not modified in this way, this value will be 1176c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * the same as that returned by {@link #getByteCount()}.</p> 1177c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * 1178c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * <p>This value will not change over the lifetime of a Bitmap.</p> 11799f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik * 1180c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik * @see #reconfigure(int, int, Config) 11819f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik */ 11829f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik public final int getAllocationByteCount() { 1183222f2ad294c9046b62af5e059f8b409aec044ce9Chris Craik if (mBuffer == null) { 1184222f2ad294c9046b62af5e059f8b409aec044ce9Chris Craik // native backed bitmaps don't support reconfiguration, 1185222f2ad294c9046b62af5e059f8b409aec044ce9Chris Craik // so alloc size is always content size 1186222f2ad294c9046b62af5e059f8b409aec044ce9Chris Craik return getByteCount(); 1187222f2ad294c9046b62af5e059f8b409aec044ce9Chris Craik } 11889f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik return mBuffer.length; 11899f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik } 11909f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik 11919f58361e98be7386a4eadd3aa254e9b7d09d0a3bChris Craik /** 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If the bitmap's internal config is in one of the public formats, return 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that config, otherwise return null. 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final Config getConfig() { 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Config.nativeToConfig(nativeConfig(mNativeBitmap)); 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1199a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed /** Returns true if the bitmap's config supports per-pixel alpha, and 1200a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * if the pixels may contain non-opaque alpha values. For some configs, 1201a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * this is always false (e.g. RGB_565), since they do not support per-pixel 1202a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * alpha. However, for configs that do, the bitmap may be flagged to be 1203a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * known that all of its pixels are opaque. In this case hasAlpha() will 1204a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * also return false. If a config such as ARGB_8888 is not so flagged, 1205a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * it will return true by default. 1206a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed */ 12079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final boolean hasAlpha() { 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return nativeHasAlpha(mNativeBitmap); 12099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1212a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * Tell the bitmap if all of the pixels are known to be opaque (false) 1213a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * or if some of the pixels may contain non-opaque alpha values (true). 1214366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy * Note, for some configs (e.g. RGB_565) this call is ignored, since it 1215366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy * does not support per-pixel alpha values. 1216a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * 1217a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * This is meant as a drawing hint, as in some cases a bitmap that is known 1218a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * to be opaque can take a faster drawing case than one that may have 1219a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed * non-opaque per-pixel alpha values. 1220a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed */ 1221a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed public void setHasAlpha(boolean hasAlpha) { 12225e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III nativeSetAlphaAndPremultiplied(mNativeBitmap, hasAlpha, mIsPremultiplied); 1223a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed } 1224a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed 1225a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed /** 1226713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * Indicates whether the renderer responsible for drawing this 1227713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * bitmap should attempt to use mipmaps when this bitmap is drawn 1228713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * scaled down. 1229713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 1230713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * If you know that you are going to draw this bitmap at less than 1231713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 50% of its original size, you may be able to obtain a higher 1232713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * quality 1233713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 1234713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * This property is only a suggestion that can be ignored by the 1235713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * renderer. It is not guaranteed to have any effect. 1236713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 1237713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * @return true if the renderer should attempt to use mipmaps, 1238713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * false otherwise 1239713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 1240713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * @see #setHasMipMap(boolean) 1241713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy */ 1242713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy public final boolean hasMipMap() { 1243713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy return nativeHasMipMap(mNativeBitmap); 1244713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy } 1245713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy 1246713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy /** 1247713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * Set a hint for the renderer responsible for drawing this bitmap 1248713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * indicating that it should attempt to use mipmaps when this bitmap 1249713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * is drawn scaled down. 1250713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 1251713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * If you know that you are going to draw this bitmap at less than 1252713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 50% of its original size, you may be able to obtain a higher 1253713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * quality by turning this property on. 1254713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 1255713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * Note that if the renderer respects this hint it might have to 1256713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * allocate extra memory to hold the mipmap levels for this bitmap. 1257713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 1258713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * This property is only a suggestion that can be ignored by the 1259713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * renderer. It is not guaranteed to have any effect. 1260713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 1261713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * @param hasMipMap indicates whether the renderer should attempt 1262713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * to use mipmaps 1263713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * 1264713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy * @see #hasMipMap() 1265713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy */ 1266713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy public final void setHasMipMap(boolean hasMipMap) { 1267713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy nativeSetHasMipMap(mNativeBitmap, hasMipMap); 1268713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy } 1269713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy 1270713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy /** 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Fills the bitmap's pixels with the specified {@link Color}. 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException if the bitmap is not mutable. 12749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void eraseColor(int c) { 12769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't erase a recycled bitmap"); 12779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!isMutable()) { 12789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException("cannot erase immutable bitmaps"); 12799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeErase(mNativeBitmap, c); 12819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the {@link Color} at the specified location. Throws an exception 12859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if x or y are out of bounds (negative or >= to the width or height 12863849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * respectively). The returned color is a non-premultiplied ARGB value. 12879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate (0...width-1) of the pixel to return 12899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate (0...height-1) of the pixel to return 12909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The argb {@link Color} at the specified coordinate 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if x, y exceed the bitmap's bounds 12929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getPixel(int x, int y) { 12949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't call getPixel() on a recycled bitmap"); 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkPixelAccess(x, y); 12961abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik return nativeGetPixel(mNativeBitmap, x, y, mIsPremultiplied); 12979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12988cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 12999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns in pixels[] a copy of the data in the bitmap. Each value is 13019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a packed int representing a {@link Color}. The stride parameter allows 13029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the caller to allow for gaps in the returned pixels array between 13039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * rows. For normal packed results, just pass width for the stride value. 13043849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * The returned colors are non-premultiplied ARGB values. 13059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pixels The array to receive the bitmap's colors 13079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset The first index to write into pixels[] 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stride The number of entries in pixels[] to skip between 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * rows (must be >= bitmap's width). Can be negative. 13109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate of the first pixel to read from 13119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap 13129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate of the first pixel to read from 13139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap 13149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The number of pixels to read from each row 13159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The number of rows to read 13163849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * 13179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if x, y, width, height exceed the 13189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bounds of the bitmap, or if abs(stride) < width. 13199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws ArrayIndexOutOfBoundsException if the pixels array is too small 13209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to receive the specified number of pixels. 13219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void getPixels(int[] pixels, int offset, int stride, 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int x, int y, int width, int height) { 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't call getPixels() on a recycled bitmap"); 13259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width == 0 || height == 0) { 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; // nothing to do 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkPixelsAccess(x, y, width, height, offset, stride, pixels); 13299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeGetPixels(mNativeBitmap, pixels, offset, stride, 13301abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik x, y, width, height, mIsPremultiplied); 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13328cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Shared code to check for illegal arguments passed to getPixel() 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or setPixel() 13363849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x x coordinate of the pixel 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y y coordinate of the pixel 13399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void checkPixelAccess(int x, int y) { 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkXYSign(x, y); 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (x >= getWidth()) { 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("x must be < bitmap.width()"); 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (y >= getHeight()) { 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("y must be < bitmap.height()"); 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Shared code to check for illegal arguments passed to getPixels() 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or setPixels() 13539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x left edge of the area of pixels to access 13559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y top edge of the area of pixels to access 13569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width width of the area of pixels to access 13579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height height of the area of pixels to access 13589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset offset into pixels[] array 13599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stride number of elements in pixels[] between each logical row 13609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pixels array to hold the area of pixels being accessed 13619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void checkPixelsAccess(int x, int y, int width, int height, 13639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int offset, int stride, int pixels[]) { 13649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkXYSign(x, y); 13659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width < 0) { 13669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("width must be >= 0"); 13679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (height < 0) { 13699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("height must be >= 0"); 13709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (x + width > getWidth()) { 13729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException( 13739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "x + width must be <= bitmap.width()"); 13749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (y + height > getHeight()) { 13769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException( 13779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "y + height must be <= bitmap.height()"); 13789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (Math.abs(stride) < width) { 13809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalArgumentException("abs(stride) must be >= width"); 13819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int lastScanline = offset + (height - 1) * stride; 13839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int length = pixels.length; 13849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (offset < 0 || (offset + width > length) 13859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || lastScanline < 0 13869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project || (lastScanline + width > length)) { 13879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new ArrayIndexOutOfBoundsException(); 13889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13908cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 13919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13923849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * <p>Write the specified {@link Color} into the bitmap (assuming it is 13933849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * mutable) at the x,y coordinate. The color must be a 13943849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * non-premultiplied ARGB value.</p> 13959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate of the pixel to replace (0...width-1) 13979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate of the pixel to replace (0...height-1) 13983849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * @param color The ARGB color to write into the bitmap 13993849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException if the bitmap is not mutable 14019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if x, y are outside of the bitmap's 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * bounds. 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setPixel(int x, int y, int color) { 14059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't call setPixel() on a recycled bitmap"); 14069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!isMutable()) { 14079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(); 14089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkPixelAccess(x, y); 14101abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik nativeSetPixel(mNativeBitmap, x, y, color, mIsPremultiplied); 14119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14128cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 14139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14143849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * <p>Replace pixels in the bitmap with the colors in the array. Each element 14153849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * in the array is a packed int prepresenting a non-premultiplied ARGB 14163849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * {@link Color}.</p> 14179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pixels The colors to write to the bitmap 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offset The index of the first color to read from pixels[] 14209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param stride The number of colors in pixels[] to skip between rows. 14219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normally this value will be the same as the width of 14229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap, but it can be larger (or negative). 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param x The x coordinate of the first pixel to write to in 14249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap. 14259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param y The y coordinate of the first pixel to write to in 14269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap. 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param width The number of colors to copy from pixels[] per row 14289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param height The number of rows to write to the bitmap 14293849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy * 14309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalStateException if the bitmap is not mutable 14319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws IllegalArgumentException if x, y, width, height are outside of 14329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the bitmap's bounds. 14339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws ArrayIndexOutOfBoundsException if the pixels array is too small 14349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to receive the specified number of pixels. 14359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setPixels(int[] pixels, int offset, int stride, 14373849f93b3c2b29ca3873b602897dccac039a0b98Romain Guy int x, int y, int width, int height) { 14389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't call setPixels() on a recycled bitmap"); 14399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (!isMutable()) { 14409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new IllegalStateException(); 14419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (width == 0 || height == 0) { 14439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return; // nothing to do 14449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkPixelsAccess(x, y, width, height, offset, stride, pixels); 14469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project nativeSetPixels(mNativeBitmap, pixels, offset, stride, 14471abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik x, y, width, height, mIsPremultiplied); 14489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14498cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 14509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final Parcelable.Creator<Bitmap> CREATOR 14519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project = new Parcelable.Creator<Bitmap>() { 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Rebuilds a bitmap previously stored with writeToParcel(). 14549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param p Parcel object to read the bitmap from 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new bitmap created from the data in the parcel 14579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap createFromParcel(Parcel p) { 14599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap bm = nativeCreateFromParcel(p); 14609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bm == null) { 14619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Failed to unparcel Bitmap"); 14629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bm; 14649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap[] newArray(int size) { 14669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new Bitmap[size]; 14679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 14699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * No special parcel contents. 14729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int describeContents() { 1474b6377170960d40e66858d8b4d335a95eac773762Bart Sears return 0; 14759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Write the bitmap and its pixels to the parcel. The bitmap can be 14799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * rebuilt from the parcel by calling CREATOR.createFromParcel(). 14809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param p Parcel object to write the bitmap data into 14819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void writeToParcel(Parcel p, int flags) { 14839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't parcel a recycled bitmap"); 1484de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn if (!nativeWriteToParcel(mNativeBitmap, mIsMutable, mDensity, p)) { 14859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("native writeToParcel failed"); 14869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a new bitmap that captures the alpha values of the original. 14919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This may be drawn with Canvas.drawBitmap(), where the color(s) will be 14929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * taken from the paint that is passed to the draw call. 14939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return new bitmap containing the alpha channel of the original bitmap. 14959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap extractAlpha() { 14979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return extractAlpha(null, null); 14989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14998cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 15009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a new bitmap that captures the alpha values of the original. 15029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * These values may be affected by the optional Paint parameter, which 15039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * can contain its own alpha, and may also contain a MaskFilter which 15049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * could change the actual dimensions of the resulting bitmap (e.g. 15059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a blur maskfilter might enlarge the resulting bitmap). If offsetXY 15069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is not null, it returns the amount to offset the returned bitmap so 15079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that it will logically align with the original. For example, if the 15089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * paint contains a blur of radius 2, then offsetXY[] would contains 15099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * -2, -2, so that drawing the alpha bitmap offset by (-2, -2) and then 15109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * drawing the original would result in the blur visually aligning with 15119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the original. 151296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * 151396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * <p>The initial density of the returned bitmap is the same as the original's. 151496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn * 15159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param paint Optional paint used to modify the alpha values in the 15169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * resulting bitmap. Pass null for default behavior. 15179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param offsetXY Optional array that returns the X (index 0) and Y 15189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (index 1) offset needed to position the returned bitmap 15199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * so that it visually lines up with the original. 15209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return new bitmap containing the (optionally modified by paint) alpha 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * channel of the original bitmap. This may be drawn with 15229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Canvas.drawBitmap(), where the color(s) will be taken from the 15239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * paint that is passed to the draw call. 15249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Bitmap extractAlpha(Paint paint, int[] offsetXY) { 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project checkRecycled("Can't extractAlpha on a recycled bitmap"); 15279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativePaint = paint != null ? paint.mNativePaint : 0; 15289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Bitmap bm = nativeExtractAlpha(mNativeBitmap, nativePaint, offsetXY); 15299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (bm == null) { 15309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("Failed to extractAlpha on Bitmap"); 15319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 153296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn bm.mDensity = mDensity; 15339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return bm; 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15368cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen /** 153776d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed * Given another bitmap, return true if it has the same dimensions, config, 153876d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed * and pixel data as this bitmap. If any of those differ, return false. 153976d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed * If other is null, return false. 154076d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed */ 154176d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed public boolean sameAs(Bitmap other) { 1542366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy return this == other || (other != null && nativeSameAs(mNativeBitmap, other.mNativeBitmap)); 154376d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed } 154476d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed 154576d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed /** 15468cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * Rebuilds any caches associated with the bitmap that are used for 15478cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * drawing it. In the case of purgeable bitmaps, this call will attempt to 15488cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * ensure that the pixels have been decoded. 15498cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * If this is called on more than one bitmap in sequence, the priority is 15508cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * given in LRU order (i.e. the last bitmap called will be given highest 15518cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * priority). 15528cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * 15538cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * For bitmaps with no associated caches, this call is effectively a no-op, 15548cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen * and therefore is harmless. 15558cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen */ 15568cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen public void prepareToDraw() { 15578cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen nativePrepareToDraw(mNativeBitmap); 15588cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen } 15598cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 1560e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy private static class BitmapFinalizer { 1561e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy private final int mNativeBitmap; 156202890fd0f98b3b8d98baf0bda1ea906afd723d8bRomain Guy 1563e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy BitmapFinalizer(int nativeBitmap) { 1564e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy mNativeBitmap = nativeBitmap; 156502890fd0f98b3b8d98baf0bda1ea906afd723d8bRomain Guy } 156602890fd0f98b3b8d98baf0bda1ea906afd723d8bRomain Guy 156702890fd0f98b3b8d98baf0bda1ea906afd723d8bRomain Guy @Override 1568e4ac2d6b5723c95e648c489b187ddde449452c13Patrick Dubroy public void finalize() { 1569366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy try { 1570366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy super.finalize(); 1571366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy } catch (Throwable t) { 1572366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy // Ignore 1573366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy } finally { 1574366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy nativeDestructor(mNativeBitmap); 1575366a84056c9a695ee6702d9d30bf9f3b521ba7ccRomain Guy } 15769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15788cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 15799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //////////// native methods 15809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native Bitmap nativeCreate(int[] colors, int offset, 15829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int stride, int width, int height, 1583c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik int nativeConfig, boolean mutable); 15849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native Bitmap nativeCopy(int srcBitmap, int nativeConfig, 15859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean isMutable); 15869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeDestructor(int nativeBitmap); 1587547e66531d521eb1eadac87edb0f79f8c2f1bbe0Chet Haase private static native boolean nativeRecycle(int nativeBitmap); 1588c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik private static native void nativeReconfigure(int nativeBitmap, int width, int height, 1589c84d203da21c3ae3ded94c79c035d41b27809b3bChris Craik int config, int allocSize); 15909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean nativeCompress(int nativeBitmap, int format, 15929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int quality, OutputStream stream, 15939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte[] tempStorage); 15949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeErase(int nativeBitmap, int color); 15959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int nativeRowBytes(int nativeBitmap); 15969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native int nativeConfig(int nativeBitmap); 15978cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 15981abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik private static native int nativeGetPixel(int nativeBitmap, int x, int y, 15991abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik boolean isPremultiplied); 16009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeGetPixels(int nativeBitmap, int[] pixels, 16011abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik int offset, int stride, int x, int y, 16021abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik int width, int height, boolean isPremultiplied); 16038cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen 16049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeSetPixel(int nativeBitmap, int x, int y, 16051abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik int color, boolean isPremultiplied); 16069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeSetPixels(int nativeBitmap, int[] colors, 16071abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik int offset, int stride, int x, int y, 16081abf5d62429e5a9329520b2f7c2b5a5e7a8e72ecChris Craik int width, int height, boolean isPremultiplied); 16099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeCopyPixelsToBuffer(int nativeBitmap, 16109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Buffer dst); 16119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native void nativeCopyPixelsFromBuffer(int nb, Buffer src); 16120bbae0836426ba2704e38e7f90a9d0ca502ab71dRomain Guy private static native int nativeGenerationId(int nativeBitmap); 16139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native Bitmap nativeCreateFromParcel(Parcel p); 16159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // returns true on success 16169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native boolean nativeWriteToParcel(int nativeBitmap, 16179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean isMutable, 1618de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn int density, 16199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Parcel p); 16209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // returns a new bitmap built from the native bitmap's alpha, and the paint 16219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static native Bitmap nativeExtractAlpha(int nativeBitmap, 16229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int nativePaint, 16239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] offsetXY); 16249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16258cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen private static native void nativePrepareToDraw(int nativeBitmap); 1626713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy private static native boolean nativeHasAlpha(int nativeBitmap); 16275e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III private static native void nativeSetAlphaAndPremultiplied(int nBitmap, boolean hasAlpha, 16285e49b497ae2019586937aae0e8159292363728b5Leon Scroggins III boolean isPremul); 1629713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy private static native boolean nativeHasMipMap(int nativeBitmap); 1630713e1bb9df6bdfc21bd5c40d1a6ecf6c822a4be5Romain Guy private static native void nativeSetHasMipMap(int nBitmap, boolean hasMipMap); 163176d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed private static native boolean nativeSameAs(int nb0, int nb1); 1632d90f23e24a4d1768d5a7ed0e7072e67af6330a45Romain Guy 16339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /* package */ final int ni() { 16349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mNativeBitmap; 16359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1637