.\" {PTM/LK/0.1/03-10-1998/"konwersja plikw graficznych do formatu JPEG"}
.\" Tumaczenie: 05-10-1998 ukasz Kowalczyk (lukow@tempac.okwf.fuw.edu.pl)
.TH cjpeg 1 "20 marca 1998"
.SH NAZWA
cjpeg \- konwersja plikw graficznych do formatu JPEG
.SH SKADNIA
.B cjpeg
[
.I opcje
]
[
.I plik
]
.LP
.SH OPIS
.LP
.B cjpeg
dokonuje kompresji podanego pliku (bd danych ze standardowego wejcia,
jeeli nie podano nazwy pliku) i zapisuje na standardowym wyjciu plik w
formacie JPEG/JFIF. Bieca wersja programu obsuguje nastpujce standardy
wejciowych plikw graficznych: PPM (format PBMPLUS color), 
PGM (format PBMPLUS w skali szaroci), BMP, Targa, and RLE (format Utah Raster
Toolkit).  (RLE tylko w wypadku, gdy zainstalowana jest biblioteka URT).
.SH OPCJE
Wszystkie nazwy opcji mog by skracane, np.
.B \-grayscale
moe by zapisana jako
.B \-gray
lub
.BR \-gr .
Wikszo "podstawowych" opcji moe by skrcona nawet do jednej litery.
Wielkie i mae litery w nazwach opcji nie s rozrniane (np.
.B \-BMP
jest rwnowane z
.BR \-bmp ).
Akceptowana jest te brytyjska pisownia niektrych opcji (np.
.BR \-greyscale ),
cho nie jest ona poniej wspominana ze wzgldu na zwizo.
.PP
Podstawowe opcje to:
.TP
.BI \-quality " N"
Skalowanie tablicy kwantyzacji dla dostrojenia jakoci obrazu. Jako moe
przybiera wartoci od 0 (najgorsza) do 100 (najlepsza). Wartoci domyln
jest 75. (Wicej informacji poniej).
.TP
.B \-grayscale
Tworzenie monochromatycznego pliku JPEG z kolorowego pliku wejciowego. Uyj tej
opcji podczas kompresji plikw BMP w skali szaroci, poniewa
.B cjpeg
nie jest w stanie samodzielnie rozpozna takiego pliku. Dziki opcji
.BR \-grayscale 
otrzymasz mniejszy plik wyjciowy.
.TP
.B \-optimize
Zoptymalizuj parametry kodowania entropii. Bez tej opcji uywane s domylne
parametry.
Opcja
.B \-optimize
powoduje wyprodukowanie mniejszego pliku JPEG, lecz 
.B cjpeg
dziaa wolniej i potrzebuje znacznie wicej pamici. Jako obrazu i prdko
dekompresji pozostaj bez zmian.
.TP
.B \-progressive
Stwrz plik JPEG z przeplotem (patrz niej).
.TP
.B \-targa
Plik wejciowy jest w formacie Targa. Pliki Targa zawierajce pole
"identyfikacji" nie s automatycznie rozpoznawane przez program
.BR cjpeg ;
dla takich plikw trzeba uy opcji
.B \-targa
by 
.B cjpeg
traktowa te pliki waciwie. Dla wikszoci plikw tego typu ta opcja nie
bdzie potrzebna.
.PP
Opcja
.B \-quality
pozwala na zmniejszanie rozmiaru pliku kosztem jakoci obrazu. Im wysza
warto parametru tej opcji, tym bardziej plik wyjciowy bdzie zbliony
jakoci do pliku wejciowego. Zazwyczaj powiniene uywa najmniejszej
wartoci tej opcji, ktra jeszcze produkuje plik wizualnie nieodrnialny od 
oryginau. W tym celu warto parametru powinna zawiera si pomidzy 50 a
95. Domylna warto 75 przewanie jest zadowalajca. Jeeli przy domylnym
ustawieniu (75) jako obrazu jest niewystarczajca, sprbuj zwiksza
warto o 5 lub 10 za jednym razem, a uzyskasz zadowalajce rezultaty (dla
kadego pliku warto optymalna jest inna).
.PP
.B \-quality
100 wygeneruje tablic kwantyzacji skadajc si z samych cyfr 1,
minimalizujc straty jakoci podczas kwantyzacji (wci jednak wystpuje
strata przy podprbkowaniu (subsampling) i zaokrglaniu (roundoff) ). To
ustawienie nadaje si tylko do celw eksperymentalnych. Wartoci powyej 95
nie s zalecane przy normalnym uytkowaniu; rozmiar skompresowanego pliku
gwatownie ronie przy znikomym wzrocie jakoci obrazu.
.PP
Idc w drug stron, wartoci poniej 50 wyprodukuj bardzo may plik o bardzo
niskiej jakoci. Wartoci okoo 5 lub 10 mog by przydatne podczas
przygotowywania biblioteki plikw graficznych. Na przykad, sprbuj opcji
.B \-quality
2 (lub w pobliu), aby uzyska zadziwiajce efekty kubistyczne. (Notabene:
wartoci poniej 25 generuj 2-bajtowe tablice kwantyzacji, ktre w
standardzie JPEG s opcjonalne.
.B cjpeg
wypisuje ostrzeenie gdy podasz tak warto jakoci obrazu, poniewa
niektre dekodery JPEG mog nie by w stanie zdekompresowa takiego pliku,
uyj opcji
.B \-baseline
aby zapewni kompatybilno przy tak niskich wartociach jakoci).
.PP
Opcja
.B \-progressive
tworzy plik JPEG z przeplotem. W pliku tego typu dane s przechowywane jako
wiele ekranw o powikszajcej si jakoci. Jeeli plik jest transmitowany
przez powolne cze, dekoder moe bardzo szybko wywietlic pierwszy ekran,
jako niskojakociow wersj obrazu, nastpnie podnoszc jako podczas
wywietlania kolejnych ekranw.
Kocowy efekt jest identyczny ze standardowym plikiem JPEG o
tym samym ustawieniu jakoci. Rozmiar pliku rwnie jest taki sam, a czsto
nieco mniejszy.
.B Uwaga:
pliki JPEG z przeplotem nie s jeszcze rozpoznawane przez wiele programw,
wic znaczna liczba dekoderw nie bdzie w stanie ich wywietli.
.PP
Opcje dla zaawansowanych uytkownikw:
.TP
.B \-dct int
uyj cakowitoliczbowej metody DCT (warto domylna).
.TP
.B \-dct fast
uyj szybkiej cakowitoliczbowej metody DCT (nisza jako)
.TP
.B \-dct float
uyj zmiennoprzecinkowej metody DCT. Jest ona odrobin dokadniejsza ni
metoda cakowitoliczbowa, lecz duo wolniejsza, jeeli twj komputer nie ma
szybkiego koprocesora arytmetycznego. Rezultaty uywania tej metody mog si
rni na rozmaitych komputerach, podczas gdy metoda cakowitoliczbowa
powina dawa zawsze te same rezultaty. Szybka metoda cakowitoliczbowa jest
duo mniej dokadna ni dwie pozostae.
.TP
.BI \-restart " N"
Docz do pliku JPEG znacznik restartu co N rzdw MCU (lub co N blokw MCU,
jeeli do liczby jest doczona litera "B").
.B \-restart 0
(warto domylna) oznacza brak znacznikw restartu.
.TP
.BI \-smooth " N"
Wygadzanie obrazu wejciowego w celu wyeliminowania zakce wynikych z
zastosowania ditheringu.
N (od 1 do 100) opisuje poziom wygadzania obrazu. 0 (warto
domylna) oznacza brak wygadzania.
.TP
.BI \-maxmemory " N"
Naoenie limitu na ilo pamici zuywanej podczas przetwarzania duych
obrazw. Warto liczona jest w tysicach bajtw bd w milionach bajtw,
jeeli do liczby doczona jest litera "M". Na przykad:
.B \-max 4m
oznacza 4000000 bajtw. Jeeli wymagana jest wiksza ilo pamici, uyte
zostan pliki tymczasowe.
.TP
.BI \-outfile " nazwa"
Zapisanie pliku wynikowego pod nazw "nazwa", zamiast na standardowym wyjciu.
.TP
.B \-verbose
Wypisuj komunikaty diagnostyczne. Im wicej opcji
.BR \-v 
tym wicej informacji bdzie wypisywanych. Podczas startu programu
wypisywana jest rwnie informacja o wersji.
.TP
.B \-debug
To samo, co
.BR \-verbose .
.PP
Opcja
.B \-restart
wstawia do pliku znaczniki pozwalajce dekoderowi JPEG na zniwelowanie
efektw uszkodzenia pliku np. podczas transmisji. Bez znacznikw restartu
dowolne uszkodzenie pliku spowoduje niemono wywietlenia pliku w caoci.
Gdy w pliku znajduj si znaczniki, pominita zostanie tylko cz pliku
znajdujca si pomidzy uszkodzeniem, a kolejnym znacznikiem. Znaczniki
zajmuj oczywicie dodatkow przestrze w pliku. Zalecane jset uywanie opcji
.B \-restart 1
dla plikw, ktre maj by transmitowane przez sieci o niskim poziomie
transmisji, jak np. Usenet.
.PP
Opcja
.B \-smooth
odfiltrowuje z pliku zakcenia wpywajce na jako odtworzenia drobnych
szczegw obrazu. Jest ona uyteczna podczas konwersji plikw poddanych
ditheringowi. Nieduy wpczynnik wygadzania (10 do 50) usuwa zakcenia
powstae podczas ditheringu, dziki czemu wynikowy plik JPEG jest mniejszy i
ma lepsz jako. Zbyt duy wspczynnik wygadzania spowoduje rozmycie
obrazu.
.PP
Opcje dla magikw:
.TP
.B \-baseline
Generacja tabel kwantyzacji kompatybilnych z podstawowym standardem JPEG.
Powoduje to uywanie 8-bitowych wartoci kwantyzacji nawet przy niskim
ustawieniu jakoci obrazu (opcja \-quality). Ta opcja jest dosy
nieszczliwie nazwana, poniewa nie zawsze wymusza zgodno z podstawow
wersj formatu JPEG. Na przykad, moesz uy
.B \-baseline
i
.B \-progressive
jednoczenie.)
.TP
.BI \-qtables " plik"
Uyj tablic kwantyzacji zawartych w podanym pliku.
.TP
.BI \-qslots " N[,...]"
Wybierz tablice kwantyzacji uywane dla kadego z kolorw bazowych.
.TP
.BI \-sample " HxV[,...]"
Ustaw wspczynnik prbkowania dla kadego z kolorw bazowych.
.TP
.BI \-scans " plik"
Do skanowania uyj skryptu (scan script) o podanej nazwie.
.PP
Opcje dla "magikw" przeznaczone s do eksperymentowania ze standardem JPEG.
Jeeli nie wiesz do czego su, \fBnie uywaj ich\fR. S one dokadniej
opisane w pliku wizard.doc.
.SH PRZYKADY
.LP
Przykad konwersji pliku PPM o nazwie foo.ppm do pliku foo.jpg ze
wspczynnikiem jakoci 60.
.IP
.B cjpeg \-quality
.I 60 foo.ppm
.B >
.I foo.jpg
.SH PODPOWIEDZI
Kolorowe pliki GIF nie s zbyt dobrze kompresowane do standardu JPEG,
poniewa standard ten suy zasadniczo do kompresji plikw o 24-bitowym
kolorze. W szczeglnoci, nie staraj si kompresowa komiksw, grafiki
skadajcej si gwnie z linii oraz generalnie obrazw skadajacych si
z jedynie
kilku rnych kolorw. Do tych zastosowa nadaje si format GIF. Jeeli
jednak koniecznie chcesz skompresowa plik GIF do formatu JPEG, powiniene
skupi si na doborze wartoci dla opcji
.B \-quality
i
.BR \-smooth .
.B \-smooth 10
czsto moe by pomocne.
.PP
Unikaj kilkukrotnej kompresji/dekompresji  do/z formatu JPEG, poniewa
straty jakoci bd si nawarstwia. Po okoo 10 cyklach jako obrazu
wyranie spadnie w stosunku do jakoci po zaledwie jednym cyklu. Podczas
dokonywania zmian w obrazie najlepiej jest uywa innego formatu, ktry
uywa bezstratnej kompresji.
.PP
Opcji
.B \-optimize
warto uywa podczas tworzenia "ostatecznej" wersji do celw archiwizacji
lub publikacji (elektronicznej). Dobrym rozwizaniem jest te uywanie niskiego wpczynnika
jakoci (\-quality) do tworzenia bardzo maych plikw JPEG; kompresja daje
wtedy znacznie lepsze rezultaty ni dla duych plikw. (Tryb
.B \-optimize
jest zawsze uywany podczas tworzenia plikw JPEG z przeplotem).
.SH RODOWISKO
.TP
.B JPEGMEM
Warto tej zmiennej stanowi limit pamici. Sposb okrelania wartoci jest
opisany przy opcji
.BR \-maxmemory .
Jeeli
.B JPEGMEM
istnieje, jej warto ma wyszy priorytet ni warto ustalona podczas
kompilacji. Z kolei jeszcze wyszy priorytet ma opcja
.BR \-maxmemory .
.SH ZOBACZ TAKE
.BR djpeg (1),
.BR jpegtran (1),
.BR rdjpgcom (1),
.BR wrjpgcom (1)
.br
.BR ppm (5),
.BR pgm (5)
.br
Wallace, Gregory K.  "The JPEG Still Picture Compression Standard",
Communications of the ACM, April 1991 (vol. 34, no. 4), pp. 30-44.
.SH AUTOR
Independent JPEG Group
.SH PROBLEMY
Kodowanie arytmetyczne nie jest obsugiwane z przyczyn prawnych.
.PP
Pliki wejciowe w formacie GIF nie s ju obsugiwane, aby nie narusza
patentu Unisys LZW. Do odczytywania plikw GIF uyj programu
licencjonowanego przez Unisys (mimo wszystko, konwersja plikw GIF do
formatu JPEG nie jest zalecana).
.PP
Nie s obsugiwane wszystkie wersje plikw BMP i Targa.
.PP
Opcja
.B \-targa
to nie bd, jest ona bardzo pomocna. (Byaby bdem, gdyby twrcy formatu
Targa lepiej go przemyleli).
.PP
Program wci nie jest tak szybki, jak bymy chcieli.