Eyevinn / hi264

87%

Build Type

push

github

Committed by tobbee

Commit Message

feat: fractional -fps and NTSC drop-frame timecode

Let -fps express fractional rates and add drop-frame timecode counting.

- hi264gen -fps now accepts an integer (25), a rational (30000/1001), or
  an NTSC decimal (29.97/59.94/23.976, snapped to the exact 1001 fraction).
  For mp4 the media timescale is the numerator and each sample lasts the
  denominator ticks, so fractional rates play at the correct speed
  (ffprobe reports r_frame_rate=30000/1001). Timecodes count at the
  nominal integer rate round(fps); -kbps->bpp uses the exact ratio.
- hi264gen -drop-frame: NTSC drop-frame counting, validated to 29.97/59.94.
  Drops the two (rate 30) / four (rate 60) lowest timecode labels at each
  minute except every tenth, and signals it in the pic_timing SEI via
  counting_type=4 and per-frame cnt_dropped_flag. Applies to both the
  burnt-in -text timecode and the SEI.
- yuv.FormatTextTC: text formatter variant taking the counting rate and
  drop-frame; FormatText is the integer/non-drop wrapper.
- encode.PicTimingConfig.DropFrame / PicTiming.Dropped carry the
  counting_type / cnt_dropped_flag into the SEI.
- Docs: cover pic-timing, start-frame, fractional fps, and drop-frame in the
  curated hi264gen usage header and the CLAUDE.md feature list / CLI examples
  (README and CHANGELOG updated alongside the relevant changes).

Verified: 30000/1001 mp4 timescale=30000 dur=1001; NDF rolls at frame 30;
drop-frame frames 1798..1802 -> 59:28, 59:29, 01:00:02, 01:00:03, 01:00:04
(labels ;00/;01 skipped), ffprobe renders ';'; -drop-frame rejected for 25
fps; ffmpeg decodes both; all 12 hi264gen golden checks still pass.

Coverage Stats

88 of 99 new or added lines in 3 files covered. (88.89%)

264 existing lines in 5 files now uncovered.

8124 of 9298 relevant lines covered (87.37%)

1.01 hits per line