Merge "Ensure that the decoder is thread-safe." into jb-mr1-dev

public final class BitmapRegionDecoder {

    private int mNativeBitmapRegionDecoder;

    private boolean mRecycled;

    // ensures that the native decoder object exists and that only one decode can

    // occur at a time.

    private final Object mNativeLock = new Object();

    /**

     * Create a BitmapRegionDecoder from the specified byte array.

     *         decoded.

     */

    public Bitmap decodeRegion(Rect rect, BitmapFactory.Options options) {

        synchronized (mNativeLock) {

            checkRecycled("decodeRegion called on recycled region decoder");

            if (rect.right <= 0 || rect.bottom <= 0 || rect.left >= getWidth()

                    || rect.top >= getHeight())

            return nativeDecodeRegion(mNativeBitmapRegionDecoder, rect.left, rect.top,

                    rect.right - rect.left, rect.bottom - rect.top, options);

        }

    }

    /** Returns the original image's width */

    public int getWidth() {

        synchronized (mNativeLock) {

            checkRecycled("getWidth called on recycled region decoder");

            return nativeGetWidth(mNativeBitmapRegionDecoder);

        }

    }

    /** Returns the original image's height */

    public int getHeight() {

        synchronized (mNativeLock) {

            checkRecycled("getHeight called on recycled region decoder");

            return nativeGetHeight(mNativeBitmapRegionDecoder);

        }

    }

    /**

     * Frees up the memory associated with this region decoder, and mark the

     * memory when there are no more references to this region decoder.

     */

    public void recycle() {

        synchronized (mNativeLock) {

            if (!mRecycled) {

                nativeClean(mNativeBitmapRegionDecoder);

                mRecycled = true;

            }

        }

    }

    /**

     * Returns true if this region decoder has been recycled.