COSIMA GUI: A Help for Setting the Cosima Parameters
Working flow
Using the Cosima Gui, you can load existing inifiles, change their parameters and store the changed inifiles back to disk. The Cosima Gui supports the starting of Cosima with normal and reduced processor priority, and the load of both processor kernels with dual core processor system.
If you start the Cosima Gui the first time, the inifile cosima.ini is searched and loaded automatically. Later, the last active inifile will be loaded, if it could be 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 - Quick Start - Plausibility check - Show file list - Launch Cosima with normal priority - Launch Cosima with reduced priority - Cosima Gui help - Clear message window - Interrupt and recover a Cosima run.
Then you can find four message lines, saying, which inifile has been loaded at last, the value of the actual setting of the path of images and which images are just be mounted (if Cosima has been started). On the right hand side there are two thumbs showing the left and the right image under operation.
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.txt using the notepad editor.
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" ⇧
All the 85 different Cosima parameters are, spread over 10 different windows, adjustable with individual control elements. All mutual dependencies are considered using automatic activating and deactivating mechanisms as well as a lot of tool tips.
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 raizing tool textes.
Stereocard Configuration Wizard: Calculation help for printing stereo cards.
Anaglyph Calibration Wizard: Wizard for ghostfree anaglyph prints.
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 correted, if Cosima would be launched. The list is just the content of the file cosima_files.txt.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 one normal job.
Run dual job: From the actual parameter settings, an inifile cosima_gui.ini is build and cosima.exe is launched two times, once with FilterImageNames = 1 and once with FilterImageNames = 2.
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/Recover: Deletes all information concerning Löscht alle gespeicherten Information eines unterbrochenen Cosimalaufes.
Standby: A tickmark will standby the computer after Cosima has been finished.
Hibernate: A tickmark will hibernate the computer after Cosima has been finished.
Shutdown: A tickmark 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.herbig-3d.de/cosima/ 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 = 1 TellNonDefault = 0 MissingUseDefault = 1 ShowFullPath = 0 AskOnExit = 1 BreakRecovery = 0 UseTabs = 1 StaggeredWindows = 1 CPU_Priority = 0LoadAtStart: 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. Default is 0.
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.
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).
Section [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.
© Gerhard P. Herbig, November 2009, back to cosima homepage