1UFRAW(1) UFRAW(1)
2
3
4
6 UFRaw - Convert camera RAW images to standard image files.
7
9 ufraw [OPTIONS] <rawfile(s)>
10 ufraw-batch [OPTIONS] <rawfile(s)>
11
13 The Unidentified Flying Raw (UFRaw) is a utility to read and manipulate
14 raw images from digital cameras. It reads raw images using Dave Cof‐
15 fin's raw conversion utility - DCRaw. UFRaw supports basic color man‐
16 agement using Little CMS, allowing the user to apply color profiles.
17 For Nikon users UFRaw has the advantage that it can read the camera's
18 tone curves. Even if you don't own a Nikon, you can still apply a
19 Nikon curve to your images.
20
21 By default 'ufraw' displays a preview window for each raw image allow‐
22 ing the user to tweak the image parameters before saving. If no raw
23 images are given at the command line, UFRaw will display a file chooser
24 dialog. To process the images with no questions asked (and no preview)
25 use the command 'ufraw-batch'.
26
27 The input files can be either raw images or UFRaw ID-files. ID-files
28 contain a raw image filename and the parameters for handling the image.
29
30 UFRaw can also work as a GIMP plug-in. To activate it simply open a raw
31 image or a UFRaw ID-file in the GIMP.
32
34 The options supplied on the command-line decide the starting-values for
35 the GUI. The GUI will then allow you to tweak these values before sav‐
36 ing the final image.
37
38 General Options
39
40 --version
41 Display the version of UFRaw and exit.
42
43 --help
44 Display a brief description of how to use UFRaw and exit.
45
46 --silent
47 Do not display any messages during batch conversion.
48
49 --conf=<ID-filename>
50 Load all parameters from an ID-file. This feature can be used
51 to tweak the parameters for one file using the GUI and using
52 those parameters as the starting point for other images as
53 well.
54
55 Image Manipulation Options
56
57 These command-line options override settings from the default con‐
58 figuration of UFRaw and from any loaded ID-file. The best way to
59 learn about how these parameters work is to experiment with the
60 GUI. All parameters correspond exactly to a setting available in
61 the GUI. Not all parameters in the GUI have corresponding command-
62 line options.
63
64 --wb=camera|auto
65 White balance setting. "camera" means that UFRaw tries to read
66 the color-temperature and green color component that the camera
67 recorded in the meta-information in the raw-file. This does not
68 work for all cameras. If UFRaw fails to read the white-balance
69 information from the meta-information, it falls back to "auto".
70
71 "auto" means that UFRaw calculates the color-temperature and
72 green color component automatically from the image data.
73
74 The white-balance can also be set manually with the --tempera‐
75 ture and --green options.
76
77 --temperature=TEMP
78 Manually set the color temperature in Kelvin (2000 - 7000).
79
80 --green=GREEN
81 Green color component. Range 0.20 to 2.50.
82
83 --gamma=GAMMA
84 Gamma adjustment of the base curve. Range 0.10 to 1.00. Default
85 0.45.
86
87 --linearity=LINEARITY
88 Linearity of the base curve. Range 0.00 to 1.00. Default 0.10.
89
90 --exposure=auto|EXPOSURE
91 Auto exposure or exposure correction in EV. Range -3.00 to
92 3.00. Default 0.
93
94 --restore=clip|lch|hsv
95 Control how highlights are restored when applying negative EV.
96 'clip' restores nothing and is therefore safe from any arti‐
97 facts. 'lch' restores in LCH space, resulting in restored
98 highlights with soft details (good for clouds). 'hsv' restores
99 in HSV space, resulting in restored highlights with sharp
100 details. The default is 'lch'.
101
102 --clip=digital|film
103 Control how highlights are clipped when applying positive EV.
104 'digital' corresponds to using a linear response, emulating the
105 harsh behaviour of the digital sensor. 'film' emulate the soft
106 film response. The default is 'digital'.
107
108 --saturation=SAT
109 Adjust the color saturation. Range 0.00 to 3.00. Default 1.0,
110 use 0 for black & white output.
111
112 --base-curve=manual|linear|custom|camera|CURVE
113 Type of tone curve to use. The base curve is a combination of
114 the gamma curve corrected by the curve specified here. The
115 base curve is applied to each channel of the raw data after the
116 white balance and color matrix, but before the ICC transforma‐
117 tion.
118
119 "manual" means that a manual tone curve is used. This is prob‐
120 ably not very useful as a command-line option, since there is
121 no way to specify what the curve should look like.
122
123 "linear" means that no tone curve corrections is performed.
124
125 "custom" means that UFRaw shall use the curve supplied by the
126 camera in the meta-information in the raw-file.
127
128 "camera" means that UFRaw shall use the "custom" curve only if
129 the camera was set to use it (according to the meta-informa‐
130 tion). Otherwise the "linear" curve is used.
131
132 CURVE can be the filename (without path) of any curve that was
133 previously loaded in the GUI.
134
135 The default is "camera" if such a curve exists, linear other‐
136 wise.
137
138 --base-curve-file=<curve-file>
139 Load the base curve from a file. The curve file format can be
140 either UFRaw's XML format or Nikon's NTC/NCV format.
141
142 --curve=manual|linear|CURVE
143 Type of luminosity curve to use. This curve is applied in HSV
144 space and therefore hue and saturation should not be effected
145 by it.
146
147 "manual" means that a manual luminosity curve is used. This is
148 probably not very useful as a command-line option, since there
149 is no way to specify what the curve should look like.
150
151 "linear" means that no luminosity correction is performed.
152
153 CURVE can be the filename (without path) of any curve that was
154 previously loaded in the GUI.
155
156 The default is "linear".
157
158 --curve-file=<curve-file>
159 Load the luminosity curve from a file. The curve file format
160 can be either UFRaw's XML format or Nikon's NTC/NCV format.
161
162 --black-point=auto|BLACK
163 Black-point value. Range 0.0 to 1.0, default 0.0.
164
165 --interpolation=ahd|vng|four-color|ppg|bilinear
166 Interpolation algorithm to use when converting from the Bayer-
167 pattern to normal RGB values. AHD (Adaptive Homogeneity
168 Directed) interpolation is the best, but also the slowest. VNG
169 (Variable Number Gradients) is second best and a bit faster.
170 Bilinear is the simplest yet fastest interpolation.
171
172 "four-color" is a variation of the VNG interpolation that
173 should only be used if you see strange square patterns in the
174 VNG interpolation, See <http://www.cybercom.net/~dcof‐
175 fin/dcraw/>.
176
177 AHD is the default interpolation. AHD interpolation is not
178 supported for cameras with four color filters, such as the
179 Sony-828 RGBE filter. In such cases, VNG interpolation will be
180 used instead.
181
182 --darkframe=FILE
183 Use FILE for raw darkframe subtraction.
184
185 Output Options
186
187 The options which are related to the final output are:
188
189 --shrink=FACTOR
190 Shrink the image by FACTOR (default 1).
191
192 --size=SIZE
193 Downsize max(height,width) to SIZE.
194
195 --out-type=ppm8|ppm16|tiff8|tiff16|jpeg
196 Output file-format to use. ppm8 and tiff8 uses eight bits to
197 encode each of the Red, Green and Blue components of each
198 pixel. ppm16 and tiff16 uses 16 bits. The jpeg-format only
199 allows for eight bits for each color component.
200
201 The raw-files contain more than eight bits of information for
202 each color component. This means that by using an eight bit
203 format, you are actually discarding some of the information
204 supplied by the camera. This is not a problem if you only plan
205 to view the image on screen. For prints you should consider a
206 16 bits workflow.
207
208 The default output file-format is ppm8.
209
210 --compression=VALUE
211 JPEG quality factor. Range 0-100 with a higher number giving a
212 higher quality at the cost of a larger file. Default 85. The
213 --compression parameter is only relevant if the output file-
214 format is jpeg.
215
216 --[no]exif
217 Embed exif in output JPEG. Default embed exif. Exif information
218 can only be embedded in jpeg-files.
219
220 --[no]zip
221 Enable [disable] TIFF zip compression. The zip-compression is
222 loss-less. Default nozip. The --zip parameter is only relevant
223 if the output file-format if tiff8 or tiff16.
224
225 --out-path=PATH
226 PATH for output file. In batch mode by default, output-files
227 are placed in the same directory as the input-files. In inter‐
228 active mode UFRaw tries to ''guess'' if you have a favorite
229 output directory.
230
231 --output=FILE
232 Output file name to use. This is only relevant if a single raw-
233 file is supplied on the command-line. . Use '-' to output to
234 stdout. The default is to name the output-file the same as the
235 input-file but with the extension given by the output file-for‐
236 mat.
237
238 --overwrite
239 Overwrite existing files without asking. Default is to ask
240 before deleting an existing file.
241
242 --create-id=no|also|only
243 Control whether UFRaw ID files are created for the output
244 image. (Default is no).
245
246 --embedded-image
247 Extract the preview image embedded in the raw file instead of
248 converting the raw image.
249
251 Conversion settings are applied in the following priority order:
252
253 1. Command-line options
254 2. Settings from the configuration file specified with --conf=<ID-file>
255 (ignoring any filenames in the ID-file).
256 3. Settings from an ID-file supplied as an input-file.
257 4. Settings from $HOME/.ufrawrc
258 5. UFRaw's default settings.
259
260 This means that an option supplied on the command-line always takes
261 precedence over all other options.
262
263 The conversion settings can be changed in the GUI before the
264 resulting image is saved.
265
267 $HOME/.ufrawrc - UFRaw resource file containing the user default set‐
268 tings. This is an XML file that can be modified with any text editor.
269 Still, it is recommended not to edit this file. This file is updated
270 from the GUI when you save an image, or when you explicitly ask to save
271 this file in the 'Options' menu.
272
274 UFRaw homepage: <http://ufraw.sourceforge.net>
275 DCRaw homepage: <http://www.cybercom.net/~dcoffin/dcraw>
276
278 The GIMP homepage: <http://www.gimp.org>
279
280
281
282UFRAW 2007-11-11 UFRAW(1)