Cosima Gui: A graphical user interface for setting the Cosima Parameters

The Cosima Gui is a graphical user interface for administer and setting the Cosima Parameters. Using the Cosima Gui, you can load existing inifiles, change their parameters and store the changed inifiles back to disk. Furthermore, the Cosima Gui is used for starting of the kernelprogram Cosima.

If you start the Cosima Gui the first time, the inifile cosima.ini is searched and loaded automatically. After that, the lastly used inifile will be loaded (if it is found). Missing parameters are replaced by their default values. After loading, an internal plausibility check is launched and the result is shown in a message window.

From the menu User Defined, you can load individually assembled subsets of parameters. These subsets, the parameters and their values are definied within the file cosima_config.txt. For further details please see below.

The main window

Mainwindow of Cosima Gui

Below of the menues, there are 13 buttons provided for the most often used functions: Load inifile - Save inifile - Select PathofImages - Choose left/right image - Choose stereo image - Open Parameter tabs - Quick start - Plausibility check - Show file list - Launch Cosima - Cosima Gui help - Clear message window - Interrupt and recover a Cosima run.

Below the buttons, you can find four message lines, telling, which inifile has been loaded lastly, the value of the current setting of the path of images and which images are just be mounted (after Cosima has been started). Below there are two thumbs showing the left and the right image under operation. Thumbnails of the original images are displayed during the correction phase with a red border and thumbnails of the resulting images during the period of storing with green borders.

In the large message window, the most important actions of the Cosima Gui will be protokolled.

The status line provides some explanations for the menu entries.

Menu "File"

Load settings (load inifile) ...: Loads an inifile, replaces missing parameters with their default values and launches the plausibility check.
Save settings (save inifile) ...: Stores the current parameters into a new inifile.
Select left/right image ...: Overwrites the parameters LeftFileName and RightFileName and sets the parameter InputMode = 0.
Select stereo image ...: Overwrites the parameter StereoFileName and sets the parameter InputMode = 0.
File collector ...: Opens an image collector to mark a selection of images out of a right subfolder. The left partners are searched automatically.
Open ListofImages with Editor ...: Opens the list of images with the notepad editor, so you can individually change this list (will be processed with InputMode = 10).
Select PathofImages: Opens a path dialog to set the parameter PathofImages.
Open PathofImages with Explorer ...: Opens the path PathofImages into an external Windows-Explorer window.
Show last report: That will open the last report file cosima_report.html using the Internet Explorer.
Edit configuration file ...: Notepad will be launched and the file cosima_config.txt loaded for editing. For further details please see below. After closing notepad, all changes are active immediately.
Options...: An entry mask will be opened to set the most important configuration settings for the GUI also with a graphical tool.
Exit: Terminates the Cosima Gui with the option to store all changes into the current inifile.

Menu "Language"

English: Switches to English language and changes all texts.
German: Switches to German language and changes all texts.

Menu "User Defined"

The user may edit the file cosima_config.txt and can define up to 30 different parameter subsets with corresponding description names. Thses names are used for the submenu entries. With activating the sub menues, only the given subset of parameters will be overwritten, all other parameters remain unchanged. For further details of the file cosima_config.txt please see below. Only the explicitely setted parameters are overwriten, all other parameters remain unchanged.

Menu "Parameter"

Quick Start...: Opens a window to set the most important input and output parameters.
Parameter Tabs: With the default value UseTabs = 1 all Cosima parmeters will be listet with individual control elements in only one common configuration window, separated by some tabs. With UseTabs = 0, there are 10 different entry windows, each for every group. All mutual dependencies are considered by activating and deactivating mechanisms and by raising tool textes.
Stereocard Configuration Wizard: Calculation help for printing stereo cards.
Anaglyph Calibration Wizard: Wizard for ghostfree anaglyph prints.
AviSynth-Scriptgenerator: Automatic creation of suitable AviSynth scrips to open videos using AviSynth.
AviSynth-Scriptgenerator for Video Batch: This will create the AviSynth scripts for a whole directory.
Video Previewer: Starts the Video Previewer to check synchronization as well as cutting and clipping the videos with dynamic masks. The Previewer opens the video specified by the parameters InputMpde and PathofImages.
Make scroll cash in the Video Previewer: In order to scroll also such videos in the Video Previewer, which are NOT scrollable by their nature (eg. MVC), a special scroll cash must be created.
Deshaker Analysis Run: With this menu item, a deshaking analysis logfile is created. For this purpose, appropriate AviSynth Scripts are require, which are previously generated in AviSynth Script Generator.
Reset all for Images: Sets all parameters to their default values.
Reset all for Videos: Sets all parameters to video standard values.
Plausibility Check: Checks the current parameter set of consistency.

Menu "Run"

Show file list: Shows the image files, which are corrected, if Cosima would be launched. The shown list is just the content of the file cosima_files.txt. All automatic pairing using the Exif time is also done with this action.
Low priority: A low processor priority is preset.
Normal priority: A normal processor priority is preset.
Run Cosima: From the current parameter settings, an inifile cosima_gui.ini is build and cosima.exe is launched as a normal job.
Run twopass, complete: Within a first run, only the correction values of all images are evaluated without correcting and storing the images. Then, within the second run, the stereo window can be set interactively image by image. This will reduce the waiting between the display of two images.
Run twopass, only part 1: Will only process the first pass.
Run twopass, only part 2: Will only process the second pass.
Reset Break/Recovery: Deletes all information concerning a breaked Cosima run.
Add to Batch: The current parameter set is added to the batch. This set of parameters can be provided with an identifier. The batch file is called cosima_batch.bat and is located in the Cosima directory. The individual parameter sets are stored as inifiles of the form cosima_yyyy.mm.dd_hh.mm.ss.ini.
Edit/show Batch: The batch is opened with the notepad editor and can be edited. The identifiers are inserted as 'REM'-comment lines before the command lines.
Delete Batch: The batch and all associated inifiles are deleted.
Run Batch: The batch is executed. After each execution of a task, the batch will be automatically reduced. The execution of the batch can also be done by double-clicking on the file cosima_batch.dat.
Standby: A tickmark here will standby the computer after Cosima has been finished.
Hibernate: A tickmark here will hibernate the computer after Cosima has been finished.
Shutdown: A tickmark here will shutdown the computer after Cosima has been finished.

Menu "Help"

Cosima Gui Help: Opens the local file cosima_gui_de.html into the Internet Explorer.
Parameter Help: Opens the local file parameters.html into the Internet Explorer.
Video Help: Opens the local file video_start_en.html into the Internet Explorer.
Visit Cosima Homepage: Opens the URL http://www.cosima-3d.de into the Internet Explorer.
Searching for Updates ...: Looks at the Cosima homepage for newer versions and offers in case of success automatic download and installation.
Licensing Cosima ...: A hint to license Cosima.
About ...: Prints the current version number.


Design of the configuration file cosima_config.txt

Section [General]

[General]
LoadAtStart          =  .\cosima.ini
IgnorePathofImages   =  0
TellNonDefault       =  0
MissingUseDefault    =  1
ShowFullPath         =  0
AskOnExit            =  1
BreakRecovery        =  0
CPU_Priority         =  0
SetInputModewithPath =  0
CopyInitoPathofImage =  0
ColorNonDefaultPara  =  1
AutoUpdate           =  0
LoadAtStart: When starting Cosima GUI, the program will be initialized with the parameter values of the inifile named here. Moreover, Cosima stores the current inifile name here, when exiting the program.
With setting IgnorePathofImages = 1, the value of the parameter PathofImages will be not overwritten, if you load an inifile.
If TellNonDefault is set to 1, every parameter, which has got another than the default value, is reported when reading an inifile.
If MissingUseDefault is set to 1, missing parameters are allowed in inifiles. In that case, default values are assumed for the missing parameters. That enables very small and clear inifiles.
With ShowFullPath you can decide, whether either the full pathnames (= 1) or only the filenames (= 0) are to be showed in the message lines.
If you set AskOnExit = 1, Cosima will ask on every exit by Alt-F4 (or clicking on [x]), whether the current parameter settings should be stored or not.
The variable BreakRecovery is used for remembering, whether a Cosima run has been interrupted or not.
With the value of CPU_Priority, Cosima Gui will remember any settings of CPU priority.
If you set the parameter PathofImages with the 3.rd button from the toolbar, you may set at the same time the parameter InputMode to the value given here with SetInputModewithPath. (0: deactivated).
If CopyInitoPathofImage = 1, the inifile will be copied to PathofImages with every start of Cosima. The current date and time is stamped into the name of the inifile.
Depending on the value of the parameters, the background of the parameter controls will be colored: With ColorNonDefaultPara = 1 all default values will be set light green, all non-default values light yellow.
If you set AutoUpdate = 1, with every start of Cosima it is checked, if there is an update for your installed Cosima version. In case, an automatic update is offered.

Sections [InputType_RB1/2/3] and [OutputType_RB1/2/3]

[InputType_RB1]
% text entries
labeltext_de       = Links-Rechts getrennt, augenrichtig.
labeltext_en       = Left-right separated (parallel view).
% parameter entries
InputMode          =  9
StereoImageInput   =  2
RotMirInputLeft    =  0
RotMirInputRight   =  0
InverseInput       =  0
ColorLeftRight     =  0

[InputType_RB2]
.
.
.
The sections [InputType_RB1] to [OutputType_RB3] control the settings of the radio buttons in the "Quick Start"- sheet. You can add parameters of your choice and may also include a personalized text (labeltext_en). If you have e.g. beamers with 1400 pixel, you may change the settings of [OutputType_RB2] (default is 1024x768).

Sektion [User Defined Menu - <x>]

[User Defined Menu - 1]
; menu entry text
menu_item_de       = Eingabe - keine Drehung (l/r)
menu_item_en       = Input - Upside upside (l/r)
; parameters
InputMode          =  9
StereoImageInput   =  2
RotMirInputLeft    =  0
RotMirInputRight   =  0
InverseInput       =  0
AutoOutputContrast =  3
ColorLeftRight     =  0

[User Defined Menu - 2]
.
.
.
In the sections [User Defined Menu - 1] to [User Defined Menu - 30] you may define up to 30 different individual sets of parameters, which are loaded with the related sub menu entry of the "User defined"-menu. The names of the sub menu entries are defined with the parameter menu_item_de (German) and menu_item_en (English).

All lines beginning with a ';' are ignored and are seen as comments.