fwrite_serialized_itemT_fwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item (算子名称)

名称

fwrite_serialized_itemT_fwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item — 写入一个序列化项目到文件。

参数签名

描述

fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item writes a serialized item to the output file with the handle FileHandleFileHandleFileHandleFileHandlefileHandlefile_handle. The serialized item is defined by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle. The file can be opened by 该算子 open_fileopen_fileOpenFileOpenFileOpenFileopen_file. Note that the file must be open in binary format. For writing more than one item in one file, 该算子 fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item must be called several times. A serialized item can be read with fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItemfread_serialized_item.

Basics of the serialization and deserialization

For writing or sending iconic objects, data, or models to a file or to another HALCON process over a socket connection, first, the iconic objects, data, or models must be converted to serialized items. For this purpose, a lot of operators are available. E.g., the operator serialize_shape_modelserialize_shape_modelSerializeShapeModelSerializeShapeModelSerializeShapeModelserialize_shape_model performs the serialization for the shape model . After this, a serialized item can be written by fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item in a file or can be transferred by send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemSendSerializedItemsend_serialized_item to another HALCON process over a socket connection.

To deserialize a serialized item, first a serialized item is read from a file (see fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItemfread_serialized_item) or is received over the socket connection from another HALCON process (see receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item). There are also operators to convert the serialized item to the original format, i.e., to the iconic object, the data, or the model. These operators deserialize the iconic object, the data, or the model. E.g., 该算子 deserialize_shape_modeldeserialize_shape_modelDeserializeShapeModelDeserializeShapeModelDeserializeShapeModeldeserialize_shape_model deserializes the item for a serialized shape model .

运行信息

• 多线程类型:可重入(与非独占操作符并行运行)。
• 多线程作用域:全局(可以从任何线程调用)。
• 未经并行化处理。

参数表

结果

如果参数均有效，算子 fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item 返回值 2 ( H_MSG_TRUE) . If necessary, an exception is raised.

可能的前置算子

open_fileopen_fileOpenFileOpenFileOpenFileopen_file, serialize_shape_modelserialize_shape_modelSerializeShapeModelSerializeShapeModelSerializeShapeModelserialize_shape_model, serialize_ncc_modelserialize_ncc_modelSerializeNccModelSerializeNccModelSerializeNccModelserialize_ncc_model

可能的后置算子

close_fileclose_fileCloseFileCloseFileCloseFileclose_file, fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItemfread_serialized_item

模块

Foundation