Tile multiple images into a large image.
tile_channels tiles an image consisting of multiple channels into a large single-channel image. The input image Image contains Num images of the same size, which are stored in the individual channels. The output image TiledImage contains a single channel image, where the Num input channels have been tiled into NumColumns columns. In particular, this means that tile_channels cannot tile color images. For this purpose, tile_images can be used. The parameter TileOrder determines the order in which the images are copied into the output in the cases in which this is not already determined by NumColumns (i.e., if NumColumns != 1 and NumColumns != Num). If TileOrder = 'horizontal' the images are copied in the horizontal direction, i.e., the second channel of Image will be to the right of the first channel. If TileOrder = 'vertical' the images are copied in the vertical direction, i.e., the second channel of Image will be below the first channel. The domain of TiledImage is obtained by copying the domain of Image to the corresponding locations in the output image. If Num is not a multiple of NumColumns the output image will have undefined gray values in the lower right corner of the image. The output domain will reflect this.
|
Image (input_object) |
multichannel-image(-array) -> object : byte / direction / cyclic / int1 / int2 / uint2 / int4 / real |
| Input image. | |
|
TiledImage (output_object) |
singlechannelimage(-array) -> object : byte / direction / cyclic / int1 / int2 / uint2 / int4 / real |
| Tiled output image. | |
|
NumColumns (input_control) |
integer -> integer |
| Number of columns to use for the output image. | |
| Default value: 1 | |
| Suggested values: 1, 2, 3, 4, 5, 6, 7 | |
| Restriction: NumColumns >= 1 | |
|
TileOrder (input_control) |
string -> string |
| Order of the input images in the output image. | |
| Default value: 'vertical' | |
| List of values: 'horizontal', 'vertical' | |
/* 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, FGHandle, -1)
append_channel (Image, ImageGrabbed, Image)
endfor
tile_channels (Image, TiledImage, 1, 'vertical')
tile_channels 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>:). If necessary, an exception handling is raised.
tile_channels is reentrant and automatically parallelized (on tuple level).
tile_images, tile_images_offset
change_format, crop_part, crop_rectangle1
Image / region / XLD management
