Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

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

クローズ
  • 何か問題がありますか？
#6,556 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
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
平均マージ
12時間 19分
マージ済み PR（30日）
762

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

heygen-com/hyperframes のほかの issue

heygen-com/hyperframes の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。