io.rong.imkit.picture.widget.longimage

Interface ImageRegionDecoder

All Known Implementing Classes:

SkiaImageRegionDecoder

public interface ImageRegionDecoder

Interface for image decoding classes, allowing the default BitmapRegionDecoder based on the Skia library to be replaced with a custom class.

Method Summary

Modifier and Type	Method and Description
android.graphics.Bitmap	decodeRegion(android.graphics.Rect sRect, int sampleSize) Decode a region of the image with the given sample size.
android.graphics.Point	init(android.content.Context context, android.net.Uri uri) Initialise the decoder.
boolean	isReady() Status check.
void	recycle() This method will be called when the decoder is no longer required.

Method Detail

init

android.graphics.Point init(android.content.Context context,
                            android.net.Uri uri)
                     throws java.lang.Exception

Initialise the decoder. When possible, initial setup work once in this method. This method must return the dimensions of the image. The URI can be in one of the following formats: File: file:///scard/picture.jpg Asset: file:///android_asset/picture.png Resource: android.resource://com.example.app/drawable/picture

Parameters:

context - Application context. A reference may be held, but must be cleared on recycle.

uri - URI of the image.

Returns:

Dimensions of the image.

Throws:

java.lang.Exception - if initialisation fails.

decodeRegion

android.graphics.Bitmap decodeRegion(android.graphics.Rect sRect,
                                     int sampleSize)

Decode a region of the image with the given sample size. This method is called off the UI thread so it can safely load the image on the current thread. It is called from an AsyncTask running in a single threaded executor, and while a synchronization lock is held on this object, so will never be called concurrently even if the decoder implementation supports it.

Parameters:

sRect - Source image rectangle to decode.

sampleSize - Sample size.

Returns:

The decoded region. It is safe to return null if decoding fails.

isReady

boolean isReady()

Status check. Should return false before initialisation and after recycle.

Returns:

true if the decoder is ready to be used.

recycle

void recycle()

This method will be called when the decoder is no longer required. It should clean up any resources still in use.