Ad
cwebp
-- Resim dosyasını WebP dosyası olarak sıkıştırın
Özet
cwebp [options] input_file -o output_file.webp
Açıklama
cwebp
, WebP biçimini kullanarak bir resmi sıkıştırır. Giriş biçimi PNG, JPEG, TIFF, WebP veya ham Y'CbCr örnekleri olabilir.
Not: Animasyonlu PNG ve WebP dosyaları desteklenmez.
Seçenekler
Temel seçenekler şunlardır:
-o string
- Çıkış WebP dosyasının adını belirtin. Atlanırsa
cwebp
gerçekleştirilecek yalnızca istatistikleri rapor eder. Çıkış adı olarak "-" kullanıldığında çıkış "stdout"a yönlendirilir. -- string
- Giriş dosyasını açıkça belirtin. Bu seçenek, giriş dosyası örneğin "-" ile başlıyorsa kullanışlıdır. Bu seçenek
last
olarak görünür. Bundan sonraki diğer seçenekler yoksayılır. -h, -help
- Kısa bir kullanım özeti.
-H, -longhelp
- Olası tüm seçeneklerin özeti.
-version
- Sürüm numarasını (ana.alt.düzeltme olarak) yazdırın ve çıkın.
-lossless
- Resmi kayıpsız şekilde kodlayın. Tamamen saydam alanı olan resimlerde, görünmez piksel değerleri (R/G/B veya Y/U/V) yalnızca
-exact
seçeneği kullanıldığında korunur. -near_lossless int
- Neredeyse kayıpsız görüntü işleme seviyesini belirleyin. Bu seçenek,
piksel değerleri sıkıştırılabilir, ancak görsel üzerindeki etkisi minimum düzeydedir.
kalitedir. Bu mod, kayıpsız sıkıştırma modunu otomatik olarak tetikler.
Aralık
0
(maksimum ön işleme) ile100
(ön işleme yok, varsayılan) arasındadır. Normal değer60
civarındadır.-q 100
ile kayıplı sıkıştırmanın bazen daha iyi sonuçlar verebileceğini unutmayın. -q float
RGB kanalları için
0
ile100
arasında bir sıkıştırma faktörü belirtin. Varsayılan değer75
'tir.Kayıplı sıkıştırma durumunda (varsayılan), küçük bir faktör daha küçük daha düşük kalitede olduğunu unutmayın. En iyi kalite,
100
değeri kullanılarak elde edilir.Kayıpsız sıkıştırma durumunda (
-lossless
seçeneğiyle belirtilir), küçük bir faktör daha hızlı sıkıştırma hızı sağlar ancak daha büyük bir dosya oluşturur. Maksimum sıkıştırma,100
değeri kullanılarak elde edilir.-z int
lossless
sıkıştırma modunu 0 arasında belirtilen bir düzeyde olacak şekilde açın ve 9. seviye en hızlı, 9 ise en yavaştır. Hızlı mod daha yavaş olanlardan daha büyük dosya boyutu üretir. Varsayılan olarak-z 6
değerini kullanabilirsiniz. Bu seçenek aslında kalite için önceden tanımlanmış bazı ayarların kısayoludur ve yöntem.-q
veya-m
seçenekleri daha sonra kullanılırsa bu seçeneğin etkisi geçersiz kılınır.-alpha_q int
Alfa sıkıştırma için
0
ile arasında bir sıkıştırma faktörünü belirtin100
. Alfanın kayıpsız sıkıştırılması için100
değeri kullanılır. Daha düşük değerler ise kayıplı sıkıştırmaya neden olur. Varsayılan değer100
'tir.-preset string
Belirli bir kaynak materyal türüne uygun önceden tanımlanmış bir parametre grubu belirtin. Olası değerler:
default
,photo
,picture
,drawing
,icon
,text
.-preset
, diğer parametrelerin değerlerinin (-q
hariç) üzerine yazdığı için bu seçenek tercihen bağımsız değişkenler sırasına göre ilk sırada görünmelidir.-m int
Kullanılacak sıkıştırma yöntemini belirtin. Bu parametre, kodlama hızı ile sıkıştırılmış dosya boyutu ve kalitesi arasındaki dengeyi kontrol eder. Olası değerler
0
ile6
aralığında değişiyor.4
varsayılan değerdir. Daha yüksek olduğunda kodlayıcı, ek incelemeleri yapmak için daha fazla zaman harcar ve ve kalite kazanımına karar vermeniz gerekecek. Daha düşük bir değer, daha büyük dosya boyutu ve daha düşük sıkıştırma kalitesi pahasına daha hızlı işleme süresi sağlayabilir.-crop x_position y_position width height
Kaynağı, koordinatlarda sol üst köşesi olan bir dikdörtgen olacak şekilde kırpın (
x_position
,y_position
) ve boyutwidth
xheight
. Bu kırpma alanı, tamamen kaynak dikdörtgenin içinde olmalıdır. Not: Kırpma işlemi, ölçeklendirmeden önce uygulanır.-resize width height
Kaynağı
width
xheight
boyutunda bir dikdörtgen olarak yeniden boyutlandırın. İkisinden biri genişlik veya yükseklik parametrelerinin (ikisi birden değil)0
olursa değer korunarak hesaplanır. Not: Ölçeklendirme, kırpma işleminden sonra uygulanır.-mt
Mümkünse kodlama için çoklu iş parçacığı kullanın.
-low_memory
Sıkıştırılmış koddan dört kat tasarruf ederek kayıplı kodlamanın bellek kullanımını azaltın boyutu (tipik olarak). Bu durumda kodlama yavaşlar ve sonuç olarak boyut ve distorsiyon açısından biraz farklı. Bu işaret yalnızca 3 ve sonraki yöntemler için geçerlidir ve varsayılan olarak kapalıdır. Bu işaretin kapalı bırakılmasının bit akışı üzerinde bazı yan etkilere sahip olur: Belirli bit akışını bölüm sayısı (
1
ile zorunlu kılınan) gibi özellikler içerir. Daha fazla bit akışı boyutunun ayrıntılı raporu bu ayar kullanılırkencwebp
tarafından yazdırılır seçeneğini belirleyin.
Kayıp Seçenekleri
Bu seçenekler yalnızca kayıplı kodlama (varsayılan, alfa sürümü olmadan) yapmayı deneyin.
-size int
- Sıkıştırılmış reklam öğesi için erişilebilecek bir hedef boyut (bayt cinsinden) belirtin
çıktı. Kompresör, sıcaklığın düşük olması için
mümkün olduğunca yakınlaşmak için yapılması gerekenleri belirler. Hem
-size
hem de-psnr
kullanılır,-size
değeri geçerli olur. -psnr float
- Sıkıştırılmış çıktıya ulaşmaya çalışmak için bir hedef PSNR (dB cinsinden) belirtin.
Sıkıştırıcı, bu hedefe mümkün olduğunca yaklaşmak için birkaç kısmi kodlama geçişi yapar. Hem
-size
hem de-psnr
kullanılıyorsa-size
değeri geçerli olur. -pass int
- Seçeneklerin kullandığı ikilem sırasında kullanılacak maksimum kart sayısını belirleyin
-size
veya-psnr
. Maksimum değer10
, varsayılan değer1
.-size
veya-psnr
seçenekleri kullanıldıysa ancak-pass
belirtilmediyse varsayılan değer olarak "6" geçiş kullanılır.-pass
belirtilmişse ancak-size
veya-psnr
belirtilmemişse 40 dB hedef PSNR kullanılır. -af
- Otomatik filtreyi açar. Bu algoritma, dengeli bir kaliteye ulaşmak için filtreleme gücünü optimize etmek üzere ek süre harcar.
-jpeg_like
- Dahili parametre eşlemesini, JPEG sıkıştırmanın beklenen boyutuna daha uygun olacak şekilde değiştirin. Bu işaret genellikle
(aynı
-q
ayarı için) JPEG eşdeğerine benzer bir boyuta sahiptir ancak daha az görsel distorsiyon.
Gelişmiş seçenekler:
-f int
0
arasında, engelleme filtresinin gücünü belirtin (filtreleme yok) ve100
(maksimum filtreleme).0
değeri tüm filtrelemeleri kapatır. Daha yüksek bir değer, resmin kodu çözüldikten sonra uygulanan filtreleme işleminin gücünü artırır. Değer ne kadar yüksek olursa görüntü de o kadar akıcı olur. görünür. Normal değerler genellikle20
-50
aralığındadır.-sharpness int
- Filtreleme keskinliğini belirtin (kullanılıyorsa). Aralık
0
(en keskin)7
(en az keskin) olarak. Varsayılan değer0
'tir. -strong
- Güçlü filtreleme kullanın (
-f
seçeneği sayesinde filtreleme kullanılıyorsa). Güçlü filtreleme varsayılan olarak açıktır. -nostrong
- Güçlü filtrelemeyi devre dışı bırakın (
-f
seçeneği) tercih edin ve bunun yerine basit filtreleme kullanın. -sharp_yuv
- Daha doğru ve daha keskin RGB->YUV dönüşümü kullanın. Bu işlemin varsayılan "hızlı" ayardan daha yavaştır RGB->YUV dönüşümü
-sns int
- Uzamsal gürültü şekillendirmenin genliğini belirtin. Uzamsal gürültü şekillendirme (veya kısaca sns), resmin hangi alanında nispeten daha az bit kullanılması gerektiğine ve bu bitlerin başka nerede daha iyi aktarılacağına karar vermek için kullanılan yerleşik algoritmalardan oluşan genel bir koleksiyon anlamına gelir. Olası aralık
0
(algoritma kapalı) ile100
(maksimum etki) arasındadır. Varsayılan değer:50
-segments int
- SANS segmentasyonu sırasında kullanılacak bölüm sayısını değiştirin
algoritması. Segmentler
1
-4
aralığında olmalıdır. Varsayılan değer4
'tür.-low_memory
kullanılmadığı sürece bu seçenek 3 ve sonraki yöntemler için geçerli değildir. -partition_limit int
- Bazı makro bloklar tarafından kullanılan bit sayısını sınırlayarak kaliteyi düşürün.
Aralık
0
(düşüş yok, varsayılan) ile100
(tam düşüş) arasındadır. Orta büyüklükteki resimler için genellikle30
-70
civarında değerler kullanışlıdır. İçinde kontrol bölümünün 512k limiti vardır ve şu bilgileri depolamak için kullanılır: makro bloğunun veya hangi segmente ait olduğu, 4x4 veya 4x4 biçiminde kodlanmış olup ve son olarak bu modların her biri için kullanılacak tahmin modları alt bloklar. Çok büyük resimlerde 512k, her bir resim için yalnızca birkaç bit 16x16 makro blok. Mutlak minimum, makro blok başına 4 bittir. Atla, ve mod bilgileri de bu 4 bitin neredeyse tamamını kullanabilir (ancak durum pek olası değildir). Bu da çok büyük resimler için soruna yol açar.partition_limit
faktörü, en fazla bit maliyeti olan modun (4x4 dahili) ne sıklıkta kullanılacağını kontrol eder. Bu seçenek, 512 KB sınırına ulaşıldığında ve şu mesaj görüntülendiğinde kullanışlıdır: Hata kodu: 6 (PARTITION0_OVERFLOW: Bölüm 0, 512 KB'ye sığmayacak kadar büyük). Şunu kullanıyorsanız:-partition_limit
, 512k kısıtlamasını karşılamak için yeterli değildir, makro blok başına daha fazla başlık biti kaydetmek için daha az segment kullanın.-segments
seçeneğini inceleyin.-m
ve-q
seçeneklerinin, kodlayıcının kararlarını ve bu sınıra ulaşabilme yeteneğini de etkilediğini unutmayın.
Günlük kaydı seçenekleri
Şu seçenekler çıkış düzeyini kontrol eder:
-v
- Ek bilgileri (özellikle kodlama süresini) yazdırın.
-print_psnr
- Ortalama PSNR'yi (En Yüksek Sinyal-Gürültü Oranı) hesaplayıp raporlayın.
-print_ssim
- Ortalama SSIM'yi (yapısal benzerlik metriği, bkz. https://en.wikipedia.org/wiki/SSIM) ziyaret edebilirsiniz.
-print_lsim
- Yerel benzerlik metriğini hesaplayıp raporlayın (yan yana yerleştirilmiş piksel komşuları arasındaki en düşük hatanın toplamı).
-progress
- Kodlama ilerleme durumunu yüzde olarak raporlayın.
-quiet
- Hiçbir şeyi yazdırmayın.
-short
- Test için yalnızca kısa bilgileri (çıktı dosyası boyutu ve PSNR) yazdır amaçlar.
-map int
- Kodlama bilgilerinin ek ASCII haritasını çıkışa aktarın. Olası harita değerleri
1
ile6
arasındadır. Bu, yalnızca hata ayıklama işlemine yardımcı olmak içindir.
Ek Seçenekler
Diğer gelişmiş seçenekler şunlardır:
-s width height
- Giriş dosyasının aslında ITU-R BT.601 önerisine uygun olarak 4:2:0 doğrusal biçiminde ham Y'CbCr örneklerinden oluştuğunu belirtin. Işık düzlemi
width
xheight
boyutundadır. -pre int
- Bazı ön işleme adımlarını belirtin.
2
değeri kullanıldığında, RGBA -> YUVA dönüşümü sırasında kaliteye bağlı sözde rastgele dithering tetiklenir (yalnızca kayıplı sıkıştırma). -alpha_filter string
- Alfa düzlemi için tahmine dayalı filtreleme yöntemini belirtir. Şunlardan biri:
Artan karmaşıklık ve yavaşlık sırasıyla
none
,fast
veyabest
.fast
varsayılandır. Dahili olarak, alfa filtreleme dört olası tahminler (hiçbiri, yatay, dikey, gradyan).best
her bir modu tek tek deneyecek ve daha küçük olan modu seçecek. seçin.fast
modu, herhangi bir işlem yapmadan önce öncelikli tahmin oluşturmaya çalışır. test ediyoruz. -alpha_method int
- Alfa sıkıştırma için kullanılan algoritmayı belirtin:
0
veya1
. Algoritma:0
sıkıştırma yapılmadığını,1
ise sıkıştırma için WebP kayıpsız biçimini kullandığını belirtir. Varsayılan değer1
'tir. -exact
- Şeffaf alandaki RGB değerlerini koruyun. Size yardımcı olmak için varsayılan ayar "kapalı" özellikleri olabilir.
-blend_alpha int
- Bu seçenek, alfa kanalını (varsa) 0xrrggbb olarak onaltılı biçimde belirtilen arka plan rengini kullanarak kaynakla harmanlar. Alfa
kanal daha sonra opak değere
255
sıfırlanır. -noalpha
- Bu seçenek kullanıldığında alfa kanalı silinir.
-hint string
- Giriş resmi türüyle ilgili ipucunu belirtin. Olası değerler:
photo
,picture
veyagraph
. -metadata string
Aşağıdaki durumlarda girişten çıkışa kopyalanacak meta verilerin virgülle ayrılmış listesi gösterir. Geçerli değerler:
all
,none
,exif
,icc
,xmp
. Varsayılan değernone
'tir.Her giriş biçiminin tüm kombinasyonları desteklemeyebileceğini unutmayın.
-noasm
Tüm derleme optimizasyonlarını devre dışı bırakın.
Hatalar
Lütfen tüm hataları sorun takipçisine bildirin: https://issues.webmproject.org
Yamalar memnuniyetle karşılanır. Başlamak için şu sayfaya bakın: https://www.webmproject.org/code/contribute/submitting-patches/
Örnekler
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
Yazarlar
cwebp
, libwebp
bünyesindeki web sitesinde ve WebP ekibi tarafından yazılmıştır.
En son kaynak ağacı https://chromium.googlesource.com/webm/libwebp/ adresinde mevcuttur.
Bu manuel sayfa Debian projesi için yazılmıştır (ve diğerleri).