Боке камеры

Боке камеры — это эффект малой глубины резкости, создаваемый путем размывания частей сцены, так что они не находятся в фокусе. На камерах мобильных устройств боке достигается с помощью информации о глубине, полученной из стереозрения двух камер или из двойных фотодиодов (PD) одной камеры.

Начиная с Android 11, платформа Android поддерживает реализацию эффекта боке и предоставляет API, делающие эту функцию доступной для сторонних приложений.

Выполнение

Чтобы сделать функцию боке камеры доступной на вашем устройстве, выполните следующие действия:

  • Реклама ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES :

    Этот тег имеет формат массива кортежей из трех целых чисел, где каждый кортеж имеет формат {mode, maxWidth, maxHeight} . В дополнение к {ANDROID_CONTROL_EXTENDED_SCENE_MODE_DISABLED, 0, 0} , HAL камеры также должен перечислить один или оба режима ANDROID_CONTROL_EXTENDED_SCENE_MODE_BOKEH_STILL_CAPTURE и ANDROID_CONTROL_EXTENDED_SCENE_MODE_BOKEH_CONTINUOUS с соответствующими им максимальными размерами потока.

  • Реклама ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_ZOOM_RATIO_RANGES :

    Этот тег имеет формат массива {minZoomRatio, maxZoomRatio} , который содержит все диапазоны коэффициентов масштабирования для включенного расширенного режима сцены в том же порядке, что и в ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES . Диапазон масштабирования [1.0, 1.0] означает, что масштабирование не поддерживается.

  • Заполните ANDROID_CONTROL_USE_EXTENDED_SCENE_MODE в ANDROID_CONTROL_AVAILABLE_MODES .

Чтобы приложение активировало функцию боке, оно должно установить ANDROID_CONTROL_MODE в ANDROID_CONTROL_USE_EXTENDED_SCENE_MODE и ANDROID_CONTROL_EXTENDED_SCENE_MODE в один из поддерживаемых расширенных режимов сцены. Обратите внимание, что реализация боке может привести к дополнительному потреблению памяти из-за стереовычислений.

Если поддерживаемый расширенный режим сцены не может быть применен для каждого кадра и приводит к неожиданным задержкам при включении/отключении, включите ANDROID_CONTROL_EXTENDED_SCENE_MODE в ANDROID_REQUEST_AVAILABLE_SESSION_KEYS . В то же время реализуйте метод ICameraDeviceSession::isReconfigurationRequired() , чтобы избежать перенастройки для расширенных режимов сцены, которые не требуют перенастройки.

Проверка

Чтобы проверить функцию боке на вашем устройстве, запустите следующие тесты CTS, VTS и CTS Verifier:

  • CtsCameraTestCases
  • VtsHalCameraProviderV2_4TargetTest
  • CameraBokehTest в CTS Verifier