מחרוזת שם

XR_ANDROID_recommended_resolution

סוג התוסף

תוסף למכונה

מספר השלוחה הרשום

462

גרסה

1

סטטוס האישור

לא אושר

תלויות של תוספים וגרסאות

OpenXR 1.0

סטטוס IP

אין תלונות ידועות על הפרת קניין רוחני.

שותפים ביצירת התוכן

Trevor Debrechtabel, Google
Spencer Quin, Google
Lachlan Ford, Google
Vasiliy Baranov, Google

סקירה כללית

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

התוסף הזה משנה את המפרט באופן הבא:

  • יכול להיות שזמן הריצה יחזיר תוכן מאגר לא זהה מהספירה של xrEnumerateViewConfigurationViews עבור systemId ו-viewConfigurationType הנתונים למשך כל חיי המופע.

המבנה של XrEventDataRecommendedResolutionChangedANDROID מוגדר כך:

typedef struct XrEventDataRecommendedResolutionChangedANDROID {
    XrStructureType    type;
    const void*        next;
} XrEventDataRecommendedResolutionChangedANDROID;

תיאורי חברים

  • ‫type הוא ה-XrStructureType של המבנה הזה.
  • ‫next הוא NULL או מצביע למבנה הבא בשרשרת מבנים. מבנים כאלה לא מוגדרים ב-OpenXR או בתוסף הזה.

קבלת מבנה האירוע XrEventDataRecommendedResolutionChangedANDROID מציינת שהרזולוציה המומלצת השתנתה. האפליקציה צריכה לשלוח שאילתה לזמן הריצה לגבי הרזולוציה המומלצת החדשה באמצעות xrEnumerateViewConfigurationViews .

שימוש תקין (משתמע)

קוד לדוגמה

קוד הדוגמה הבא מדגים איך להאזין לאירועים של שינוי רזולוציה מומלצת.

// Created at app startup time.
XrInstance instance;
XrSystemId systemId; // Previously initialized.
uint32_t viewCountOutput; // Previously initialized.

// View configuration type the application uses.
XrViewConfigurationType viewConfigType;

// Poll events for recommended resolution changes.
XrEventDataBuffer event = {
  .type = XR_TYPE_EVENT_DATA_BUFFER,
};
XrResult result = xrPollEvent(instance, &event);
if (result == XR_SUCCESS) {
  switch (event.type) {
    case XR_TYPE_EVENT_DATA_RECOMMENDED_RESOLUTION_CHANGED_ANDROID: {
        uint32_t viewCapacityInput = viewCountOutput;
        std::vector<XrViewConfigurationView> views(viewCapacityInput);
        result = xrEnumerateViewConfigurationViews(instance, systemId,
          viewConfigType, viewCapacityInput, &viewCountOutput, views.data());
        if(!XR_SUCCEEDED(result)) {
          // Handle error
        }

        // New recommended resolution is found in
        // views.recommendedImageRectWidth and views.recommendedImageRectHeight
        // Change the resolution for the viewConfigType
      break;
    }
    default:
      break;
  }
}

היסטוריית הגרסאות

  • גרסה 1, 04.04.2025 (Kenny Vercaemer)

    • תיאור התוסף הראשוני