XR_ANDROID_recommended_resolution

Name String

XR_ANDROID_recommended_resolution

एक्सटेंशन टाइप

इंस्टेंस एक्सटेंशन

रजिस्टर किया गया एक्सटेंशन नंबर

462

बदलाव

1

पुष्टि की स्थिति

पुष्टि नहीं की गई

एक्सटेंशन और वर्शन की डिपेंडेंसी

OpenXR 1.0

पिछली बार बदलाव किए जाने की तारीख

आईपी स्टेटस

योगदान देने वाले

ट्रेवर डेब्रेटेबल, Google
स्पेंसर क्विन, Google
लैकलन फ़ोर्ड, Google
वासिली बारानोव, Google

खास जानकारी

इस एक्सटेंशन की मदद से, रनटाइम, ऐप्लिकेशन को सूचना दे सकता है. यह सूचना, सुझाए गए रिज़ॉल्यूशन में बदलाव होने पर दी जाती है. रिज़ॉल्यूशन में बदलाव, सिस्टम की मौजूदा परफ़ॉर्मेंस, डिवाइस के तापमान या अन्य वजहों से हो सकता है.

यह एक्सटेंशन, स्पेसिफ़िकेशन में इस तरह बदलाव करता है:

• रनटाइम, इंस्टेंस के लाइफ़टाइम के लिए दिए गए systemId और viewConfigurationType के लिए, xrEnumerateViewConfigurationViews इन्यूमरेशन से बफ़र के अलग-अलग कॉन्टेंट दिखा सकता है.

XrEventDataRecommendedResolutionChangedANDROID स्ट्रक्चर को इस तरह से परिभाषित किया गया है:

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

सदस्यों के बारे में जानकारी

• type इस स्ट्रक्चर का XrStructureType है.
• next, NULL होता है या स्ट्रक्चर चेन में अगले स्ट्रक्चर का पॉइंटर होता है. इस तरह के स्ट्रक्चर, OpenXR के मुख्य स्पेसिफ़िकेशन या इस एक्सटेंशन में तय नहीं किए गए हैं.

XrEventDataRecommendedResolutionChangedANDROID इवेंट स्ट्रक्चर मिलने का मतलब है कि सुझाया गया रिज़ॉल्यूशन बदल गया है. ऐप्लिकेशन को, xrEnumerateViewConfigurationViews का इस्तेमाल करके, सुझाए गए नए रिज़ॉल्यूशन के लिए रनटाइम से क्वेरी करनी चाहिए .

मान्य इस्तेमाल (इंप्लिसिट)

• XrEventDataRecommendedResolutionChangedANDROID का इस्तेमाल करने से पहले, XR_ANDROID_recommended_resolution एक्सटेंशन को चालू करना ज़रूरी है
• 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 = {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;
  }
}

वर्शन इतिहास

• पहला संशोधन, 04-04-2025 (कैनी वर्केमर)

  • एक्सटेंशन की शुरुआती जानकारी