receive_regionT_receive_regionReceiveRegionReceiveRegion (Operator)
Name
receive_regionT_receive_regionReceiveRegionReceiveRegion
— Receive regions over a socket connection.
Signature
Herror T_receive_region(Hobject* Region, const Htuple Socket)
Description
receive_regionreceive_regionReceiveRegionReceiveRegionReceiveRegion
reads a region object that was sent over the
socket connection determined by SocketSocketSocketSocketsocket
by another HALCON
process using the operator send_regionsend_regionSendRegionSendRegionSendRegion
. If no regions have
been sent, the HALCON process calling receive_regionreceive_regionReceiveRegionReceiveRegionReceiveRegion
blocks
until enough data arrives. For a detailed example, see
open_socket_acceptopen_socket_acceptOpenSocketAcceptOpenSocketAcceptOpenSocketAccept
.
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
RegionRegionRegionRegionregion
(output_object) region(-array) →
objectHRegionHRegionHobject *
Received regions.
SocketSocketSocketSocketsocket
(input_control) socket →
HSocket, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Socket number.
Possible Predecessors
open_socket_connectopen_socket_connectOpenSocketConnectOpenSocketConnectOpenSocketConnect
,
socket_accept_connectsocket_accept_connectSocketAcceptConnectSocketAcceptConnectSocketAcceptConnect
,
get_socket_paramget_socket_paramGetSocketParamGetSocketParamGetSocketParam
,
set_socket_paramset_socket_paramSetSocketParamSetSocketParamSetSocketParam
See also
send_regionsend_regionSendRegionSendRegionSendRegion
,
send_imagesend_imageSendImageSendImageSendImage
,
receive_imagereceive_imageReceiveImageReceiveImageReceiveImage
,
send_tuplesend_tupleSendTupleSendTupleSendTuple
,
receive_tuplereceive_tupleReceiveTupleReceiveTupleReceiveTuple
,
get_next_socket_data_typeget_next_socket_data_typeGetNextSocketDataTypeGetNextSocketDataTypeGetNextSocketDataType
Module
Foundation