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
-
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