名前
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
xheight
の長方形に変更します。次のいずれかに該当する場合 (両方ではなく)幅または高さのパラメータに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
アセンブリ最適化をすべて無効にします。
バグ
バグはすべて Issue Tracker(https://issues.webmproject.org)に報告してください。
パッチをぜひご利用ください!開始するには、こちらのページ(https://www.webmproject.org/code/contribute/submitting-patches/)をご覧ください。
例
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 プロジェクト用に作成されました( 。