panda.roid.image

Class Bitmaps

java.lang.Object

panda.roid.image.Bitmaps

public class Bitmaps
extends Object

Collection of utility functions used in this package.

Field Summary

Fields

Modifier and Type	Field and Description
static int	UNCONSTRAINED

Constructor Summary

Constructors

Constructor and Description
Bitmaps()

Method Summary

Methods

Modifier and Type	Method and Description
static int	computeSampleSize(android.graphics.BitmapFactory.Options options, int minSideLength, int maxNumOfPixels) Compute the sample size as a function of minSideLength and maxNumOfPixels.
static android.graphics.Bitmap	makeBitmap(int minSideLength, int maxNumOfPixels, String pathName, android.graphics.BitmapFactory.Options options) Make a bitmap from a given Uri.
static android.graphics.Bitmap	rotate(android.graphics.Bitmap b, int degrees) Rotates the bitmap by the specified degree.
static android.graphics.Bitmap	rotate(android.graphics.Bitmap b, int degrees, android.graphics.Matrix m) Rotates the bitmap by the specified degree.
static android.graphics.Bitmap	transform(android.graphics.Matrix scaler, android.graphics.Bitmap source, int targetWidth, int targetHeight, boolean scaleUp, boolean recycle)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

UNCONSTRAINED

public static final int UNCONSTRAINED

See Also:

Constant Field Values

Constructor Detail

Bitmaps

public Bitmaps()

Method Detail

rotate

public static android.graphics.Bitmap rotate(android.graphics.Bitmap b,
                             int degrees)

Rotates the bitmap by the specified degree. If a new bitmap is created, the original bitmap is recycled.

Parameters:

b - bitmap object

degrees - rotate degrees

Returns:

rotated bitmap

rotate

public static android.graphics.Bitmap rotate(android.graphics.Bitmap b,
                             int degrees,
                             android.graphics.Matrix m)

Rotates the bitmap by the specified degree. If a new bitmap is created, the original bitmap is recycled.

Parameters:

b - bitmap object

degrees - rotate degrees

m - matrix object

Returns:

rotated bitmap

computeSampleSize

public static int computeSampleSize(android.graphics.BitmapFactory.Options options,
                    int minSideLength,
                    int maxNumOfPixels)

Compute the sample size as a function of minSideLength and maxNumOfPixels. minSideLength is used to specify that minimal width or height of a bitmap. maxNumOfPixels is used to specify the maximal size in pixels that is tolerable in terms of memory usage. The function returns a sample size based on the constraints. Both size and minSideLength can be passed in as IImage.UNCONSTRAINED, which indicates no care of the corresponding constraint. The functions prefers returning a sample size that generates a smaller bitmap, unless minSideLength = IImage.UNCONSTRAINED. Also, the function rounds up the sample size to a power of 2 or multiple of 8 because BitmapFactory only honors sample size this way. For example, BitmapFactory downsamples an image by 2 even though the request is 3. So we round up the sample size to avoid OOM.

Parameters:

options - bitmap factory options

minSideLength - minimum side length

maxNumOfPixels - max numbers of pixels

Returns:

size

transform

public static android.graphics.Bitmap transform(android.graphics.Matrix scaler,
                                android.graphics.Bitmap source,
                                int targetWidth,
                                int targetHeight,
                                boolean scaleUp,
                                boolean recycle)

makeBitmap

public static android.graphics.Bitmap makeBitmap(int minSideLength,
                                 int maxNumOfPixels,
                                 String pathName,
                                 android.graphics.BitmapFactory.Options options)

Make a bitmap from a given Uri.

Parameters:

minSideLength - side length

maxNumOfPixels - max number of pixels

pathName - path name

options - bitmap factory options

Returns:

bitmap object