Custom Calibrations

Authentica Creator wird mit einer Reihe von vorinstallierten Kalibrationen von offiziell unterstützten Geräten ausgeliefert. Dies sind in Authentica Creator Version 1.3 der Truvis Helios S53 und der Broncolor Scope D50.

Um Authentica Materialien aus Bild-Sequenzen zu generieren, welche mit Hilfe von anderen Geräten oder mit manueller Positionierung der Lichtquellen (z.B. Highlight RTI Method) erstellt wurden, unterstützt Authentica Creator die Verwendung einer benutzerdefinierten Kalibrationsdatei ('Custom Calibration'). Wir unterstützen momentan zwei verschiedene Formate für das Einlesen der Datei: das LP (.lp) Dateiformat und das JSON Dateiformat. Diese Formate werden weiter unten detaillierter beschrieben.

Verwenden einer benutzerdefinierten Kalibrationsdatei

• Folgen Sie den Anleitung Digitales Material generieren. Im Popup-Dialog wählen Sie 'Custom Calibration' als 'Device'.
• Klicken Sie dann auf 'Choose File' and lokalisieren Sie die .json of .lp Datei die Sie verwenden möchten.
• Details zu allen anderen Schritten und Einstellungen für das Erstellen eines digitalen Materials finden Sie in unter der Digitales Material generieren.

Erstellen einer benutzerdefinierten Kalibrationsdatei

Grundsätzlich kann eine Kalibrationsdatei auf zwei unterschiedliche Arten erstellt werden. Entweder mit der 'Highlight RTI' Methode, bei der eine reflektierende Kugel zusmammen mit den Objekten aufgenommen wird, oder durch das direkte Berechnen der Lichtrichtungen im Falle bekannter Geometrie des Beleuchtungsaufbaus.

Um eine LP Datei aus Bildern einer reflektierenden Kugel zu generieren, können Tools wie z.B. RTIBuilder verwendet werden. Siehe RTIBuilder by CHI und Guide to Highlight Image Processing by CHI

Für die direkte Erstellung einer Kalibrationsdatei bei bekannter Geometrie des Beleuchtungsaufbaus, konsultieren Sie die Beschreibung der unterstützen Formate weiter unten.

Das LP (.lp) Kalibrationsdatei Format

Das LP Format wird in verschiedenen Tools für die Erstellung von RTI Daten verwendet, unter anderem in der Desktop Software RTIBuilder. Es wird als einfache Text Datei gespeichert und besteht aus durch Leerzeichen und Zeilenumbrüche getrennten Werten. Die erste Zeile besteht aus nur einer Spalte, bestehend aus einer Zahl N, welche die Anzahl der verwendeten Bilder in der Bildsequenz beschreibt. Die folgenden N Zeilen bestehen jeweils aus 4 Spalten. Jede Zeile entspricht einem Bild aus der Bildsequenz.

Die erste Spalte besteht aus dem Pfad des enstsprechenden Bildes aus der Bildsequenz, die für die Erstellung der Kalibrationsdatei verwendet wurde.

Achtung: Die erste Spalte (Pfad zu den Bilddateien) wird in Authentica Creator ignoriert. Authentica Creator geht davon aus, dass die Zeilen in der Datei alpha-numerisch nach den Bildpfaden sortiert sind. Dies ist der Fall für LP Dateine, welche mit RTIBuilder erstellt wurden. Authentica Creator liest die Bilder in dem Input-Ordner ebenfalls in alpha-numerischer Reihenfolge, und assoziert diese so mit der jeweiligen Zeile der Kalibrationsdatei. Dieses Verhalten erlaubt es, eine Kalibrationsdatei für mehrere Bildsequenzen , solange die Geometrie des Beleuchtungsaufbaus sich nicht verändert. Bilder der reflektierenden Kugel müssen so nur einmal für die Kalibration aufgenommen werden, und nicht jedes mal zusammen mit den jeweiligen eingentlichen Objekten.

Die folgenden 3 Spalten bestehen aus den x-, y- und z-Koordinaten des (normalisierten) Vektors der die Richtung der jeweiligen Lichtquelle beschreibt.

Der Name der Kalibrationsdatei muss in '.lp' enden.

Bei konstanter Geometrie des Beleuchtungsaufbaus empfehlen wir die einmalige Aufnahme einer Bildsequenz einer reflektierenden Kugel, platziert im Zentrum des Bildes, und die anschliessende Erstellung einer LP Datei mit Hilfe von RTIBuilder.

Beispieldatei exampleCalibration.lp:

4
/Users/Thomas/rtiSequences/sequence42/image_01.tif 0.7071067812 0.0 0.7071067812
/Users/Thomas/rtiSequences/sequence42/image_02.tif 0.0 0.7071067812 0.7071067812
/Users/Thomas/rtiSequences/sequence42/image_03.tif -0.7071067812 0.0 0.7071067812
/Users/Thomas/rtiSequences/sequence42/image_02.tif 0.0 -0.7071067812 0.7071067812

Diese Beispieldatei beschreibt ein Setup mit 4 Lichtquellen, welche über den x- und -y Achsen platziert sind. Alle Lichtquellen sind auf gleicher Höhe angebracht, was in einem 45° Winkel zwischen Lichtrichtung und der x/y Ebene resultiert.

Das JSON (.json) Kalibrationsdatei Format

Das Authentica JSON Format für Kalibrationsdateien des Beleuchtungsaufbaus wird als einfache Textdatei in JSON Notation gespeichert. Es besteht aus einem einzeln JSON Array, mit je einem Element für jede Lichtquelle. Jedes Element besteht aus einem JSON Objekt, das die x-, y- und z-Koordinaten des (normalisierten) Vektors der die Richtung der jeweiligen Lichtquelle beinhaltet.

Authentica Creator liest die Bilder im Input Ordner in alpha-numerischerischer Reihenfolge und assoziert diese so mit dem jeweiligen Array-Element.

Der Name der Kalibrationsdatei muss in '.json' oder '.JSON' enden.

Beispieldatei exampleCalibration.json:

[
  {
    "x": 0.7071067812,
    "y": 0.0,
    "z": 0.7071067812
  },
  {
    "x": 0.0,
    "y": 0.7071067812,
    "z": 0.7071067812
  },
  {
    "x": -0.7071067812,
    "y": 0.0,
    "z": 0.7071067812
  },
  {
    "x": 0.0,
    "y": -0.7071067812,
    "z": 0.7071067812
  },
]

Diese Beispieldatei beschreibt ein Setup mit 4 Lichtquellen, welche über den x- und -y Achsen platziert sind. Alle Lichtquellen sind auf gleicher Höhe angebracht, was in einem 45° Winkel zwischen Lichtrichtung und der x/y Ebene resultiert.