de.mrapp.android.util

Class BitmapUtil

java.lang.Object

de.mrapp.android.util.BitmapUtil

public final class BitmapUtil
extends java.lang.Object

An utility class, which provides static methods, which allow to create and edit bitmaps.

Since:

1.0.0

Method Summary

Modifier and Type	Method and Description
static android.graphics.Bitmap	clipCircle(android.graphics.Bitmap bitmap) Clips the corners of a bitmap in order to transform it into a round shape.
static android.graphics.Bitmap	clipCircle(android.graphics.Bitmap bitmap, int size) Clips the corners of a bitmap in order to transform it into a round shape.
static android.graphics.Bitmap	clipCircle(android.graphics.Bitmap bitmap, int borderWidth, int borderColor) Clips the corners of a bitmap in order to transform it into a round shape.
static android.graphics.Bitmap	clipCircle(android.graphics.Bitmap bitmap, int size, int borderWidth, int borderColor) Clips the corners of a bitmap in order to transform it into a round shape.
static android.graphics.Bitmap	clipSquare(android.graphics.Bitmap bitmap) Clips the long edge of a bitmap, if its width and height are not equal, in order to form it into a square.
static android.graphics.Bitmap	clipSquare(android.graphics.Bitmap bitmap, int size) Clips the long edge of a bitmap, if its width and height are not equal, in order to form it into a square.
static android.graphics.Bitmap	clipSquare(android.graphics.Bitmap bitmap, int borderWidth, int borderColor) Clips the long edge of a bitmap, if its width and height are not equal, in order to transform it into a square.
static android.graphics.Bitmap	clipSquare(android.graphics.Bitmap bitmap, int size, int borderWidth, int borderColor) Clips the long edge of a bitmap, if its width and height are not equal, in order to transform it into a square.
static android.graphics.Bitmap	drawableToBitmap(android.graphics.drawable.Drawable drawable) Creates and returns a bitmap from a specific drawable.
static android.graphics.Bitmap	resize(android.graphics.Bitmap bitmap, int width, int height) Resizes a bitmap to a specific width and height.
static android.graphics.Bitmap	tile(android.graphics.Bitmap bitmap, int width, int height) Creates and returns a bitmap with a specific width and height by tiling another bitmap.
static android.graphics.Bitmap	tint(android.graphics.Bitmap bitmap, int color) Creates and returns a bitmap by overlaying it with a specific color.

Methods inherited from class java.lang.Object

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

Method Detail

clipCircle

public static android.graphics.Bitmap clipCircle(android.graphics.Bitmap bitmap)

Clips the corners of a bitmap in order to transform it into a round shape. Bitmaps, whose width and height are not equal, will be clipped to a square beforehand.

Parameters:

bitmap - The bitmap, which should be clipped, as an instance of the class Bitmap. The bitmap may not be null

Returns:

The clipped bitmap as an instance of the class Bitmap

clipCircle

public static android.graphics.Bitmap clipCircle(android.graphics.Bitmap bitmap,
                                                 int size)

Clips the corners of a bitmap in order to transform it into a round shape. Additionally, the bitmap is resized to a specific size. Bitmaps, whose width and height are not equal, will be clipped to a square beforehand.

Parameters:

bitmap - The bitmap, which should be clipped, as an instance of the class Bitmap. The bitmap may not be null

size - The size, the bitmap should be resized to, as an Integer value in pixels. The size must be at least 1

Returns:

The clipped bitmap as an instance of the class Bitmap

clipCircle

public static android.graphics.Bitmap clipCircle(android.graphics.Bitmap bitmap,
                                                 int borderWidth,
                                                 int borderColor)

Clips the corners of a bitmap in order to transform it into a round shape. Additionally, a border will be added. Bitmaps, whose width and height are not equal, will be clipped to a square beforehand.

Parameters:

bitmap - The bitmap, which should be clipped, as an instance of the class Bitmap. The bitmap may not be null

borderWidth - The width of the border as an Integer value in pixels. The width must be at least 0

borderColor - The color of the border as an Integer value

Returns:

The clipped bitmap as an instance of the class Bitmap

clipCircle

public static android.graphics.Bitmap clipCircle(android.graphics.Bitmap bitmap,
                                                 int size,
                                                 int borderWidth,
                                                 int borderColor)

Clips the corners of a bitmap in order to transform it into a round shape. Additionally, the bitmap is resized to a specific size and a border will be added. Bitmaps, whose width and height are not equal, will be clipped to a square beforehand.

Parameters:

bitmap - The bitmap, which should be clipped, as an instance of the class Bitmap. The bitmap may not be null

size - The size, the bitmap should be resized to, as an Integer value in pixels. The size must be at least 1

borderWidth - The width of the border as an Integer value in pixels. The width must be at least 0

borderColor - The color of the border as an Integer value

Returns:

The clipped bitmap as an instance of the class Bitmap

clipSquare

public static android.graphics.Bitmap clipSquare(android.graphics.Bitmap bitmap)

Clips the long edge of a bitmap, if its width and height are not equal, in order to form it into a square.

Parameters:

bitmap - The bitmap, which should be clipped, as an instance of the class Bitmap. The bitmap may not be null

Returns:

The clipped bitmap as an instance of the class Bitmap

clipSquare

public static android.graphics.Bitmap clipSquare(android.graphics.Bitmap bitmap,
                                                 int size)

Clips the long edge of a bitmap, if its width and height are not equal, in order to form it into a square. Additionally, the bitmap is resized to a specific size.

Parameters:

bitmap - The bitmap, which should be clipped, as an instance of the class Bitmap. The bitmap may not be null

size - The size, the bitmap should be resized to, as an Integer value in pixels. The size must be at least 1

Returns:

The clipped bitmap as an instance of the class Bitmap

clipSquare

public static android.graphics.Bitmap clipSquare(android.graphics.Bitmap bitmap,
                                                 int borderWidth,
                                                 int borderColor)

Clips the long edge of a bitmap, if its width and height are not equal, in order to transform it into a square. Additionally, a border will be added.

Parameters:

bitmap - The bitmap, which should be clipped, as an instance of the class Bitmap. The bitmap may not be null

borderWidth - The width of the border as an Integer value in pixels. The width must be at least 0

borderColor - The color of the border as an Integer value

Returns:

The clipped bitmap as an instance of the class Bitmap

clipSquare

public static android.graphics.Bitmap clipSquare(android.graphics.Bitmap bitmap,
                                                 int size,
                                                 int borderWidth,
                                                 int borderColor)

Clips the long edge of a bitmap, if its width and height are not equal, in order to transform it into a square. Additionally, the bitmap is resized to a specific size and a border will be added.

Parameters:

bitmap - The bitmap, which should be clipped, as an instance of the class Bitmap. The bitmap may not be null

size - The size, the bitmap should be resized to, as an Integer value in pixels. The size must be at least 1

borderWidth - The width of the border as an Integer value in pixels. The width must be at least 0

borderColor - The color of the border as an Integer value

Returns:

The clipped bitmap as an instance of the class Bitmap

resize

public static android.graphics.Bitmap resize(android.graphics.Bitmap bitmap,
                                             int width,
                                             int height)

Resizes a bitmap to a specific width and height. If the ratio between width and height differs from the bitmap's original ratio, the bitmap is stretched.

Parameters:

bitmap - The bitmap, which should be resized, as an instance of the class Bitmap. The bitmap may not be null

width - The width, the bitmap should be resized to, as an Integer value in pixels. The width must be at least 1

height - The height, the bitmap should be resized to, as an Integer value in pixels. The height must be at least 1

Returns:

The resized bitmap as an instance of the class Bitmap

tile

public static android.graphics.Bitmap tile(android.graphics.Bitmap bitmap,
                                           int width,
                                           int height)

Creates and returns a bitmap with a specific width and height by tiling another bitmap.

Parameters:

bitmap - The bitmap, which should be tiled, as an instance of the class Bitmap. The bitmap may not be null

width - The width of the bitmap as an Integer value in pixels. The width must be at least 1

height - The height of the bitmap as an Integer value in pixels. The height must be at least 1

Returns:

The bitmap, which has been created as an instance of the class Bitmap

tint

public static android.graphics.Bitmap tint(android.graphics.Bitmap bitmap,
                                           int color)

Creates and returns a bitmap by overlaying it with a specific color.

Parameters:

bitmap - The bitmap, which should be tinted, as an instance of the class Bitmap. The bitmap may not be null

color - The color, which should be used for tinting, as an Integer value

Returns:

The bitmap, which has been created, as an instance of the class Bitmap

drawableToBitmap

public static android.graphics.Bitmap drawableToBitmap(android.graphics.drawable.Drawable drawable)

Creates and returns a bitmap from a specific drawable.

Parameters:

drawable - The drawable, which should be converted, as an instance of the class Drawable. The drawable may not be null

Returns:

The bitmap, which has been created, as an instance of the class Bitmap