ฟังก์ชันและประเภทการเรียกใช้เคอร์เนลของ RenderScript

เรียกใช้เคอร์เนลกับการจองอินพุตตั้งแต่ 0 รายการขึ้นไป โดยระบบจะส่งอาร์กิวเมนต์เหล่านี้ต่อจากอาร์กิวเมนต์ rs_kernel หากเคอร์เนลที่ระบุแสดงผลค่า คุณต้องระบุการจัดสรรเอาต์พุตเป็นอาร์กิวเมนต์สุดท้าย การจัดสรรอินพุตทั้งหมดและการจัดสรรเอาต์พุต (หากมี) ต้องมีมิติข้อมูลเดียวกัน

นี่เป็นฟังก์ชันแบบซิงค์ การเรียกใช้ฟังก์ชันนี้จะแสดงผลหลังจากที่งานทั้งหมดเสร็จสมบูรณ์แล้วสำหรับเซลล์ทั้งหมดของการจัดสรรอินพุต หากฟังก์ชันเคอร์เนลแสดงผลค่าใดๆ การเรียกจะรอจนกว่าระบบจะเขียนผลลัพธ์ทั้งหมดไปยังการจัดสรรเอาต์พุต

จนถึง API ระดับ 23 ระบบจะระบุเคอร์เนลโดยนัยว่าเป็นเคอร์เนลที่มีชื่อว่า "root" ในสคริปต์ที่ระบุ และจะใช้การจัดสรรอินพุตได้เพียงรายการเดียว ตั้งแต่ API ระดับ 24 เป็นต้นไป คุณจะใช้ฟังก์ชัน Kernel ใดก็ได้ตามที่ระบุโดยอาร์กิวเมนต์ Kernel ระบบจะนำอาร์กิวเมนต์สคริปต์ออก โดยต้องกำหนดเคอร์เนลในสคริปต์ปัจจุบัน นอกจากนี้ คุณยังใช้อินพุตได้มากกว่า 1 รายการ

เช่น
float __attribute__((kernel)) square(float a) {
  return a * a;
}

void compute(rs_allocation ain, rs_allocation aout) {
  rsForEach(square, ain, aout);
}



API ภายในสำหรับเปิดใช้งานเคอร์เนล

เปิดใช้งานเคอร์เนลในลักษณะที่คล้ายกับ rsForEach อย่างไรก็ตาม ฟังก์ชันนี้จะประมวลผลเฉพาะเซลล์ในพาร์ทเนอร์ย่อยของพื้นที่อินเด็กซ์ที่ระบุไว้ในตัวเลือกแทนที่จะประมวลผลเซลล์ทั้งหมดในอินพุต เมื่อระบุพื้นที่ดัชนีอย่างชัดเจนด้วยตัวเลือก คุณไม่จําเป็นต้องจัดสรรอินพุตหรือเอาต์พุตสําหรับการเริ่มใช้งานเคอร์เนลโดยใช้ API นี้ หากมีการส่งการจัดสรร การจัดสรรต้องตรงกับจํานวนอาร์กิวเมนต์และค่าที่ฟังก์ชันเคอร์เนลคาดไว้ การจัดสรรเอาต์พุตจะแสดงอยู่ก็ต่อเมื่อเคอร์เนลมีค่าที่แสดงผลที่ไม่ใช่ void

เช่น
rs_script_call_t opts = {0};
opts.xStart = 0;
opts.xEnd = dimX;
opts.yStart = 0;
opts.yEnd = dimY / 2;
rsForEachWithOptions(foo, &opts, out, out);


ส่งคืนดัชนีในมิติข้อมูล Array0 ของเซลล์ที่ประมวลผล ตามที่ระบุโดยบริบทเคอร์เนลที่ระบุ

บริบทเคอร์เนลมีลักษณะทั่วไปของการจัดสรรที่วนซ้ำและอินเด็กซ์ที่ไม่ค่อยได้ใช้ เช่น อินเด็กซ์ Array0

คุณสามารถเข้าถึงบริบทเคอร์เนลได้โดยเพิ่มพารามิเตอร์พิเศษชื่อ "context" ประเภท 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);
  //...
}


ฟังก์ชันนี้จะแสดงผล 0 หากไม่มีมิติข้อมูล Array0

แสดงผลดัชนีในมิติข้อมูล Array1 ของเซลล์ที่ประมวลผล ตามที่ระบุโดยบริบทเคอร์เนลที่ระบุ ดูคำอธิบายบริบทได้ที่ rsGetArray0()

แสดงผล 0 หากไม่มีมิติข้อมูล Array1

แสดงผลดัชนีในมิติข้อมูล Array2 ของเซลล์ที่ประมวลผล ตามที่ระบุโดยบริบทเคอร์เนลที่ระบุ ดูคำอธิบายบริบทได้ที่ rsGetArray0()

แสดงผลเป็น 0 หากไม่มีมิติข้อมูล Array2

แสดงผลดัชนีในมิติข้อมูล Array3 ของเซลล์ที่ประมวลผล ตามที่ระบุโดยบริบทเคอร์เนลที่ระบุ ดูคำอธิบายบริบทได้ที่ rsGetArray0()

แสดงผลเป็น 0 หากไม่มีมิติข้อมูล Array3

แสดงผลขนาดของมิติข้อมูล Array0 สําหรับบริบทเคอร์เนลที่ระบุ ดูคําอธิบายบริบทได้ที่ rsGetDimX()

แสดงผลเป็น 0 หากไม่มีมิติข้อมูล Array0

แสดงผลขนาดของมิติข้อมูล Array1 สําหรับบริบทเคอร์เนลที่ระบุ ดูคําอธิบายบริบทได้ที่ rsGetDimX()

แสดงผล 0 หากไม่มีมิติข้อมูล Array1

แสดงผลขนาดของมิติข้อมูล Array2 สําหรับบริบทเคอร์เนลที่ระบุ ดูคําอธิบายบริบทได้ที่ rsGetDimX()

แสดงผลเป็น 0 หากไม่มีมิติข้อมูล Array2

แสดงผลขนาดของมิติข้อมูล Array3 สําหรับบริบทเคอร์เนลที่ระบุ ดูคําอธิบายบริบทได้ที่ rsGetDimX()

แสดงผลเป็น 0 หากไม่มีมิติข้อมูล Array3

หากเคอร์เนลกำลังวนซ้ำภาพลูกบาศก์ ฟังก์ชันนี้จะแสดงผลเป็น "จริง" หากมีมากกว่า 1 หน้า ในกรณีอื่นๆ ทั้งหมด ระบบจะแสดงผลเป็น "เท็จ" ดูคำอธิบายบริบทได้ที่ rsGetDimX()

rsAllocationGetDimFaces() คล้ายกัน แต่จะแสดงผลเป็น 0 หรือ 1 แทนบูลีน

แสดงผลจํานวนระดับรายละเอียดสําหรับบริบทเคอร์เนลที่ระบุ ซึ่งมีประโยชน์สำหรับ MIPMAP ดูคําอธิบายบริบทได้ที่ rsGetDimX()

แสดงผลเป็น 0 หากไม่ได้ใช้ระดับรายละเอียด

rsAllocationGetDimLOD() คล้ายกัน แต่จะแสดงผลเป็น 0 หรือ 1 แทนจำนวนระดับจริง

แสดงผลขนาดของมิติข้อมูล X สําหรับบริบทเคอร์เนลที่ระบุ

บริบทเคอร์เนลมีลักษณะทั่วไปของการจัดสรรที่วนซ้ำและอินเด็กซ์ที่ไม่ค่อยได้ใช้ เช่น อินเด็กซ์ Array0

คุณสามารถเข้าถึงได้โดยเพิ่มพารามิเตอร์พิเศษชื่อ "context" ประเภท rs_kernel_context ลงในฟังก์ชันเคอร์เนล เช่น
int4 RS_KERNEL myKernel(int4 value, rs_kernel_context context) {
  uint32_t size = rsGetDimX(context); //...


หากต้องการดูมิติข้อมูลของการกําหนดเฉพาะ ให้ใช้ rsAllocationGetDimX()

แสดงผลขนาดของมิติข้อมูล X สําหรับบริบทเคอร์เนลที่ระบุ ดูคําอธิบายบริบทได้ที่ rsGetDimX()

แสดงผลเป็น 0 หากไม่มีมิติข้อมูล Y

หากต้องการดูมิติข้อมูลของการจัดสรรที่เฉพาะเจาะจง ให้ใช้ rsAllocationGetDimY()

แสดงผลขนาดของมิติข้อมูล Z สําหรับบริบทเคอร์เนลที่ระบุ ดูคําอธิบายบริบทได้ที่ rsGetDimX()

แสดงผลเป็น 0 หากไม่มีมิติข้อมูล Z

หากต้องการดูมิติข้อมูลของการจัดสรรที่เฉพาะเจาะจง ให้ใช้ rsAllocationGetDimZ()

แสดงผลใบหน้าที่พบเซลล์ที่ประมวลผล ตามที่ระบุโดยบริบทเคอร์เนลที่ระบุ ดูคำอธิบายบริบทได้ที่ rsGetArray0()

แสดงผล RS_ALLOCATION_CUBEMAP_FACE_POSITIVE_X หากไม่มีมิติข้อมูลใบหน้า

แสดงผลดัชนีในมิติข้อมูลระดับรายละเอียดของเซลล์ที่ประมวลผล ตามที่ระบุโดยบริบทเคอร์เนลที่ระบุ ดูคำอธิบายบริบทได้ที่ rsGetArray0()

แสดงผลเป็น 0 หากไม่มีมิติข้อมูลระดับรายละเอียด