कैमरा बोकेह

कैमरा बोकेह एक उथला गहराई-क्षेत्र प्रभाव है जो किसी दृश्य के कुछ हिस्सों को धुंधला करके बनाया जाता है ताकि वे फोकस में न रहें। मोबाइल उपकरणों के कैमरों पर, दो कैमरों के स्टीरियो विज़न से या एक कैमरे के दोहरे फोटोडायोड (पीडी) से प्राप्त गहन जानकारी का उपयोग करके बोकेह प्राप्त किया जाता है।

एंड्रॉइड 11 से शुरू होकर, एंड्रॉइड प्लेटफ़ॉर्म बोकेह कार्यान्वयन का समर्थन करता है और तीसरे पक्ष के ऐप्स को सुविधा उपलब्ध कराने के लिए एपीआई प्रदान करता है।

कार्यान्वयन

अपने डिवाइस पर कैमरा बोकेह सुविधा उपलब्ध कराने के लिए, निम्नलिखित कार्य करें:

  • विज्ञापन 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_REQUEST_AVAILABLE_SESSION_KEYS में ANDROID_CONTROL_EXTENDED_SCENE_MODE शामिल करें। साथ ही, विस्तारित दृश्य मोड के लिए पुन: कॉन्फ़िगरेशन से बचने के लिए ICameraDeviceSession::isReconfigurationRequired() विधि लागू करें, जिन्हें पुन: कॉन्फ़िगरेशन की आवश्यकता नहीं है।

मान्यकरण

अपने डिवाइस पर बोकेह सुविधा को मान्य करने के लिए, निम्नलिखित सीटीएस, वीटीएस और सीटीएस सत्यापनकर्ता परीक्षण चलाएं:

  • CtsCameraTestCases
  • VtsHalCameraProviderV2_4TargetTest
  • सीटीएस सत्यापनकर्ता में CameraBokehTest
,

कैमरा बोकेह एक उथला गहराई-क्षेत्र प्रभाव है जो किसी दृश्य के कुछ हिस्सों को धुंधला करके बनाया जाता है ताकि वे फोकस में न रहें। मोबाइल उपकरणों के कैमरों पर, दो कैमरों के स्टीरियो विज़न से या एक कैमरे के दोहरे फोटोडायोड (पीडी) से प्राप्त गहन जानकारी का उपयोग करके बोकेह प्राप्त किया जाता है।

एंड्रॉइड 11 से शुरू होकर, एंड्रॉइड प्लेटफ़ॉर्म बोकेह कार्यान्वयन का समर्थन करता है और तीसरे पक्ष के ऐप्स को सुविधा उपलब्ध कराने के लिए एपीआई प्रदान करता है।

कार्यान्वयन

अपने डिवाइस पर कैमरा बोकेह सुविधा उपलब्ध कराने के लिए, निम्नलिखित कार्य करें:

  • विज्ञापन 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_REQUEST_AVAILABLE_SESSION_KEYS में ANDROID_CONTROL_EXTENDED_SCENE_MODE शामिल करें। साथ ही, विस्तारित दृश्य मोड के लिए पुन: कॉन्फ़िगरेशन से बचने के लिए ICameraDeviceSession::isReconfigurationRequired() विधि लागू करें, जिन्हें पुन: कॉन्फ़िगरेशन की आवश्यकता नहीं है।

मान्यकरण

अपने डिवाइस पर बोकेह सुविधा को मान्य करने के लिए, निम्नलिखित सीटीएस, वीटीएस और सीटीएस सत्यापनकर्ता परीक्षण चलाएं:

  • CtsCameraTestCases
  • VtsHalCameraProviderV2_4TargetTest
  • सीटीएस सत्यापनकर्ता में CameraBokehTest