cwebp

名前

cwebp -- 画像ファイルを WebP ファイルに圧縮します。

概要

cwebp [options] input_file -o output_file.webp

説明

cwebp は、WebP 形式を使用して画像を圧縮します。入力形式は次のいずれかです。 PNG、JPEG、TIFF、WebP、または未加工の Y'CbCr サンプル。 注: アニメーションの PNG ファイルと WebP ファイルはサポートされていません。

オプション

基本的なオプションは次のとおりです。

-o string
出力 WebP ファイルの名前を指定します。省略すると、cwebp によって実行されます 統計情報のみを報告できます。 「-」の使用出力名は「stdout」に出力するためです。
-- string
入力ファイルを明示的に指定する。このオプションは、入力シーケンスが 「-」で始まるファイルできます。このオプションは last と指定する必要があります。 それ以降のその他のオプションは無視されます。
-h, -help
使用状況の概要。
-H, -longhelp
使用可能なすべてのオプションの概要。
-version
バージョン番号を出力して（major.minor.revision として）終了します。
-lossless
画像をロスせずにエンコードします。完全に透明な領域の画像の場合は 見えないピクセル値（R/G/B または Y/U/V）が保持されるのは、 -exact オプションが使用されている。
-near_lossless int
ほぼ可逆な画像前処理のレベルを指定します。このオプションでは 圧縮率を高めるが、画質への影響は最小限である 向上します可逆圧縮モードが自動的にトリガーされます。 範囲は 0（最大前処理）～100（前処理なし、 デフォルト）。通常は約 60 です。なお、-q 100 での非可逆圧縮には、 良い結果が得られる場合もあります。
-q float

RGB チャンネルの圧縮係数を 0～100 で指定します。デフォルトは 75 です。

非可逆圧縮の場合（デフォルト）では、係数が小さいほど圧縮率が小さくなります。 画質は低下します。最適な品質を実現するには、次の値を使用します。 100。

可逆圧縮の場合（-lossless オプションで指定）、 小要素の場合、圧縮速度は速くなりますが、生成されるファイルが大きくなります。 最大圧縮を達成するには、100 の値を使用します。

-z int

0 の範囲で指定した lossless 圧縮モードをオンにします レベル 0 が最速、9 が最速となります。高速モード 遅い場合よりもファイルサイズが大きくなります。適切なデフォルト値は -z 6 です。 このオプションは、事前定義された画質設定へのショートカットです あります。オプション -q または -m が続けて使用された場合、これらのオプションは このオプションの効果は無効になります。

-alpha_q int

アルファ圧縮の圧縮係数を 0 から の間で指定します 100。アルファの可逆圧縮は、100 の値を使用して実現されます。 値が小さいほど非可逆圧縮になります。デフォルトは 100 です。

-preset string

特定の種類の事前定義済みパラメータを指定して、 あります。有効な値: default、photo、picture、 drawing、icon、text。

-preset は他のパラメータを上書きするため、値（-q は除く） このオプションは、可能であれば、 渡します。

-m int

使用する圧縮方法を指定します。このパラメータで取引を管理します。 エンコード速度と圧縮ファイルのサイズや品質は大きく異なります。 有効な値の範囲は 0～6 です。デフォルト値は 4 です。高い場合 値が使用されると、エンコーダは追加の入力データの検査に 品質向上について判断します値が小さいほど、 処理時間が速くなりますが、ファイルサイズは大きくなりますが、 適しています。

-crop x_position y_position width height

左上隅が座標がある長方形にソースを切り抜きます （x_position、y_position）、サイズ width×height。この切り抜き 領域はソースの長方形内に完全に含める必要があります。注: トリミングは 適用される。

-resize width height

ソースを width x height の長方形に変更します。次のいずれかに該当する場合 （両方ではなく）幅または高さのパラメータに 0 が指定されている場合、値は次のようになります。 計算を行います。注: スケーリングは 切り抜きます。

-mt

可能であれば、エンコードにはマルチスレッドを使用します。

-low_memory

非可逆エンコードのメモリ使用量を、圧縮データの 4 倍を節約して削減 サイズ（通常）を指定します。これによりエンコードが遅くなり、出力が 若干異なります。このフラグは デフォルトでオフになっています。このフラグをオフのままにすると、 副作用がビットストリームに 現れます （強制的に 1 に設定）などの機能があります。なお、 これを使用すると、ビットストリーム サイズの詳細レポートが cwebp によって出力されます。 選択します。

ロッシー オプション

これらのオプションは、非可逆エンコード（デフォルトでは、 。

-size int
圧縮ファイルで試行するターゲット サイズ（バイト単位）を 出力です。コンプレッサーはいくつかのパスを実行し、部分的なエンコーディングを ターゲットにできるだけ近づけます-size と -psnr が使用されている場合は、-size 値が優先されます。
-psnr float
圧縮出力を達成しようとするターゲット PSNR を dB 単位で指定します。 コンプレッサーは、部分的なエンコーディングを何度かパスして、 できるだけ近い目標に 近づけます-size と -psnr の両方を使用すると、 -size の値が優先されます。
-pass int
オプションで使用する二分法の間に使用するパスの最大数を設定する -size または -psnr。最大値は 10、デフォルトは 1 です。if オプション -size または -psnr が使用されましたが、-pass が指定されていません（デフォルト値） /「6」使用されます。-pass を指定し、なおかつ -size も -psnr の場合、40 dB の目標 PSNR が使用されます。
-af
オートフィルタを有効にします。このアルゴリズムは最適化に多くの時間を費やします バランスのとれた品質を実現します。
-jpeg_like
内部パラメータ マッピングを変更して、予想されるサイズに合わせて JPEG 圧縮。通常、このフラグを使用すると、 JPEG と同等のサイズ（同じ -q 設定）ですが、 ひずみが軽減されます

詳細オプション:

-f int
ブロック解除フィルタの強度を 0（フィルタリングなし）の間で指定します と 100（最大フィルタリング）。値を 0 にすると、フィルタリングがオフになります。 値が大きいほど、適用されるフィルタリング処理の強度が高くなります。 デコードします。この値が大きいほど、画像が滑らかになります。 が表示されます。一般的な値は通常 20～50 の範囲内です。
-sharpness int
フィルタのシャープネスを指定します（使用する場合）。範囲は 0（最もシャープ） 7（シャープ度が最も低い）に設定します。デフォルトは 0 です。
-strong
強力なフィルタリングを使用する（-f オプション）。強力なフィルタリングはデフォルトでオンになっています。
-nostrong
強力なフィルタリングを無効にする（-f 代わりにシンプルなフィルタリングを使用します。
-sharp_yuv
必要に応じて、より正確でシャープな RGB -> YUV 変換を使用します。なお、 デフォルトの「fast」よりも遅いRGB から YUV への変換。
-sns int
空間ノイズ シェーピングの振幅を指定します。空間ノイズ シェーピング （略して sns）は組み込みアルゴリズムの一般的なコレクション 比較的少ないビット数を使用する領域を 決定するために使われます 転送すべき場所を特定します指定可能な範囲は 0（アルゴリズムはオフ）～100（最大効果）。デフォルト値は 50 です。
-segments int
sns のセグメンテーションで使用するパーティション数を変更する アルゴリズムです。セグメントは 1～4 の範囲で指定してください。デフォルト値は 4 です。 このオプションは、メソッド 3 以降では機能しません。ただし、-low_memory が あります。
-partition_limit int
一部のマクロブロックで使用されるビット数を制限することで品質を低下させます。 範囲は 0（デグラデーションなし、デフォルト）～100（フル デグラデーション）です。 やや大きい画像の場合、通常は 30～70 程度の値が有効です。イン VP8 形式の場合、いわゆるコントロール パーティションの上限は 512k で、 （マクロブロックが元の状態にあるか、 どのセグメントに属するか、イントラ 4x4 または イントラ 16x16 モード あります。非常に大きな画像の場合、512K でも、 16x16 マクロブロック。絶対的な最小値は、マクロブロックあたり 4 ビットである。スキップ、 セグメント、モードの情報は、これら 4 ビットのほとんどすべてを 非常に大きな画像で問題が発生します。「 partition_limit 要素は、最もビットコストの高いモードの頻度を制御します （イントラ 4x4）が使用されます。これは、512,000 の上限に達している場合に有用です。 「Error code: 6」というメッセージが表示されます。 （PARTITION0_OVERFLOW: パーティション #0 は大きすぎて 512k に収まりません）。次を使用する場合: -partition_limit では 512k の制約を満たすには不十分であるため、 セグメントを少なくして、マクロブロックあたりのヘッダービット数を増やします。詳しくは、 -segments オプション。-m オプションと -q オプションも エンコーダの判断と、この上限に達する能力に大きく影響します。

ロギングのオプション

出力レベルは、以下のオプションで設定します。

-v
追加情報（特にエンコード時刻）を出力する。
-print_psnr
平均 PSNR（ピーク信号対雑音比）を計算してレポートします。
-print_ssim
平均 SSIM（構造的類似性指標、 https://en.wikipedia.org/wiki/SSIM）
-print_lsim
局所的類似度指標（最も低い誤差の合計）を計算してレポートする あります。
-progress
エンコードの進行状況をパーセントで報告します。
-quiet
何も印刷しないでください。
-short
テスト用の簡単な情報（出力ファイルサイズと PSNR）のみを出力する 提供します。
-map int
エンコード情報の追加の ASCII マップを出力します。マップに指定できる値 範囲は1～6です。これはデバッグを支援することのみを目的としています。

その他のオプション

より高度なオプションは次のとおりです。

-s width height
入力ファイルが実際に未加工の Y'CbCr サンプルで構成されていることを指定します 準拠しています。「 luma プレーンのサイズは width × height です。
-pre int
前処理ステップを指定する。値を 2 にすると、トリガーされます。 RGBA から YUVA への変換時の品質依存擬似ランダム ディザリング （非可逆圧縮のみ）。
-alpha_filter string
アルファ プレーンの予測フィルタリング方法を指定します。次のいずれか none、fast、または best（複雑で遅い順）。 デフォルトは fast です。内部では、アルファ フィルタリングに 4 つの 可能な予測（なし、水平、垂直、勾配）。best 各モードが順番に試行され、出力レベルが小さい方の 指定します。fast モードでは、何も記述せずに事前推測を試行します。 すべてのモードをテストします
-alpha_method int
アルファ圧縮に使用するアルゴリズムを 0 または 1 で指定します。アルゴリズム 0 は圧縮が行われないことを示し、1 は圧縮に WebP 可逆形式を使用します。 デフォルトは 1 です。
-exact
透明な領域で RGB 値を保持します。デフォルトではオフになっています 圧縮性に優れています。
-blend_alpha int
このオプションでは、アルファ チャンネル（存在する場合）とソースが 0xrrggbb の 16 進数で指定される背景色。アルファ版 チャネルは後で不透明な値 255 にリセットされます。
-noalpha
このオプションを使用すると、アルファ版チャンネルは破棄されます。
-hint string
入力画像のタイプに関するヒントを指定します。有効な値: photo、 picture または graph。
-metadata string

次の場合に入力から出力にコピーするメタデータのカンマ区切りのリスト できます。有効な値: all、none、exif、icc、xmp。デフォルトは none です。

各入力形式では、すべての組み合わせがサポートされていない場合があります。

-noasm

アセンブリ最適化をすべて無効にします。

バグ

例

cwebp -q 50 -lossless picture.png -o picture_lossless.webp
cwebp -q 70 picture_with_alpha.png -o picture_with_alpha.webp
cwebp -sns 70 -f 50 -size 60000 picture.png -o picture.webp
cwebp -o picture.webp -- ---picture.png

著者

cwebp は libwebp の一部で、WebP チームが作成したものです。 最新のソースツリーは次の URL から入手できます。 https://chromium.googlesource.com/webm/libwebp/

このマニュアル ページは Debian プロジェクト用に作成されました（ 。