AGSL 快速參考指引

AGSL 與 GLSL ES 1.0 相容。詳情請參閱 OpenGL ES 著色語言說明文件中的等效函式。本說明文件會盡可能指出 AGSL 與 GLSL 之間的差異。

類型

AGSL 支援 GLSL ES 1.0 類型，並提供另一種表示向量和矩陣類型的方式。AGSL 支援其他 short 和 half 類型，用於表示中等精確度。

基本類型

精確度和範圍最小值

這些是根據 OpenGL ES 2.0 規格，與每個修飾符相關聯的最低保證精確度和範圍。由於大多數裝置都支援 ES 3.0，因此這些裝置可保證更高的 highp 精確度/範圍和 int mediump 範圍。精確度修飾符可套用至純量、向量和矩陣變數和參數。只有下列最小值可保證；lowp 實際上不一定比 mediump 精確度低，而 mediump 也不一定比 highp 精確度低。AGSL 目前會在最終輸出內容中將 lowp 轉換為 mediump。

除了陣列數字下標語法 (例如 var[num]) 之外，長度為 2 至 4 的向量元件的名稱會以單一字母表示。元件可進行調度和複製。例如：vect.yx、vect.yy

vect.xyzw - 用於存取代表點/法線的向量

vect.rgba - 用於存取代表顏色的向量

vect.LTRB：當向量代表矩形時使用 (不適用於 GLSL)

在 AGSL 中，0 和 1 可用於在該管道中產生常數 0 或 1。例如：vect.rgb1 == vec4(vect.rgb,1)

結構體和陣列

結構體的宣告語法與 GLSL 相同，但 AGSL 只支援全域範圍的結構體。

struct type-name {
 members
} struct-name; // optional variable declaration.

系統僅支援明確的陣列大小，且必須使用 C 樣式或 GLSL 樣式語法：

<base type>[<array size>] 變數名稱 - 例如：half[10] x;

<base type> 變數名稱 [<array size>] - 例如：half x[10];

陣列無法從函式傳回、複製、指派或比較。陣列限制會傳播至包含陣列的結構體。陣列只能使用常數或迴圈變數編入索引。

資格賽

變數宣告

宣告必須位於明確的括號範圍內。以下範例中 y 的宣告不允許：

if (condition)
    int y = 0;

矩陣/結構體/陣列的基本概念

矩陣建構函式範例

當矩陣以單一值建構時，對角線上的所有值都會設為該值，而其餘的值則設為零。因此，float2x2(1.0) 會建立 2x2 的單位矩陣。

矩陣使用多個值建構時，系統會先填入資料欄 (以資料欄為主)。

請注意，與 GLSL 不同，這個函式不支援可減少傳入向量元件數量的建構函式，但您可以使用 swizzling 取得相同效果。如要從 AGSL 中的 vec4 建構 vec3，並讓其行為與 GLSL 相同，請指定 vec3 nv = quadVec.xyz。

結構體建構函式範例

struct light { float intensity; float3 pos; };
// literal integer constants auto-converted to floating point
light lightVar = light(3, float3(1, 2, 3.0));

矩陣元件

使用陣列下標語法存取矩陣的元件。

float4x4 m; // represents a matrix
m[1] = float4(2.0); // sets second column to all 2.0
m[0][0] = 1.0; // sets upper left element to 1.0
m[2][3] = 2.0; // sets 4th element of 3rd column to 2.0

結構欄位

使用「點」. 運算子選取結構體欄位。運算子包括：

陣列元素

您可以使用陣列下標運算子 [ ] 存取陣列元素。例如：

diffuseColor += lightIntensity[3] * NdotL;

運算子

依優先順序編號。關係和等於運算子 > < <= >= == != 會評估為布林值。如要逐個元件比較向量，請使用 lessThan()、equal() 等函式。

矩陣和向量運算

套用於純量值時，算術運算子會產生純量。對於除模運算子以外的運算子，如果一個運算元是純量，另一個是向量或矩陣，則會以元件為單位執行運算，並產生相同的向量或矩陣類型。如果兩個運算都是相同大小的向量，則會以元件為單位執行運算 (並傳回相同的向量類型)。

如果一個運算元是向量，且與矩陣的資料列或資料欄大小相符，則可使用乘法運算子進行代數的資料列和資料欄乘法運算。

使用內建函式計算向量內積、交叉乘積和元件逐項相乘：

程式控制

For 迴圈限制

與 GLSL ES 1.0 類似，'for' 迴圈相當有限；編譯器必須能夠展開迴圈。也就是說，初始化器、測試條件和 next 陳述式都必須使用常數，才能在編譯時計算所有項目。next 陳述式進一步限制使用 ++, --, +=, or -=。

內建函式

GT (泛型類型) 是 float、float2、float3、float4 或 half、half2、half3、half4。

這些函式的運作方式大多是依元件為單位 (函式會套用至每個元件)。並在必要時加以標示。

角度與三角函數

系統會假設以角度指定的函式參數為弧度單位。無論如何，這些函式都不會導致除以零錯誤。如果比率的除數為 0，則結果將不定義。

指數函式

常用函式

幾何函式

這些函式會以向量形式運算向量，而非以元件為單位。GT 是大小為 2 至 4 的浮點/半向量。

矩陣函式

類型 mat 是任何方陣型別。

向量關聯函式

比較 x 和 y 元件。特定呼叫的輸入向量和傳回向量大小必須一致。T 是整數和浮點向量類型的聯集。BV 是與輸入向量大小相符的布林向量。

色彩函式

著色器取樣 (評估)

不支援取樣器類型，但您可以評估其他著色器。如果您需要取樣紋理，可以建立 BitmapShader 物件，並將其新增為統一變數。您可以對任何著色器執行這項操作，也就是說，您可以直接評估任何 Android 著色器，而無須先將其轉換為 Bitmap，包括其他 RuntimeShader 物件。這可提供極大的彈性，但複雜的著色器可能會耗費大量資源進行評估，尤其是在迴圈中。

uniform shader image;

image.eval(coord).a   // The alpha channel from the evaluated image shader

原始緩衝區取樣

雖然大多數圖片都含有應進行色彩管理的顏色，但有些圖片含有的資料並非實際的顏色，包括儲存法線、材質屬性 (例如粗糙度)、高度圖，或任何其他純粹以數學方式儲存在圖片中的資料。在 AGSL 中使用這類圖片時，您可以使用 RuntimeShader#setInputBuffer 將 BitmapShader 用作一般原始緩衝區。這樣可避免色彩空間轉換和篩選。