initial commit

2026-09-16 21:04:28 +08:00
commit a29ca6846c
31 changed files with 2537 additions and 0 deletions
@@ -0,0 +1,28 @@
+sensor: finger
+revision: r01
+status: draft
+
+# Authoring unit in Blender (mm). Export converts using meters_per_source_unit.
+authoring_unit: mm
+meters_per_source_unit: 0.001
+
+source_blend: source/assembly.blend
+
+# Expected sensing surface topology for r01 (from shipped 30fps-0703 runtime).
+expected:
+  sensing_vertices: 1032
+  sensing_triangles: 1974
+
+frames:
+  world: world
+  camera: camera
+
+collections:
+  sensing_surface: SENSOR_SURFACE
+  housing: SENSOR_HOUSING
+  marker_pattern: MARKER_PATTERN
+  camera_rig: CAMERA_RIG
+
+notes: |
+  Legacy bootstrap blend is vtbs-blender/thumb.blend copied to source/assembly.blend.
+  Split into sensing-surface.blend + housing.blend when two people edit geometry.
@@ -0,0 +1,4 @@
+Optional golden outputs for regression:
+
+- `preview.png` — viewport or render still
+- `expected-metrics.json` — vertex counts, UV residual, bounding box in metres
@@ -0,0 +1,20 @@
+profile: compute
+description: Runtime sensing bundle consumed by orisys-sdk assets_dir
+
+output_dir: build/export/finger/r01/compute
+
+# Files must match orisys-sdk / Studio runtime layout.
+artifacts:
+  - mesh.npz
+  - camera_intrinsics.npz
+  - world_to_cam.npy
+
+# Measured unroll maps stay in SDK (not overwritten by nominal export).
+runtime_owned_by_sdk:
+  - unroll_map_uv_s0.4.npz
+
+validation:
+  # orisys-app validate_scene.py --legacy-dir <output_dir> --map <sdk unroll map>
+  require_sensing_surface_only: true
+  expected_vertices: 1032
+  expected_triangles: 1974
@@ -0,0 +1,20 @@
+profile: studio
+description: Compile a Studio .oryscene from compute export + SDK unroll map
+
+# Always compile from compute export, never from visualization/ pose mesh.
+compute_export_dir: build/export/finger/r01/compute
+
+# Measured field domain — lives in orisys-sdk, not this repo.
+unroll_map: orisys-sdk/sensors/finger/assets/30fps-0703/unroll_map_uv_s0.4.npz
+
+compile:
+  tool: orisys-app/tools/scene_assets/compile_scene.py
+  meters_per_source_unit: 0.001
+  output: orisys-app/apps/studio/config/sensors/finger/scene/finger-display-1.0.0.oryscene
+
+validate:
+  tool: orisys-app/tools/scene_assets/validate_scene.py
+
+notes: |
+  visualization/world_to_cam.npy is for SDK Dashboard viz_pose only.
+  Do not point Studio compile at assets/visualization/.
@@ -0,0 +1,14 @@
+# Source blends (Git LFS)
+
+Place `assembly.blend` here. Bootstrap from legacy:
+
+```powershell
+Copy-Item D:\orisys_ws\vtbs-blender\thumb.blend .\assembly.blend
+```
+
+Ensure Git LFS is installed before the first commit:
+
+```powershell
+git lfs install
+git add assembly.blend
+```
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4d88cd2e6604e95c44dd483ec5380797dcebdd02ff584b68fb2182bd8e24b511
+size 8256170