.\"
.\" Man page for dcraw
.\"
.\" Copyright (c) 2009 by David Coffin
.\"
.\" You may distribute without restriction.
.\"
.\" David Coffin
.\" dcoffin a cybercom o net
.\" http://www.cybercom.net/~dcoffin
.\"
.TH dcraw 1 "14 maj 2009"
.LO 1
.SH NAZWA
dcraw - dekoder obrazów w formacie raw
.SH SKŁADNIA
.B dcraw
[\fIOPCJE\fR]... [\fIPLIK\fR]...
.SH OPIS
.B dcraw
dekoduje obrazy w formacie raw, wyświetla metadane oraz wyodrębnia miniaturki.
.SH OPCJE PODSTAWOWE
.TP
.B -v
Wyświetl szczegółowe informacje, a nie tylko błędy i ostrzeżenia.
.TP
.B -c
Zapisz zdekodowany obraz lub miniaturę na standardowe wyjście.
.TP
.B -e
Wyodrębnij wygenerowaną przez aparat miniaturkę, a nie obraz raw.
Wynikowy obraz będzie w formacie JPEG lub PPM, w zależności od modelu aparatu.
.TP
.B -z
Zmień daty modyfikacji i ostatniego dostępu plików AVI, JPEG, TIFF lub raw
na datę wykonania obrazu przy założeniu, że zegar aparatu jest
ustawiony na Czas Uniwersalny (UTC).
.TP
.B -i
Tylko zidentyfikuj pliki, nie dekoduj zawartości.
Zwraca wartość 0 jeżeli
.B dcraw
jest w stanie zdekodować ostatni obraz. W innym przypadku zwracana jest wartość 1.
.B -i -v
pokazuje metadane obrazka.
.TP
.B ""
.B dcraw
nie dekoduje obrazów w formacie JPEG!!
.SH OPCJE NAPRAWY OBRAZU
.TP
.B -P martwepiksele.txt
Wczytuje listę martwych pikseli z tego pliku zamiast z ".badpixels".
Zobacz w
.B PLIKI
opis składni tego pliku.
.TP
.B -K czarna_klatka.pgm
Odejmuje czarna klatkę od danych raw. Czarna klatkę wygenerujesz
robiąc zdjecie bez oswietlenia (np.: z obiektywem zasłoniętym dekielkiem), które
wywołaj następująco
.BR dcraw\ -D\ -4\ -j\ -t\ 0 .
.TP
.B -k odciecie_czerni
Kiedy po wywołaniu cienie stają się szare, należy podnieść poziom
odcięcia czerni.
Zmierzyć można poprzez użycie
.B pamsumm -mean
z plikiem czarnej klatki, przygotowanym jak powyżej.
.TP
.B -S nasycenie
Kiedy światła przechodzą w kolor różowy, należy obniżyć poziom nasycenia.
Żeby ustalic właściwy poziom, należy zrobić  zdjęcie z czymś lśniącym
w kadrze, a następnie
.B dcraw -D -4 -j -c
fotka.raw
.B | pamsumm -max
.TP
.B ""
Domyślny poziom czerni, jak i nasycenia jest zazwyczaj poprawny i nie
wymaga ingerencji.
.TP
.B -n poziom_redukcji
Użyj falkowej redukcji szumów, pozostawiając jak najwięcej detali.
Najlepszy efekt dają wartości poziomu z przedziału między 100 a 1000.
.TP
.B -C wzm_czerw wzm_nieb
Zwiększ warstwy koloru czerwonego i niebieskiego o podane współczynniki
(zazwyczaj od 0.999 do 1.001) aby zniwelować aberrację chromatyczną.
.TP
.B -H 0
Przytnij wszystkie światła do koloru białego (domyślne).
.TP
.B -H 1
Nie przycinaj świateł (pozostaw w różnych odcieniach różu).
.TP
.B -H 2
Połącz przycięte i nieprzycięte wartości ze sobą aby uzyskać wygładzone
przejście do bieli.
.TP
.B -H 3+
Rekonstruuj światła. Niskie wartości preferują biel, wyższe preferują
kolory. Spróbuj użyć
.B -H 5
jako dobrego kompromisu. Gdyby to okazało się niewystarczające, użyj opcji
.BR -H\ 9 ,
wyczyść wszystkie inne niż białe światła, a następnie wklej je do obrazka
wygenerowanego przy użyciu
.BR -H\ 3 .
.SH OPCJE KOLORÓW
Domyślnie
.B dcraw
używa stałego balansu bieli w oparciu o próbnik kolorów naświetlony
standardową lampą błyskową D65.
.TP
.B -w
Użyj wartości balansu bieli zapisanej przez aparat.
Jeżeli wartość ta nie zostanie odnaleziona, zostanie wyświetlone
ostrzeżenie i użyta będzie inna metoda jego określenia.
.TP
.B -a
Oblicz balans bieli na podstawie średniej z zawartości całego obrazu.
.TP
.B -A lewo góra szerokość wysokość
Oblicz balans bieli na podstawie średniej z zawartości wybranego
szarego obszaru prostokątnego (np. zdjęcie z szarą kartą).
Przedtem wykonaj
.B dcraw\ -j\ -t\ 0
, a następnie wybierz obszar o neutralnym, szarym kolorze.
.TP
.B -r mul0 mul1 mul2 mul3
Podaj własne wartości balansu bieli. Te wartości mogą również zostać
skopiowane z rezultatu działania polecenia
.BR dcraw\ -v .
.TP
.BR +M " lub " -M
Używaj (lub nie używaj) jakichkolwiek macierzy kolorów z metadanych aparatu.
Domyślna wartość to
.B +M
gdy użyto opcji
.BR -w ,
lub
.B -M
w przeciwnym wypadku.
Ta opcja dotyczy jedynie aparatów Olympus, Leaf oraz Phase One.
.TP
.B -o [0-6]
Wybierz wynikową przestrzeń kolorów, w przypadku gdy nie użyto parametru
.B -p
:

.B \t0
\ \ Surowy kolor (specyficzny dla każdego aparatu)
.br
.B \t1
\ \ sRGB D65 (domyślna)
.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\ aparat.icm \ [\  -o\ rezultat.icm \ ]
Użyj profilów kolorów ICC do obliczenia surowej przestrzeni kolorów
aparatu oraz wynikowej przestrzeni kolorów (domyślnie sRGB).
.TP
.B -p embed
Użyj profilu ICC osadzonego wewnątrz obrazu w formacie raw.
.SH OPCJE INTERPOLACJI
.TP
.B -d
Zdekoduj obraz raw w skali szarości, bez interpolacji kolorów.
Przydatne przy fotografowaniu czarno-białego tekstu.
.TP
.B -D
Tak samo jak
.BR -d ,
lecz bez skalowania kolorów (całkowicie surowy obraz).
.TP
.B -h
Generuj obraz o wymiarach równych połowie oryginału.
Działa dwa razy szybciej niż
.BR -q\ 0 .
.TP
.B -q 0
Użyj szybkiej, lecz niskiej jakości interpolacji dwuliniowej.
.TP
.B -q 1
Użyj interpolacji VNG (Variable Number of Gradients).
.TP
.B -q 2
Użyj interpolacji PPG (Patterned Pixel Grouping).
.TP
.B -q 3
Użyj interpolacji AHD (Adaptive Homogeneity-Directed, najwyższa jakość).
.TP
.B -f
Interpoluj RGB jako cztery kolory. Użyj tej opcji, jeżeli na wynikowym
obrazie widać niewłaściwe obszary 2x2 (interpolacja VNG) lub mazy (AHD).
.TP
.B -m liczba_przebiegów
Po dokonaniu interpolacji usuń zniekształcenia kolorystyczne poprzez
wielokrotne zastosowanie filtra medianowego (3x3 piksele) do wartości
R-G oraz B-G (różnic składowych).
.SH OPCJE FORMATU WYJŚCIOWEGO
Domyślnie
.B dcraw
zapisuje obrazy PGM/PPM/PAM wykorzystując 8 bitów na składową koloru,
krzywą gamma BT 709, poziom bieli oparty o histogram oraz bez metadanych.
.TP
.B -W
Użyj stałego poziomu bieli, ignorując histogram obrazka.
.TP
.B -b jasnosc
Podziel poziom bieli przez tą wartość (domyślnie 1.0).
.TP
.B -g potęga początkowego_nachylenia
Ustaw krzywą gamma, domyślne BT.709
.RB ( -g\ 2.222\ 4.5 ).
Jeżeli wolisz współczynnik gamma zgodny z sRGB, użyj
.BR -g\ 2.4\ 12.92 .
Dla zwykłej funkji potęgowej, ustaw nachylenie początkowe na zero.
.TP
.B -6
Zapisuje 16-bitów na próbkę, zamiast 8-bitów.
.TP
.B -4
Liniowy zapis 16-bitowy, tak samo jak
.BR -6\ -W\ -g\ 1\ 1 .
.TP
.B -T
Generuj obraz wynikowy w formacie TIFF z metadanymi zamiast
domyślnego formatu PGM/PPM/PAM.
.TP
.B -t [0-7,90,180,270]
Obróć wynikowy obraz. Domyślnie
.B dcraw
obraca obraz stosownie do informacji zapisanej przez aparat.
.B -t 0
wyłącza obracanie.
.TP
.B -j
W przypadku aparatów Fuji\ Super\ CCD obróć obraz o 45 stopni.
Dla aparatów o innym niż kwadratowy kształcie piksela nie skaluj
obrazu do jego właściwych proporcji. W każdym przypadku użycie tej
opcji gwarantuje, że jeden wynikowy piksel odpowiada dokładnie
jednemu surowemu pikselowi.
.TP
.BR "-s [0..N-1]" " lub " "-s all"
Jeżeli plik zawiera N surowych obrazków, wybierz do zdekodowania
jeden z nich lub "all" (wszystkie).
Przykładowo aparaty Fuji\ Super\ CCD\ SR generują drugi obraz o
zmniejszonej o cztery poziomy ekspozycji, na którym dokładniej
przedstawione są odbłyski.
.SH PLIKI
.TP
\:./.badpixels, ../.badpixels, ../../.badpixels, ...
Lista uszkodzonych pikseli Twojego aparatu, używana po to, aby
.B dcraw
mógł zinterpolować ich wartość ba podstawie sąsiednich pikseli.
Każda linia zawiera kolumnę i wiersz uszkodzonego piksela, oraz
datę (w formacie uniksowym), kiedy nastąpiło uszkodzenie.
Na przykład:
.sp 1
.nf
 962   91 1028350000  # uszkodzony 1. sierpnia 2002
1285 1067 0           # nieznana data uszkodzenia
.fi
.sp 1
Te współrzędne dotyczą obrazu przed przycięciem oraz obrotem,
tak więc użyj polecenia
.B dcraw -j -t 0
aby zlokalizować uszkodzone piksele.
.SH "ZOBACZ TAKŻE"
.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
.B dcraw
został stworzony przez Davida Coffina, dcoffin a cybercom o net
.SH TŁUMACZENIE
Krzysztof Nowicki krissn a op o pl