XR_ANDROID_recommended_resolution
מחרוזת שם
XR_ANDROID_recommended_resolution
סוג התוסף
תוסף למכונה
מספר השלוחה הרשום
462
גרסה
1
סטטוס האישור
לא אושר
תלויות של תוספים וגרסאות
סטטוס 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 .
שימוש תקין (משתמע)
- צריך להפעיל את התוסף
XR_ANDROID_recommended_resolutionלפני שמשתמשים ב-XrEventDataRecommendedResolutionChangedANDROID -
typeחייב להיותXR_TYPE_EVENT_DATA_RECOMMENDED_RESOLUTION_CHANGED_ANDROID -
nextחייב להיותNULLאו מצביע תקין למבנה הבא בשרשרת מבנים
קוד לדוגמה
קוד הדוגמה הבא מדגים איך להאזין לאירועים של שינוי רזולוציה מומלצת.
// 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)
- תיאור התוסף הראשוני