Декодер изображений

API NDK ImageDecoder предоставляет стандартный API для приложений Android C/C++ для прямого декодирования изображений. Разработчикам приложений больше не нужно использовать API Java (через JNI) или сторонние библиотеки декодирования изображений. Этот API, наряду с функциями кодирования в модуле Bitmap , позволяет следующее:

  • Собственные приложения и библиотеки могут быть меньше, поскольку им больше не нужно подключать собственные библиотеки декодирования.
  • Приложения и библиотеки автоматически получают преимущества от обновлений безопасности платформы для библиотек декодирования.
  • Приложения могут декодировать изображения непосредственно в память, которую они предоставляют. Затем приложения могут выполнять постобработку данных изображения (при желании) и передавать их в OpenGL или свой код рисования.

На этой странице описывается, как использовать API для декодирования изображения.

Доступность и возможности

API ImageDecoder доступен в приложениях, ориентированных на Android 11 (уровень API 30) или выше. Реализация находится внутри следующих файлов:

  • imagedecoder.h для декодера
  • bitmap.h для кодировщика
  • libjnigraphics.so

API поддерживает следующие форматы изображений:

  • JPEG
  • PNG
  • GIF
  • ВебП

  • БМП

  • ICO

  • WBMP

  • ХЕИФ

  • Цифровые негативы (через DNG SDK)

Чтобы охватить все варианты использования декодированных необработанных изображений, этот API не предоставляет объекты более высокого уровня, подобные тем, которые создаются поверх декодированных изображений внутри фреймворка Java, например:

  • Drawable объекты .
  • NinePatch : если фрагменты NinePatch присутствуют в закодированном изображении, они игнорируются.
  • Плотность растрового изображения : AImageDecoder не выполняет автоматическую настройку размера на основе плотности экрана, но позволяет декодировать изображение в другой размер с помощью AImageDecoder_setTargetSize() .
  • Анимация: декодирует только первый кадр анимированного файла GIF или WebP.

Расшифровать изображение

Декодирование начинается с некоторой формы ввода, представляющей закодированное изображение. AImageDecoder принимает несколько типов ввода:

  • AAsset (показано ниже)
  • Дескриптор файла
  • Буфер

Следующий код показывает, как открыть изображение Asset из файла, декодировать его, а затем правильно распорядиться декодером и активом. Чтобы увидеть пример рендеринга декодированного изображения, см. пример чайника .

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

API NDK ImageDecoder предоставляет стандартный API для приложений Android C/C++ для прямого декодирования изображений. Разработчикам приложений больше не нужно использовать API Java (через JNI) или сторонние библиотеки декодирования изображений. Этот API, наряду с функциями кодирования в модуле Bitmap , позволяет следующее:

  • Собственные приложения и библиотеки могут быть меньше, поскольку им больше не нужно подключать собственные библиотеки декодирования.
  • Приложения и библиотеки автоматически получают преимущества от обновлений безопасности платформы для библиотек декодирования.
  • Приложения могут декодировать изображения непосредственно в память, которую они предоставляют. Затем приложения могут выполнять постобработку данных изображения (при желании) и передавать их в OpenGL или свой код рисования.

На этой странице описывается, как использовать API для декодирования изображения.

Доступность и возможности

API ImageDecoder доступен в приложениях, ориентированных на Android 11 (уровень API 30) или выше. Реализация находится внутри следующих файлов:

  • imagedecoder.h для декодера
  • bitmap.h для кодировщика
  • libjnigraphics.so

API поддерживает следующие форматы изображений:

  • JPEG
  • PNG
  • GIF
  • ВебП

  • БМП

  • ICO

  • WBMP

  • ХЕИФ

  • Цифровые негативы (через DNG SDK)

Чтобы охватить все варианты использования декодированных необработанных изображений, этот API не предоставляет объекты более высокого уровня, подобные тем, которые создаются поверх декодированных изображений внутри фреймворка Java, например:

  • Drawable объекты .
  • NinePatch : если фрагменты NinePatch присутствуют в закодированном изображении, они игнорируются.
  • Плотность растрового изображения : AImageDecoder не выполняет автоматическую настройку размера на основе плотности экрана, но позволяет декодировать изображение в другой размер с помощью AImageDecoder_setTargetSize() .
  • Анимация: декодирует только первый кадр анимированного файла GIF или WebP.

Расшифровать изображение

Декодирование начинается с некоторой формы ввода, представляющей закодированное изображение. AImageDecoder принимает несколько типов ввода:

  • AAsset (показано ниже)
  • Дескриптор файла
  • Буфер

Следующий код показывает, как открыть изображение Asset из файла, декодировать его, а затем правильно распорядиться декодером и активом. Чтобы увидеть пример рендеринга декодированного изображения, см. пример чайника .

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