DataSourceBitmapLoader

Artifact: androidx.media3:media3-datasource

Kotlin |Java

@UnstableApi
class DataSourceBitmapLoader : BitmapLoader

A BitmapLoader implementation that uses a DataSource to support fetching images from URIs and BitmapFactory to load them into Bitmap.

Loading tasks are delegated to a ListeningExecutorService defined during construction. If no executor service is passed, all tasks are delegated to a single-thread executor service that is shared between instances of this class.

Summary

Constants
`const Supplier<ListeningExecutorService!>!`	`DEFAULT_EXECUTOR_SERVICE`

Public constructors
`DataSourceBitmapLoader(context: Context!)` Creates an instance that uses a `DefaultHttpDataSource` for image loading and delegates loading tasks to a `newSingleThreadExecutor`.
`DataSourceBitmapLoader( listeningExecutorService: ListeningExecutorService!, dataSourceFactory: DataSource.Factory! )` Creates an instance that delegates loading tasks to the `ListeningExecutorService`.
`DataSourceBitmapLoader( listeningExecutorService: ListeningExecutorService!, dataSourceFactory: DataSource.Factory!, options: BitmapFactory.Options? )` Creates an instance that delegates loading tasks to the `ListeningExecutorService`.
`DataSourceBitmapLoader( listeningExecutorService: ListeningExecutorService!, dataSourceFactory: DataSource.Factory!, options: BitmapFactory.Options?, maximumOutputDimension: Int )` Creates an instance that delegates loading tasks to the `ListeningExecutorService`.

Public functions
`ListenableFuture<Bitmap!>!`	`decodeBitmap(data: ByteArray!)` Decodes an image from compressed binary data.
`ListenableFuture<Bitmap!>!`	`loadBitmap(uri: Uri!)` Loads an image from `uri`.
`Boolean`	`supportsMimeType(mimeType: String!)` Returns whether the given `mimeType` is supported.

Inherited functions

From androidx.media3.common.util.BitmapLoader

ListenableFuture<Bitmap!>?

loadBitmapFromMetadata(metadata: MediaMetadata!)

Loads an image from MediaMetadata.

Constants

DEFAULT_EXECUTOR_SERVICE

const val DEFAULT_EXECUTOR_SERVICE: Supplier<ListeningExecutorService!>!

Public constructors

DataSourceBitmapLoader

DataSourceBitmapLoader(context: Context!)

Creates an instance that uses a DefaultHttpDataSource for image loading and delegates loading tasks to a newSingleThreadExecutor.

DataSourceBitmapLoader

DataSourceBitmapLoader(
    listeningExecutorService: ListeningExecutorService!,
    dataSourceFactory: DataSource.Factory!
)

Creates an instance that delegates loading tasks to the ListeningExecutorService.

Parameters
`listeningExecutorService: ListeningExecutorService!`	The `ListeningExecutorService`.
`dataSourceFactory: DataSource.Factory!`	The `DataSource.Factory` that creates the `DataSource` used to load the image.

DataSourceBitmapLoader

DataSourceBitmapLoader(
    listeningExecutorService: ListeningExecutorService!,
    dataSourceFactory: DataSource.Factory!,
    options: BitmapFactory.Options?
)

Creates an instance that delegates loading tasks to the ListeningExecutorService.

Parameters
`listeningExecutorService: ListeningExecutorService!`	The `ListeningExecutorService`.
`dataSourceFactory: DataSource.Factory!`	The `DataSource.Factory` that creates the `DataSource` used to load the image.
`options: BitmapFactory.Options?`	The `BitmapFactory.Options` the image should be loaded with.

DataSourceBitmapLoader

DataSourceBitmapLoader(
    listeningExecutorService: ListeningExecutorService!,
    dataSourceFactory: DataSource.Factory!,
    options: BitmapFactory.Options?,
    maximumOutputDimension: Int
)

Creates an instance that delegates loading tasks to the ListeningExecutorService.

Use maximumOutputDimension to limit memory usage when loading large Bitmaps.

Parameters
`listeningExecutorService: ListeningExecutorService!`	The `ListeningExecutorService`.
`dataSourceFactory: DataSource.Factory!`	The `DataSource.Factory` that creates the `DataSource` used to load the image.
`options: BitmapFactory.Options?`	The `BitmapFactory.Options` the image should be loaded with.
`maximumOutputDimension: Int`	The maximum dimension of the output Bitmap.

Public functions

decodeBitmap

fun decodeBitmap(data: ByteArray!): ListenableFuture<Bitmap!>!

Decodes an image from compressed binary data.

loadBitmap

fun loadBitmap(uri: Uri!): ListenableFuture<Bitmap!>!

Loads an image from uri.

supportsMimeType

fun supportsMimeType(mimeType: String!): Boolean

Returns whether the given mimeType is supported.