snap_from_image_source — Einziehen von Bildern und zugehörigen Metadaten von einer Bildquelle.
snap_from_image_source( : Images : ImageSourceHandle : Data)
snap_from_image_source löst aktiv den Einzug der Bilder
Images mit der im Handle ImageSourceHandle definierten
Bildquelle aus. 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.
Intern wird beim Aufruf von snap_from_image_source der Bildeinzug
gestartet, ein Bild eingezogen und die Aufnahme wieder beendet, wodurch
wieder alle Ressourcen freigegeben werden. Der Aufruf ist daher auf
den einfachen asynchronen Einzug eines Bildes ausgerichtet.
Siehe fetch_from_image_source für kontinuierlichen Bildeinzug.
Metainformationen werden, soweit vom entsprechenden Plugin unterstützt,
in Data zurückgegeben. Die bereitgestellten Parameter sind in
fetch_from_image_source beschrieben.
Das in ImageSourceHandle definierte Gerät muss beim Aufruf
von snap_from_image_source verbunden sein. Siehe
connect_image_source für Informationen zum Verbinden 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)
Eingezogene Bilder.
ImageSourceHandle (input_control) image_source → (handle)
Handle der Bildquelle, die die Bilder aufnimmt.
Data (output_control) dict → (handle)
Metainformationen über die Bilder.
Sind die Parameterwerte korrekt, gibt snap_from_image_source
den Wert 2 (
H_MSG_TRUE)
zurück.
Andernfalls wird eine Fehlerbehandlung durchgeführt.
connect_image_source,
set_image_source_param
Foundation