Decodificatore di immagini

L'API NDK ImageDecoder fornisce un'API standard per le app Android C/C++ per decodificare direttamente le immagini. Gli sviluppatori di app non devono più utilizzare le API Java (tramite JNI) o librerie di decodifica delle immagini di terze parti. Questa API, insieme alle funzioni di codifica nel modulo Bitmap, consente di:

  • Le app native e le librerie possono essere più piccole perché non devono più collegare le proprie librerie di decodifica.
  • Le app e le librerie beneficiano automaticamente degli aggiornamenti della sicurezza della piattaforma per le librerie di decodifica.
  • Le app possono decodificare le immagini direttamente nella memoria che forniscono. Le app possono quindi eseguire la post-elaborazione dei dati delle immagini (se lo desideri) e passarli a OpenGL o al loro codice di disegno.

In questa pagina viene descritto come utilizzare l'API per decodificare un'immagine.

Disponibilità e funzionalità

L'API ImageDecoder è disponibile nelle app che hanno come target Android 11 (livello API 30) o versioni successive. L'implementazione si trova nei seguenti file:

  • imagedecoder.h per il decoder
  • bitmap.h per l'encoder
  • libjnigraphics.so

L'API supporta i seguenti formati di immagine:

  • JPEG
  • PNG
  • GIF
  • WebP

  • BMP

  • ICO

  • WBMP

  • HEIF

  • Digital Negative (tramite l'SDK DNG)

Per coprire tutti gli utilizzi delle immagini non elaborate decodificate, questa API non fornisce oggetti di livello superiore come quelli creati sopra le immagini decodificate all'interno del framework Java, ad esempio:

  • Drawable oggetti.
  • NinePatch: se presenti in un'immagine codificata, i blocchi NinePatch vengono ignorati.
  • Densità bitmap: AImageDecoder non esegue alcuna regolazione automatica delle dimensioni in base alla densità dello schermo, ma consente la decodifica in dimensioni diverse tramite AImageDecoder_setTargetSize().
  • Animazioni: decodifica solo il primo frame di un file GIF animata o WebP.

Decodifica un'immagine

La decodifica inizia con una forma di input che rappresenta l'immagine codificata. AImageDecoder accetta più tipi di input:

  • AAsset (mostrato di seguito)
  • Descrittore del file
  • flussi di dati

Il seguente codice mostra come aprire un'immagine Asset da un file, decodificarla e poi eliminare correttamente il decoder e l'asset. Per un esempio di rendering dell'immagine decodificata, consulta l'esempio di teiera.

AAssetManager* nativeManager = AAssetManager_fromJava(env, jAssets);
const char* file = // Filename
AAsset* asset = AAssetManager_open(nativeManager, file, AASSET_MODE_STREAMING);
AImageDecoder* decoder;
int result = AImageDecoder_createFromAAsset(asset, &decoder);
if (result != ANDROID_IMAGE_DECODER_SUCCESS) {
  // An error occurred, and the file could not be decoded.
}

const AImageDecoderHeaderInfo* info = AImageDecoder_getHeaderInfo(decoder);
int32_t width = AImageDecoderHeaderInfo_getWidth(info);
int32_t height = AImageDecoderHeaderInfo_getHeight(info);
AndroidBitmapFormat format =
       (AndroidBitmapFormat) AImageDecoderHeaderInfo_getAndroidBitmapFormat(info);
size_t stride = AImageDecoder_getMinimumStride(decoder);  // Image decoder does not
                                                          // use padding by default
size_t size = height * stride;
void* pixels = malloc(size);

result = AImageDecoder_decodeImage(decoder, pixels, stride, size);
if (result != ANDROID_IMAGE_DECODER_SUCCESS) {
  // An error occurred, and the file could not be decoded.
}

// We’re done with the decoder, so now it’s safe to delete it.
AImageDecoder_delete(decoder);

// The decoder is no longer accessing the AAsset, so it is safe to
// close it.
AAsset_close(asset);

// Draw the pixels somewhere

// Free the pixels when done drawing with them
free(pixels);