מצלמה בוקה

בוקה של מצלמה הוא אפקט עומק שדה רדוד שנוצר על ידי טשטוש חלקים מסצנה כך שהם לא בפוקוס. במצלמות במכשירים ניידים, בוקה מושגת באמצעות מידע עומק הנרכש מראיית הסטריאו משתי מצלמות או מפוטודיודות כפולות (PD) של מצלמה בודדת.

החל מאנדרואיד 11, פלטפורמת אנדרואיד תומכת ביישום Bokeh ומספקת ממשקי API להפיכת התכונה לזמינה לאפליקציות צד שלישי.

יישום

כדי להפוך את תכונת הבוקה של המצלמה לזמינה במכשיר שלך, בצע את הפעולות הבאות:

  • פרסם ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES :

    תג זה הוא בפורמט של מערך tuple בן שלושה מספרים שלמים, כאשר כל tuple בפורמט של {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() כדי למנוע תצורה מחדש עבור מצבי סצנה מורחבים שאינם דורשים הגדרה מחדש.

מַתַן תוֹקֵף

כדי לאמת את תכונת הבוקה במכשיר שלך, הפעל את מבחני CTS, VTS ו-CTS Verifier הבאים:

  • CtsCameraTestCases
  • VtsHalCameraProviderV2_4TargetTest
  • CameraBokehTest ב-CTS Verifier
,

בוקה של מצלמה הוא אפקט עומק שדה רדוד שנוצר על ידי טשטוש חלקים מסצנה כך שהם לא בפוקוס. במצלמות במכשירים ניידים, בוקה מושגת באמצעות מידע עומק הנרכש מראיית הסטריאו משתי מצלמות או מפוטודיודות כפולות (PD) של מצלמה בודדת.

החל מאנדרואיד 11, פלטפורמת אנדרואיד תומכת ביישום Bokeh ומספקת ממשקי API להפיכת התכונה לזמינה לאפליקציות צד שלישי.

יישום

כדי להפוך את תכונת הבוקה של המצלמה לזמינה במכשיר שלך, בצע את הפעולות הבאות:

  • פרסם ANDROID_CONTROL_AVAILABLE_EXTENDED_SCENE_MODE_MAX_SIZES :

    תג זה הוא בפורמט של מערך tuple בן שלושה מספרים שלמים, כאשר כל tuple בפורמט של {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() כדי למנוע תצורה מחדש עבור מצבי סצנה מורחבים שאינם דורשים הגדרה מחדש.

מַתַן תוֹקֵף

כדי לאמת את תכונת הבוקה במכשיר שלך, הפעל את מבחני CTS, VTS ו-CTS Verifier הבאים:

  • CtsCameraTestCases
  • VtsHalCameraProviderV2_4TargetTest
  • CameraBokehTest ב-CTS Verifier