Hacktoberfest 2026：维护者为十月标记出来的 issue，仍然开放、适合新手。 浏览 Hacktoberfest issue

HDR layered composite repeats video frames: ~50% duplicates when the source <video> is HLG

未关闭
  • 哪里不对？
#6,556 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
52/100
Issue 类型
缺陷
描述清晰度
描述清楚
活跃度
活跃
技术栈
typescript

调研方向

Start at the HDR auto-promotion and capture_hdr_layered path named in the report, then trace how it captures and composites the extracted video frames. The report confirms the frame cache contains 300 distinct frames, so compare those with frames from the HDR layered output and use the SDR render as a control. Done means the HLG render preserves all source frames without duplicates.

由索引模型根据 Issue 内容生成。

描述

Summary

When a composition contains an HLG (HDR) <video>, the render auto-promotes to HDR and goes through the HDR layered composite path. In that path the output repeats video frames: about half of the frames are duplicates of the previous one, so playback visibly stutters. The same composition with an SDR copy of the same clip renders every frame correctly.

Reproduction

A blank project from npx hyperframes init with one full-frame video. No other elements or animation.

# 10 s, 30 fps HLG test clip (synthetic, so every source frame is distinct)
ffmpeg -f lavfi -i "testsrc2=size=1920x1080:rate=30" -f lavfi -i "sine=frequency=440" -t 10 \
  -c:v libx265 -pix_fmt yuv420p10le \
  -x265-params "colorprim=bt2020:transfer=arib-std-b67:colormatrix=bt2020nc" \
  -tag:v hvc1 -c:a aac -shortest assets/hlg.mp4

# SDR control clip
ffmpeg -f lavfi -i "testsrc2=size=1920x1080:rate=30" -f lavfi -i "sine=frequency=440" -t 10 \
  -c:v libx264 -pix_fmt yuv420p -c:a aac -shortest assets/clip.mp4

<div id="root" data-composition-id="main" data-start="0" data-duration="10" data-width="1920" data-height="1080">
  <video id="footage" class="clip" src="assets/hlg.mp4" data-start="0" data-duration="10"
         data-track-index="0" data-has-audio="true"></video>
</div>
<script>
  const tl = gsap.timeline({ paused: true });
  window.__timelines["main"] = tl;
  tl.seek(0);
</script>

npx hyperframes render --quality draft --output out.mp4

# count distinct frames (300 expected)
ffmpeg -i out.mp4 -vf "mpdecimate=hi=200:lo=100:frac=0.1,showinfo" -an -f null - 2>&1 | grep -c pts_time

Results

Source Distinct frames in output Render time
SDR H.264 (clip.mp4) 300 / 300 9.9 s
HLG HEVC 10-bit (hlg.mp4) 155 / 300 34.5 s
Real iPhone HLG recording (8-bit re-encode, HLG tags kept) 64 / 302 —

The log for the HLG run shows HDR auto-promotion triggered by "assets/hlg.mp4", then capture_hdr_layered with captureMode: screenshot, useLayeredComposite: true. The frames HyperFrames extracts into its frame cache are all distinct (checked: 300/300), so the repeats appear to come from the layered capture/composite step rather than from extraction.

--experimental-fast-capture=false, --workers 1, and an all-intra source (-g 1 -bf 0) did not change the result.

Expected

Every source frame appears once in the output, as with SDR input.

Environment

  • hyperframes 0.8.208 (also seen on 0.8.206)
  • macOS 15.7.9, Apple M1 Pro
  • Google Chrome 156.0.8078.48 (hardware GPU)
  • FFmpeg 8.1.1

Workaround

Tone-map the HLG clip to SDR BT.709 before using it in a composition. iPhones record HDR (HLG / Dolby Vision) by default, so phone footage hits this path without the author choosing HDR.

主要语言
TypeScript
星标
54.1k
派生
4.9k
平均合并
15 小时 19 分钟
30 天内合并 PR
769

环境准备

这个项目没有提供开发容器、Dockerfile 或贡献指南，环境需要你自己搭建：先看它的 README，通用步骤见我们的新手贡献指南。

从这里开始

  1. 先读完整个 Issue，再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库，在一个分支上完成修改。
  4. 提交 Pull Request，并在描述里引用这个 Issue 编号。

heygen-com/hyperframes 的其他 Issue

查看 heygen-com/hyperframes 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。