The kernel program Cosima is a command line program, which is started with
an inifile including all parameters. There are several different possibilities to start Cosima:
- Using the graphical user interface Cosima Gui:
The easiest way to start Cosima is from the user interface
Cosima Gui. The user interface allows a comfortable
setting of all the parameter values and the administration of many parameter inifiles. You will find more
help for the Gui here.
- Double clicking an inifile:
After you have bound the ending *.ini to cosima_gui.exe (mark any inifile -
right mouse button - Open with ... - Choose standard program - check Cosima Gui, tick "Always ..." - OK)
the Cosima Gui will open, if you double click an inifile and this inifile will be loaded.
- Inifile send to ... Cosima Gui
Mark Inifile - right mouse button - Senden to ... - Cosima Gui will open a new instance of the
Cosima Gui and loads the inifile. Inifiles may be also loaded into an already opened
Cosima Gui per drag-and-drop.
- Inifile send to ... Cosima:
Inifiles can also be sended directly to Cosima:
Mark inifile - right mouse button - Send to ... - Cosima. This will start Cosima
at once without using the Cosima Gui.
- Images send to ... Cosima Gui:
Mark one or two images - right mouse button - Send to ... - Cosima Gui
will start the GUI and will also set the parameters LeftFileName, RightFileName
respectively StereoFileName and InputMode = 0.
- Images send to ... Cosima:
Mark one or two images - right mouse button - Send to ... - Cosima will start
at once the correction process of the image or the image pair.
- Directory send to ... Cosima:
Mark a directory - right mouse button - Send to ... - Cosima will start
to process the whole directory. You will be asked, whether the directory
contains mono images (ordering L-R-L-R etc.) or stereoimages.
The use of batch files is recommended not only for advanced users!
With the help of batch files, a number of Cosima runs can be started automatically.
For that, create at first a batchfile with the ending *.bat and write one command line for each Cosima call.
The syntax for one Cosima call is:
C:\Cosima\Cosima.exe <inidatei> /<parameter>=<value>.
With <inidatei> is the inifile used for all Cosima runs
(you have to create it before with the GUI) and
will set a specific parameter to a specific parameter value. To identify the parameter,
must applied here.
Assuming, you want to compare all 6 possible anaglyph methods at the same time. At first, create an inifile
anaglyph.ini containing all your wanted parameter settings.
Then, create a batch file, e.g. use the name anaglyph.bat for that,
and write the following lines into it:
C:\Cosima\Cosima.exe anaglyph.ini /EG=3 /AT=0 /ID=_0
C:\Cosima\Cosima.exe anaglyph.ini /EG=4 /AT=1 /ID=_1
C:\Cosima\Cosima.exe anaglyph.ini /EG=4 /AT=2 /ID=_2
C:\Cosima\Cosima.exe anaglyph.ini /EG=4 /AT=3 /ID=_3
C:\Cosima\Cosima.exe anaglyph.ini /EG=4 /AT=4 /ID=_4
C:\Cosima\Cosima.exe anaglyph.ini /EG=4 /AT=5 /ID=_5
In that example, three parameters are given additionally:
AnaglyphType (AT) and
The values given here will overrule the values given in the inifile, the values in the inifile doesn't care!
Finally, the job will be started with a double click on the file anaglyph.bat.
- EstimateGeometry is set = 3 in the first run, elsewhere it is set = 4.
So, the geometric image errors will be estimated and stored only in the first run and will be re-used
for the other runs.
- AnaglyphType get all 6x values from 0 to 5.
- IdentOutputDir is set to avoid overwriting the resulting images at every run.
In this example, the images from the 6 runs will be stored into 6 different subdirectories.