নাম স্ট্রিং
XR_ANDROID_light_estimation
এক্সটেনশন টাইপ
ইনস্ট্যান্স এক্সটেনশন
নিবন্ধিত এক্সটেনশন নম্বর
701
রিভিশন
1
এক্সটেনশন এবং সংস্করণ নির্ভরতা
সর্বশেষ সংশোধিত তারিখ
2025-01-17
আইপি স্ট্যাটাস
কোন পরিচিত আইপি দাবি.
অবদানকারী
জ্যারেড ফাইন্ডার, গুগল
কেয়ার্ন ওভারটার্ফ, গুগল
স্পেন্সার কুইন, গুগল
লেভানা চেন, গুগল
নিহাভ জৈন, গুগল
সালার খান, গুগল
স্কট চুং, গুগল
ওভারভিউ
এই এক্সটেনশনটি অ্যাপ্লিকেশনটিকে হেডসেটের চারপাশে বাস্তব-বিশ্বের পরিবেশের আলোকসজ্জার প্রতিনিধিত্বকারী ডেটা অনুরোধ করার অনুমতি দেয়৷ ভার্চুয়াল অবজেক্ট রেন্ডার করার সময় এই তথ্যটি ব্যবহার করা যেতে পারে যাতে তারা যে দৃশ্যে স্থাপন করা হয় সেই একই অবস্থার অধীনে আলোকিত করতে।
সিস্টেমের ক্ষমতা পরিদর্শন করুন
xrGetSystemProperties কল করার সময় একটি অ্যাপ্লিকেশন XrSystemLightEstimationPropertiesANDROID কাঠামোকে XrSystemProperties- এ চেইন করে সিস্টেমটি হালকা অনুমান সমর্থন করে কিনা তা পরীক্ষা করতে পারে ।
typedef struct XrSystemLightEstimationPropertiesANDROID {
XrStructureType type;
void* next;
XrBool32 supportsLightEstimation;
} XrSystemLightEstimationPropertiesANDROID;
সদস্য বিবরণ
-
typeহল এই কাঠামোর XrStructureType । -
nextহলNULLবা একটি স্ট্রাকচার চেইনের পরবর্তী কাঠামোর একটি পয়েন্টার। কোর OpenXR বা এই এক্সটেনশনে এই ধরনের কোনো কাঠামো সংজ্ঞায়িত করা হয়নি। -
supportsLightEstimationহল একটিXrBool32, বর্তমান সিস্টেম হালকা অনুমান সমর্থন করে কিনা তা নির্দেশ করে।
একটি অ্যাপ্লিকেশন XrGetSystemProperties কল করার সময় XrSystemLightEstimationPropertiesANDROID কাঠামোর সাথে XrSystemProperties প্রসারিত করে আলোর অনুমান সমর্থন করতে সক্ষম কিনা তা পরীক্ষা করতে পারে ।
যদি সিস্টেমটি হালকা অনুমান সমর্থন করতে সক্ষম না হয়, তাহলে এটি supportsLightEstimation জন্য XR_FALSE এবং xrCreateLightEstimatorANDROID থেকে XR_ERROR_FEATURE_UNSUPPORTED প্রদান করবে।
বৈধ ব্যবহার (অন্তর্নিহিত)
- XR_ANDROID_light_estimation এক্সটেনশনটি XrSystemLightEstimationPropertiesANDROID ব্যবহার করার আগে অবশ্যই সক্রিয় করা উচিত
-
typeXR_TYPE_SYSTEM_LIGHT_ESTIMATION_PROPERTIES_ANDROIDহতে হবে -
nextঅবশ্যইNULLবা একটি কাঠামোর চেইনের পরবর্তী কাঠামোর জন্য একটি বৈধ পয়েন্টার হতে হবে
একটি হালকা অনুমানকারী হ্যান্ডেল তৈরি করুন
XR_DEFINE_HANDLE(XrLightEstimatorANDROID)
XrLightEstimatorANDROID হ্যান্ডেল একটি হালকা অনুমানক প্রতিনিধিত্ব করে। এই হ্যান্ডেলটি এই এক্সটেনশনের অন্যান্য ফাংশন ব্যবহার করে হালকা অনুমান তথ্য অ্যাক্সেস করতে ব্যবহার করা যেতে পারে ।
xrCreateLightEstimatorANDROID ফাংশনটি এইভাবে সংজ্ঞায়িত করা হয়েছে:
XrResult xrCreateLightEstimatorANDROID(
XrSession session,
XrLightEstimatorCreateInfoANDROID* createInfo,
XrLightEstimatorANDROID* outHandle);
পরামিতি বিবরণ
-
sessionহল XrSession যা আলোর অনুমানক তৈরি করে। -
createInfoহল একটি XrLightEstimatorCreateInfoANDROID স্ট্রাকচারের একটি পয়েন্টার যেখানে হালকা অনুমানক তৈরি করতে ব্যবহার করা হবে এমন প্যারামিটার রয়েছে। -
outHandleহল একটি হ্যান্ডেলের একটি পয়েন্টার যেখানে তৈরি করা XrLightEstimatorANDROID ফেরত দেওয়া হয়।
অ্যাপ্লিকেশনটি একটি হালকা অনুমানক তৈরি করতে xrCreateLightEstimatorANDROID ফাংশন ব্যবহার করতে পারে ।
- xrCreateLightEstimatorANDROID
XR_ERROR_FEATURE_UNSUPPORTEDফেরত দেবে যদি সিস্টেম আলোর অনুমান সমর্থন না করে। - xrCreateLightEstimatorANDROID
XR_ERROR_PERMISSION_INSUFFICIENTফেরত দেবে যদি কলিং অ্যাপ্লিকেশনে প্রয়োজনীয় অনুমতি না দেওয়া হয়।
প্রত্যাবর্তিত আলো অনুমানকারী হ্যান্ডেল পরবর্তীতে API কলগুলিতে ব্যবহার করা যেতে পারে । যদি একটি অ্যাপ্লিকেশন রানটাইমকে নির্দেশ করতে চায় যে এটি হালকা অনুমান ডেটা অ্যাক্সেস করা হয়েছে তবে এটি xrDestroyLightEstimatorANDROID ব্যবহার করে হ্যান্ডেলটি ধ্বংস করতে হবে ।
বৈধ ব্যবহার (অন্তর্নিহিত)
- xrCreateLightEstimatorANDROID কল করার আগে
XR_ANDROID_light_estimationএক্সটেনশনটি সক্রিয় করা আবশ্যক -
sessionঅবশ্যই একটি বৈধ XrSession হ্যান্ডেল হতে হবে -
createInfoঅবশ্যই একটি XrLightEstimatorCreateInfoANDROID কাঠামোর একটি পয়েন্টার হতে হবে -
outHandleঅবশ্যই একটি XrLightEstimatorANDROID হ্যান্ডেলের একটি পয়েন্টার হতে হবে
রিটার্ন কোড
-
XR_SUCCESS -
XR_SESSION_LOSS_PENDING
-
XR_ERROR_FUNCTION_UNSUPPORTED -
XR_ERROR_RUNTIME_FAILURE -
XR_ERROR_INSTANCE_LOST -
XR_ERROR_SESSION_LOST -
XR_ERROR_OUT_OF_MEMORY -
XR_ERROR_HANDLE_INVALID -
XR_ERROR_LIMIT_REACHED
XrLightEstimatorCreateInfoANDROID কাঠামো একটি XrLightEstimatorANDROID হ্যান্ডেল তৈরি করার তথ্য বর্ণনা করে।
typedef struct XrLightEstimatorCreateInfoANDROID {
XrStructureType type;
void* next;
} XrLightEstimatorCreateInfoANDROID;
সদস্য বিবরণ
-
typeহল এই কাঠামোর XrStructureType । -
nextহলNULLবা একটি স্ট্রাকচার চেইনের পরবর্তী কাঠামোর একটি পয়েন্টার। কোর OpenXR বা এই এক্সটেনশনে এই ধরনের কোনো কাঠামো সংজ্ঞায়িত করা হয়নি।
বৈধ ব্যবহার (অন্তর্নিহিত)
-
XR_ANDROID_light_estimationএক্সটেনশনটি XrLightEstimatorCreateInfoANDROID ব্যবহার করার পূর্বে সক্রিয় করা আবশ্যক -
typeXR_TYPE_LIGHT_ESTIMATOR_CREATE_INFO_ANDROIDহতে হবে -
nextঅবশ্যইNULLবা একটি কাঠামোর চেইনের পরবর্তী কাঠামোর জন্য একটি বৈধ পয়েন্টার হতে হবে
xrDestroyLightEstimatorANDROID ফাংশন estimator এবং যেকোনো অন্তর্নিহিত সম্পদ প্রকাশ করে।
XrResult xrDestroyLightEstimatorANDROID(
XrLightEstimatorANDROID estimator);
পরামিতি বিবরণ
-
estimatorহল একটি XrLightEstimatorANDROID পূর্বে xrCreateLightEstimatorANDROID দ্বারা তৈরি করা হয়েছে।
বৈধ ব্যবহার (অন্তর্নিহিত)
-
XR_ANDROID_light_estimationএক্সটেনশনটি অবশ্যই xrDestroyLightEstimatorANDROID কল করার আগে সক্রিয় করতে হবে -
estimatorঅবশ্যই একটি বৈধ XrLightEstimatorANDROID হ্যান্ডেল হতে হবে
থ্রেড নিরাপত্তা
-
estimatorঅ্যাক্সেস, এবং যেকোনো শিশু হ্যান্ডেলগুলিকে বাহ্যিকভাবে সিঙ্ক্রোনাইজ করতে হবে
রিটার্ন কোড
-
XR_SUCCESS
-
XR_ERROR_FUNCTION_UNSUPPORTED -
XR_ERROR_HANDLE_INVALID
হালকা অনুমান ডেটা অ্যাক্সেস করুন
xrGetLightEstimateANDROID ফাংশনটি এইভাবে সংজ্ঞায়িত করা হয়েছে:
XrResult xrGetLightEstimateANDROID(
XrLightEstimatorANDROID estimator,
const XrLightEstimateGetInfoANDROID* input,
XrLightEstimateANDROID* output);
পরামিতি বিবরণ
-
estimator: পূর্বেxrCreateLightEstimatorANDROIDএর সাথে তৈরি করা একটি XrLightEstimatorANDROID- কে হ্যান্ডেল করুন৷ -
input: একটি XrLightEstimateGetInfoANDROID কাঠামোর দিকে নির্দেশক৷ -
output: একটি XrLightEstimateANDROID কাঠামোর দিকে নির্দেশক।
বৈধ ব্যবহার (অন্তর্নিহিত)
- xrGetLightEstimateANDROID কল করার পূর্বে
XR_ANDROID_light_estimationএক্সটেনশনটি সক্রিয় করা আবশ্যক -
estimatorঅবশ্যই একটি বৈধ XrLightEstimatorANDROID হ্যান্ডেল হতে হবে -
inputএকটি বৈধ XrLightEstimateGetInfoANDROID কাঠামোর একটি পয়েন্টার হতে হবে ৷ -
outputএকটি XrLightEstimateANDROID কাঠামোর একটি পয়েন্টার হতে হবে
রিটার্ন কোড
-
XR_SUCCESS -
XR_SESSION_LOSS_PENDING
-
XR_ERROR_FUNCTION_UNSUPPORTED -
XR_ERROR_VALIDATION_FAILURE -
XR_ERROR_RUNTIME_FAILURE -
XR_ERROR_HANDLE_INVALID -
XR_ERROR_INSTANCE_LOST -
XR_ERROR_SESSION_LOST -
XR_ERROR_OUT_OF_MEMORY -
XR_ERROR_TIME_INVALID
একটি XrLightEstimateGetInfoANDROID হালকা অনুমান ডেটা পেতে প্রয়োজনীয় তথ্য বর্ণনা করে৷
typedef struct XrLightEstimateGetInfoANDROID {
XrStructureType type;
void* next;
XrSpace space;
XrTime time;
} XrLightEstimateGetInfoANDROID;
সদস্য বিবরণ
-
typeহল এই কাঠামোর XrStructureType । -
nextহলNULLবা একটি স্ট্রাকচার চেইনের পরবর্তী কাঠামোর একটি পয়েন্টার। -
spaceহল XrSpace রেফারেন্স স্পেসকে সংজ্ঞায়িত করে যেখানে প্রত্যাবর্তিত আলোর দিক এবং গোলাকার হারমোনিক্স এবং কিউবম্যাপ ঘূর্ণন প্রকাশ করা হয়। -
timeহলXrTimeযে সময়টি বর্ণনা করে যে সময়ে অ্যাপ্লিকেশনটি হালকা অনুমান অনুসন্ধান করতে চায়।
বৈধ ব্যবহার (অন্তর্নিহিত)
-
XR_ANDROID_light_estimationএক্সটেনশনটি XrLightEstimateGetInfoANDROID ব্যবহার করার পূর্বে সক্রিয় করা আবশ্যক -
typeXR_TYPE_LIGHT_ESTIMATE_GET_INFO_ANDROIDহতে হবে -
nextঅবশ্যইNULLবা একটি কাঠামোর চেইনের পরবর্তী কাঠামোর জন্য একটি বৈধ পয়েন্টার হতে হবে -
spaceঅবশ্যই একটি বৈধ XrSpace হ্যান্ডেল হতে হবে
XrLightEstimateANDROID গঠনে হালকা অনুমান ডেটা রয়েছে৷
typedef struct XrLightEstimateANDROID {
XrStructureType type;
void* next;
XrLightEstimateStateANDROID state;
XrTime lastUpdatedTime;
} XrLightEstimateANDROID;
সদস্য বিবরণ
-
typeহল এই কাঠামোর XrStructureType । -
nextহলNULLবা একটি স্ট্রাকচার চেইনের পরবর্তী কাঠামোর একটি পয়েন্টার। বৈধ কাঠামোগুলি হল XrAmbientLightANDROID , XrSphericalHarmonicsANDROID , XrEnvironmentLightingCubemapANDROID এবং XrDirectionalLightANDROID ৷ -
stateহল XrLightEstimateStateANDROID আলোর অনুমানের অবস্থার প্রতিনিধিত্ব করে৷ -
lastUpdatedTimeহলXrTimeযেটি প্রতিনিধিত্ব করে কখন অনুমানটি শেষবার গণনা করা হয়েছিল।
এনভায়রনমেন্ট লাইটিং কিউবম্যাপ, পরিবেষ্টিত আলো, গোলাকার হারমোনিক্স, এবং প্রাথমিক দিকনির্দেশক আলোর জন্য হালকা অনুমান তথ্য পেতে, অ্যাপ্লিকেশনগুলি নিম্নলিখিত কাঠামোর উদাহরণগুলিকে চেইন করতে পারে , XrEnvironmentLightingCubemapANDROID , XrAmbientLightANDROID , XrSphericalHarmonicsANDROID এবং XrSphericalHarmonicsANDROID এবং XrANDROIDL-এ XrLightEstimateANDROID::next ।
বৈধ ব্যবহার (অন্তর্নিহিত)
-
XR_ANDROID_light_estimationএক্সটেনশনটি XrLightEstimateANDROID ব্যবহার করার পূর্বে সক্রিয় করা আবশ্যক -
typeXR_TYPE_LIGHT_ESTIMATE_ANDROIDহতে হবে -
nextঅবশ্যইNULLবা একটি স্ট্রাকচার চেইনের পরবর্তী কাঠামোর জন্য একটি বৈধ পয়েন্টার হতে হবে। আরও দেখুন: XrAmbientLightANDROID , XrDirectionalLightANDROID , XrEnvironmentLightingCubemapANDROID , XrSphericalHarmonicsANDROID -
stateঅবশ্যই একটি বৈধ XrLightEstimateStateANDROID মান হতে হবে
XrEnvironmentLightingCubemapANDROID কাঠামোতে দৃশ্যের পরিবেশের আলো সম্পর্কে একটি কিউবম্যাপ বিন্যাসে আলোর অনুমান ডেটা রয়েছে।
typedef struct XrEnvironmentLightingCubemapANDROID {
XrStructureType type;
void* next;
XrLightEstimateStateANDROID state;
const float* cubemapRightImage;
const float* cubemapLeftImage;
const float* cubemapTopImage;
const float* cubemapBottomImage;
const float* cubemapFrontImage;
const float* cubemapBackImage;
uint32_t resolution;
XrQuaternionf rotation;
XrTime centerExposureTime;
} XrEnvironmentLightingCubemapANDROID;
সদস্য বিবরণ
-
typeহল এই কাঠামোর XrStructureType । -
nextহলNULLবা একটি স্ট্রাকচার চেইনের পরবর্তী কাঠামোর একটি পয়েন্টার। বৈধ কাঠামোগুলি হল XrSphericalHarmonicsANDROID , XrAmbientLightANDROID , এবং XrDirectionalLightANDROID ৷ -
stateহল XrLightEstimateStateANDROID আলোর অনুমানের অবস্থার প্রতিনিধিত্ব করে৷ -
cubemapRightImageহল একটিfloat*যা কিউবম্যাপের ডান দিকের R32G32B32_SFLOAT বাফারকে প্রতিনিধিত্ব করে। মনে রাখবেন এটি HDR তাই ফ্লোটের মান 1.0-এর বেশি হতে পারে। -
cubemapLeftImageহল একটিfloat*যা কিউবম্যাপের বাম দিকের R32G32B32_SFLOAT বাফারকে প্রতিনিধিত্ব করে। মনে রাখবেন এটি HDR তাই ফ্লোটের মান 1.0-এর বেশি হতে পারে। -
cubemapTopImageহল একটিfloat*যা কিউবম্যাপের উপরের দিকের R32G32B32_SFLOAT বাফারের প্রতিনিধিত্ব করে। মনে রাখবেন এটি HDR তাই ফ্লোটের মান 1.0-এর বেশি হতে পারে। -
cubemapBottomImageহল একটিfloat*যা কিউবম্যাপের নিচের দিকের R32G32B32_SFLOAT বাফারকে প্রতিনিধিত্ব করে। মনে রাখবেন এটি HDR তাই ফ্লোটের মান 1.0-এর বেশি হতে পারে। -
cubemapFrontImageহল একটিfloat*যা কিউবম্যাপের সামনের দিকের R32G32B32_SFLOAT বাফারকে প্রতিনিধিত্ব করে। মনে রাখবেন এটি HDR তাই ফ্লোটের মান 1.0-এর বেশি হতে পারে। -
resolutionহল একটিuint32_tকিউবম্যাপের প্রতিটি পাশের চিত্রের প্রস্থ এবং উচ্চতাকে প্রতিনিধিত্ব করে। -
rotationহল একটি XrQuaternionf যা কিউবম্যাপের ঘূর্ণনকে প্রতিনিধিত্ব করে। -
centerExposureTimeহল একটিXrTimeযা কিউবম্যাপ ক্যাপচার করার সময়কে প্রতিনিধিত্ব করে। কিউবম্যাপের মধ্যে ইন্টারপোলেশনের জন্য দরকারী।
বৈধ ব্যবহার (অন্তর্নিহিত)
-
XR_ANDROID_light_estimationএক্সটেনশনটি XrEnvironmentLightingCubemapANDROID ব্যবহার করার পূর্বে সক্রিয় করা আবশ্যক -
typeXR_TYPE_ENVIRONMENT_LIGHTING_CUBEMAP_ANDROIDহতে হবে -
nextঅবশ্যইNULLবা একটি কাঠামোর চেইনের পরবর্তী কাঠামোর জন্য একটি বৈধ পয়েন্টার হতে হবে -
stateঅবশ্যই একটি বৈধ XrLightEstimateStateANDROID মান হতে হবে -
cubemapRightImageঅবশ্যই একটি বৈধ ফ্লোট মান নির্দেশক হতে হবে -
cubemapLeftImageঅবশ্যই একটি বৈধ ফ্লোট মান নির্দেশক হতে হবে -
cubemapTopImageঅবশ্যই একটি বৈধ ফ্লোট মান নির্দেশক হতে হবে -
cubemapBottomImageঅবশ্যই একটি বৈধ ফ্লোট মান নির্দেশক হতে হবে -
cubemapFrontImageঅবশ্যই একটি বৈধ ফ্লোট মান নির্দেশক হতে হবে -
cubemapBackImageঅবশ্যই একটি বৈধ ফ্লোট মান নির্দেশক হতে হবে
XrAmbientLightANDROID কাঠামোতে দৃশ্যের পরিবেষ্টিত আলো সম্পর্কে হালকা অনুমান ডেটা রয়েছে৷
typedef struct XrAmbientLightANDROID {
XrStructureType type;
void* next;
XrLightEstimateStateANDROID state;
XrVector3f intensity;
XrVector3f colorCorrection;
} XrAmbientLightANDROID;
সদস্য বিবরণ
-
typeহল এই কাঠামোর XrStructureType । -
nextহলNULLবা একটি স্ট্রাকচার চেইনের পরবর্তী কাঠামোর একটি পয়েন্টার। বৈধ কাঠামোগুলি হল XrSphericalHarmonicsANDROID , XrEnvironmentLightingCubemapANDROID , এবং XrDirectionalLightANDROID ৷ -
stateহল XrLightEstimateStateANDROID আলোর অনুমানের অবস্থার প্রতিনিধিত্ব করে৷ -
intensityহল একটিXrVector3যা পরিবেষ্টিত আলোর তীব্রতাকে প্রতিনিধিত্ব করে। ভেক্টরের প্রতিটি উপাদান লাল, সবুজ এবং নীল চ্যানেলের সাথে মিলে যায়। -
colorCorrectionহল একটিXrVector3যার মান গামা স্পেসে রয়েছে। এই মানগুলির সাথে আপনার গামার সংশোধিত রেন্ডারের রঙকে উপাদান অনুসারে গুণ করুন।
বৈধ ব্যবহার (অন্তর্নিহিত)
- XrAmbientLightANDROID ব্যবহার করার পূর্বে
XR_ANDROID_light_estimationএক্সটেনশন অবশ্যই সক্রিয় করা উচিত -
typeXR_TYPE_AMBIENT_LIGHT_ANDROIDহতে হবে -
nextঅবশ্যইNULLবা একটি কাঠামোর চেইনের পরবর্তী কাঠামোর জন্য একটি বৈধ পয়েন্টার হতে হবে -
stateঅবশ্যই একটি বৈধ XrLightEstimateStateANDROID মান হতে হবে
XrSphericalHarmonicsANDROID স্ট্রাকচারে গোলক হারমোনিক্স রয়েছে যা দৃশ্যের আলোকে উপস্থাপন করে।
typedef struct XrSphericalHarmonicsANDROID {
XrStructureType type;
void* next;
XrLightEstimateStateANDROID state;
XrSphericalHarmonicsKindANDROID kind;
float coefficients[9][3];
} XrSphericalHarmonicsANDROID;
সদস্য বিবরণ
-
typeহল এই কাঠামোর XrStructureType । -
nextহলNULLবা একটি স্ট্রাকচার চেইনের পরবর্তী কাঠামোর একটি পয়েন্টার। বৈধ কাঠামোগুলি হল XrAmbientLightANDROID , XrEnvironmentLightingCubemapANDROID , এবং XrDirectionalLightANDROID ৷ -
stateহল XrLightEstimateStateANDROID আলোর অনুমানের অবস্থার প্রতিনিধিত্ব করে৷ -
kindহল XrSphericalHarmonicsKindANDROID অ্যাপ্লিকেশন দ্বারা অনুরোধ করা হয়েছে৷ -
coefficientsহল একটি দ্বি-মাত্রিকfloatঅ্যারে যার মাত্রা 9 সারি এবং 3টি কলাম। 3টি কলাম যথাক্রমে লাল, সবুজ এবং নীল রঙের চ্যানেলের সাথে সম্পর্কিত। প্রতিটি চ্যানেলে 9টি গোলাকার হারমোনিক সহগ রয়েছে।
বৈধ ব্যবহার (অন্তর্নিহিত)
-
XR_ANDROID_light_estimationএক্সটেনশনটি XrSphericalHarmonicsANDROID ব্যবহার করার আগে সক্রিয় করা আবশ্যক -
typeXR_TYPE_SPHERICAL_HARMONICS_ANDROIDহতে হবে -
nextঅবশ্যইNULLবা একটি কাঠামোর চেইনের পরবর্তী কাঠামোর জন্য একটি বৈধ পয়েন্টার হতে হবে -
stateঅবশ্যই একটি বৈধ XrLightEstimateStateANDROID মান হতে হবে -
kindএকটি বৈধ XrSphericalHarmonicsKindANDROID মান হতে হবে
XrDirectionalLightANDROID গঠনে হালকা অনুমান ডেটা রয়েছে৷
typedef struct XrDirectionalLightANDROID {
XrStructureType type;
void* next;
XrLightEstimateStateANDROID state;
XrVector3f intensity;
XrVector3f direction;
} XrDirectionalLightANDROID;
সদস্য বিবরণ
-
typeহল এই কাঠামোর XrStructureType । -
nextহলNULLবা একটি স্ট্রাকচার চেইনের পরবর্তী কাঠামোর একটি পয়েন্টার। বৈধ কাঠামোগুলি হল XrAmbientLightANDROID , XrSphericalHarmonicsANDROID এবং XrDirectionalLightANDROID ৷ -
stateহল XrLightEstimateStateANDROID আলোর অনুমানের অবস্থার প্রতিনিধিত্ব করে৷ -
intensityহল একটিXrVector3যা নির্দেশক আলোর তীব্রতাকে প্রতিনিধিত্ব করে। ভেক্টরের প্রতিটি উপাদান লাল, সবুজ এবং নীল চ্যানেলের সাথে মিলে যায়। -
directionহল একটিXrVector3আলোর দিক নির্দেশ করে।
বৈধ ব্যবহার (অন্তর্নিহিত)
-
XR_ANDROID_light_estimationএক্সটেনশনটি অবশ্যই XrDirectionalLightANDROID ব্যবহার করার আগে সক্রিয় করতে হবে -
typeXR_TYPE_DIRECTIONAL_LIGHT_ANDROIDহতে হবে -
nextঅবশ্যইNULLবা একটি কাঠামোর চেইনের পরবর্তী কাঠামোর জন্য একটি বৈধ পয়েন্টার হতে হবে -
stateঅবশ্যই একটি বৈধ XrLightEstimateStateANDROID মান হতে হবে
XrSphericalHarmonicsKindANDROID গণনা রানটাইমকে শনাক্ত করে, অ্যাপ্লিকেশনটি কী ধরনের গোলাকার হারমোনিক্সের জন্য অনুরোধ করছে।
typedef enum XrSphericalHarmonicsKindANDROID {
XR_SPHERICAL_HARMONICS_KIND_TOTAL_ANDROID = 0,
XR_SPHERICAL_HARMONICS_KIND_AMBIENT_ANDROID = 1
} XrSphericalHarmonicsKindANDROID;
enums নিম্নলিখিত অর্থ আছে:
এনাম | বর্ণনা |
| গোলাকার সুরেলা সহগ পরিবেশ আলোর দীপ্তি ফাংশন প্রতিনিধিত্ব করে, প্রধান আলোর অবদান সহ। |
| গোলাকার সুরেলা সহগগুলি প্রধান আলো থেকে অবদান বাদ দিয়ে পরিবেশের আলোর দীপ্তি ফাংশনকে উপস্থাপন করে। |
XrLightEstimateStateANDROID গণনা রানটাইমকে শনাক্ত করে, অ্যাপ্লিকেশনটি কী ধরনের গোলাকার হারমোনিক্সের জন্য অনুরোধ করছে।
typedef enum XrLightEstimateStateANDROID {
XR_LIGHT_ESTIMATE_STATE_VALID_ANDROID = 0,
XR_LIGHT_ESTIMATE_STATE_INVALID_ANDROID = 1
} XrLightEstimateStateANDROID;
enums নিম্নলিখিত অর্থ আছে:
এনাম | বর্ণনা |
| হালকা অনুমান বৈধ |
| আলো অনুমান অবৈধ |
হালকা অনুমানের জন্য উদাহরণ কোড
নিম্নলিখিত উদাহরণ কোডটি দেখায় কিভাবে রানটাইম থেকে সমস্ত সম্ভাব্য আলো অনুমান পরিমাণ পেতে হয়।
XrSession session; // Created at app startup
XrSpace appSpace; // Created previously.
XrLightEstimatorANDROID estimator;
XrLightEstimatorCreateInfoANDROID createInfo = {
.type = XR_TYPE_LIGHT_ESTIMATOR_CREATE_INFO_ANDROID};
CHK_XR(xrCreateLightEstimatorANDROID(session, &createInfo, &estimator));
// Every frame
XrTime updateTime; // Time used for the current frame's simulation update.
XrLightEstimateGetInfoANDROID info = {
.type = XR_TYPE_LIGHT_ESTIMATE_GET_INFO_ANDROID,
.space = appSpace,
.time = updateTime,
};
XrDirectionalLightANDROID directionalLight = {
.type = XR_TYPE_DIRECTIONAL_LIGHT_ANDROID,
};
XrSphericalHarmonicsANDROID totalSh = {
.type = XR_TYPE_SPHERICAL_HARMONICS_ANDROID,
.kind = XR_SPHERICAL_HARMONICS_KIND_TOTAL_ANDROID,
.next = &directionalLight,
};
XrSphericalHarmonicsANDROID ambientSh = {
.type = XR_TYPE_SPHERICAL_HARMONICS_ANDROID,
.kind = XR_SPHERICAL_HARMONICS_KIND_AMBIENT_ANDROID,
.next = &totalSh,
};
XrAmbientLightANDROID ambientLight = {
.type = XR_TYPE_AMBIENT_LIGHT_ANDROID,
.next = &ambientSh,
};
XrEnvironmentLightingCubemapANDROID lightingCubemap {
.type = XR_TYPE_ENVIRONMENT_LIGHTING_CUBEMAP_ANDROID,
.next = &ambientLight,
}
XrLightEstimateANDROID estimate = {
.type = XR_TYPE_LIGHT_ESTIMATE_ANDROID,
.next = &lightingCubemap,
};
XrResult result = xrGetLightEstimateANDROID(estimator, &info, &estimate);
if (result == XR_SUCCESS &&
estimate.state == XR_LIGHT_ESTIMATE_STATE_VALID_ANDROID) {
// use directionalLight, totalSh, ambientSh, ambientLight,
// lightingCubemap, if each
// struct has a valid state field
}
// When you want to disable light estimation
CHK_XR(xrDestroyLightEstimatorANDROID(estimator));
নতুন অবজেক্ট টাইপ
-
XrLightEstimator
XrObjectType গণনা এর সাথে প্রসারিত করা হয়েছে:
-
XR_OBJECT_TYPE_LIGHT_ESTIMATOR_ANDROID
XrStructureType গণনা এর সাথে প্রসারিত করা হয়েছে:
-
XR_TYPE_LIGHT_ESTIMATOR_CREATE_INFO_ANDROID -
XR_TYPE_LIGHT_ESTIMATE_GET_INFO_ANDROID -
XR_TYPE_LIGHT_ESTIMATE_ANDROID -
XR_TYPE_DIRECTIONAL_LIGHT_ANDROID -
XR_TYPE_SPHERICAL_HARMONICS_ANDROID -
XR_TYPE_AMBIENT_LIGHT_ANDROID -
XR_TYPE_ENVIRONMENT_LIGHTING_CUBEMAP_ANDROID
নতুন Enums
নতুন কাঠামো
- XrLightEstimatorCreateInfoANDROID
- XrLightEstimateGetInfoANDROID
- XrLightEstimateANDROID
- XrDirectionalLightANDROID
- XrSphericalHarmonicsANDROID
- XrAmbientLightANDROID
- XrSystemLightEstimation PropertiesANDROID
- XrEnvironmentLightingCubmapANDROID
নতুন ফাংশন
ইস্যু
সংস্করণ ইতিহাস
- রিভিশন 2, 2025-01-17 (সালার খান)
- এনভায়রনমেন্ট লাইটিং কিউবম্যাপ সমর্থন যোগ করা হয়েছে
- রিভিশন 1, 2024-09-16 (কেয়ার্ন ওভারটার্ফ)
- প্রাথমিক এক্সটেনশন বর্ণনা
OpenXR™ এবং OpenXR লোগো হল The Khronos Group Inc. এর মালিকানাধীন ট্রেডমার্ক এবং চীন, ইউরোপীয় ইউনিয়ন, জাপান এবং যুক্তরাজ্যে ট্রেডমার্ক হিসেবে নিবন্ধিত।