Skip to content

Frame generation: CPU reference of the per-call configuration - #173

Merged
phantoslayer21 merged 1 commit into
mainfrom
fg/ref-config
Nov 14, 2026
Merged

phantoslayer21 merged 1 commit into
mainfrom
fg/ref-config

Conversation

@phantoslayer21

Copy link
Copy Markdown
Owner

The frame-generation configuration values that are already settled, as a CPU reference (lane h). None of these values changes the networks or their weights.

clean/fg/reference/config.py

  • intermediate_time(n, i): the time of the generated frame, t = i / (N + 1), computed as one single-precision division (numpy float32).
  • check_multi_frame(n, i, *, n_max, extra_index=False): N must be in 1..cap and i in 1..N. With extra_index set, i may also be N + 1.
  • Flags: multi_frame_active(n) (N > 1) and last_index(i, maximum).
  • ui_recomposition(app_setting, profile_value) and preset(): UI recomposition off is preset A, on is preset B. A profile value of 1 or 0xFFFFFE forces it off, 2 or 0xFFFFFF forces it on, and any other value leaves the application's setting.

OPEN items are required arguments; nothing here picks them:

  • the cap on N (n_max);
  • the extra mode that accepts i = N + 1 (extra_index);
  • which maximum "last index" compares with (maximum).

The private override that can turn UI recomposition off is OPEN and not modelled. clean/fg/FORMATS.md has a new "Configuration" section and OPEN item 10.

Refs #96

Tested

  • python -m unittest clean.fg.tests.test_fg_config: 6 tests pass locally.
    • t matches the exactly rounded binary32 quotient for every N up to 63 and every i up to N + 1, and differs from the double-precision value.
    • The index rules and their errors, including the missing cap and non-integer counts.
    • Every forcing profile value, and other values with both application settings.
  • The whole clean/fg test set passes. The line-ending check and the public gates pass, with no hits in clean/fg.

Not tested

  • Nothing compared with the original at run time; the stages that use t are not delivered yet.

clean/fg/reference/config.py: the multi-frame intermediate time t = i / (N + 1)
as one single-precision division, the index checks and the two flags, and UI
recomposition (preset A / B) with the profile values that force it. The cap on N,
the further mode accepting i = N + 1 and the maximum the last-index flag uses
are OPEN: required arguments, listed in FORMATS.md.

Refs #96

Signed-off-by: phantoslayer21 <156617979+phantoslayer21@users.noreply.github.com>
@phantoslayer21
phantoslayer21 marked this pull request as ready for review November 14, 2026 16:04
@phantoslayer21
phantoslayer21 merged commit 684cb20 into main Nov 14, 2026
9 checks passed
@phantoslayer21
phantoslayer21 deleted the fg/ref-config branch November 14, 2026 16:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant