IGuiTexture

自 2.2.1

IGuiTexture 是 LDLib2 中所有可绘制 Texture 的基接口。所有接受视觉外观的样式属性（例如 background、focus-overlay、mark-background）都使用 IGuiTexture。

所有已注册的 Texture 实现都属于 ldlib2:gui_texture 注册表，可以被序列化、在 UI 编辑器中编辑，并在 LSS 中使用。

内置常量

常量	描述
`IGuiTexture.EMPTY`	无操作 — 不绘制任何内容。使用此值可在不传递 `null` 的情况下移除 Texture。
`IGuiTexture.MISSING_TEXTURE`	渲染原版缺失 Texture 的棋盘格图案。当资源无法解析时作为后备使用。

TransformTexture

大多数具体的 Texture 类型都继承自抽象类 TransformTexture，它包装了一个 Transform2D 并在每次绘制调用时应用。所有 TransformTexture 的子类都继承以下流式方法：

方法	描述
`rotate(float degree)`	绕 Texture 中心旋转 `degree` 度。
`scale(float scale)`	绕中心均匀缩放。
`scale(float width, float height)`	在每个轴上独立缩放。
`transform(float xOffset, float yOffset)`	按给定的 GUI 像素偏移量平移。
`setColor(int argb)`	为 Texture 着色。具体效果取决于子类型。

JavaKotlinKubeJS

IGuiTexture tex = SpriteTexture.of("mymod:textures/gui/icon.png")
    .rotate(45f)
    .scale(0.8f)
    .setColor(0x80FFFFFF); // 50% 不透明度白色着色

val tex = SpriteTexture.of("mymod:textures/gui/icon.png")
    .rotate(45f)
    .scale(0.8f)
    .setColor(0x80FFFFFF.toInt())

let tex = SpriteTexture.of("mymod:textures/gui/icon.png")
    .rotate(45)
    .scale(0.8)
    .setColor(0x80FFFFFF);

接口方法

方法	返回	描述
`setColor(int)`	`IGuiTexture`	为 Texture 着色。在接口上无操作；由具体类型重写。
`rotate(float)`	`IGuiTexture`	旋转 Texture。在接口上无操作；由 `TransformTexture` 重写。
`scale(float)`	`IGuiTexture`	缩放 Texture。在接口上无操作；由 `TransformTexture` 重写。
`transform(int, int)`	`IGuiTexture`	平移 Texture。在接口上无操作；由 `TransformTexture` 重写。
`getRawTexture()`	`IGuiTexture`	返回底层 Texture，解包任何代理（例如 `DynamicTexture`）。
`copy()`	`IGuiTexture`	通过编解码器创建深拷贝。
`interpolate(IGuiTexture, float)`	`IGuiTexture`	将此 Texture 与另一个混合。`lerp = 0` 为此 Texture，`lerp = 1` 为另一个。`ColorRectTexture`、`RectTexture`、`SDFRectTexture` 和 `ColorBorderTexture` 原生支持。

静态工厂辅助方法

JavaKotlinKubeJS

// 多层叠加 Texture（按顺序绘制）
IGuiTexture layered = IGuiTexture.group(background, overlay);

// 懒加载 / 动态 Texture，每帧解析
IGuiTexture dynamic = IGuiTexture.dynamic(() -> currentTexture);

val layered = IGuiTexture.group(background, overlay)
val dynamic = IGuiTexture.dynamic { currentTexture }

let layered = IGuiTexture.group(background, overlay);
let dynamic = IGuiTexture.dynamic(() => currentTexture);

已注册的 Texture 类型

注册名	类	LSS 函数	描述
`color_rect_texture`	`ColorRectTexture`	`color(#RGBA)` 或十六进制字面量	纯色填充矩形。
`color_border_texture`	`ColorBorderTexture`	`border(size, #RGBA)`	仅边框矩形（无填充）。
`sdf_rect_texture`	`SDFRectTexture`	`rect(color, radius?, stroke?, borderColor?)`	GPU SDF 圆角矩形，可选描边。
`rect_texture`	`RectTexture`	—	CPU 渲染圆角矩形（无需 Shader）。
`sprite_texture`	`SpriteTexture`	`sprite(path, ...)`	PNG 图像，可选 9-slice 和环绕模式。
`vanilla_sprite_texture`	`VanillaSpriteTexture`	`vanilla-sprite(id)`	已注册的原版 GUI 图集 sprite。
`text_texture`	`TextTexture`	—	渲染文本，支持滚动模式。
`animation_texture`	`AnimationTexture`	—	精灵表帧动画。
`item_stack_texture`	`ItemStackTexture`	—	一个或多个 `ItemStack`，每 20 tick 循环。
`fluid_stack_texture`	`FluidStackTexture`	—	一种或多种流体，每 20 tick 循环。
`group_texture`	`GuiTextureGroup`	`group(...)`	一起绘制的有序 Texture 堆叠。
`shader_texture`	`ShaderTexture`	`shader(location)`	自定义 GLSL Shader，自动提供 GUI Uniform。
`ui_resource_texture`	`UIResourceTexture`	`builtin(name)` / `file(...)`	引用保存在编辑器资源系统中的 Texture。

LSS 参考

Texture 在 LSS 属性中作为值使用。有关完整语法，包括 rect()、sprite()、group() 和变换链，请参见 LSS 中的 Texture。

button {
    background: rect(#3a3a3a, 4);
    hover-background: rect(#4a4a4a, 4, 1, #FFFFFF66);
}