append_channelAppendChannelAppendChannelappend_channelappend_channel
Short description
append_channelAppendChannelAppendChannelappend_channelappend_channel — Append additional matrices (channels) to the image.
Signature
append_channel( image MultiChannelImage, image Image, out image ImageExtended )void AppendChannel( const HObject& MultiChannelImage, const HObject& Image, HObject* ImageExtended )static void HOperatorSet.AppendChannel( HObject multiChannelImage, HObject image, out HObject imageExtended )def append_channel( multi_channel_image: HObject, image: HObject ) -> HObject
Herror append_channel( const Hobject MultiChannelImage, const Hobject Image, Hobject* ImageExtended )
Herror T_append_channel( const Hobject MultiChannelImage, const Hobject Image, Hobject* ImageExtended )
HImage HImage::AppendChannel( const HImage& Image ) const
HImage HImage.AppendChannel( HImage image )
Description
The operator append_channelAppendChannel appends the matrices of the
image Imageimageimage to the matrices of
MultiChannelImagemultiChannelImagemulti_channel_image. The result is an image containing as
many matrices (channels) as MultiChannelImagemultiChannelImagemulti_channel_image and
Imageimageimage combined. The definition domain of the output
image is calculated as the intersection of the definition domains of both
input images.
MultiChannelImagemultiChannelImagemulti_channel_image may be a region only that is then interpreted as
the definition domain of an image without channels.
No new storage is allocated for the multi-channel image.
Instead, the created multi-channel image contains references to the existing
input images.
Execution information
-
Supports objects on compute devices.
-
Multithreading type: reentrant (runs in parallel with non-exclusive operators).
-
Multithreading scope: global (may be called from any thread).
-
Processed without parallelization.
Parameters
MultiChannelImagemultiChannelImagemulti_channel_image (input_object) (multichannel-)image → 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)
Multi-channel image.
Imageimageimage (input_object) (multichannel-)image → 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 appended.
ImageExtendedimageExtendedimage_extended (output_object) multichannel-image → 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 appended by Imageimageimage.
Combinations with other operators
Combinations
Possible successors
disp_imageDispImage
Alternatives
compose2Compose2, compose3Compose3, compose4Compose4, compose5Compose5
Module
Foundation