RectTexture

自 2.2.1

RectTexture 使用 CPU 端曲面细分绘制圆角矩形。在无法使用 SDF Shader 的环境中，它可作为 SDFRectTexture 的备用方案。两个类公开的属性相同，RectTexture 另有 cornerSegments。

注册名：rect_texture
LSS 函数：rect(...)

INFO

继承自 TransformTexture —— 支持 rotate()、scale()、transform()。

TIP

对于大多数用例，建议优先使用 SDFRectTexture，它在所有尺寸下都能提供更好的视觉效果。仅在需要 CPU 端渲染时使用 RectTexture。

---

用法

// 填充圆角矩形
IGuiTexture panel = new RectTexture()
    .setColor(0xFF2A2A2A)
    .setRadius(new Vector4f(6, 6, 6, 6));

// 带描边
IGuiTexture bordered = new RectTexture()
    .setColor(0xFF1A1A1A)
    .setRadius(new Vector4f(4, 4, 4, 4))
    .setStroke(1f)
    .setBorderColor(0xFFFFFFFF);

// 静态工厂方法
IGuiTexture simple = RectTexture.of(0xFF3A3A3A);

val panel = RectTexture()
    .setColor(0xFF2A2A2A.toInt())
    .setRadius(Vector4f(6f, 6f, 6f, 6f))

val simple = RectTexture.of(0xFF3A3A3A.toInt())

let panel = new RectTexture()
    .setColor(0xFF2A2A2A)
    .setStroke(1)
    .setBorderColor(0xFFFFFFFF);

let simple = RectTexture.of(0xFF3A3A3A);

---

LSS

/* rect(fillColor) */
background: rect(#2A2A2A);

/* rect(fillColor, radius) */
background: rect(#2A2A2A, 6);

/* rect(fillColor, radius, strokeWidth, borderColor) */
background: rect(#2A2A2A, 4, 1, #FFFFFF);

/* 逐角半径：左上 右上 右下 左下 */
background: rect(#2A2A2A, 8 8 0 0);

/* rect(fillColor, radius, strokeWidth, borderColor, cornerSegments) */
background: rect(#2A2A2A, 12, 0, #00000000, 16);

自 2.2.41

第五个参数 cornerSegments 自 2.2.41 起可用。半径较大、圆角显得有棱角时可以调高它。

WARNING

rect() 按 CSS 顺序（从左上开始）读取 4 个半径，而 sdf() 从左下开始读取。见 LSS 中的 Texture。

---

字段

名称	类型	描述
color	int	填充颜色（ARGB）。默认值：0xFFFFFFFF。
borderColor	int	描边颜色（ARGB）。默认值：0xFF000000。
radius	Vector4f	每个角的半径：x = 左上角，y = 右上角，z = 右下角，w = 左下角。
stroke	float	边框描边宽度。0 表示禁用边框。
cornerSegments	int	每个角圆弧的线段数。数值越高越平滑，但顶点数也越多。默认值：8。

---

方法

方法	返回	描述
setColor(int)	RectTexture	设置填充颜色。
setBorderColor(int)	RectTexture	设置描边颜色。
setRadius(Vector4f)	RectTexture	设置每个角的半径。
setStroke(float)	RectTexture	设置描边宽度。
setCornerSegments(int)	RectTexture	设置每个角圆弧的线段数。
copy()	RectTexture	返回深拷贝。
interpolate(IGuiTexture, float)	IGuiTexture	将所有属性混合到另一个 RectTexture。
RectTexture.of(int)	RectTexture	静态工厂方法 —— 创建具有指定填充颜色的矩形。