## COSIMA - FUNKTIONSÜBERSICHT / LIST OF FEATURES:

### Inhaltsverzeichnis: Cosima starten Input-Organisation und Input-Formate Fortgeschrittene Input-Optionen Output-Organisation und Output-Formate Rahmen-Optionen Geometrische Bildkorrektur Farbkorrektur Video Funktionen Anaglyphen Diverses Funktionen der GUI Cosima Image PreViewer Cosima Image Postviewer Cosima Video Previewer | ### Content: Starting Cosima Input Organisation and Input Formats Advanced Input Options Output Organisation and Output Formats Framing Options Geomerical Image Correction Color Correction Video Functions Anaglyphs Divers Functions of the GUI Cosima Image Postviewer Cosima Image Postviewer Cosima Video Previewer
### 1. Cosima starten: ⇧ Cosima Gui starten, Parameter setzen und Start-Button drücken. Inidatei (Projekt-Datei) tsenden an Cosima Gui lädt diese Inidatei in die Gui. Inidatei (Projekt-Datei) auf die Gui-Oberfläche ziehen lädt diese Inidatei in die Gui. Ein Bild auf die Gui-Oberfläche ziehen (SBS oder MPO) lädt dieses Bild in die Gui. Zwei getrennte Bilder auf die Gui-Oberfläche ziehen lädt dieses Bildpaar in die Gui. Ein komplettes Verzeichnis markieren und an die Cosima Gui senden lädt nach einer Abfrage die Verzeichnisparameter. Zwei komplette Verzeichnis markieren und an die Cosima Gui senden lädt die Verzeichnisparameter. Komplett 2-sprachig Deutsch und Englisch. Bei jedem Cosima-Lauf wird eine Dateiliste mit allen Korrekturparametern erzeugt. Bei jedem Cosima-Lauf wird eine ausführliche Reportdatei im txt und html-Format angelegt. | ### 1. Starting Cosima: ⇧ Start Cosima Gui , set the parameters and press the start button . Inifile (project file), send-to Cosima Gui will load that inifile into the Gui. Drag 'n drop inifile (project file) onto the Gui surface will load that inifile into the Gui. Drag 'n drop image (SBS or MPO) onto the Gui surface will load that image into the Gui. Drag 'n drop two separate images onto the Gui surface will load this image pair into the Gui. A complete directory, marked and sent-to Cosima will load the directory-parameters after a quiery. Two directories, marked and sent-to Cosima will load the directory-parameters. Completely bi-lingual German and English (so far I can ;-). With every Cosima run, a file list will be created with all correction parameters. With every Cosima run, a detailed reportfile (txt and html) will be created.
### 2. Input-Organisation und Input-Formate: ⇧ Zwei Einzelbilder oder ein fertiges Stereobild (MPO, SBS-H, Anaglyph) in beliebiger Annordnung (jede denkbare Vertauschung, Drehung und Spiegelung). Nativ unter anderem: bmp, tga, jpg, jp2, tif, gif, pbm, png, raw, cr2, xbm, mpo ... mit Datei-Filteroption. Inputgröße bis maximal 16384 x 16384 Pixel je Halbbild. Automatische Paarung der Bilder mit Hilfe der EXIF-Aufnahmezeiten (mit Verwendung des Programms exiftool) in jpg- und tif-Bildern. Hierzu müssen die Einzelkameras nicht synchronisiert sein, Cosima orientiert sich an einem Referenzbildpaar. Verarbeitung kompletter Verzeichnisse, z.B. mit einem Verzeichnis l für alle linken Bilder und einem Verzeichnis r für alle rechten Bilder, bis zu zwei Verzeichnisebenen. Zahlreiche weitere Verzeichnisoptionen, z.B. 'Alle Paare im Verzeichnis', 'Alle Nachbarn', 'Erstes mit Jedem', 'Jedes mit Jedem'. Automatisches Aussortieren von verwaisten Einzelbildern. Automatisches Aussortieren von nicht-korrigierbaren Bildpaaren. | ### 2. Input Organisation and Input Formats: ⇧ Two single images or an already mounted stereo image (MPO, SBS-H, Anaglyph) with arbitrary orientation (every interchangement, rotation and mirroring). Native among others: bmp, tga, jpg, jp2, tif, gif, pbm, png, raw, cr2, xbm, mpo ... with a file filter option. Input size up to 16384 x 16384 pixel maximum for each stereo partial image. Fully-automatic pairing of images using EXIF shooting times (with the help of the program exiftool) with jpg- and tif-images. For that, the two single cameras must not be synchronized, Cosima computes the times relative to a reference image pair. Processing whole directories, e.g. a subdirectory l for all left images and a subdirectory r for all right images, up to two subdirectory levels. Numerous further directory options, e.g. 'All pair in a directory', 'All neighbours', 'First to all', 'All possible pairs'. Fully-automatic sorting-out of orphaned images. Fully-automatic sorting-out of not-correctable image pairs.
### 3. Fortgeschrittene Input-Optionen: ⇧ Mehrere Methoden zur Behandlung von Bildern mit unterschiedlicher Auflösung: Beschneiden, Ergänzen, Skalieren. Mehrere Methoden zur Behandlung von Bildern mit Rahmen: Automatische Erkennung eines beliebig geformten Rahmens mit gegebener Rahmenfarbe, automatische Erkennung eines beliebig geformten Rahmens mit automatischer Erkennung der Rahmenfarben, automatische Erkennung eines rechteckigen Rahmens mit gegebener Rahmenfarbe, automatische Erkennung eines rechteckigen Rahmens mit automatischer Erkennung der Rahmenfarbe (Scannermode), Anwendung eines beliebig vorgegebenen Rahmens aus einer Rahmendatei, Anwendung eines beliebigen rechteckigen Fensterausschnittes. Ausgabe der Rahmeninformation zur Kontrolle in eine Rahmendatei. Mehr Funktionen im Cosima Image Previewer. | ### 3. Advanced Input Options: ⇧ Different methods for processing images with different resolution: cutting, completing, scaling. Different methods for processing images with frames: automatic recognition of arbitrary frames with given frame color, automatic recognition of arbitrary frames with automatic recognition of the frame colors, automatic recognition of rectangular frames with given frame color, automatic recognition of rectangular frames with automatic recognition of the frame colors (scanner mode), appliance of an arbitrary given frame from a framefile, appliance of an arbitrary rectangular image window. Output of the estimated frame values into a framefile for control reasons. More functionality in the Cosima Image Previewer.
### 4. Output-Organisation und Output-Formate: ⇧ Unabhängige Erzeugung von zwei Einzelbildern, einem side-by-side Stereobild, einem Anaglyphenbild und einem weiteren zusätzlichen Format. Zusätzliche Formate sind: horizontal gestaucht (SBS-H), übereinander (TAB), vertikal gestaucht (TAB-H), interlaced, MPO, LRL, LR/RL. Im Ergebnis-Dateinamen kann das Datum und/oder die Deviation eingestempelt werden. Im Ergebnis-Verzeichnis kann ein vorzugebender Text angehängt werden. Explizite Auswahl eines Dateiformtes (jpg, tga, bmp, png, tif-24bit, tif-32bit, tif-48bit), tif und png wahlweise verlustlos komprimiert, jpg immer 4:4:4 ohne Farbensubsampling. Die Schärfungsparameter sind entweder vozugeben oder werden automatisch entsprechend dem Bildskalierungsfaktor gewählt. Vorwählbare Bildbreite und Bildhöhe bis maximal 16384 x 16385 Pixel. Mehrere Beschnittoptionen, unter anderem 'Einpassen in ein vorgegebenes Fenster' oder 'Vorgabe des Höhen/Seitenverhältnisses'. Achtung: Die Bildkorrektur und Beschnitt auf die gewünschte Zielgröße erfolgen gleichzeitig in einem einzigen Bearbeitungsschritt, um bestmögliche Bildqualität zu garantieren! Im Ergebnis jede denkbare Vertauschung, Drehung und Spiegelung. Automatische Wahl der besten Interpolationsmethode abhängig vom Bildskalierungsfaktor. | ### 4. Output Organisation and Output Formats: ⇧ Independant creation of two single left-right images, one side-by-side (SBS) stereo image, an anaglyph image and an additional image with an extra format. Extra formats are: horizontally squeezed (SBS-H), top-and-bottom (TAB) vertically squeezed (TAB-H), interlaced, MPO, LRL, LR/RL. The date and/or the deviation may be stamped into the resulting filename. A given text can be added to the output directory name. Choose of the output file format (jpg, tga, bmp, png, tif-24bit, tif-32bit, tif-48bit), tif and png optionally lossless compressed, jpeg always 4:4:4 coded without color subsampling. Sharpening parameters to be given or automatically selected depending on the image scaling factor. Any given image width and image height up to 16384 x 16384 pixel. Different cutting options, among others 'Fit in a box' or 'Given height/width ratio'. Attention: Image correction and cutting to the wanted image size take place at the same time at only one processing step to guarantee the best posssible image quality! For the result: arbitrary orientation, interchangement, rotation and mirroring. Automatic selection of the best interpolation method depending on the image scaling factor.
### 5. Rahmen-Optionen: ⇧ Anfügen eines Rahmens mit fester Pixelzahl oder Anfüllen des Bildes bis auf eine gewünschte Bildgröße. Individuellen Rahmen Anfügen für 'Oben', 'Unten', 'Links und Rechts' und 'Mitte'. Automatisch schwebendes Scheinfenster. Rahmenfarbe vorgebbar. Zusätzliche dünne schwarze Linien zuwählbar. Stereokarten-Konfigurator mit Vorgabe aller Größen in Millimeter. | ### 5. Framing Options: ⇧ Adding of frames with given pixel values or filling the image up to a given image size. Individual frame sizes for 'top', 'bottom', 'left and right' and 'center'. Automatic floating stereo window. Framecolor according to given RGB parameters. Additional thin black line. Stereocard wizard with setting all values in millimeter.
### 6. Geometrische Bildkorrektur: ⇧ Automatische Berechnung der Korrekturwerte für Höhenversatz, Seitenversatz, Größe, Rotation, vertikale und horizontale Vergenz. Wahlweise Korrektur nur des linken Bildes, nur des rechten Bildes oder beider Bilder (symmetrisch). Die Korrekturwerte werden entweder aus dem Bild berechnet, aus einer Datei gelesen, aus den Exif-Werten des Originalbildes gelesen (nur jpg und tif) oder direkt vorgegeben. Wahlweises Abspeichern der Korrekturwerte im EXIF der Originalbilder (nur jpg und tif). Zusätzliche Berechnung einer 16x16 Deviationsmatrix. Mehrere Optionen zum Setzen des Scheinfensters: Fernpunkt, Nahpunkt, Nahpunkt nur Bildränder, Nahpunkt mit limitierter Fernpunktdisparität. Zusätzliche Verschiebung des Scheinfensters um einen festen vorgebbaren Wert. Schwebende Scheinfenster: Entweder in Kombination mit einer Fernpunktrahmung und Vorhängen "im Bild" - oder in Kombination mit einer Nahpunktrahmung und dem Anfügen von asymmetrischen Rändern. | ### 6. Geomerical Image Correction: Fully-automatic estimation of the correction values for height error, shift error, size, rotation, vertical and horizontal vergence. Correction of only the left image, only the right image or both images symmetrically. The correction values will be either estimated out of the image, or read from a file, or read from the Exif values of the original image (only jpg and tif), or may be given as numbers. The correction values can be stored as EXIF values into the original image (only jpg and tif). Optional evaluation and output of a 16x16 disparity matrix. Different options to set the stereo window: at the far point, at the near point, at the edges of the stereo window, at the near point with limited far-point disparity. Additional stereo window shift by a given value. Floating: Either in combination with a far-point framimg and curtains "in the picture" - or in combination with a near-point framing and the addition of asymmetrical borders.
### 7. Farbkorrektur: ⇧ Mehrere Optionen zur Farbkorrektur: Korrektur nur der Grauwerte oder Korrektur aller Grundfarben. Optionen zur Kontrastnormalisierung. Wahlweise Farbkorrektur nur des linken Bildes, nur des rechten Bildes oder beider Bilder (symmetrisch). Zur Farbkorrektur findet eine adaptive Methode zur entsprechenden Verformung der Histogramme statt. Gammakorrektur zur automatischen Dichtekorrektur, schwach, mittel und stark. Vorkompensation des Übersprechens zwischen den beiden Kanälen zur geisterfreien Projektion selbst bei nicht-idealen Projektionsbedingungen. Farbmanipulation mit Hilfe externer Farbmanagament-Dateien, entweder arithmetisch oder tabellarisch (12 Bit). | ### 7. Color Correction: ⇧ Different options for the color correction: only grey values or individual for all basic colors. Options for normalization the image contrast. Color correction of only the left image, only the right image or both images (symmetrically). Color corrrection is done using very advanced histogram matching methods. Gamma correction for automatic density correction, weak, medium and strong. Precompensation of image crosstalk between the both image channels for ghostfree projection with non-ideal projection conditions. Open color manipulation system with extern color management files, either arithmetic or by tables (12 Bit resolution).
### 8. Video Funktionen: ⇧ Input: Einzelbilder oder Video (links-rechts gerennt, SBS, SBS-H, DualStream, Anaglyph). Output: Einzelbilder oder Avi-Video (links-rechts gerennt, SBS, SBS-H, TAB, TAB-H, DualStream, Anaglyph). Optionales DeInterlacen. Optionales Entwackeln mit der Gunnar Thalin Deshaker Analyse. Rudimentäre Schnittfunktion: Angabe des ersten und letzten Frames und des Frameinkrements (jedes 2.te, 3.te Bild ...). Versatzausgleich für unterschiedliche Verzögerungen im linken und rechten Video (nur ganze Frames). Mehrere Methoden zur geometrischen Bildkorrektur: konstant, gleitender Mittelwert oder linear interpoliert zwischen den Keyframes. Mehrere Methoden zur Scheinfenstermontage: konstant, gleitender Mittelwert oder linear interpoliert zwischen den Keyframes. Deviationsausgleich während einer Zoomfahrt, um das Scheinfenster automatisch anzupassen. Weitere Funktionen zur Synchronisation, zum Schnitt und für Kamerafahrten im Cosima Video Previewer. | ### 8. Video Functions: ⇧ Input: A sequence of images or a video (left-right separated, SBS, SBS-H, DualStream, anaglyph). Output: A sequence of images or an avi video (left-right separated, SBS, SBS-H, TAB, TAB-H, DualStream, anaglyph). Optional Deinterlacing. Optional Deshaking using Gunnar Thalin Deshaker analysys. Basic cutting functionality: Using the first frame number, the last frame number and the frame increment (every 2.nd, 3.rd, ... image). Delay alignment for different delays in left and right video (only whole frames). Different methods for geometric image correction: constant, moving average or linear interpolated inbetween two key frames. Different methods for stereo window setting: constant, moving average or linear interpolated inbetween two key frames. Deviation clearing during a image zooming to keep the stereo window setting. Additional functions for synchronization, cutting and definition of camera movements in the Cosima Video Previewer.
### 9. Anaglyphen: ⇧ Mehrere Methoden zur Erzeugung von Anaglyphen: '2 Fundamentalfarben', 'Halbfarben', 'Vollfarben', 'Optimierter Farbraum', 'Dubois', 'Geisterfreie Monitordarstellung'. Verfahren zur Kalibrierung von Anaglyphendrucken mit dem Ziel, geisterfreie Anaglyphendrucke zu erhalten. Beliebige Farbwahl bei der Methode '2 Fundamentalfarben'; Auswahl mit Farbwähler, z.B rot-blau. rot-grün, rot-cyan, gelb-blau oder was auch immer ... Anpassung der Helligkeit und des Kontrastes des Anaglyphenbildes. Individuelle Gammkorrektur für den roten und den grün/blauen Kanal. Anpassung aller Anaglyphenparameter in Echtzeit mit voller Kontrolle des Ergebnisses (Monitordarstelung). | ### 9. Anaglyphs: ⇧ Different methods to create anaglyphs: '2 fundamental colors', 'half colors', 'full colors', 'otimized color space', 'according to Dubois', 'for ghostfree monitor display'. Procedure for the calibration of anaglyph prints with the aim of obtaining ghost-free anaglyph prints. Arbitrary color selection with method '2 fundamental colors'; the selection uses color rulers to yield red-blue, red-green, red-cyan, yellow-blue or any other color combination ... Adjustment of the density and the contrast of the anaglyph image. Individual gamma correction for the red and the green/blue channel. Adjustment of all anaglyph parameters in real time with full control of the result (monitor display).
### 10. Diverses: ⇧ Optionale Aktivierung des Cosima Image PreViewers zum manuellen Ausschneiden und zur individuellen Rotation des Inputbildes. Optionale Aktivierung des Cosima Image PostViewers zum gemeinsamen manuellen Ausschneiden und manuellen Setzen des Scheinfensters. Übertragung der EXIF-, IPTC-, XMP- und ICC-Informationen aus dem Originalbild in das Ergebnisbild. Explizite Wahl der DPI-Werte in den Ergebnisbildern für einen pixelgenauen Ausdruck. Mehrere Optionen zum Schreiben eines Textes unter das Bild: 'beliebiger Text', 'Text aus dem EXIF-Heading', 'Dateiname', 'Verzeichnisname', 'Datum' oder 'Verzeichnisname plus Bildzähler' (der Verzeichnisname muß in diesem Fall eine Zahl sein). Beliebige Größe und beliebiger Font. Gleiche Optionen wie oben zum Schreiben eines Textes in die rechte untere Bildhälfte. Copyright Eintrag in die Ergebnisbilder. | ### 10. Divers: ⇧ Optional activating the Cosima Image PreViewer for cutting and individual rotation of the input images. Optional activating the Cosima Image PostViewer for common manual cutting and manual setting of the stereo window. Transfer of the EXIF-, IPTC-, XMP- and ICC-information from the original image into the output image. Setting of the DPI-values at the output images for pixelexact prints. Different options to write a text below the image: 'arbitrary text', 'text from the EXIF header', 'filename', 'directory name', 'date' or 'directory name plus an image counter' (the directory name must be a number in that case). Arbitrary size and arbitrary font. The same options to write a text into the right lower image corner. Copyright entry into the output images.
### 11. Funktionen der GUI: ⇧ Cosima Korrekturprozess starten. Online Hilfe. Automatische Updatefunktion. Setzen aller Cosima-Parameter, Lesen und Schreiben von Inidateien. Schnellstartfenster mit den wichtigsten Ein- und Ausgabeparametern. Bildersammler: Nur die rechten Bilder aussuchen und die linken per EXIF-Zeit automatisch dazuwählen. Nur Bildpaarung durchführen und verwaiste Einzelbilder aussortieren (anschließend hat man saubere Verzeichnisse). Unterbrechung und Wiederaufnahme eines Cosima-Laufes. Doppellauf: Zuerst nur Korrekturwerte ermitteln, anschließend Ausschnitt und Scheinfenster festlegen. Stereokartenkonfigurator mit Defaultwerten für Canon Selphy. Erzeugung eines Testmusters zur Anaglyphenkalibrierung für geisterfreie gedruckte Anaglyphen. AviSynth-Scriptgenerator für den allgemeinen Import von Videos. Vorbereitet für viele verbreitete Stereokameras: Fuji W1/W3 (avi), Panasonic FX500 (mov), Panasonic TZ10 (mov), Panasonic TZ10 (mts), Sony P200 (mpg), PAL-Camcorder (Mini-DV) DeInter (avi), HD-Camcorder (AVCHD) DeInter (mts), JVC GS-TD1 (AVCHD) DeInter (mts) und viele andere, komplette Bearbeitung ganzer Verzeichnisse. Aufruf des Cosima Video Previewer. Plausibilitätstest der Cosima-Parameter. Verwaltung der Optionen. | ### 11. Functions of the GUI: ⇧ Start the Cosima correction process. Online help. Automatic update function. Setting of all Cosima parameters, reading and writing of inifiles. Quick start window to set the most important input and output parameters. File collector: Just select the right images and get automatically the left ones by evaluating the EXIF times. Only pairing the images without correction run. After that there are clean directories with only one-to-one image relationships. Break and recovery of a Cosima run. Two pass run: For batch operation, at first only the correction values of all images will be estimated, after that, the image cutting and the window setting will be done image for image. Stereocard configurator with default values for Canon Selphy. Generation of a test image for anaglyph calibration for ghostfree anaglyph prints. AviSynth-Scriptgenerator for the import of general videos. Prepared are some wide-spread stereocameras: Fuji W1/W3 (avi), Panasonic FX500 (mov), Panasonic TZ10 (mov), Panasonic TZ10 (mts), Sony P200 (mpg), PAL-Camcorder (Mini-DV) DeInter (avi), HD-Camcorder (AVCHD) DeInter (mts), JVC GS-TD1 (AVCHD) DeInter (mts) and much more also foreseen complete processing of whole directories. Call of the Cosima Video Previewer. Plausibilitycheck for the Cosima parameters. Administration of the GUI options.
### 12. Cosima Image Previewer: ⇧ Anzeige des linken und rechten Bildes nebeneinander mit der Möglichkeit zum individuellen Beschnitt des Bildes vor der eigentlichen Bildkorrektur. Links und rechts individuelle Rotation zum Geraderichten des Horizonts. Nur die Drehwinkel werden bei der geometrischen Bildkorrektur verwendet, eine tatsächlich Drehung oder Beschneidung findet bei dieser virtuellen Rotation nicht statt. Eingeblendete waagerechte verschiebbare horizontale Linie. Onlinehilfe. | ### 12. Cosima Image Previewer: ⇧ Display of the left and right image side by side with the possibility of individual cropping of the image before the actual image correction. Left and right individual rotation to straighten the horizon. Only the rotation angles are used in the geometric image correction, an actual rotation or cropping does not take place during this virtual rotation. A sliding horizontal line is displayed. Online help.
### 13. Cosima Image Postviewer: ⇧ Anzeige eines geometrisch korrigierten Vorschaubildes als Anaglyphe. Optionale Vertauschung des linken und rechten Bildes. Manuelle Wahl eines Ausschnittes. Manuelle Wahl des Scheinfensters. Manuelle Phantogrammkorrektur. Manuelle Korrektur von stürzenden Linien, symmetrisch und asymmterisch. Manuelle Drehung um vertikale Mittenachse. Manuelle Korrektur einer Kantenverdrehung (infolge Objektivverzeichnung in Kombination mit Höhenfehlern). Halbtransparenter oder schwarzer Hintergrund der abgeschnittenen Bildränder. Overlay einer 16x16-Segment Deviationsmatrix. Sofortiges Springen zum nächsten Bild. Verschiebbare adaptive Anzeige von Bildweite/30. Bestimmung der 4 Parameter zur Monitor-Geisterkorrektur in Echtzeit. Onlinehilfe. | ### 13. Cosima Image Postviewer: ⇧ Display of a geometrically corrected preview image as an anaglyph. Optional interchange of the left and right image. Manual cutting-out of an image part. Manual setting of the stereo window. Manual phantogram correction. Manual correction of inclined lines, symmetrical and asymmetrical. Manual rotation around vertical center axis. Manual correction of an edge twisting (due to lens distortion in combination with height errors). Half transparent or black background of cutted borders. Overlay of a 16x16-segment deviation matrix. Immediate jump to the next image. Deviation metering with adaptive shiftable display of imagewidth/30. Finding out the 4 parameters for the monitor ghostbusting in real time. Online help.
### 14. Cosima Video Previewers: ⇧ Cut: Visuelle Festlegung des ersten und letzen Frames eines Takes. Sync: Synchronität zwischen dem linkem und rechtem Video feststellen (mit den eingebetteten Audiostreams) und nötigenfalls einen Frameversatz zum Ausgleich vorsehen. Clip: Manuelle Ausschnitte wählen und damit dynamische Zoom- oder Kamerafahrten erzeugen. Diese werden sofort abgespielt. Visuelle Kontrolle der Deshakingparameter. | ### 14. Cosima Video Previewer: ⇧ Cut: Visual determination of the first and last frame in a take. Sync: Finding out the synchronity between the left and right video (using the embedded audio streams), and, if necessary, adjust the delay in number of frames. Clip: Manual cutting-out of image parts and creating (simulated) camera trackings, zooms and pans. The results can be controlled in real time. Visual control of the deshaking parameters.

© Gerhard P. Herbig, August 2011, back to cosima homepage