-
Notifications
You must be signed in to change notification settings - Fork 2
/
dcraw_cs.1
273 lines (272 loc) · 7.76 KB
/
dcraw_cs.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
.\"
.\" 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-5]
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
.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