コマンドライン引数

****** x265コマンドラインパラメータDaquan（詳細）**********



X265 Command Line Parameters Daquan



このパラメーターは、パラメーターがCLI ONLYとしてマークされていない限り、x265_param_parse（）でもサポートされます。 CLIは、getopt関数を使用してコマンドライン引数を解釈します。引数の長いバージョンと短いバージョンの両方を使用できます。長い引数は、あいまいさを引き起こすことなく短い引数に切り捨てることができます。 APIユーザーは、完全なパラメーター名をx265_param_parse（）に渡す必要があります。プリセットとチューンには特別な意味があります。 APIユーザーは、x265_param_parse（）を呼び出して他のパラメーターを設定する前に、予想されるプリセットを使用してx265_param_default_preset（）を呼び出し、値を調整する必要があります。 CLIはユーザーに対してこれを暗黙的に実行しているため、CLIのオプションは、コマンドライン引数の順序に関係なく、ユーザーのプリセットと調整の後に適用されます。コマンドラインに追加のパラメーター（非オプションパラメーターまたはパラメータープロパティ値）がある場合、CLIはそれを入力ファイル名として扱い、オプション–inputをオプションにします。追加のパラメーターが2つある場合、2番目のパラメーターは出力ストリームファイル名として扱われます。これにより、–outputがオプションになります（入力ファイル名がすでに暗示されている場合）。これにより、x265 in.y4mout.hevcが有効なコマンドラインになります。 3つ以上の追加パラメーターがある場合、CLIは、パラメーターが間違っていると判断すると、パラメーターを放棄します。

パラメータの説明：ロギング/統計



オプション--help、-h ：ヘルプ情報を表示する

-バージョン、-V： バージョン情報を表示する



-ログレベル： ログレベル。デバッグレベルは、各フレームのQP、メトリック、およびビットレートを記録します。 csvログファイルを作成する場合は、すべてのエンコーディングではなく、フレームごとに1回ログを書き込みます。フルレベルは、ハッシュと重みをログに書き込みます。 -1は、文字列 'none'で指定できる致命的なエラーを除くすべてのログを無効にします。ログレベル番号は次のとおりです。0–エラー1 –警告 2–情報（デフォルト） ； 3 –デバッグ； 4 –フル。 -進行なし： 定期的なコーディング進捗レポートをキャンセルします。

CLIのみ--csv ：エンコードされた結果を、さまざまな値のコンマ区切りのログファイルに書き込みます。このファイルが存在しない場合は作成してください。 --csv-log-levelが0の場合、-csv-log-levelが0より大きい場合は、実行するたびにログの行を追加し、-csv-log-levelが大きい場合は、フレームごとに1行のログを書き込みます。 2に等しい場合、複数のフレームの統計を取得できます。

CLIのみ--csv-log-level： CSVログレベル。 0 –要約（デフォルト） ； 1 –フレームレベル； 2 –パフォーマンス統計を含むフレームレベル。



CLIのみ --ssim、-no-ssim： SSIM（構造的類似性）値を計算して報告します。 ssimを測定する場合は、–tuneを使用することをお勧めします。そうしないと、結果を比較に使用できません。 デフォルトはdisable--psnr、-no-psnrです： PSNR（ピーク信号対雑音比）値を計算して報告します。 psnrを測定する場合は、–tuneを使用することをお勧めします。そうしないと、結果を比較に使用できません。 デフォルトは無効です

パフォーマンスオプション--asm、-no-asm： X265は、デフォルトで、検出されたすべてのCPUSIMDアーキテクチャを使用します。 –no-asmを試してSIMDアーキテクチャを無効にするか、MMX2、SSE、SSE2、SSE3、SSSE3、SSE4、SSE4.1、SSE4.2の文字列に一致するSIMDアーキテクチャの使用法のコンマ区切りリストを指定することもできます。 、AVX、XOP、FMA4、AVX2、FMA3、一部の高アーキテクチャは、使用可能な低アーキテクチャを意味し、CPU機能マップを直接提供することもできます。 注意： このパラメータオプションを指定すると、x265の自動検出が上書きされ、エラーが発生する場合があります。 CPUでサポートされていないSIMDスキーマ値を指定すると、コードがクラッシュする可能性があります。 デフォルト： SIMDアーキテクチャを自動的に検出

--frame-threads、-F： フレーム数は同時にエンコードされます。動き補償中にすべての参照フレームが使用可能であるため、単一のフレームスレッドを使用すると圧縮率がわずかに増加しますが、パフォーマンスに深刻な影響を及ぼします。デフォルトは、CPUコアの数と、WPPが有効になっているかどうかに応じて、自動検出です。フレームスレッドが多すぎるとパフォーマンスは向上しませんが、メモリのオーバーヘッドが増加します。 値： 0 –16の間の任意の数。 デフォルト：0、自動検出。

--pools , --numa-pools : NUMAノードごとにコンマで区切られたスレッドのリストがあります。 'none'の場合、ワークプールの作成はなく、フレームの並列化のみが可能である可能性があります。 NULLまたは ''（デフォルト）の場合、x265のすべてのスレッドがすべてのNUMAノードで使用されます。

--wpp、-no-wpp： ウェーブフロントコーディング。エンコーダは、現在のラインの上の少なくとも1つのCTU（コーディングツリーユニット）がエンコードプロセスにある限り、ラインのエンコードを開始できます。これにより、並列化が3〜5倍になり、圧縮率が約1％増加します。スレッドプールが利用できない場合、この機能は暗黙的にオフになります。 デフォルト：オン

--pmode、-no-pmode： 並列モードまたは分散モード。有効にすると、エンコーダーは各CUの分析（マージ、インター、イントラ）を複数のワーカースレッドにデプロイします。このモードは、x265がCPUコアを飽和させない場合にのみ推奨されます。。 -rectがオンの場合、RDレベルは3または4であり、これが最も効率的です。 RDレベルが5または6の場合、通常、CPUがまだ飽和していないと仮定して、CPUが過剰に実行されていることを確認するのに十分な作業が行われます。--pmodeは、圧縮を減らすことなく使用率を上げます。実際、このモードは並列モードで測定されるため、一部の非現実的なパターンが途中で終了します。そのため、通常、オンにすると圧縮率がわずかに向上します（スキップする可能性は低くなります）。パターンにはコストがかかります）。 Pmodeが早期終了をバイパスすると、特にプリセットの方が速い場合、エンコード速度が低下します。この機能は、スレッドプールがない場合は暗黙的に閉じられます。

--pme、-no-pme： 並列モーション推定。有効にすると、モーション検索を必要とする特定のCUへの参照が3つ以上ある場合、エンコーダーはモーション推定を複数のワーカースレッドにデプロイして動作させます。このモードは、x265がCPUコアを飽和させない場合にのみ推奨されます。。 --pmodeは、より多くの作業を分散するため、このオプションよりも効率的です。 --pmeオプションをオンにすると、並列処理の利点を超えて作業が分散されることは一般的にまれです。この機能は、スレッドプールがない場合は暗黙的に閉じられます。

-プリセット、-p： コーディング効率とコーディング速度の間で妥協するために、いくつかのプリセット値が提供されています。このパラメーターは、他の入力パラメーターを適用する前に有効にする必要があるため、これらの値によって制御されるパラメーター値はすべてオーバーライドできます。デフォルトのパラメータ値は次のとおりです：0 –超高速1 –超高速2 –超高速3 –高速4 –高速 5-中（デフォルト） ； 6 –遅い； 7 –遅い； 8 –非常に遅い； 9 –プラセボ。

--tune、-t： 特定のビデオソースまたはシーンを設定します。このパラメーターは、プリセットの後、他のすべてのパラメーターの前に設定されます。 デフォルト：なし値： psnr、ssim、grain、zero-latency、fast-decode

入出力ファイルオプション これらのオプションは、入力ビデオシーケンス、または--ditherの場合は、エンコード前に実行される操作を記述するために使用されます。ファイルを処理するためのすべてのオプション（名前、形式、オフセット、フレーム数）は、コマンドラインインターフェイス（つまりCLI）にのみ適用されます。

CLIのみ--y4m： ファイルのサフィックス名を無視し、入力ストリームをYUV4MPEG2として解釈します。このオプションは、入力ファイル名に「.y4m」サフィックスが含まれている場合に暗黙的に示されます。

CLIのみ--input-depth： YUVのみ有効：ファイルまたはストリームのピクセルビット深度を入力します。 値： 8〜16の任意の値。 デフォルト： 内部ピクセル深度。

CLIのみ-フレーム： エンコードされると予想されるフレームの数。指定できない場合もありますが、この値を指定すると、レート制御はこの情報を利用します。また、エンコーディングが実際に静的イメージグレードエンコーディング（単一フレーム）であるかどうかを判断するためにも使用できます。 -ディザ： 高品質をエンコーダのビット深度まで下げることができます。ジッタは、画像内のピクセルの次の行に広がる1行のピクセルのエラーに基づいており、入力のビット深度が8ビットより大きい場合にのみこのオプションを適用する必要があります。デフォルトはオフです。

CLIのみ--input-res： YUVのみが有効です：元の画像のサイズ[w x h]

CLIのみ--input-csp： クロマダウンサンプリング（YUVのみ）：現在、4：0：0（モノクロ）、4：2：0、4：2：2、4：4：4のみがサポートされています。入力するクロマダウンサンプリング形式は、出力するクロマダウンサンプリング形式と一致する必要があり（libx265はクロマダウンサンプリング変換を実行しません）、指定したHEVCファイルでもサポートされている必要があります。 0. i400（4：0：0モノクロ）-メインおよびメイン10グレードは1をサポートしません。i420（4：2：0デフォルト）-すべてのHEVCグレードは2をサポートします。I422（4：2：2）-メイン、メイン10およびメイン12グレードは3をサポートしていません。i444（4：4：4）-メイン、メイン10、メイン12、メイン16サポート4. nv12 5. nv16

--fps： YUVのみ：元のフレームレート 値の範囲： 正の整数、浮動小数点数、または分子/分母

--interlace、-no-interlace： 0.プログレッシブ画像（デフォルト）1。上部フィールド2.最初の下部フィールドHEVCは、インターレースされたコンテンツをフィールドとしてエンコードします。エンコーダに正しいフィールド順序を提供します。ソースサイズはフィールドのサイズである必要があり、FPSは1秒あたりのフィールド数である必要があります。デコーダーは、フィールドの方向に従って表示するために再組み立てする必要があります。

- 求める ： ファイルの先頭でスキップするフレーム数を入力します。 デフォルトは0です。

-フレーム、-f： シーケンスでエンコードするフレーム数を入力し、 デフォルト0（すべて） 。

CLIのみ -出力、-o： 出力ファイル名。追加のCLIオプションが2つある場合、最初のオプションは暗黙的に入力ファイル名であり、2番目のオプションは出力ファイル名であるため、-outputオプションは不要です。出力ファイルには常に元のHEVCビットレートが含まれており、CLIはコンテナファイル形式をサポートしていません。

CLIのみ--output-depth、-D 8 | 10 | 12： 出力HEVCビットストリームのビット深度は、エンコーダ内部のビット深度でもあります。必要なビット深度が接続されたlibx265ビットの深度と同じでない場合、8ビットエンコーダーの場合はlibx265_main、10ビットエンコーダーの場合はlibx265_main10、12ビットエンコーダーの場合はlibx265_main12をバインドしようとします。同じAPIをlibx265バージョンに接続します。出力のビット深度が指定されていないが、-profileが指定されている場合、出力ビット深度はプロファイルの名前から取得されます。 プロファイル、レベル、ティア 

 --profile, 
 -P 
 
 ： Force the requirement of a specified grade to ensure that the output stream of the decoder can be modified to support the specified level. If the specified level is not supported by the encoder's compile option (the high bit depth encoder cannot output a bit stream compatible with Main or MainStillPicture), it is possible to discard the encoder.
X265は次のグレードをサポートします：-8ビットグレード：* main、main-intra、mainstillpicture（または略してmsp）* main444-8、main444-intra、main444-stillpicture-10ビット* main10、main10-intra * main422-10、main422 -10-intra * main444-10、main444-10-intra-12ビットグレード：* main12、main12-intra * main422-12、main422-12-intra * main444-12、main444-12-intra CLIONLYAPIユーザーはx265_param_apply_profileを呼び出す必要があります（）パラメータ構造を設定した後。呼び出し後にパラメータ構造を変更すると、エンコーダに互換性がなくなる可能性があります。 --output-depthが指定されていない場合、CLIアプリケーションはプロファイルの名前から出力ビット深度を取得します。
 --level-idc 
 
 
 ： The lowest level of decoding required. The default value of 0 means that it is automatically detected by the encoder. If a value is specified, the encoder will assign some specified rules within the specified level. If the encoder does not reach this level, it will give a warning and abandon the encoder. If the required level is higher than the actual level, the actual demand level is sent.
注意 デコードセクターを指定すると、エンコーダーは定レートファクターエンコードのVBVをオンにする必要があり、不確実性が生じる可能性があります。値は浮動小数点数または整数（レベルに10を掛けたもの）として指定されます。例：レベル5.1は「5.1」または「51」として指定でき、レベル5.0は「5.0」または「50」として指定できます。 付録Aレベル： 1、2、2.1、3、3.1、4、4.1、5、5.1、5.2、6、6.1、6.2、8.5
 --high-tier, 
 
 --no-high-tier 
 
 ： in case --level-idc is specified, --high-tier allows to support the high level of that level. The encoder is first coded at the specified level and master level, and the high level is only turned on if necessary and the high level of that level is available. If the level you are requesting does not support a high level, then the high level will not be supported. If --no-high-tier is specified, the encoder will only encode at the main level.
デフォルト：オン
 --ref 
 
 
 ： L0 The maximum number allowed by the reference sequence. This number has a linear multiplier effect on the motion search, but usually has a beneficial effect on compression and distortion rates.
 
 --allow-non-conformance, 
 
 --no-allow-non-conformance 
 
 ： Allows libx265 to specify a profile and no level to generate a bitstream. If the strict level condition is not met, the default is to discard any encoding. The two most likely reasons are: --ctu is too small, --ref is too large, or the bit rate or resolution is outside the specified conditions.
デフォルト：オフ
 --uhd-bd  
 
 ： Allows support for HD Blu-ray Disc format. If it is specified that it is not compatible with the encoding option, the encoder will try to correct or set the correct encoding configuration. If the encoder can't do this, then this option will be turned off. Highly experimental.
デフォルト：閉じる注： --profile、-level-idc、および--high-tierは、リソースの制約が制限された特定のデコーダーを構築し、これらの制限の下でビットストリームを含める場合にのみ使用します。グレードまたはレベルを指定すると、これらのニーズを満たすためにエンコーディング品質パラメータが低下する可能性がありますが、それらを向上させることはありません。 CRFエンコーディングでは、VBV制約がオンになる場合があります。また、x265はデコーダーのレベルとレベルを決定するために3つのステップを使用することに注意してください。まず、推奨されるエンコードオプションを使用してx265_param構造を構成してから、x265_param_apply_profile（）を呼び出して、特定のレベル（main、main10など）を強制します。次に、x265_paramのインスタンスを使用してエンコーダーを作成します。 --level-idcおよび--high-tierパラメーターは、特定のターゲットレベルを達成するために、ストリームまたはその他の機能を削減するために使用されます。 。最後に、エンコーダーは最終パラメーターセットを再度チェックし、ビットストリームのヘッダーに送信される最低のデコード要件レベルをチェックします。ユーザーが高レベルを指定した場合にのみ、検出されたデコードレベルが高レベルを使用します。送信されるグレードは、エンコーダの内部ビット深度と入力色空間によって決まります。 --keyintが0または1の場合、フレーム内変数が送信されます。 --total-framesが1の場合、静的イメージ変数が送信されますが、特にCLIが標準入力ストリームまたはlibx265を使用するサードパーティアプリケーションによって使用される場合、このパラメーターはアプリケーションによって常に設定されるとは限りません。 モード決定/分析
--rd
 
 
：
モードの意思決定におけるRDOレベル。値が大きいほど、より多くのレート歪み最適化を使用して、パターン分析に時間がかかります。値が小さいほど、エンコード速度は速くなります。一般に、値が大きいほど、ビットストリームは小さくなります。 デフォルト：3 注：以下の表は正確さのためのものですが、必ずしも各パターンの最終的な動作であるとは限りません。 
 このオプションは、コーディングユニットのクアッドツリーに影響し、予測クアッドツリーと呼ばれることもあります。
--ctu,
 
-s
 
 
 ： Maximum CU size (width and height). The larger the value, the higher the efficiency of x265 encoding the flat area of ​​the image, and the more the code stream is reduced. However, this leads to loss of parallelism, less CU line parallel coding, and less frame parallel coding. For this reason, if the preset selects the fast, the size of the CU is set to 32. Default: 64 
--min-cu-size
 
 
：
 
--limit-refs
 
 
：
 
--limit-modes,
 
--no-limit-modes
 
：
 
--rect,
 
--no-rect
 
：
 
--amp,
 
--no-amp
 
：
 
--early-skip,
 
--no-early-skip
 
：
 
--rskip,
 
--no-rskip
 
：
 
--fast-intra,
 
--no-fast-intra
 
：
 
--b-intra,
 
--no-b-intra
 
：
 
--cu-lossless,
 
--no-cu-lossless
 
：
 
--tskip-fast,
 
--no-tskip-fast
 
：
 
--rd-refine,
 
--no-rd-refine
 
：
 
--analysis-mode
 
 
：
 
--analysis-file
 
 
：
 
--rdoq-level
 
,
 
--no-rdoq-level
 
：
 
--tu-intra-depth
 
 
：
 
--tu-inter-depth
 
 
：
 
--nr-intra
 
,
 
--nr-inter
 
 
：
 
--tskip,
 
--no-tskip
 
：
 
--rdpenalty
 
 :
 
--max-tu-size
 
 :
時間/モーション検索オプション
--max-merge
 
 :
 
--me
 
 :
 
--subme,
 
-m
 
 :
 
--merange
 
 :
 
--temporal-mvp,
 
--no-temporal-mvp :
 
--weightp,
 
-w,
 
--no-weightp :
 
--weightb,
 
--no-weightb :
空間/イントラオプション
 --strong-intra-smoothing, 
 
 --no-strong-intra-smoothing : 
 
 --constrained-intra, 
 
 --no-constrained-intra : 
心理視覚的オプション
 --psy-rd 
 
  : 
 
 --psy-rdoq 
 
  : 
スライス決定オプション
 --open-gop, 
 
 --no-open-gop : 
 
 --keyint, 
 
 -I 
 
  : 
 
 --min-keyint, 
 
 -i 
 
  : 
 
 --scenecut 
 
 , 
 
 --no-scenecut : 
 
 --intra-refresh : 
 
 --rc-lookahead 
 
  : 
 
 --lookahead-slices 
 
  : 
 
 --b-adapt 
 
  : 
 
 --bframes, 
 
 -b 
 
  : 
 
 --bframe-bias 
 
  : 
 
 --b-pyramid, 
 
 --no-b-pyramid : 
つづく！