fwrite_serialized_item
— Schreiben eines serialisierten Elements in eine Datei.
fwrite_serialized_item( : : FileHandle, SerializedItemHandle : )
fwrite_serialized_item
schreibt ein serialisiertes Element in
die Ausgabedatei mit dem Datei-Handle FileHandle
. Das
serialisierte Element wird durch das Handle
SerializedItemHandle
übergeben. Mit dem Operator
open_file
kann die Datei geöffnet werden. Zu beachten ist, dass sie
im Binärdateiformat geöffnet werden muss. Um mehrere serialisierte
Elemente in eine einzige Ausgabedatei zu schreiben, muss
fwrite_serialized_item
mehrmals aufgerufen werden. Ein
serialisiertes Element kann mit fread_serialized_item
wieder
aus der Datei eingelesen werden.
Grundlagen der Serialisierung und Deserialisierung
Um ikonische Objekte, Daten oder Modelle in einer Datei abspeichern
zu können oder zu einem anderen HALCON-Prozess über die
Socket-Verbindung schicken zu können müssen die ikonischen Objekte, Daten
oder Modelle zunächst in serialisierte Elemente überführt werden.
Zu diesem Zweck stehen eine Vielzahl Operatoren zur Verfügung.
Beispielsweise gibt es für ein Formmodell den Operator
serialize_shape_model
, der die Serialisierung durchführt.
Ein serialisiertes Element kann dann mit fwrite_serialized_item
in eine Datei geschrieben oder mit send_serialized_item
zu
einem anderen HALCON-Prozess über die Socket-Verbindung übertragen
werden.
Um ein serialisiertes Element zu deserialisieren wird zunächst ein
serialisiertes Element aus einer Datei (siehe
fread_serialized_item
) eingelesen oder über die
Socket-Verbindung von einem anderen HALCON-Prozess empfangen (siehe
receive_serialized_item
). Um
ein serialisiertes Element wieder in seine ursprüngliche Form, d.h.
in das ikonische Objekt, die Daten oder das Modell zu überführen,
gibt es ebenfalls Operatoren. Diese nehmen die Deserialisierung vor
und erzeugen automatisch das jeweilige ikonische Objekt, die Daten
oder das Modell. Beispielsweise gibt es für ein serialisiertes
Formmodell den Operator deserialize_shape_model
, der die
Deserialisierung durchführt.
FileHandle
(input_control) file →
(handle)
Datei-Handle.
SerializedItemHandle
(input_control) serialized_item →
(handle)
Handle des serialisierten Elements.
Sind die Parameterwerte korrekt, dann liefert
fwrite_serialized_item
den Wert 2 (H_MSG_TRUE).
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
open_file
,
serialize_shape_model
,
serialize_ncc_model
close_file
,
fread_serialized_item
Foundation