Skip to content

receive_imageReceiveImageReceiveImagereceive_imageT_receive_image🔗

Short description🔗

receive_imageReceiveImageReceiveImagereceive_imageT_receive_image — Receive an image over a socket connection.

Signature🔗

receive_image( out image Image, socket Socket )void ReceiveImage( HObject* Image, const HTuple& Socket )static void HOperatorSet.ReceiveImage( out HObject image, HTuple socket )def receive_image( socket: HHandle ) -> HObject

Herror T_receive_image( Hobject* Image, const Htuple Socket )

HImage HSocket::ReceiveImage( ) const

void HImage::ReceiveImage( const HSocket& Socket )

HImage HSocket.ReceiveImage( )

void HImage.ReceiveImage( HSocket socket )

Description🔗

receive_imageReceiveImage reads an image object that was sent over the socket connection determined by Socketsocketsocket by another HALCON process using the operator send_imageSendImage. If no image has been sent, the HALCON process calling receive_imageReceiveImage blocks until enough data arrives. For a detailed example, see open_socket_acceptOpenSocketAccept.

Attention🔗

‘int8’ images can be received by 64 bit systems only!

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🔗

Imageimageimage (output_object) image(-array) → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)HObject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)HImage (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)HObject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)Hobject * (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Received image.

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_imageSendImage, send_regionSendRegion, receive_regionReceiveRegion, send_tupleSendTuple, receive_tupleReceiveTuple, get_next_socket_data_typeGetNextSocketDataType

Module🔗

Foundation