UFRaw - Convert camera RAW images to standard image files.


   ufraw [OPTIONS] <rawfile(s)>
   ufraw-batch [OPTIONS] <rawfile(s)>


   The Unidentified Flying Raw (UFRaw) is a utility to read and manipulate
   raw images from digital cameras. It reads raw images using Dave
   Coffin's raw conversion utility - DCRaw. UFRaw supports basic color
   management using Little CMS, allowing the user to apply color profiles.
   For Nikon users UFRaw has the advantage that it can read the camera's
   tone curves.  Even if you don't own a Nikon, you can still apply a
   Nikon curve to your images.

   By default 'ufraw' displays a preview window for each raw image
   allowing the user to tweak the image parameters before saving. If no
   raw images are given at the command line, UFRaw will display a file
   chooser dialog.  To process the images with no questions asked (and no
   preview) use the command 'ufraw-batch'.

   The input files can be either raw images or UFRaw ID-files.  ID-files
   contain a raw image filename and the parameters for handling the image.

   UFRaw can also work as a GIMP plug-in. To activate it simply open a raw
   image or a UFRaw ID-file in the GIMP.


   The options supplied on the command-line decide the starting-values for
   the GUI. The GUI will then allow you to tweak these values before
   saving the final image.

   General Options
       Display the version of UFRaw and exit.

       Display a brief description of how to use UFRaw and exit.

       Force window to be maximized.

       Do not display any messages during conversion. This option is only
       valid with 'ufraw-batch'.

       Load all parameters from an ID-file. This feature can be used to
       tweak the parameters for one file using the GUI and using those
       parameters as the starting point for other images as well.

   Image Manipulation Options
   These command-line options override settings from the default
   configuration of UFRaw and from any loaded ID-file. The best way to
   learn about how these parameters work is to experiment with the GUI.
   All parameters correspond exactly to a setting available in the GUI.
   Not all parameters in the GUI have corresponding command-line options.

       White balance setting. "camera" means that UFRaw tries to read the
       color-temperature and green color component that the camera
       recorded in the meta-information in the raw-file. This does not
       work for all cameras. If UFRaw fails to read the white-balance
       information from the meta-information, it falls back to "auto".

       "auto" means that UFRaw calculates the color-temperature and green
       color component automatically from the image data.

       The white-balance can also be set manually with the --temperature
       and --green options.

       Manually set the color temperature in Kelvin.

       Green color component. Range 0.20 to 2.50.

       Gamma adjustment of the base curve. Range 0.10 to 1.00. Default

       Linearity of the base curve. Range 0.00 to 1.00. Default 0.10.

       Auto exposure or exposure correction in EV. Range -3.00 to 3.00.
       Default 0.

       Control how highlights are restored when applying negative EV.
       'clip' restores nothing and is therefore safe from any artifacts.
       'lch' restores in LCH space, resulting in restored highlights with
       soft details (good for clouds).  'hsv' restores in HSV space,
       resulting in restored highlights with sharp details.  The default
       is 'lch'.

       Control how highlights are clipped when applying positive EV.
       'digital' corresponds to using a linear response, emulating the
       harsh behaviour of the digital sensor.  'film' emulate the soft
       film response.  The default is 'digital'.

       Adjust the color saturation. Range 0.00 to 8.00. Default 1.0, use 0
       for black & white output.

       Wavelet denoising threshold (default 0.0).

       Sensitivity for detecting and shaving hot pixels (default 0.0).

       Type of tone curve to use. The base curve is a combination of the
       gamma curve corrected by the curve specified here.  The base curve
       is applied to each channel of the raw data after the white balance
       and color matrix, but before the ICC transformation.

       "manual" means that a manual tone curve is used.  This is probably
       not very useful as a command-line option, since there is no way to
       specify what the curve should look like.

       "linear" means that no tone curve corrections is performed.

       "custom" means that UFRaw shall use the curve supplied by the
       camera in the meta-information in the raw-file.

       "camera" means that UFRaw shall use the "custom" curve only if the
       camera was set to use it (according to the meta-information).
       Otherwise the "linear" curve is used.

       CURVE can be the filename (without path) of any curve that was
       previously loaded in the GUI.

       The default is "camera" if such a curve exists, linear otherwise.

       Load the base curve from a file.  The curve file format can be
       either UFRaw's XML format or Nikon's NTC/NCV format.

       Type of luminosity curve to use. This curve is applied in HSV space
       and therefore hue and saturation should not be effected by it.

       "manual" means that a manual luminosity curve is used.  This is
       probably not very useful as a command-line option, since there is
       no way to specify what the curve should look like.

       "linear" means that no luminosity correction is performed.

       CURVE can be the filename (without path) of any curve that was
       previously loaded in the GUI.

       The default is "linear".

       Load the luminosity curve from a file.  The curve file format can
       be either UFRaw's XML format or Nikon's NTC/NCV format.

       Black-point value. Range 0.0 to 1.0, default 0.0.

       Interpolation algorithm to use when converting from the color
       filter array to normal RGB values. AHD (Adaptive Homogeneity
       Directed) interpolation is the best, but also the slowest. VNG
       (Variable Number Gradients) is second best and a bit faster.
       Bilinear is the simplest yet fastest interpolation.

       "four-color" is a variation of the VNG interpolation that should
       only be used if you see strange square patterns in the VNG
       interpolation, See <http://www.cybercom.net/~dcoffin/dcraw/>.

       AHD is the default interpolation.  AHD interpolation is not
       supported for cameras with four color filters, such as the Sony-828
       RGBE filter. In such cases, VNG interpolation will be used instead.

       Apply color smoothing.

       Grayscale conversion algorithm to use (default none).

       Grayscale mixer values to use (default 1,1,1).

       Use FILE for raw darkframe subtraction.

   Output Options
   The options which are related to the final output are:

       Shrink the image by FACTOR (default 1).

       Downsize max(height,width) to SIZE.

       Rotate image to camera's setting, by ANGLE degrees clockwise, or do
       not rotate the image (default camera)

       Crop the output to the given pixel range, relative to the raw image
       after rotation but before any scaling.

       Crop the output automatically.

   --aspect-ratio X:Y
       Set crop area aspect ratio.

       Do not apply lens correction or try to apply correction by auto-
       detecting the lens (default auto).

       Output file-format to use.  The default output file-format is ppm.

       Output bit depth per channel.  ppm, tiff, png and fits output
       formats can uses either 8 bits or 16 bits to encode each of the
       Red, Green and Blue components of each pixel.  The jpeg format only
       allows for 8 bits for each color component.

       The raw-files contain more than eight bits of information for each
       color component. This means that by using an eight bit format, you
       are actually discarding some of the information supplied by the
       camera. This is not a problem if you only plan to view the image on
       screen. For prints you should consider a 16 bits workflow.

       JPEG quality factor. Range 0-100 with a higher number giving a
       higher quality at the cost of a larger file. Default 85. The
       --compression parameter is only relevant if the output file-format
       is jpeg.

       Embed exif in output. Default embed exif. Exif is currently
       embedded in JPEG, PNG and TIFF output.

       Enable [disable] TIFF zip compression. The zip-compression is loss-
       less.  Default nozip. The --zip parameter is only relevant if the
       output file-format if tiff8 or tiff16.

       PATH for output file. In batch mode by default, output-files are
       placed in the same directory as the input-files. In interactive
       mode UFRaw tries to ''guess'' if you have a favorite output

       Output file name to use. This is only relevant if a single raw-file
       is supplied on the command-line. . Use '-' to output to stdout. The
       default is to name the output-file the same as the input-file but
       with the extension given by the output file-format.

       Overwrite existing files without asking. Default is to ask before
       deleting an existing file.

       Control whether UFRaw ID files are created for the output image.
       (Default is no).

       Extract the preview image embedded in the raw file instead of
       converting the raw image. This option is only valid with

Conversion Setting Priority

   Conversion settings are applied in the following priority order:

   1. Command-line options
   2. Settings from the configuration file specified with --conf=<ID-file>
   (ignoring any filenames in the ID-file).
   3. Settings from an ID-file supplied as an input-file.
   4. Settings from $HOME/.ufrawrc
   5. UFRaw's default settings.

   This means that an option supplied on the command-line always takes
   precedence over all other options.

   The conversion settings can be changed in the GUI before the resulting
   image is saved.


   $HOME/.ufrawrc or $HOME/.config/ufrawrc (depending on the system) -
   UFRaw resource file containing the user default settings. This is an
   XML file that can be modified with any text editor. Still, it is
   recommended not to edit this file. This file is updated from the GUI
   when you save an image, or when you explicitly ask to save this file in
   the 'Options' menu.

   $HOME/.ufraw-gtkrc - An optional file for setting up a specific GTK
   theme for UFRaw.


   UFRaw homepage: <http://ufraw.sourceforge.net>
   DCRaw homepage: <http://www.cybercom.net/~dcoffin/dcraw>


   The GIMP homepage: <http://www.gimp.org>


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.

Free Software

Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.

Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.

Free Books

The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.

Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.

Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.