XR_ANDROID_প্রস্তাবিত_রেজোলিউশন

নাম স্ট্রিং

XR_ANDROID_recommended_resolution

এক্সটেনশন টাইপ

ইনস্ট্যান্স এক্সটেনশন

নিবন্ধিত এক্সটেনশন নম্বর

৪৬২

সংশোধন

১

অনুমোদনের অবস্থা

অনুমোদিত নয়

এক্সটেনশন এবং সংস্করণ নির্ভরতা

ওপেনএক্সআর ১.০

সর্বশেষ সংশোধনের তারিখ

আইপি স্ট্যাটাস

অবদানকারীরা

ট্রেভর ডেব্রেচট্যাবেল, গুগল
স্পেন্সার কুইন, গুগল
ল্যাকলান ফোর্ড, গুগল
ভাসিলি বারানভ, গুগল

সংক্ষিপ্ত বিবরণ

এই এক্সটেনশনটি বর্তমান সিস্টেম পারফরম্যান্স, ডিভাইসের তাপীয় অবস্থা বা অন্যান্য কারণের উপর ভিত্তি করে প্রস্তাবিত রেজোলিউশন পরিবর্তিত হলে, রানটাইমকে অ্যাপ্লিকেশনকে অবহিত করার সুযোগ দেয়।

এই এক্সটেনশনটি স্পেসিফিকেশনটিকে নিম্নলিখিত উপায়ে পরিবর্তন করে:

• ইনস্ট্যান্সটির জীবনকাল জুড়ে রানটাইম, প্রদত্ত 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;
  }
}

সংস্করণ ইতিহাস

• সংস্করণ ১, ২০২৫-০৪-০৪ (কেনি ভার্কাইমার)

  • প্রাথমিক এক্সটেনশনের বিবরণ