net.donky.core.messaging.ui.helpers

Class ImageUtils

java.lang.Object

net.donky.core.messaging.ui.helpers.ImageUtils

public class ImageUtils
extends java.lang.Object

Created by Marcin Swierczek 18/10/15. Copyright (C) Donky Networks Ltd. All rights reserved.

Field Summary

Fields

Modifier and Type	Field and Description
static int	MESSAGE_ERROR
static int	MESSAGE_OK

Constructor Summary

Constructors

Constructor and Description
ImageUtils()

Method Summary

Modifier and Type	Method and Description
static int	calculateInSampleSize(android.graphics.BitmapFactory.Options options, int reqWidth, int reqHeight) Calculate the largest inSampleSize value that is a power of 2 and keeps both height and width larger than the requested height and width.
static android.content.Intent	getImageCaptureIntent(android.content.Context context, java.io.File captureToFile) Create a new Intent for capturing an image.
static android.content.Intent	getImageCropIntent(java.io.File inputCropFile, java.io.File outputCropFile) Create a new Intent for cropping an image.
static android.content.Intent	getImagePickerIntent() Create a new Intent for picking an image.
static int	getOrientation(android.content.ContentResolver contentResolver, android.net.Uri uri)
static int	getPixelsFromDP(android.content.res.Resources resources, float dps) Get the number of pixels scaled for the current density.
static android.graphics.Bitmap	loadImageAtRequiredSize(android.content.ContentResolver contentResolver, android.net.Uri uri, int reqWidth, int reqHeight) Load an image from the given file at a size that will equal or exceed the given bounds.
static android.graphics.Bitmap	loadImageAtRequiredSize(java.io.File imageFile, int reqWidth, int reqHeight) Load an image from the given file at a size that will equal or exceed the given bounds.
static android.graphics.Bitmap	loadImageAtRequiredSize(java.io.File imageFile, int reqWidth, int reqHeight, DonkyListener listener) Load an image from the given file at a size that will equal or exceed the given bounds.
static android.graphics.BitmapFactory.Options	readImageBounds(android.content.ContentResolver contentResolver, android.net.Uri uri) Read the image size from the given file.
static android.graphics.BitmapFactory.Options	readImageBounds(java.io.File file) Read the image size from the given file.
static android.graphics.Bitmap	resizeBitmap(android.graphics.Bitmap b, int maxWidth, int maxHeight, boolean allowLossOfPrecision) Try to resize the given bitmap in memory, keeping it's aspect ratio to the given max dimensions.
static void	resizeBitmap(java.io.File imageFile, int maxWidth, int maxHeight, int jpegQuality) Resize the given bitmap, if it is larger than the given width or height.
static void	resizeBitmapToPNG(java.io.File imageFile, int maxWidth, int maxHeight) Resize the given bitmap, if it is larger than the given width or height.
static void	saveBitmapContent(android.content.ContentResolver contentResolver, android.content.Intent data, java.io.File outputFile, android.os.Handler handler) Save a bitmap picked from the image picker to the given file in a background thread.
static void	saveBitmapContent(android.content.ContentResolver contentResolver, android.net.Uri uri, java.io.File outputFile, android.os.Handler handler) Save a bitmap picked from the image picker to the given file in a background thread.

Methods inherited from class java.lang.Object

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

Field Detail

MESSAGE_OK

public static final int MESSAGE_OK

See Also:

Constant Field Values

MESSAGE_ERROR

public static final int MESSAGE_ERROR

See Also:

Constant Field Values

Constructor Detail

ImageUtils

public ImageUtils()

Method Detail

getImageCaptureIntent

public static android.content.Intent getImageCaptureIntent(android.content.Context context,
                                                           java.io.File captureToFile)

Create a new Intent for capturing an image.

Parameters:

context - The current context.

captureToFile - The file to write the image to.

Returns:

The image pick intent.

getImageCropIntent

public static android.content.Intent getImageCropIntent(java.io.File inputCropFile,
                                                        java.io.File outputCropFile)

Create a new Intent for cropping an image.

Parameters:

inputCropFile - The image file to crop.

outputCropFile - The image file to crop. Need to specify a different output directory

Returns:

The image crop intent.

getImagePickerIntent

public static android.content.Intent getImagePickerIntent()

Create a new Intent for picking an image.

Returns:

The image pick intent.

saveBitmapContent

public static void saveBitmapContent(android.content.ContentResolver contentResolver,
                                     android.content.Intent data,
                                     java.io.File outputFile,
                                     android.os.Handler handler)

Save a bitmap picked from the image picker to the given file in a background thread. The handler will be called when finished with a what of MESSAGE_OK, or will have a what of MESSAGE_ERROR on an error with the obj set to the Exception.

Parameters:

contentResolver - The ContentResolver.

data - The data intent from the Activity.onActivityResult(int, int, Intent).

outputFile - The file to save the image to.

handler - The handler to call back when finished.

See Also:

getImagePickerIntent()

saveBitmapContent

public static void saveBitmapContent(android.content.ContentResolver contentResolver,
                                     android.net.Uri uri,
                                     java.io.File outputFile,
                                     android.os.Handler handler)

Save a bitmap picked from the image picker to the given file in a background thread. The handler will be called when finished with a what of MESSAGE_OK, or will have a what of MESSAGE_ERROR on an error with the obj set to the Exception.

Parameters:

contentResolver - The ContentResolver.

uri - The uri from the data intent from the Activity.onActivityResult(int, int, Intent).

outputFile - The file to save the image to.

handler - The handler to call back when finished.

See Also:

getImagePickerIntent()

getOrientation

public static int getOrientation(android.content.ContentResolver contentResolver,
                                 android.net.Uri uri)

Returns:

The orientation of an image file in the gallery.

loadImageAtRequiredSize

public static android.graphics.Bitmap loadImageAtRequiredSize(java.io.File imageFile,
                                                              int reqWidth,
                                                              int reqHeight)

Load an image from the given file at a size that will equal or exceed the given bounds.

Parameters:

imageFile - The file to load.

reqWidth - The required width.

reqHeight - The required height.

Returns:

The bitmap loaded from the file.

loadImageAtRequiredSize

public static android.graphics.Bitmap loadImageAtRequiredSize(java.io.File imageFile,
                                                              int reqWidth,
                                                              int reqHeight,
                                                              DonkyListener listener)

Load an image from the given file at a size that will equal or exceed the given bounds.

Parameters:

imageFile - The file to load.

reqWidth - The required width.

reqHeight - The required height.

listener - The listener for throwable events

Returns:

The bitmap loaded from the file.

loadImageAtRequiredSize

public static android.graphics.Bitmap loadImageAtRequiredSize(android.content.ContentResolver contentResolver,
                                                              android.net.Uri uri,
                                                              int reqWidth,
                                                              int reqHeight)

Load an image from the given file at a size that will equal or exceed the given bounds.

Parameters:

reqWidth - The required width.

reqHeight - The required height.

Returns:

The bitmap loaded from the file.

resizeBitmap

public static void resizeBitmap(java.io.File imageFile,
                                int maxWidth,
                                int maxHeight,
                                int jpegQuality)
                         throws java.io.FileNotFoundException

Resize the given bitmap, if it is larger than the given width or height. Save at the given quality.

Parameters:

imageFile - The file to resize.

maxWidth - The max width.

maxHeight - The max height.

jpegQuality - The quality to save at.

Throws:

java.io.FileNotFoundException - If the file does not exist, or we cannot decode a bitmap from it.

resizeBitmapToPNG

public static void resizeBitmapToPNG(java.io.File imageFile,
                                     int maxWidth,
                                     int maxHeight)
                              throws java.io.FileNotFoundException

Resize the given bitmap, if it is larger than the given width or height. Save as a PNG.

Parameters:

imageFile - The file to resize.

maxWidth - The max width.

maxHeight - The max height.

Throws:

java.io.FileNotFoundException - If the file does not exist, or we cannot decode a bitmap from it.

readImageBounds

public static android.graphics.BitmapFactory.Options readImageBounds(java.io.File file)

Read the image size from the given file.

Parameters:

file - The file to read.

Returns:

The image options with width, height and mime type.

readImageBounds

public static android.graphics.BitmapFactory.Options readImageBounds(android.content.ContentResolver contentResolver,
                                                                     android.net.Uri uri)

Read the image size from the given file.

Parameters:

uri - The file to read.

Returns:

The image options with width, height and mime type.

calculateInSampleSize

public static int calculateInSampleSize(android.graphics.BitmapFactory.Options options,
                                        int reqWidth,
                                        int reqHeight)

Calculate the largest inSampleSize value that is a power of 2 and keeps both height and width larger than the requested height and width.

Parameters:

options - The bitmap options (to get the actual height and width of the image)

reqWidth - The required width.

reqHeight - The required height.

Returns:

The number of samples to read in.

getPixelsFromDP

public static int getPixelsFromDP(android.content.res.Resources resources,
                                  float dps)

Get the number of pixels scaled for the current density.

Parameters:

resources - The Resources.

dps - Number of pixels in mdpi.

Returns:

The number of pixels in current density.

resizeBitmap

public static android.graphics.Bitmap resizeBitmap(android.graphics.Bitmap b,
                                                   int maxWidth,
                                                   int maxHeight,
                                                   boolean allowLossOfPrecision)

Try to resize the given bitmap in memory, keeping it's aspect ratio to the given max dimensions.

Parameters:

b - The bitmap to scale.

maxWidth - The max width.

maxHeight - The max height.

Returns:

The resized (if required) bitmap.