بوكيه الكاميرا

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

بدءًا من Android 11، يدعم نظام Android الأساسي تطبيقات bokeh ويوفر واجهات برمجة التطبيقات لإتاحة الميزة لتطبيقات الطرف الثالث.

تطبيق

لإتاحة ميزة بوكيه الكاميرا على جهازك، قم بما يلي:

  • الإعلان عن 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_CONTROL_EXTENDED_SCENE_MODE في ANDROID_REQUEST_AVAILABLE_SESSION_KEYS . وفي الوقت نفسه، قم بتطبيق طريقة ICameraDeviceSession::isReconfigurationRequired() لتجنب إعادة التكوين لأوضاع المشهد الموسعة التي لا تتطلب إعادة التكوين.

تصديق

للتحقق من صحة ميزة bokeh على جهازك، قم بتشغيل اختبارات CTS وVTS وCTS Verifier التالية:

  • CtsCameraTestCases
  • VtsHalCameraProviderV2_4TargetTest
  • CameraBokehTest في أداة التحقق من CTS
,

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

بدءًا من Android 11، يدعم نظام Android الأساسي تطبيقات bokeh ويوفر واجهات برمجة التطبيقات لإتاحة الميزة لتطبيقات الطرف الثالث.

تطبيق

لإتاحة ميزة بوكيه الكاميرا على جهازك، قم بما يلي:

  • الإعلان عن 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_CONTROL_EXTENDED_SCENE_MODE في ANDROID_REQUEST_AVAILABLE_SESSION_KEYS . وفي الوقت نفسه، قم بتطبيق طريقة ICameraDeviceSession::isReconfigurationRequired() لتجنب إعادة التكوين لأوضاع المشهد الموسعة التي لا تتطلب إعادة التكوين.

تصديق

للتحقق من صحة ميزة bokeh على جهازك، قم بتشغيل اختبارات CTS وVTS وCTS Verifier التالية:

  • CtsCameraTestCases
  • VtsHalCameraProviderV2_4TargetTest
  • CameraBokehTest في أداة التحقق من CTS