ORF2TIFF -- Batch Mode Olympus® Raw Format File Tool

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 logo PCD Arts
PaulChaseDempsey@msn.com

Copyright© 2001-2002 Paul Chase Dempsey
All Rights Reserved

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.

Contents

Revision History
Feature Summary
Command-Line Syntax
ORF Import Settings Format
Legal Notices
Trademarks

Revision History

 

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

 

Feature Summary

 

Command-Line Syntax

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.
-qq   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.

 

ORF Import Settings Format

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.

 

Legal Notices

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.

Trademarks

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.