.\"
.\" Czech manpage for dcraw
.\"
.\" Copyright (c) 2007 by David Coffin
.\"
.\" You may distribute without restriction.
.\"
.\" David Coffin
.\" dcoffin a cybercom o net
.\" http://www.cybercom.net/~dcoffin
.\"
.TH dcraw 1 "6 únor 2008"
.LO 1
.SH JMÉNO
dcraw - dekodér fotografií v raw formátu pro příkazovou řádku
.SH POUŽITÍ
.B dcraw
[\fIPARAMETRY\fR]... [\fISOUBOR\fR]...
.SH POPIS
.B dcraw
dekóduje fotografie ve formátu raw, zobrazuje metadata a extrahuje náhledy.
.SH OBECNÉ VOLBY
.TP
.B -v
Vypisuje detailnější hlášky, ne jen varování a chyby.
.TP
.B -c
Zapisuje dekódované obrázky nebo náhledy na standardní výstup.
.TP
.B -e
Extrahuje náhledy vložené fotoaparátem do raw souboru. Podle typu
fotoaparátu dostanete buď obrázky ve formátu JPEG nebo PPM.
.TP
.B -z
Změní datum a čas poslední modifikace souboru ve formátu AVI,
JPEG, TIFF nebo raw na datum a čas, kdy byla fotografie pořízena.
Předpokládá, že kamera zapisuje datum v časové zóně UTC.
.TP
.B -i
Vypíše typ souboru, ale neprovede jeho dekódování.
Pokud je návratová hodnota 0
.B dcraw
dokáže soubor dekódovat, pokud to možné není vrací 1.
.B -i -v
zobrazí metadata souboru.
.TP
.B ""
.B dcraw
nedokáže číst soubory ve formátu JPEG!!
.SH VOLBY PRO OPRAVY
.TP
.B -P vadné_pixely.txt
Seznam vadných pixelů se přečte ze zvoleného souboru místo z ".badpixels".
V sekci
.B SOUBORY
můžete najít popis formátu.
.TP
.B -K temný_snímek.pgm
Odečte temný snímek z dat v raw formátu. Soubor, který bude použit s
tímto parametrem vytvoříme tak, že provedeme expozici ve tmě a výsledek
zkonvertujeme příkazem
.BR dcraw\ -D\ -4\ -j\ -t\ 0 .
.TP
.B -k černá
Pokud jsou stíny příliš světlé, je potřeba zvýšit úroveň černé.
K jejímu zjištění aplikujte
.B pamsumm -mean
na výše uvedený temný snímek.
.TP
.B -S nasycení
Pokud je obraz ve světlech narůžovělý, potřebujete snížit úroveň
nasycení (bílé).
K jejímu zjištění pořiďte snímek něčeho jasného a proveďte příkaz
.B dcraw -D -4 -j -c
foto.raw
.B | pamsumm -max
.TP
.B ""
Výchozí nastavení úrovní černé a nasycení je obvykle správné.
.TP
.B -n hranice_šumu
Použije wavelet transformaci pro redukci šumu při současném zachování
detailů. Vhodná hodnota tohoto parametru bývá mezi 100 a 1000.
.TP
.B -C násobek_červené násobek_modré
Rozšíří červenou a modrou vrstvu o zadaný násobek, který vetšinou nabývá
hodnot mezi 0.999 a 1.001. Používá se ke korekci chromatické aberace.
.TP
.B -H 0
Všechny přepálené body změní na čistě bílou (výchozí stav).
.TP
.B -H 1
Nechá přepálené body beze změny, budou mít různé odstíny fialové.
.TP
.B -H 2
Smísí přepálené a nepřepálené body dohromady do gradientu přecházejícího
do bílé.
.TP
.B -H 3+
Opraví přepaly. Nižší čísla preferují bílou, vyšší barvy.
Pro začátek je dobré zkusit
.B -H 5
jako střední volbu. Pokud výsledek není uspokojivý, lze zkusit
.BR -H\ 9 ,
zkopírovat přepaly, které nejsou bílé a nakopírovat je do obrázku
vygenerovaného pomocí
.BR -H\ 3 .
.SH VOLBY BAREV
Ve výchozím nastavení
.B dcraw
používá vestavěnou hodnotu vyvážení bílé založenou na expozici
barevné tabulky osvětlené standardní lampou typu D65.
.TP
.B -w
Použije vyvážení bílé dle fotoaparátu. Pokud obrázek tuto informaci
neobsahuje, je vypsáno varování.
.TP
.B -a
Určí vyvážení bíle automaticky jako průměr z celého obrázku.
.TP
.B -A zleva zhora šířka výška
Spočte vyvážení bílé jako průměr ze zadaného obdélníku.
Nejdříve proveďte
.B dcraw\ -j\ -t\ 0
a vyberte obdélník obsahující střední šedou.
.TP
.B -r nás0 nás1 nás2 nás3
Zadejte vlastní hodnoty pro výpočet vyvážení bílé. Tyto parametry mohou být
získány jako výstup příkazu
.BR dcraw\ -v .
.TP
.BR +M " nebo " -M
Použije (nepoužije) barevnou matici z metadat obrázku.
Výchozí hodnota je
.B +M
pokud je použit parametr
.B -w
a v ostatních případech
.BR -M .
Tato volba se projeví pouze ve spojení s fotoaparáty Olympus, Leaf a Phase One.
.TP
.B -o [0-6]
Vybere výstupní barevný profil, pokud není současně použita volba
.B -p
:

.B \t0
\ \ Raw color (unikátní pro každý fotoaparát)
.br
.B \t1
\ \ sRGB D65 (výchozí hodnota)
.br
.B \t2
\ \ Adobe RGB (1998) D65
.br
.B \t3
\ \ Wide Gamut RGB D65
.br
.B \t4
\ \ Kodak ProPhoto RGB D65
.br
.B \t5
\ \ XYZ
.br
.B \t6
\ \ ACES
.TP
.BR -p\ fotoaparát.icm \ [\  -o\ výstupní.icm \ ]
Použije ICC barevný profil ze souboru fotoaparát.icm. Pro výstup je ve výchozím
nastavení použit profil sRGB a nebo v případě zadání výstupní.icm profil z
tohoto souboru.
.TP
.B -p embed
Použije ICC profil vložený do fotografie.
.SH VOLBY INTERPOLACE
.TP
.B -d
Zobrazí raw data jako černobílý (stupně šedi) obrázek bez jakékoliv
interpolace. Používá se především při fotografování dokumentů.
.TP
.B -D
Stejné jako
.BR -d ,
ale výstupem jsou čistá raw data, bez změn barev.
.TP
.B -h
Výstupem je barevný obrázek poloviční velikosti. Dvakrát rychlejší než
.BR -q\ 0 .
.TP
.B -q 0
Použije velmi rychlou, ale nepříliš kvalitní, bilineární interpolaci.
.TP
.B -q 1
Použije Variable Number of Gradients (VNG) interpolaci.
.TP
.B -q 2
Použije Patterned Pixel Grouping (PPG) interpolaci.
.TP
.B -q 3
Použije Adaptive Homogeneity-Directed (AHD) interpolaci.
.TP
.B -f
Interpoluje RGB jako čtyři barvy. Tuto volbu použijte pokud ve výstupu
vidíte rastr o velikosti 2x2 pixely nebo je výstup rozmazaný.
.TP
.B -m počet_průchodů
Po provedení interpolace odstraní barevné artefakty opakovaným aplikováním
3x3 medián filtru na R-G a B-G kanály.
.SH VOLBY VÝSTUPU
Ve výchozím nastavení
.B dcraw
zapisuje 8-bitový PGM/PPM/PAM obrázek s gamma křivkou BT.709,
úrovní bílé založené na histogramu a neukládá metadata.
.TP
.B -W
Použije pevnou úroveň bílé, ignoruje histogram obrázku.
.TP
.B -b jas
Vydělí úroveň bílé tímto číslem. Výchozí hodnota je 1.0.
.TP
.B -4
Zapíše 16bitový lineární obrázek (pevná úroveň bílé, bez gamma korekce).
.TP
.B -T
Zapíše obrázek ve formátu TIFF místo PGM/PPM/PAM.
.TP
.B -t [0-7,90,180,270]
Rotuje výstupní obrázek. Ve výchozím nastavení
.B dcraw
použije otočení dle údajů fotoaparátu.
.B -t 0
zakáže jakékoliv otáčení.
.TP
.B -j
U fotoaparátu Fuji\ Super\ CCD zobrazí obrázek sklopený o 45 stupňů. U
fotoaparátů. které nemají čtvercové pixely neprovádí transformaci obrazu do
korektního poměru stran. Ve všech případech tato volba garantuje, že jeden
pixel ve vyýstupním souboru přesně odpovídá jednomu pixelu čipu.
.TP
.BR "-s [0..N-1]" " nebo " "-s all"
Pokud soubor obsahuje více obrázků, vybere jeden konkrétní a nebo při zadání
"all" dekóduje všechny vložené obrázky.
Například fotoaparáty Fuji\ Super\ CCD\ SR generují druhý obrázek
podexponovaný o 4 EV pro zachování detailů v přepalech.
.SH SOUBORY
.TP
\:./.badpixels, ../.badpixels, ../../.badpixels, ...
Seznam vadných pixelů pro daný fotoaparát. Podle těchto souborů dokáže
.B dcraw
interpolovat obrázek, tak, aby byly vadné pixely skryty a nahrazeny
informacemi z okolních pixelů. Každý řádek obsahuje tři sloupce, které
obsahují ve kterém sloupci a řádku je vadný pixel a kdy byl poškozen. Např.:
.sp 1
.nf
 962   91 1028350000  # odešel mezi 1. a 4. srpnem 2002
1285 1067 0           # nevím, kdy pixel umřel
.fi
.sp 1
Tyto souřadnice se použijí před jakoukoliv transformací, pro jejich nalezení
použijte
.B dcraw -j -t 0
.
.SH "VIZ TAKÉ"
.BR pgm (5),
.BR ppm (5),
.BR pam (5),
.BR pnmgamma (1),
.BR pnmtotiff (1),
.BR pnmtopng (1),
.BR gphoto2 (1),
.BR cjpeg (1),
.BR djpeg (1)
.SH AUTOR
Napsal David Coffin, dcoffin a cybercom o net
.SH PŘEKLADATEL
Dan Ohnesorg, dan a ohnesorg o cz