receive_imageT_receive_imageReceiveImageReceiveImagereceive_image (Operator)
Name
receive_imageT_receive_imageReceiveImageReceiveImagereceive_image — Receive an image over a socket connection.
Signature
Herror T_receive_image(Hobject* Image, const Htuple Socket)
def receive_image(socket: HHandle) -> HObject
Description
receive_imagereceive_imageReceiveImageReceiveImageReceiveImagereceive_image reads an image object that was sent over the
socket connection determined by SocketSocketSocketSocketsocketsocket by another HALCON
process using the operator send_imagesend_imageSendImageSendImageSendImagesend_image. If no image has been
sent, the HALCON process calling receive_imagereceive_imageReceiveImageReceiveImageReceiveImagereceive_image blocks until
enough data arrives. For a detailed example, see
open_socket_acceptopen_socket_acceptOpenSocketAcceptOpenSocketAcceptOpenSocketAcceptopen_socket_accept.
Attention
'int8' images can be received by 64 bit systems only!
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
ImageImageImageImageimageimage (output_object) image(-array) → objectHImageHObjectHImageHobject * (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)
Received image.
SocketSocketSocketSocketsocketsocket (input_control) socket → HSocket, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Socket number.
Possible Predecessors
open_socket_connectopen_socket_connectOpenSocketConnectOpenSocketConnectOpenSocketConnectopen_socket_connect,
socket_accept_connectsocket_accept_connectSocketAcceptConnectSocketAcceptConnectSocketAcceptConnectsocket_accept_connect,
get_socket_paramget_socket_paramGetSocketParamGetSocketParamGetSocketParamget_socket_param,
set_socket_paramset_socket_paramSetSocketParamSetSocketParamSetSocketParamset_socket_param
See also
send_imagesend_imageSendImageSendImageSendImagesend_image,
send_regionsend_regionSendRegionSendRegionSendRegionsend_region,
receive_regionreceive_regionReceiveRegionReceiveRegionReceiveRegionreceive_region,
send_tuplesend_tupleSendTupleSendTupleSendTuplesend_tuple,
receive_tuplereceive_tupleReceiveTupleReceiveTupleReceiveTuplereceive_tuple,
get_next_socket_data_typeget_next_socket_data_typeGetNextSocketDataTypeGetNextSocketDataTypeGetNextSocketDataTypeget_next_socket_data_type
Module
Foundation