Bokeh kamera adalah efek kedalaman bidang dangkal yang dibuat dengan memburamkan bagian pemandangan sehingga tidak fokus. Pada kamera pada perangkat seluler, bokeh dicapai menggunakan informasi kedalaman yang diperoleh dari penglihatan stereo dari dua kamera atau dari fotodioda ganda (PD) dari satu kamera.
Mulai dari Android 11, platform Android mendukung penerapan bokeh dan menyediakan API untuk membuat fitur tersebut tersedia bagi aplikasi pihak ketiga.
Penerapan
Untuk menjadikan fitur bokeh kamera tersedia di perangkat Anda, lakukan hal berikut:
Iklankan
ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES
:Tag ini berformat larik tupel tiga bilangan bulat, dengan masing-masing tupel berformat
{mode, maxWidth, maxHeight}
. Selain{ANDROID_CONTROL_EXTENDED_SCENE_MODE_DISABLED, 0, 0}
, HAL kamera juga harus mencantumkan salah satu atau kedua modeANDROID_CONTROL_EXTENDED_SCENE_MODE_BOKEH_STILL_CAPTURE
danANDROID_CONTROL_EXTENDED_SCENE_MODE_BOKEH_CONTINUOUS
dengan ukuran streaming maksimum yang sesuai.Iklankan
ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_ZOOM_RATIO_RANGES
:Tag ini dalam format larik
{minZoomRatio, maxZoomRatio}
, yang berisi semua rentang rasio zoom untuk mode pemandangan diperluas yang diaktifkan, dalam urutan yang sama seperti padaANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES
. Rentang zoom[1.0, 1.0]
berarti zoom tidak didukung.Isi
ANDROID_CONTROL_USE_EXTENDED_SCENE_MODE
diANDROID_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 pemandangan tambahan yang didukung. Perhatikan bahwa penerapan bokeh dapat menyebabkan konsumsi memori ekstra karena komputasi stereo.
Jika mode pemandangan diperluas yang didukung tidak dapat diterapkan per frame dan mengakibatkan penundaan yang tidak terduga saat diaktifkan/dinonaktifkan, sertakan ANDROID_CONTROL_EXTENDED_SCENE_MODE
dalam ANDROID_REQUEST_AVAILABLE_SESSION_KEYS
. Pada saat yang sama, terapkan metode ICameraDeviceSession::isReconfigurationRequired()
untuk menghindari konfigurasi ulang untuk mode pemandangan yang diperluas yang tidak memerlukan konfigurasi ulang.
Validasi
Untuk memvalidasi fitur bokeh di perangkat Anda, jalankan pengujian CTS, VTS, dan CTS Verifier berikut:
-
CtsCameraTestCases
-
VtsHalCameraProviderV2_4TargetTest
-
CameraBokehTest
di Pemverifikasi CTS
Bokeh kamera adalah efek kedalaman bidang dangkal yang dibuat dengan memburamkan bagian pemandangan sehingga tidak fokus. Pada kamera pada perangkat seluler, bokeh dicapai menggunakan informasi kedalaman yang diperoleh dari penglihatan stereo dari dua kamera atau dari fotodioda ganda (PD) dari satu kamera.
Mulai dari Android 11, platform Android mendukung penerapan bokeh dan menyediakan API untuk membuat fitur tersebut tersedia bagi aplikasi pihak ketiga.
Penerapan
Untuk menjadikan fitur bokeh kamera tersedia di perangkat Anda, lakukan hal berikut:
Iklankan
ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES
:Tag ini berformat larik tupel tiga bilangan bulat, dengan masing-masing tupel berformat
{mode, maxWidth, maxHeight}
. Selain{ANDROID_CONTROL_EXTENDED_SCENE_MODE_DISABLED, 0, 0}
, HAL kamera juga harus mencantumkan salah satu atau kedua modeANDROID_CONTROL_EXTENDED_SCENE_MODE_BOKEH_STILL_CAPTURE
danANDROID_CONTROL_EXTENDED_SCENE_MODE_BOKEH_CONTINUOUS
dengan ukuran streaming maksimum yang sesuai.Iklankan
ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_ZOOM_RATIO_RANGES
:Tag ini dalam format larik
{minZoomRatio, maxZoomRatio}
, yang berisi semua rentang rasio zoom untuk mode pemandangan diperluas yang diaktifkan, dalam urutan yang sama seperti padaANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES
. Rentang zoom[1.0, 1.0]
berarti zoom tidak didukung.Isi
ANDROID_CONTROL_USE_EXTENDED_SCENE_MODE
diANDROID_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 pemandangan tambahan yang didukung. Perhatikan bahwa penerapan bokeh dapat menyebabkan konsumsi memori ekstra karena komputasi stereo.
Jika mode pemandangan diperluas yang didukung tidak dapat diterapkan per frame dan mengakibatkan penundaan yang tidak terduga saat diaktifkan/dinonaktifkan, sertakan ANDROID_CONTROL_EXTENDED_SCENE_MODE
dalam ANDROID_REQUEST_AVAILABLE_SESSION_KEYS
. Pada saat yang sama, terapkan metode ICameraDeviceSession::isReconfigurationRequired()
untuk menghindari konfigurasi ulang untuk mode pemandangan yang diperluas yang tidak memerlukan konfigurasi ulang.
Validasi
Untuk memvalidasi fitur bokeh di perangkat Anda, jalankan pengujian CTS, VTS, dan CTS Verifier berikut:
-
CtsCameraTestCases
-
VtsHalCameraProviderV2_4TargetTest
-
CameraBokehTest
di Pemverifikasi CTS