PhotomatixCL is a command line program running on Windows and Linux. It provides a way to automate HDR processing, allowing it to be integrated into a larger system or workflow.
A free trial PhotomatixCL can be downloaded from this page.
PhotomatixCL operates in one of two ways:
A command line for processing bracketed photos follows this pattern:
[Processing Options] [Output Options] [Input Files]
[Processing Options] refers to your choice for pre-processing (e.g. merge to HDR, alignment, deghosting, etc.), HDR processing (tone mapping/fusion with a specific preset) and finishing.
The options for HDR processing are supplied using the -x option followed by the XMP preset file containing tone mapping/fusion settings. If multiple XMP files are provided, then multiple output files are produced in the same run.
You can create an XMP preset file using the Photomatix Pro application (you don't need a Photomatix Pro license to save a preset file).
[Output Options] refers to the output path as well as options for the file format. There are two ways to supply the output path:
[Input Files] refers to the path of each of the source photos supplied one after the other.
This means that the input files must be entered at the end of the command line and are not preceded by an option.
The following sample command (run on a Windows OS) aligns and merges to HDR the files Image1.jpg, Image2.jpg and Image3.jpg, and processes them with the preset in the MyPreset.xmp file:
PhotomatixCL -a2 -x "c:\Presets\MyPreset.xmp" -d c:\Images\ResultFolder\ "c:\Images\Image1.jpg" "c:\Images\Image2.jpg" "c:\Images\Image3.jpg"
If PhotomatixCL fails to process the files for some reason, it will return a negative exit code. Sometimes this will be accompanied by an error message, but the exit code is the most reliable way to determine if it succeeded. There are many different internal negative error codes occurring in various situations, but a return of -4 always means that there wasn't enough memory to perform the processing.
|Merge to HDR options|
|-a2||Align the source images with the handheld method|
|-a3||Align the source images with the hand-held method, without perspective correction|
|-a1||Align the source images by correcting shifts prior to combining them|
|-a1n||(or -a2n or -a3n) Align images but do not crop the aligned results|
|-a1s||(or -a2s or -a3s) Align images and save the aligned results|
|-a1ns||(or -a2ns or -a3ns) Align images without cropping the aligned results, and save the aligned results|
|-am||Maximum shift between the images that will be considered when aligning, as a percentage of image width/height - e.g. -am 20 to allow an image to be shifted by 20% of its size with respect to the others|
|-g||Attempt to reduce ghosting artifacts: -gn for normal detection, -gh for high detection, -g num for custom ghost reduction strength, where num is between 0 and 100|
|-ca||Reduce Chromatic Aberrations|
|-no||Reduce Noise: -no0 to reduce noise in underexposed photos, -no1 for normal and underexposed photos, -no2 for all photos, -no9 for merged image noise reduction|
|-nr||Noise reduction strength for -n0, -n1 and -n2 options - e.g. -ns 100 (valid values vary between 50 and 150)|
|-wb||Color temperature for RAW conversion when source images are RAW files, e.g. -wb 7500|
|-tr||Consider files with the .tif extension coming from the Canon 1Ds and Phase One P45 as RAW files|
|-e||EV spacing for merging to HDR when exposure information not found on source files, e.g. -e 2.0 for images with a two EV difference between them.|
|-cu||Tonal curve for HDR generation. Options are -cu 0 for tonal curve of ICC profiles of source images (default), -cu 1 to attempt to recover tone curve applied|
Name of Photomatix preset XMP file to use for processing images - e.g. -x mypreset.xmpYou can also process with multiple presets by using multiple -x options, e.g. -x mypreset1.xmp -x mypreset2.xmp
|-sa||Sharpening Amount, e.g. -sa 50 (valid values are between 0 and 150)|
|-sr||Sharpening Radius (only works if -sa is greater than 0), e.g. -sr 0.9 (valid values are between 0.5 and 3)|
|-st||Sharpening Threshold (only works if -sa is greater than 0), e.g. -st 2 (valid values vary between 0 and 20)|
|-ch||Contrast adjustment for highlights, e.g. -ch 10 (valid values are between 0 and 100)|
|-cl||Contrast adjustment for lights, e.g. -cl 10 (valid values are between 0 and 100)|
|-cd||Contrast adjustment for darks, e.g. -cd -10 (valid values are between 0 and -100)|
|-cs||Contrast adjustment for shadows, e.g. -cs -10 (valid values are between 0 and -100)|
|Output / Saving Options|
|-o||Name of the resulting image (without the extension)|
|-d||Destination path for the resulting image, including the last "\" character if applicable. E.g. -d C:\images\|
|-n||Naming options for the resulting images. Options are -n 0 for output name starting with name of first image in the set (default), -n 1 for name starting with set number, -n 2 for shortened version starting with set number, -n 3 for name ending with set number and -n 4 for shortened version ending with set number. In the case of 1, 2, 3 or 4 set number has to be given with argument -q, e.g. -q 3|
|-ns||Naming options for the output images (same as above) with appended suffix. E.g. -ns 0 trial1.|
String that refers to the preset XMP file (used to process the image with the option -x) in the filename of the output image. This option requires using the -x option listed in the Setting Options section. E.g. -x mypreset1.xmp -xn "My Preset 1".
|-s||Save output image in a format different from the one of the source images. Options are: -s tif or -s jpg|
|-j||Jpeg quality for output image saved in the JPEG format, e.g. -j 90 (default is 100)|
|-bi||Bit-depth of output image when saving as TIFF: -bi 8 for 8 bits/channel, -bi 16 for 16/bits channel|
|-k||Tag saved files with this keyword|
|-rs||Width and height of the output image, e.g. -rs 1024 768 to resize the image to 1024x768. This option requires that the new width and height are smaller than the original image's ones.|
|-p||Create output image as a 360 degree panorama suitable to be viewed in a panorama viewer - useful for methods Details Enhancer and Fusion/Natural only.|
|-h||HDR saving options: -h "exr" will save the HDR image in the OpenEXR format, -h "remove" will remove the HDR image after having tone mapped it.|
|-co||Output color space when source images are RAW files. Options are -co 0 for sRGB, -co 1 for AdobeRGB (default), -co 2 for ProPhotoRGB|
|-mp||Specify maximum number of cores / CPUs to use when processing images - e.g. -mp 4 to use up to 4 CPUs. Default is 1.|
|-mh||Merge image to HDR strip by strip instead of loading the whole source files in memory. Requires option -3 and TIFF files as source. Alignment and ghosting reducing options will be disabled|
|-md||Use scratch disk option for Details Enhancer and Fusion/Natural methods (reduces needed memory by a factor of 3). This option is automatically enabled if -mh option is used.|
|-sd||Scratch directory to use for the temporary files when required (without this option the standard temp directory will be used), e.g. -sd E:\temp|
|-ll||Load license key: -ll license key|
|-lq||Print number of sets remaining|
|Legacy / Compatibility Options|
|-0||Combine the source images with Average|
|-1||Combine the source images with Fusion/Auto|
|-2||Combine the source images with Fusion/Natural|
|-2a||Accentuation for method "Natural" e.g. -2a 0.5 (valid values are between -10 and 10)|
|-2b||Blending Point for method "Natural" e.g. -2b 0.5 (valid values are between -10 and 10)|
|-2c||Color Saturation for method "Natural" e.g. -2c 0.5 (valid values are between -10 and 10)|
|-2h||Sharpness for method "Natural" e.g. -2h 0.5 (valid values are between 0 and 10)|
|-2k||Black Point for method "Natural" e.g. -2k 0.5 (valid values are between 0 and 10)|
|-2m||Midtone for method "Natural" e.g. -2m 0.5 (valid values are between -10 and 10)|
|-2s||Shadows for method "Natural" e.g. -2s 0.5 (valid values are between -10 and 10)|
|-2w||White Point for method "Natural" e.g. -2w 0.5 (valid values are between 0 and 10)|
|-4||Combine the source images with Fusion/Intensive|
|-4c||Color Saturation for method "Intensive" e.g. -4c 0.5 (valid values are between -10 and 10)|
|-4r||Radius for method "Intensive" e.g. -4r 30 (valid values are between 10 and 70)|
|-4s||Strength for method "Intensive" e.g. -4s 0.5 (valid values are between -10 and 10)|
|-5||Combine the source images with Fusion/Realistic|
|-5a||Strength for method "Realistic" e.g. -2a 0.5 (valid values are between -10 and 10)|
|-5c||Color Saturation for method "Realistic" e.g. -2c 0.5 (valid values are between -10 and 10)|
|-5h||Sharpness for method "Realistic" e.g. -2h 0.5 (valid values are between 0 and 10)|
|-3||Merge the source images into an HDR image (by default saved in Radiance ".hdr" format)|
|-t1||Tone map HDR image with "Details Enhancer"|
|-t2||Tone map HDR image with "Tone Compressor"|
|-x1||Settings file in XMP format for tone mapping method "Details Enhancer", .e.g. -x1 EnhancerSettings.xmp|
|-x2||Settings file in XMP format for tone mapping method "Tone Compressor", .e.g. -x2 CompressorSettings.xmp|