PaulChaseDempsey@msn.com
Copyright© 2001-2002 Paul Chase Dempsey
All Rights Reserved
ORF2TIFF is a command-line version of ORF geared for batch conversion of Olympus Raw Format files. It is most easily used with OIS files saved from ORF.
|
|
PCD Arts PaulChaseDempsey@msn.com |
|
Copyright© 2001-2002 Paul Chase Dempsey | |
Download the PCD Arts ORF Suite from http://groups.msn.com/PaulChaseDempsey/files.msnw.
Parts of this software is based on the work of the Independent JPG Group (IJG). See Legal Notices for more information.
Revision History
Feature Summary
Command-Line Syntax
ORF Import Settings Format
Legal Notices
Trademarks
| Version | Changes |
| 1.00 - June 12, 2001 | First release. |
| 1.01 - June 16, 2001 | Add -c option to read current settings and curves from the ORF registry. This way, you can use ORF as a graphical editor for the complex ORF2TIFF options. |
| 1.02 - June 22, 2001 | Add unsharp mask |
| 1.06 - April 10, 2002 | Support E-20 |
| 1.07 - April 16, 2002 | Add Camera color transformation matrix processing |
| 1.08 - April 18, 2002 | Preserve standard Exif information |
| 1.09 - April 23, 2002 | Fix USM threshholding bug (much better USM!). |
| 1.10 - May 23, 2002 | Faster processing, Add Windows Bitmap BMP output (-w), Add Optical Black Point (=O), Add annotations =A, -aa, -ac |
| 1.11 - May 24, 2002 | Fix TIFF glitch that causes trouble for some programs. |
| 1.12 - May 28, 2002 | Fix silly crash bug. |
| 1.13 - August 23, 2002 | Fix OIS read crash, Gamma setting, and -g doc re =z |
| 1.14 - Sept 25, 2002 | Revamp interpolation algorithms add version banner add -j (JPEG output) add -ad (descript annotation) add -e (Exif) add -f (fudge) fix -o<dir> fix progress display |
| 1.15 - Sept 25, 2002 | Add =Y, -y Saturation option |
ORF2TIFF [ois] [acv] [eq-options] [dash-params] file...
You can freely intermix ois, acv, options, params, and files on the command line. All items are processed in order, left to right. When an ORF file is encountered, the options specified up to that point are used. Note that an OIS sets all conversion options and curves, and an ACV sets only the curves (but does not turn on the use of curves). The options and their meaning are identical to their ORF counterparts.
The eq-options are a little unusual, in that they start with an equals sign, instead of the familiar / or -. These are simple Boolean conversion flags. The other options specify parameters, or control the general operation of the program.
| Parameter | Syntax | Default Setting | Description | |
| ois | OIS file name | ORF Import Settings file (save from ORF). Loads all processing options and curves from the file. Create an OIS file using the File.Save Settings command in ORF. | ||
| acv | ACV file name | Adobe Curve file. Loads curves from the file. Requires =C or =R to have an effect. Create ACV files in ORF, Adobe Photoshop, or other compatible programs. | ||
| eq-options | =optlist | =ltwz | Specifies one or more of the following Boolean options (that is, on/off options). Option letters are case-insensitive. | |
| + | on | Turn on all options that follow (up to a -) | ||
| - | off | Turn off all options that follow (up to a +) | ||
| 1 | - | Rotate 90° clockwise | ||
| 2 | - | Rotate 180° | ||
| 3 | - | Rotate 270° (90° counter-clockwise) | ||
| A | on | Annotate | Set annotations with -aa, -ac and -ad. | |
| B | - | Balance Colors | ||
| C | - | Curve | Curves may be specified only in an ACV or OIS file. | |
| E | on | Exif | Exif information included in the output file. | |
| F | on | Fudge | Applies magic fudge factor scaling for color correction. | |
| G | - | Grayscale | ||
| H | - | Flip Horizontally (left for right) | ||
| I | - | Invert (make negative) | ||
| L | on | Levels | Set thresholds for Levels with -n | |
| M | on | Camera color transformation matrix | ||
| O | on | Camera Optical Black Point | ||
| R | - | Raw Curves | Curves may be specified only in an ACV or OIS file. | |
| S | on | Scale | Set scaling ratios with -s | |
| T | on | Texture Defect Removal | Set detection threshold with -t | |
| U | - | Unsharp Mask (sharpen) | Set USM parameters with -u | |
| V | - | Flip Vertically (top for bottom) | ||
| W | on | White Balance using camera settings | ||
| X | - | Channel Levels | Set thresholds for Levels with -n | |
| Z | on | Gamma | Set gamma value with -g | |
| dash-params | Specifies on or more of the following parameters. | |||
| -aa:artist | Artist annotation string. Quote the string to include spaces. Requires =a on to have an effect. | |||
| -ac:copyright | Copyright annotation string. Quote the string to include spaces. Requires =a on to have an effect. | |||
| -ad:description | Description annotation string. Quote the string to include spaces. Requires =a on to have an effect. | |||
| -b:(8|16) | 16 | Bit-depth (bits per component). Must be 8 or 16. | ||
| -c | off | Current ORF settings. Reads options and curves from ORF's registry. If ORF is currently running, these are the options and curves current when the main image was last updated. If no file is open, you can choose Snap Settings from the File menu to save a snapshot of the current settings. | ||
| -g[:gamma] | 2.2222 | Specifies a gamma value. Requires =z on to have an effect. | ||
| -j[:quality] | 95 | Saves as a JPEG with quality from 10 to 100. | ||
| -m:method | 8 | Select the interpolation method. If an obsolete method is
selected, method 8 will be used. 0 = None -- Raw CCD Bayer Pattern 1 = Bilinear Interpolation 2 = obsolete (was LaPlacian gradients) 3 = obsolete (was LaPlacian gradients (floating point)) 4 = obsolete (was Luminance) 5 = obsolete (was Luminance using gradients) 6 = obsolete (was Luminance using gradients (floating point)) 7 = Black and White (luminance only) (now fixed-point) 8 = Luminance using gradients (fixed point) |
||
| -n:lo,hi | 0.004,0.000 | Set thresholds for Levels. Requires =L or =X on
to have an effect. Use -1 to suppress Level processing at that end. To set the black or white point to the end of the scale without any clipping, specify 0.0. |
||
| -o:folder | Current directory | Output folder. Specifies where the resulting .TIF files are to be created. | ||
| -p | off | Print settings and actions to the console without actually processing files. | ||
| -q | Quiet: Do not print detailed progress information. | |||
| Very Quiet (silent) Do not print any progress information. | ||||
| -s:r/r:g/g:b/b | 250/256:268/256:252,256 | Set ratios for scaling. Requires =S to have an effect. | ||
| -t:n | 4 | Set threshold for Texture defect removal. Requires =T on to have an effect. | ||
| -u:amount,radius,threshold | 100,1.1,0 | Set unsharp mask parameters. Requires =U on to have an effect. | ||
| -w | off | Save as Windows bitmap (.BMP). The -b:16 is ignored: the file is always 8bpp. | ||
| file... | one or more files or wildcard patterns | Lists the ORF files you want to convert. | ||
The ORF Import Settings file format is a simple text-based format. There are a small number of tags to specify ORF import options and curves. All information in an OIS file outside of a tag is ignored.
This is an example OIS file.
<ORFImport><version=4.0>
<Options="(annotate|black|gamma|levels|matrix|scale|tt|wb) gamma=2.2222 noise(0,0)
tt=4 m=1 rot=0 rscale(250,256) gscale(268,256) bscale(252,256) usm(100,1.10,0)">
<Curve_RGB="3:0,0 86,172 255,255">
<Curve_Red="2:0,0 255,255">
<Curve_Green="2:0,0 255,255">
<Curve_Blue="2:0,0 255,255">
<fmt=0><tx=1><ta=1><t16=0><jx=1><ja=1><jq=95>
<Artist="Paul Chase Dempsey">
<Copyright="Copyright (C) 2002 PCD Arts, All Rights Reserved.">
| Tag | Description |
| ORFImport | Indicates that this is an ORF Import file. |
| version | The file format version. Currently, only 4.0 is specified. |
| Options | All ORF conversion options. |
| Curve_RGB | Master, or All-Channel curve |
| Curve_Red | Curve to be applied to the Red channel |
| Curve_Green | Curve to be applied to the Green channel |
| Curve_Blue | Curve to be applied to the Blue channel |
| Artist | Artist annotation string |
| Copyright | Copyright annotation string |
| Description | Image description annotation string |
| fmt | Save format: 0 = TIFF 1 = Bitmap 2 = JPEG |
| tx | TIFF Exif (1 = TRUE, 0 = FALSE) |
| ta | TIFF Annotations (1 = TRUE, 0 = FALSE) |
| t16 | TIFF 16-bit (1 = TRUE, 0 = FALSE) |
| jx | JPEG Exif (1 = TRUE, 0 = FALSE) |
| ja | JPEG Annotations (1 = TRUE, 0 = FALSE) |
| jq | JPEG Quality |
| Options Value Syntax | flags params | |
| flags | Specifies a set of Boolean flags. If a flag is present, the option is turned on. If a flag is absent, the option is turned off. | |
| (flag[|flag]...) | Flag | Description |
| annotate | obsolete - ignored | |
| asktt | Prompts for confirmation before correcting the Texture Defect | |
| balance | Color Balance | |
| black | Camera Optical Black Point | |
| bpp16 | obsolete - ignored | |
| curves | Curves | |
| fudge | Fudge | |
| gamma | Gamma | |
| gray | Grayscale | |
| hflip | Flip Horizontally | |
| invert | Invert | |
| levels | Levels | |
| matrix | Camera color transformation matrix | |
| rgblevels | Channel Levels | |
| scale | Scale | |
| tt | Detect and fix Texture Defect | |
| vflip | Flip Vertically | |
| usm | Unsharp Mask | |
| wb | White Balance using camera settings | |
| params | Specifes a list of parameters and their values. If a parameter has a single item, the syntax is a variable assignment. If the parameter takes more items, the syntax is a parenthesized list after the name. | |
| Param | Description | |
| gamma=gamma | Gamma value | |
| noise(lo,hi) | Thresholds for Levels. Units of 1 == 0.001%. | |
| tt=threshold | Threshold for Texture Defect Repair | |
| m=method | Interpolation method. See the -m option in the Command-Line Syntax for the list of values. | |
| rot=rotation | Rotation: 0 = none 1 = 90° 2 = 180° 3 = 270° |
|
| rscale(num,denom) | Red scaling ratio | |
| gscale(num,denom) | Green scaling ratio | |
| bscale(num,denom) | Blue scaling ratio | |
| usm(amount,radius,threshold) | Unsharp mask parameters | |
| Curve Value Syntax | |
| count: in,out... | Count of points followed by list of points in input,output pairs where the values are in the range 0-255. The points should be listed in ascending input value order. |
ORF Suite - Copyright© 2001-2002 Paul Chase Dempsey, All Rights Reserved
This program is free and provided "AS IS" without warranty of any kind, either expressed or implied, including, but not limited to the implied warranties of merchantability and fitness for a particular purpose. The entire risk for the quality and performance of this program is with you. Should the program prove defective, you assume the cost of all necessary servicing, repair or correction.
This software is based in part on the work of the Independent JPEG Group (IJG).
The IJG code carries the following legal notice:
The authors make NO WARRANTY or representation, either express or implied,
with respect to this software, its quality, accuracy, merchantability, or
fitness for a particular purpose. This software is provided "AS IS", and you,
its user, assume the entire risk as to its quality and accuracy.
This software is copyright (C) 1991-1998, Thomas G. Lane.
All Rights Reserved except as specified below.
Permission is hereby granted to use, copy, modify, and distribute this
software (or portions thereof) for any purpose, without fee, subject to these
conditions:
(1) If any part of the source code for this software is distributed, then this
README file must be included, with this copyright and no-warranty notice
unaltered; and any additions, deletions, or changes to the original files
must be clearly indicated in accompanying documentation.
(2) If only executable code is distributed, then the accompanying
documentation must state that "this software is based in part on the work of
the Independent JPEG Group".
(3) Permission for use of this software is granted only if the user accepts
full responsibility for any undesirable consequences; the authors accept
NO LIABILITY for damages of any kind.
Olympus® is a registered trademark of Olympus Optical Co. Ltd.
Adobe® and Photoshop® are registered trademarks of Adobe Systems Inc.
Microsoft® and Windows® are registered trademarks of Microsoft Corp.
The tools in the PCD Arts ORF Suite are NOT products
of Olympus Optical Co, Ltd.
PCD Arts and Paul Chase Dempsey are not affiliated with Olympus Optical Co.