Operator Reference

HALCON Operator Reference / System / Sockets

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

receive_regionT_receive_regionReceiveRegionReceiveRegionreceive_region (Operator)

receive_regionT_receive_regionReceiveRegionReceiveRegionreceive_region — Receive regions over a socket connection.

Signature

receive_region( : Region : Socket : )

Herror T_receive_region(Hobject* Region, const Htuple Socket)

void ReceiveRegion(HObject* Region, const HTuple& Socket)

HRegion HSocket::ReceiveRegion() const

void HRegion::ReceiveRegion(const HSocket& Socket)

static void HOperatorSet.ReceiveRegion(out HObject region, HTuple socket)

HRegion HSocket.ReceiveRegion()

void HRegion.ReceiveRegion(HSocket socket)

def receive_region(socket: HHandle) -> HObject

Description

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

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) → objectHRegionHObjectHObjectHobject *

Received regions.

SocketSocketSocketsocketsocket (input_control)  socket → HSocket, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Socket number.

Possible Predecessors

open_socket_connectopen_socket_connectOpenSocketConnectOpenSocketConnectopen_socket_connect, socket_accept_connectsocket_accept_connectSocketAcceptConnectSocketAcceptConnectsocket_accept_connect, get_socket_paramget_socket_paramGetSocketParamGetSocketParamget_socket_param, set_socket_paramset_socket_paramSetSocketParamSetSocketParamset_socket_param

See also

send_regionsend_regionSendRegionSendRegionsend_region, send_imagesend_imageSendImageSendImagesend_image, receive_imagereceive_imageReceiveImageReceiveImagereceive_image, send_tuplesend_tupleSendTupleSendTuplesend_tuple, receive_tuplereceive_tupleReceiveTupleReceiveTuplereceive_tuple, get_next_socket_data_typeget_next_socket_data_typeGetNextSocketDataTypeGetNextSocketDataTypeget_next_socket_data_type

Module

Foundation

---

ClassesClasses | | Operators