कैमरा3_कैप्चर_अनुरोध संरचना संदर्भ

कैमरा3_कैप्चर_अनुरोध संरचना संदर्भ

#include < camera3.h >

डेटा फ़ील्ड

uint32_t चौखटा नंबर
स्थिरांक कैमरा_मेटाडेटा_टी * समायोजन
कैमरा3_स्ट्रीम_बफ़र_टी * इनपुट_बफर
uint32_t num_output_buffers
स्थिरांक कैमरा3_स्ट्रीम_बफ़र_टी * आउटपुट_बफ़र्स

विस्तृत विवरण

कैमरा3_कैप्चर_अनुरोध_टी:

इमेज कैप्चर/बफर रीप्रोसेसिंग के लिए एक एकल अनुरोध, प्रोसेस_कैप्चर_रेक्वेस्ट() में फ्रेमवर्क द्वारा कैमरा एचएएल डिवाइस को भेजा गया।

अनुरोध में इस कैप्चर के लिए उपयोग की जाने वाली सेटिंग्स और परिणामी छवि डेटा को लिखने के लिए आउटपुट बफ़र्स का सेट शामिल है। इसमें वैकल्पिक रूप से एक इनपुट बफ़र हो सकता है, जिस स्थिति में अनुरोध एक नया कैप्चर करने के बजाय उस इनपुट बफ़र को पुन: संसाधित करने के लिए है कैमरा सेंसर के साथ छवि. कैप्चर की पहचान फ़्रेम_नंबर द्वारा की जाती है।

जवाब में, कैमरा एचएएल डिवाइस को प्रोसेस_कैप्चर_रिजल्ट() कॉलबैक का उपयोग करके फ्रेमवर्क में एसिंक्रोनस रूप से कैमरा3_कैप्चर_रिजल्ट संरचना भेजनी होगी।

कैमरा3.एच फ़ाइल की पंक्ति 2135 पर परिभाषा।

फ़ील्ड दस्तावेज़ीकरण

uint32_t फ़्रेम_नंबर

फ़्रेम संख्या इस कैप्चर को विशिष्ट रूप से पहचानने के लिए फ़्रेमवर्क द्वारा निर्धारित एक वृद्धिशील पूर्णांक है। इसे परिणाम कॉल में वापस करने की आवश्यकता है, और इसका उपयोग कैमरा3_कॉलबैक_ऑप्स_t.notify() पर भेजे गए एसिंक्रोनस नोटिफिकेशन में अनुरोध की पहचान करने के लिए भी किया जाता है।

कैमरा3.एच फ़ाइल की पंक्ति 2142 पर परिभाषा।

इस अनुरोध के लिए उपयोग किया जाने वाला इनपुट स्ट्रीम बफ़र, यदि कोई हो।

यदि इनपुट_बफ़र शून्य है, तो अनुरोध इमेजर से एक नए कैप्चर के लिए है। यदि इनपुट_बफ़र मान्य है, तो अनुरोध इनपुट_बफ़र में निहित छवि को पुन: संसाधित करने के लिए है।

बाद के मामले में, एचएएल को इनपुट_बफर के रिलीज_फेंस को वैध सिंक बाड़ पर सेट करना होगा, या यदि एचएएल सिंक का समर्थन नहीं करता है, तो प्रोसेस_कैप्चर_रेक्वेस्ट() रिटर्न से पहले -1 पर सेट करना होगा।

एचएएल को इनपुट बफर तक पहुंचने से पहले उसके अधिग्रहण सिंक बाड़ पर इंतजार करना आवश्यक है।

<= CAMERA_DEVICE_API_VERSION_3_1:

यहां शामिल किसी भी इनपुट बफ़र को अनुरोध में शामिल करने से पहले रजिस्टर_स्ट्रीम_बफ़र्स() के माध्यम से एचएएल के साथ पंजीकृत किया गया होगा।

>= CAMERA_DEVICE_API_VERSION_3_2:

बफ़र्स एचएएल के साथ पूर्व-पंजीकृत नहीं होंगे। बाद के अनुरोध बफ़र्स का पुन: उपयोग कर सकते हैं, या पूरी तरह से नए बफ़र्स प्रदान कर सकते हैं।

कैमरा3.एच फ़ाइल की पंक्ति 2177 पर परिभाषा।

uint32_t num_output_buffers

इस कैप्चर अनुरोध के लिए आउटपुट बफ़र्स की संख्या। कम से कम 1 होना चाहिए.

कैमरा3.एच फ़ाइल की पंक्ति 2183 पर परिभाषा।

कॉन्स्ट कैमरा3_स्ट्रीम_बफ़र_टी * आउटपुट_बफ़र्स

इस कैप्चर/रीप्रोसेस से छवि डेटा को भरने के लिए num_output_buffers स्ट्रीम बफ़र्स की एक सरणी। एचएएल को उन्हें लिखने से पहले प्रत्येक स्ट्रीम बफर के अधिग्रहण बाड़ पर इंतजार करना होगा।

एचएएल आउटपुट_बफ़र्स में वास्तविक बफ़र_हैंडल_टी प्रविष्टियों का स्वामित्व लेता है; जब तक वे कैमरा3_कैप्चर_रिजल्ट_टी में वापस नहीं आ जाते तब तक फ्रेमवर्क उन तक पहुंच नहीं पाता है।

<= CAMERA_DEVICE_API_VERSION_3_1:

यहां शामिल सभी बफ़र्स को अनुरोध में शामिल करने से पहले रजिस्टर_स्ट्रीम_बफ़र्स() के माध्यम से एचएएल के साथ पंजीकृत किया गया होगा।

>= CAMERA_DEVICE_API_VERSION_3_2:

यहां शामिल कोई भी या सभी बफ़र्स इस अनुरोध में बिल्कुल नए हो सकते हैं (एचएएल द्वारा पहले कभी नहीं देखे गए)।

कैमरा3.एच फ़ाइल की पंक्ति 2204 पर परिभाषा।

कॉन्स्ट कैमरा_मेटाडेटा_टी * सेटिंग्स

सेटिंग्स बफ़र में अनुरोध के लिए कैप्चर और प्रोसेसिंग पैरामीटर शामिल हैं। एक विशेष मामले के रूप में, एक NULL सेटिंग्स बफ़र इंगित करता है कि सेटिंग्स सबसे हाल ही में सबमिट किए गए कैप्चर अनुरोध के समान हैं। config_streams() कॉल के बाद NULL बफ़र को पहले सबमिट किए गए अनुरोध के रूप में उपयोग नहीं किया जा सकता है।

कैमरा3.एच फ़ाइल की पंक्ति 2151 पर परिभाषा।


इस संरचना के लिए दस्तावेज़ीकरण निम्नलिखित फ़ाइल से तैयार किया गया था:
  • हार्डवेयर/लिबहार्डवेयर/शामिल/हार्डवेयर/ कैमरा3.एच