Hàm truy cập dữ liệu phân bổ RenderScript

Sao chép số lượng ô được chỉ định từ lần phân bổ này sang lần phân bổ khác.

Hai cơ cấu phân bổ phải khác nhau. Việc sử dụng hàm này để sao chép trong cùng một quy trình phân bổ sẽ dẫn đến kết quả không xác định.

Hàm không xác thực liệu số cộng bù trừ có vượt quá kích thước của một trong hai mức phân bổ hay không. Hãy cẩn trọng!

Hàm này chỉ được gọi giữa các lượt phân bổ 1D. Không xác định được việc gọi hàm này trên các lượt phân bổ khác.

Bạn không được gọi hàm này từ bên trong một hạt nhân hoặc từ bất kỳ hàm nào có thể được gọi trực tiếp hoặc gián tiếp từ một hạt nhân. Làm như vậy sẽ gây ra lỗi thời gian chạy.

Sao chép một vùng hình chữ nhật của ô từ lần phân bổ này sang lần phân bổ khác. Các ô (chiều rộng * chiều cao) đã được sao chép.

Hai cơ cấu phân bổ phải khác nhau. Việc sử dụng hàm này để sao chép trong cùng một quy trình phân bổ sẽ dẫn đến kết quả không xác định.

Hàm này không xác thực liệu khu vực nguồn hoặc khu vực đích có vượt quá kích thước của mức phân bổ tương ứng hay không. Hãy cẩn trọng!

Hàm này chỉ được gọi giữa các lần phân bổ 2D. Không xác định được việc gọi hàm này trên các lượt phân bổ khác.

Bạn không được gọi hàm này từ bên trong một hạt nhân hoặc từ bất kỳ hàm nào có thể được gọi trực tiếp hoặc gián tiếp từ một hạt nhân. Làm như vậy sẽ gây ra lỗi thời gian chạy.

Hàm này trả về một vectơ bao gồm các ô liên tiếp của lượt phân bổ. Phương pháp này giả định rằng phép phân bổ chứa các đại lượng vô hướng.

"X" trong tên cho biết các giá trị kế tiếp được trích xuất bằng cách tăng chỉ mục X. Hiện không có hàm nào để nhận các giá trị liên tiếp làm tăng các phương diện khác. Thay vào đó, hãy sử dụng nhiều lệnh gọi đến rsGetElementAt().

Ví dụ: khi gọi rsAllocationVLoadX_int4(a, 20, 30), một int4 bao gồm a[20, 30], a[21, 30], a[22, 30] và a[23, 30] sẽ được trả về.

Khi truy xuất từ mô hình phân bổ ba chiều, hãy sử dụng biến thể x, y, z. Tương tự, hãy sử dụng biến thể x, y cho phương thức phân bổ 2 phương diện và x cho phương thức phân bổ đơn phương diện.

Để tăng tính hiệu quả, hàm này không xác thực các dữ liệu đầu vào. Việc cố gắng bao bọc chỉ mục X, vượt quá kích thước của nội dung phân bổ hoặc sử dụng các chỉ mục không tương thích với chiều của quá trình phân bổ sẽ dẫn đến các kết quả không xác định.

Hãy xem thêm rsAllocationVStoreX().

Hàm này lưu trữ các mục nhập của một vectơ vào các ô liên tiếp của một lượt phân bổ. Phương pháp này giả định rằng phép phân bổ chứa các đại lượng vô hướng.

"X" trong tên cho biết các giá trị kế tiếp được lưu trữ bằng cách tăng chỉ mục X. Hiện không có hàm nào để lưu trữ giá trị liên tiếp tăng lên theo các phương diện khác. Thay vào đó, hãy sử dụng nhiều lệnh gọi đến rsSetElementAt().

Ví dụ: khi gọi rsAllocationVStoreX_int3(a, v, 20, 30), v.x được lưu trữ tại a[20, 30], v.y tại a[21, 30] và v.z tại a[22, 30].

Khi lưu trữ vào mô hình phân bổ ba chiều, hãy sử dụng biến thể x, y, z. Tương tự, hãy sử dụng biến thể x, y cho phương thức phân bổ 2 phương diện và x cho phương thức phân bổ đơn phương diện.

Để tăng tính hiệu quả, hàm này không xác thực các dữ liệu đầu vào. Việc cố gắng gói chỉ mục X, vượt quá kích thước của quy trình phân bổ hoặc sử dụng các chỉ mục không tương thích với kích thước của kết quả không xác định trong giá trị yiel phân bổ.

Xem thêm rsAllocationVLoadX().

Hàm này trích xuất một ô duy nhất từ mô hình phân bổ.

Khi truy xuất từ mô hình phân bổ ba chiều, hãy sử dụng biến thể x, y, z. Tương tự, hãy sử dụng biến thể x, y cho phương thức phân bổ 2 phương diện và x cho phương thức phân bổ đơn phương diện.

Hàm này có hai kiểu. Một kiểu trả về địa chỉ của giá trị bằng cách sử dụng void*, loại còn lại trả về giá trị thực tế, ví dụ: rsGetElementAt() so với rsGetElementAt_int4(). Đối với loại gốc, hãy luôn sử dụng loại thứ hai vì nó hiệu quả hơn.

Trích xuất thành phần U của một giá trị YUV duy nhất từ hoạt động phân bổ 2D của YUV.

Bên trong một mô hình phân bổ, các thành phần Y, U và V có thể được lưu trữ nếu các mặt phẳng và độ phân giải khác nhau. Các toạ độ x, y được cung cấp ở đây là kích thước của mặt phẳng Y.

Hãy xem rsGetElementAtYuv_uchar_Y().

Trích xuất thành phần V của một giá trị YUV duy nhất từ hoạt động phân bổ 2D của YUV.

Bên trong một mô hình phân bổ, các thành phần Y, U và V có thể được lưu trữ nếu các mặt phẳng và độ phân giải khác nhau. Các toạ độ x, y được cung cấp ở đây là kích thước của mặt phẳng Y.

Hãy xem rsGetElementAtYuv_uchar_Y().

Trích xuất thành phần Y của một giá trị YUV duy nhất từ hoạt động phân bổ 2D của YUV.

Bên trong một mô hình phân bổ, các thành phần Y, U và V có thể được lưu trữ nếu các mặt phẳng và độ phân giải khác nhau. Các toạ độ x, y được cung cấp ở đây là kích thước của mặt phẳng Y.

Hãy xem rsGetElementAtYuv_uchar_U() và rsGetElementAtYuv_uchar_V().

Tìm nạp một giá trị từ quá trình phân bổ kết cấu theo cách mà trình lấy mẫu mô tả.

Nếu mức phân bổ của bạn là 1D, hãy sử dụng biến thể có số thực cho vị trí. Đối với 2D, hãy sử dụng biến thể float2.

Hãy xem android.renderscript.Sampler để biết thêm thông tin chi tiết.

Hàm này lưu trữ giá trị vào một ô duy nhất của lượt phân bổ.

Khi lưu trữ vào mô hình phân bổ ba chiều, hãy sử dụng biến thể x, y, z. Tương tự, hãy sử dụng biến thể x, y cho phương thức phân bổ 2 phương diện và x cho phương thức phân bổ đơn phương.

Hàm này có hai kiểu. Một giá trị sẽ được lưu trữ bằng cách sử dụng khoảng trống*, giá trị còn lại có giá trị thực tế làm đối số, ví dụ: rsSetElementAt() so với rsSetElementAt_int4(). Đối với các loại nguyên gốc, hãy luôn sử dụng giá trị thứ hai vì nó hiệu quả hơn.

Xem thêm rsGetElementAt().