path: root/po/fi/archive/plain/man1/cjpeg.1

.\" $Id: $
.\" Translated into finnish by Jan Lipponen (lippis@rieska.oulu.fi)
.\"
.TH CJPEG 7 "" "K�ytt�j�n sovellusohjelmat" ""
.SH NIMI
cjpeg \- pakkaa kuvatiedoston JPEG-formaattiin
.SH "YLEISKATSAUS"
.B cjpeg
[
.I optiot
]
[
.I tiedosto
]
.LP
.SH KUVAUS
.LP
.B cjpeg
pakkaa kuvatiedoston tai kuvatiedoston nimen puuttuessa vakiosy�tteen ja
tuottaa vakiotulosteena JPEG/JFIF-muotoisen kuvatiedoston.
T�ll� hetkell� tuettuja kuvaformaatteja ovat: PPM (PBMPLUS v�rikuvat),
PGM (PBMPLUS harmaans�vykuvat), BMP, GIF, Targa, ja RLE (Utah Raster
Toolkit -formaatti).  (RLE:t� tuetaan vain jos URT-kirjasto on k�ytett�viss�.)
.SH OPTIOT
Kaikkien optioiden nimet ovat lyhennett�viss�; Esim.
.B \-grayscale
voidaan kirjoittaa muodossa
.B \-gray
tai
.BR \-gr .
Yleisimm�t perusoptioista voidaan lyhent�� jopa yksimerkkisiksi.
Suurten ja pienten kirjainten v�lill� ei tehd� eroa (
.B \-GIF
on siis sama kuin
.BR \-gif ).
My#s englantilaistyylisesti kirjoitetut sanat hyv�ksyt��n (esim.
.BR \-greyscale ),
tilan s��st�miseksi n�it� ei kuitenkaan ole lueteltu.
.PP
Perusoptiot ovat:
.TP
.BI \-quality " N"
S��t�� kuvan laadusta m��r�v�� kvantifiointitaulua.  Laatu voi olla v�lilt�
0 (huonoin) ja 100 (paras); Laatu on oletuksena 75.  (lis�tietoja alla.)
.TP
.B \-grayscale
Tekee sy�tteest� harmaans�vyj� k�ytt�v�n JPEG-kuvan. Optiota suositellaan k�ytett�v�ksi
harmaans�vyist� koostuvaa GIF-kuvaa pakattaessa, koska
.B cjpeg
ei itse pysty p��ttelem��n milloin GIF-kuvassa on k�ytetty ainoastaan harmaans�vyj�.
K�ytt�m�ll�
.BR \-grayscale ,
-optiota saat aikaan pienempi� JPEG-kuvia lyhyemm�ss� ajassa.
.TP
.B \-optimize
Optimoi kuvan entropian koodausparametrit.  Jos t�t� optiota ei ole annettu
k�ytet��n oletusparametreja.
.B \-optimize
tekee JPEG-kuvatiedostoista yleens� hieman pienempi�, mutta
.B cjpeg
toimii silloin hieman hitaammin ja k�ytt�� huomattavasti enemm�n muistia.
.B \-optimize
-option k�ytt� ei vaikuta kuvan laatuun tai nopeuteen kuvan purkamisen yhtydess�.
.TP
.B \-progressive
Luo progressiivisen (asteittain tarkentuvan) JPEG-tiedoston (ks. alle).
.TP
.B \-targa
Sy�te on Targa-kuvaformaatissa.  Targa-tiedostot sis�lt�v�t tunnistuskent�n, jota
.B cjpeg
ei tunnista automaattisesti.
.B \-targa
-optiota tulee k�ytt�� t�llaisille tiedostoille, jotta
.B cjpeg
k�sittelee sy�tett� Targa-formaatissa.
Useimmat Targa-muotoiset tiedostot eiv�t tarvitse t�t� optiota.
.PP
.B \-quality
-optiolla voidaan s��t�� tasapainoa pakatun tiedoston koon ja kuvan laadun v�lill�.
Mit� suuremmaksi s��d�t kuvan laadun sit� suurempia tiedostoja saat aikaiseksi, mutta
tuloksena on kuva, joka vastaa paremmin alkuper�ist� kuvaa.  Aivan pienimpi�
laatuasetuksia (tuottavat siis my�s pienimpi� tiedostoja) k�ytet��n sellaisten kuvien
luomiseen, joita ei purettaessa tunnista alkuper�isiksi.  Tavalliseen k�ytt��n
k�ytt�kelpoisimpia ovat arvot 50:n ja 95:n v�lill�.  Oletusarvona k�ytett�v� 75
sopii useimpiin tarkoituksiin.  Jos kuvan laatu
.B \-quality
75:ll� ei tyydyt� kannattaa kokeilla arvon kasvattamista 5:ll� tai 10:ll� kunnes
olet tyytyv�inen tulokseen.  (Eri tyyppisill� kuvilla on erilaiset optimiasetukset.)
.PP
.B \-quality
100 tuottaa kvantifiontitaulukon, jonka kaikki arvot ovat ykk�si�. Joka
kvantifiointiaskeleella menetet��n t�ll�in v�hiten kuvainformaatiota, mutta t�ll�kin
asetuksella tapahtuu pienenpient� h�vikki�.  Arvoa 100 k�ytet��n l�hinn�
kokeilutarkoitukessa eik� normaalik�ytt��n suositella arvoja, jotka ovat yli 95:n.
Pakatun tiedoston koko kasvaa silloi suhteettomasti verrattuna laadussa saatavaan
hy�tyyn. 
.PP
Toisaalta alle 50:n arvot tuottavat hyvin pieni� kuvatiedostoja, joiden laatu
on huono. Arvot 5:n ja 10:n v�lilt� voivat olla k�ytt�kelpoisia esimerkiksi
silloin, kun halutaan luoda selailuun k�ytet�v�� hakemistoa suuresta kuvakirjastosta.
Voit huviksesi kokeilla
.B \-quality
:� arvolla 2 hauskojen kubistisien efektien luomiseksi.  (Huom. alle 25:n laatuarvot
tuottavat kaksitavuisen kvantifiointitaulun, jonka toteuttaminen JPEG-standardissa
ei ole pakollista.
.B cjpeg
antaa varoituksen k�ytett�ess� n�in pient� kuvanlaatua, koska er��t JPEG-ohjelmat
eiv�t osaa purkaa t�llaisia kuvatiedostoja.  K�yt�
.B \-baseline
-optiota jos haluat varmistua yhteensopivuudesta pienimmill� kuvanlaaduilla.)
.PP
.B \-progressive
-optio luo progressiivisen JPEG-tiedoston. T�m�ntyyppisess� kuvatiedostossa
kuvainformaatio talletetaan useammassa pyyhk�isyss� tarkentaen kuvan laatua
joka kerralla.  T�st� on se hy�ty, ett� kun kuvaa v�litet��n hitaan yhteyden
kautta voi purkaja n�ytt�� ensimm�isest� pyyhk�isyst� saatavan ep�selv�n
kuvan varsin nopeasti ja sen j�lkeen parantaa kuvan laatua seuraavien
pyyhk�isyjen aikana.  Lopullinen kuva on t�sm�lleen samanlainen laadultaan
kuin standardi JPEG-kuva ja my�s tiedoston koko on suunnilleen sama -- joskus
jopa hieman pienempi.
.B Varoitus:
kaikki JPEG-purkajat eiv�t osaa lukea t�ll� tavalla koodattua kuvaa.
.PP
Optiot edistyneille k�ytt�jille:
.TP
.B \-dct int
K�yt� DCT-kokonaislukumetodia (oletus).
.TP
.B \-dct fast
K�yt� nopeaa DCT-kokonaislukumetodia (ep�tarkempi).
.TP
.B \-dct float
K�yt� DCT-liukulukumetodia.
Liukulukumetodi on hieman tarkempi kuin kokonaislukumetodi, mutta huomattavasti
hitaampi jos koneessasi ei ole eritt�in nopeaa liukulukuyksikk��. Huomaa my�s,
ett� liukulukumetodilla tuloksena saatavissa tiedostoissa voi olla pienenpieni�
eroja erityyppisten koneiden v�lill�. Kokonaislukumetodin pit�isi tuottaa t�sm�lleen
sama tulos konetyypist� riippumatta. Nopea kokonaislukumetodi on n�it� molempia 
huomattavasti ep�tarkempi.
.TP
.BI \-restart " N"
L�hett�� JPEG-uudelleenaloitusmerkin joka N:nen MCU rivin j�lkeen tai joka
N:nen MCU blokin j�lkeen jos numeron per��n on liitettyn� B-kirjain.
.B \-restart 0
(oletus) ei l�het� uudelleenaloitusmerkkej�.
.TP
.BI \-smooth " N"
Pehment�� sy�tekuvaa v�hent�m�ll� siin� esiintyv�� kohinaa. N, joka voi saada
arvon v�lilt� 0 ja 100, ilmaisee pehmennyksen voimakkuuden. 0 ei pehmenn� kuvaa
lainkaan (oletus).
.TP
.BI \-maxmemory " N"
Asettaa suurten kuvien k�sittelyss� k�ytett�v�n muistin enimm�ism��r�n. Luku
tarkoittaa tuhatta tavua tai miljoonaa jos luvun per��n on liitetty M-kirjain.
Esim.
.B \-max 4m
tarkoittaa 4000000 tavua.  Jos annettu muistim��r� ei riit� k�ytet��n apuna
tilap�istiedostoja.
.TP
.BI \-outfile " nimi"
Kirjoittaa tuloksena saatavan kuvan vakiosy�tteen sijasta nimettyyn tiedostoon.
.TP
.B \-verbose
N�ytt�� debuggaustietoja. Useamman
.BR \-v
-option k�ytt� lis�� n�ytett�vien debuggaustietojen m��r��.  Debuggaustietojen
alussa n�ytet��n ohjelman versionumero.
.TP
.B \-debug
Sama kuin
.BR \-verbose .
.PP
.B \-restart
-optio lis�� ylim��r�isi� merkkej�, joka auttaa JPEG-purkajaa tahdistuksessa
siirtovirheen sattuessa.  Jos uudelleenaloitusmerkkej� ei k�ytet�, niin yksikin
pakatussa tiedostossa oleva virhe pilaa useimmiten koko loppukuvan; merkkien avulla
voidaan vaurio saada rajoitettua seuraavaan uudelleenaloitusmerkkiin. Merkit
kasvattavat luonnollisestikin hieman tiedostokokoa.  Luotettavien verkkojen
kautta (esim. Usenet) v�litett�ville kuville suositellaan k�ytet�v�ksi optiota 
.B \-restart 1
.PP
.B \-smooth
-optio suodattaa sy�tteest� pois hienojakoista kohinaa.  T�t� k�ytet��n
useimmiten GIF-kuvien muunnoksen yhteydessa.  Kohtuullinen pehmennyskerroin
10:st� 50:een poistaa sy�tteest� rasteroinnin ja pienent�� siten tiedoston
kokoa ja parantaa kuvan ulkon�k��.  Liian suuren pehmennyskertoimen k�ytt�
kiutenkin sumentaa kuvaa.
.PP
Optioita velhoille:
.TP
.B \-baseline
Luo baseline:� k�ytt�v�n JPEG-tiedoston.  Kvantifioinnissa k�ytett�v�t arvot
supistetaan kahdeksaan bittiin my�s pienimmill� laatuasetuksilla.
.TP
.BI \-qtables " tiedosto"
K�ytt�� m��r�tyst� tekstitiedostosta l�ytyv�� kvantifiointitaulua.
.TP
.BI \-qslots " N[,...]"
Valitsee k�ytett�v�n kvantifiointitaulun jokaiselle v�rikomponentille.
.TP
.BI \-sample " HxV[,...]"
Asettaa JPEG-n_ytteenottokertoimet jokaiselle v�rikomponentille.
.TP
.BI \-scans " tiedosto"
K�ytt�� m��r�tyst� tekstitiedostosta l�ytyv�� pyyhk�isyskripti�.
.PP
"Velho-opiot" on tarkoitettu kokeiluun. Jos et ole aivan varma mit� optioilla
tehd��n, niin \fB�l� k�yt� niit�\fR.  Lis�tietoa n�ist� optioista l�ytyy
tiedostosta wizard.doc.
.SH ESIMERKIT
.LP
T�m� esimerkki pakkaa foo.ppm-nimisen PPM-tiedoston laatuasetuksella 60 ja
tallettaa sen tiedostoon foo.jpg:
.IP
.B cjpeg \-quality
.I 60 foo.ppm
.B >
.I foo.jpg
.SH VINKIT
V�rilliset GIF-kuvat eiv�t ole aivan parhaimpia mahdollisia JPEG-kandidaatteja;
JPEG on tarkoitettu t�ysv�rikuvien (24-bittisten kuvien) pakkaamiseen.
Aivan erityisesti kannattaa v�ltt�� sarjakuvien, viivapiirrosten ja muiden
sellaisten kuvien muuntamista, jotka k�ytt�v�t vain muutamaa v�ri�.  GIF sopii
t�h�n tarkoitukseen huomattavasti paremmin kuin JPEG.  Jos haluat muuntaa
GIF-kuvia JPEG-formaattiin kannattaa kokeilla
.BR cjpeg :n
.B \-quality
ja
.B \-smooth
-optioilla tyydytt�v�n lopputuloksen aikaansaamiseksi.
.B \-smooth 10
on usein k�ytt�kelpoinen.
.PP
V�lt� kuvien ajamista useiden per�kk�isten JPEG pakkaus/purku-toimenpiteen l�pi.
Kuvasta h�vi�� joka kerralla informaatiota ja kymmenennen kierroksen paikkeilla
kuvan laatu on jo selke�sti huonompi kuin ensimm�isen kierroksen j�lkeen.
Kuvaa muokattaessa kannattaa k�ytt�� h�vikit�nt� tiedostoformaattia ja suorittaa
JPEG-muunnos vasta lopulliselle kuvalle.
.PP
.B \-optimize
-optiota kannattaa k�ytt�� silloin, kun olet tekem�ss� kuvasta "lopullista"
versiota eteenp�in l�hetett�v�ksi tai varastoitavaksi.  Optio on hy�dyksi
my�s k�ytett�ess� huonompaa kuvanlaatua eritt�in pienten JPEG-tiedostojen
luomiseksi. Saatava prosentuaalinen hy�ty on usein suurempi kuin suurempia
tiedostoja luotaessa.  (T�ll� hetkell�
.B \-optimize
-moodi on aina valittuna progressiivisia JPEG-tiedostoja generoitaessa.)
.SH YMP�RIST�MUUTTUJAT
.TP
.B JPEGMEM
T�m�n ymp�rist�muuttujan arvoa k�ytet��n oletuksena varattavan muistin yl�rajana.
Arvoa k�ytet��n samoin kuin
.B \-maxmemory
-optiota.
.B JPEGMEM
korvaa k��nn�ksen yhteydess� annetun k�ytett�v�n muistin enimm�ism��r�n. Se itse
voidaan korvata antamalla uusi arvo
.BR \-maxmemory -optiolla.
.SH "KATSO MY�S"
.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 TEKIJ�
Independent JPEG Group
.SH BUGIT
Aritmeettista koodausta ei ole tuettu lakisyist�.
.PP
Kaikkia BMP- ja Targa-formaattien muunnelmia ei tueta.
.PP
.B \-targa
-optio ei ole bugi, se on ominaisuus. (Se olisi kyll� ollut bugi elleiv�t
Targa-formaatin suunnittelijat olisi olleet niin pihalla.)
.PP
Ei ole viel�k��n niin nopea kuin haluaisimme sen olevan.