Initial commit: RHINE LAB · ANALYSIS OS：三维界面与动效实验（本仓库不含个人归档索引数据）

2026-09-19 13:04:56 +08:00
commit 3f422218a5
1098 changed files with 39410 additions and 0 deletions
@@ -0,0 +1,101 @@
+import assert from "node:assert/strict";
+import * as THREE from "three";
+import { CardAppearance } from "../src/appearance.ts";
+
+const appearance = new CardAppearance();
+const high = new THREE.MeshPhysicalMaterial({
+  color: "#fffdfa",
+  transmission: 0.9,
+  roughness: 0.21,
+  attenuationColor: "#eee6df",
+  attenuationDistance: 2,
+});
+const low = new THREE.MeshPhysicalMaterial({
+  color: "#fff7ed",
+  transmission: 0.78,
+  roughness: 0.28,
+  attenuationColor: "#d4c7b4",
+  attenuationDistance: 1.2,
+});
+appearance.register("Frosted_Polymer", high, low);
+const group = new THREE.Group();
+const body = new THREE.Mesh(new THREE.BoxGeometry(), high);
+body.userData.surface = "Frosted_Polymer";
+group.add(body);
+appearance.prepare(group);
+appearance.apply(group, 0);
+assert.ok(body.material.color.equals(low.color));
+assert.equal(body.material.transmission, low.transmission);
+assert.ok(body.material.attenuationColor.equals(low.attenuationColor));
+assert.equal(body.material.attenuationDistance, low.attenuationDistance);
+let last = body.material.transmission;
+for (let i = 1; i <= 100; i++) {
+  appearance.apply(group, i / 100);
+  assert.ok(
+    Math.abs(body.material.transmission - last) < 0.00121,
+    "Surface changes continuously",
+  );
+  last = body.material.transmission;
+  assert.ok(
+    body.material.attenuationColor.equals(
+      low.attenuationColor.clone().lerp(high.attenuationColor, i / 100),
+    ),
+  );
+  assert.equal(
+    body.material.attenuationDistance,
+    THREE.MathUtils.lerp(1.2, 2, i / 100),
+  );
+}
+assert.ok(body.material.color.equals(high.color));
+assert.equal(body.material.transmission, high.transmission);
+assert.ok(body.material.attenuationColor.equals(high.attenuationColor));
+
+// Opaque glTF surfaces may be Standard materials without absorption properties.
+const opaque = new THREE.MeshStandardMaterial({ color: "#c7beb6" });
+appearance.register("Opaque", opaque, opaque.clone());
+const solid = new THREE.Mesh(new THREE.BoxGeometry(), opaque);
+solid.userData.surface = "Opaque";
+const solids = new THREE.Group();
+solids.add(solid);
+appearance.prepare(solids);
+assert.doesNotThrow(() => appearance.apply(solids, 0.5));
+
+// Default unbounded absorption must not turn into NaN during interpolation.
+const clear = new THREE.MeshPhysicalMaterial();
+appearance.register("Clear", clear, clear.clone());
+const glass = new THREE.Mesh(new THREE.BoxGeometry(), clear);
+glass.userData.surface = "Clear";
+solids.add(glass);
+appearance.prepare(solids);
+appearance.apply(solids, 0.5);
+assert.equal(glass.material.attenuationDistance, Infinity);
+appearance.dispose(solids);
+
+// A file selected again while descending must keep its own material state.
+const returning = group.clone(true);
+appearance.prepare(returning);
+appearance.apply(returning, 0.37);
+appearance.apply(group, 0.81);
+assert.notEqual(returning.children[0].material, body.material);
+assert.equal(returning.children[0].userData.appearance.value, 0.37);
+assert.equal(body.userData.appearance.value, 0.81);
+appearance.apply(returning, 1e-8);
+assert.ok(
+  Math.abs(returning.children[0].material.transmission - low.transmission) <
+    1e-8,
+  "Array handoff has the same surface",
+);
+
+const shader = {
+  uniforms: {},
+  vertexShader: "#include <begin_vertex>",
+  fragmentShader: "#include <color_fragment>\n#include <roughnessmap_fragment>",
+};
+body.material.onBeforeCompile(shader, null);
+assert.equal(shader.uniforms.archiveQuality, body.userData.appearance);
+assert.ok(shader.fragmentShader.includes("roughnessFactor = mix(0.28"));
+appearance.dispose(returning);
+assert.ok(body.material.color.r > 0);
+console.log(
+  "Appearance interpolation, independent returning materials, shader uniform and array handoff: passed",
+);