MAN page from RedHat Other XITE-3.3-3.i386.rpm

MOSAIC

Section: User Commands (1)
Updated: 16 Mar 1998
Index

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 newone-band image or a multi-band image, copied in the sequencethey are given as arguments.

img1,imgnare input images.

xstartand ystartgive new positions for all bands in thenew band. Should not be smaller than 1.

OPTIONS

-auto

Place the bands according to their individual xstart/ystartattributes. Otherwise: Use the xstart/ystart arguments onthe command line.

-multi

If any of the input images is multiband, then the outputimage will also be multiband. This means that band1 fromall 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 samenumber of bands.

-bg bg

Use bgas 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 imagesmust 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 $

This document was created byman2html,using the manual pages.