Fungsi Akses Data Alokasi RenderScript

Menyalin jumlah sel yang ditentukan dari satu alokasi ke alokasi lainnya.

Kedua alokasi ini harus berbeda. Menggunakan fungsi ini untuk menyalin dalam alokasi yang sama akan memberikan hasil yang tidak ditentukan.

Fungsi ini tidak memvalidasi apakah jumlah plus offset melebihi ukuran salah satu alokasi. Hati-hati!

Fungsi ini hanya boleh dipanggil di antara alokasi 1D. Memanggilnya pada alokasi lain tidak ditentukan.

Fungsi ini tidak boleh dipanggil dari dalam kernel, atau dari fungsi apa pun yang dapat dipanggil langsung atau tidak langsung dari kernel. Tindakan ini akan menyebabkan error runtime.

Menyalin wilayah persegi panjang sel dari satu alokasi ke alokasi lain. (lebar * tinggi) sel disalin.

Kedua alokasi ini harus berbeda. Menggunakan fungsi ini untuk menyalin dalam alokasi yang sama akan memberikan hasil yang tidak ditentukan.

Fungsi tersebut tidak memvalidasi apakah region sumber atau tujuan melebihi ukuran alokasi masing-masing. Hati-hati!

Fungsi ini hanya boleh dipanggil di antara alokasi 2D. Memanggilnya pada alokasi lain tidak ditentukan.

Fungsi ini tidak boleh dipanggil dari dalam kernel, atau dari fungsi apa pun yang dapat dipanggil langsung atau tidak langsung dari kernel. Tindakan ini akan menyebabkan error runtime.

Fungsi ini menampilkan vektor yang terdiri dari sel alokasi yang berurutan. Diasumsikan bahwa alokasi berisi skalar.

Huruf "X" pada nama menunjukkan bahwa nilai berturut-turut diekstrak dengan meningkatkan indeks X. Saat ini tidak ada fungsi untuk mendapatkan nilai berturut-turut yang bertambah dengan dimensi lainnya. Sebagai gantinya, gunakan beberapa panggilan ke rsGetElementAt().

Misalnya, saat memanggil rsAllocationVLoadX_int4(a, 20, 30), int4 yang terdiri dari [20, 30], a[21, 30], a[22, 30], dan a[23, 30] akan ditampilkan.

Saat mengambil dari alokasi tiga dimensi, gunakan varian x, y, z. Demikian pula, gunakan varian x, y untuk alokasi dua dimensi dan x untuk alokasi dimensi mono.

Agar efisien, fungsi ini tidak memvalidasi input. Mencoba menggabungkan indeks X, melebihi ukuran alokasi, atau menggunakan indeks yang tidak kompatibel dengan dimensi alokasi akan memberikan hasil yang tidak ditentukan.

Lihat juga rsAllocationVStoreX().

Fungsi ini menyimpan entri vektor ke dalam sel alokasi yang berurutan. Diasumsikan bahwa alokasi berisi skalar.

Huruf "X" pada nama menunjukkan bahwa nilai berturut-turut disimpan dengan meningkatkan indeks X. Saat ini tidak ada fungsi untuk menyimpan nilai berturut-turut yang bertambah dimensi lainnya. Sebagai gantinya, gunakan beberapa panggilan ke rsSetElementAt().

Misalnya, saat memanggil rsAllocationVStoreX_int3(a, v, 20, 30), v.x disimpan di [20, 30], v.y di a[21, 30], dan v.z di [22, 30].

Saat menyimpan ke dalam alokasi tiga dimensi, gunakan varian x, y, z. Demikian pula, gunakan varian x, y untuk alokasi dua dimensi dan x untuk alokasi dimensi mono.

Agar efisien, fungsi ini tidak memvalidasi input. Mencoba menggabungkan indeks X, melebihi ukuran alokasi, atau menggunakan indeks yang tidak kompatibel dengan dimensi yiels alokasi menghasilkan hasil yang tidak ditentukan.

Lihat juga rsAllocationVLoadX().

Fungsi ini mengekstrak satu sel dari alokasi.

Saat mengambil dari alokasi tiga dimensi, gunakan varian x, y, z. Demikian pula, gunakan varian x, y untuk alokasi dua dimensi dan x untuk alokasi dimensi mono.

Fungsi ini memiliki dua gaya. Yang pertama menampilkan alamat nilai menggunakan void*, metode satunya menampilkan nilai sebenarnya, misalnya rsGetElementAt() vs. rsGetElementAt_int4(). Untuk jenis primitif, selalu gunakan nilai yang kedua karena lebih efisien.

Mengekstrak komponen U dari satu nilai YUV dari alokasi 2D YUV.

Di dalam alokasi, komponen Y, U, dan V dapat disimpan jika bidang yang berbeda dan pada resolusi yang berbeda. Koordinat x, y yang diberikan di sini berada dalam dimensi bidang Y.

Lihat rsGetElementAtYuv_uchar_Y().

Mengekstrak komponen V dari satu nilai YUV dari alokasi 2D YUV.

Di dalam alokasi, komponen Y, U, dan V dapat disimpan jika bidang yang berbeda dan pada resolusi yang berbeda. Koordinat x, y yang diberikan di sini berada dalam dimensi bidang Y.

Lihat rsGetElementAtYuv_uchar_Y().

Mengekstrak komponen Y dari satu nilai YUV dari alokasi 2D YUV.

Di dalam alokasi, komponen Y, U, dan V dapat disimpan jika bidang yang berbeda dan pada resolusi yang berbeda. Koordinat x, y yang diberikan di sini berada dalam dimensi bidang Y.

Lihat rsGetElementAtYuv_uchar_U() dan rsGetElementAtYuv_uchar_V().

Mengambil nilai dari alokasi tekstur dengan cara yang dijelaskan oleh sampler.

Jika alokasi Anda 1D, gunakan varian dengan float untuk lokasi. Untuk 2D, gunakan varian float2.

Lihat android.renderscript.Sampler untuk mengetahui detail selengkapnya.

Fungsi ini menyimpan nilai ke dalam satu sel alokasi.

Saat menyimpan ke dalam alokasi tiga dimensi, gunakan varian x, y, z. Demikian pula, gunakan varian x, y untuk alokasi dua dimensi dan x untuk alokasi dimensi mono.

Fungsi ini memiliki dua gaya. Salah satunya meneruskan nilai untuk disimpan menggunakan void*, yang satunya memiliki nilai aktual sebagai argumen, misalnya rsSetElementAt() vs. rsSetElementAt_int4(). Untuk jenis primitif, selalu gunakan nilai yang kedua karena lebih efisien.

Lihat juga rsGetElementAt().