GigE Vision 2.0/GenICam-Schnittstelle¶
Gigabit Ethernet for Machine Vision (oder kurz „GigE Vision®“) ist ein industrieller Standard für Kameraschnittstellen, der auf UDP/IP basiert (siehe http://www.gigevision.com). Der rc_cube nutzt den GigE Vision®-Standard der Version 2.0 und ist damit mit allen GigE Vision®-2.0-Standard-konformen Frameworks und Bibliotheken kompatibel.
GigE Vision® verwendet GenICam (Generic Interface for Cameras), um die Eigenschaften der Kamera bzw. des Geräts zu beschreiben. Für nähere Informationen zu dieser generischen Programmierschnittstelle für Kameras siehe http://www.genicam.org/.
Über diese Schnittstelle stellt der rc_cube folgende Funktionen zur Verfügung:
- Discovery-Mechanismus,
- IP-Konfiguration,
- Konfiguration kamerabezogener Parameter,
- Bildaufnahme und
- Zeitsynchronisierung über das im Standard IEEE 1588-2008 definierte Precision Time Protocol (PTPv2).
Bemerkung
Der rc_cube unterstützt Jumbo-Frames mit einer Größe bis 9000 Byte. Für höchste Leistung wird empfohlen, die maximale Übertragungseinheit (MTU) des GigE-Vision-Clients auf 9000 zu stellen.
Bemerkung
Über seine Homepage stellt Roboception Tools und eine C++-Programmierschnittstelle mit Beispielen zum Discovery-Mechanismus, zur Konfiguration und zum Bild-Streaming über die GigE Vision/GenICam-Schnittstelle zur Verfügung (http://www.roboception.com/download).
GigE Vision Ports¶
GigE Vision ist ein UDP basiertes Protokoll. Auf dem rc_cube sind die UDP Ports statisch und bekannt:
- UDP Port 3956: GigE Vision Control Protocol (GVCP). Zum Auffinden, steuern und konfigurieren des Geräts.
- UDP Port 50010: Stream channel source port. Nutzt das GigE Vision Stream Protocol (GVSP) zum transferieren der Bilder.
Wichtige Parameter der GenICam-Schnittstelle¶
Die folgende Liste enthält einen Überblick über relevante GenICam-Parameter des rc_cube, die über die GenICam-Schnittstelle abgerufen und/oder geändert werden können. Neben den Standardparametern, die in der Standard Feature Naming Convention (SFNC, siehe http://www.emva.org/standards-technology/genicam/genicam-downloads/) definiert werden, bietet der rc_cube zudem eigene Parameter, die sich auf spezielle Eigenschaften der Module Stereokamera und Stereo-Matching beziehen.
Wichtige Standardparameter der GenICam-Schnittstelle¶
Kategorie: ImageFormatControl¶
ComponentSelector
- Typ: Aufzählung, mögliche Werte:
Intensity
,IntensityCombined
,Disparity
,Confidence
oderError
- Voreinstellung: -
- Beschreibung: Erlaubt dem Benutzer, einen der fünf Bild-Streams zur Konfiguration auszuwählen (siehe Verfügbare Bild-Streams).
- Typ: Aufzählung, mögliche Werte:
ComponentIDValue
(schreibgeschützt)- Typ: Integer
- Beschreibung: ID des vom
ComponentSelector
ausgewählten Bild-Streams.
ComponentEnable
- Typ: Boolean
- Voreinstellung: -
- Beschreibung: Ist der Parameter auf
true
gesetzt, aktiviert er den imComponentSelector
ausgewählten Bild-Stream. Anderenfalls deaktiviert er diesen Stream. ÜberComponentSelector
undComponentEnable
lassen sich einzelne Bild-Streams ein- und ausschalten.
Width
(schreibgeschützt)- Typ: Integer
- Beschreibung: Bildbreite des vom
ComponentSelector
ausgewählten Bild-Streams in Pixeln.
Height
(schreibgeschützt)- Typ: Integer
- Beschreibung: Bildhöhe des vom
ComponentSelector
ausgewählten Bild-Streams in Pixeln.
WidthMax
(schreibgeschützt)- Typ: Integer
- Beschreibung: Maximale Breite eines Bildes (beträgt immer 1280 Pixel).
HeightMax
(schreibgeschützt)- Typ: Integer
- Beschreibung: Maximale Höhe eines Bildes im Stream. Der Wert beträgt aufgrund der gestapelten Bilder der linken und rechten Kamera im
IntensityCombined
-Stream immer 1920 Pixel (siehe Verfügbare Bild-Streams).
PixelFormat
- Typ: Aufzählung, mögliche Werte:
Mono8
oderYCbCr411_8
(nur bei Farbkameras),Coord3D_C16
,Confidence8
undError8
- Beschreibung: Pixelformat der selektierten Komponente. Die Aufzählung erlaubt nur aus Pixelformaten auszuwählen, die für die ausgewählte Komponente möglich sind. Bei einer Farbkamera kann man bei den Komponenten
Intensity
undIntensityCombined
zwischen den PixelformatenMono8
oderYCbCr411_8
wählen.
- Typ: Aufzählung, mögliche Werte:
Kategorie: AcquisitionControl¶
AcquisitionFrameRate
- Typ: Float, Wertebereich: 1–25 Hz
- Voreinstellung: 25 Hz
- Beschreibung: Bildwiederholrate der Kamera (FPS).
ExposureAuto
- Typ: Aufzählung, mögliche Werte:
Continuous
,AdaptiveOut1
oderOff
- Voreinstellung:
Continuous
- Beschreibung: Lässt sich für die manuelle Belichtung auf
Off
bzw. für die automatische Belichtung aufContinuous
oderAdaptiveOut1
setzen. Der WertContinuous
entspricht dem WertNormal
fürexp_auto_mode
(Modus Belichtungsautomatik) undAdaptiveOut1
dem gleichnamigen Modus.
- Typ: Aufzählung, mögliche Werte:
ExposureTime
- Typ: Float, Wertebereich: 66–18000 µs
- Voreinstellung: 5000 µs
- Beschreibung: Belichtungszeit der Kameras für den manuellen Belichtungsmodus, ausgedrückt in Mikrosekunden (Belichtungszeit).
Kategorie: AnalogControl¶
GainSelector
(schreibgeschützt)- Typ: Aufzählung, Wert: ist immer
All
- Voreinstellung:
All
- Beschreibung: Der rc_cube unterstützt aktuell nur einen globalen Verstärkungsfaktor.
- Typ: Aufzählung, Wert: ist immer
Gain
- Typ: Float, Wertebereich: 0–18 dB
- Voreinstellung: 0 dB
- Beschreibung: Verstärkungsfaktor der Kameras für den manuellen Belichtungsmodus, ausgedrückt in Dezibel (Verstärkungsfaktor).
BalanceWhiteAuto
(nur für Farbkameras)- Typ: Aufzählung, mögliche Werte:
Continuous
oderOff
- Voreinstellung:
Continuous
- Beschreibung: Lässt sich für den manuellen Weißabgleich auf
Off
bzw. für den automatischen Weißabgleich aufContinuous
setzen. Dieser Parameter ist nur für Farbkameras verfügbar (Weißabgleich).
- Typ: Aufzählung, mögliche Werte:
BalanceRatioSelector
(nur für Farbkameras)- Typ: Aufzählung, mögliche Werte:
Red
oderBlue
- Voreinstellung:
Red
- Beschreibung: Auswahl des Verhältnisses welches mit
BalanceRatio
einstellbar ist.Red
bedeutet Verhältnis von Rot zu Grün, undBlue
bedeutet Verhältnis von Blau zu Grün. Diese Einstellung ist nur für Farbkameras verfügbar.
- Typ: Aufzählung, mögliche Werte:
BalanceRatio
(nur für Farbkameras)- Typ: Float, Wertebereich: 0.125 – 8
- Voreinstellung: 1.2 wenn
Red
und 2.4 wennBlue
imBalanceRatioSelector
eingestellt sind - Beschreibung: Gewichtung vom roten oder blauen zum grünen Farbkanal. Diese Einstellung ist nur für Farbkameras verfügbar (wb_ratio).
Kategorie: DigitalIOControl¶
Bemerkung
Falls die IOControl-Lizenz nicht verfügbar ist, dann werden die Ausgänge entsprechend den Voreinstellungen gesetzt und können nicht geändert werden. Die Eingänge liefern immer den logischen Wert für falsch, unabhängig davon welche Signale an den physikalischen Eingängen anliegen.
LineSelector
- Typ: Aufzählung, mögliche Werte:
Out1
,Out2
,In1
oderIn2
- Voreinstellung:
Out1
- Beschreibung: Wählt den Ein- oder Ausgang, um den aktuellen Zustand abzufragen oder die Betriebsart zu setzen.
- Typ: Aufzählung, mögliche Werte:
LineStatus
(schreibgeschützt)- Typ: Boolean
- Beschreibung: Aktueller Zustand des mit
LineSelector
ausgewählten Ein- oder Ausgangs.
LineStatusAll
(schreibgeschützt)- Typ: Integer
- Beschreibung: Aktueller Zustand der Ein- und Ausgänge, welche in den unteren vier Bits angegeben werden.
¶ Bit 4 3 2 1 GPIO Eingang 2 Eingang 1 Ausgang 2 Ausgang 1
LineSource
(schreibgeschützt, falls das IOControl-Modul nicht lizenziert ist)- Typ: Aufzählung, mögliche Werte:
ExposureActive
,ExposureAlternateActive
,Low
oderHigh
- Voreinstellung:
Low
- Beschreibung: Betriebszustand des mit
LineSelector
gewählten Ausgangs, wie im Abschnitt zum IOControl Modul beschrieben (out1_mode und out2_mode). Siehe auch den ParameterAcquisitionAlternateFilter
zum Filtern von Bildern im BetriebszustandExposureAlternateActive
.
- Typ: Aufzählung, mögliche Werte:
Kategorie: TransportLayerControl / PtpControl¶
PtpEnable
- Typ: Boolean
- Voreinstellung:
false
- Beschreibung: Schaltet die PTP-Synchronisierung ein und aus.
Kategorie: Scan3dControl¶
Scan3dDistanceUnit
(schreibgeschützt)- Typ: Aufzählung, Wert: ist immer
Pixel
- Beschreibung: Einheit für die Disparitätsmessungen, ist immer
Pixel
.
- Typ: Aufzählung, Wert: ist immer
Scan3dOutputMode
(schreibgeschützt)- Typ: Aufzählung, Wert: ist immer
DisparityC
- Beschreibung: Modus für die Tiefenmessungen, ist immer
DisparityC
.
- Typ: Aufzählung, Wert: ist immer
Scan3dFocalLength
(schreibgeschützt)- Typ: Float
- Beschreibung: Brennweite des mit
ComponentSelector
ausgewählten Bild-Streams in Pixeln. Im Fall der KomponentenDisparity
,Confidence
undError
hängt der Wert auch von der Auflösung ab, die implizit überDepthQuality
eingestellt wurde.
Scan3dBaseline
(schreibgeschützt)- Typ: Float
- Beschreibung: Basisabstand der Stereokamera in Metern.
Scan3dPrinciplePointU
(schreibgeschützt)- Typ: Float
- Beschreibung: Horizontale Position des Bildhauptpunktes des mit
ComponentSelector
ausgewählten Bild-Streams. Im Fall der KomponentenDisparity
,Confidence
undError
hängt der Wert auch von der Auflösung ab, die implizit überDepthQuality
eingestellt wurde.
Scan3dPrinciplePointV
(schreibgeschützt)- Typ: Float
- Beschreibung: Vertikale Position des Bildhauptpunktes des mit
ComponentSelector
ausgewählten Bild-Streams. Im Fall der KomponentenDisparity
,Confidence
undError
hängt der Wert auch von der Auflösung ab, die implizit überDepthQuality
eingestellt wurde.
Scan3dCoordinateScale
(schreibgeschützt)- Typ: Float
- Beschreibung: Der Skalierungsfaktor, der mit den Disparitätswerten im Disparitätsbild-Stream zu multiplizieren ist, um die tatsächlichen Disparitätswerte zu erhalten. Der Wert beträgt immer 0,0625.
Scan3dCoordinateOffset
(schreibgeschützt)- Typ: Float
- Beschreibung: Der Versatz, der zu den Disparitätswerten im Disparitätsbild-Stream addiert werden muss, um die tatsächlichen Disparitätswerte zu erhalten. Für den rc_cube beträgt der Wert immer 0 und kann daher ignoriert werden.
Scan3dInvalidDataFlag
(schreibgeschützt)- Typ: Boolean
- Beschreibung: Ist immer
true
, was bedeutet, dass ungültige Daten im Disparitätsbild mit einem spezifischen Wert markiert werden, der durch den ParameterScan3dInvalidDataValue
definiert wird.
Scan3dInvalidDataValue
(schreibgeschützt)- Typ: Float
- Beschreibung: Ist der Wert, der für ungültige Disparität steht. Der Wert ist immer 0, was bedeutet, dass Disparitätswerte von 0 immer ungültigen Messungen entsprechen. Um zwischen ungültigen Disparitätsmessungen und Messungen, bei denen die Disparität aufgrund der unendlich weit entfernten Objekte 0 beträgt, unterscheiden zu können, wird der Disparitätswert für den letztgenannten Fall auf 0,0625 gesetzt. Dies entspricht noch immer einer Objektentfernung von mehreren hundert Metern.
Kategorie: ChunkDataControl¶
ChunkModeActive
- Typ: Boolean
- Voreinstellung:
false
- Beschreibung: Schaltet Chunk-Daten an, die mit jedem Bild mitgeliefert werden.
Besondere Parameter der GenICam-Schnittstelle des rc_cube¶
Kategorie: AcquisitionControl¶
AcquisitionAlternateFilter
(schreibgeschützt, falls das IOControl-Modul nicht lizenziert ist)- Typ: Aufzählung, mögliche Werte:
Off
,OnlyHigh
oderOnlyLow
- Voreinstellung:
Off
- Beschreibung: Falls dieser Parameter auf
OnlyHigh
(oder entsprechendOnlyLow
) und dieLineSource
für mindestens einen Ausgang aufExposureAlternateActive
eingestellt wird, dann werden nur die Kamerabilder übertragen, welche aufgenommen wurden, während der konfigurierte Ausgang an war, d.h. ein potentiell angeschlossener Projektor war an (oder beiOnlyLow
entsprechend aus). Dieser Parameter ist ein einfaches Mittel um nur Bilder ohne ein projiziertes Muster zu bekommen. Der minimale Zeitunterschied zwischen einem Kamera- und einem Disparitätsbild ist in diesem Fall etwa 40 ms (siehe IOControl).
- Typ: Aufzählung, mögliche Werte:
AcquisitionMultiPartMode
- Typ: Aufzählung, mögliche Werte:
SingleComponent
oderSynchronizedComponents
- Voreinstellung:
SingleComponent
- Beschreibung: Nur wirksam im MultiPart-Modus. Ist dieser Parameter auf
SingleComponent
gesetzt, werden die Bilder jeweils sofort als einzelne Komponente pro Frame/Puffer geschickt, sobald sie verfügbar sind. Dies entspricht dem Verhalten von Clients, die MultiPart nicht unterstützen. Ist dieser Parameter aufSynchronizedComponents
gesetzt, werden die aktivierten Komponenten auf dem rc_cube zeitlich synchronisiert und in einem gemeinsamen Frame/Puffer versendet – allerdings nur, falls alle für diesen Zeitpunkt verfügbar sind.
- Typ: Aufzählung, mögliche Werte:
ExposureTimeAutoMax
- Typ: Float, Wertebereich: 66–18000 µs
- Voreinstellung: 18000 µs
- Beschreibung: Maximale Belichtungszeit im automatischen Belichtungsmodus (Maximale Belichtungszeit).
ExposureRegionOffsetX
- Typ: Integer, Wertebereich 0-1280
- Voreinstellung: 0
- Beschreibung: Horizontaler Offset des Bereichs für die Belichtungszeitregelung in Pixeln.
ExposureRegionOffsetY
- Typ: Integer, Wertebereich: 0-960
- Voreinstellung: 0
- Beschreibung: Vertikaler Offset des Bereichs für die Belichtungszeitregelung in Pixeln.
ExposureRegionWidth
- Typ: Integer, Wertebereich 0-1280
- Voreinstellung: 0
- Beschreibung: Breite des Bereichs für die Belichtungszeitregelung in Pixeln.
ExposureRegionHeight
- Typ: Integer, Wertebereich: 0-960
- Voreinstellung: 0
- Beschreibung: Höhe des Bereichs für die Belichtungszeitregelung in Pixeln.
RcExposureAutoAverageMax
- Typ: Float, Wertebereich 0-1
- Voreinstellung: 0.75
- Beschreibung: Maximale Helligkeit der automatischen Belichtungszeitsteuerung als Wert zwischen 0 (dunkel) und 1 (hell).
RcExposureAutoAverageMin
- Typ: Float, Wertebereich 0-1
- Voreinstellung: 0.25
- Beschreibung: Minimale Helligkeit der automatischen Belichtungszeitsteuerung als Wert zwischen 0 (dunkel) und 1 (hell).
Kategorie: Scan3dControl¶
FocalLengthFactor
(schreibgeschützt)- Typ: Float
- Beschreibung: Brennweite skaliert auf eine Bildbreite von einem Pixel. Um die Brennweite für ein bestimmtes Bild in Pixeln zu ermitteln, muss dieser Wert mit der Breite des empfangenen Bilds multipliziert werden. Siehe auch den Parameter
Scan3dFocalLength
.
Baseline
(schreibgeschützt)- Typ: Float
- Besschreibung: Dieser Parameter ist überholt. Der Parameter
Scan3dBaseline
sollte stattdessen benutzt werden.
Kategorie: DepthControl¶
DepthAcquisitionMode
- Typ: Aufzählung, mögliche Werte:
SingleFrame
,SingleFrameOut1
oderContinuous
- Voreinstellung:
Continuous
- Beschreibung: Im Modus
SingleFrame
wird das Stereo-Matching mit jedem Aufruf vonDepthAcquisitionTrigger
durchgeführt. Der ModusSingleFrameOut1
kann zum Kontrollieren eines externen Projektors genutzt werden. Dabei wird bei jedem TriggerOut1
aufExposureAlternateActive
und nach dem Empfangen der Stereobilder aufLow
gesetzt. Dies ist jedoch nur möglich, wenn die IOControl-Lizenz verfügbar ist. Im ModusContinuous
wird das Stereo-Matching kontinuierlich durchgeführt.
- Typ: Aufzählung, mögliche Werte:
DepthAcquisitionTrigger
- type: Command
- Beschreibung: Dieses Kommando triggert das Stereo-Matching auf den nächsten verfügbaren Stereobildern, falls
DepthAcquisitionMode
aufSingleFrame
oderSingleFrameOut1
eingestellt ist.
DepthQuality
- Typ: Aufzählung, mögliche Werte:
Low
,Medium
,High
oderFull
(nur mit StereoPlus-Lizenz) - Voreinstellung:
High
- Beschreibung: Qualität der Disparitätsbilder. Eine geringere
DepthQuality
führt zu Disparitätsbildern mit einer geringeren Auflösung (Qualität).
- Typ: Aufzählung, mögliche Werte:
DepthStaticScene
- Typ: Boolean
- Voreinstellung:
false
- Beschreibung:
True
zum Mitteln über acht aufeinanderfolgende Kamerabilder zur Verbesserung des Stereo-Matching-Resultats (Statisch).
DepthSmooth
(schreibgeschützt ohne StereoPlus-Lizenz)- Typ: Boolean
- Voreinstellung:
false
- Beschreibung:
True
um Disparitätswerte zu glätten (Glättung).
DepthFill
- Typ: Integer, Wertebereich: 0–4 Pixel
- Voreinstellung: 3 Pixel
- Beschreibung: Wert in Pixeln für Füllen.
DepthSeg
- Typ: Integer, Wertebereich: 0–4000 Pixel
- Voreinstellung: 200 Pixel
- Beschreibung: Wert in Pixeln für Segmentierung.
DepthMinConf
- Typ: Float, Wertebereich: 0.0–1.0
- Voreinstellung: 0.0
- Beschreibung: Wert für die Minimale Konfidenz-Filterung.
DepthMinDepth
- Typ: Float, Wertebereich: 0.1–100.0 m
- Voreinstellung: 0.1 m
- Beschreibung: Wert in Metern für die Minimale Abstands-Filterung.
DepthMaxDepth
- Typ: Float, Wertebereich: 0.1–100.0 m
- Voreinstellung: 100.0 m
- Beschreibung: Wert in Metern für die Maximale Abstands-Filterung.
DepthMaxDepthErr
- Typ: Float, Wertebereich: 0.01–100.0 m
- Voreinstellung: 100.0 m
- Beschreibung: Wert in Metern für die Maximale Fehler-Filterung.
Chunk-Daten¶
Der rc_cube unterstützt Chunk-Parameter, die mit jedem Bild mitgeschickt werden. Chunk-Parameter haben alle den Präfix Chunk
. Ihre Bedeutung entspricht den gleichlautenden Nicht-Chunk-Parametern. Sie passen jedoch immer zu dem zugehörigen Bild. Zum Beispiel hängt Scan3dFocalLength
von ComponentSelector
und DepthQuality
ab, da die Bildauflösung von beiden Parametern abhängt. Der Parameter ChunkScan3dFocalLength
, welcher zu einem Bild geliefert wird, passt hingegen zu der Auflösung dieses Bildes.
Nützliche Chunk-Parameter:
ChunkComponentSelector
selektiert, für welche Komponente Chunk-Daten aus dem MultiPart-Puffer gelesen werden.ChunkComponentID
undChunkComponentIDValue
dienen der eindeutigen Zuordnung des Bildes zu seiner Komponente (z.B. Kamerabild oder Disparitätsbild), ohne dies vom Bildformat oder der Bildgröße ableiten zu müssen.ChunkLineStatusAll
bietet den Status der Ein- und Ausgänge zum Zeitpunkt der Bildaufnahme. SieheLineStatusAll
für eine Beschreibung der Bits.ChunkScan3d...
sind nützlich zur 3D-Rekonstruktion wie im Abschnitt Umwandlung von Bild-Streams beschrieben.ChunkPartIndex
gibt den Index des Bild-Parts im MultiPart-Block für die ausgewählte Komponente (ChunkComponentSelector
) zurück.
Chunk-Daten werden durch das Setzen des GenICam-Parameters ChunkModeActive
auf True
eingeschaltet.
Verfügbare Bild-Streams¶
Der rc_cube stellt über die GenICam-Schnittstelle die folgenden fünf Bild-Streams zur Verfügung:
Name der Komponente | PixelFormat | Breite × Höhe | Beschreibung |
---|---|---|---|
Intensity |
Mono8 (monochrome Kameras)YCbCr411_8 (Farbkameras) |
1280 × 960 | Rektifiziertes Bild der linken Kamera |
IntensityCombined |
Mono8 (monochrome Kameras)YCbCr411_8 (Farbkameras) |
1280 × 1920 | Rektifiziertes Bild der linken Kamera, gestapelt auf das rektifizierte Bild der rechten Kamera |
Disparity |
Coord3D_C16 |
1280 × 1920
640 × 480
320 × 240
214 × 160
|
Disparitätsbild in gewünschter Auflösung, d.h. DepthQuality in Full , High , Medium oder Low |
Confidence |
Confidence8 |
wie Disparity |
Konfidenzbild |
Error |
Error8 (Sonderformat: 0x81080001) |
wie Disparity |
Fehlerbild |
Jedes Bild wird mit einem Zeitstempel und dem in der Tabelle angegebenen PixelFormat ausgegeben. Dieses PixelFormat sollte verwendet werden, um zwischen den verschiedenen Bildtypen zu unterscheiden. Bilder, die den gleichen Aufnahmezeitpunkt haben, können durch Vergleich der GenICam-Zeitstempel einander zugeordnet werden.
Umwandlung von Bild-Streams¶
Das Disparitätsbild enthält vorzeichenlose 16-Bit-Ganzzahlwerte. Diese Werte müssen mit dem im GenICam-Parameter Scan3dCoordinateScale angegebenen Skalierungsfaktor multipliziert werden, um die Disparitätswerte \(d\) in Pixeln zu ermitteln. Um die 3D-Objektkoordinaten aus den Disparitätswerten berechnen zu können, werden die Brennweite, der Basisabstand und der Bildhauptpunkt benötigt. Diese Parameter werden als GenICam-Parameter Scan3dFocalLength, Scan3dBaseline, Scan3dPrincipalPointU und Scan3dPrincipalPointV zur Verfügung gestellt. Die Brennweite und der Bildhauptpunkt hängen von der Bildauflösung der mit dem ComponentSelector selektierten Komponente ab. Sind diese Werte bekannt, können die Pixel-Koordinaten und die Disparitätswerte mithilfe der im Abschnitt Berechnung von Tiefenbildern und Punktwolken angegebenen Gleichungen in 3D-Objektkoordination im Kamera-Koordinatensystem umgerechnet werden.
Unter der Annahme, dass es sich bei \(d_{ik}\) um den 16-Bit-Disparitätswert in der Spalte \(i\) und Zeile \(k\) eines Disparitätsbildes handelt, ist der Fließkomma-Disparitätswert in Pixeln \(d_{ik}\) gegeben durch
Die 3D-Rekonstruktion (in Metern) kann wie folgt mit den GenICam-Parametern durchgeführt werden:
Das Konfidenzbild umfasst vorzeichenlose 8-Bit-Ganzzahlwerte. Diese Werte müssen durch 255 geteilt werden, um die zwischen 0 und 1 liegenden Konfidenzwerte zu berechnen.
Das Fehlerbild umfasst vorzeichenlose 8-Bit-Ganzzahlwerte. Der Fehler \(e_{ik}\) muss mit dem im GenICam-Parameter Scan3dCoordinateScale angegebenen Skalierungsfaktor multipliziert werden, um die Disparitätsfehlerwerte \(d_{eps}\) in Pixeln zu ermitteln. Der Beschreibung in Konfidenz- und Fehlerbilder zufolge lässt sich der Tiefenfehler \(z_{eps}\) (in Metern) mit den GenICam-Parametern wie folgt berechnen:
Bemerkung
Chunk-Daten sollten nach Möglichkeit mit dem Parameter ChunkModeActive angeschaltet und die zum Bild zugehörigen Parameter ChunkScan3dCoordinateScale, ChunkScan3dFocalLength, ChunkScan3dBaseline, ChunkScan3dPrincipalPointU und ChunkScan3dPrincipalPointV genutzt werden, denn deren Werte passen zu der Auflösung des zugehörigen Bildes.
Für nähere Informationen zu Disparitäts-, Fehler- und Konfidenzbildern siehe Stereo-Matching.