Package io.rong.imkit.picture.widget.longimage

## Interface SubsamplingScaleImageView.OnImageEventListener

- All Implemented Interfaces:

      public interface SubsamplingScaleImageView.OnImageEventListener

  An event listener, allowing subclasses and activities to be notified of significant events.

- - ### Nested Class Summary

    Nested Classes
    Modifier and Type | Class | Description
    --- | --- | ---

  - ### Field Summary

    Fields
    Modifier and Type | Field | Description
    --- | --- | ---

  - ### Constructor Summary

    Constructors
    Constructor | Description
    --- | ---

  - ### Enum Constant Summary

    Enum Constants
    Enum Constant | Description
    --- | ---

  - ### Method Summary

    Modifier and Type | Method | Description
    --- | --- | ---
    `abstract void` | `onReady()` | Called when the dimensions of the image and view are known, and either a preview image, the full size image, or base layer tiles are loaded.
    `abstract void` | `onImageLoaded()` | Called when the full size image is ready.
    `abstract void` | `onPreviewLoadError(Exception e)` | Called when a preview image could not be loaded.
    `abstract void` | `onImageLoadError(Exception e)` | Indicates an error initiliasing the decoder when using a tiling, or when loading the full size bitmap when tiling is disabled.
    `abstract void` | `onTileLoadError(Exception e)` | Called when an image tile could not be loaded.
    `abstract void` | `onPreviewReleased()` | Called when a bitmap set using ImageSource.cachedBitmap is no longer being used by the View.

    - ### Methods inherited from class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- - ### Constructor Detail

  - ### Method Detail

    - #### onReady

           abstract void onReady()

      Called when the dimensions of the image and view are known, and either a preview image, the full size image, or base layer tiles are loaded. This indicates the scale and translate are known and the next draw will display an image. This event can be used to hide a loading graphic, or inform a subclass that it is safe to draw overlays.

    - #### onImageLoaded

           abstract void onImageLoaded()

      Called when the full size image is ready. When using tiling, this means the lowest resolution base layer of tiles are loaded, and when tiling is disabled, the image bitmap is loaded. This event could be used as a trigger to enable gestures if you wanted interaction disabled while only a preview is displayed, otherwise for most cases onReady is the best event to listen to.

    - #### onPreviewLoadError

           abstract void onPreviewLoadError(Exception e)

      Called when a preview image could not be loaded. This method cannot be relied upon; certain encoding types of supported image formats can result in corrupt or blank images being loaded and displayed with no detectable error. The view will continue to load the full size image.

      Parameters:
        `e` - The exception thrown.

    - #### onImageLoadError

           abstract void onImageLoadError(Exception e)

      Indicates an error initiliasing the decoder when using a tiling, or when loading the full size bitmap when tiling is disabled. This method cannot be relied upon; certain encoding types of supported image formats can result in corrupt or blank images being loaded and displayed with no detectable error.

      Parameters:
        `e` - The exception thrown.

    - #### onTileLoadError

           abstract void onTileLoadError(Exception e)

      Called when an image tile could not be loaded. This method cannot be relied upon; certain encoding types of supported image formats can result in corrupt or blank images being loaded and displayed with no detectable error. Most cases where an unsupported file is used will result in an error caught by onImageLoadError.

      Parameters:
        `e` - The exception thrown.

    - #### onPreviewReleased

           abstract void onPreviewReleased()

      Called when a bitmap set using ImageSource.cachedBitmap is no longer being used by the View. This is useful if you wish to manage the bitmap after the preview is shown