XR_KHR_extended_struct_name_lengths

নাম স্ট্রিং

XR_KHR_extended_struct_name_lengths

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

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

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

১৪৯

সংশোধন

২

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

অনুমোদিত

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

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

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

২০২৫-১২-০৪

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

কোনো জ্ঞাত আইপি দাবি নেই।

অবদানকারীরা

ম্যাথিউ ল্যাঙ্গিল, মেটা প্ল্যাটফর্মস
আন্দ্রেয়াস সেলভিক, মেটা প্ল্যাটফর্ম
রাইলি পাভলিক, কোলাবোরা, লিমিটেড।

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

এই এক্সটেনশনটি স্ট্রাক্ট নামের সর্বোচ্চ আকার বৃদ্ধি করে এবং এই নতুন বর্ধিত নামগুলো অ্যাক্সেস করার জন্য একটি নতুন ফাংশন প্রদান করে।

xrStructureTypeToString2KHR প্রদান করা হয়েছে স্ট্রাকচার টাইপ এনুমার‍্যান্টের সেইসব স্ট্রিং নাম পুনরুদ্ধার করার জন্য, যেগুলোর দৈর্ঘ্য মূল ৬৩ বাইটের (নাল টার্মিনেটর সহ ৬৪ বাইট) সীমা অতিক্রম করে। xrStructureTypeToString2KHR ২৫৫ বাইট পর্যন্ত দৈর্ঘ্যের (নাল টার্মিনেটর সহ ২৫৬ বাইট) স্ট্রাকচার টাইপ এনুমার‍্যান্টের জন্য নামের স্ট্রিং ফেরত দেয়। একটি অ্যাপ্লিকেশন xrStructureTypeToString- এর সরাসরি প্রতিস্থাপন হিসেবে xrStructureTypeToString2KHR ব্যবহার করতে পারে , কারণ এটি স্ট্রিং নামের দৈর্ঘ্য নির্বিশেষে সমস্ত স্ট্রাকচার টাইপ এনুমার‍্যান্টের সাথে কাজ করে।

স্ট্রাকচার টাইপ এনুমারেন্ট স্ট্রিং পুনরুদ্ধার করা

যদি ৬৩ বাইটের বেশি দৈর্ঘ্যের স্ট্রাকচার টাইপ এনুমারেন্টের জন্য স্ট্রিং নাম পুনরুদ্ধার করতে মূল xrStructureTypeToString ব্যবহার করা হয়, তবে এর আচরণ নিম্নরূপভাবে স্পষ্ট করা হয়েছে। xrStructureTypeToString-কে অবশ্যই বাফারটি সঠিক নাম দিয়ে পূরণ করতে হবে, তবে শর্ত থাকে যে, উপলব্ধ বাফারের মধ্যে জায়গা করে নেওয়ার জন্য স্ট্রিংটিকে একটি কোডপয়েন্ট সীমানায় ছেঁটে ফেলতে হবে । অর্থাৎ, ফেরত আসা স্ট্রিংটি অবশ্যই সর্বদা বৈধ UTF-8 হতে হবে।

xrStructureTypeToString2KHR ফাংশনটি নিম্নরূপে সংজ্ঞায়িত করা হয়েছে:

XrResult xrStructureTypeToString2KHR(
    XrInstance                                  instance,
    XrStructureType                             value,
    char                                        buffer[XR_MAX_STRUCTURE_NAME_SIZE_EXTENDED_KHR]);

প্যারামিটার বিবরণ

  • যে ইনস্ট্যান্স থেকে স্ট্রিংটি অনুরোধ করতে হবে, সেই ইনস্ট্যান্সটির হ্যান্ডেল হলো instance ।
  • value হলো সেই XrStructureType মান, যাকে স্ট্রিং-এ রূপান্তর করতে হবে।
  • buffer হলো সেই বাফার যা স্ট্রিংটি ফেরত দেওয়ার জন্য ব্যবহৃত হবে।

প্রদত্ত XrStructureType ভ্যালুটির নামটি ফেরত দেওয়ার জন্য, একটি বৈধ নাল-টার্মিনেটেড UTF-8 স্ট্রিং buffer কপি করা হয়।

সকল ক্ষেত্রে ফেরত আসা স্ট্রিংটি নিম্নলিখিতগুলির মধ্যে একটি হতে হবে :

কাঠামোর ধরণ স্ট্রিং আউটপুট মান

  • কোর স্পেসিফিকেশন বা এক্সটেনশনে প্রদত্ত সাংখ্যিক মানের জন্য সংজ্ঞায়িত আক্ষরিক স্ট্রিং। (যেমন, XR_TYPE_INSTANCE_CREATE_INFO এর মানের ফলে XR_TYPE_INSTANCE_CREATE_INFO স্ট্রিংটি পাওয়া যায়)
  • XR_UNKNOWN_STRUCTURE_TYPE_ সাথে দশমিক সংখ্যা হিসেবে প্রকাশিত স্ট্রাকচার টাইপ নম্বরটি সংযুক্ত করা হয়।

যেসব স্ট্রাকচার টাইপ এনুমার‍্যান্টের নাম ৬৩ বাইটের মূল আকারের সীমার মধ্যে থাকে, তাদের ক্ষেত্রে xrStructureTypeToString2KHR-কে অবশ্যই xrStructureTypeToString-এর মতোই একই ফলাফলস্বরূপ স্ট্রিং ফেরত দিতে হবে, যা নাল টার্মিনেটর পর্যন্ত প্রযোজ্য হবে।

বৈধ ব্যবহার (অন্তর্নিহিত)

  • xrStructureTypeToString2KHR কল করার আগে XR_KHR_extended_struct_name_lengths এক্সটেনশনটি অবশ্যই সক্রিয় করতে হবে।
  • instance অবশ্যই একটি বৈধ XrInstance হ্যান্ডেল হতে হবে
  • value অবশ্যই একটি বৈধ XrStructureType মান হতে হবে
  • buffer অবশ্যই XR_MAX_STRUCTURE_NAME_SIZE_EXTENDED_KHR দৈর্ঘ্যের একটি ক্যারেক্টার অ্যারে হতে হবে।

রিটার্ন কোড

সাফল্য

  • XR_SUCCESS

ব্যর্থতা

  • XR_ERROR_FUNCTION_UNSUPPORTED
  • XR_ERROR_HANDLE_INVALID
  • XR_ERROR_INSTANCE_LOST
  • XR_ERROR_RUNTIME_FAILURE
  • XR_ERROR_VALIDATION_FAILURE

XR_MAX_STRUCTURE_NAME_SIZE_EXTENDED_KHR এনুমারেন্টটি xrStructureTypeToString2KHR- এ পাস করা বাফারের আকার নির্ধারণ করে।

#define XR_MAX_STRUCTURE_NAME_SIZE_EXTENDED_KHR 256

নতুন কমান্ড

নতুন এনাম ধ্রুবক

  • XR_KHR_EXTENDED_STRUCT_NAME_LENGTHS_EXTENSION_NAME
  • XR_KHR_extended_struct_name_lengths_SPEC_VERSION
  • XR_MAX_STRUCTURE_NAME_SIZE_EXTENDED_KHR

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

  • সংস্করণ ১, ২০২৪-০২-২৯ (ম্যাথিউ ল্যাঙ্গিল)

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

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

    • কাঠামোর নামের দৈর্ঘ্যের নির্দিষ্টকরণ ঠিক করুন