Skip to content

receive_regionReceiveRegionReceiveRegionreceive_regionT_receive_region🔗

Short description🔗

receive_regionReceiveRegionReceiveRegionreceive_regionT_receive_region — Receive regions over a socket connection.

Signature🔗

receive_region( out region Region, socket Socket )void ReceiveRegion( HObject* Region, const HTuple& Socket )static void HOperatorSet.ReceiveRegion( out HObject region, HTuple socket )def receive_region( socket: HHandle ) -> HObject

Herror T_receive_region( Hobject* Region, const Htuple Socket )

HRegion HSocket::ReceiveRegion( ) const

void HRegion::ReceiveRegion( const HSocket& Socket )

HRegion HSocket.ReceiveRegion( )

void HRegion.ReceiveRegion( HSocket socket )

Description🔗

receive_regionReceiveRegion reads a region object that was sent over the socket connection determined by Socketsocketsocket by another HALCON process using the operator send_regionSendRegion. If no regions have been sent, the HALCON process calling receive_regionReceiveRegion blocks until enough data arrives. For a detailed example, see open_socket_acceptOpenSocketAccept.

Execution information🔗

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🔗

Regionregionregion (output_object) region(-array) → objectHObjectHRegionHObjectHobject *

Received regions.

Socketsocketsocket (input_control) socket → (handle)HTuple (HHandle)HSocket, HTuple (IntPtr)HHandleHtuple (handle)

Socket number.

Combinations with other operators🔗

Combinations

Possible predecessors

open_socket_connectOpenSocketConnect, socket_accept_connectSocketAcceptConnect, get_socket_paramGetSocketParam, set_socket_paramSetSocketParam

See also

send_regionSendRegion, send_imageSendImage, receive_imageReceiveImage, send_tupleSendTuple, receive_tupleReceiveTuple, get_next_socket_data_typeGetNextSocketDataType

Module🔗

Foundation