Dekoder obrazów

Interfejs NDK ImageDecoder API to standardowy interfejs API dla aplikacji na Androida napisanych w C/C++, który umożliwia bezpośrednie dekodowanie obrazów. Deweloperzy aplikacji nie muszą już używać interfejsów Java API (za pomocą JNI) ani bibliotek do dekodowania obrazów innych firm. Ten interfejs API wraz z funkcjami kodowania w module Bitmap umożliwia:

  • mniejsze rozmiary aplikacji i bibliotek natywnych, ponieważ nie muszą one już łączyć własnych bibliotek dekodowania;
  • automatyczne korzystanie przez aplikacje i biblioteki z aktualizacji zabezpieczeń platformy w bibliotekach dekodowania;
  • dekodowanie obrazów bezpośrednio do pamięci udostępnianej przez aplikacje; aplikacje mogą następnie przetwarzać dane obrazu (jeśli jest to wymagane) i przekazywać je do OpenGL lub kodu rysowania.

Na tej stronie dowiesz się, jak używać interfejsu API do dekodowania obrazu.

Dostępność i możliwości

Interfejs ImageDecoder API jest dostępny w aplikacjach kierowanych na Androida 11 (poziom 30 interfejsu API) lub nowszego. Implementacja znajduje się w tych plikach:

  • imagedecoder.h dla dekodera,
  • bitmap.h dla kodera,
  • libjnigraphics.so

Interfejs API obsługuje te formaty obrazów:

  • JPEG,
  • PNG,
  • GIF,
  • WebP,

  • BMP,

  • ICO,

  • WBMP,

  • HEIF,

  • cyfrowe negatywy (za pomocą pakietu DNG SDK).

Aby uwzględnić wszystkie zastosowania dekodowanych obrazów w formacie RAW, ten interfejs API nie udostępnia obiektów wyższego poziomu, takich jak te, które są tworzone na podstawie dekodowanych obrazów w ramach Java Framework, np.:

  • Drawable obiekty.
  • NinePatch: jeśli jest obecny w zakodowanym obrazie, fragmenty NinePatch są ignorowane;
  • Gęstość bitmapy: AImageDecoder nie dostosowuje automatycznie rozmiaru na podstawie gęstości ekranu, ale umożliwia dekodowanie do innego rozmiaru za pomocą AImageDecoder_setTargetSize().
  • animacje: dekoduje tylko pierwszą klatkę animowanego pliku GIF lub WebP.

Dekodowanie obrazu

Dekodowanie rozpoczyna się od danych wejściowych reprezentujących zakodowany obraz. AImageDecoder akceptuje kilka typów danych wejściowych:

  • AAsset (pokazany poniżej),
  • deskryptor pliku,
  • bufor.

Poniższy kod pokazuje, jak otworzyć obraz Asset z pliku, zdekodować go, a następnie prawidłowo usunąć dekoder i zasób. Przykład renderowania zdekodowanego obrazu znajdziesz w przykładzie z czajnikiem.

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);