कैमरा3_कैप्चर_अनुरोध संरचना संदर्भ
#include < camera3.h >
डेटा फ़ील्ड | |
| uint32_t | चौखटा नंबर |
| स्थिरांक कैमरा_मेटाडेटा_टी * | समायोजन |
| कैमरा3_स्ट्रीम_बफ़र_टी * | इनपुट_बफर |
| uint32_t | num_output_buffers |
| स्थिरांक कैमरा3_स्ट्रीम_बफ़र_टी * | आउटपुट_बफ़र्स |
विस्तृत विवरण
कैमरा3_कैप्चर_अनुरोध_टी:
इमेज कैप्चर/बफर रीप्रोसेसिंग के लिए एक एकल अनुरोध, प्रोसेस_कैप्चर_रेक्वेस्ट() में फ्रेमवर्क द्वारा कैमरा एचएएल डिवाइस को भेजा गया।
अनुरोध में इस कैप्चर के लिए उपयोग की जाने वाली सेटिंग्स और परिणामी छवि डेटा को लिखने के लिए आउटपुट बफ़र्स का सेट शामिल है। इसमें वैकल्पिक रूप से एक इनपुट बफ़र हो सकता है, जिस स्थिति में अनुरोध एक नया कैप्चर करने के बजाय उस इनपुट बफ़र को पुन: संसाधित करने के लिए है कैमरा सेंसर के साथ छवि. कैप्चर की पहचान फ़्रेम_नंबर द्वारा की जाती है।
जवाब में, कैमरा एचएएल डिवाइस को प्रोसेस_कैप्चर_रिजल्ट() कॉलबैक का उपयोग करके फ्रेमवर्क में एसिंक्रोनस रूप से कैमरा3_कैप्चर_रिजल्ट संरचना भेजनी होगी।
फ़ील्ड दस्तावेज़ीकरण
| uint32_t फ़्रेम_नंबर |
फ़्रेम संख्या इस कैप्चर को विशिष्ट रूप से पहचानने के लिए फ़्रेमवर्क द्वारा निर्धारित एक वृद्धिशील पूर्णांक है। इसे परिणाम कॉल में वापस करने की आवश्यकता है, और इसका उपयोग कैमरा3_कॉलबैक_ऑप्स_t.notify() पर भेजे गए एसिंक्रोनस नोटिफिकेशन में अनुरोध की पहचान करने के लिए भी किया जाता है।
| कैमरा3_स्ट्रीम_बफ़र_टी * इनपुट_बफ़र |
इस अनुरोध के लिए उपयोग किया जाने वाला इनपुट स्ट्रीम बफ़र, यदि कोई हो।
यदि इनपुट_बफ़र शून्य है, तो अनुरोध इमेजर से एक नए कैप्चर के लिए है। यदि इनपुट_बफ़र मान्य है, तो अनुरोध इनपुट_बफ़र में निहित छवि को पुन: संसाधित करने के लिए है।
बाद के मामले में, एचएएल को इनपुट_बफर के रिलीज_फेंस को वैध सिंक बाड़ पर सेट करना होगा, या यदि एचएएल सिंक का समर्थन नहीं करता है, तो प्रोसेस_कैप्चर_रेक्वेस्ट() रिटर्न से पहले -1 पर सेट करना होगा।
एचएएल को इनपुट बफर तक पहुंचने से पहले उसके अधिग्रहण सिंक बाड़ पर इंतजार करना आवश्यक है।
<= CAMERA_DEVICE_API_VERSION_3_1:
यहां शामिल किसी भी इनपुट बफ़र को अनुरोध में शामिल करने से पहले रजिस्टर_स्ट्रीम_बफ़र्स() के माध्यम से एचएएल के साथ पंजीकृत किया गया होगा।
>= CAMERA_DEVICE_API_VERSION_3_2:
बफ़र्स एचएएल के साथ पूर्व-पंजीकृत नहीं होंगे। बाद के अनुरोध बफ़र्स का पुन: उपयोग कर सकते हैं, या पूरी तरह से नए बफ़र्स प्रदान कर सकते हैं।
| uint32_t num_output_buffers |
| कॉन्स्ट कैमरा3_स्ट्रीम_बफ़र_टी * आउटपुट_बफ़र्स |
इस कैप्चर/रीप्रोसेस से छवि डेटा को भरने के लिए num_output_buffers स्ट्रीम बफ़र्स की एक सरणी। एचएएल को उन्हें लिखने से पहले प्रत्येक स्ट्रीम बफर के अधिग्रहण बाड़ पर इंतजार करना होगा।
एचएएल आउटपुट_बफ़र्स में वास्तविक बफ़र_हैंडल_टी प्रविष्टियों का स्वामित्व लेता है; जब तक वे कैमरा3_कैप्चर_रिजल्ट_टी में वापस नहीं आ जाते तब तक फ्रेमवर्क उन तक पहुंच नहीं पाता है।
<= CAMERA_DEVICE_API_VERSION_3_1:
यहां शामिल सभी बफ़र्स को अनुरोध में शामिल करने से पहले रजिस्टर_स्ट्रीम_बफ़र्स() के माध्यम से एचएएल के साथ पंजीकृत किया गया होगा।
>= CAMERA_DEVICE_API_VERSION_3_2:
यहां शामिल कोई भी या सभी बफ़र्स इस अनुरोध में बिल्कुल नए हो सकते हैं (एचएएल द्वारा पहले कभी नहीं देखे गए)।
| कॉन्स्ट कैमरा_मेटाडेटा_टी * सेटिंग्स |
सेटिंग्स बफ़र में अनुरोध के लिए कैप्चर और प्रोसेसिंग पैरामीटर शामिल हैं। एक विशेष मामले के रूप में, एक NULL सेटिंग्स बफ़र इंगित करता है कि सेटिंग्स सबसे हाल ही में सबमिट किए गए कैप्चर अनुरोध के समान हैं। config_streams() कॉल के बाद NULL बफ़र को पहले सबमिट किए गए अनुरोध के रूप में उपयोग नहीं किया जा सकता है।
इस संरचना के लिए दस्तावेज़ीकरण निम्नलिखित फ़ाइल से तैयार किया गया था:
- हार्डवेयर/लिबहार्डवेयर/शामिल/हार्डवेयर/ कैमरा3.एच