tile_channelstile_channelstile_channelsTileChannelsTileChannels (Operator)

Name

tile_channelstile_channelstile_channelsTileChannelsTileChannels — Tile multiple images into a large image.

Signature

Description

tile_channelstile_channelstile_channelsTileChannelsTileChannels tiles an image consisting of multiple channels into a large single-channel image. The input image ImageImageImageImageimage contains Num images of the same size, which are stored in the individual channels. The output image TiledImageTiledImageTiledImageTiledImagetiledImage contains a single channel image, where the Num input channels have been tiled into NumColumnsNumColumnsNumColumnsNumColumnsnumColumns columns. In particular, this means that tile_channelstile_channelstile_channelsTileChannelsTileChannels cannot tile color images. For this purpose, tile_imagestile_imagestile_imagesTileImagesTileImages can be used. The parameter TileOrderTileOrderTileOrderTileOrdertileOrder determines the order in which the images are copied into the output in the cases in which this is not already determined by NumColumnsNumColumnsNumColumnsNumColumnsnumColumns (i.e., if NumColumnsNumColumnsNumColumnsNumColumnsnumColumns != 1 and NumColumnsNumColumnsNumColumnsNumColumnsnumColumns != Num). If TileOrderTileOrderTileOrderTileOrdertileOrder = 'horizontal'"horizontal""horizontal""horizontal""horizontal" the images are copied in the horizontal direction, i.e., the second channel of ImageImageImageImageimage will be to the right of the first channel. If TileOrderTileOrderTileOrderTileOrdertileOrder = 'vertical'"vertical""vertical""vertical""vertical" the images are copied in the vertical direction, i.e., the second channel of ImageImageImageImageimage will be below the first channel. The domain of TiledImageTiledImageTiledImageTiledImagetiledImage is obtained by copying the domain of ImageImageImageImageimage to the corresponding locations in the output image. If Num is not a multiple of NumColumnsNumColumnsNumColumnsNumColumnsnumColumns the output image will have undefined gray values in the lower right corner of the image. The output domain will reflect this.

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Automatically parallelized on tuple level.

Parameters

Example (HDevelop)

* Grab 5 single-channel images and stack them vertically.
gen_rectangle1 (Image, 0, 0, Height-1, Width-1)
for I := 1 to 5 by 1
    grab_image_async (ImageGrabbed, AcqHandle, -1)
    append_channel (Image, ImageGrabbed, Image)
endfor
tile_channels (Image, TiledImage, 1, 'vertical')

Result

tile_channelstile_channelstile_channelsTileChannelsTileChannels returns 2 (H_MSG_TRUE) if all parameters are correct and no error occurs during execution. If the input is empty the behavior can be set via set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

append_channelappend_channelappend_channelAppendChannelAppendChannel

Alternatives

tile_imagestile_imagestile_imagesTileImagesTileImages, tile_images_offsettile_images_offsettile_images_offsetTileImagesOffsetTileImagesOffset

See also

change_formatchange_formatchange_formatChangeFormatChangeFormat, crop_partcrop_partcrop_partCropPartCropPart, crop_rectangle1crop_rectangle1crop_rectangle1CropRectangle1CropRectangle1

Module

Foundation