fetch_from_image_source — Holen von Bildern und zugehörigen Metadaten aus der Pufferwarteschlange einer
Bildquelle.
fetch_from_image_source( : Images : ImageSourceHandle : Data)
fetch_from_image_source holt die Bilder Images aus der
Pufferwarteschlange der in dem Handle ImageSourceHandle
definierten Bildquelle. Für konventionelle Geräte ist Images
üblicherweise ein einzelnes Bild, wohingegen komplexere Sensoren, wie z.B.
3D Sensoren, mehrere Bilder gleichzeitig liefern können.
Zusätzlich werden in Data Metainformationen zurückgegeben.
fetch_from_image_source versucht Bilder aus der Pufferwarteschlange
der Bildquelle zu ziehen und für die Anwendung bereitzustellen. Falls die
Pufferwarteschlange leer ist wartet der Operator darauf, dass ein Bild
in der Pufferwarteschlange ankommt bis der eingestellte Timeout erreicht
wird (siehe 'fetch_timeout' in get_image_source_param).
Sind bereits Bilder in der Pufferwarteschlange angekommen bevor
fetch_from_image_source ausgeführt wurde, wird sofort ein Puffer
aus der Warteschlange gezogen und das enthaltene Bild bereitgestellt.
Die Laufzeit des Operators hängt von verschiedenen Faktoren ab, wie
beispielsweise dem Zustand der Pufferwarteschlange und der aktuellen
Konfiguration des Bildquellen-Gerätes.
Siehe 'num_buffers' in get_image_source_param für
Informationen zur Anpassung der Kapazität der Pufferwarteschlange.
Die zurückgegebenen Metainformationen in Data enthalten, soweit
vom entsprechenden Plugin unterstützt, die folgenden Parameter:
Linear ansteigender Bildzähler, der zusammen mit den Bilddaten übertragen wird. Unregelmäßigkeiten in der Zählsequenz weisen auf verloren gegangene Puffer hin.
Status, der Aufschluss über die Vollständigkeit der aufgenommenen Daten gibt. Unvollständige Daten können auf Probleme in der Datenübertragung hinweisen.
Werteliste: 0 (vollständig), 1 (unvollständig).
Zeitstempel [ns] des Bildes, der vom Gerät zusammen mit den Bilddaten übertragen wird. Der Parameter entspricht dem Wert der internen Uhr des Gerätes zur Zeit der Aufnahme.
Das Gerät und ein zugehöriger Stream, die in ImageSourceHandle
definiert sind, müssen beim Aufruf von fetch_from_image_source
verbunden und gestartet sein. Siehe connect_image_source für
Informationen zum Verbinden und start_image_source zum Starten
einer Bildquelle.
Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.
Images (output_object) image(-array) → object (byte / int1 / int2 / uint2 / int4 / int8 / real)
Zurückgegebene Bilder.
ImageSourceHandle (input_control) image_source → (handle)
Handle der Bildquelle, auf deren Pufferwarteschlange zugegriffen werden soll.
Data (output_control) dict → (handle)
Metainformationen über die Bilder.
Sind die Parameterwerte korrekt, gibt fetch_from_image_source
den Wert 2 (
H_MSG_TRUE)
zurück.
Andernfalls wird eine Fehlerbehandlung durchgeführt.
Foundation