mosaic

[ XITE Reference Manual | XITE home ]

Name

mosaic - combine several images to a new one band image

Syntax

 mosaic -auto [<option>...] <img1> ... <imgn> <outimage>
 mosaic [<option>...] <img1> <xstart> <ystart> ...
    <imgn> <xstart> <ystart> <outimage>

Description

All bands from all input images are copied into a new one-band image or a multi-band image, copied in the sequence they are given as arguments.

img1, .., imgn are input images.

xstart and ystart give new positions for all bands in the new band. Should not be smaller than 1.

Options

-auto
Place the bands according to their individual xstart/ystart attributes. Otherwise: Use the xstart/ystart arguments on the command line.

-multi
If any of the input images is multiband, then the output image will also be multiband. This means that band1 from all input images will be combined into band1 of the output, band2 of all input images combined into band2 of the output, and so on. The input images do not need to have the same number of bands.

-bg bg
Use bg as background pixel value. Default: 0

-xsize xsize
Make the new horizontal band size at least as large as xsize

-ysize ysize
Make the new vertical band size at least as large as ysize. Default size: Just as large as necessary.

Restrictions

Works with all pixel types, but all bands of all images must have the same pixel type.

Author

Tor Lønnestad, BLAB, Ifi, UiO.

Examples

Make frame 10 pixels wide "painted" with pixel value 5:
 mosaic -bg 5 -xsize 532 -ysize 532 mona.img 11 11 \\
   frame.img

Put two 500x500 images side by side:
 mosaic i1.img 1 1 i2.img 501 1 both.img

Put two 500x500 bands (in the same image) side by side:
 mosaic i1.img:1 1 1 i1.img:2 501 1 both.img

Id

$Id: mosaic.c,v 1.23 1996/12/06 19:10:50 svein Exp $