動画プログレスバー

再生位置インジケーターを動画フレームに焼き込みます — スライドするバーまたは周囲を囲む枠線として表示されます。

不明な値は警告とともにオフにフォールバックします。

2つのスタイル

bar — スライドするバー。 上端または下端に固定されたフルワイドのカラーバーです。クリップ開始時は空で、再生に合わせて左から右へ広がり、最終フレームでフルワイドになります。色は video-progress-bar-color、太さは video-progress-bar-height、位置は video-progress-bar-align で制御します。

frame — 周囲を囲む枠線。 フレームの左下隅から2方向に向かって成長する枠線です — 一方は左端を上って上端を横切り、もう一方は下端を進んで右端を上り、100% でフレームの右上に到達します。下端のバーがキャプションやテロップと重なる場合に有効です。frame は4辺すべてを使うため video-progress-bar-align は無視されます。

進行の計算方法

バーは出力の長さに対して塗り進みます — トリム (video-clip-*) やスピード変更 (video-speed) 後の長さを基準にします。

静止画 (fm=jpg/png/webp) では、インジケーターは t / duration の値で固定表示されます。t は video-thumbnail のシーク時刻です。デフォルトの静止画 (シーク 0) では空のバーが表示されます。

スコープ

プログレスバーはすべての動画出力でアニメーションします: MP4/WebM、HLS/DASH (各レンディション)、アニメーション GIF、プレビューリール。静止画では静止表示されます。スプライトシートでは無効化され、音声のみ出力には非対応です。

バーは最前面のレイヤーです。インジケーターを描画したレンダーは X-Imgix-Video-Operations に progress-bar を記録します。

既知の制限。 video-loop と組み合わせると、バーは最初の再生のみ正しく塗り進み、繰り返し再生では塗り直しは行われません。