AGSL 快速參考指引

AGSL 經過特別設計，與 GLSL ES 1.0 相容。如需更多資訊 您可在 OpenGL ES 著色語言說明文件。 如果可能，本說明文件會嘗試指出不同 AGSL 之間的差異 以及 GLSL

類型

AGSL 支援 GLSL ES 1.0 型別，並提供另一種呈現向量的方式 以及矩陣類型AGSL 支援額外的 short 和 half 類型來代表 中等精確度

基本類型

精確度和範圍下限

這些是與各項屬性相關聯的 最小保證精確度和範圍 修飾符。大多數裝置 支援 ES 3.0，其保證精確度/範圍為 highp， int mediump 個範圍。精確度修飾符可以套用至純量、向量及 矩陣變數和參數我們只保證以下的最低限額； lowp 不一定低於 mediump 精確度，而且 mediump 精確度不一定低於 highp。AGSL 正在轉換 lowp 最終輸出內容的 mediump。

除了陣列數字下標語法外，例如： var[num], names of vector components for vectors of length 2 - 4 are denoted by a single letter. Components can be swizzled and replicated. ex:vect.yx,vect.yy`

vect.xyzw - 存取代表點/一般的向量時

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

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

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

結構和陣列

宣告結構的語法與 GLSL 相同，但 AGSL 僅支援 部署 Kubernetes 叢集

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

只有明確陣列大小支援 1 維陣列，使用 C 樣式或 GLSL 樣式語法：

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

<基礎類型>變數名稱 [<array size>] - 例如：half x[10];

您無法透過函式傳回陣列，也無法複製、指派或比較陣列。 陣列限制適用於包含陣列的結構。陣列可以 就必須使用常數或迴圈變數建立索引

資格賽

變數宣告

宣告必須在明確的外圍範圍內。宣告中 y 以下為不允許的做法：

if (condition)
    int y = 0;

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

矩陣建構函式範例

以單一值建構矩陣時，所有值與 對對角線的值表示，其他值則為零。float2x2(1.0)會 因此，請建立 2x2 身分矩陣

以多個值建構矩陣時，系統會先填入資料欄 (依資料欄的主要順序)。

請注意，與 GLSL 不同的是，建構函式會減少 不支援傳入向量，但您可以使用滑動手勢確保 效果。如何從 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 物件，並將其新增為 統一您可以針對任何著色器執行這項作業，也就是說，您可以直接評估 不必轉換成 點陣圖，包括其他 RuntimeShader 物件。這樣一來， 但由於著色器較複雜 尤其是在迴圈中評估

uniform shader image;

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

原始緩衝區取樣

雖然大部分的圖片都含有應依顏色管理的顏色，但仍有部分圖片 包含的資料不是實際顏色，包括那些存有常態的圖片 材質屬性 (例如粗糙度)、高度圖或任何其他純粹的 圖片中儲存的數學資料使用這些類型時 可讓您使用 BitmapShader 做為一般原始緩衝區 RuntimeShader#setInputBuffer。 這可避免色彩空間轉換和篩選問題。