From dd32caf6602953e043d2dc643b057f82f9790965 Mon Sep 17 00:00:00 2001 From: Jakub Bogusz Date: Thu, 28 Apr 2005 18:38:44 +0000 Subject: [PATCH] - up to current 0edfe10acf69c93724e271646ae79df5 dcraw.1 dbbf0b001eb8d7983c6f96390c66c732 dcraw.c Changed files: dcraw.1 -> 1.2 --- dcraw.1 | 93 +++++++++++++++++++++++++++++++-------------------------- 1 file changed, 50 insertions(+), 43 deletions(-) diff --git a/dcraw.1 b/dcraw.1 index 5a19364..218735a 100644 --- a/dcraw.1 +++ b/dcraw.1 @@ -1,7 +1,7 @@ .\" .\" Man page for dcraw (Raw Photo Decoder) .\" -.\" Copyright (c) 2003 by David Coffin +.\" Copyright (c) 2005 by David Coffin .\" .\" You may distribute without restriction. .\" @@ -9,7 +9,7 @@ .\" dcoffin a cybercom o net .\" http://www.cybercom.net/~dcoffin .\" -.TH dcraw 1 "March 6, 2004" +.TH dcraw 1 "April 28, 2005" .LO 1 .SH NAME dcraw - convert raw digital photos to PPM format @@ -18,10 +18,9 @@ dcraw - convert raw digital photos to PPM format [\fIOPTION\fR]... [\fIFILE\fR]... .SH DESCRIPTION .B dcraw -converts a list of raw digital camera files to +converts raw digital photos to .BR ppm (5) -format. Dozens of cameras are supported, and new ones are -added as they reach the market. +format. .SH OPTIONS .TP .B -i @@ -32,22 +31,12 @@ can decode the last file, 1 if it can't. .TP .B -c Write binary image data to standard output. -Otherwise, +By default, .B dcraw creates files with a ".ppm" extension. .TP .B -v -Print verbose messages. Otherwise, -.B dcraw -prints only warnings and errors. -.TP -.B -f -Interpolate RGB as four colors. The default is to assume that -all green pixels are the same. If even-row green pixels are -more sensitive to ultraviolet light than odd-row green pixels, -this difference causes a mesh pattern in the output. -.B -f -solves this problem with minimal loss of detail. +Print verbose messages. Default is to print only warnings and errors. .TP .B -d Show the raw data as a grayscale image with no interpolation. @@ -62,11 +51,11 @@ Half-size the output image. Instead of interpolating, reduce each 2x2 block of sensors to one pixel. Much faster than .BR -q . .TP -.B -g gamma -Specify the gamma value for eight-bit output. Default is 0.6. -.TP -.B -b brightness -Specify the output brightness. Default is 1.0. +.B -f +Interpolate RGB as four colors. This causes a slight loss +of detail, so use +.B -f +only if you see false 2x2 mesh patterns in blue sky. .TP .B -a Automatic color balance. The default is to use a fixed @@ -79,17 +68,49 @@ If this can't be found, prints a warning and reverts to the default. .TP .B -r red_mul -l blue_mul -After all other color adjustments, multiply the red and blue -channels by these values. Default is 1.0. +Further adjust the color balance by multiplying the red and +blue channels by these values. Both default to 1.0. +.TP +.B -b brightness +Change the output brightness. Default is 1.0. +.TP +.B -n +By default, +.B dcraw +clips all colors to prevent pink hues in the highlights. +Combine this option with +.B -b 0.25 +to leave the image data completely unclipped. +.TP +.B -m +Write raw camera colors to the output file. By default, +.B dcraw +converts to sRGB colorspace. +.TP +.B -s +For cameras based on the Fuji Super CCD SR, use the secondary +sensors, in effect underexposing the image by four stops to +reveal detail in the highlights. For all other cameras, +.B -s +is silently ignored. +.TP +.B -t [0-7] +Flip the output image. The most common flips are 5 +(90 degrees CCW) and 6 (90 degrees clockwise). By default, +dcraw tries to use the flip specified by the camera. +.RB \^" -t\ 0 \^" +forces +.B dcraw +not to flip images. .TP .B -2 -Write eight bits per color value with gamma correction and -automatic brightness adjustment. Double the height -if necessary to correct the aspect ratio. This is the default. +Write eight bits per color value with a 99th-percentile white +point and the standard 0.45 gamma curve. Double the height if +necessary to correct the aspect ratio. This is the default. .TP .B -4 -Write sixteen bits per color value, with no gamma correction, -no brightness adjustment, and no changes to the aspect ratio. +Write sixteen bits per color value. Output is linear with +input -- no white point, no gamma, same aspect ratio. .TP .B -3 Same image as @@ -112,19 +133,5 @@ to produce the same images as software provided by the camera vendor. Sometimes .B dcraw gives better results! -.SH TIPS -First raise the brightness if the highlights are too dark, -then lower the gamma if the lowlights are too dark. -Use -.B -q -or -.B -h -until you get it right. -.P -To balance the color, do -.RB \^" dcraw\ -q\ -g\ 1\ -b\ 0.5 \^" -and select a rectangle of something that you know is white. -Compute the average R, G, and B values for this area, then -set red_mul and blue_mul to G/R and G/B. .SH AUTHOR Written by David Coffin, dcoffin a cybercom o net -- 2.43.0