dcraw(1)

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

總　覽
dcraw [參數]... [圖檔路徑]...

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

一般選項

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

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

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

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

-i  僅辨識輸入檔案的格式而不進行解碼。如果 dcraw 可以支援該種檔案，本指令結束時的狀態碼會是 0，反之如果辨識失敗狀態碼則是 1。 -i -v 則可以顯示圖檔之詮釋資料 (metadata)。

    請注意 dcraw 不能解碼 JPEG 格式檔案！

影像修補選項

-P deadpixels.txt
    忽略 .badpixels 參數，自此檔案中讀取損壞感應元件之資料列表 參見 相關檔案 中之檔案格式敘述

-K darkframe.pgm
    使用黑框抵消法來消除影像雜訊。如欲產生黑框影像，請將相機鏡頭蓋上後拍攝一張原始影像照片， 並使用 dcraw -D -4 -j -t 0 指令來產生參考檔案。

-k 黑暗度
    當影像中的陰影顯得模糊時，你可以試著增加黑暗度來改善這個問題。 你可以利用上述指令來產生參考檔案後，再利用下述指令來測量黑暗度： pamsumm -mean

-S 飽和度
    當影像中的亮處顯得發紅時，你可以試著減低飽和度來改善問題。 請先到一個明亮的地方拍張照片，再利用下述指令來度量飽和度的參考值： dcraw -D -4 -j -c photo.raw | pamsumm -max

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

-n 雜訊消除臨界值
    利用微波法來消除雜訊同時保存影像細節。 雜訊消除臨界值我們建議使用 100 至 1000 之間的數值。

-C 紅色縮放倍數 藍色縮放倍數
    根據參數來縮放紅色與藍色圖層。通常倍數是在 0.999 至 1.001 之間， 此指令可以透過紅藍圖層的縮放來消除影像的色像差。

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

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

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

-H 3+
    重建影像中高亮度部份的色彩。參數值較低時會比較偏向採用白色來取代高亮度部份的色彩； 高數值時則會使用顏色漸層來取代。建議嘗試您先設定成 -H 5 來進行試驗。如果對於效果不滿意，可再試試先用 -H 9 來進行轉換後，在影像編輯軟體中把帶有顏色的高亮度部份除去後，再與一張使用 -H 3 參數來轉換的同一圖檔進行合併。

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

-w  使用相機所指定的白平衡值。 如果在檔案中找不到此項資料，顯示警告訊息並改用其他方式調整白平衡。

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

-A 左方座標 上方座標 寬度 高度
    利用一個矩形區域的影像平均值來計算白平衡。 這項功能首先會執行 dcraw -j -t 0 接著選擇一個有中性灰色的區域來進行計算。

-r 係數0 係數1 係數2 係數3
    使用自定白平衡值。 上述四個參數可以拷貝自以下指令的輸出： dcraw -v.

+M or -M
    使用或是捨棄影像檔案中的 color matrix 資料。 如果一併使用 -w 選項，則預設值為 +M 否則將會使用 -M 這個參數只會影響 Olympus、Leaf 以及 Phase One 等品牌相機所拍攝的照片。

-o [0-5]
    選定當 -p 選項沒有使用時所輸出的色域： 0 原始影像色彩 (各廠牌均有不同值)
    1 sRGB D65 (預設值)
    2 Adobe RGB (1998) D65
    3 Wide Gamut RGB D65
    4 Kodak ProPhoto RGB D65
    5 XYZ

-p camera.icm [ -o output.icm ]
    利用 ICC 描述檔案來定義相機的輸入以及輸出 colorspace。(預設的 profile 值為 sRGB)

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

內插運算選項

-d  將原始影像檔案內容以灰階方式解碼，不使用內插法來改善影像品質。 這個模式最適合翻拍文件

-D  此模式與 -d 一樣會輸出灰階影像， 但是影像解碼過程完全不經過任何處理。

-h  輸出影像的長寬減半，相對的解碼速度也會比 -q 0 快上一倍。

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

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

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

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

-f  在進行內插法演算時將 RGB 當成四種顏色。 如果利用 VNG 或是 AHD 內插法來產生影像結果 出現格狀雜訊的話，請加上這個選項來減少雜訊。

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

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

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

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

-g 次方 斜率極大值
    設定 gamma 曲線值，預設值為 BT.709 (-g 2.222 4.5). 如果你想要使用 sRGB 色域的 gamma 曲線，請使用 -g 2.4 12.92. 如欲使用簡單乘方曲線，請將斜率極大值設定成 0

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

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

-t [0-7,90,180,270]
    旋轉圖片。此指令的預設值是根據相機之方向感應器資料而定。使用 -t 0 指令則可以取消自動旋轉功能。

-j  使用 Fuji Super CCD 的數位相機因為像素不是正方形，在電腦螢幕上無法以正確的長寬比顯示。 使用這個參數會產生轉 45 度角的影像，如此可以確保每個像素都對應到一個感應元件。

-s [0..N-1] or -s all
    如果在一個影像檔案裡夾有 N 個 RAW 影像檔案，利用此參數可以選擇要解碼那個影像。 以 Fuji Super CCD SR 相機為例，每個 RAW 影像檔案裡都包含有兩個影像， 其中一個是專門記錄高亮度區域的資料。

相關檔案

./.badpixels, ../.badpixels, ../../.badpixels, ...
    列出相機感光元件上損壞的感應元件（dead pixels）。 dcraw 將會參考這個檔案在解碼時避開這些像素。這種檔案的格式為：

     962   91 1028350000  # 該感光元件在 2001 年八月一日至四日之間出現問題
    1285 1067 0           # 不確定此感光元件損壞的確實時間

    這些座標是以照片轉向與被裁切之前的狀態為準。請使用 dcraw -j -t 0 指令來找尋有問題的像素的座標。

參　見
pgm(5), ppm(5), pam(5), pamsumm(1), pnmgamma(1), pnmtotiff(1), pnmtopng(1), gphoto2(1), cjpeg(1), djpeg(1)

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