Skip to content

copy_imageCopyImageCopyImagecopy_imagecopy_image🔗

Short description🔗

copy_imageCopyImageCopyImagecopy_imagecopy_image — Copy an image and allocate new memory for it.

Signature🔗

copy_image( image Image, out image DupImage )void CopyImage( const HObject& Image, HObject* DupImage )static void HOperatorSet.CopyImage( HObject image, out HObject dupImage )def copy_image( image: HObject ) -> HObject

Herror copy_image( const Hobject Image, Hobject* DupImage )

Herror T_copy_image( const Hobject Image, Hobject* DupImage )

HImage HImage::CopyImage( ) const

HImage HImage.CopyImage( )

Description🔗

copy_imageCopyImage copies the input image into a new image with the same domain as the input image. In contrast to HALCON operators such as copy_objCopyObj, physical copies of all channels are created. This can be used, for example, to modify the gray values of the new image (see get_image_pointer1GetImagePointer1).

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 (input_object) (multichannel-)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)

Image to be copied.

DupImagedupImagedup_image (output_object) (multichannel-)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)

Copied image.

Combinations with other operators🔗

Combinations

Possible predecessors

read_imageReadImage, gen_image_constGenImageConst

Possible successors

set_grayvalSetGrayval, get_image_pointer1GetImagePointer1

Alternatives

set_grayvalSetGrayval, paint_grayPaintGray, gen_image_constGenImageConst, gen_image_protoGenImageProto

See also

get_image_pointer1GetImagePointer1

Module🔗

Foundation