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 $