Pipelinetyp stereo_ace¶
Parameter¶
Das Kamera-Modul auf einer Pipeline vom Typ stereo_ace
wird in der REST-API als rc_camera
bezeichnet und in der Web GUI auf der Seite Kamera in der gewünschten Pipeline dargestellt. Der Benutzer kann die Stereo-Matching-Parameter entweder dort oder über die REST-API (REST-API-Schnittstelle) oder über GigE Vision (GigE Vision 2.0/GenICam-Schnittstelle) ändern.
Übersicht über die Parameter¶
Dieses Softwaremodul bietet folgende Laufzeitparameter:
Name | Typ | Min. | Max. | Default | Beschreibung |
---|---|---|---|---|---|
acquisition_mode |
string | - | - | Continuous | Aufnahmemodus: [Continuous, Trigger] |
brightness |
float64 | -1.0 | 1.0 | 0.0 | Helligkeit |
contrast |
float64 | -1.0 | 1.0 | 0.0 | Kontrast |
contrast_mode |
string | - | - | Linear | Kontrastmodus [Linear, SCurve] |
exp_auto |
bool | false | true | false | Umschalten zwischen automatischer und manueller Belichtung (veraltet, nutzen Sie stattdessen exp_control) |
exp_auto_average_max |
float64 | 0.0 | 1.0 | 0.75 | Maximaler Belichtungsmittelwert im Auto Belichtungsmodus |
exp_auto_average_min |
float64 | 0.0 | 1.0 | 0.25 | Maximaler Belichtungsmittelwert im Auto Belichtungsmodus |
exp_auto_mode |
string | - | - | Normal | Modus für automatische Belichtung: [Normal, Out1High, AdaptiveOut1] |
exp_control |
string | - | - | Manual | Art der Belichtungsregelung: [Manual, Auto, HDR] |
exp_height |
int32 | 0 | 959 | 0 | Höhe der Region für automatische Belichtung, 0 für das ganze Bild |
exp_max |
float64 | 6.6e-05 | 0.018 | 0.018 | Maximale Belichtungszeit in Sekunden im Auto Belichtungsmodus |
exp_offset_x |
int32 | 0 | 1279 | 0 | Erste Spalte der Region für automatische Belichtung |
exp_offset_y |
int32 | 0 | 959 | 0 | Erste Zeile der Region für automatische Belichtung |
exp_value |
float64 | 6.6e-05 | 0.018 | 0.005 | Maximale Belichtungszeit in Sekunden im Auto Belichtungsmodus |
exp_width |
int32 | 0 | 1279 | 0 | Breite der Region für automatische Belichtung, 0 für das ganze Bild |
fps |
float64 | 1.0 | 25.0 | 25.0 | Bildwiederholrate in Hertz |
gain_value |
float64 | 0.0 | 18.0 | 0.0 | Verstärkung in Dezibel, wenn nicht im Auto Belichtungsmodus |
gamma |
float64 | 0.1 | 10.0 | 1.0 | Gammafaktor |
light_source_preset |
string | - | - | Daylight6500K | Voreinstellung der Lichtquelle [Off, Tungsten, Daylight5000K, Daylight6500K, FactoryLED6000K] |
saturation` | float64 | 0.0 | 2.0 | 1.0 | Sättigung |
trigger_activation |
string | - | - | RisingEdge | Triggeraktivierung: [RisingEdge, FallingEdge, AnyEdge] |
trigger_source |
string | - | - | Software | Triggerquelle: [Software, In1, In2, In3, In4] |
wb_auto |
bool | false | true | true | Ein- und Ausschalten des manuellen Weißabgleichs (nur für Farbkameras) |
wb_ratio_blue |
float64 | 0.125 | 8.0 | 2.4 | Blauanteil, falls wb_auto auf false gesetzt ist (nur für Farbkameras) |
wb_ratio_green |
float64 | 0.125 | 8.0 | 1.0 | Grünanteil, falls wb_auto auf false gesetzt ist (nur für Farbkameras) |
wb_ratio_red |
float64 | 0.125 | 8.0 | 1.2 | Rotanteil, falls wb_auto auf false gesetzt ist (nur für Farbkameras) |
Beschreibung der Laufzeitparameter¶
Jeder Laufzeitparameter ist durch eine eigene Zeile auf der Seite Tiefenbild der Web GUI repräsentiert. Der Web GUI-Name des Parameters ist in Klammern hinter dem Namen des Parameters angegeben und die Parameter werden in der Reihenfolge, in der sie in der Web GUI erscheinen, aufgelistet.
acquisition_mode
(Aufnahmemodus)¶
Dieser Wert bestimmt den Aufnahmemodus der Kamera. Im Modus Kontinuierlich (
Continuous
) nimmt die Kamera Bilder mit der infps
angegebenen Bildwiederholrate auf. Im Modus Trigger (Trigger
) werden nur Bilder aufgenommen, wenn die Kamera ein Triggersignal empfängt.Über die REST-API kann dieser Parameter wie folgt gesetzt werden.
PUT http://<host>/api/v2/pipelines/0/nodes/rc_camera/services/parameters?acquisition_mode=<value>
PUT http://<host>/api/v1/nodes/rc_camera/parameters?acquisition_mode=<value>
trigger_source
(Triggerquelle)¶
Dieser Wert wird nur verwendet, wenn der Aufnahmemodus auf
Trigger
gesetzt ist und bestimmt die Triggerquelle. ImSoftware
-Modus kann ein Trigger über denrc_camera/acquisition_trigger
Service gesendet werden. Wenn der Aufnahmemodusacquisition_mode
für die Tiefenbilder aufSingleFrame
oderSingleFrameOut1
gesetzt ist (siehe Parameter), wird der Kamera-Softwaretrigger automatisch bei jeder Tiefenbildaufnahme gesendet. Die ModiIn1
undIn2
sind Hardwaretriggermodi. Ein Bild wird aufgenommen, sobald ein Signal auf dem jeweiligen Eingang empfangen wird.Über die REST-API kann dieser Parameter wie folgt gesetzt werden.
PUT http://<host>/api/v2/pipelines/0/nodes/rc_camera/services/parameters?trigger_source=<value>
PUT http://<host>/api/v1/nodes/rc_camera/parameters?trigger_source=<value>
trigger_activation
(Triggeraktivierung)¶
Dieser Wert wird nur verwendet, wenn der Aufnahmemodus auf
Trigger
gesetzt ist und die Triggerquelle aufIn1
oderIn2
steht. Er bestimmt die Signalflanke, die genutzt werden soll, um eine Bildaufnahme auszulösen. Mögliche Werte sindRisingEdge
(steigende Flanke),FallingEdge
(fallende Flanke) oderAnyEdge
(steigende und fallende Flanke).Über die REST-API kann dieser Parameter wie folgt gesetzt werden.
PUT http://<host>/api/v2/pipelines/0/nodes/rc_camera/services/parameters?trigger_activation=<value>
PUT http://<host>/api/v1/nodes/rc_camera/parameters?trigger_activation=<value>
fps
(Bildwiederholrate (Hz))¶
Dieser Wert bezeichnet die Bildwiederholrate der Kamera in Bildern pro Sekunde und begrenzt zugleich die Frequenz, mit der Tiefenbilder berechnet werden können. Die Bildwiederholrate entspricht auch der Frequenz, mit welcher der rc_visard NG Bilder über GigE Vision bereitstellt. Wird diese Frequenz verringert, reduziert sich auch die zur Übertragung der Bilder benötigte Bandbreite des Netzwerks.
Über die REST-API kann dieser Parameter wie folgt gesetzt werden.
PUT http://<host>/api/v2/pipelines/<0,1,2,3>/nodes/rc_camera/parameters?fps=<value>PUT http://<host>/api/v1/nodes/rc_camera/parameters?fps=<value>
gamma
(Gamma)¶
Der Gammawert bestimmt, wie das gemessene Licht auf die Helligkeit eines Pixels abgebildet wird. Ein Gammawert von 1 entspricht einem linearen Zusammenhang. Kleinere Gammawerte lassen dunkle Bildbereiche heller erscheinen. Ein Wert um 0.5 entspricht der menschlichen Wahrnehmung.
Über die REST-API kann dieser Parameter wie folgt gesetzt werden.
PUT http://<host>/api/v2/pipelines/<0,1,2,3>/nodes/rc_camera/parameters?gamma=<value>PUT http://<host>/api/v1/nodes/rc_camera/parameters?gamma=<value>
contrast_mode
(Kontrastmodus)¶
Der Kontrastmodus kann auf „Linear“ (Linear) oder „SCurve“ (S-Curve) eingestellt werden und bestimmt, wie die Bildintensitätswerte skaliert werden, wenn der Kontrast angepasst wird. Im Modus
Linear
verwendet die Kamera eine lineare Funktion zur Anpassung des Kontrasts. Durch Erhöhen oder Verringern des Kontrasts wird der Gradient der linearen Funktion erhöht oder verringert. Wenn der Kontrast erhöht wird, erscheinen die dunkelsten und hellsten Bereiche des Bildes vollständig schwarz oder vollständig weiß, die anderen Bereiche erscheinen jedoch definierter. Eine Verringerung des Kontrasts hat den gegenteiligen Effekt.Im ModusSCurve
nutzt die Kamera eine S-Kurven-Funktion zur Anpassung des Kontrasts. Durch Erhöhen des Kontrasts werden dunkle Pixel abgedunkelt und helle Pixel aufgehellt, der Dynamikumfang des Bildes bleibt jedoch erhalten.Über die REST-API kann dieser Parameter wie folgt gesetzt werden.
PUT http://<host>/api/v2/pipelines/<0,1,2,3>/nodes/rc_camera/parameters?contrast_mode=<value>PUT http://<host>/api/v1/nodes/rc_camera/parameters?contrast_mode=<value>
contrast
(Kontrast)¶
Durch Anpassen des Kontrasts wird der Unterschied zwischen hellen und dunklen Bereichen im Bild erhöht oder verringert. Die Art und Weise, wie sich die hellen und dunklen Bereiche beim Anpassen des Kontrasts ändern, hängt vom ausgewählten Kontrastmodus (
contrast_mode
) ab.Über die REST-API kann dieser Parameter wie folgt gesetzt werden.
PUT http://<host>/api/v2/pipelines/<0,1,2,3>/nodes/rc_camera/parameters?contrast=<value>PUT http://<host>/api/v1/nodes/rc_camera/parameters?contrast=<value>
exp_control
(Belichtung Auto oder Manual)¶
Die Belichtungsregelung kann auf Auto oder Manual gesetzt werden. Dies ersetzt den veralteten exp_auto Parameter.
Auto: Dies ist der Standard Modus der die die Belichtungszeit und Verstärkung automatisch anpasst, um Unter- und Überbelichtung zu vermeiden. Wenn die Automatik abgeschaltet wird, werden exp_value und gain_value auf die letzten von der Automatik ermittelten Werte für Belichtungszeit und Verstärkung gesetzt.
Manual: Im manuellen Belichtungsmodus werden die Belichtungszeit und die Verstärkung konstant gehalten unabhängig von der resultierenden Bildhelligkeit.
Über die REST-API kann dieser Parameter wie folgt gesetzt werden.
PUT http://<host>/api/v2/pipelines/<0,1,2,3>/nodes/rc_camera/parameters?exp_control=<value>PUT http://<host>/api/v1/nodes/rc_camera/parameters?exp_control=<value>
exp_auto_mode
(Modus Belichtungszeitautomatik)¶
Der Modus für automatische Belichtung kann auf Normal, Out1High oder AdaptiveOut1 gesetzt werden. Diese Modi sind nur relevant, wenn der rc_visard NG mit einer externen Lichtquelle oder einem Projektor betrieben wird, der an den GPIO-Ausgang 1 der Kamera angeschlossen ist. Dieser Ausgang kann durch das IOControl-Modul (IOControl und Projektor-Kontrolle) gesteuert werden.
Normal: Alle Bilder werden für die Regelung der Belichtungszeit in Betracht gezogen, außer wenn der IOControl-Modus für den GPIO-Ausgang 1 ExposureAlternateActive ist: Dann werden nur Bilder berücksichtigt, bei denen GPIO-Ausgang 1 HIGH ist, da diese Bilder heller sein können, falls dieser GPIO-Ausgang benutzt wird um einen externen Projektor auszulösen.
Out1High: Die Belichtungszeit wird nur anhand der Bilder mit GPIO-Ausgang 1 HIGH angepasst. Bilder bei denen GPIO-Ausgang 1 LOW ist, werden für die Belichtungszeitregelung nicht berücksichtigt. Das bedeutet, die Belichtungszeit ändert sich nicht, solange nur Bilder mit GPIO-Ausgang 1 LOW aufgenommen werden. Dieser Modus wird für die Benutzung mit dem Single+Out1 Tiefenbild Aufnahmemodus (siehe Stereo Matching Parameters und externem Projektor empfohlen, wenn die Helligkeit der Szene nur zu den Zeitpunkten berücksichtigt werden soll, wenn GPIO-Ausgang 1 HIGH ist. Das ist zum Beispiel der Fall, wenn kurz vor einer Objekterkennung ein heller Teil des Roboters durch das Bild fährt, der die Belichtungseinstellungen jedoch nicht beeinflussen soll.
AdaptiveOut1: Dieser Modus nutzt alle Kamerabilder und speichert die Differenz der Belichtung zwischen Bildern mit GPIO Ausgang 1 HIGH und LOW. Während der IOControl-Modus für GPIO-Ausgang 1 LOW ist, werden die Bilder um diese Differenz unterbelichtet, um eine Überbelichtung zu verhindern, sobald der externe Projektor über GPIO-Ausgang 1 ausgelöst wird. Die Differenz der Belichtung wird als Out1 Reduktion unter den Livebildern angezeigt. Dieser Modus wird empfohlen, wenn im Stereo-Matching-Modul der Parameter
acquisition_mode
aufSingleFrameOut1
(Einzelbild+Out1) gesetzt ist (Parameter des Stereo-Matching-Moduls), und ein externer Projektor an den GPIO-Ausgang 1 angeschlossen ist, und wenn die Helligkeit der Szene zu jeder Zeit zur Belichtungszeitregelung berücksichtigt werden soll.Das ist zum Beispiel in Anwendungen mit veränderlichen äußeren Lichtbedingungen der Fall.Über die REST-API kann dieser Parameter wie folgt gesetzt werden.
PUT http://<host>/api/v2/pipelines/<0,1,2,3>/nodes/rc_camera/parameters?exp_auto_mode=<value>PUT http://<host>/api/v1/nodes/rc_camera/parameters?exp_auto_mode=<value>
exp_max
(Maximale Belichtungszeit)¶
Dieser Wert gibt die maximale Belichtungszeit im automatischen Modus in Sekunden an. Die tatsächliche Belichtungszeit wird automatisch angepasst, sodass das Bild korrekt belichtet wird. Sind die Bilder trotz maximaler Belichtungszeit noch immer unterbelichtet, erhöht der rc_visard NG schrittweise die Verstärkung, um die Helligkeit der Bilder zu erhöhen. Es ist sinnvoll, die Belichtungszeit zu begrenzen, um die bei schnellen Bewegungen auftretende Bildunschärfe zu vermeiden oder zu verringern. Jedoch führt eine höhere Verstärkung auch zu mehr Bildrauschen. Welcher Kompromiss der beste ist, hängt immer auch von der Anwendung ab.
Über die REST-API kann dieser Parameter wie folgt gesetzt werden.
PUT http://<host>/api/v2/pipelines/<0,1,2,3>/nodes/rc_camera/parameters?exp_max=<value>PUT http://<host>/api/v1/nodes/rc_camera/parameters?exp_max=<value>
exp_auto_average_max
(Maximale Helligkeit) und exp_auto_average_min
(Minimale Helligkeit)¶
Die automatische Belichtungszeitsteuerung versucht die Belichtungszeit und den Verstärkungsfaktor so einzustellen, dass die mittlere Bildhelligkeit im Bild oder im Bereich zur Regelung zwischen der maximalen und minimalen Helligkeit liegt. Die maximale Helligkeit wird benutzt, wenn keine Bildteile in der Sättigung sind, d.h. keine Überbelichtung durch helle Oberflächen oder Reflexionen vorhanden sind. Falls Sättigungen auftreten, werden die Belichtungszeit und der Verstärkungsfaktor verringert, aber nur bis zur eingestellten minimalen Helligkeit.
Der Parameter für die maximale Helligkeit hat Vorrang über den Parameter der minimalen Helligkeit. Falls die minimale Helligkeit größer als die maximale ist, versucht die automatische Belichtungszeitsteuerung die mittlere Bildhelligkeit auf die maximale Helligkeit zu setzen.
Die aktuelle Helligkeit wird in der Statuszeile unter den Bildern angezeigt.
Über die REST-API kann dieser Parameter wie folgt gesetzt werden.
PUT http://<host>/api/v2/pipelines/<0,1,2,3>/nodes/rc_camera/parameters?<exp_auto_average_max|exp_auto_average_min>=<value>PUT http://<host>/api/v1/nodes/rc_camera/parameters?<exp_auto_average_max|exp_auto_average_min>=<value>
exp_offset_x
, exp_offset_y
, exp_width
, exp_height
(Bereich zur Regelung)¶
Diese Werte definieren eine rechteckige Region im linken rektifizierten Bild, um den von der automatischen Belichtung überwachten Bereich zu limitieren. Die Belichtungszeit und der Verstärkungsfaktor werden so gewählt, dass die definierte Region optimal belichtet wird. Dies kann zu Über- oder Unterbelichtung in anderen Bildbereichen führen. Falls die Breite oder Höhe auf 0 gesetzt werden, dann wird das gesamte linke und rechte Bild von der automatischen Belichtungsfunktion berücksichtigt. Dies ist die Standardeinstellung.
Die Region wird in der Web GUI mit einem Rechteck im linken rektifizierten Bild visualisiert. Sie kann über Slider oder direkt im Bild mithilfe der Schaltfläche
Bereich im Bild auswählen
verändert werden.Über die REST-API kann dieser Parameter wie folgt gesetzt werden.
PUT http://<host>/api/v2/pipelines/<0,1,2,3>/nodes/rc_camera/parameters?<exp_offset_x|exp_offset_y|exp_width|exp_height>=<value>PUT http://<host>/api/v1/nodes/rc_camera/parameters?<exp_offset_x|exp_offset_y|exp_width|exp_height>=<value>
exp_value
(Belichtungszeit)¶
Dieser Wert gibt die Belichtungszeit im manuellen Modus in Sekunden an. Diese Belichtungszeit wird konstant gehalten, auch wenn die Bilder unterbelichtet sind.
Über die REST-API kann dieser Parameter wie folgt gesetzt werden.
PUT http://<host>/api/v2/pipelines/<0,1,2,3>/nodes/rc_camera/parameters?exp_value=<value>PUT http://<host>/api/v1/nodes/rc_camera/parameters?exp_value=<value>
gain_value
(Verstärkungsfaktor (dB))¶
Dieser Wert gibt den Verstärkungsfaktor im manuellen Modus in Dezibel an. Höhere Verstärkungswerte reduzieren die Belichtungszeit, führen aber zu Rauschen.
Über die REST-API kann dieser Parameter wie folgt gesetzt werden.
PUT http://<host>/api/v2/pipelines/<0,1,2,3>/nodes/rc_camera/parameters?gain_value=<value>PUT http://<host>/api/v1/nodes/rc_camera/parameters?gain_value=<value>
brightness
(Helligkeit)¶
Das Anpassen der Helligkeit hellt das gesamte Bild auf oder verdunkelt es.
Über die REST-API kann dieser Parameter wie folgt gesetzt werden.
PUT http://<host>/api/v2/pipelines/<0,1,2,3>/nodes/rc_camera/parameters?brightness=<value>PUT http://<host>/api/v1/nodes/rc_camera/parameters?brightness=<value>
wb_auto
(Weißabgleich Auto oder Manuell, nur verfügbar für Farbkameras)¶
Dieser Wert kann auf true gesetzt werden, um den automatischen Weißabgleich anzuschalten. Bei false kann das Verhältnis der Farben manuell mit
wb_ratio_red
undwb_ratio_blue
gesetzt werden.wb_ratio_red
undwb_ratio_blue
werden auf die letzten von der Automatik ermittelten Werte gesetzt, wenn diese abgeschaltet wird. Der Weißabgleich ist bei monochromen Kameras ohne Funktion und wird in diesem Fall in der Web GUI nicht angezeigt.Über die REST-API kann dieser Parameter wie folgt gesetzt werden.
PUT http://<host>/api/v2/pipelines/<0,1,2,3>/nodes/rc_camera/parameters?wb_auto=<value>PUT http://<host>/api/v1/nodes/rc_camera/parameters?wb_auto=<value>
wb_ratio_blue
, wb_ratio_red
and wb_ratio_green
(Blauanteil, Rotanteil und Grünanteil, nur verfügbar für Farbkameras)¶
Mit diesen Werten können der Blau-, Rot- und Grünanteil für einen manuellen Weißabgleich gesetzt werden. Der Weißabgleich ist bei monochromen Kameras ohne Funktion und wird in diesem Fall in der Web GUI nicht angezeigt.
Über die REST-API kann dieser Parameter wie folgt gesetzt werden.
PUT http://<host>/api/v2/pipelines/<0,1,2,3>/nodes/rc_camera/parameters?<wb_ratio_blue|wb_ratio_red|wb_ratio_green>=<value>
PUT http://<host>/api/v1/nodes/rc_camera/parameters?<wb_ratio_blue|wb_ratio_red|wb_ratio_green>=<value>
light_source_preset
(Voreinstellung Lichtquelle, nur verfügbar für Farbkameras)¶
Mit dem Parameter
light_source_preset
können Farbverschiebungen korrigiert werden, die durch bestimmte Lichtquellen verursacht werden. Abhängig von der Farbtemperatur kann das für die Bildaufnahme verwendete Licht Farbverschiebungen im Bild verursachen. Diese Farbverschiebungen können durch Auswahl der entsprechenden Voreinstellung für die Lichtquelle korrigiert werden. Mögliche Werte sind: Off, Tungsten, Daylight5000K, Daylight6500K und FactoryLED6000K.Über die REST-API kann dieser Parameter wie folgt gesetzt werden.
PUT http://<host>/api/v2/pipelines/<0,1,2,3>/nodes/rc_camera/parameters?light_source_preset=<value>PUT http://<host>/api/v1/nodes/rc_camera/parameters?light_source_preset=<value>
saturation
(Sättigung, nur verfügbar für Farbkameras)¶
Durch Anpassen der Sättigung ändert sich die Buntheit (Intensität) der Farben. Eine höhere Sättigung erleichtert beispielsweise die Unterscheidung von Farben.
Über die REST-API kann dieser Parameter wie folgt gesetzt werden.
PUT http://<host>/api/v2/pipelines/<0,1,2,3>/nodes/rc_camera/parameters?saturation=<value>PUT http://<host>/api/v1/nodes/rc_camera/parameters?saturation=<value>
Die gleichen Parameter sind – mit leicht abweichenden Namen und teilweise mit anderen Einheiten oder Datentypen – auch über die GenICam-Schnittstelle verfügbar (siehe GigE Vision 2.0/GenICam-Schnittstelle).
Statuswerte¶
Das rc_camera
-Modul meldet folgende Statuswerte für eine Pipeline vom Typ stereo_ace
:
Services¶
Das rc_camera
-Modul bietet folgende Services für eine Pipeline vom Typ stereo_ace
.
acquisition_trigger
¶
triggert eine Bildaufnahme, wenn der Aufnahmemodus auf
Trigger
und die Triggerquelle aufSoftware
gesetzt sind.Details
Dieser Service kann wie folgt aufgerufen werden.
PUT http://<host>/api/v2/pipelines/0/nodes/rc_camera/services/acquisition_triggerPUT http://<host>/api/v1/nodes/rc_camera/services/acquisition_triggerDieser Service hat keine Argumente.Die Definition der Response mit jeweiligen Datentypen ist:
{ "name": "acquisition_trigger", "response": { "return_code": { "message": "string", "value": "int16" } } }
reset_defaults
¶
stellt die Werkseinstellungen der Parameter dieses Moduls wieder her und wendet sie an („factory reset“).
Details
Dieser Service kann wie folgt aufgerufen werden.
PUT http://<host>/api/v2/pipelines/0/nodes/rc_camera/services/reset_defaultsPUT http://<host>/api/v1/nodes/rc_camera/services/reset_defaultsDieser Service hat keine Argumente.Die Definition der Response mit jeweiligen Datentypen ist:
{ "name": "reset_defaults", "response": { "return_code": { "message": "string", "value": "int16" } } }