مرجع بنية camera3_capture_result

رقم اللقطة هو عدد صحيح متزايد يحدّده إطار العمل في الطلب الذي تم إرساله لتحديد هذه اللقطة بشكل فريد. ويُستخدَم أيضًا لتحديد الطلب في الإشعارات غير المتزامنة المُرسَلة إلى: camera3_callback_ops_t.notify() .

التعريف في السطر 2258 من الملف camera3.h .

‫‎>= CAMERA_DEVICE_API_VERSION_3_2:

معرّف وحدة تخزين بث الإدخال لهذا الالتقاط قد لا يتم استهلاكه بعد في وقت استدعاء HAL لـ process_capture_result(); وسينتظر إطار العمل حدود تحرير المزامنة التي يوفرها HAL قبل إعادة استخدام المخزن المؤقت.

يجب أن يعالج HAL حدود المزامنة بالطريقة نفسها التي يتم بها التعامل مع output_buffers.

يُسمح بإرسال وحدة تخزين مؤقت واحد فقط لكل طلب. على غرار وحدات تخزين الإخراج، يجب أن يحافظ HAL على ترتيب وحدات تخزين الإدخال المُسترَدة.

اعتبارات الأداء:

يجب إرجاع مخزن الإدخال في أقرب وقت ممكن. إذا كان HAL يتيح حدود المزامنة، يمكنه استدعاء process_capture_result لإعادته مع ضبط حدود المزامنة بشكل مناسب. إذا لم تكن حدود المزامنة متوافقة، لا يمكن إرجاع المخزن المؤقت إلا عند استخدامه، ما قد يستغرق وقتًا طويلاً. وقد يختار HAL نسخ مخزن الإدخال هذا لإعادة عرض المخزن المؤقت في وقت أقرب.

التعريف في السطر 2361 من الملف camera3.h .

عدد وحدات تخزين الإخراج التي يتم عرضها في بنية النتيجة هذه. يجب أن يكون أقل من أو يساوي عدد طلبات الالتقاط المطابقة. إذا كان هذا العدد أقل من عدد المخازن المؤقتة في طلب الالتقاط، يجب إجراء طلب واحد على الأقل آخر إلى process_capture_result باستخدام رقم_الإطار نفسه، لإعادة المخازن المؤقتة المتبقية للإخراج إلى إطار العمل. قد تكون هذه القيمة صفرًا فقط إذا كانت البنية تتضمّن بيانات وصفية صالحة للنتيجة أو إذا تم عرض وحدة تخزين مؤقت للإدخال في هذه النتيجة.

التعريف في السطر 2296 من الملف camera3.h .

يتم تخزين مقابض بث الإخراج مؤقتًا في ذاكرة التخزين المؤقت لعملية الالتقاط هذه. قد لا تكون هذه الحقول ممتلئة بعد في وقت استدعاء HAL لـ process_capture_result(); وسينتظر إطار العمل على حدود مزامنة الإصدار التي يوفرها HAL قبل قراءة المخزن المؤقت.

يجب أن يضبط HAL حاجز تحرير مزامنة مخزن البث على رقم تعريف ملف وصف صالح للمزامنة، أو على -1 إذا سبق أن تم ملء المخزن.

إذا واجه HAL خطأ أثناء معالجة المخزن المؤقت ولم يتم ملؤه، يجب ضبط حقل حالة المخزن المؤقت على CAMERA3_BUFFER_STATUS_ERROR. إذا لم ينتظر HAL على السياج المخصص للاستحواذ قبل مواجهة الخطأ، يجب نسخ السياج المخصص للاستحواذ إلى السياج المخصص للإفراج، للسماح للإطار بالانتظار على السياج قبل إعادة استخدام المخزن المؤقت.

يجب ضبط ميزة "حاجز الاستحواذ" على -1 لجميع وحدات تخزين المؤقت للإخراج. إذا كانت قيمة num_output_buffers تساوي صفرًا، قد تكون هذه القيمة فارغة. في هذه الحالة، يجب أن يُجري HAL طلبًا واحدًا على الأقل من عملية process_capture_result لتوفير وحدات تخزين مؤقت للإخراج.

عند استدعاء process_capture_result باستخدام مخزن مؤقت جديد للإطار، يجب أن يكون قد تم إرسال جميع مخازن الإطارات السابقة لهذا البث المقابل (ولا يلزم أن يكون قد تم إرسال حدود الإطارات بعد).

‫>= CAMERA_DEVICE_API_VERSION_3_2:

قد يتم إرسال مخازن Gralloc لإطار إلى إطار العمل قبل إشعار SHUTTER المقابل.

اعتبارات الأداء:

لن يتم إرسال المخزن المؤقت الذي يتم إرساله إلى إطار العمل إلى طبقة التطبيق إلى أن يتم استلام الطابع الزمني لبدء التعرّض من خلال طلب notify()‏ (SHUTTER). ننصح بشدة بإرسال هذه المكالمة في أقرب وقت ممكن.

التعريف في السطر 2335 من الملف camera3.h .

‫‎>= CAMERA_DEVICE_API_VERSION_3_2:

للاستفادة من النتائج الجزئية، يجب أن يضبط HAL البيانات الوصفية الثابتة android.request.partialResultCount على عدد النتائج الجزئية التي سيتم إرسالها لكل إطار.

يجب أن تضبط كل نتيجة جديدة لالتقاط البيانات التي تتضمّن نتيجة جزئية هذا الحقل (partial_result) على قيمة شاملة ومميّزة تتراوح بين 1 وandroid.request.partialResultCount.

يجب ألا تضبط واجهات HAL التي لا تريد الاستفادة من هذه الميزة قيمة غير 1 على android.request.partialResultCount أو partial_result.

يجب ضبط هذه القيمة على 0 عندما تحتوي نتيجة الالتقاط على وحدات تخزين مؤقت فقط بدون بيانات وصفية.

التعريف في السطر 2381 من الملف camera3.h .

البيانات الوصفية للنتيجة لهذا الالتقاط يحتوي هذا القسم على معلومات حول مَعلمات الالتقاط النهائية وحالة أجهزة الالتقاط والمعالجة اللاحقة وحالة خوارزميات 3A، في حال تفعيلها، وإخراج أي وحدات إحصاءات مفعَّلة.

قد تتضمّن البيانات الوصفية للنتيجة طلبًا واحدًا فقط لـ process_capture_result()‎ مع رقم_إطار معيّن. يجب أن تضبط جميع طلبات frame_number الأخرى هذا المقياس على NULL.

إذا حدث خطأ أثناء إنشاء البيانات الوصفية للنتيجة، يجب أن تكون النتيجة ذاكرة تخزين مؤقت فارغة للبيانات الوصفية، ويجب استدعاء notify() مع ERROR_RESULT.

‫‎>= CAMERA_DEVICE_API_VERSION_3_2:

قد تتضمّن عمليات الاتصال المتعدّدة بـ process_capture_result() مع رقم_إطار معيّن البيانات الوصفية للنتيجة.

يجب ألا تتضمّن البيانات الوصفية الجزئية التي يتم إرسالها أي مفتاح بيانات وصفية تم إرجاعه في نتيجة جزئية سابقة لإطار معيّن. يجب أيضًا أن تضبط كل نتيجة جزئية جديدة لهذا الإطار قيمة فريدة لسمة partial_result.

إذا تمّ استدعاء notify باستخدام ERROR_RESULT، يتجاهل إطار العمل جميع النتائج الجزئية الأخرى لهذا الإطار.

التعريف في السطر 2285 من الملف camera3.h .