dcraw(1) dcraw(1) NNAAMMEE dcraw - command-line decoder for raw digital photos SSYYNNOOPPSSIISS ddccrraaww [_O_P_T_I_O_N]... [_F_I_L_E]... DDEESSCCRRIIPPTTIIOONN ddccrraaww decodes raw photos, displays metadata, and extracts thumbnails. OOPPTTIIOONNSS --vv Print verbose messages, not just warnings and errors. --cc Write decoded images or thumbnails to standard out- put. --ee Extract the camera-generated thumbnail, not the raw image. You'll get either a JPEG or a PPM file, depending on the camera. --zz Change the access and modification times of an AVI, JPEG or raw file to when the photo was taken, assuming that the camera clock was set to Universal Time. --ii Identify files but don't decode them. Exit status is 0 if ddccrraaww can decode the last file, 1 if it can't. --ii --vv shows metadata. ddccrraaww cannot decode JPEG files!! --dd Show the raw data as a grayscale image with no interpolation. Good for photographing black-and- white documents. --DD Same as --dd, but totally raw (no color scaling). --hh Output a half-size color image. Twice as fast as --qq 00. --qq 00 Use high-speed, low-quality bilinear interpolation. --qq 22 Use Variable Number of Gradients (VNG) interpola- tion. --qq 33 Use Adaptive Homogeneity-Directed (AHD) interpola- tion. --ff Interpolate RGB as four colors. Use this if the output shows false 2x2 meshes with VNG or mazes with AHD. December 21, 2006 1 dcraw(1) dcraw(1) --BB ssiiggmmaa__ddoommaaiinn ssiiggmmaa__rraannggee Use a bilateral filter to smooth noise while pre- serving edges. ssiiggmmaa__ddoommaaiinn is in units of pixels, while ssiiggmmaa__rraannggee is in units of CIELab colorspace. Try --BB 22 44 to start. --bb bbrriigghhttnneessss By default, ddccrraaww writes 8-bit PGM/PPM/PAM with a BT.709 gamma curve and a 99th-percentile white point. If the result is too light or too dark, --bb lets you adjust it. Default is 1.0. --44 Write 16-bit linear pseudo-PGM/PPM/PAM with no gamma curve, no white point, and no --bb option. --TT Write TIFF output (with metadata) instead of PGM/PPM/PAM. --kk bbllaacckk Set the black point. Default depends on the cam- era. --KK ddaarrkkffrraammee..ppggmm Subtract a dark frame from the raw data. To gener- ate a dark frame, shoot a raw photo with no light and do ddccrraaww --DD --44 --jj --tt 00. --aa Automatic color balance. The default is to use a fixed color balance based on a white card pho- tographed in sunlight. --ww Use the color balance specified by the camera. If this can't be found, print a warning and revert to the default. --rr mmuull00 mmuull11 mmuull22 mmuull33 Specify your own raw color balance. These multi- pliers can be cut and pasted from the output of ddccrraaww --vv. --HH 00 Clip all highlights to solid white (default). --HH 11 Leave highlights unclipped in various shades of pink. --HH 22--99 Reconstruct highlights. Low numbers favor whites; high numbers favor colors. Try --HH 55 as a compro- mise. If that's not good enough, do --HH 99, cut out the non-white highlights, and paste them into an image generated with --HH 33. --mm Same as --oo 00. December 21, 2006 2 dcraw(1) dcraw(1) --oo [[00--55]] Select the output colorspace when the --pp option is not used: 00 Raw color (unique to each camera) 11 sRGB D65 (default) 22 Adobe RGB (1998) D65 33 Wide Gamut RGB D65 44 Kodak ProPhoto RGB D65 55 XYZ --pp ccaammeerraa..iiccmm [ --oo oouuttppuutt..iiccmm ] Use ICC profiles to define the camera's raw col- orspace and the desired output colorspace (sRGB by default). --pp eemmbbeedd Use the ICC profile embedded in the raw photo. --tt [[00--77,,9900,,118800,,227700]] Flip the output image. By default, ddccrraaww applies the flip specified by the camera. --tt 00 disables all flipping. --ss [[00--9999]] Select which raw image to decode if the file con- tains more than one. For example, Fuji Super CCD SR cameras generate a second image underexposed four stops to show detail in the high- lights. --jj For Fuji Super CCD cameras, show the image tilted 45 degrees. For cameras with non-square pixels, do not stretch the image to its correct aspect ratio. In any case, this option guarantees that each out- put pixel corresponds to one raw pixel. If they don't apply to your camera, --ss and --jj are silently ignored. FFIILLEESS :./.badpixels, ../.badpixels, ../../.badpixels, ... List of your camera's dead pixels, so that ddccrraaww can interpolate around them. Each line specifies the column, row, and UNIX time of death for one pixel. For example: 962 91 1028350000 # died between August 1 and 4, 2002 1285 1067 0 # don't know when this pixel died These coordinates are before any cropping or rota- tion, so use ddccrraaww --jj --tt 00 to locate dead pixels. December 21, 2006 3 dcraw(1) dcraw(1) SSEEEE AALLSSOO ppggmm(5), ppppmm(5), ppaamm(5), ppnnmmggaammmmaa(1), ppnnmmttoottiiffff(1), ppnnmm-- ttooppnngg(1), ggpphhoottoo22(1), ccjjppeegg(1), ddjjppeegg(1) AAUUTTHHOORR Written by David Coffin, dcoffin a cybercom o net December 21, 2006 4