Fungsi dan Jenis Pemanggilan Kernel RenderScript

Menjalankan kernel pada nol atau beberapa alokasi input. Argumen tersebut diteruskan setelah argumen rs_kernel. Jika kernel yang ditentukan menampilkan sebuah nilai, alokasi output harus ditentukan sebagai argumen terakhir. Semua alokasi input, dan alokasi output, jika ada, harus memiliki dimensi yang sama.

Ini adalah fungsi sinkron. Panggilan ke fungsi ini hanya ditampilkan setelah semua pekerjaan selesai untuk semua sel alokasi input. Jika fungsi kernel menampilkan nilai apa pun, panggilan akan menunggu hingga semua hasil ditulis ke alokasi output.

Hingga API level 23, kernel secara implisit ditetapkan sebagai kernel yang bernama "root" dalam skrip yang ditentukan, dan hanya satu alokasi input yang dapat digunakan. Mulai API level 24, fungsi kernel arbitrer dapat digunakan, seperti yang ditetapkan oleh argumen kernel. Argumen skrip dihapus. Kernel harus ditetapkan dalam skrip saat ini. Selain itu, lebih dari satu input dapat digunakan.

Misalnya,
float __attribute__((kernel)) square(float a) {
  return a * a;
}

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



API internal untuk meluncurkan kernel.

Meluncurkan kernel dengan cara yang mirip dengan rsForEach. Namun, fungsi ini hanya memproses sel di subruang indeks yang ditentukan dalam opsi, bukan memproses semua sel dalam input. Dengan ruang indeks yang ditentukan secara eksplisit oleh opsi, tidak diperlukan alokasi input atau output untuk peluncuran kernel menggunakan API ini. Jika diteruskan, alokasi harus cocok dengan jumlah argumen dan nilai hasil yang diharapkan oleh fungsi kernel. Alokasi output ada jika dan hanya jika kernel memiliki nilai yang ditampilkan non-void.

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


Menampilkan indeks dalam dimensi Array0 dari sel yang sedang diproses, seperti yang ditentukan oleh konteks kernel yang disediakan.

Konteks kernel berisi karakteristik umum dari alokasi yang diiterasi dan indeks yang jarang digunakan, seperti indeks Array0.

Anda dapat mengakses konteks kernel dengan menambahkan parameter khusus bernama "context" dengan jenis rs_kernel_context ke fungsi kernel Anda. Misalnya,
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);
  //...
}


Fungsi ini mengembalikan 0 jika dimensi Array0 tidak ada.

Menampilkan indeks dalam dimensi Array1 dari sel yang sedang diproses, seperti yang ditentukan oleh konteks kernel yang disediakan. Lihat rsGetArray0() untuk mendapatkan penjelasan konteks.

Mengembalikan 0 jika dimensi Array1 tidak ada.

Menampilkan indeks dalam dimensi Array2 dari sel yang sedang diproses, seperti yang ditentukan oleh konteks kernel yang disediakan. Lihat rsGetArray0() untuk mendapatkan penjelasan konteks.

Mengembalikan 0 jika dimensi Array2 tidak ada.

Menampilkan indeks dalam dimensi Array3 dari sel yang sedang diproses, seperti yang ditentukan oleh konteks kernel yang disediakan. Lihat rsGetArray0() untuk mendapatkan penjelasan konteks.

Mengembalikan 0 jika dimensi Array3 tidak ada.

Menampilkan ukuran dimensi Array0 untuk konteks kernel yang ditentukan. Lihat rsGetDimX() untuk penjelasan konteks.

Mengembalikan 0 jika dimensi Array0 tidak ada.

Menampilkan ukuran dimensi Array1 untuk konteks kernel yang ditentukan. Lihat rsGetDimX() untuk penjelasan konteks.

Mengembalikan 0 jika dimensi Array1 tidak ada.

Menampilkan ukuran dimensi Array2 untuk konteks kernel yang ditentukan. Lihat rsGetDimX() untuk penjelasan konteks.

Mengembalikan 0 jika dimensi Array2 tidak ada.

Menampilkan ukuran dimensi Array3 untuk konteks kernel yang ditentukan. Lihat rsGetDimX() untuk penjelasan konteks.

Mengembalikan 0 jika dimensi Array3 tidak ada.

Jika kernel melakukan iterasi pada peta kubus, fungsi ini akan menampilkan nilai benar (true) jika ada lebih dari satu wajah. Dalam semua kasus lain, nilai salah (false) akan ditampilkan. Lihat rsGetDimX() untuk mendapatkan penjelasan konteks.

rsAllocationGetDimFaces() serupa, tetapi menampilkan 0 atau 1, bukan bool.

Menampilkan jumlah tingkat detail untuk konteks kernel yang ditentukan. Hal ini berguna untuk mipmap. Lihat rsGetDimX() untuk penjelasan konteks.

Mengembalikan 0 jika Level of Detail tidak digunakan.

rsAllocationGetDimLOD() serupa, tetapi menampilkan 0 atau 1 sebagai jumlah level sebenarnya.

Menampilkan ukuran dimensi X untuk konteks kernel yang ditentukan.

Konteks kernel berisi karakteristik umum dari alokasi yang diiterasi dan indeks yang jarang digunakan, seperti indeks Array0.

Anda dapat mengaksesnya dengan menambahkan parameter khusus bernama "context" dengan jenis rs_kernel_context ke fungsi kernel Anda. Misalnya,
int4 RS_KERNEL myKernel(int4 value, rs_kernel_context context) {
  uint32_t size = rsGetDimX(context); //...


Untuk mendapatkan dimensi alokasi spesifik, gunakan rsAllocationGetDimX().

Menampilkan ukuran dimensi X untuk konteks kernel yang ditentukan. Lihat rsGetDimX() untuk penjelasan konteks.

Mengembalikan 0 jika dimensi Y tidak ada.

Untuk mendapatkan dimensi alokasi spesifik, gunakan rsAllocationGetDimY().

Menampilkan ukuran dimensi Z untuk konteks kernel yang ditentukan. Lihat rsGetDimX() untuk penjelasan konteks.

Mengembalikan 0 jika dimensi Z tidak ada.

Untuk mendapatkan dimensi alokasi spesifik, gunakan rsAllocationGetDimZ().

Menampilkan wajah tempat sel yang sedang diproses ditemukan, seperti yang ditetapkan oleh konteks kernel yang disediakan. Lihat rsGetArray0() untuk mendapatkan penjelasan konteks.

Menampilkan RS_ALLOCATION_CUBEMAP_FACE_POSITIVE_X jika dimensi wajah tidak ada.

Menampilkan indeks dalam dimensi Tingkat Detail sel yang sedang diproses, seperti yang ditentukan oleh konteks kernel yang disediakan. Lihat rsGetArray0() untuk mendapatkan penjelasan tentang konteksnya.

Menampilkan 0 jika Tingkat dimensi Detail tidak ada.