initial commit

2026-09-16 21:04:28 +08:00
commit a29ca6846c
31 changed files with 2537 additions and 0 deletions
@@ -0,0 +1,3 @@
+sensor: finger
+revision: r01
+status: draft
@@ -0,0 +1,35 @@
+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/geometry.blend
+
+# Expected sensing surface topology for r01 (from shipped 30fps-0703 runtime).
+# First exports from geometry.blend may differ until topology is locked.
+expected:
+  sensing_vertices: 1032
+  sensing_triangles: 1974
+
+frames:
+  sensor: origin_sensor
+
+objects:
+  sensing_surface: sensing_surface
+  cam_sensor: cam_sensor
+  origin_sensor: origin_sensor
+
+collections:
+  frames: FRAMES
+  export_compute: EXPORT_COMPUTE
+  assembly: ASSEMBLY
+  design_sim: DESIGN_SIM
+  exclude: EXCLUDE
+
+notes: |
+  Canonical source is geometry.blend with named collections and objects.
+  Compute export uses sensing_surface + cam_sensor relative to origin_sensor.
+  Studio observation cameras are derived from mesh bounds; no cam_viz required.
@@ -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,16 @@
+# Source blends (Git LFS)
+
+Canonical file: `geometry.blend`
+
+Required objects (by name):
+
+- `sensing_surface` — in `EXPORT_COMPUTE`
+- `cam_sensor` — in `DESIGN_SIM`
+- `origin_sensor` — Empty in `FRAMES` (sensor-frame datum)
+
+Ensure Git LFS is installed before the first commit:
+
+```powershell
+git lfs install
+git add geometry.blend
+```
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:928a0012a17b68f3de9bab42bd9314fa8661f62f624d6460f6c1918ba17813f5
+size 769866
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:cdceb6bb091a7f8e1f820063c18b84ea9fa686949381f6d7b1cee74d63c27c18
+size 677092
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c92c9d800d22e37f161a9ee4a29b53ff514b7c1d224575a91c5144237cf39963
+size 650206