camera3_capture_request संरचना संदर्भ
#include < camera3.h >
डेटा फ़ील्ड | |
| uint32_t | चौखटा नंबर |
| const camera_metadata_t * | समायोजन |
| camera3_stream_buffer_t * | input_buffer |
| uint32_t | num_output_buffers |
| const camera3_stream_buffer_t * | output_buffers |
विस्तृत विवरण
camera3_capture_request_t:
इमेज कैप्चर / बफर रिप्रोसेसिंग के लिए एक एकल अनुरोध, प्रक्रिया Hcapture_request () में फ्रेमवर्क द्वारा कैमरा HAL डिवाइस को भेजा गया।
अनुरोध में इस कैप्चर के लिए उपयोग की जाने वाली सेटिंग्स और आउटपुट बफ़र्स का सेट होता है, जिसके परिणामस्वरूप छवि डेटा को लिखा जाता है। इसमें वैकल्पिक रूप से एक इनपुट बफर हो सकता है, जिस स्थिति में अनुरोध नए इनपुट को कैप्चर करने के बजाय उस इनपुट बफ़र को पुन: भेजने के लिए है। कैमरा सेंसर के साथ छवि। कैप्चर को फ्रेम_नंबर द्वारा पहचाना जाता है।
प्रतिक्रिया में, कैमरा HAL डिवाइस को process_capture_result () कॉलबैक का उपयोग करते हुए, फ्रेम के लिए अतुल्यकालिक रूप से एक camera3_capture_result संरचना भेजनी चाहिए।
फील्ड प्रलेखन
| uint32_t फ्रेम_नंबर |
फ्रेम नंबर एक वृद्धिशील पूर्णांक है जिसे फ्रेमवर्क द्वारा विशिष्ट रूप से इस कैप्चर की पहचान करने के लिए सेट किया गया है। परिणाम कॉल में इसे वापस करने की आवश्यकता होती है, और इसका उपयोग कैमरा 3_callback_ops_t.notify () को भेजे गए अतुल्यकालिक सूचनाओं में अनुरोध की पहचान करने के लिए भी किया जाता है।
| camera3_stream_buffer_t * input_buffer |
इनपुट स्ट्रीम बफर इस अनुरोध के लिए उपयोग करने के लिए, यदि कोई हो।
यदि input_buffer NULL है, तो अनुरोध इमेजर से नए कैप्चर के लिए है। यदि input_buffer वैध है, तो अनुरोध input_buffer में निहित छवि को पुन: प्रस्तुत करने के लिए है।
बाद के मामले में, एचएएल को input_buffer के रिलीज_फेंस को एक वैध सिंक बाड़ पर सेट करना चाहिए, या -1 को अगर HAL सिंक का समर्थन नहीं करता है, तो process_capture_request () रिटर्न से पहले।
एचएएल को एक्सेस करने से पहले इनपुट बफर के सिंक सिंक के अधिग्रहण पर इंतजार करना पड़ता है।
<= CAMERA_DEVICE_API_VERSION_3_1:
यहां शामिल किसी भी इनपुट बफर को HAL में register_stream_buffers () के माध्यम से एक अनुरोध में शामिल किए जाने से पहले पंजीकृत किया जाएगा।
> = CAMERA_DEVICE_API_VERSION_3_2:
बफ़र्स को एचएएल के साथ पूर्व-पंजीकृत नहीं किया गया होगा। बाद के अनुरोध बफ़र्स का पुन: उपयोग कर सकते हैं, या पूरी तरह से नए बफ़र्स प्रदान कर सकते हैं।
| uint32_t num_output_buffers |
| const camera3_stream_buffer_t * output_buffers |
इस कैप्चर / रिप्रोसेस से छवि डेटा से भरे जाने के लिए num_output_buffers स्ट्रीम बफ़र्स की एक सरणी। एचएएल को उन्हें लिखने से पहले प्रत्येक स्ट्रीम बफर के अधिग्रहण बाड़ पर इंतजार करना चाहिए।
HAL, output_buffers में वास्तविक बफर_हैंडल_ट प्रविष्टियों का स्वामित्व लेता है; जब तक वे कैमरा 3 में नहीं लौटते हैं, तब तक फ्रेमवर्क उन तक नहीं पहुंचता है।
<= CAMERA_DEVICE_API_VERSION_3_1:
अनुरोध में शामिल किए जाने से पहले यहां शामिल सभी बफ़र्स को HAL के साथ register_stream_buffers () के माध्यम से पंजीकृत किया जाएगा।
> = CAMERA_DEVICE_API_VERSION_3_2:
यहां शामिल कोई भी या सभी बफ़र इस अनुरोध में (एचएएल द्वारा पहले कभी नहीं देखे गए) नए हो सकते हैं।
| const camera_metadata_t * सेटिंग्स |
सेटिंग्स बफ़र में अनुरोध के लिए कैप्चर और प्रोसेसिंग पैरामीटर शामिल हैं। एक विशेष मामले के रूप में, एक NULL सेटिंग्स बफर इंगित करता है कि सेटिंग्स सबसे हाल ही में प्रस्तुत कैप्चर अनुरोध के समान हैं। कॉन्फ़िगर_स्ट्रीम () कॉल के बाद पहले सबमिट किए गए अनुरोध के रूप में एक NULL बफर का उपयोग नहीं किया जा सकता है।
इस संरचना का प्रलेखन निम्न फ़ाइल से उत्पन्न हुआ था:
- हार्डवेयर / कामचलाऊ / शामिल / हार्डवेयर / camera3.h