Operator Reference

HALCON Operator Reference / System / Sockets
ClassesClasses | | Operators

receive_imageT_receive_imageReceiveImageReceiveImagereceive_image (Operator)

receive_imageT_receive_imageReceiveImageReceiveImagereceive_image — Receive an image over a socket connection.

Signature

receive_image( : Image : Socket : )

Herror T_receive_image(Hobject* Image, const Htuple Socket)

void ReceiveImage(HObject* Image, const HTuple& Socket)

HImage HSocket::ReceiveImage() const

void HImage::ReceiveImage(const HSocket& Socket)

static void HOperatorSet.ReceiveImage(out HObject image, HTuple socket)

HImage HSocket.ReceiveImage()

void HImage.ReceiveImage(HSocket socket)

def receive_image(socket: HHandle) -> HObject

Description

receive_imagereceive_imageReceiveImageReceiveImagereceive_image reads an image object that was sent over the socket connection determined by SocketSocketSocketsocketsocket by another HALCON process using the operator send_imagesend_imageSendImageSendImagesend_image. If no image has been sent, the HALCON process calling receive_imagereceive_imageReceiveImageReceiveImagereceive_image blocks until enough data arrives. For a detailed example, see open_socket_acceptopen_socket_acceptOpenSocketAcceptOpenSocketAcceptopen_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

ImageImageImageimageimage (output_object)  image(-array) → objectHImageHObjectHObjectHobject * (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Received image.

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_imagesend_imageSendImageSendImagesend_image, send_regionsend_regionSendRegionSendRegionsend_region, receive_regionreceive_regionReceiveRegionReceiveRegionreceive_region, 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