rigayaの日記兼メモ帳

- Visual Studio 2022に移行。
- .NET Framework 4.8に移行。
- パッケージのフォルダ構成を変更。
- 同梱のx265を更新。(x265 3.5+35)
- 簡易インストーラによるインストールを廃止。
- パスが指定されていない場合、exe_files内の実行ファイルを検索して使用するように。
- ログに使用した実行ファイルのパスを出力するように。
- 相対パスでのパスの保存をデフォルトに。

- 拡張編集使用時の映像と音声の長さが異なる場合の動作の改善。
拡張編集で音声を読み込ませたあと、異なるサンプリングレートの音声をAviutl本体に読み込ませると、音声のサンプル数はそのままに、サンプリングレートだけが変わってしまい、音声の時間が変わってしまうことがある。

拡張編集使用時に、映像と音声の長さにずれがある場合、これを疑ってサンプリングレートのずれの可能性がある場合は音声のサンプル数を修正する。

- エンコードするフレーム数が0の場合のエラーメッセージを追加。
- ログの保存に失敗すると、例外が発生していたのを修正。
- ログの保存に失敗した場合にその原因を表示するように。

- muxエラーの一部原因を詳しく表示するように。
mp4出力で対応していない音声エンコーダを選択した場合のエラーメッセージを追加。

- エラーメッセージ
「x264が予期せず途中終了しました。x264に不正なパラメータ（オプション）が渡された可能性があります。」
の一部原因を詳しく表示するように。
1. ディスク容量不足でエンコードに失敗した場合のエラーメッセージを追加。
2. 環境依存文字を含むファイル名- フォルダ名で出力しようとした場合のエラーメッセージを追加。
3. Windowsに保護されたフォルダ等、アクセス権のないフォルダに出力しようとした場合のエラーメッセージを追加。

---

x265guiEx 4.xxから導入方法が変更されています。新しい導入方法は、x265guiEx 4.xxの導入方法をチェックしてください。

---

ダウンロード>>

x265guiEx 4.xxの導入方法

---

どうも、Aviutlの拡張編集側の音声と本体側の音声読み込み機能が競合する場合があるようです。

まず、拡張編集で動画を読み込みます。この動画の音声(これを音声Aとします)が48kHz, 10秒だったとします。このとき、音声のサンプル数は48万(10秒 x 48k)です。



次に、誤って44.1kHz, 5秒の音声をAviutl本体側に読み込ませたとします(これを音声Bとします)。



この状態では、音声としてはこの音声Bが対象となっており、Aviutlのプレビューに5秒以降音声は表示されません。また、x264guiExで出力すると音声としては音声Bが出力されます。映像と音声の長さが食い違い(映像:10秒と音声B:5秒)が生じますし、拡張編集側の音声を出力したかった場合、意図しない音声が出力されることになります。

---

さらにこの状態から、拡張編集でシーン切り替えを行います。(例えば、Root→Scene1→Root)



こうすると、Aviutlのプレビューに拡張編集側の音声波形が戻ってきます。



プレビューで流れる音声も音声Aのものです。しかし、サンプリングレートは音声Bと同じく44.1kHzのままな一方、サンプル数は音声Aの48万のままです。そのため、この状態でx264guiExで出力しようとすると、サンプル数は48万のままのため、480000/44.1k=10.88秒の音声になってしまい、映像と音声の長さが食い違い、音声だけが長い動画が出力されます。

そこで、x264guiEx 3.04では、こうしたときに音声の長さを映像にそろえて出力するようにしました。今回の例だと、サンプリングレートが44.1kHzで10秒間なので、44万1000サンプルとして出力します。これで、映像と音声の長さの一致した自然な動画が出力できます。




ただ、これは緊急回避的な対処方法なので、こういう不思議な現象が起こるため、拡張編集使用時にはそもそもAviutl本体側に音声を読み込まないよう注意いただければと思います。

---

出力時には、いろいろなエラーが発生する可能性があって、ログにある程度エラーメッセージが出ているけど、中にはわかりににくかったり、区別しにくかったりするものもある。

web上を検索して、遭遇する方の多そうなエラーメッセージのうち、原因がわかっているものについて、なるべくエラーではまる方が減らせるように、わかりやすいメッセージを出せるよう調整した。

---

ダウンロード>>

ソースはこちら

---

変更の詳細

---

エラーメッセージ1:
x264が予期せず途中終了しました。
x264に不正なパラメータ(オプション)が渡された可能性があります。

x264が異常終了するエラーの汎用メッセージ。本当にパラメータが適切でないこともあるが、そうでないこともある。

---

パターン1-1: 環境依存文字 (ファイル)

Aviutlはユニコード非対応のため、SJIS(CP932)非対応のいわゆる環境依存文字には対応していない。そのため、環境依存文字を含むファイル名で出力しようとするとエラーが発生する。


mp4 [error]: cannot open output file `F:\temp\sakura_op?.mp4'.
x264 [error]: could not open output file `F:\temp\sakura_op?.mp4'
auo [error]: x264が予期せず途中終了しました。x264に不正なパラメータ(オプション)が渡された可能性があります。

? のところが問題の文字。この場合、明らかに「x264に不正なパラメータ(オプション)が渡された可能性があります」はエラーメッセージとしてはよろしくない。

x264guiEx 3.02では改良してこんな感じにした。

auo [error]: 映像の出力ファイル "F:\temp\sakura_op?.mp4" を開くことができません。
auo [error]: ファイル名、ディレクトリ名、またはボリューム ラベルの構文が間違っています。

auo [error]: このエラーは、出力ファイル名に環境依存文字を含む場合に発生することがあります。
auo [error]: 該当文字は、"?"で表示されていますので該当文字を避けてファイル名で出力しなおしてください。

---

パターン1-2: 環境依存文字 (フォルダ)

フォルダ名が環境依存文字を含む、という場合もある。この場合も同じエラーになっていた。

mp4 [error]: cannot open output file `F:\temp\てすと?\sakura_op.mp4'.
x264 [error]: could not open output file `F:\temp\てすと?\sakura_op.mp4'
auo [error]: x264が予期せず途中終了しました。x264に不正なパラメータ(オプション)が渡された可能性があります。

x264guiEx 3.02ではフォルダ名の問題だと表示できるようになった。

auo [error]: 出力先フォルダを認識できないため、出力できません。
auo [error]: 出力ファイル名: "F:\temp\てすと?\sakura_op.mp4"
auo [error]: 出力先フォルダ: "F:\temp\てすと?"
auo [error]: このエラーは、上記出力先のフォルダ名に環境依存文字を含む場合に発生することがあります。
auo [error]: 該当文字は、"?"で表示されています。
auo [error]: 環境依存文字を含まないフォルダに出力先に変更して出力しなおしてください。

---

パターン1-3: アクセス権の問題

アクセス権がない場所に出力しようとした場合にも同じようにエラーが起こる。特にWindows Vista以降、ユーザーが自由にファイルを置けない場所があって、こういうった場所に出力しようとしたときによく起こる。

mp4 [error]: cannot open output file `C:\sakura_op.mp4'.
x264 [error]: could not open output file `C:\sakura_op.mp4'
auo [error]: x264が予期せず途中終了しました。x264に不正なパラメータ(オプション)が渡された可能性があります。

かなり気づくのは難しいエラーメッセージになってしまっているので、x264guiEx 3.02ではアクセス権の問題だと表示できるようにした。

auo [error]: 映像の出力ファイル "C:\sakura_op.mp4" を開くことができません。
auo [error]: アクセスが拒否されました。

auo [error]: このエラーは、アクセス権のないフォルダ、あるいはWindowsにより保護されたフォルダに
auo [error]: 出力しようとすると発生することがあります。
auo [error]: 出力先のフォルダを変更して出力しなおしてください。
auo [error]: なお、下記はWindowsにより保護されたフォルダですので、ここへの出力は避けてください。
auo [error]: 例: C: ドライブ直下
auo [error]: C:\Windows 以下
auo [error]: C:\ProgramData 以下
auo [error]: C:\Program Files (x86) 以下
auo [error]: など

---

パターン1-4: 空き容量の問題

ドライブの空き容量が足りない場合もこんな感じで同じエラーが出ていた。

auo [info]: x264 options...
--crf 23 --frames 3501 --input-res 1280x720 --input-csp nv12 --fps 30/1 -o "D:\sakura_op.mp4" "-"
raw [info]: 1280x720p 0:0 @ 30/1 fps (cfr)
x264 [info]: using cpu capabilities: MMX2 SSE2Fast SSSE3 SSE4.2 AVX FMA3 BMI2 AVX2
x264 [info]: profile High, level 3.1, 4:2:0, 8-bit
mp4 [error]: failed to append a video frame.
x264 [info]: frame I:40 Avg QP:18.38 size: 42507
x264 [info]: frame P:739 Avg QP:22.12 size: 14793
x264 [info]: frame B:1350 Avg QP:25.07 size: 3449
x264 [info]: consecutive B-frames: 8.7% 8.4% 35.4% 47.5%
x264 [info]: mb I I16..4: 20.3% 67.1% 12.6%
x264 [info]: mb P I16..4: 6.2% 14.5% 1.2% P16..4: 33.0% 10.5% 5.9% 0.0% 0.0% skip:28.8%
x264 [info]: mb B I16..4: 0.8% 1.3% 0.1% B16..8: 32.5% 2.6% 0.4% direct: 2.1% skip:60.2% L0:41.6% L1:52.0% BI: 6.4%
x264 [info]: 8x8 transform intra:65.9% inter:78.9%
x264 [info]: coded y,uvDC,uvAC intra: 33.0% 46.6% 13.4% inter: 9.4% 14.3% 0.8%
x264 [info]: i16 v,h,dc,p: 41% 31% 9% 18%
x264 [info]: i8 v,h,dc,ddl,ddr,vr,hd,vl,hu: 25% 24% 33% 3% 3% 3% 4% 3% 4%
x264 [info]: i4 v,h,dc,ddl,ddr,vr,hd,vl,hu: 25% 19% 18% 6% 8% 8% 7% 6% 4%
x264 [info]: i8c dc,h,v,p: 56% 25% 16% 3%
x264 [info]: Weighted P-Frames: Y:19.4% UV:18.7%
x264 [info]: ref P L0: 68.6% 13.0% 13.2% 5.1% 0.1%
x264 [info]: ref B L0: 85.1% 12.6% 2.3%
x264 [info]: ref B L1: 96.9% 3.1%
x264 [info]: kb/s:1948.90

aborted at input frame 2194, output frame 2128
encoded 2128 frames, 309.21 fps, 1948.35 kb/s
auo [error]: x264が予期せず途中終了しました。x264に不正なパラメータ(オプション)が渡された可能性があります。

本質的には、"failed to append a video frame."のところが原因でそこを見ればわかるのだが、「x264に不正なパラメータ～」と出るせいで逆にわかりにくくなってしまっている。

これをx264guiEx 3.02ではより直接的なメッセージに変更した。

auo [error]: x264が予期せず途中終了しました。
auo [error]: Dドライブの空き容量が残り 0.03 MBしかありません。
auo [error]: Dドライブの空き容量不足で失敗した可能性があります。
auo [error]: Dドライブの空きをつくり、再度実行してみてください。

---

エラーメッセージ 2.
mux後ファイルが見つかりませんでした。

---

muxは最終工程のため、いろいろなエラーが起こりやすい。

その中で、原因のはっきりしているものについて対策した。

auo [error]: mux後ファイルが見つかりませんでした。
auo [error]: L-SMASH muxer でのmuxに失敗しました。
auo [error]: muxのコマンドラインは…
auo [error]: ".\exe_files\muxer_x64.exe" --file-format m4v -i "F:\temp\sakura_op.1.mp4"?fps=30/1 --file-format m4a -i "F:\temp\sakura_op.1.tmp.wav" --optimize-pd -o "F:\temp\sakura_op.1_muxout.mp4"
L-SMASH muxer [error]: iTunes MP4 muxing mode
L-SMASH muxer [error]: Track 1: H.264 Advanced Video Coding
L-SMASH muxer [error]: Error: the input seems Uncompressed Audio, at present available only for QuickTime file format.
L-SMASH muxer [error]: Error: failed to open input files.

Uncompressed Audio、ようはWAV出力はmp4コンテナに入れられない、というエラー。

同じパターンで、"L-SMASH muxer [error]: [importer: Error]: failed to find the matched importer." というのもあって、mp4コンテナに対応していない音声エンコーダを選択した場合に発生する。

すこしだけわかりにくいのと、そもそも動画エンコード後にエラーを出すのではなくて、エンコード前にチェックするべき、ということで、x264guiEx 3.02では動画のエンコード開始前にチェックを行うようにした。

auo [error]: 音声エンコーダ WAV出力 は、mp4 形式での出力に対応していません。
auo [error]: AAC (ffmpeg) 等の他の音声エンコーダを選択して出力してください。

---

こんな感じで、いくつかのわかりにくいエラーメッセージを改良してみた。エラーではまる方が少なくなるとよいのだが…

最後に、現状原因や再現方法がわからないエラーを紹介。

---

原因や再現方法のわからないエラー

---

その1: 音声の長さが動画の長さと大きく異なるようです。

Aviutlから渡された情報に基づいて計算される動画の秒数と音声の秒数が相当(50%以上)ずれている、という警告。音ズレなどの原因になるのだが、どうすれば発生するのかさっぱりわからない。

拡張編集の選択範囲等の問題という話もあるが、いまいち再現方法がわからない…。

---

その2: mux後ファイルが小さすぎます。
auo [error]: mux後ファイルが小さすぎます。 muxに失敗したものと思われます。
L-SMASH muxer [error]: iTunes MP4 muxing mode
L-SMASH muxer [error]: Track 1: H.264 Advanced Video Coding
L-SMASH muxer [error]: Error: failed to get the last sample delta.

先ほどのまったくmux後のファイルができないものとは異なり、一応mux処理は始まるがすぐエラー終了してしまうもの。エラーメッセージからは、mux時の映像ファイルの読み込みで失敗しているのがわかる。おそらくエンコード後(のはずの)映像ファイルが破損(上書き? 他のプログラムで開かれた?)されているなどしていると思う。

ただ、どうやったら起こるのか、というのがよくわからない。ログを載せてくれている方もログもみたが、動画のエンコードは正常終了しているみたいだった。

これも拡張編集の選択範囲等の問題というのを見かけたが、手元で適当に試した限りだと、短い選択範囲にしても特に問題は生じなかった。

---

エラーや、エラーでなくても戸惑うポイントの例

・Onedrive/google driveでどれをダウンロードしていいかわからない。
旧バージョンのフォルダとかが紛らわしい。それに、やはり最近はgithubのほうが馴染み深いかもしれない。

・zipファイルを展開せずに簡易インストーラを実行してエラー
明示的に展開しなくてもよい( = 開くだけでよい) ようにしたい。

・簡易インストーラで、ダウンロードに失敗
→ すでにx264等の実行ファイルは同梱済み。VC runtimeのダウンロードに失敗している?

・簡易インストーラで、Aviutlのパス指定に戸惑う
やはりほかのプラグインと同じように、エクスプローラーでファイルコピーのほうが直感的。

・x264guiExがAviutlに認識されない
Windows 8.1/10/11環境を一通り確認したが、Windows Updateをしていれば.NET Frameworkは自動的に導入されていることがほとんど。ということはVC runtimeがインストールされていないのだと思う。これもやはり簡易インストーラでのVC runtimeのダウンロードに失敗するのが根本的な原因かもしれない。

・「ファイルの出力に失敗しました。」といきなり出る
・neroaacencが存在しない…
設定がなされていない場合(あるいは飛んだ)に起こる。x264guiEx 2.72で前回出力時の設定を自動で読み込むようにして対策済み。

・x264.exe の場所が指定されていません。
簡易インストーラを使用していればパスは自動的に入っているはずだが、設定が飛んで空欄になったとか、あるいは指定されているけど存在しないというケースがあるようだ。

そもそも、実行ファイルのパスの指定というのがややこしく厄介に思われる方も多いようだ。ということはパスの指定をしなくても動くようにする必要がある。

・x264に不正なパラメータ（オプション）が渡された可能性があります。
わからん。英語のエラーメッセージを読む、あるいは、とりあえずデフォルトで出力してください…。

・qaacエンコードに失敗する
・CoreAudioToolbox.dll:指定されたモジュールが見つかりません。
とりあえず AAC (ffmpeg) をデフォルトにして対策したつもりだが、古いx264guiExをお使いの方だろうか?

・音声の長さが動画の長さと大きく異なるようです。
わからん…なぜだ…

・muxに失敗する
・mux後ファイルが見つかりませんでした
muxerの指定が間違っているケースとかもあるようだが、多くは原因不明。(ひとつひとつ細かく見ればわかるだろうが…)

たまにmuxerがウイルス対策ソフトにウイルス扱いされて消される場合もあってこれが一番厄介(気づかないし)。

---

x264guiEx 3.00の変更

ということで、発生するエラーは多岐に及ぶので、もう少し改善する必要がありそう。

さらに導入しやすくして、エラーを発生しづらくするため、x264guiEx 3.00では、

・導入時はzipファイルの中身をAviutlフォルダにコピーするだけ
→ 簡易インストーラを起動する導入法は廃止する
→ とにかくすべて同梱する (ダウンロードエラーの回避)

・設定しなくてもすぐ使用できる
→ パスの指定をしなくてもいいように

ようにしてみた。これで、導入がうまくいかないケースが減ってくれるとよいのだが…。

---

3.00に上げるのと同時にいくつか変更をしている。

・簡易インストーラによる導入を廃止。
「中身をAviutlフォルダにコピーするだけ」なのでいらなくなった。実際にはAviutl起動時に動かす感じ。

※実行ファイルのパスを指定している場合、x264が自動では更新されなくなる(古い実行ファイルのパスのままになる)ので注意してください。

・Visual Studio 2022に移行。
せっかくなので開発環境も移行した。

・.NET Framework 4.8に移行。
これまでx264guiExは.NET Framework 4.5.2ベースだったが、これは2022/4/26までがサポート期限だということなので、4.8に移行することにした。

.NET Framework 4.8はWindows Updateが行われていれば、Win8.1/Win10 1903以降/Win 11では導入済みのことを確認したので、これらの環境で動くのなら特に問題はないはず。

・パッケージのフォルダ構成を変更。
「中身をAviutlフォルダにコピーするだけ」のために必要な変更。

x264guiExプラグインだけでなく必要な実行ファイル(x264.exe, ffmpeg_audenc.exe, muxer.exe, remuxer.exe)、さらにVC runtimeをインストールするのに必要な実行ファイルもすべて同梱して、ダウンロードに失敗する可能性をなくした。

ウイルス対策ソフトに消される可能性は残るけど、それはいかんともしがたい。

・配布場所をgithubに移行。
onedriveやgoolge driveに置いていると、zipファイルの中をスキャンして、挙句実行ファイルをウイルス扱いしてzipを削除するようなトラブルが起こることがあった。

・実行ファイルのパスが指定されていない場合、exe_files内の実行ファイルを検索して使用するように。
「設定しなくてもすぐ使用できる」に必要な変更。

パスを指定しなくても、zipファイルと同じフォルダ構成であれば、実行ファイルを自動で見つけて使用するようにした。

したがってパス設定欄が空白でも問題ありません。

もちろん、今まで通りパスを指定して使用することもできる。

・ログに使用した実行ファイルのパスを出力するように。
自動で見つけたといっても結局どれを使ってるの? というのを確認するため。

・mp4box向け設定ファイルを廃止。
継続的なテストが困難で、また導入時の迷いのもととなるため。

・相対パスでのパスの保存をデフォルトに。
Aviutlをフォルダごと移動してもなるべく問題が生じないようにするため。

---

x264guiEx 3.01での修正
・x264/音声エンコーダの指定がないときの設定画面のエラーを回避。

・設定画面でパス指定がないときは実行ファイルを自動選択することを表示するように。
こんな感じで、ただパスの指定欄を空欄にしておくのではなくで、exe_files内から自動選択することを明示するようにした。

---

x264guiEx 3.00 の導入・更新方法はこちら。
x264guiEx 3.00 の削除方法はこちら。

---

ダウンロード>>

ソースはこちら

---

x264guiEx 3.00の導入の流れは、上記リンクの通りだけど、実際の動きはどうなっているかというと

1. exe_filesとpluginsフォルダをすべてAviutlフォルダにコピーする。

2. この状態でAviutlを起動する。

3. pluginsフォルダ内のauo_setup.aufがAviutlにx264guiEx.auoより先に読み込まれる。

auo_setup.aufは、これは0個のフィルタを登録するフィルタプラグインで、初期化時にVC runtimeと.NET Frameworkのチェックを行う。(ほとんどの環境で.NET FrameworkはOS標準でインストール済み)

VC runtimeのチェックにはexe_files内のcheck_vc.dll、.NET Frameworkのチェックにはcheck_dotnet.dllを使用する。

VC runtimeなどのインストールが必要なら、exe_files内のauo_setup.exeを実行し、これが同じくexe_files内のVC_redist.x86.exeを呼ぶなどして、VC runtimeをインストールする。

なお、このプラグインの作成方法として、こちらの資料を参考にさせていただきました。ありがとうございました。
あるフィルタプラグインのfunc_initより必ず先に実行する

4. auo_setup.aufの処理が終わると、x264guiEx.auoをロードする条件は整っているので、問題なくロードできる。

とこんな感じなので、一度導入が完了したら、auo_setup.aufは削除しても構いません(もちろんしなくてもよい)。

今回からauo_setupのソースコードも公開することとしました。こちらに置いてあります。