FFmpegで動画を回転させる方法と、回転情報だけ変える方法の違い

​​FFmpeg​ffprobe,H.264,コマンドライン,動画

スマホで撮った動画が横倒しで再生されるときは、FFmpeg で向きを直せます。方法は2つあります。transpose フィルターで映像そのものを回してエンコードし直す方法と、-display_rotation で「再生するときに何度回すか」という情報(回転の情報)だけを書き換える方法です。前者は時間がかかり画質も少し落ちますが、ファイルの中の映像そのものが正しい向きになります。後者は一瞬で終わり画質も変わりませんが、映像は元のままで、回すのは再生する側に任せます。横長の動画を時計回りに90度回して縦長にする例で、2つの方法の違いを検証環境で比べました。

補足

検証環境は Ubuntu 24.04.5、FFmpeg 6.1.1(Ubuntu のパッケージ 6.1.1-3ubuntu5)、libx264 0.164.3108 です。元の動画は、FFmpeg の testsrc2 で作った 1280×720、30fps、3秒の H.264 の動画(AAC の音声付き)です。再生したときの大きさは、Playwright に入っている Chromium 153 で確かめました。カメラやスマホで撮った動画、MP4 以外の形式、Chromium 以外のプレーヤーや動画サイトでの表示は試していません。

2つの方法のコマンド

映像そのものを時計回りに90度回すには、transpose=clock を使います。

bash
ffmpeg -i src.mp4 -vf "transpose=clock" -c:a copy out.mp4

回転の情報だけを付けるには、-display_rotation を使います。映像は -c copy で、エンコードし直さずにそのまま写します。

bash
ffmpeg -display_rotation -90 -i src.mp4 -c copy out.mp4

時計回りに90度回したいのに -90 と書くのは、ffmpeg のドキュメントにある -display_rotation の説明で、値は「表示する前に反時計回りに回す角度」と決められているためです。時計回りは負の数になります。

上に元の横長の動画のコマ、その下に transpose=clock で作り直した動画と、-display_rotation -90 で情報だけ付けた動画を並べた図。作り直した動画はファイルの中の映像がすでに 720×1280 の縦長。情報だけ付けた動画は、ファイルの中は 1280×720 の横長のままで、回転の情報 -90° があり、表示される向きは 720×1280 の縦長
2つの方法で、ファイルの中の映像と表示される向きがどう違うか

図の「表示される向き」は、FFmpeg で1コマ目を PNG に書き出したものです。どちらの方法でも 720×1280 の縦長になり、左上の画素はどちらも赤(RGB で 253, 0, 0)でした。元の動画では左下の角にあった色です。

結果を数字で比べる

2つの方法でできた動画を ffprobe で調べ、Chromium の <video> で読み込んだときの videoWidth・videoHeight も取り出しました。

transpose=clock -display_rotation -90
ファイルの中の映像の大きさ 720×1280 1280×720
回転の情報(ffprobe の rotation) なし -90
Chromium の videoWidth×videoHeight 720×1280 720×1280
かかった時間(time の real、1回ずつ測った値) 0.933 秒 0.059 秒
ファイルの大きさ 1,082,047 バイト 1,170,122 バイト(元と同じ)
元の動画との PSNR(平均) 45.23 dB inf(まったく同じ)

回転の情報だけを付けた動画は、映像のデータが元の動画とまったく同じです。映像のパケットの MD5 を比べると、どちらも bd62cc9eb57056ff18081451811756a1 でした。エンコードし直していないので、時間はほぼかからず、画質も変わりません。

transpose で作り直した動画は、libx264 で圧縮し直しています。回した映像を transpose=cclock で元の向きに戻し、元の動画と PSNR(2つの映像の差を表す値で、映像がまったく同じなら inf になります)で比べると、平均 45.23 dB でした。元とまったく同じではありません。エンコードの設定は初期値のままにしています。

回転の情報を確かめる

ffprobe をオプションなしで実行すると、映像のストリームの下に Side data: として回転の情報が出ます(必要な行を抜き出しました)。

text
  Stream #0:0[0x1](und): Video: h264 (High) (avc1 / 0x31637661), yuv420p(progressive), 1280x720 [SAR 1:1 DAR 16:9], 3037 kb/s, 30 fps, 30 tbr, 15360 tbn (default)
    Side data:
      displaymatrix: rotation of -90.00 degrees

幅と高さは 1280×720 のまま表示されます。値だけを取り出したいときは、-show_entries に stream_side_data=rotation を加えます。

bash
ffprobe -v error -select_streams v:0 -show_entries stream=width,height:stream_side_data=rotation -of compact=p=0 out.mp4

-90、90、180 を付けた動画の rotation は、それぞれ -90、90、-180 でした。180 を指定しても、ffprobe の rotation は -180 と出ます。Chromium で読み込むと、-90 と 90 の動画は 720×1280、180 の動画は 1280×720 でした。

情報が付いた動画を作り直すと、FFmpeg が自動で回す

回転の情報が付いた動画をフィルターなしで作り直すと、FFmpeg は映像を回してからエンコードします。-90 の情報を持つ動画をそのまま作り直したところ、出力は 720×1280 になり、回転の情報はなくなりました。-v debug で実行すると、FFmpeg が transpose を自分で入れているのが分かります。

text
[transpose @ 0x561ef5d40bc0] Setting 'dir' to value 'clock'
[transpose @ 0x561ef5d40bc0] w:1280 h:720 dir:1 -> w:720 h:1280 rotation:clockwise vflip:0

これは -autorotate という機能で、ffmpeg のドキュメントにある -autorotate の説明によると、初期設定で有効です。入力の前に -noautorotate を付けると、出力は 1280×720 のままで、rotation が -90 の情報も残りました。

このため、すでに回転の情報を持つ動画に、さらに transpose を指定すると、2回回ることになります。-90 の情報を持つ動画に -vf transpose=clock を付けて作り直すと、出力は 1280×720 でした。元の動画を上下左右に反転(hflip,vflip、つまり180度回転)したものと PSNR で比べると平均 45.15 dB、回さない元の動画とは 5.92 dB でした。映像は、元の動画を180度回したもの(上下が逆さま)になっていました。向きがおかしい動画を直す前に、ffprobe で回転の情報があるかを確かめておくと、この取り違えを防げます。

回転の情報を消す

回転の情報を外すときも -display_rotation を使い、0 を指定します。

bash
ffmpeg -display_rotation 0 -i in.mp4 -c copy out.mp4

-90 の情報を持つ動画にこのコマンドを使うと、ffprobe の出力から rotation がなくなりました。映像のパケットの MD5 は元と同じでした。なお、回転の情報を持つ動画を -c copy だけで写した場合は、rotation が -90 のまま残りました。

うまくいかない書き方

-display_rotation は入力に付けるオプションです。次のように -i のあとに書くと、エラーで止まりました。終了コードは234でした。

bash
ffmpeg -i src.mp4 -display_rotation -90 -c copy out/wrongpos.mp4
text
Option display_rotation (set pure counter-clockwise rotation in degrees for stream(s)) cannot be applied to output url out/wrongpos.mp4 -- you are trying to apply an input option to an output file or vice versa. Move this option before the file it belongs to.

メタデータの rotate で角度を書く方法は、FFmpeg 6.1.1 では次の警告が出ました。

bash
ffmpeg -i src.mp4 -metadata:s:v:0 rotate=90 -c copy out.mp4
text
Conversion of a 'rotate' metadata key to a proper display matrix rotation is deprecated. See -display_rotation for setting rotation instead.

この書き方で -c copy して作った動画には、ffprobe で見ても回転の情報がなく、Chromium でも 1280×720 のままでした。libx264 でエンコードし直した場合も、ffprobe で回転の情報は出ませんでした。回転の情報を付けるなら、-display_rotation を使います。

transpose は、値を付けずに使うと、単純な回転にはなりません。フィルターのドキュメントにある transpose の説明では、初期値は「反時計回りに90度回して上下を反転する」cclock_flip です。値なしで回した1コマ目の左上の画素は、元の動画の左上と同じ色(RGB で 122, 2, 248)でした。左右の向きが鏡に映したように入れ替わるので、回すときは clock(時計回り)か cclock(反時計回り)を書きます。

どちらを使うか

再生する場所が回転の情報を読めると分かっていて、画質を落としたくないなら、-display_rotation で情報だけを書き換えます。回転の情報を読むかどうか分からないソフトに渡すときや、ほかのフィルター(大きさの変更や切り抜き)と一緒にエンコードし直すときは、transpose で映像そのものを回します。エンコードし直す場合は、FFmpeg が回転の情報に合わせて自動で回すので、元の動画に情報があるなら transpose は付けずに作り直すだけで向きがそろいます。

​Posted by 86