フレーム生成
video-generate
video-generate パラメータは、動画からどのような画像出力を生成するかを制御します。
| 値 | 説明 |
|---|---|
animation | アニメーション画像を生成します。fm で形式を指定します (gif、webp、avif、png)。fm を省略した場合は GIF になります。 |
gif | video-generate=animation&fm=gif のレガシーエイリアスです。新しい実装では animation を推奨します。 |
thumbnail | 動画から静止画フレームを1枚抽出します。fm で出力形式を指定します (例：fm=jpg、fm=png)。 |
spritesheet | スプライトシート画像グリッドを生成します。詳細なパラメータは Spritesheets を参照してください。 |
animation
動画クリップからアニメーション画像を生成します。fm パラメータで出力形式を選択します：
fm 値 | 出力形式 |
|---|---|
gif (fm を省略した場合も同様) | アニメーション GIF |
webp | アニメーション WebP |
avif | アニメーション AVIF |
png | アニメーション PNG (APNG) |
jxl | アニメーション JXL (下記注記を参照) |
jpg およびその他の静止画専用形式 | 静止フレーム1枚 — animation フラグは無視されます |
JXL に関する注記： 現在の FFmpeg ビルドにはアニメーション JPEG XL エンコーダーが含まれていないため、Iris はまずアニメーション WebP を生成し、その後 imgix の下流パイプラインがアニメーション JXL に変換して配信します。
WebP と AVIF はフルカラーで、GIF よりもファイルサイズが大幅に小さくなります。アニメーション AVIF が最もファイルサイズを小さくできます。
クリップ範囲は clip パラメータで制御できます。
出力には任意のレンダリング API パラメータを適用できます。例えば、auto=compress,format で最適な圧縮を適用したり、fit でリサイズ方法を制御したりできます。
デフォルト値と上限：
| プロパティ | デフォルト | 上限 |
|---|---|---|
| 再生時間 | 5 秒 | 10 秒 (最小 0.25 秒) |
| フレームレート | 15 fps | 30 fps (ソースの fps を超えない) |
| 幅 / 高さ | 未指定の軸は 320 px | 各軸最大 640 px (ソース解像度を超えない) |
| ループ | 無限ループ | — |
ループ動作は video-loop で制御できます：video-loop を省略するか負の値を指定すると無限ループ、video-loop=0 で1回再生、video-loop=N で初回再生後に N 回追加再生されます。
gif
video-generate=animation&fm=gif のレガシーエイリアスです。後方互換性のために完全にサポートされていますが、新しい実装では明確さとすべてのアニメーション形式へのアクセスのために video-generate=animation&fm=gif を使用することを推奨します。デモとパラメータの詳細は animation セクションを参照してください。
thumbnail
動画から静止サムネイル画像を生成します。fm パラメータで出力画像形式を指定します (例：fm=jpg、fm=png)。
サムネイルフレームはカラーヒストグラムスコアリングを使用して最も代表的なフレームが自動選択され、単色フレームや黒フレームは回避されます。特定の時間のサムネイルを抽出するには、より細かい制御ができる video-thumbnail を使用してください。
fm=gif が同時に指定されている場合、video-generate=thumbnail が優先され、アニメーションではなく静止フレームが1枚返されます。
