LSS 中的纹理

自 2.1.4

在 LDLib2 中，许多视觉样式（如 background）都接受一个纹理值。
LSS 中的纹理值是用来描述纹理如何创建以及可选变换的字符串表达式。

该系统灵活且可组合，允许你使用简洁的语法构建复杂的视觉效果。

---

支持的纹理类型

空纹理

background: empty;

或空字符串：

background: ;

这将导致不渲染任何纹理。

---

纯色

如果该值可以被解析为颜色，它将被视为一个纯色矩形：

background: #1F00FFFF; /* #AARRGGBB */
background: #FF00FF; //* #RRGGBB */
background: #FFF; /* #RGB */
background: rgba(255, 0, 0, 128);
background: rgb(255, 123, 0);

---

sprite(...)

使用来自纹理图集或资源位置的 sprite。

background: sprite(ldlib2:textures/gui/icon.png);

高级用法：

background: sprite(
    ldlib2:textures/gui/icon.png,
    0, 0, 16, 16,          /* sprite 区域（可选） */
    2, 2, 2, 2,            /* 边框（可选） */
    #FFFFFF                /* 颜色色调（可选） */
);

---

icon(...)

使用已注册的图标纹理。

background: icon(check);
background: icon(modid, check);

---

rect(...) / sdf(...)

创建一个基于 SDF 的矩形纹理。

background: rect(#FF0000);
background: rect(#FF0000, 4);
background: rect(#FF0000, 4 4 4 4, 2, #FFFFFF);

参数：

1. 填充颜色
2. 圆角半径（单个值或 4 个值）（可选）
3. 描边宽度（可选）
4. 边框颜色（可选）

---

border(...)

创建一个简单的彩色边框。

background: border(2, #00FF00);

---

group(...)

将多个纹理组合成一个组。

background: group(
    sprite(ldlib2:textures/gui/bg.png),
    rect(#FFFFFF, 2)
);

---

shader(...)

使用自定义 shader 纹理。

background: shader(ldlib2:fbm);

---

基于资源的纹理

如果函数名与已注册的资源提供器类型匹配，它将自动被解析：

background: builtin(ui-gdp:BORDER);
background: file("<namespace>:<path>");

这允许与 LDLib2 的资源系统集成。

---

纹理变换

在主纹理之后，你可以应用变换函数。

缩放

background: sprite(...) scale(2);
background: sprite(...) scale(2, 1);

---

旋转

background: sprite(...) rotate(45);

---

平移

background: sprite(...) translate(4, 8);

---

颜色覆盖

background: sprite(...) color(#FFAA00);
background: sprite(...) color(255, 255, 0, 0);

这将使用给定的颜色为纹理着色。

---

总之，LSS 纹理值让你能够：

• 以声明方式定义纹理
• 以可读的方式链接变换
• 高效地重用和覆盖视觉效果

这使得 UI 样式既强大又兼容资源包。