mec User Guide

Descriptions - mec.exe

mec.exe uses a Multiple Exposure Combining (MEC) algorithm to combine raw video files representing multiple exposures of the same scene into a single output video file.

Command line parameters

Usage: mec <raw-video-t1> <raw-video-t2> { <raw-video-t3> { <raw-video-t4> } } <output-file>

Options:
-ini <ini-file>
Ini file to use for setting the software colorpipe options.
If not specified then the _info.txt file for t1 is used.

-preset <ini-file-preset>
Preset name to use for setting the software colorpipe options.
If not specified then 'ColorPipe State' is used.

-algo <algorithm>
Override the choice of MEC algorithm. Choices are dlo, ese, suo, nid, sup, sud, and lim.
'lim' means to only stitch the input files together, simulating sensor Line-Interleaved Mode, and not do MEC.

-xsdat <sensor-xsdat-file>
The colorpipe needs a sensor data file (.xsdat) for creating the image processing context.
Normally the file path is automatically taken from the _info.txt file of t1, but an xsdat file
can be specified if necessary.

-quiet
No progress output.

<output-file> The output file can also be .wmv, .avi, or .mp4, in which case the full color processing is done, not just MEC.

Notes:

The t1, t2, t3, and t4 files should all be .raw files, and have the same dimensions and bit depth.
The t3 and t4 files are optional. All input files need corresponding _info.txt files (as created by DevWareX).
The output file extension should be .raw, .wmv, .avi or .mp4. If the output file is .raw then the input images will be combined by the MEC algorithm, but get no further processing. A .raw output file will not be bit-packed.
Otherwise the combined image will get the full DevWareX software colorpipe processing.

The MEC algorithm and color processing parameters will be taken from the t1 _info.txt file by default, but a separate ini file for colorpipe initializations can be specified if needed.
Additionally, the choice of MEC algorithm can be specified on the command line, and that will take precedence over the ini file.

Usage Examples:

mec video_t1.raw video_t2.raw video_mec.raw

The output file can also be .wmv, .avi, or .mp4, in which case the full color processing is done, not just MEC.

mec video_t1.raw video_t2.raw video_mec.wmv

By default it will do MEC using the algorithm specified in the t1 _info.txt file STATE=MEC Mode. You can override the combining algorithm on the command line with -algo, for example:

mec video_t1.raw video_t2.raw video_ese.raw -algo ese

To only stitch files together without MEC, specify lim as the algorithm, for example:

mec video_t1.raw video_t2.raw video_lim.raw -algo lim

It can handle up to four exposures. By default it will use the colorpipe STATE settings from the t1 _info.txt file. You can
override that with -ini and -preset options, for example:

mec video_t1.raw video_t2.raw video_mec.raw -ini combining.ini -preset "MEC Settings"

Exposure Ratio Info

Also verify the exposure ratios in the t1 info.txt file. Or use -ini and -preset to specify a preset with the correct ratios and MEC options. For two exposures, the STATE settings are:

STATE= Ratio T1_T2, 8
STATE= Actual Ratio T1_T2, 7.8388
STATE= MEC Mode, 0
STATE= MEC Clip 1, 3500
STATE= MEC Clip 2, 3500
STATE= MEC T1_S3, 2500
STATE= MEC T1_S4, 3500
STATE= MEC T2_S1, 64
STATE= MEC T2_S2, 128
STATE= MEC Motion Q1, 20
STATE= MEC Motion Q2, 20
STATE= MEC Motion Q3, 1
STATE= MEC Noise Width, 3500
STATE= MEC NIDLO Noise Level, 10
STATE= MEC SUPER Noise Barrier, 3500

.