Added in API level 1
Deprecated in API level 29

MediaStore.Images.Thumbnails

Kotlin |Java

public static class MediaStore.Images.Thumbnails
extends Object implements BaseColumns

java.lang.Object
↳	android.provider.MediaStore.Images.Thumbnails

This class was deprecated in API level 29.
Callers should migrate to using ContentResolver.loadThumbnail, since it offers richer control over requested thumbnail sizes and cancellation behavior.

This class provides utility methods to obtain thumbnails for various Images items.

Summary

Constants
`String`	`DATA` Path to the thumbnail file on disk.
`String`	`DEFAULT_SORT_ORDER` The default sort order for this table
`int`	`FULL_SCREEN_KIND`
`String`	`HEIGHT` The height of the thumbnail This constant represents a column name that can be used with a `ContentProvider` through a `ContentValues` or `Cursor` object.
`String`	`IMAGE_ID` The original image for the thumbnal This constant represents a column name that can be used with a `ContentProvider` through a `ContentValues` or `Cursor` object.
`String`	`KIND` The kind of the thumbnail This constant represents a column name that can be used with a `ContentProvider` through a `ContentValues` or `Cursor` object.
`int`	`MICRO_KIND`
`int`	`MINI_KIND`
`String`	`THUMB_DATA` This constant was deprecated in API level 29. this column never existed internally, and could never have returned valid data.
`String`	`WIDTH` The width of the thumbnal This constant represents a column name that can be used with a `ContentProvider` through a `ContentValues` or `Cursor` object.

Inherited constants

From interface android.provider.BaseColumns

`String`	`_COUNT` The count of rows in a directory.
`String`	`_ID` The unique ID for a row.

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
`Thumbnails()`

Public methods
`static void`	`cancelThumbnailRequest(ContentResolver cr, long origId)` This method was deprecated in API level 29. Callers should migrate to using `ContentResolver.loadThumbnail`, since it offers richer control over requested thumbnail sizes and cancellation behavior.
`static void`	`cancelThumbnailRequest(ContentResolver cr, long origId, long groupId)` This method was deprecated in API level 29. Callers should migrate to using `ContentResolver.loadThumbnail`, since it offers richer control over requested thumbnail sizes and cancellation behavior.
`static Uri`	`getContentUri(String volumeName)` Get the content:// style URI for the image media table on the given volume.
`static Size`	`getKindSize(int kind)` This method was deprecated in API level 29. Callers should migrate to using `ContentResolver.loadThumbnail`, since it offers richer control over requested thumbnail sizes and cancellation behavior.
`static Bitmap`	`getThumbnail(ContentResolver cr, long imageId, long groupId, int kind, BitmapFactory.Options options)` This method was deprecated in API level 29. Callers should migrate to using `ContentResolver.loadThumbnail`, since it offers richer control over requested thumbnail sizes and cancellation behavior.
`static Bitmap`	`getThumbnail(ContentResolver cr, long imageId, int kind, BitmapFactory.Options options)` This method was deprecated in API level 29. Callers should migrate to using `ContentResolver.loadThumbnail`, since it offers richer control over requested thumbnail sizes and cancellation behavior.
`static final Cursor`	`query(ContentResolver cr, Uri uri, String[] projection)` This method is deprecated. all queries should be performed through `ContentResolver` directly, which offers modern features like `CancellationSignal`.
`static final Cursor`	`queryMiniThumbnail(ContentResolver cr, long origId, int kind, String[] projection)` This method is deprecated. all queries should be performed through `ContentResolver` directly, which offers modern features like `CancellationSignal`.
`static final Cursor`	`queryMiniThumbnails(ContentResolver cr, Uri uri, int kind, String[] projection)` This method is deprecated. all queries should be performed through `ContentResolver` directly, which offers modern features like `CancellationSignal`.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Constants

DATA

Added in API level 1

public static final String DATA

Path to the thumbnail file on disk. As of Build.VERSION_CODES.Q, this thumbnail has correct rotation, don't need to rotate it again.
This constant represents a column name that can be used with a ContentProvider through a ContentValues or Cursor object. The values stored in this column are Cursor#FIELD_TYPE_STRING .

Constant Value: "_data"

DEFAULT_SORT_ORDER

Added in API level 1

public static final String DEFAULT_SORT_ORDER

The default sort order for this table

Constant Value: "image_id ASC"

FULL_SCREEN_KIND

Added in API level 1

public static final int FULL_SCREEN_KIND

Constant Value: 2 (0x00000002)

HEIGHT

Added in API level 1

public static final String HEIGHT

The height of the thumbnail
This constant represents a column name that can be used with a ContentProvider through a ContentValues or Cursor object. The values stored in this column are Cursor#FIELD_TYPE_INTEGER , and are read-only and cannot be mutated.

Constant Value: "height"

IMAGE_ID

Added in API level 1

public static final String IMAGE_ID

The original image for the thumbnal
This constant represents a column name that can be used with a ContentProvider through a ContentValues or Cursor object. The values stored in this column are Cursor#FIELD_TYPE_INTEGER .

Constant Value: "image_id"

KIND

Added in API level 1

public static final String KIND

The kind of the thumbnail
This constant represents a column name that can be used with a ContentProvider through a ContentValues or Cursor object. The values stored in this column are Cursor#FIELD_TYPE_INTEGER .

Constant Value: "kind"

MICRO_KIND

Added in API level 1

public static final int MICRO_KIND

Constant Value: 3 (0x00000003)

MINI_KIND

Added in API level 1

public static final int MINI_KIND

Constant Value: 1 (0x00000001)

THUMB_DATA

Added in API level 5
Deprecated in API level 29

public static final String THUMB_DATA

This constant was deprecated in API level 29.
this column never existed internally, and could never have returned valid data.

The blob raw data of thumbnail
This constant represents a column name that can be used with a ContentProvider through a ContentValues or Cursor object. The values stored in this column are Cursor#FIELD_TYPE_BLOB .

Constant Value: "thumb_data"

WIDTH

Added in API level 1

public static final String WIDTH

The width of the thumbnal
This constant represents a column name that can be used with a ContentProvider through a ContentValues or Cursor object. The values stored in this column are Cursor#FIELD_TYPE_INTEGER , and are read-only and cannot be mutated.

Constant Value: "width"

Fields

EXTERNAL_CONTENT_URI

Added in API level 1

public static final Uri EXTERNAL_CONTENT_URI

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

INTERNAL_CONTENT_URI

Added in API level 1

public static final Uri INTERNAL_CONTENT_URI

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

Public constructors

Thumbnails

Added in API level 1

public Thumbnails ()

Public methods

cancelThumbnailRequest

Added in API level 5
Deprecated in API level 29

public static void cancelThumbnailRequest (ContentResolver cr, 
                long origId)

This method was deprecated in API level 29.
Callers should migrate to using ContentResolver.loadThumbnail, since it offers richer control over requested thumbnail sizes and cancellation behavior.

Cancel any outstanding getThumbnail(ContentResolver, long, int, Options) requests, causing them to return by throwing a OperationCanceledException.

This method has no effect on ContentResolver.loadThumbnail calls, since they provide their own CancellationSignal.

Parameters
`cr`	`ContentResolver`
`origId`	`long`

cancelThumbnailRequest

Added in API level 8
Deprecated in API level 29

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

Cancel any outstanding getThumbnail(ContentResolver, long, int, Options) requests, causing them to return by throwing a OperationCanceledException.

This method has no effect on ContentResolver.loadThumbnail calls, since they provide their own CancellationSignal.

Parameters
`cr`	`ContentResolver`
`origId`	`long`
`groupId`	`long`

getContentUri

Added in API level 1

public static Uri getContentUri (String volumeName)

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

Parameters
`volumeName`	`String`: the name of the volume to get the URI for

Returns
`Uri`	the URI to the image media table on the given volume

getKindSize

Added in API level 30
Deprecated in API level 29

public static Size getKindSize (int kind)

Return the typical Size (in pixels) used internally when the given thumbnail kind is requested.

Parameters
`kind`	`int`

Returns
`Size`	This value cannot be `null`.

getThumbnail

Added in API level 8
Deprecated in API level 29

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

Return thumbnail representing a specific image item. If a thumbnail doesn't exist, this method will block until it's generated. Callers are responsible for their own in-memory caching of returned values. As of Build.VERSION_CODES.Q, this output of the thumbnail has correct rotation, don't need to rotate it again.

Parameters
`cr`	`ContentResolver`
`imageId`	`long`: the image item to obtain a thumbnail for.
`groupId`	`long`
`kind`	`int`: optimal thumbnail size desired.
`options`	`BitmapFactory.Options`

Returns
`Bitmap`	decoded thumbnail, or `null` if problem was encountered.

getThumbnail

Added in API level 5
Deprecated in API level 29

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

Parameters
`cr`	`ContentResolver`
`imageId`	`long`: the image item to obtain a thumbnail for.
`kind`	`int`: optimal thumbnail size desired.
`options`	`BitmapFactory.Options`

Returns
`Bitmap`	decoded thumbnail, or `null` if problem was encountered.

query

Added in API level 1

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

This method is deprecated.
all queries should be performed through ContentResolver directly, which offers modern features like CancellationSignal.

Parameters
`cr`	`ContentResolver`
`uri`	`Uri`
`projection`	`String`

Returns
`Cursor`

queryMiniThumbnail

Added in API level 1

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

This method is deprecated.
all queries should be performed through ContentResolver directly, which offers modern features like CancellationSignal.

Parameters
`cr`	`ContentResolver`
`origId`	`long`
`kind`	`int`
`projection`	`String`

Returns
`Cursor`

queryMiniThumbnails

Added in API level 1

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

This method is deprecated.
all queries should be performed through ContentResolver directly, which offers modern features like CancellationSignal.

Parameters
`cr`	`ContentResolver`
`uri`	`Uri`
`kind`	`int`
`projection`	`String`

Returns
`Cursor`