tile_channelstile_channelsTileChannelstile_channelsTileChannelsTileChannels (Operator)

Name

tile_channelstile_channelsTileChannelstile_channelsTileChannelsTileChannels — Tile multiple images into a large image.

Signature

Description

tile_channelstile_channelsTileChannelstile_channelsTileChannelsTileChannels tiles an image consisting of multiple channels into a large single-channel image. The input image ImageImageImageImageImageimage contains Num images of the same size, which are stored in the individual channels. The output image TiledImageTiledImageTiledImageTiledImageTiledImagetiledImage contains a single channel image, where the Num input channels have been tiled into NumColumnsNumColumnsNumColumnsNumColumnsNumColumnsnumColumns columns. In particular, this means that tile_channelstile_channelsTileChannelstile_channelsTileChannelsTileChannels cannot tile color images. For this purpose, tile_imagestile_imagesTileImagestile_imagesTileImagesTileImages can be used. The parameter TileOrderTileOrderTileOrderTileOrderTileOrdertileOrder determines the order in which the images are copied into the output in the cases in which this is not already determined by NumColumnsNumColumnsNumColumnsNumColumnsNumColumnsnumColumns (i.e., if NumColumnsNumColumnsNumColumnsNumColumnsNumColumnsnumColumns != 1 and NumColumnsNumColumnsNumColumnsNumColumnsNumColumnsnumColumns != Num). If TileOrderTileOrderTileOrderTileOrderTileOrdertileOrder = 'horizontal'"horizontal""horizontal""horizontal""horizontal""horizontal" the images are copied in the horizontal direction, i.e., the second channel of ImageImageImageImageImageimage will be to the right of the first channel. If TileOrderTileOrderTileOrderTileOrderTileOrdertileOrder = 'vertical'"vertical""vertical""vertical""vertical""vertical" the images are copied in the vertical direction, i.e., the second channel of ImageImageImageImageImageimage will be below the first channel. The domain of TiledImageTiledImageTiledImageTiledImageTiledImagetiledImage is obtained by copying the domain of ImageImageImageImageImageimage to the corresponding locations in the output image. If Num is not a multiple of NumColumnsNumColumnsNumColumnsNumColumnsNumColumnsnumColumns 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_channelsTileChannelstile_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>)SetSystem("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_channelAppendChannelappend_channelAppendChannelAppendChannel

Alternatives

tile_imagestile_imagesTileImagestile_imagesTileImagesTileImages, tile_images_offsettile_images_offsetTileImagesOffsettile_images_offsetTileImagesOffsetTileImagesOffset

See also

change_formatchange_formatChangeFormatchange_formatChangeFormatChangeFormat, crop_partcrop_partCropPartcrop_partCropPartCropPart, crop_rectangle1crop_rectangle1CropRectangle1crop_rectangle1CropRectangle1CropRectangle1

Module

Foundation