fix algining xynova texture to uv printing fixture.

2026-09-29 16:33:31 +08:00
parent 267334d543
commit 37e3e8400b
33 changed files with 758477 additions and 886701 deletions
@@ -70,6 +70,25 @@ texture_patch:
 texture_patch_views:
  enabled: true
  pattern_camera: cam_sensor     # the pattern every layout carries, same source as `compute`
+  # Per-view page sizing. A layout authored by Project from View (Bounds) maps [0,1]^2 to the
+  # image-plane extent of the mesh through ITS camera, so the page is measurable and differs
+  # per view: measured 17.5116 x 15.9772 mm for uv_1 (aspect 1.0960) and 17.5114 x 15.9820 mm
+  # for uv_2 (aspect 1.0957). `vector:` above says 16.4 x 16.0 (aspect 1.0250), which stretched
+  # the artwork by 6.9% along u. `auto` derives it and proves the layout really is a
+  # bounds-projection from the named camera before using the result.
+  #
+  # `px_per_mm: 200` reproduces the existing density exactly (3280/16.4 = 3700/18.5 = 200.0),
+  # and the page is set from the rounded raster so page and raster always share an aspect.
+  #
+  # `fixed` keeps `texture_patch.vector`. Unwrapped layouts (`produce`, `compute`) are not
+  # projections and must use it — a camera-derived page would be meaningless there.
+  #
+  # To overlay a texture on a render from its camera: set the render resolution to the emitted
+  # raster size and the background image to "Stretch to fill". At any other resolution the
+  # scene aspect (1280x720 here) will distort the overlay regardless of the page.
+  page:
+    mode: auto
+    px_per_mm: 200
  pairs:
    - id: uv_1                   # layout authored from cam_uv_1
      camera: cam_uv_1           # REGION camera: what this pair may own