|
PhotomatixCL.exe, the command line version of Photomatix Pro is automatically installed on your computer when you install the Photomatix Pro program on a Windows OS. |
|
The command line options listed below are for PhotomatixCL version 2.0 which is available from Photomatix Pro version 3.0 on. You can download the latest version Photomatix Pro from the download page. PhotomatixCL.exe will be installed under the PhotomatixPro3 application folder (stored by default under the "Program Files" directory) when you install
Photomatix Pro 3. |
|
Note that we also offer a native Linux build of PhotomatixCL to licensed users of Photomatix Pro. If you are interested in it, please contact our support team. |
| Command line arguments |
| -0 | Combination of the source images with Average |
|
| -1 | Combination of the source images with Exposure Fusion method "Auto" |
|
| -2 | Combination of the source images with Exposure Fusion method "Adjust" |
| -2a | Accentuation for method "Adjust" e.g. -2a 5 (valid values between -10 and 10) |
| -2b | Blending Point for method "Adjust" e.g. -2b 5 (valid values between -10 and 10) |
| -2c | Color Saturation for method "Adjust" e.g. -2c 5 (valid values between -10 and 10) |
| -2s | Shadows for method "Adjust" e.g. -2s 5 (valid values between 0 and 10) |
| -2w | White Point for method "Adjust" e.g. -2w 5 (valid values between 0 and 10) |
| -2k | Black Point for method "Adjust" e.g. -2k 5 (valid values between 0 and 10) |
| -2m | Midtone adjustments for method "Adjust" e.g. -2m 5 (valid values between -10 and 10) |
|
| -4 | Combination of the source images with Exposure Fusion method "Intensive" |
| -4s | Strength for method "Intensive" e.g. -4s 5 (valid values between -10 and 10) |
| -4c | Color Saturation for method "Intensive" e.g. -4c 5 (valid values between -10 and 10) |
| -4r | Radius for method "Intensive" e.g. -4r 30 (valid values between 10 and 70) |
|
| -3 | Merge of the source images into an HDR image (by default saved in Radiance ".hdr" format) |
| -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. |
| -e | EV spacing for generating HDR image when exposure information not found on source files, e.g. -e 2.0 for images with a two EVs difference between them. |
| -ca | Reduce Chromatic Aberrations |
| -no | Reduce Noise |
| -g | Attempt to reduce ghosting artifacts: -g 1 pour Moving Objects - setting Normal, -g 2 for Moving Objects - setting High, -g 11 for Background movements - setting Normal, -g 12 for Background movements - setting High |
| -cu | Tonal curve for HDR generation. Options are -cu 0 for tonal curve of ICC profiles of source images (default), -cu 1 for attempting to recover tone curve applied, -cu 1 |
| -wb | Color temperature for RAW conversion when source images are RAW files, e.g. -wb 7500 |
| -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 |
| -mh | Generate HDR image 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 |
|
| -t1 | Tone map HDR image with "Details Enhancer" (requires option -3) |
| -t2 | Tone map HDR image with "Tone Compressor" (requires option -3) |
| -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 |
|
| -a1 | Alignment of the source images with the "By correcting shifts" method |
| -a2 | Alignment of the source images with the "By matching features" method |
| -a1n | (or -a2n) Align images but do not crop the aligned results |
| -a1s | (or -a2s) Align images and save the aligned results |
|
| -bi | Bit-depth of resulting image: -bi 8 for 8 bits/channel, -bi 16 for 16/bits channel |
| -p | Result image is a 360 degree panorama intended to be viewed in a panorama viewer (only applies to Tone Mapping with Details Enhancer and fusion with Adjust, ignored otherwise). |
| -md | Reduce memory needs (only applies to Tone Mapping with Details Enhancer and fusion with Adjust, ignored otherwise). This option is automatically enabled if -mh option is used. |
|
| -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 resulting 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 resulting images (same as above) and appended suffix. E.g. -ns 0 trial1. |
| -o | Name of the resulting image (without the extension) |
| -s | Resulting image saved in a format different from the one of the source images. Options are: -s tif or -s jpg |
| -j | Jpeg quality for resulting image saved in the JPEG format, e.g. -j 90 (default is 100) |
|
| |
|
The source images need to be given as arguments. A combination method is required in addition to the source images. All other arguments are optional. |
For instance, if you just want to average three images (named image1.jpg, image2.jpg and image3.jpg), the command line would simply be:
| |
PhotomatixCL -0 image1.jpg image2.jpg image3.jpg
|
|
If you rather want to merge the three images into HDR and tone map with Details Enhancer (default settings), then the command line would be:
| |
PhotomatixCL -3 -t1 image1.jpg image2.jpg image3.jpg
|
|
If you want to align your images with the "by matching features" method prior to merging, to tone map with custom settings provided in a mySettings.xmp file, to save the tone mapped image as 16-bit TIFF under a file name starting with the name of the first image in the set, then the command line would be:
| |
PhotomatixCL -a2 -3 -t1 -x1 mySettings.xmp -bi 16 -n 0 image1.jpg image2.jpg image3.jpg
|
Note that you can create the mySettings.xmp file using Photomatix Pro in manual mode (via the "Save Settings" item of the Presets combo-box) or in batch processing mode as the batch will by default save the settings in an xmp file located in the folder containing the resulting images. |
If you are only interested in the tone mapped result, you can remove the 32-bit HDR image file after tone mapping by adding "-h remove" as follows:
| |
PhotomatixCL -a2 -3 -h remove -t1 -x1 mySettings.xmp -bi 16 -n 0 image1.jpg image2.jpg image3.jpg
|
|
If you would like to fuse the images with the Adjust exposure fusion method with default settings in addition to merging them to HDR and tone mapping them with Details Enhancer, you just need to add the "-2" command as follows:
| |
PhotomatixCL -a2 -2 -3 -h remove -t1 -x1 mySettings.xmp -bi 16 -n 0 image1.jpg image2.jpg image3.jpg
|
|
