fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItem (Operator)

Name

fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItem — Schreiben eines serialisierten Elements in eine Datei.

Signatur

Beschreibung

fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem schreibt ein serialisiertes Element in die Ausgabedatei mit dem Datei-Handle FileHandleFileHandleFileHandleFileHandlefileHandle. Das serialisierte Element wird durch das Handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle übergeben. Mit dem Operator open_fileopen_fileOpenFileOpenFileOpenFile 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_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem mehrmals aufgerufen werden. Ein serialisiertes Element kann mit fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItem 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_modelserialize_shape_modelSerializeShapeModelSerializeShapeModelSerializeShapeModel, der die Serialisierung durchführt. Ein serialisiertes Element kann dann mit fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem in eine Datei geschrieben oder mit send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemSendSerializedItem 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_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItem) eingelesen oder über die Socket-Verbindung von einem anderen HALCON-Prozess empfangen (siehe receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItem). 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_modeldeserialize_shape_modelDeserializeShapeModelDeserializeShapeModelDeserializeShapeModel, der die Deserialisierung durchführt.

Ausführungsinformationen

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Wird ohne Parallelisierung verarbeitet.

Parameter

Ergebnis

Sind die Parameterwerte korrekt, dann liefert fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

open_fileopen_fileOpenFileOpenFileOpenFile, serialize_shape_modelserialize_shape_modelSerializeShapeModelSerializeShapeModelSerializeShapeModel, serialize_ncc_modelserialize_ncc_modelSerializeNccModelSerializeNccModelSerializeNccModel

Nachfolger

close_fileclose_fileCloseFileCloseFileCloseFile, fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItem

Modul

Foundation