feat(UI): add AnvilLib-Ui module for declarative UI library

.github/workflows/ci.yml

@@ -356,6 +356,33 @@ jobs:
       signing_key: ${{ secrets.SIGNING_KEY }}
       signing_public_key: ${{ secrets.SIGNING_PUBLIC_KEY }}
       signing_password: ${{ secrets.SIGNING_PASSWORD }}
+  ui:
+    needs:
+      - rendering
+    uses: ./.github/workflows/build_and_test.yml
+    with:
+      module: ui
+      module_id: anvillib-ui
+      mod_id: anvillib_ui
+      ci_build: true
+      pr_build: false
+    secrets:
+      maven_url: ${{ secrets.MAVEN_URL }}
+      maven_user: ${{ secrets.MAVEN_USER }}
+      maven_pass: ${{ secrets.MAVEN_PASS }}
+  ui-maven-central-deploy:
+    uses: ./.github/workflows/publish_maven_central.yml
+    needs:
+      - ui
+    with:
+      module: ui
+      module_id: anvillib-ui
+    secrets:
+      maven_central_username: ${{ secrets.MAVEN_CENTRAL_USERNAME }}
+      maven_central_password: ${{ secrets.MAVEN_CENTRAL_PASSWORD }}
+      signing_key: ${{ secrets.SIGNING_KEY }}
+      signing_public_key: ${{ secrets.SIGNING_PUBLIC_KEY }}
+      signing_password: ${{ secrets.SIGNING_PASSWORD }}
   util:
     uses: ./.github/workflows/build_and_test.yml
     needs:
@@ -426,6 +453,7 @@ jobs:
       - rendering
       - space-select
       - sync
+      - ui
       - util
       - wheel
     uses: ./.github/workflows/build_and_test.yml

.github/workflows/pull_request.yml

@@ -135,6 +135,16 @@ jobs:
       mod_id: anvillib_sync
       ci_build: true
       pr_build: true
+  ui:
+    needs:
+      - rendering
+    uses: ./.github/workflows/build_and_test.yml
+    with:
+      module: ui
+      module_id: anvillib-ui
+      mod_id: anvillib_ui
+      ci_build: true
+      pr_build: true
   util:
     uses: ./.github/workflows/build_and_test.yml
     needs:
@@ -171,6 +181,7 @@ jobs:
       - rendering
       - space-select
       - sync
+      - ui
       - util
       - wheel
     uses: ./.github/workflows/build_and_test.yml

.github/workflows/release.yml

@@ -356,6 +356,33 @@ jobs:
       signing_key: ${{ secrets.SIGNING_KEY }}
       signing_public_key: ${{ secrets.SIGNING_PUBLIC_KEY }}
       signing_password: ${{ secrets.SIGNING_PASSWORD }}
+  ui:
+    needs:
+      - rendering
+    uses: ./.github/workflows/build_and_test.yml
+    with:
+      module: ui
+      module_id: anvillib-ui
+      mod_id: anvillib_ui
+      ci_build: false
+      pr_build: false
+    secrets:
+      maven_url: ${{ secrets.MAVEN_URL }}
+      maven_user: ${{ secrets.MAVEN_USER }}
+      maven_pass: ${{ secrets.MAVEN_PASS }}
+  ui-maven-central-deploy:
+    uses: ./.github/workflows/publish_maven_central.yml
+    needs:
+      - ui
+    with:
+      module: ui
+      module_id: anvillib-ui
+    secrets:
+      maven_central_username: ${{ secrets.MAVEN_CENTRAL_USERNAME }}
+      maven_central_password: ${{ secrets.MAVEN_CENTRAL_PASSWORD }}
+      signing_key: ${{ secrets.SIGNING_KEY }}
+      signing_public_key: ${{ secrets.SIGNING_PUBLIC_KEY }}
+      signing_password: ${{ secrets.SIGNING_PASSWORD }}
   util:
     uses: ./.github/workflows/build_and_test.yml
     needs:
@@ -426,6 +453,7 @@ jobs:
       - rendering
       - space-select
       - sync
+      - ui
       - util
       - wheel
     uses: ./.github/workflows/build_and_test.yml

module.main/build.gradle

@@ -16,6 +16,7 @@ dependencies {
         jarJar(api("dev.anvilcraft.lib:anvillib-rendering-neoforge-26.1:latest.release"))
         jarJar(api("dev.anvilcraft.lib:anvillib-space-select-neoforge-26.1:latest.release"))
         jarJar(api("dev.anvilcraft.lib:anvillib-sync-neoforge-26.1:latest.release"))
+        jarJar(api("dev.anvilcraft.lib:anvillib-ui-neoforge-26.1:latest.release"))
         jarJar(api("dev.anvilcraft.lib:anvillib-util-neoforge-26.1:latest.release"))
         jarJar(api("dev.anvilcraft.lib:anvillib-wheel-neoforge-26.1:latest.release"))
     } else {
@@ -35,6 +36,7 @@ dependencies {
         jarJar(implementation project(":anvillib-rendering-neoforge-26.1"))
         jarJar(implementation project(":anvillib-space-select-neoforge-26.1"))
         jarJar(implementation project(":anvillib-sync-neoforge-26.1"))
+        jarJar(implementation project(":anvillib-ui-neoforge-26.1"))
         jarJar(implementation project(":anvillib-util-neoforge-26.1"))
         jarJar(implementation project(":anvillib-wheel-neoforge-26.1"))
     }

module.rendering/src/main/java/dev/anvilcraft/lib/v2/rendering/sdf/Sdf2d.java

@@ -98,6 +98,14 @@ public static float sd(
                     shape.x, shape.y,
                     shape.z
             );
+
+            case TRIANGLE -> sdTriangle(
+                    px, py,
+                    shape.x, shape.y,
+                    shape.z, shape.w,
+                    Float.intBitsToFloat(params.getTypeParams().w),
+                    params.getSharedParams().w
+            );
         };
 
         if (params.isOnion()) {
@@ -259,4 +267,39 @@ public static float sdEgg(
                         ) - (ce + ra);
     }
 
+    /**
+     * 三角形 SDF。来自 <a href="https://iquilezles.org/articles/distfunctions2d/">IQ</a>。
+     */
+    public static float sdTriangle(
+            float px, float py,
+            float x0, float y0,
+            float x1, float y1,
+            float x2, float y2
+    ) {
+        float ex0 = x1 - x0, ey0 = y1 - y0;
+        float ex1 = x2 - x1, ey1 = y2 - y1;
+        float ex2 = x0 - x2, ey2 = y0 - y2;
+        float e0x = px - x0, e0y = py - y0;
+        float e1x = px - x1, e1y = py - y1;
+        float e2x = px - x2, e2y = py - y2;
+
+        float v0 = e0x * ey0 - e0y * ex0;
+        float v1 = e1x * ey1 - e1y * ex1;
+        float v2 = e2x * ey2 - e2y * ex2;
+
+        float d;
+        if (v0 * v1 > 0.0f && v1 * v2 > 0.0f) {
+            d = -Math.min(Math.min(
+                    (e0x * ex0 + e0y * ey0) / (float) Math.sqrt(ex0 * ex0 + ey0 * ey0),
+                    (e1x * ex1 + e1y * ey1) / (float) Math.sqrt(ex1 * ex1 + ey1 * ey1)),
+                    (e2x * ex2 + e2y * ey2) / (float) Math.sqrt(ex2 * ex2 + ey2 * ey2));
+        } else {
+            d = (float) Math.sqrt(Math.min(Math.min(
+                    e0x * e0x + e0y * e0y,
+                    e1x * e1x + e1y * e1y),
+                    e2x * e2x + e2y * e2y));
+        }
+        return d;
+    }
+
 }

module.rendering/src/main/java/dev/anvilcraft/lib/v2/rendering/sdf/SdfGraphics.java

@@ -109,6 +109,16 @@ public SdfGraphics egg(
         return          this;
     }
 
+    /** 三角形。按逆时针顺序填入三个顶点坐标。包围盒自动计算。 */
+    public SdfGraphics triangle(
+            float x0, float y0,
+            float x1, float y1,
+            float x2, float y2
+    ) {
+        this.parameters.triangle(x0, y0, x1, y1, x2, y2);
+        return this;
+    }
+
     public SdfGraphics color(int color) {
         this.parameters .color(color);
         return          this;

module.rendering/src/main/java/dev/anvilcraft/lib/v2/rendering/sdf/SdfParameters.java

@@ -74,6 +74,22 @@ public void egg(float topRadius, float bottomRadius, float height) {
         this.shapeParams    .set(height, bottomRadius, topRadius, 0.0f);
     }
 
+    /** 三角形。按逆时针顺序填入三个顶点坐标。顶点自动转为局部坐标。 */
+    public void triangle(float x0, float y0, float x1, float y1, float x2, float y2) {
+        this._renderType(SdfRenderType.TRIANGLE);
+        float minX = Math.min(Math.min(x0, x1), x2);
+        float minY = Math.min(Math.min(y0, y1), y2);
+        float maxX = Math.max(Math.max(x0, x1), x2);
+        float maxY = Math.max(Math.max(y0, y1), y2);
+        float cx = minX + (maxX - minX) / 2f;
+        float cy = minY + (maxY - minY) / 2f;
+        this.rect.set(minX, minY, maxX - minX, maxY - minY);
+        this.shapeParams.set(x0 - cx, y0 - cy, x1 - cx, y1 - cy);
+        this.typeParams.z = 0; // onion off
+        this.typeParams.w = Float.floatToIntBits(x2 - cx);
+        this.sharedParams.w = y2 - cy; // fill 模式下安全
+    }
+
     public void smooth(float smooth) {
         this                ._smooth(smooth);
     }

module.rendering/src/main/java/dev/anvilcraft/lib/v2/rendering/sdf/SdfRenderType.java

@@ -7,7 +7,8 @@ public enum SdfRenderType {
     SECTOR,
     PIE,
     CAPSULE,
-    EGG;
+    EGG,
+    TRIANGLE;
 
     private static final SdfRenderType[] VALUES = values();
 

module.rendering/src/main/resources/assets/anvillib_rendering/shaders/core/sdf_graphics.fsh

@@ -20,6 +20,7 @@ layout(std140) uniform SDFParameters {
 #define RT_PIE          4
 #define RT_UCAPSULE     5
 #define RT_EGG          6
+#define RT_TRIANGLE     7
 
 #define PASS_FILL       0
 #define PASS_LIGHT      1
@@ -106,6 +107,31 @@ float sdEgg( in vec2 p, in float he, in float ra, in float rb )
     return length(vec2(p.x+ce,p.y))-(ce+ra);
 }
 
+// from https://iquilezles.org/articles/distfunctions2d/
+float sdTriangle( in vec2 p, in vec2 v0, in vec2 v1, in vec2 v2 )
+{
+    vec2 e0 = v1 - v0, e1 = v2 - v1, e2 = v0 - v2;
+    vec2 vp0 = p - v0, vp1 = p - v1, vp2 = p - v2;
+
+    float s0 = vp0.x * e0.y - vp0.y * e0.x;
+    float s1 = vp1.x * e1.y - vp1.y * e1.x;
+    float s2 = vp2.x * e2.y - vp2.y * e2.x;
+
+    float d;
+    if (s0 * s1 > 0.0 && s1 * s2 > 0.0) {
+        d = -min(min(
+            dot(vp0, e0) / length(e0),
+            dot(vp1, e1) / length(e1)),
+            dot(vp2, e2) / length(e2));
+    } else {
+        d = sqrt(min(min(
+            dot(vp0, vp0),
+            dot(vp1, vp1)),
+            dot(vp2, vp2)));
+    }
+    return d;
+}
+
 void main() {
     Sdf     params          = SDFs[vIndex];
     vec4    shape           = params.Shape;
@@ -135,6 +161,10 @@ void main() {
         case    RT_EGG:
             d   = sdEgg(p, shape.x, shape.y, shape.z);
             break;
+        case    RT_TRIANGLE:
+            d   = sdTriangle(p, shape.xy, shape.zw,
+                    vec2(intBitsToFloat(params.Types.w), params.Shared.w));
+            break;
     }
 
     float   aa              = max(fwidth(d) * 0.5, uSmoothRadius);

module.test/build.gradle

@@ -13,6 +13,7 @@ dependencies {
     implementation project(":anvillib-rendering-neoforge-26.1")
     implementation project(":anvillib-space-select-neoforge-26.1")
     implementation project(":anvillib-sync-neoforge-26.1")
+    implementation project(":anvillib-ui-neoforge-26.1")
     implementation project(":anvillib-util-neoforge-26.1")
     implementation project(":anvillib-wheel-neoforge-26.1")
 }

module.test/src/main/java/dev/anvilcraft/lib/v2/test/client/AnvilLibTestClient.java

@@ -5,9 +5,9 @@
 import dev.anvilcraft.lib.v2.test.all.TestTiles;
 import dev.anvilcraft.lib.v2.test.client.cber.TestCachedRenderer;
 import dev.anvilcraft.lib.v2.test.client.gui.SdfGraphicsLayer;
+import dev.anvilcraft.lib.v2.test.client.screen.DeclarativeTestScreen;
 import dev.anvilcraft.lib.v2.test.client.screen.GuiTestScreen;
 import net.minecraft.client.Minecraft;
-import net.minecraft.commands.Commands;
 import net.neoforged.api.distmarker.Dist;
 import net.neoforged.bus.api.SubscribeEvent;
 import net.neoforged.fml.common.EventBusSubscriber;
@@ -21,6 +21,8 @@
 @EventBusSubscriber(modid = AnvilLibTest.MOD_ID)
 @Mod(value = AnvilLibTest.MOD_ID, dist = Dist.CLIENT)
 public class AnvilLibTestClient {
+    public static boolean renderSdfLayer = false;
+
     public AnvilLibTestClient() {
     }
 
@@ -46,6 +48,19 @@ public static void on(RegisterClientCommandsEvent event) {
                             Minecraft.getInstance().setScreen(new GuiTestScreen());
                             return 1;
                         })
+                ).
+                then(
+                    literal("declarative").
+                        executes(_ -> {
+                            Minecraft.getInstance().setScreen(new DeclarativeTestScreen());
+                            return 1;
+                        })
+                ).then(
+                    literal("sdf")
+                        .executes(_ -> {
+                            AnvilLibTestClient.renderSdfLayer = !AnvilLibTestClient.renderSdfLayer;
+                            return 1;
+                        })
                 )
         );
     }