fwrite_serialized_itemT_fwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item (Operator)

Name

fwrite_serialized_itemT_fwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item — Schreiben eines serialisierten Elements in eine Datei.

Signatur

fwrite_serialized_item( : : FileHandle, SerializedItemHandle : )

Beschreibung

fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item schreibt ein serialisiertes Element in die Ausgabedatei mit dem Datei-Handle FileHandleFileHandleFileHandleFileHandlefileHandlefile_handle. Das serialisierte Element wird durch das Handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle übergeben. Mit dem Operator open_fileopen_fileOpenFileOpenFileOpenFileopen_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_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item mehrmals aufgerufen werden. Ein serialisiertes Element kann mit fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItemfread_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_modelserialize_shape_modelSerializeShapeModelSerializeShapeModelSerializeShapeModelserialize_shape_model, der die Serialisierung durchführt. Ein serialisiertes Element kann dann mit fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item in eine Datei geschrieben oder mit send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemSendSerializedItemsend_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_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItemfread_serialized_item) eingelesen oder über die Socket-Verbindung von einem anderen HALCON-Prozess empfangen (siehe receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItemreceive_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_modeldeserialize_shape_modelDeserializeShapeModelDeserializeShapeModelDeserializeShapeModeldeserialize_shape_model, 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

FileHandleFileHandleFileHandleFileHandlefileHandlefile_handle (input_control) file → (handle)

Datei-Handle.

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (input_control) serialized_item → (handle)

Handle des serialisierten Elements.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item den Wert TRUE. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

open_fileopen_fileOpenFileOpenFileOpenFileopen_file, serialize_shape_modelserialize_shape_modelSerializeShapeModelSerializeShapeModelSerializeShapeModelserialize_shape_model, serialize_ncc_modelserialize_ncc_modelSerializeNccModelSerializeNccModelSerializeNccModelserialize_ncc_model

Nachfolger

close_fileclose_fileCloseFileCloseFileCloseFileclose_file, fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItemfread_serialized_item

Modul

Foundation

Operatoren