Android APIs
public static class

MediaStore.Images.Thumbnails

extends Object
implements BaseColumns
java.lang.Object
   ↳ android.provider.MediaStore.Images.Thumbnails

Class Overview

This class allows developers to query and get two kinds of thumbnails: MINI_KIND: 512 x 384 thumbnail MICRO_KIND: 96 x 96 thumbnail

Summary

Constants
String DATA The data stream for the thumbnail

Type: DATA STREAM

String DEFAULT_SORT_ORDER The default sort order for this table
int FULL_SCREEN_KIND
String HEIGHT The height of the thumbnail

Type: INTEGER (long)

String IMAGE_ID The original image for the thumbnal

Type: INTEGER (ID from Images table)

String KIND The kind of the thumbnail

Type: INTEGER (One of the values below)

int MICRO_KIND
int MINI_KIND
String THUMB_DATA The blob raw data of thumbnail

Type: DATA STREAM

String WIDTH The width of the thumbnal

Type: INTEGER (long)

[Expand]
Inherited Constants
From interface android.provider.BaseColumns
Fields
public static final Uri EXTERNAL_CONTENT_URI The content:// style URI for the "primary" external storage volume.
public static final Uri INTERNAL_CONTENT_URI The content:// style URI for the internal storage.
Public Constructors
MediaStore.Images.Thumbnails()
Public Methods
static void cancelThumbnailRequest(ContentResolver cr, long origId)
This method cancels the thumbnail request so clients waiting for getThumbnail will be interrupted and return immediately.
static void cancelThumbnailRequest(ContentResolver cr, long origId, long groupId)
This method cancels the thumbnail request so clients waiting for getThumbnail will be interrupted and return immediately.
static Uri getContentUri(String volumeName)
Get the content:// style URI for the image media table on the given volume.
static Bitmap getThumbnail(ContentResolver cr, long origId, long groupId, int kind, BitmapFactory.Options options)
This method checks if the thumbnails of the specified image (origId) has been created.
static Bitmap getThumbnail(ContentResolver cr, long origId, int kind, BitmapFactory.Options options)
This method checks if the thumbnails of the specified image (origId) has been created.
final static Cursor query(ContentResolver cr, Uri uri, String[] projection)
final static Cursor queryMiniThumbnail(ContentResolver cr, long origId, int kind, String[] projection)
final static Cursor queryMiniThumbnails(ContentResolver cr, Uri uri, int kind, String[] projection)
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final String DATA

Added in API level 1

The data stream for the thumbnail

Type: DATA STREAM

Constant Value: "_data"

public static final String DEFAULT_SORT_ORDER

Added in API level 1

The default sort order for this table

Constant Value: "image_id ASC"

public static final int FULL_SCREEN_KIND

Added in API level 1

Constant Value: 2 (0x00000002)

public static final String HEIGHT

Added in API level 1

The height of the thumbnail

Type: INTEGER (long)

Constant Value: "height"

public static final String IMAGE_ID

Added in API level 1

The original image for the thumbnal

Type: INTEGER (ID from Images table)

Constant Value: "image_id"

public static final String KIND

Added in API level 1

The kind of the thumbnail

Type: INTEGER (One of the values below)

Constant Value: "kind"

public static final int MICRO_KIND

Added in API level 1

Constant Value: 3 (0x00000003)

public static final int MINI_KIND

Added in API level 1

Constant Value: 1 (0x00000001)

public static final String THUMB_DATA

Added in API level 5

The blob raw data of thumbnail

Type: DATA STREAM

Constant Value: "thumb_data"

public static final String WIDTH

Added in API level 1

The width of the thumbnal

Type: INTEGER (long)

Constant Value: "width"

Fields

public static final Uri EXTERNAL_CONTENT_URI

Added in API level 1

The content:// style URI for the "primary" external storage volume.

public static final Uri INTERNAL_CONTENT_URI

Added in API level 1

The content:// style URI for the internal storage.

Public Constructors

public MediaStore.Images.Thumbnails ()

Added in API level 1

Public Methods

public static void cancelThumbnailRequest (ContentResolver cr, long origId)

Added in API level 5

This method cancels the thumbnail request so clients waiting for getThumbnail will be interrupted and return immediately. Only the original process which made the getThumbnail requests can cancel their own requests.

Parameters
cr ContentResolver
origId original image id

public static void cancelThumbnailRequest (ContentResolver cr, long origId, long groupId)

Added in API level 8

This method cancels the thumbnail request so clients waiting for getThumbnail will be interrupted and return immediately. Only the original process which made the getThumbnail requests can cancel their own requests.

Parameters
cr ContentResolver
origId original image id
groupId the same groupId used in getThumbnail.

public static Uri getContentUri (String volumeName)

Added in API level 1

Get the content:// style URI for the image media table on the given volume.

Parameters
volumeName the name of the volume to get the URI for
Returns
Uri the URI to the image media table on the given volume

public static Bitmap getThumbnail (ContentResolver cr, long origId, long groupId, int kind, BitmapFactory.Options options)

Added in API level 8

This method checks if the thumbnails of the specified image (origId) has been created. It will be blocked until the thumbnails are generated.

Parameters
cr ContentResolver used to dispatch queries to MediaProvider.
origId Original image id associated with thumbnail of interest.
groupId the id of group to which this request belongs
kind The type of thumbnail to fetch. Should be either MINI_KIND or MICRO_KIND.
options this is only used for MINI_KIND when decoding the Bitmap
Returns
Bitmap A Bitmap instance. It could be null if the original image associated with origId doesn't exist or memory is not enough.

public static Bitmap getThumbnail (ContentResolver cr, long origId, int kind, BitmapFactory.Options options)

Added in API level 5

This method checks if the thumbnails of the specified image (origId) has been created. It will be blocked until the thumbnails are generated.

Parameters
cr ContentResolver used to dispatch queries to MediaProvider.
origId Original image id associated with thumbnail of interest.
kind The type of thumbnail to fetch. Should be either MINI_KIND or MICRO_KIND.
options this is only used for MINI_KIND when decoding the Bitmap
Returns
Bitmap A Bitmap instance. It could be null if the original image associated with origId doesn't exist or memory is not enough.

public static final Cursor query (ContentResolver cr, Uri uri, String[] projection)

Added in API level 1

Parameters
cr
uri
projection
Returns
Cursor

public static final Cursor queryMiniThumbnail (ContentResolver cr, long origId, int kind, String[] projection)

Added in API level 1

Parameters
cr
origId
kind
projection
Returns
Cursor

public static final Cursor queryMiniThumbnails (ContentResolver cr, Uri uri, int kind, String[] projection)

Added in API level 1

Parameters
cr
uri
kind
projection
Returns
Cursor