DER START VON COSIMA
STARTING COSIMA

Querverweis zur Parameter Hilfe // Quicklink to the parameter help: parameters.html

Das Kernprogramm Cosima.exe ist ein Konsolenprogramm, dem beim Start eine Ini-Datei mit allen Parameterwerten übergeben wird. Es gibt grundsätzlich drei verschiedene Möglichkeiten für den Start von Cosima: The kernel program Cosima.exe is a command line program with the option to add an inifile including all parameter values. In principal, there are three different possibilities to start Cosima:
1. Graphische Benutzeroberfläche: Am einfachsten wird das Kernprogramm Cosima aus der Benutzeroberfläche Cosima Gui gestartet. Die graphische Oberfläche erlaubt das einfache Setzen der Parameter und das Verwalten einer Vielzahl von Parameterdateien. Weitere Hilfe zur Bedienung der Oberfläche findet sich hier. 1. Graphical User Interface: The easiest way to start the Cosima kernel is from the user interface Cosima Gui. The user interface allows an easy setting of all the parameters and the administration of many parameter inifiles. You will find more help for the Gui here.
2. Senden an: Bei der Installation von Cosima werden 3 Einträge in das kontextsensitive "Senden an"-Menü des Dateimanagers angeboten: "Senden an Cosima", "Senden an Cosima_nice" und "Senden an Cosima Gui". Folgende Varianten sind hierbei möglich:
  • Inidatei senden an Cosima Gui: Inidatei markieren, rechte Maustaste drücken und mit der linken Maustaste auf den gewünschten Menüeintrag klicken. Die Oberfläche startet und lädt die ausgewählte Inidatei.
  • Linkes und rechtes Einzelbild senden an Cosima Gui: Beide Bilder markieren und an Cosima Gui senden. Die Oberfläche startet und lädt die beiden ausgwählten Bilder als linkes und rechtes Einzelbild. Die Parameter LeftFileName, RightFileName und PathofImages werden automatisch gesetzt.
  • Inidatei senden an Cosima oder Cosima_nice: Cosima startet sofort ohne graphischer Benutzeroberfläche und verwendet die in der Inidatei eingetragenen Parameterwerte. Cosima_nice arbeitet als Hintergrundprozess mit reduzierter CPU Priorität.
  • Linkes und rechtes Einzelbild senden an Cosima oder Cosima_nice: Cosima startet sofort ohne graphischer Benutzeroberfläche und bearbeitet die beiden ausgewählten Bilder. Ansonsten werden die Parameter der Datei cosima.ini verwendet (sollte also vorhanden sein). Cosima_nice arbeitet als Hintergrundprozess mit reduzierter CPU Priorität.
(Eine Anleitung zum manuellen Setzen eines "Senden an"-Eintrags gibt es hier.) 		2. Send to: During the Cosima installation, three entries are offered concerning the right mouse button "Send to"-menue of the file manager: "Send to Cosima", "Send to Cosima_nice" and "Send to Cosima Gui". They work as follows:
  • Inifile send to Cosima Gui: Mark inifile, click right mouse button, go to the wanted send to menu entry and make there a left click. The Gui starts and loads the wanted inifile.
  • Left and right single images send to Cosima Gui: Mark both images and send them to Cosima Gui. The Gui starts and loads the two marked images as a left and a right single input image. The parameters LeftFileName, RightFileName and PathofImages will be set automatically.
  • Inifile send to Cosima or Cosima_nice: Cosima will start at once without a graphical user interface and uses the parameter values from the inifile. Cosima_nice runs as a background process with reduced CPU priority.
  • Left and right single images send to Cosima oder Cosima_nice: Cosima starts at once without a graphical user interface and processes the marked images. The other parameters are read from the inifile cosima.ini (must be existend). Cosima_nice runs as a background process with reduced CPU priority.
(You will find instructions for the manually setting the send to entries here!)
3. Kommandozeile oder Batchdatei: Beim Aufruf von Cosima in einer Kommandozeile oder in einer Batchdatei können sowohl Inidateien als auch einzelne Parameter übergeben werden. Dies ermöglicht, viele Cosimaläufe mit leicht unterschiedlichen Parameterwerten einmalig zu starten. 3. Command line or batchfile: While calling Cosima from the command line or from a batchfile, you can pass whole inifiles or overwrite single parameter values. That allows you to run a whole batch of Cosima tasks with only one single start.
Aufrufregel: cosima.exe [inputfile[s]] [inifile] [options]

Angaben in eckigen Klammern sind optional!
 Command rule: cosima.exe [inputfile[s]] [inifile] [options]

The inputs between the brackets are optional!
[inputfile[s]]:
    <linkes Halbbild> <rechtes Halbbild>
    oder: <Stereobild>
    Ohne Vorgabe von [inputfile[s]] werden die entsprechenden Einträge von [inifile] ausgewertet.

 [inputfile[s]]:
    <left image> <right image>
    or: <stereoimage>
    Without given [inputfile[s]], the content of the [inifile] will be evaluated.
[inifile]:
    Datei mit Parameterwerten.
    Ohne Vorgabe von [inifile] wird cosima.ini als Parameterdatei verwendet. Die Endung "ini" ist obligatorisch und muß angegeben werden.

 [inifile]:
    File with parameter values.
    Without given [inifile], cosima.ini will be used as parameter file. The ending "ini" is a must and is always to be included.
[options]:
    Alle Einträge der Parameterdatei können einzeln durch die [options] überschrieben werden. Options haben das Format: /Parameterkürzel=Wert. Die Parameterkürzel sind in der Parametertabelle und bei der Beschreibung der einzelenen Parameter angegeben.
    /h: Lädt die Datei parameters.html in den Standardbrowser.

 [options]:
    Each of the settings of the parameterfile can be overwritten by the [options]. Options always have the format: /short_form=value. The short forms of the parameters are listed in the parameter table and are also given in the specifications.
    /h: Loads the file parameters.html into your standard browser.
Beispiele:

 Examples:
Beispiel 1: c:\cosima\cosima.exe
    Das Programm cosima.exe im Verzeichnis c:\cosima wird gestartet. Cosima verwendet die Parameterdatei cosima.ini und bearbeitet die dort angegebenen Bilddateien. (Gleiches Verhalten wie ein Doppelklick auf cosima.exe.)
 Example 1: c:\cosima\cosima.exe
    That starts the program cosima.exe from the directory c:\cosima. Cosima uses the inifile cosima.ini and operates on the image files given there. (The same behaviour as a double click on cosima.exe.)
Beispiel 2: c:\cosima\cosima.exe /VM=2
    Cosima verwendet die Parameterdatei cosima.ini, bearbeitet die dort spezifizierten Bilddateien, setzt aber den Parameter VerboseMode auf den Wert 2.
 Example 2: c:\cosima\cosima.exe /VM=2
    Cosima uses the inifile cosima.ini, operates on the image files given there and sets VerboseMode equal 2.
Beispiel 3: c:\cosima\cosima.exe mystereoimage.bmp mypara.ini
    Cosima bearbeitet das Bild mystereoimage.bmp und verwendet die Parameterdatei mypara.ini. (Dort sollte natürlich StereoImageInput = 1 angegeben sein, sonst gibt es eine Fehlermeldung...)
Example 3: c:\cosima\cosima.exe mystereoimage.bmp mypara.ini
    Cosima operates on the image mystereoimage.bmp and uses the parameter file mypara.ini. (There it should be set: StereoImageInput = 1, otherweise an error message will occur...)
Beispiel 4: c:\cosima\cosima.exe links.bmp rechts.bmp /OV=1
    Cosima bearbeitet die Bilder links.bmp und rechts.bmp, verwendet die Parameterdatei cosima.ini und aktiviert den PostViewer zum interaktiven Setzen des Scheinfensters.
Example 4: c:\cosima\cosima.exe left.bmp right.bmp /OV=1
    Cosima operates on the image files left.bmp and right.bmp, uses the parameter file cosima.ini und activates the PostViewer for an interactive setting of the stereo window.
Beispiel 5: cosima /h
    Lädt die Datei parameters.html in den Standardbrowser.
 Example 5: cosima /h
    Loads the file parameters.html into your standard browser.
Beispiel 6: Batchdatei
    Angennommen, Sie wollen alle 6 Anaglyphenverfahren gleichzeitig ausprobieren. Stellen Sie zunächst alle gewünschten Parameter in einer Inidatei, beispielweise mit dem Namen myanaglyph.ini, zusammen. Erzeugen Sie nun eine BatchDatei mit der Endung ".bat", aber sonst beliebigen Namen. Schreiben Sie folgende Zeilen in diese Batchdatei:
     c:\cosima\cosima.exe myinifile.ini /EG=3 /AT=0 /ID=_0
    
 c:\cosima\cosima.exe myinifile.ini /EG=4 /AT=1 /ID=_1
    
 c:\cosima\cosima.exe myinifile.ini /EG=4 /AT=2 /ID=_2
    
 c:\cosima\cosima.exe myinifile.ini /EG=4 /AT=3 /ID=_3
    
 c:\cosima\cosima.exe myinifile.ini /EG=4 /AT=4 /ID=_4
    
 c:\cosima\cosima.exe myinifile.ini /EG=4 /AT=5 /ID=_5
    Nur beim ersten Lauf werden die Korrekturwerte berechnet (EG=3), ansonsten werden sie wiederverwendet (EG=4). Jeder Lauf erzeugt ein Anaglyphenbild mit anderer Anaglyphenmethode (AT=0 bis AT=5). Damit sich die Ergebnisbilder nicht alle überschreiben, werden die Ausgabeverzeichnisse individuell gekennzeichnet (ID=_0 bis ID=_5). Starten Sie die Batchdatei durch Doppelklick.
Beispiel 6: Batchfile
    Assumed, you want to try-out all 6 anaglyph types at the same time. At first, set up your wanted parameters into one individual inifile, say with the naming myanaglyph.ini. Create a batchfile with the ending ".bat", but arbitrary name. Write the following lines into that batchfile:
     c:\cosima\cosima.exe myinifile.ini /EG=3 /AT=0 /ID=_0
    
 c:\cosima\cosima.exe myinifile.ini /EG=4 /AT=1 /ID=_1
    
 c:\cosima\cosima.exe myinifile.ini /EG=4 /AT=2 /ID=_2
    
 c:\cosima\cosima.exe myinifile.ini /EG=4 /AT=3 /ID=_3
    
 c:\cosima\cosima.exe myinifile.ini /EG=4 /AT=4 /ID=_4
    
 c:\cosima\cosima.exe myinifile.ini /EG=4 /AT=5 /ID=_5
    The correction values will be estimated only with the first run (EG=3), otherwise, they will be reused (EG=4). Each run creates an anaglyph image with another anaglyph methode (AT=0 to AT=5). To prevent the overwriting of already existing results, all output directories are individually named (ID=_0 to ID=_5). Start the batchfile with a doubble click.
Tips:

 Hints:
Ein Start von Cosima ohne weitere Angaben entspricht einem Doppelklick auf cosima.exe im Filemanager. Tip: Den Filemanager Idoswin Free verwenden! Mit Ctrl-D öffnet sich automatisch eine Eingabeaufforderung im aktuellen Verzeichnis. Von dort aus kann man Cosima leicht entsprechend seinen Bedürfnissen starten.
 Starting Cosima without further entries on the command line corresponds to a double click using a file manager. Tip: Use the filemanager Idoswin Free! With Ctrl-D a command window opens automatically using the actual directory. There you can easily start Cosima according to your needs.
Wenn anstatt der Datei cosima.exe die Datei cosima_nice.exe gestartet wird, werkelt Cosima im Hintergrund mit niedrigster Priorität, ohne dabei andere Arbeiten am Computer zu blockieren. If cosima_nice.exe is started instead of the file cosima.exe, Cosima crunches in the background with the lowest priority, without blocking other work on the computer.



© Gerhard P. Herbig, Januar 2010,     back to cosima homepage