Bokeh kamera

Bokeh kamera adalah efek kedalaman bidang dangkal yang dibuat dengan memburamkan bagian adegan tertentu sehingga mereka tidak fokus. Pada kamera perangkat seluler, bokeh dicapai menggunakan informasi kedalaman yang diperoleh dari visi stereo dari dua kamera atau dari fotodiode ganda (PD) dari satu kamera.

Mulai dari Android 11, platform Android mendukung implementasi bokeh dan menyediakan API untuk menyediakan fitur ke aplikasi pihak ketiga.

Implementasi

Agar fitur bokeh kamera tersedia di perangkat Anda, lakukan hal berikut:

  • Beriklan ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES:

    Tag ini memiliki format array tuple tiga bilangan bulat, dengan setiap tuple dalam format {mode, maxWidth, maxHeight}. Selain {ANDROID_CONTROL_EXTENDED_SCENE_MODE_DISABLED, 0, 0}, HAL kamera harus mencantumkan juga salah satu atau kedua jenis ANDROID_CONTROL_EXTENDED_SCENE_MODE_BOKEH_STILL_CAPTURE dan ANDROID_CONTROL_EXTENDED_SCENE_MODE_BOKEH_CONTINUOUS mode dengan ukuran streaming maksimum yang sesuai.

  • Beriklan ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_ZOOM_RATIO_RANGES:

    Tag ini memiliki format array {minZoomRatio, maxZoomRatio}, yang berisi semua rentang rasio zoom untuk adegan diperluas yang diaktifkan dalam urutan yang sama seperti ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES. Rentang zoom [1.0, 1.0] berarti zoom tidak didukung.

  • Isi ANDROID_CONTROL_USE_EXTENDED_SCENE_MODE dalam ANDROID_CONTROL_AVAILABLE_MODES.

Agar aplikasi dapat memicu fitur bokeh, aplikasi harus menyetel ANDROID_CONTROL_MODE ke ANDROID_CONTROL_USE_EXTENDED_SCENE_MODE dan ANDROID_CONTROL_EXTENDED_SCENE_MODE ke salah satu mode adegan yang diperluas yang didukung. Perhatikan bahwa penerapan bokeh dapat menyebabkan konsumsi memori tambahan karena komputasi stereo.

Jika mode adegan diperluas yang didukung tidak dapat diterapkan per bingkai dan menyebabkan keterlambatan yang tidak terduga saat diaktifkan/dinonaktifkan, termasuk ANDROID_CONTROL_EXTENDED_SCENE_MODE inci ANDROID_REQUEST_AVAILABLE_SESSION_KEYS. Pada saat yang sama, implementasikan Metode ICameraDeviceSession::isReconfigurationRequired() yang harus dihindari konfigurasi ulang mode adegan yang diperluas yang tidak memerlukan konfigurasi ulang.

Validasi

Untuk memvalidasi fitur bokeh di perangkat Anda, jalankan CTS, VTS, dan Uji Pemverifikasi CTS:

  • CtsCameraTestCases
  • VtsHalCameraProviderV2_4TargetTest
  • CameraBokehTest dalam CTS Verifier