DataSourceBitmapLoader

Artifact: androidx.media3:media3-datasource

Kotlin |Java

@UnstableApi
public final class DataSourceBitmapLoader implements 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
`static final 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, DataSource.Factory dataSourceFactory )` Creates an instance that delegates loading tasks to the `ListeningExecutorService`.
`DataSourceBitmapLoader( ListeningExecutorService listeningExecutorService, DataSource.Factory dataSourceFactory, @Nullable BitmapFactory.Options options )` Creates an instance that delegates loading tasks to the `ListeningExecutorService`.
`DataSourceBitmapLoader( ListeningExecutorService listeningExecutorService, DataSource.Factory dataSourceFactory, @Nullable BitmapFactory.Options options, int maximumOutputDimension )` Creates an instance that delegates loading tasks to the `ListeningExecutorService`.

Public methods
`ListenableFuture<Bitmap>`	`decodeBitmap(byte[] data)` Decodes an image from compressed binary data.
`ListenableFuture<Bitmap>`	`loadBitmap(Uri uri)` Loads an image from `uri`.
`boolean`	`supportsMimeType(String mimeType)` Returns whether the given `mimeType` is supported.

Inherited methods

From androidx.media3.common.util.BitmapLoader

@Nullable ListenableFuture<Bitmap>

loadBitmapFromMetadata(MediaMetadata metadata)

Loads an image from MediaMetadata.

Constants

DEFAULT_EXECUTOR_SERVICE

public static final Supplier<ListeningExecutorService> DEFAULT_EXECUTOR_SERVICE

Public constructors

DataSourceBitmapLoader

public DataSourceBitmapLoader(Context context)

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

DataSourceBitmapLoader

public DataSourceBitmapLoader(
    ListeningExecutorService listeningExecutorService,
    DataSource.Factory dataSourceFactory
)

Creates an instance that delegates loading tasks to the ListeningExecutorService.

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

DataSourceBitmapLoader

public DataSourceBitmapLoader(
    ListeningExecutorService listeningExecutorService,
    DataSource.Factory dataSourceFactory,
    @Nullable BitmapFactory.Options options
)

Creates an instance that delegates loading tasks to the ListeningExecutorService.

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

DataSourceBitmapLoader

public DataSourceBitmapLoader(
    ListeningExecutorService listeningExecutorService,
    DataSource.Factory dataSourceFactory,
    @Nullable BitmapFactory.Options options,
    int maximumOutputDimension
)

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`.
`DataSource.Factory dataSourceFactory`	The `DataSource.Factory` that creates the `DataSource` used to load the image.
`@Nullable BitmapFactory.Options options`	The `BitmapFactory.Options` the image should be loaded with.
`int maximumOutputDimension`	The maximum dimension of the output Bitmap.

Public methods

decodeBitmap

public ListenableFuture<Bitmap> decodeBitmap(byte[] data)

Decodes an image from compressed binary data.

loadBitmap

public ListenableFuture<Bitmap> loadBitmap(Uri uri)

Loads an image from uri.

supportsMimeType

public boolean supportsMimeType(String mimeType)

Returns whether the given mimeType is supported.