docs: record render pipeline and i18n decisions

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
This commit is contained in:
Claude committed 2026-10-02 12:26:18 +00:00
1 parent 87c70eef4e
commit fc8c2aa3f8
1 file changed
+9
+9
View File
@@ -89,3 +89,12 @@ One line per decision: date · decision · alternative · reason.
| 2026-10-02 | Apply records a missing-data reason only where no advice exists; Optimise returns modules to Auto and only adds to the user's hero, exclusions, offset or output cap; a preset's own choices are stored as manual values, content-derived values stay Auto. | Overwrite | Manual values stay in force; re-analysis does not undo a chosen preset. |
| 2026-10-02 | Advisor namespace is `Titano.Core.Advice` (class `Advisor`). | `Titano.Core.Advisor` | A class named like its namespace needed an alias in every `Titano.Core.*` caller. |
| 2026-10-02 | CI also force-pushes each same-repository PR run's screenshots as one commit to the `ci-screenshots` branch (separate job, only it has `contents: write`). | Artifact only | Artifacts need an authenticated download; a branch can be fetched with plain git for visual review. The branch never merges and holds a single commit. |
| 2026-10-02 | Export fps is the encoded grid; `Timing.FrameRate` is the playback rate (source frames per video second, default = export fps). Durations are quantised to output periods on rounded 90 kHz boundaries; whole frames are sampled at the period centre. | One fps / free durations | Presets keep their meaning, Interpolated can synthesise slow motion, AVI and image sequences stay exact. |
| 2026-10-02 | Adaptive timing is proportional up to 3× the median interval; longer gaps show for 3 + log2(r/3) frames (max 5); pauses ≥ 20× median and ≥ 120 s become a 0.2 s cut. Interpolated fills gaps of up to 3 missing/excluded frames. | Fixed clamps | Bursts stay faithful and long gaps cannot stall the video. |
| 2026-10-02 | A non-monotonic time-remap curve is repaired (sorted, clamped, made non-decreasing) with a warning; virtual-camera keyframes are keyed to source frame positions. | Reject the curve / output frame index | The remap is always monotone; keyframes stay on the content when timing or fps change. |
| 2026-10-02 | Per frame: exposure → one warp (stabilisation⁻¹ ∘ camera ∘ crop) to output size → flow, synthesis and blur in output space → stacking → knee. Stabilisation zooms by 1/max(crop scale, 0.75), warning below 0.75. Modules run only when Auto resolves true. | Flow in source space / no zoom | A single resample; flow sees stabilised content; borders stay hidden. |
| 2026-10-02 | Blur fraction = BlurFraction(target × speed, real) / steps, speed clamped to 4, no blur across cuts. | Fixed fraction | The look survives speed changes. |
| 2026-10-02 | Encoding overlaps processing by one frame; image sequences encode up to one frame per core into a hidden `.tmp` folder renamed at the end, named `<name>/<name>_000001.ext`. | Strictly sequential / `frame_%05d` | 1080p PNG 1.0 → 2.5 fps; crash-safe and editor-friendly. |
| 2026-10-02 | JPEG/MJPEG use 4:4:4 at quality ≥ 90, else 4:2:0; HEVC/AV1 → H.264 fallback rescales the bit rate by bits-per-pixel; size capped to the highest level, then the encoder maximum; managed bit depth moves to the shallowest supported depth ≥ the request; linear DNG tiles are sized to the frame (≤ 256 px). | — | Predictable quality and sizes; small DNGs are ~3× smaller. |
| 2026-10-02 | `Auto<T>` carries `HasAdvice`; `Resolve` falls back only when there is no advice. | Treat `default` as "no advice" | A value type's advised 0/false was indistinguishable from "no advice". |
| 2026-10-02 | `i18n check` also treats any C# string literal shaped `Area.Group.Name` with an existing area as a used key. | Marker functions such as `LocKey(…)` | Reason and warning keys travel as data; 53 render/export keys had no resources and the check did not notice. |