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.ini. For further details please see below.
The main window ⇧
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 actual 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 actual 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.
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.ini 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 actual inifile file.
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.ini 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.ini 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 usinf AviSynth.
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.
Reset all: Sets all parameters to their default values.
Plausibility check: Checks the actual parameter set of consistency.
Menu "Start" ⇧
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 actual 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.
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.
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 actual version number.
Design of the configuration file cosima_config.ini ⇧
Section [General]
[General] LoadAtStart = .\cosima.ini IgnorePathofImages = 0 TellNonDefault = 0 MissingUseDefault = 1 ShowFullPath = 0 AskOnExit = 1 BreakRecovery = 0 UseTabs = 1 StaggeredWindows = 1 CPU_Priority = 0 SetInputModewithPath = 0 CopyInitoPathofImage = 0 ColorNonDefaultPara = 1LoadAtStart: When starting Cosima GUI, the program will be initialized with the parameter values of the inifile named here. Moreover, Cosima stores the actual 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 actual parameter settings should be stored or not.
The variable BreakRecovery is used for remembering, whether a Cosima run has been interrupted or not.
With UseTabs = 1, all parameters are grouped with one common parameter window. This window is separated into subgroups with tabs. With UseTabs = 0, the sub groups will be shown with individual windows.
With StaggeredWindows = 1, all individual subgroup windows are placed diagonally, without it the will be opened at the same place.
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 actual 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.
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.