নাম স্ট্রিং
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 ব্যবহার করার আগে অবশ্যই সক্রিয় করা উচিত
-
type
XR_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 ব্যবহার করার পূর্বে সক্রিয় করা আবশ্যক -
type
XR_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 ব্যবহার করার পূর্বে সক্রিয় করা আবশ্যক -
type
XR_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 ব্যবহার করার পূর্বে সক্রিয় করা আবশ্যক -
type
XR_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
কিউবম্যাপের প্রতিটি পাশের চিত্রের প্রস্থ এবং উচ্চতাকে প্রতিনিধিত্ব করে। মনে রাখবেন এটি HDR তাই ফ্লোটের মান 1.0-এর বেশি হতে পারে। -
rotation
হল একটি XrQuaternionf যা কিউবম্যাপের ঘূর্ণনকে প্রতিনিধিত্ব করে। -
centerExposureTime
হল একটিXrTime
যা কিউবম্যাপ ক্যাপচার করার সময়কে প্রতিনিধিত্ব করে। কিউবম্যাপের মধ্যে ইন্টারপোলেশনের জন্য দরকারী।
বৈধ ব্যবহার (অন্তর্নিহিত)
-
XR_ANDROID_light_estimation
এক্সটেনশনটি XrEnvironmentLightingCubemapANDROID ব্যবহার করার পূর্বে সক্রিয় করা আবশ্যক -
type
XR_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
এক্সটেনশন অবশ্যই সক্রিয় করা উচিত -
type
XR_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 ব্যবহার করার আগে সক্রিয় করা আবশ্যক -
type
XR_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 ব্যবহার করার আগে সক্রিয় করতে হবে -
type
XR_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 (কেয়ার্ন ওভারটার্ফ)
- প্রাথমিক এক্সটেনশন বর্ণনা