IGuiTexture

Since 2.2.1

IGuiTexture is the base interface for all drawable textures in LDLib2. Every style property that accepts visual appearance (e.g. background, focus-overlay, mark-background) takes an IGuiTexture.

All registered texture implementations are part of the ldlib2:gui_texture registry and can be serialised, edited in the UI editor, and used in LSS.

---

Built-in Constants

Constant	Description
IGuiTexture.EMPTY	No-op — draws nothing. Use this to remove a texture without passing null.
IGuiTexture.MISSING_TEXTURE	Renders the vanilla missing-texture checkerboard. Used as a fallback when a resource cannot be resolved.

---

TransformTexture

Most concrete texture types extend the abstract TransformTexture, which wraps a Transform2D applied to every draw call. All TransformTexture subclasses inherit these fluent methods:

Method	Description
rotate(float degree)	Rotates around the texture centre by degree degrees.
scale(float scale)	Scales uniformly around the centre.
scale(float width, float height)	Scales independently on each axis.
transform(float xOffset, float yOffset)	Translates by the given offset in GUI pixels.
setColor(int argb)	Tints the texture. Exact effect depends on subtype.

IGuiTexture tex = SpriteTexture.of("mymod:textures/gui/icon.png")
    .rotate(45f)
    .scale(0.8f)
    .setColor(0x80FFFFFF); // 50 % opacity white tint

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);

---

Interface Methods

Method	Returns	Description
setColor(int)	IGuiTexture	Tints the texture. No-op on the interface; overridden by concrete types.
rotate(float)	IGuiTexture	Rotates the texture. No-op on the interface; overridden by TransformTexture.
scale(float)	IGuiTexture	Scales the texture. No-op on the interface; overridden by TransformTexture.
transform(int, int)	IGuiTexture	Translates the texture. No-op on the interface; overridden by TransformTexture.
getRawTexture()	IGuiTexture	Returns the underlying texture, unwrapping any proxy (e.g. DynamicTexture).
copy()	IGuiTexture	Creates a deep copy via the codec.
interpolate(IGuiTexture, float)	IGuiTexture	Blends this texture with another. lerp = 0 is this, lerp = 1 is other. Natively supported by ColorRectTexture, RectTexture, SDFRectTexture, and ColorBorderTexture.

---

Static Factory Helpers

// Layer multiple textures (drawn in order)
IGuiTexture layered = IGuiTexture.group(background, overlay);

// Lazy / dynamic texture resolved every frame
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);

---

Registered Texture Types

Registry name	Class	LSS function	Description
color_rect_texture	ColorRectTexture	color(#RGBA) or hex literal	Solid-fill rectangle.
color_border_texture	ColorBorderTexture	border(size, #RGBA)	Border-only rectangle (no fill).
sdf_rect_texture	SDFRectTexture	rect(color, radius?, stroke?, borderColor?)	GPU SDF rounded rect with optional stroke.
rect_texture	RectTexture	—	CPU-rendered rounded rect (no shader required).
sprite_texture	SpriteTexture	sprite(path, ...)	PNG image with optional 9-slice and wrap mode.
vanilla_sprite_texture	VanillaSpriteTexture	vanilla-sprite(id)	Registered vanilla GUI atlas sprite.
text_texture	TextTexture	—	Rendered text with scrolling modes.
animation_texture	AnimationTexture	—	Sprite-sheet frame animation.
item_stack_texture	ItemStackTexture	—	One or more ItemStacks cycling every 20 ticks.
fluid_stack_texture	FluidStackTexture	—	One or more fluids cycling every 20 ticks.
group_texture	GuiTextureGroup	group(...)	Ordered stack of textures drawn together.
shader_texture	ShaderTexture	shader(location)	Custom GLSL shader with automatic GUI uniforms.
ui_resource_texture	UIResourceTexture	builtin(name) / file(...)	References a texture saved in the editor resource system.

---

LSS Reference

Textures are used as values in LSS properties. See Texture in LSS for the complete syntax including rect(), sprite(), group(), and transform chains.

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