Bitmap.java revision 2305ac9e4a262ed09fd034ae417e9b1dda4c0ccb
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/*
29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project
39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project *
49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License");
59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License.
69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at
79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project *
89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project *      http://www.apache.org/licenses/LICENSE-2.0
99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project *
109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software
119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS,
129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and
149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License.
159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */
169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.graphics;
189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Parcel;
208cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chenimport android.os.Parcelable;
212784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackbornimport android.util.DisplayMetrics;
229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
238cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chenimport java.io.OutputStream;
249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.nio.Buffer;
259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.nio.ByteBuffer;
269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.nio.IntBuffer;
278cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chenimport java.nio.ShortBuffer;
289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic final class Bitmap implements Parcelable {
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
389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    // Note:  mNativeBitmap is used by FaceDetector_jni.cpp
399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    // Don't change/rename without updating FaceDetector_jni.cpp
409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private final int mNativeBitmap;
418cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private final boolean mIsMutable;
439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private byte[] mNinePatchChunk;   // may be null
449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private int mWidth = -1;
459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private int mHeight = -1;
469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private boolean mRecycled;
479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
4811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn    // Package-scoped for fast access.
4996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn    /*package*/ int mDensity = sDefaultDensity = getDefaultDensity();
509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
5111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn    private static volatile Matrix sScaleMatrix;
529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
5396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn    private static volatile int sDefaultDensity = -1;
5496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn
5596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn    /**
5696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * For backwards compatibility, allows the app layer to change the default
5796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * density when running old apps.
5896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * @hide
5996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     */
6096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn    public static void setDefaultDensity(int density) {
6196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn        sDefaultDensity = density;
6296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn    }
6396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn
6496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn    /*package*/ static int getDefaultDensity() {
6596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn        if (sDefaultDensity >= 0) {
6696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn            return sDefaultDensity;
6796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn        }
6896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn        sDefaultDensity = DisplayMetrics.DENSITY_DEVICE;
6996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn        return sDefaultDensity;
7096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn    }
7196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn
729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @noinspection UnusedDeclaration
749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /*  Private constructor that must received an already allocated native
769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        bitmap int (pointer).
779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        This can be called from JNI code.
799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    */
80de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn    private Bitmap(int nativeBitmap, boolean isMutable, byte[] ninePatchChunk,
81de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn            int density) {
829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (nativeBitmap == 0) {
839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new RuntimeException("internal error: native bitmap is 0");
849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
858cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        // we delete this in our finalizer
879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        mNativeBitmap = nativeBitmap;
889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        mIsMutable = isMutable;
899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        mNinePatchChunk = ninePatchChunk;
90de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn        if (density >= 0) {
91de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn            mDensity = density;
92de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn        }
939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
9611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * <p>Returns the density for this bitmap.</p>
979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
9896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * <p>The default density is the same density as the current display,
9996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * unless the current application does not support different screen
10096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * densities in which case it is
10196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * {@link android.util.DisplayMetrics#DENSITY_DEFAULT}.  Note that
10296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * compatibility mode is determined by the application that was initially
10396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * loaded into a process -- applications that share the same process should
10496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * all have the same compatibility, or ensure they explicitly set the
10596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * density of their bitmaps appropriately.</p>
1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
10796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * @return A scaling factor of the default density or {@link #DENSITY_NONE}
1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *         if the scaling factor is unknown.
1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
11011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * @see #setDensity(int)
111a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn     * @see android.util.DisplayMetrics#DENSITY_DEFAULT
11211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * @see android.util.DisplayMetrics#densityDpi
11311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * @see #DENSITY_NONE
1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
11511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn    public int getDensity() {
11611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn        return mDensity;
1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
12011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * <p>Specifies the density for this bitmap.  When the bitmap is
12111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * drawn to a Canvas that also has a density, it will be scaled
12211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * appropriately.</p>
1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
12411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * @param density The density scaling factor to use with this bitmap or
12511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     *        {@link #DENSITY_NONE} if the density is unknown.
1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
12711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * @see #getDensity()
128a53b828635fce8b6b2d3e3377d74d72070056623Dianne Hackborn     * @see android.util.DisplayMetrics#DENSITY_DEFAULT
12911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * @see android.util.DisplayMetrics#densityDpi
13011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * @see #DENSITY_NONE
1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
13211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn    public void setDensity(int density) {
13311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn        mDensity = density;
1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
13511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn
1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Sets the nine patch chunk.
1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param chunk The definition of the nine patch
1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @hide
1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public void setNinePatchChunk(byte[] chunk) {
1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        mNinePatchChunk = chunk;
1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
1468cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Free up the memory associated with this bitmap's pixels, and mark the
1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * bitmap as "dead", meaning it will throw an exception if getPixels() or
1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * setPixels() is called, and will draw nothing. This operation cannot be
1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * reversed, so it should only be called if you are sure there are no
1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * further uses for the bitmap. This is an advanced call, and normally need
1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * not be called, since the normal GC process will free up this memory when
1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * there are no more references to this bitmap.
1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public void recycle() {
1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (!mRecycled) {
1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            nativeRecycle(mNativeBitmap);
1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            mNinePatchChunk = null;
1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            mRecycled = true;
1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Returns true if this bitmap has been recycled. If so, then it is an error
1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * to try to access its pixels, and the bitmap will not draw.
1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @return true if the bitmap has been recycled
1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public final boolean isRecycled() {
1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        return mRecycled;
1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
1738cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * This is called by methods that want to throw an exception if the bitmap
1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * has already been recycled.
1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private void checkRecycled(String errorMessage) {
1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (mRecycled) {
1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new IllegalStateException(errorMessage);
1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
1838cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Common code for checking that x and y are >= 0
1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param x x coordinate to ensure is >= 0
1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param y y coordinate to ensure is >= 0
1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static void checkXYSign(int x, int y) {
1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (x < 0) {
1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new IllegalArgumentException("x must be >= 0");
1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (y < 0) {
1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new IllegalArgumentException("y must be >= 0");
1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Common code for checking that width and height are > 0
2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param width  width to ensure is > 0
2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param height height to ensure is > 0
2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static void checkWidthHeight(int width, int height) {
2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (width <= 0) {
2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new IllegalArgumentException("width must be > 0");
2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (height <= 0) {
2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new IllegalArgumentException("height must be > 0");
2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public enum Config {
2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        // these native values must match up with the enum in SkBitmap.h
2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        ALPHA_8     (2),
2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        RGB_565     (4),
2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        ARGB_4444   (5),
2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        ARGB_8888   (6);
2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        Config(int ni) {
2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            this.nativeInt = ni;
2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        final int nativeInt;
2258cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        /* package */ static Config nativeToConfig(int ni) {
2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            return sConfigs[ni];
2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
2298cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        private static Config sConfigs[] = {
2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            null, null, ALPHA_8, null, RGB_565, ARGB_4444, ARGB_8888
2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        };
2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
2348cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Copy the bitmap's pixels into the specified buffer (allocated by the
2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * caller). An exception is thrown if the buffer is not large enough to
2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * hold all of the pixels (taking into account the number of bytes per
2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * pixel) or if the Buffer subclass is not one of the support types
2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * (ByteBuffer, ShortBuffer, IntBuffer).
2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public void copyPixelsToBuffer(Buffer dst) {
2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        int elements = dst.remaining();
2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        int shift;
2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (dst instanceof ByteBuffer) {
2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            shift = 0;
2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        } else if (dst instanceof ShortBuffer) {
2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            shift = 1;
2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        } else if (dst instanceof IntBuffer) {
2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            shift = 2;
2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        } else {
2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new RuntimeException("unsupported Buffer subclass");
2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
2548cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        long bufferSize = (long)elements << shift;
2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        long pixelSize = (long)getRowBytes() * getHeight();
2578cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (bufferSize < pixelSize) {
2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new RuntimeException("Buffer not large enough for pixels");
2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
2618cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        nativeCopyPixelsToBuffer(mNativeBitmap, dst);
2638cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        // now update the buffer's position
2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        int position = dst.position();
2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        position += pixelSize >> shift;
2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        dst.position(position);
2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Copy the pixels from the buffer, beginning at the current position,
2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * overwriting the bitmap's pixels. The data in the buffer is not changed
2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * in any way (unlike setPixels(), which converts from unpremultipled 32bit
2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * to whatever the bitmap's native format is.
2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public void copyPixelsFromBuffer(Buffer src) {
2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        checkRecycled("copyPixelsFromBuffer called on recycled bitmap");
2788cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        int elements = src.remaining();
2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        int shift;
2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (src instanceof ByteBuffer) {
2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            shift = 0;
2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        } else if (src instanceof ShortBuffer) {
2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            shift = 1;
2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        } else if (src instanceof IntBuffer) {
2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            shift = 2;
2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        } else {
2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new RuntimeException("unsupported Buffer subclass");
2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
2908cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        long bufferBytes = (long)elements << shift;
2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        long bitmapBytes = (long)getRowBytes() * getHeight();
2938cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (bufferBytes < bitmapBytes) {
2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new RuntimeException("Buffer not large enough for pixels");
2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
2978cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        nativeCopyPixelsFromBuffer(mNativeBitmap, src);
2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
3008cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Tries to make a new bitmap based on the dimensions of this bitmap,
3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * setting the new bitmap's config to the one specified, and then copying
3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * this bitmap's pixels into the new bitmap. If the conversion is not
30596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * supported, or the allocator fails, then this returns NULL.  The returned
30696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * bitmap initially has the same density as the original.
3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param config    The desired config for the resulting bitmap
3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param isMutable True if the resulting bitmap should be mutable (i.e.
3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                  its pixels can be modified)
3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @return the new bitmap, or null if the copy could not be made.
3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public Bitmap copy(Config config, boolean isMutable) {
3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        checkRecycled("Can't copy a recycled bitmap");
31596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn        Bitmap b = nativeCopy(mNativeBitmap, config.nativeInt, isMutable);
31696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn        if (b != null) {
31796e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn            b.mDensity = mDensity;
31896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn        }
31996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn        return b;
3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
32202d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick    /**
32302d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick     * Creates a new bitmap, scaled from an existing bitmap.
32402d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick     *
32502d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick     * @param src       The source bitmap.
32602d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick     * @param dstWidth  The new bitmap's desired width.
32702d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick     * @param dstHeight The new bitmap's desired height.
32802d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick     * @param filter    true if the source should be filtered.
32902d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick     * @return the new scaled bitmap.
33002d9102b3bdebac6989c2b7d12c080fb7c1f8e2bBrad Fitzpatrick     */
3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public static Bitmap createScaledBitmap(Bitmap src, int dstWidth,
3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            int dstHeight, boolean filter) {
3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        Matrix m;
3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        synchronized (Bitmap.class) {
3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            // small pool of just 1 matrix
3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            m = sScaleMatrix;
3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            sScaleMatrix = null;
3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (m == null) {
3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            m = new Matrix();
3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
3438cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        final int width = src.getWidth();
3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        final int height = src.getHeight();
3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        final float sx = dstWidth  / (float)width;
3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        final float sy = dstHeight / (float)height;
3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        m.setScale(sx, sy);
3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        Bitmap b = Bitmap.createBitmap(src, 0, 0, width, height, m, filter);
3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        synchronized (Bitmap.class) {
3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            // do we need to check for null? why not just assign everytime?
3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            if (sScaleMatrix == null) {
3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                sScaleMatrix = m;
3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            }
3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
3588cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen        return b;
3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
3608cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Returns an immutable bitmap from the source bitmap. The new bitmap may
36396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * be the same object as source, or a copy may have been made.  It is
36496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * initialized with the same density as the original bitmap.
3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public static Bitmap createBitmap(Bitmap src) {
3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        return createBitmap(src, 0, 0, src.getWidth(), src.getHeight());
3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Returns an immutable bitmap from the specified subset of the source
3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * bitmap. The new bitmap may be the same object as source, or a copy may
37396e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * have been made.  It is
37496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * initialized with the same density as the original bitmap.
3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param source   The bitmap we are subsetting
3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param x        The x coordinate of the first pixel in source
3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param y        The y coordinate of the first pixel in source
3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param width    The number of pixels in each row
3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param height   The number of rows
3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public static Bitmap createBitmap(Bitmap source, int x, int y, int width, int height) {
3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        return createBitmap(source, x, y, width, height, null, false);
3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
3858cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Returns an immutable bitmap from subset of the source bitmap,
38896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * transformed by the optional matrix.  It is
38996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * initialized with the same density as the original bitmap.
3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param source   The bitmap we are subsetting
3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param x        The x coordinate of the first pixel in source
3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param y        The y coordinate of the first pixel in source
3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param width    The number of pixels in each row
3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param height   The number of rows
39660b88edea7132ddce90f2dced07c6706f1502270Ken Shirriff     * @param m        Optional matrix to be applied to the pixels
3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param filter   true if the source should be filtered.
3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                   Only applies if the matrix contains more than just
3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                   translation.
4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @return A bitmap that represents the specified subset of source
4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @throws IllegalArgumentException if the x, y, width, height values are
4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *         outside of the dimensions of the source bitmap.
4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public static Bitmap createBitmap(Bitmap source, int x, int y, int width, int height,
4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            Matrix m, boolean filter) {
4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        checkXYSign(x, y);
4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        checkWidthHeight(width, height);
4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (x + width > source.getWidth()) {
4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new IllegalArgumentException("x + width must be <= bitmap.width()");
4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (y + height > source.getHeight()) {
4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new IllegalArgumentException("y + height must be <= bitmap.height()");
4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        // check if we can just return our argument unchanged
4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (!source.isMutable() && x == 0 && y == 0 && width == source.getWidth() &&
4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                height == source.getHeight() && (m == null || m.isIdentity())) {
4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            return source;
4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
4218cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        int neww = width;
4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        int newh = height;
4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        Canvas canvas = new Canvas();
4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        Bitmap bitmap;
4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        Paint paint;
4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        Rect srcR = new Rect(x, y, x + width, y + height);
4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        RectF dstR = new RectF(0, 0, width, height);
4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (m == null || m.isIdentity()) {
4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            bitmap = createBitmap(neww, newh,
4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                    source.hasAlpha() ? Config.ARGB_8888 : Config.RGB_565);
4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            paint = null;   // not needed
4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        } else {
4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            /*  the dst should have alpha if the src does, or if our matrix
4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                doesn't preserve rectness
4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            */
4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            boolean hasAlpha = source.hasAlpha() || !m.rectStaysRect();
4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            RectF deviceR = new RectF();
4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            m.mapRect(deviceR, dstR);
4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            neww = Math.round(deviceR.width());
4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            newh = Math.round(deviceR.height());
4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            bitmap = createBitmap(neww, newh, hasAlpha ? Config.ARGB_8888 : Config.RGB_565);
4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            if (hasAlpha) {
4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                bitmap.eraseColor(0);
4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            }
4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            canvas.translate(-deviceR.left, -deviceR.top);
4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            canvas.concat(m);
4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            paint = new Paint();
4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            paint.setFilterBitmap(filter);
4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            if (!m.rectStaysRect()) {
4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                paint.setAntiAlias(true);
4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            }
4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
45696e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn
4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        // The new bitmap was created from a known bitmap source so assume that
45811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn        // they use the same density
45911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn        bitmap.mDensity = source.mDensity;
46096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn
46196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn        canvas.setBitmap(bitmap);
46296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn        canvas.drawBitmap(source, srcR, dstR, paint);
4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        return bitmap;
4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
4668cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
46896e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * Returns a mutable bitmap with the specified width and height.  Its
46996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * initial density is as per {@link #getDensity}.
4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param width    The width of the bitmap
4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param height   The height of the bitmap
4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param config   The bitmap config to create.
4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @throws IllegalArgumentException if the width or height are <= 0
4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public static Bitmap createBitmap(int width, int height, Config config) {
4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        Bitmap bm = nativeCreate(null, 0, width, width, height, config.nativeInt, true);
4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        bm.eraseColor(0);    // start with black/transparent pixels
4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        return bm;
4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
4818cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Returns a immutable bitmap with the specified width and height, with each
48496e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * pixel value set to the corresponding value in the colors array.  Its
48596e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * initial density is as per {@link #getDensity}.
4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param colors   Array of {@link Color} used to initialize the pixels.
4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param offset   Number of values to skip before the first color in the
4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                 array of colors.
4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param stride   Number of colors in the array between rows (must be >=
4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                 width or <= -width).
4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param width    The width of the bitmap
4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param height   The height of the bitmap
4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param config   The bitmap config to create. If the config does not
4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                 support per-pixel alpha (e.g. RGB_565), then the alpha
4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                 bytes in the colors[] will be ignored (assumed to be FF)
4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @throws IllegalArgumentException if the width or height are <= 0, or if
4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *         the color array's length is less than the number of pixels.
4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public static Bitmap createBitmap(int colors[], int offset, int stride,
5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            int width, int height, Config config) {
5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        checkWidthHeight(width, height);
5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (Math.abs(stride) < width) {
5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new IllegalArgumentException("abs(stride) must be >= width");
5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        int lastScanline = offset + (height - 1) * stride;
5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        int length = colors.length;
5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (offset < 0 || (offset + width > length) || lastScanline < 0 ||
5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                (lastScanline + width > length)) {
5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new ArrayIndexOutOfBoundsException();
5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        return nativeCreate(colors, offset, stride, width, height,
5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                            config.nativeInt, false);
5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Returns a immutable bitmap with the specified width and height, with each
51996e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * pixel value set to the corresponding value in the colors array.  Its
52096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * initial density is as per {@link #getDensity}.
5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param colors   Array of {@link Color} used to initialize the pixels.
5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                 This array must be at least as large as width * height.
5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param width    The width of the bitmap
5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param height   The height of the bitmap
5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param config   The bitmap config to create. If the config does not
5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                 support per-pixel alpha (e.g. RGB_565), then the alpha
5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                 bytes in the colors[] will be ignored (assumed to be FF)
5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @throws IllegalArgumentException if the width or height are <= 0, or if
5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *         the color array's length is less than the number of pixels.
5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public static Bitmap createBitmap(int colors[], int width, int height, Config config) {
5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        return createBitmap(colors, 0, width, width, height, config);
5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Returns an optional array of private data, used by the UI system for
5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * some bitmaps. Not intended to be called by applications.
5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public byte[] getNinePatchChunk() {
5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        return mNinePatchChunk;
5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Specifies the known formats a bitmap can be compressed into
5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public enum CompressFormat {
5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        JPEG    (0),
5492305ac9e4a262ed09fd034ae417e9b1dda4c0ccbVikas Arora        PNG     (1),
5502305ac9e4a262ed09fd034ae417e9b1dda4c0ccbVikas Arora        WEBP    (2);
5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        CompressFormat(int nativeInt) {
5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            this.nativeInt = nativeInt;
5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        final int nativeInt;
5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Number of bytes of temp storage we use for communicating between the
5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * native compressor and the java OutputStream.
5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private final static int WORKING_COMPRESS_STORAGE = 4096;
5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Write a compressed version of the bitmap to the specified outputstream.
5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * If this returns true, the bitmap can be reconstructed by passing a
5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * corresponding inputstream to BitmapFactory.decodeStream(). Note: not
5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * all Formats support all bitmap configs directly, so it is possible that
5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * the returned bitmap from BitmapFactory could be in a different bitdepth,
5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * and/or may have lost per-pixel alpha (e.g. JPEG only supports opaque
5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * pixels).
5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param format   The format of the compressed image
5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param quality  Hint to the compressor, 0-100. 0 meaning compress for
5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                 small size, 100 meaning compress for max quality. Some
5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                 formats, like PNG which is lossless, will ignore the
5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                 quality setting
5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param stream   The outputstream to write the compressed data.
5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @return true if successfully compressed to the specified stream.
5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public boolean compress(CompressFormat format, int quality, OutputStream stream) {
5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        checkRecycled("Can't compress a recycled bitmap");
5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        // do explicit check before calling the native method
5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (stream == null) {
5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new NullPointerException();
5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (quality < 0 || quality > 100) {
5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new IllegalArgumentException("quality must be 0..100");
5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        return nativeCompress(mNativeBitmap, format.nativeInt, quality,
5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                              stream, new byte[WORKING_COMPRESS_STORAGE]);
5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
5938cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Returns true if the bitmap is marked as mutable (i.e. can be drawn into)
5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public final boolean isMutable() {
5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        return mIsMutable;
5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /** Returns the bitmap's width */
6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public final int getWidth() {
6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        return mWidth == -1 ? mWidth = nativeWidth(mNativeBitmap) : mWidth;
6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /** Returns the bitmap's height */
6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public final int getHeight() {
6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        return mHeight == -1 ? mHeight = nativeHeight(mNativeBitmap) : mHeight;
6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
6108cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
61211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * Convenience for calling {@link #getScaledWidth(int)} with the target
61311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * density of the given {@link Canvas}.
6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
6152784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn    public int getScaledWidth(Canvas canvas) {
61611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn        return scaleFromDensity(getWidth(), mDensity, canvas.mDensity);
6172784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn    }
6182784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn
6192784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn    /**
62011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * Convenience for calling {@link #getScaledHeight(int)} with the target
62111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * density of the given {@link Canvas}.
6222784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn     */
6232784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn    public int getScaledHeight(Canvas canvas) {
62411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn        return scaleFromDensity(getHeight(), mDensity, canvas.mDensity);
62511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn    }
62611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn
62711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn    /**
62811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * Convenience for calling {@link #getScaledWidth(int)} with the target
62911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * density of the given {@link DisplayMetrics}.
63011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     */
63111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn    public int getScaledWidth(DisplayMetrics metrics) {
63211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn        return scaleFromDensity(getWidth(), mDensity, metrics.densityDpi);
63311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn    }
63411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn
63511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn    /**
63611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * Convenience for calling {@link #getScaledHeight(int)} with the target
63711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * density of the given {@link DisplayMetrics}.
63811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     */
63911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn    public int getScaledHeight(DisplayMetrics metrics) {
64011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn        return scaleFromDensity(getHeight(), mDensity, metrics.densityDpi);
6412784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn    }
6422784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn
6432784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn    /**
6442784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn     * Convenience method that returns the width of this bitmap divided
6452784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn     * by the density scale factor.
6462784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn     *
64711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * @param targetDensity The density of the target canvas of the bitmap.
6482784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn     * @return The scaled width of this bitmap, according to the density scale factor.
6492784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn     */
65011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn    public int getScaledWidth(int targetDensity) {
65111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn        return scaleFromDensity(getWidth(), mDensity, targetDensity);
6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Convenience method that returns the height of this bitmap divided
6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * by the density scale factor.
6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
65811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * @param targetDensity The density of the target canvas of the bitmap.
6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @return The scaled height of this bitmap, according to the density scale factor.
6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
66111ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn    public int getScaledHeight(int targetDensity) {
66211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn        return scaleFromDensity(getHeight(), mDensity, targetDensity);
66311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn    }
66411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn
66511ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn    /**
66611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     * @hide
66711ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn     */
66811ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn    static public int scaleFromDensity(int size, int sdensity, int tdensity) {
66911ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn        if (sdensity == DENSITY_NONE || sdensity == tdensity) {
67011ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn            return size;
6712784ff0af88128f66ae690b73d48fb7e4a211e68Dianne Hackborn        }
67211ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn
67311ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn        // Scale by tdensity / sdensity, rounding up.
67411ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn        return ( (size * tdensity) + (sdensity >> 1) ) / sdensity;
6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
67611ea33471e1a14a8594f0b2cd012d86340dd3bd8Dianne Hackborn
6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Return the number of bytes between rows in the bitmap's pixels. Note that
6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * this refers to the pixels as stored natively by the bitmap. If you call
6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * getPixels() or setPixels(), then the pixels are uniformly treated as
6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * 32bit values, packed according to the Color class.
6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @return number of bytes between rows of the native bitmap pixels.
6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public final int getRowBytes() {
6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        return nativeRowBytes(mNativeBitmap);
6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
6888cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * If the bitmap's internal config is in one of the public formats, return
6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * that config, otherwise return null.
6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public final Config getConfig() {
6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        return Config.nativeToConfig(nativeConfig(mNativeBitmap));
6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
697a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed    /** Returns true if the bitmap's config supports per-pixel alpha, and
698a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed     * if the pixels may contain non-opaque alpha values. For some configs,
699a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed     * this is always false (e.g. RGB_565), since they do not support per-pixel
700a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed     * alpha. However, for configs that do, the bitmap may be flagged to be
701a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed     * known that all of its pixels are opaque. In this case hasAlpha() will
702a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed     * also return false. If a config such as ARGB_8888 is not so flagged,
703a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed     * it will return true by default.
704a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed     */
7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public final boolean hasAlpha() {
7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        return nativeHasAlpha(mNativeBitmap);
7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
710a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed     * Tell the bitmap if all of the pixels are known to be opaque (false)
711a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed     * or if some of the pixels may contain non-opaque alpha values (true).
712a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed     * Note, for some configs (e.g. RGB_565) this call is ignore, since it does
713a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed     * not support per-pixel alpha values.
714a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed     *
715a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed     * This is meant as a drawing hint, as in some cases a bitmap that is known
716a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed     * to be opaque can take a faster drawing case than one that may have
717a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed     * non-opaque per-pixel alpha values.
718a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed     *
719a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed     * @hide
720a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed     */
721a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed    public void setHasAlpha(boolean hasAlpha) {
722a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed        nativeSetHasAlpha(mNativeBitmap, hasAlpha);
723a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed    }
724a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed
725a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed    /**
7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Fills the bitmap's pixels with the specified {@link Color}.
7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @throws IllegalStateException if the bitmap is not mutable.
7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public void eraseColor(int c) {
7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        checkRecycled("Can't erase a recycled bitmap");
7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (!isMutable()) {
7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new IllegalStateException("cannot erase immutable bitmaps");
7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        nativeErase(mNativeBitmap, c);
7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Returns the {@link Color} at the specified location. Throws an exception
7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * if x or y are out of bounds (negative or >= to the width or height
7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * respectively).
7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param x    The x coordinate (0...width-1) of the pixel to return
7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param y    The y coordinate (0...height-1) of the pixel to return
7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @return     The argb {@link Color} at the specified coordinate
7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @throws IllegalArgumentException if x, y exceed the bitmap's bounds
7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public int getPixel(int x, int y) {
7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        checkRecycled("Can't call getPixel() on a recycled bitmap");
7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        checkPixelAccess(x, y);
7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        return nativeGetPixel(mNativeBitmap, x, y);
7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
7538cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Returns in pixels[] a copy of the data in the bitmap. Each value is
7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * a packed int representing a {@link Color}. The stride parameter allows
7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * the caller to allow for gaps in the returned pixels array between
7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * rows. For normal packed results, just pass width for the stride value.
7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param pixels   The array to receive the bitmap's colors
7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param offset   The first index to write into pixels[]
7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param stride   The number of entries in pixels[] to skip between
7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                 rows (must be >= bitmap's width). Can be negative.
7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param x        The x coordinate of the first pixel to read from
7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                 the bitmap
7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param y        The y coordinate of the first pixel to read from
7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                 the bitmap
7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param width    The number of pixels to read from each row
7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param height   The number of rows to read
7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @throws IllegalArgumentException if x, y, width, height exceed the
7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *         bounds of the bitmap, or if abs(stride) < width.
7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @throws ArrayIndexOutOfBoundsException if the pixels array is too small
7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *         to receive the specified number of pixels.
7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public void getPixels(int[] pixels, int offset, int stride,
7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                          int x, int y, int width, int height) {
7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        checkRecycled("Can't call getPixels() on a recycled bitmap");
7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (width == 0 || height == 0) {
7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            return; // nothing to do
7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        checkPixelsAccess(x, y, width, height, offset, stride, pixels);
7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        nativeGetPixels(mNativeBitmap, pixels, offset, stride,
7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                        x, y, width, height);
7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
7858cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Shared code to check for illegal arguments passed to getPixel()
7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * or setPixel()
7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param x x coordinate of the pixel
7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param y y coordinate of the pixel
7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private void checkPixelAccess(int x, int y) {
7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        checkXYSign(x, y);
7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (x >= getWidth()) {
7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new IllegalArgumentException("x must be < bitmap.width()");
7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (y >= getHeight()) {
7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new IllegalArgumentException("y must be < bitmap.height()");
7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Shared code to check for illegal arguments passed to getPixels()
8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * or setPixels()
8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param x left edge of the area of pixels to access
8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param y top edge of the area of pixels to access
8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param width width of the area of pixels to access
8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param height height of the area of pixels to access
8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param offset offset into pixels[] array
8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param stride number of elements in pixels[] between each logical row
8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param pixels array to hold the area of pixels being accessed
8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    */
8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private void checkPixelsAccess(int x, int y, int width, int height,
8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                                   int offset, int stride, int pixels[]) {
8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        checkXYSign(x, y);
8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (width < 0) {
8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new IllegalArgumentException("width must be >= 0");
8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (height < 0) {
8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new IllegalArgumentException("height must be >= 0");
8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (x + width > getWidth()) {
8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new IllegalArgumentException(
8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                    "x + width must be <= bitmap.width()");
8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (y + height > getHeight()) {
8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new IllegalArgumentException(
8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                    "y + height must be <= bitmap.height()");
8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (Math.abs(stride) < width) {
8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new IllegalArgumentException("abs(stride) must be >= width");
8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        int lastScanline = offset + (height - 1) * stride;
8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        int length = pixels.length;
8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (offset < 0 || (offset + width > length)
8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                || lastScanline < 0
8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                || (lastScanline + width > length)) {
8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new ArrayIndexOutOfBoundsException();
8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
8428cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Write the specified {@link Color} into the bitmap (assuming it is
8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * mutable) at the x,y coordinate.
8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param x     The x coordinate of the pixel to replace (0...width-1)
8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param y     The y coordinate of the pixel to replace (0...height-1)
8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param color The {@link Color} to write into the bitmap
8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @throws IllegalStateException if the bitmap is not mutable
8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @throws IllegalArgumentException if x, y are outside of the bitmap's
8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *         bounds.
8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public void setPixel(int x, int y, int color) {
8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        checkRecycled("Can't call setPixel() on a recycled bitmap");
8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (!isMutable()) {
8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new IllegalStateException();
8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        checkPixelAccess(x, y);
8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        nativeSetPixel(mNativeBitmap, x, y, color);
8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
8628cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Replace pixels in the bitmap with the colors in the array. Each element
8658cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen     * in the array is a packed int prepresenting a {@link Color}
8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param pixels   The colors to write to the bitmap
8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param offset   The index of the first color to read from pixels[]
8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param stride   The number of colors in pixels[] to skip between rows.
8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                 Normally this value will be the same as the width of
8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                 the bitmap, but it can be larger (or negative).
8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param x        The x coordinate of the first pixel to write to in
8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                 the bitmap.
8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param y        The y coordinate of the first pixel to write to in
8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                 the bitmap.
8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param width    The number of colors to copy from pixels[] per row
8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param height   The number of rows to write to the bitmap
8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @throws IllegalStateException if the bitmap is not mutable
8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @throws IllegalArgumentException if x, y, width, height are outside of
8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *         the bitmap's bounds.
8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @throws ArrayIndexOutOfBoundsException if the pixels array is too small
8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *         to receive the specified number of pixels.
8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public void setPixels(int[] pixels, int offset, int stride,
8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                          int x, int y, int width, int height) {
8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        checkRecycled("Can't call setPixels() on a recycled bitmap");
8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (!isMutable()) {
8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new IllegalStateException();
8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (width == 0 || height == 0) {
8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            return; // nothing to do
8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        checkPixelsAccess(x, y, width, height, offset, stride, pixels);
8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        nativeSetPixels(mNativeBitmap, pixels, offset, stride,
8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                        x, y, width, height);
8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
8978cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public static final Parcelable.Creator<Bitmap> CREATOR
8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            = new Parcelable.Creator<Bitmap>() {
9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        /**
9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project         * Rebuilds a bitmap previously stored with writeToParcel().
9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project         *
9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project         * @param p    Parcel object to read the bitmap from
9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project         * @return a new bitmap created from the data in the parcel
9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project         */
9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        public Bitmap createFromParcel(Parcel p) {
9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            Bitmap bm = nativeCreateFromParcel(p);
9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            if (bm == null) {
9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                throw new RuntimeException("Failed to unparcel Bitmap");
9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            }
9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            return bm;
9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        public Bitmap[] newArray(int size) {
9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            return new Bitmap[size];
9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    };
9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * No special parcel contents.
9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public int describeContents() {
9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        return 0;
9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Write the bitmap and its pixels to the parcel. The bitmap can be
9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * rebuilt from the parcel by calling CREATOR.createFromParcel().
9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param p    Parcel object to write the bitmap data into
9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public void writeToParcel(Parcel p, int flags) {
9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        checkRecycled("Can't parcel a recycled bitmap");
932de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn        if (!nativeWriteToParcel(mNativeBitmap, mIsMutable, mDensity, p)) {
9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new RuntimeException("native writeToParcel failed");
9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Returns a new bitmap that captures the alpha values of the original.
9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * This may be drawn with Canvas.drawBitmap(), where the color(s) will be
9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * taken from the paint that is passed to the draw call.
9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *
9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @return new bitmap containing the alpha channel of the original bitmap.
9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public Bitmap extractAlpha() {
9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        return extractAlpha(null, null);
9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
9478cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /**
9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * Returns a new bitmap that captures the alpha values of the original.
9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * These values may be affected by the optional Paint parameter, which
9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * can contain its own alpha, and may also contain a MaskFilter which
9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * could change the actual dimensions of the resulting bitmap (e.g.
9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * a blur maskfilter might enlarge the resulting bitmap). If offsetXY
9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * is not null, it returns the amount to offset the returned bitmap so
9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * that it will logically align with the original. For example, if the
9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * paint contains a blur of radius 2, then offsetXY[] would contains
9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * -2, -2, so that drawing the alpha bitmap offset by (-2, -2) and then
9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * drawing the original would result in the blur visually aligning with
9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * the original.
96096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     *
96196e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     * <p>The initial density of the returned bitmap is the same as the original's.
96296e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn     *
9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param paint Optional paint used to modify the alpha values in the
9649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *              resulting bitmap. Pass null for default behavior.
9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @param offsetXY Optional array that returns the X (index 0) and Y
9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                 (index 1) offset needed to position the returned bitmap
9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *                 so that it visually lines up with the original.
9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     * @return new bitmap containing the (optionally modified by paint) alpha
9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *         channel of the original bitmap. This may be drawn with
9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *         Canvas.drawBitmap(), where the color(s) will be taken from the
9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     *         paint that is passed to the draw call.
9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project     */
9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    public Bitmap extractAlpha(Paint paint, int[] offsetXY) {
9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        checkRecycled("Can't extractAlpha on a recycled bitmap");
9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        int nativePaint = paint != null ? paint.mNativePaint : 0;
9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        Bitmap bm = nativeExtractAlpha(mNativeBitmap, nativePaint, offsetXY);
9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        if (bm == null) {
9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            throw new RuntimeException("Failed to extractAlpha on Bitmap");
9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
98096e240f25a97c10bba863df328ed73a82c34ff61Dianne Hackborn        bm.mDensity = mDensity;
9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        return bm;
9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
9848cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen    /**
98576d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed     *  Given another bitmap, return true if it has the same dimensions, config,
98676d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed     *  and pixel data as this bitmap. If any of those differ, return false.
98776d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed     *  If other is null, return false.
98876d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed     *
98976d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed     * @hide (just needed internally right now)
99076d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed     */
99176d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed    public boolean sameAs(Bitmap other) {
99276d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed        return this == other ||
99376d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed              (other != null &&
99476d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed               nativeSameAs(mNativeBitmap, other.mNativeBitmap));
99576d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed    }
99676d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed
99776d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed    /**
9988cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen     * Rebuilds any caches associated with the bitmap that are used for
9998cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen     * drawing it. In the case of purgeable bitmaps, this call will attempt to
10008cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen     * ensure that the pixels have been decoded.
10018cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen     * If this is called on more than one bitmap in sequence, the priority is
10028cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen     * given in LRU order (i.e. the last bitmap called will be given highest
10038cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen     * priority).
10048cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen     *
10058cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen     * For bitmaps with no associated caches, this call is effectively a no-op,
10068cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen     * and therefore is harmless.
10078cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen     */
10088cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen    public void prepareToDraw() {
10098cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen        nativePrepareToDraw(mNativeBitmap);
10108cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen    }
10118cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
10128cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen    @Override
10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    protected void finalize() throws Throwable {
10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        try {
10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            nativeDestructor(mNativeBitmap);
10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        } finally {
10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project            super.finalize();
10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        }
10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
10208cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    //////////// native methods
10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static native Bitmap nativeCreate(int[] colors, int offset,
10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                                              int stride, int width, int height,
10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                                            int nativeConfig, boolean mutable);
10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static native Bitmap nativeCopy(int srcBitmap, int nativeConfig,
10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                                            boolean isMutable);
10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static native void nativeDestructor(int nativeBitmap);
10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static native void nativeRecycle(int nativeBitmap);
10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static native boolean nativeCompress(int nativeBitmap, int format,
10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                                            int quality, OutputStream stream,
10339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                                            byte[] tempStorage);
10349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static native void nativeErase(int nativeBitmap, int color);
10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static native int nativeWidth(int nativeBitmap);
10369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static native int nativeHeight(int nativeBitmap);
10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static native int nativeRowBytes(int nativeBitmap);
10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static native int nativeConfig(int nativeBitmap);
10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static native boolean nativeHasAlpha(int nativeBitmap);
10408cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static native int nativeGetPixel(int nativeBitmap, int x, int y);
10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static native void nativeGetPixels(int nativeBitmap, int[] pixels,
10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                                               int offset, int stride, int x,
10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                                               int y, int width, int height);
10458cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static native void nativeSetPixel(int nativeBitmap, int x, int y,
10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                                              int color);
10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static native void nativeSetPixels(int nativeBitmap, int[] colors,
10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                                               int offset, int stride, int x,
10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                                               int y, int width, int height);
10519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static native void nativeCopyPixelsToBuffer(int nativeBitmap,
10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                                                        Buffer dst);
10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static native void nativeCopyPixelsFromBuffer(int nb, Buffer src);
10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
10559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static native Bitmap nativeCreateFromParcel(Parcel p);
10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    // returns true on success
10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static native boolean nativeWriteToParcel(int nativeBitmap,
10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                                                      boolean isMutable,
1059de0dfb7b65a02d4dd74c271b558adee0973fc267Dianne Hackborn                                                      int density,
10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                                                      Parcel p);
10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    // returns a new bitmap built from the native bitmap's alpha, and the paint
10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    private static native Bitmap nativeExtractAlpha(int nativeBitmap,
10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                                                    int nativePaint,
10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project                                                    int[] offsetXY);
10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project
10668cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen    private static native void nativePrepareToDraw(int nativeBitmap);
1067a78b0a2d9ebb38b86ed802b3d86de07d0b301262Mike Reed    private static native void nativeSetHasAlpha(int nBitmap, boolean hasAlpha);
106876d1e01d5e65c4631c827831e98ad4e300d99eabMike Reed    private static native boolean nativeSameAs(int nb0, int nb1);
10698cdcb12752b716d0407733fecefcf1d9e926310aWei-Ta Chen
10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    /* package */ final int ni() {
10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project        return mNativeBitmap;
10729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project    }
10739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project}
1074