RenderScript 分配資料存取函式

將指定數量的儲存格從某個分配範圍複製到另一個分配範圍。

兩者的分配必須不同。若使用這個函式在同一配置中複製，會產生未定義的結果。

此函式不會驗證偏移加計數是否超過任一配置的大小。請務必謹慎！

這個函式只能在 1D 分配之間呼叫。在其他配置上呼叫該函式未定義。

請勿從核心內部或任何可直接從核心或間接呼叫的函式呼叫此函式。這樣做會導致執行階段錯誤。

將儲存格的矩形區域從一個分配範圍複製到另一個分配範圍。系統隨即複製 (寬度 * 高度) 儲存格。

兩者的分配必須不同。若使用這個函式在同一配置中複製，會產生未定義的結果。

這個函式不會驗證來源或目的地區域是否超過其個別分配作業的大小。請務必謹慎！

這個函式只能在 2D 分配之間呼叫。在其他配置上呼叫該函式未定義。

請勿從核心內部或任何可直接從核心或間接呼叫的函式呼叫此函式。這樣做會導致執行階段錯誤。

這個函式會傳回由分配作業連續儲存格組成的向量。假設分配作業包含純量。

名稱中的「X」表示提高 X 索引擷取後續值。目前沒有函式可取得為其他維度遞增的連續值。請改用多次呼叫 rsGetElementAt()。

舉例來說，在呼叫 rsAllocationVLoadX_int4(a, 20, 30) 時，會傳回由 [20, 30]、a[21, 30]、a[22, 30] 和 a[23, 30] 組成的 int4。

從三維分配範圍中擷取時，請使用 x、y、z 變化版本。同樣地，針對雙維度配置，請使用 x、y 變化版本，針對單維度分配使用 x。

為提高效率，此函式不會驗證輸入內容。嘗試包裝 X 索引、超過分配大小，或使用與分配維度不相容的索引會產生未定義的結果。

另請參閱 rsAllocationVStoreX()。

這個函式會將向量項目儲存至分配的連續儲存格。假設分配作業包含純量。

名稱中的「X」表示透過增加 X 索引來儲存後續值。目前沒有函式可儲存遞增其他維度的連續值。請改用多次呼叫 rsSetElementAt()。

舉例來說，呼叫 rsAllocationVStoreX_int3(a, v, 20, 30) 時，v.x 會儲存在 [20, 30], v.y 以 [21, 30] 為 a [22, 30] 和 v.z。

將資料儲存為三個維度配置時，請使用 x、y 和 z 變化版本。同樣地，針對雙維度配置，請使用 x、y 變化版本，針對單維度分配使用 x。

為提高效率，此函式不會驗證輸入內容。嘗試包裝 X 索引、超過分配大小，或使用索引與分配 yiels 未定義結果的維度不相容。

另請參閱 rsAllocationVLoadX()

這個函式會擷取分配作業中的單一儲存格。

從三維分配範圍中擷取時，請使用 x、y、z 變化版本。同樣地，針對雙維度配置，請使用 x、y 變化版本，針對單維度分配使用 x。

這個函式有兩種樣式。其中一個會使用 void* 傳回該值的地址，另一個則會傳回實際值，例如 rsGetElementAt() 與 rsGetElementAt_int4()。 針對原始類型，請一律使用後者，因為前者的處理效率較高。

從 YUV 的 2D 分配圖擷取單一 YUV 值的 U 元件。

如果不同平面及不同解析度，就可以儲存配置中的 Y、U 和 V 元件。這裡提供的 x 和 y 座標是 Y 平面的維度。

請參閱 rsGetElementAtYuv_uchar_Y()。

從 YUV 的 2D 分配圖擷取單一 YUV 值的 V 元件。

如果不同平面及不同解析度，就可以儲存配置中的 Y、U 和 V 元件。這裡提供的 x 和 y 座標是 Y 平面的維度。

請參閱 rsGetElementAtYuv_uchar_Y()。

從 YUV 的 2D 分配圖擷取單一 YUV 值的 Y 元件。

如果不同平面及不同解析度，就可以儲存配置中的 Y、U 和 V 元件。這裡提供的 x 和 y 座標是 Y 平面的維度。

請參閱 rsGetElementAtYuv_uchar_U() 和 rsGetElementAtYuv_uchar_V()。

以取樣器描述的方式從紋理配置擷取值。

如果分配金額為 1D，請使用浮動式這個值的變化版本。如果是 2D，請使用 float2 變化版本。

詳情請參閱 android.renderscript.Sampler。

這個函式會將值儲存在分配作業的單一儲存格中。

將資料儲存為三個維度配置時，請使用 x、y 和 z 變化版本。同樣地，針對雙維度配置，請使用 x、y 變化版本，若為單維度分配，則使用 x。

這個函式有兩種樣式。其中一個傳遞要使用 void* 儲存的值，另一個則包含實際值做為引數，例如 rsSetElementAt() 與 rsSetElementAt_int4()。 如果是原始類型，請一律使用後者，因為前者會更有效率。

另請參閱 rsGetElementAt()。