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;

<基准类型> 变量名称 [<数组大小>] - 例如：half x[10];

无法从函数返回、复制、赋值或比较数组。数组限制会传播到包含数组的结构。数组只能使用常量或循环变量编制索引。

资格赛

变量声明

声明必须位于显式大括号作用域中。以下示例中 y 的声明不允许：

if (condition)
    int y = 0;

矩阵/结构/数组基础知识

矩阵构造函数示例

使用单个值构建矩阵时，对对角线上的所有值赋予该值，而对其余值赋予零。因此，float2x2(1.0) 会创建一个 2x2 的单位矩阵。

使用多个值构建矩阵时，系统会先填充列（按列顺序）。

请注意，与 GLSL 不同，此语言不支持用于减少传入矢量组件数量的构造函数，但您可以使用串联来实现相同的效果。如需在 AGSL 中根据 vec4 构造行为与 GLSL 相同的 vec3，请指定 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 用作通用原始缓冲区。这样可以避免色彩空间转换和滤除。