ওভারভিউ
rsForEach () ফাংশনটি একটি স্ক্রিপ্টের রুট কার্নেল চালু করতে ব্যবহার করা যেতে পারে।
অন্যান্য ফাংশনগুলি একটি কার্যকরী কার্নেলের আহ্বানের বৈশিষ্ট্যগুলি পেতে ব্যবহৃত হয়, যেমন মাত্রা এবং বর্তমান সূচকগুলি। এই ফাংশনগুলি আর্গুমেন্ট হিসাবে একটি rs_kernel_context নেয়।
সারসংক্ষেপ
| প্রকারভেদ | |
|---|---|
| rs_for_each_strategy_t | প্রস্তাবিত সেল প্রক্রিয়াকরণ আদেশ |
| rs_kernel | একটি কার্নেল ফাংশন হ্যান্ডেল |
| rs_kernel_context | একটি কার্নেল আহ্বান প্রসঙ্গে হ্যান্ডেল |
| rs_script_call_t | কোষ পুনরাবৃত্তি তথ্য |
| ফাংশন | |
|---|---|
| rsForEach | একটি কার্নেল চালু করে |
| rsForEachInternal | (অভ্যন্তরীণ API) বর্তমান স্ক্রিপ্টে একটি কার্নেল চালু করুন (স্লট নম্বর সহ) |
| rsForEachWithOptions | অপশন সহ একটি কার্নেল চালু করে |
| rsGetArray0 | নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Array0 মাত্রায় সূচক |
| rsGetArray1 | নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Array1 মাত্রায় সূচক |
| rsGetArray2 | নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Array2 মাত্রায় সূচক |
| rsGetArray3 | নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Array3 মাত্রায় সূচক |
| rsGetDimArray0 | নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Array0 মাত্রার আকার |
| rsGetDimArray1 | নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Array1 মাত্রার আকার |
| rsGetDimArray2 | নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Array2 মাত্রার আকার |
| rsGetDimArray3 | নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Array3 মাত্রার আকার |
| rsGetDimHasFaces | নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য একাধিক মুখের উপস্থিতি |
| rsGetDimLod | নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য বিস্তারিত স্তরের সংখ্যা |
| rsGetDimX | নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য X মাত্রার আকার |
| rsGetDimY | নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Y মাত্রার আকার |
| rsGetDimZ | নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Z মাত্রার আকার |
| rsGetFace | নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য মুখের স্থানাঙ্ক |
| rsGetLod | সুনির্দিষ্ট কার্নেল প্রসঙ্গের জন্য বিস্তারিত মাত্রার স্তরে সূচক |
প্রকারভেদ
rs_for_each_strategy_t : প্রস্তাবিত সেল প্রসেসিং অর্ডার
নিম্নলিখিত মান সহ একটি enum:
| RS_FOR_EACH_STRATEGY_SERIAL = 0 | সংলগ্ন মেমরি অঞ্চল পছন্দ করুন। |
|---|---|
| RS_FOR_EACH_STRATEGY_DONT_CARE = 1 | কোনো পছন্দ নেই। |
| RS_FOR_EACH_STRATEGY_DST_LINEAR = 2 | ডিএসটি পছন্দ করুন। |
| RS_FOR_EACH_STRATEGY_TILE_SMALL = 3 | ছোট আয়তক্ষেত্রাকার অঞ্চল প্রক্রিয়াকরণ পছন্দ করুন। |
| RS_FOR_EACH_STRATEGY_TILE_MEDIUM = 4 | প্রক্রিয়াকরণ মাঝারি আয়তক্ষেত্রাকার অঞ্চল পছন্দ. |
| RS_FOR_EACH_STRATEGY_TILE_LARGE = 5 | বড় আয়তক্ষেত্রাকার অঞ্চল প্রক্রিয়াকরণ পছন্দ করুন। |
এই প্রকারটি প্রস্তাব করার জন্য ব্যবহার করা হয় যে কীভাবে আমন্ত্রিত কার্নেলটি বরাদ্দের কোষগুলির উপর পুনরাবৃত্তি করা উচিত। এই শুধুমাত্র একটি ইঙ্গিত. বাস্তবায়ন পরামর্শ অনুসরণ নাও হতে পারে.
এই স্পেসিফিকেশনটি চলমান কার্নেলের ক্যাশিং আচরণে সাহায্য করতে পারে, যেমন ক্যাশে লোকেলিটি যখন প্রক্রিয়াকরণ একাধিক কোরে বিতরণ করা হয়।
rs_kernel : একটি কার্নেল ফাংশন হ্যান্ডেল
API স্তর 24 এ যোগ করা হয়েছে এর একটি টাইপডেফ: void*
কার্নেল অ্যাট্রিবিউট দিয়ে সংজ্ঞায়িত একটি ফাংশনের জন্য একটি অস্বচ্ছ প্রকার। এই ধরনের একটি মান একটি কার্নেল চালু করতে rsForEach কলে ব্যবহার করা যেতে পারে।
rs_kernel_context : একটি কার্নেল আমন্ত্রণ প্রসঙ্গে হ্যান্ডেল করুন
এর একটি typedef: const struct rs_kernel_context_t * API লেভেল 23 এ যোগ করা হয়েছে
কার্নেল প্রেক্ষাপটে বরাদ্দের সাধারণ বৈশিষ্ট্য রয়েছে, যেমন মাত্রার উপর পুনরাবৃত্তি করা হচ্ছে। এটিতে বর্তমানে প্রক্রিয়াকৃত কক্ষের খুব কমই ব্যবহৃত সূচক রয়েছে, যেমন Array0 সূচক বা বর্তমান বিশদ স্তর।
আপনি আপনার কার্নেল ফাংশনে rs_kernel_context টাইপের "context" নামের একটি বিশেষ প্যারামিটার যোগ করে কার্নেল প্রসঙ্গ অ্যাক্সেস করতে পারেন। উদাহরণের জন্য rsGetDimX () এবং rsGetArray0 () দেখুন।
rs_script_call_t : সেল পুনরাবৃত্তির তথ্য
নিম্নলিখিত ক্ষেত্র সহ একটি কাঠামো:
| rs_for_each_strategy_t কৌশল | বর্তমানে উপেক্ষা করা হয়েছে। ভবিষ্যতে, সেল পুনরাবৃত্তি কৌশল প্রস্তাবিত হবে. |
|---|---|
| uint32_t xStart | X মাত্রায় সূচী শুরু হচ্ছে। |
| uint32_t xEnd | X মাত্রায় সমাপ্তি সূচক (একচেটিয়া)। |
| uint32_t yStart | Y মাত্রায় সূচনা সূচী। |
| uint32_t yEnd | Y মাত্রায় সমাপ্তি সূচক (একচেটিয়া)। |
| uint32_t zStart | Z মাত্রায় সূচনা শুরু হচ্ছে। |
| uint32_t zEnd | Z মাত্রায় সমাপ্তি সূচক (একচেটিয়া)। |
| uint32_t অ্যারেস্টার্ট | Array0 মাত্রায় সূচী শুরু হচ্ছে। |
| uint32_t অ্যারেএন্ড | Array0 মাত্রায় সমাপ্তি সূচক (একচেটিয়া)। |
| uint32_t অ্যারে1 শুরু করুন | Array1 মাত্রায় সূচী শুরু হচ্ছে। |
| uint32_t অ্যারে 1 শেষ | Array1 মাত্রায় সমাপ্তি সূচক (একচেটিয়া)। |
| uint32_t array2Start | Array2 মাত্রায় সূচী শুরু হচ্ছে। |
| uint32_t array2End | Array2 মাত্রায় সমাপ্তি সূচক (একচেটিয়া)। |
| uint32_t array3Start | Array3 মাত্রায় সূচী শুরু হচ্ছে। |
| uint32_t অ্যারে3এন্ড | Array3 মাত্রায় সমাপ্তি সূচক (একচেটিয়া)। |
এই কাঠামোটি একটি rsForEach কলে পুনরাবৃত্তির তথ্য প্রদান করতে ব্যবহৃত হয়। এটি বর্তমানে কোষের একটি উপসেটে প্রক্রিয়াকরণ সীমাবদ্ধ করতে ব্যবহৃত হয়। ভবিষ্যত সংস্করণগুলিতে, এটি কোষগুলির উপর কীভাবে সর্বোত্তম পুনরাবৃত্তি করা যায় তার ইঙ্গিত প্রদান করতেও ব্যবহার করা হবে।
শুরুর ক্ষেত্রগুলি অন্তর্ভুক্ত এবং শেষ ক্ষেত্রগুলি একচেটিয়া৷ যেমন X ডাইমেনশনে 4, 5, 6, এবং 7 কক্ষের উপর পুনরাবৃত্তি করতে, xStart 4 এবং xEnd-এ সেট করুন।
ফাংশন
rsForEach : একটি কার্নেল চালু করে
| void rsForEach( rs_kernel কার্নেল, ... ...); | API স্তর 24 এ যোগ করা হয়েছে |
| void rsForEach( rs_script স্ক্রিপ্ট, rs_allocation ইনপুট, rs_allocation আউটপুট); | API স্তর 14 - 23 |
| void rsForEach( rs_script স্ক্রিপ্ট, rs_allocation ইনপুট, rs_allocation আউটপুট, const void* usrData); | API স্তর 14 এবং উচ্চতর থেকে সরানো হয়েছে৷ |
| void rsForEach( rs_script স্ক্রিপ্ট, rs_allocation ইনপুট, rs_allocation আউটপুট, const void* usrData, const rs_script_call_t * sc); | API স্তর 14 এবং উচ্চতর থেকে সরানো হয়েছে৷ |
| void rsForEach( rs_script স্ক্রিপ্ট, rs_allocation ইনপুট, rs_allocation আউটপুট, const void* usrData, size_t usrDataLen); | API স্তর 14 - 20 |
| void rsForEach( rs_script স্ক্রিপ্ট, rs_allocation ইনপুট, rs_allocation আউটপুট, const void* usrData, size_t usrDataLen, const rs_script_call_t * sc); | API স্তর 14 - 20 |
পরামিতি
| লিপি | কল করার জন্য স্ক্রিপ্ট। |
|---|---|
| ইনপুট | থেকে উৎস তথ্য বরাদ্দ. |
| আউটপুট | তারিখ লিখতে বরাদ্দ. |
| usrData | স্ক্রিপ্টে পাস করার জন্য ব্যবহারকারীর সংজ্ঞায়িত ডেটা। NULL হতে পারে। |
| sc | প্রক্রিয়া করার জন্য বরাদ্দের একটি উপ-অঞ্চল নির্বাচন করতে বা হাঁটার কৌশল প্রস্তাব করতে ব্যবহৃত অতিরিক্ত নিয়ন্ত্রণ তথ্য। NULL হতে পারে। |
| usrDataLen | ব্যবহারকারীর ডেটা কাঠামোর আকার। এটি প্রয়োজনে ডেটার একটি অগভীর অনুলিপি সম্পাদন করতে ব্যবহার করা হবে। |
| কার্নেল | কার্নেল অ্যাট্রিবিউট দিয়ে সংজ্ঞায়িত একটি ফাংশনের ফাংশন ডিজিনেটর। |
| ... | ইনপুট এবং আউটপুট বরাদ্দ |
শূন্য বা তার বেশি ইনপুট বরাদ্দের উপরে কার্নেল চালায়। সেগুলি rs_kernel আর্গুমেন্টের পরে পাস করা হয়। যদি নির্দিষ্ট কার্নেল একটি মান প্রদান করে, একটি আউটপুট বরাদ্দ অবশ্যই শেষ আর্গুমেন্ট হিসাবে নির্দিষ্ট করতে হবে। সমস্ত ইনপুট বরাদ্দ, এবং আউটপুট বরাদ্দ যদি এটি বিদ্যমান থাকে তবে অবশ্যই একই মাত্রা থাকতে হবে।
এটি একটি সিঙ্ক্রোনাস ফাংশন। ইনপুট বরাদ্দের সমস্ত কক্ষের জন্য সমস্ত কাজ শেষ হওয়ার পরেই এই ফাংশনে একটি কল ফিরে আসে। যদি কার্নেল ফাংশন কোনো মান প্রদান করে, আউটপুট বরাদ্দে সমস্ত ফলাফল লেখা না হওয়া পর্যন্ত কলটি অপেক্ষা করে।
API লেভেল 23 পর্যন্ত, নির্দিষ্ট স্ক্রিপ্টে "root" নামের কার্নেল হিসাবে কার্নেলটি স্পষ্টভাবে নির্দিষ্ট করা হয় এবং শুধুমাত্র একটি ইনপুট বরাদ্দ ব্যবহার করা যেতে পারে। API স্তর 24 থেকে শুরু করে, একটি নির্বিচারে কার্নেল ফাংশন ব্যবহার করা যেতে পারে, যেমন কার্নেল আর্গুমেন্ট দ্বারা নির্দিষ্ট করা হয়েছে। স্ক্রিপ্ট যুক্তি সরানো হয়. কার্নেল বর্তমান স্ক্রিপ্টে সংজ্ঞায়িত করা আবশ্যক। এছাড়াও, একাধিক ইনপুট ব্যবহার করা যেতে পারে।
যেমন
float __attribute__((kernel)) square(float a) {
return a * a;
}
void compute(rs_allocation ain, rs_allocation aout) {
rsForEach(square, ain, aout);
}
rsForEachInternal : (অভ্যন্তরীণ API) বর্তমান স্ক্রিপ্টে একটি কার্নেল চালু করুন (স্লট নম্বর সহ)
| void rsForEachInternal(int স্লট, rs_script_call_t * বিকল্প, int hasOutput, int numInputs, rs_allocation * allocs); | API স্তর 24 এ যোগ করা হয়েছে |
পরামিতি
| স্লট | |
|---|---|
| বিকল্প | |
| আছে আউটপুট | কার্নেল আউটপুট তৈরি করে কিনা তা নির্দেশ করে |
| numInputs | ইনপুট বরাদ্দের সংখ্যা |
| allocs | ইনপুট এবং আউটপুট বরাদ্দ |
একটি কার্নেল চালু করতে অভ্যন্তরীণ API।
rsForEachWithOptions : বিকল্প সহ একটি কার্নেল চালু করে
| void rsForEachWithOptions( rs_kernel কার্নেল, rs_script_call_t * বিকল্প, ... ...); | API স্তর 24 এ যোগ করা হয়েছে |
পরামিতি
| কার্নেল | কার্নেল অ্যাট্রিবিউট দিয়ে সংজ্ঞায়িত একটি ফাংশনের ফাংশন ডিজিনেটর। |
|---|---|
| বিকল্প | অপশন চালু করুন |
| ... | ইনপুট এবং আউটপুট বরাদ্দ |
rsForEach এর অনুরূপভাবে কার্নেল চালু করে। যাইহোক, ইনপুটে সমস্ত কোষ প্রক্রিয়াকরণের পরিবর্তে, এই ফাংশনটি শুধুমাত্র বিকল্পগুলিতে নির্দিষ্ট সূচক স্থানের সাবস্পেসে কোষগুলিকে প্রক্রিয়া করে। অপশন দ্বারা সুস্পষ্টভাবে নির্দিষ্ট করা ইনডেক্স স্পেসের সাথে, এই API ব্যবহার করে কার্নেল লঞ্চের জন্য কোনো ইনপুট বা আউটপুট বরাদ্দের প্রয়োজন নেই। যদি বরাদ্দ করা হয়, তাহলে তাদের অবশ্যই আর্গুমেন্টের সংখ্যা এবং কার্নেল ফাংশন দ্বারা প্রত্যাশিত রিটার্ন মানের সাথে মেলে। আউটপুট বরাদ্দ উপস্থিত থাকে যদি এবং শুধুমাত্র যদি কার্নেলের একটি অ-অকার্যকর রিটার্ন মান থাকে।
যেমন,
rs_script_call_t opts = {0};
opts.xStart = 0;
opts.xEnd = dimX;
opts.yStart = 0;
opts.yEnd = dimY / 2;
rsForEachWithOptions(foo, &opts, out, out);
rsGetArray0 : নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Array0 মাত্রায় সূচক
| uint32_t rsGetArray0( rs_kernel_context প্রসঙ্গ); | API স্তর 23 এ যোগ করা হয়েছে |
সরবরাহকৃত কার্নেল প্রসঙ্গ দ্বারা নির্দিষ্ট করা হিসাবে প্রক্রিয়াজাত করা ঘরের Array0 মাত্রায় সূচী প্রদান করে।
কার্নেল প্রেক্ষাপটে অ্যারে0 সূচকের মতো বরাদ্দের পুনরাবৃত্তি এবং খুব কমই ব্যবহৃত সূচকগুলির সাধারণ বৈশিষ্ট্য রয়েছে।
আপনি আপনার কার্নেল ফাংশনে rs_kernel_context টাইপের "প্রসঙ্গ" নামের একটি বিশেষ প্যারামিটার যোগ করে কার্নেল প্রসঙ্গে অ্যাক্সেস করতে পারেন। যেমন
short RS_KERNEL myKernel(short value, uint32_t x, rs_kernel_context context) {
// The current index in the common x, y, z dimensions are accessed by
// adding these variables as arguments. For the more rarely used indices
// to the other dimensions, extract them from the kernel context:
uint32_t index_a0 = rsGetArray0(context);
//...
}
Array0 মাত্রা উপস্থিত না থাকলে এই ফাংশনটি 0 প্রদান করে।
rsGetArray1 : নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Array1 মাত্রায় সূচক
| uint32_t rsGetArray1( rs_kernel_context প্রসঙ্গ); | API স্তর 23 এ যোগ করা হয়েছে |
সরবরাহকৃত কার্নেল প্রসঙ্গ দ্বারা নির্দিষ্ট করা হিসাবে প্রক্রিয়াজাত করা ঘরের Array1 মাত্রায় সূচী প্রদান করে। প্রসঙ্গটির ব্যাখ্যার জন্য rsGetArray0 () দেখুন।
Array1 মাত্রা উপস্থিত না থাকলে 0 প্রদান করে।
rsGetArray2 : নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Array2 মাত্রায় সূচক
| uint32_t rsGetArray2( rs_kernel_context প্রসঙ্গ); | API স্তর 23 এ যোগ করা হয়েছে |
সরবরাহকৃত কার্নেল প্রসঙ্গ দ্বারা নির্দিষ্ট করা হিসাবে প্রক্রিয়াজাত করা কোষের Array2 মাত্রায় সূচী প্রদান করে। প্রসঙ্গটির ব্যাখ্যার জন্য rsGetArray0 () দেখুন।
Array2 মাত্রা উপস্থিত না থাকলে 0 প্রদান করে।
rsGetArray3 : নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Array3 মাত্রায় সূচক
| uint32_t rsGetArray3( rs_kernel_context প্রসঙ্গ); | API স্তর 23 এ যোগ করা হয়েছে |
সরবরাহকৃত কার্নেল প্রসঙ্গ দ্বারা নির্দিষ্ট করা হিসাবে প্রক্রিয়াজাত করা ঘরের Array3 মাত্রায় সূচী প্রদান করে। প্রসঙ্গটির ব্যাখ্যার জন্য rsGetArray0 () দেখুন।
Array3 মাত্রা উপস্থিত না থাকলে 0 প্রদান করে।
rsGetDimArray0 : নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Array0 মাত্রার আকার
| uint32_t rsGetDimArray0( rs_kernel_context প্রসঙ্গ); | API স্তর 23 এ যোগ করা হয়েছে |
নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Array0 মাত্রার আকার প্রদান করে। প্রসঙ্গটির ব্যাখ্যার জন্য rsGetDimX () দেখুন।
Array0 মাত্রা উপস্থিত না থাকলে 0 প্রদান করে।
rsGetDimArray1 : নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Array1 মাত্রার আকার
| uint32_t rsGetDimArray1( rs_kernel_context প্রসঙ্গ); | API স্তর 23 এ যোগ করা হয়েছে |
নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Array1 মাত্রার আকার প্রদান করে। প্রসঙ্গটির ব্যাখ্যার জন্য rsGetDimX () দেখুন।
Array1 মাত্রা উপস্থিত না থাকলে 0 প্রদান করে।
rsGetDimArray2 : নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Array2 মাত্রার আকার
| uint32_t rsGetDimArray2( rs_kernel_context প্রসঙ্গ); | API স্তর 23 এ যোগ করা হয়েছে |
নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Array2 মাত্রার আকার প্রদান করে। প্রসঙ্গটির ব্যাখ্যার জন্য rsGetDimX () দেখুন।
Array2 মাত্রা উপস্থিত না থাকলে 0 প্রদান করে।
rsGetDimArray3 : নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Array3 মাত্রার আকার
| uint32_t rsGetDimArray3( rs_kernel_context প্রসঙ্গ); | API স্তর 23 এ যোগ করা হয়েছে |
নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Array3 মাত্রার আকার প্রদান করে। প্রসঙ্গটির ব্যাখ্যার জন্য rsGetDimX () দেখুন।
Array3 মাত্রা উপস্থিত না থাকলে 0 প্রদান করে।
rsGetDimHasFaces : নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য একাধিক মুখের উপস্থিতি
| bool rsGetDimHasFaces( rs_kernel_context প্রসঙ্গ); | API স্তর 23 এ যোগ করা হয়েছে |
রিটার্নস
| একাধিক মুখ উপস্থিত থাকলে সত্য দেখায়, অন্যথায় মিথ্যা। |
যদি কার্নেল একটি কিউবম্যাপের উপর পুনরাবৃত্তি করে, যদি একাধিক মুখ উপস্থিত থাকে তবে এই ফাংশনটি সত্য হয়ে ওঠে। অন্য সব ক্ষেত্রে, এটা মিথ্যা ফেরত. প্রসঙ্গটির ব্যাখ্যার জন্য rsGetDimX () দেখুন।
rsAllocationGetDimFaces () অনুরূপ কিন্তু একটি bool এর পরিবর্তে 0 বা 1 প্রদান করে।
rsGetDimLod : নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য বিস্তারিত স্তরের সংখ্যা
| uint32_t rsGetDimLod( rs_kernel_context প্রসঙ্গ); | API স্তর 23 এ যোগ করা হয়েছে |
নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য বিস্তারিত স্তরের সংখ্যা প্রদান করে। এটি মিপম্যাপের জন্য দরকারী। প্রসঙ্গটির ব্যাখ্যার জন্য rsGetDimX () দেখুন।
বিশদ স্তর ব্যবহার না করা হলে 0 প্রদান করে।
rsAllocationGetDimLOD () একই রকম কিন্তু লেভেলের প্রকৃত সংখ্যার পরিবর্তে 0 বা 1 প্রদান করে।
rsGetDimX : নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য X মাত্রার আকার
| uint32_t rsGetDimX( rs_kernel_context প্রসঙ্গ); | API স্তর 23 এ যোগ করা হয়েছে |
নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য X মাত্রার আকার প্রদান করে।
কার্নেল প্রেক্ষাপটে অ্যারে0 সূচকের মতো বরাদ্দের পুনরাবৃত্তি এবং খুব কমই ব্যবহৃত সূচকগুলির সাধারণ বৈশিষ্ট্য রয়েছে।
আপনি আপনার কার্নেল ফাংশনে rs_kernel_context টাইপের "প্রসঙ্গ" নামের একটি বিশেষ প্যারামিটার যোগ করে এটি অ্যাক্সেস করতে পারেন। যেমন
int4 RS_KERNEL myKernel(int4 value, rs_kernel_context context) {
uint32_t size = rsGetDimX(context); //...
নির্দিষ্ট বরাদ্দের মাত্রা পেতে, rsAllocationGetDimX () ব্যবহার করুন।
rsGetDimY : নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Y মাত্রার আকার
| uint32_t rsGetDimY( rs_kernel_context প্রসঙ্গ); | API স্তর 23 এ যোগ করা হয়েছে |
নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য X মাত্রার আকার প্রদান করে। প্রসঙ্গটির ব্যাখ্যার জন্য rsGetDimX () দেখুন।
Y মাত্রা উপস্থিত না থাকলে 0 প্রদান করে।
নির্দিষ্ট বরাদ্দের মাত্রা পেতে, rsAllocationGetDimY () ব্যবহার করুন।
rsGetDimZ : নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Z মাত্রার আকার
| uint32_t rsGetDimZ( rs_kernel_context প্রসঙ্গ); | API স্তর 23 এ যোগ করা হয়েছে |
নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য Z মাত্রার আকার প্রদান করে। প্রসঙ্গটির ব্যাখ্যার জন্য rsGetDimX () দেখুন।
Z মাত্রা উপস্থিত না থাকলে 0 প্রদান করে।
নির্দিষ্ট বরাদ্দের মাত্রা পেতে, rsAllocationGetDimZ () ব্যবহার করুন।
rsGetFace : নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য মুখের স্থানাঙ্ক
| rs_allocation_cubemap_face rsGetFace( rs_kernel_context প্রসঙ্গ); | API স্তর 23 এ যোগ করা হয়েছে |
সরবরাহকৃত কার্নেল প্রসঙ্গ দ্বারা নির্দিষ্ট করা হিসাবে যে মুখের উপর প্রসেস করা সেলটি পাওয়া যায় তা ফেরত দেয়। প্রসঙ্গটির ব্যাখ্যার জন্য rsGetArray0 () দেখুন।
মুখের মাত্রা উপস্থিত না থাকলে RS_ALLOCATION_CUBEMAP_FACE_POSITIVE_X ফেরত দেয়।
rsGetLod : নির্দিষ্ট কার্নেল প্রসঙ্গের জন্য বিস্তারিত মাত্রার স্তরের সূচক
| uint32_t rsGetLod( rs_kernel_context প্রসঙ্গ); | API স্তর 23 এ যোগ করা হয়েছে |
সরবরাহকৃত কার্নেল প্রসঙ্গ দ্বারা নির্দিষ্ট করা হিসাবে প্রক্রিয়াজাত করা ঘরের বিশদ মাত্রার স্তরে সূচী প্রদান করে। প্রসঙ্গটির ব্যাখ্যার জন্য rsGetArray0 () দেখুন।
বিশদ মাত্রার মাত্রা উপস্থিত না থাকলে 0 প্রদান করে।