.\"

.\" 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 "2009 年 3 月 3 日"

.LO 1

.SH 名　稱

dcraw - 指令界面原始影像解碼工具

.SH 總　覽

.B dcraw

[\fI參數\fR]... [\fI圖檔路徑\fR]...

.SH 概　要

.B dcraw

解碼原始影像檔案，顯示圖檔之詮釋資料 (metadata) 以及產生預覽圖片。

.SH 一般選項

.TP

.B -v

在除了警告與錯誤訊息外並顯示額外的執行資訊。

.TP

.B -c

將解碼後圖片與預覽圖片資料送至標準輸出埠 (STDOUT)

.TP

.B -e

自原始影像檔案中解出由相機產生的預覽圖片。視相機廠牌型號的不同，產生的圖檔有可能是 JPEG 或 PPM 格式。

.TP

.B -z

將產生之檔案的最後存取時間設定為照片的實際拍攝時間。

.TP

.B -i

僅辨識輸入檔案的格式而不進行解碼。如果

.B dcraw

可以支援該種檔案，本指令結束時的狀態碼會是 0，反之如果辨識失敗狀態碼則是 1。

.B -i -v

則可以顯示圖檔之詮釋資料 (metadata)。

.TP

.B ""

請注意

.B dcraw

不能解碼 JPEG 格式檔案！

.SH 影像修補選項

.TP

.B -P deadpixels.txt

忽略 .badpixels 參數，自此檔案中讀取損壞感應元件之資料列表

參見

.B 相關檔案

中之檔案格式敘述

.TP

.B -K darkframe.pgm

使用黑框抵消法來消除影像雜訊。如欲產生黑框影像，請將相機鏡頭蓋上後拍攝一張原始影像照片，

並使用

.B dcraw -D -4 -j -t 0

指令來產生參考檔案。

.TP

.B -k 黑暗度

當影像中的陰影顯得模糊時，你可以試著增加黑暗度來改善這個問題。

你可以利用上述指令來產生參考檔案後，再利用下述指令來測量黑暗度：

.B pamsumm -mean

.TP

.B -S 飽和度

當影像中的亮處顯得發紅時，你可以試著減低飽和度來改善問題。

請先到一個明亮的地方拍張照片，再利用下述指令來度量飽和度的參考值：

.B dcraw -D -4 -j -c

photo.raw

.B | pamsumm -max

.TP

.B ""

在一般的情況下，預設的黑暗度與飽和度應該是不需調整的。

.TP

.B -n 雜訊消除臨界值

利用微波法來消除雜訊同時保存影像細節。

雜訊消除臨界值我們建議使用 100 至 1000 之間的數值。

.TP

.B -C 紅色縮放倍數 藍色縮放倍數

根據參數來縮放紅色與藍色圖層。通常倍數是在 0.999 至 1.001 之間，

此指令可以透過紅藍圖層的縮放來消除影像的色像差。

.TP

.B -H 0

將影像中過亮部份改成純白色。（預設功能）

.TP

.B -H 1

影像中過亮部份以淡粉紅色階調來取代。

.TP

.B -H 2

混合過曝與正常曝光值來產生均勻的漸層白色。

.TP

.B -H 3+

重建影像中高亮度部份的色彩。參數值較低時會比較偏向採用白色來取代高亮度部份的色彩；

高數值時則會使用顏色漸層來取代。建議嘗試您先設定成

.B -H 5

來進行試驗。如果對於效果不滿意，可再試試先用

.B -H 9

來進行轉換後，在影像編輯軟體中把帶有顏色的高亮度部份除去後，再與一張使用

.B -H 3

參數來轉換的同一圖檔進行合併。

.SH 色彩選項

在一般狀態下

.B dcraw

程式使用固定的白平衡值，這個數值是經由測量在 D65 燈光下的標準色表所得。

.TP

.B -w

使用相機所指定的白平衡值。

如果在檔案中找不到此項資料，顯示警告訊息並改用其他方式調整白平衡。

.TP

.B -a

利用整個影像的平均值來計算白平衡。

.TP

.B -A 左方座標 上方座標 寬度 高度

利用一個矩形區域的影像平均值來計算白平衡。

這項功能首先會執行

.B dcraw -j -t 0

接著選擇一個有中性灰色的區域來進行計算。

.TP

.B -r 係數0 係數1 係數2 係數3

使用自定白平衡值。

上述四個參數可以拷貝自以下指令的輸出：

.BR dcraw\ -v .

.TP

.BR +M " or " -M

使用或是捨棄影像檔案中的 color matrix 資料。

如果一併使用

.B -w

選項，則預設值為

.B +M

否則將會使用

.B -M

這個參數只會影響 Olympus、Leaf 以及 Phase One 等品牌相機所拍攝的照片。

.TP

.B -o [0-6]

選定當

.B -p

選項沒有使用時所輸出的色域：

.B \t0

\ \原始影像色彩 (各廠牌均有不同值)

.br

.B \t1

\ \ sRGB D65 (預設值)

.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\ camera.icm \ [\  -o\ output.icm \ ]

利用 ICC 描述檔案來定義相機的輸入以及輸出 colorspace。(預設的 profile 值為 sRGB)

.TP

.B -p embed

使用嵌在原始影像檔案中的 ICC 描述來決定 colorspace

.SH 內插運算選項

.TP

.B -d

將原始影像檔案內容以灰階方式解碼，不使用內插法來改善影像品質。

這個模式最適合翻拍文件

.TP

.B -D

此模式與

.B -d

一樣會輸出灰階影像，

但是影像解碼過程完全不經過任何處理。

.TP

.B -h

輸出影像的長寬減半，相對的解碼速度也會比

.B -q 0

快上一倍。

.TP

.B -q 0

使用品質略遜，但速度較快的雙線性 (bilinear) 內插法來進行影像的解碼。

.TP

.B -q 1

使用變數漸層 (Variable Number of Gradients, VNG) 內插法來進行影像的解碼。

.TP

.B -q 2

使用像素圖樣組群 (Patterned Pixel Grouping, PPG) 內插法。

.TP

.B -q 3

使用 Adaptive Homogeneity-Directed (AHD) 內插法來進行影像的解碼。

.TP

.B -f

在進行內插法演算時將 RGB 當成四種顏色。 如果利用 VNG 或是 AHD 內插法來產生影像結果

出現格狀雜訊的話，請加上這個選項來減少雜訊。

.TP

.B -m 重複運算次數

在使用內插法產生中介數值後，在紅綠與藍綠色頻上重複利用 3x3 大小的中間值濾鏡來消除色彩雜訊。

.SH 輸出選項

在一般情況下

.B dcraw

會產生利用八位元取樣、採用 BT.709 gamma 曲線、根據平均值所計算之全白色值、以及沒有詮釋資料的 PGM/PPM/PAM 檔案。

.TP

.B -W

忽略平均值計算所得之全白色值，使用參數指定的全白色值。

.TP

.B -b 亮度

將全白色值除以這個參數，預設值為 1.0。

.TP

.B -g 次方 斜率極大值

設定 gamma 曲線值，預設值為 BT.709

.RB ( -g\ 2.222\ 4.5 ).

如果你想要使用 sRGB 色域的 gamma 曲線，請使用

.BR -g\ 2.4\ 12.92 .

如欲使用簡單乘方曲線，請將斜率極大值設定成 0

.TP

.B -4

輸出 16 位元線性檔案（固定全白色值，不改變 gamma 值）

.TP

.B -T

輸出 TIFF 格式（附詮釋資料）的影像檔案。

.TP

.B -t [0-7,90,180,270]

旋轉圖片。此指令的預設值是根據相機之方向感應器資料而定。使用

.B -t 0

指令則可以取消自動旋轉功能。

.TP

.B -j

使用 Fuji\ Super\ CCD 的數位相機因為像素不是正方形，在電腦螢幕上無法以正確的長寬比顯示。

使用這個參數會產生轉 45 度角的影像，如此可以確保每個像素都對應到一個感應元件。

.TP

.BR "-s [0..N-1]" " or " "-s all"

如果在一個影像檔案裡夾有 N 個 RAW 影像檔案，利用此參數可以選擇要解碼那個影像。

以 Fuji\ Super\ CCD\ SR 相機為例，每個 RAW 影像檔案裡都包含有兩個影像，

其中一個是專門記錄高亮度區域的資料。

.SH 相關檔案

.TP

\:./.badpixels, ../.badpixels, ../../.badpixels, ...

列出相機感光元件上損壞的感應元件（dead pixels）。

.B dcraw

將會參考這個檔案在解碼時避開這些像素。這種檔案的格式為：

.sp 1

.nf

 962   91 1028350000  # 該感光元件在 2001 年八月一日至四日之間出現問題

1285 1067 0           # 不確定此感光元件損壞的確實時間

.fi

.sp 1

這些座標是以照片轉向與被裁切之前的狀態為準。請使用

.B dcraw -j -t 0

指令來找尋有問題的像素的座標。

.SH "參　見"

.BR pgm (5),

.BR ppm (5),

.BR pam (5),

.BR pamsumm (1),

.BR pnmgamma (1),

.BR pnmtotiff (1),

.BR pnmtopng (1),

.BR gphoto2 (1),

.BR cjpeg (1),

.BR djpeg (1)

.SH 作　者

本軟體由 David Coffin 製作，電郵信箱： dcoffin a cybercom o net