Image Merge

Merges multiple images into a single image and cuts areas out from a single image. A window may be placed around any portion of the images that are open in VrOne and a new image will be created that fills the selected area. The output file size and pixel dimensions are displayed as the merge area is selected. A new TIFF world file (.tfw) is written with the output image to maintain the image real world coordinate system. Images may be written as 24-bit color or 8-bit grayscale, regardless of the type of images that are being merged. Downsampled images may be created by selecting different pyramid levels. Output of compressed images is also supported with user control of the compression quality setting. If any portion of the output area contains multiple images, the image pixels will be taken from the last opened image. If multiple images are opened at once, the image whose pixels are used for that portion depends on the order that the images are selected in the open file dialog box. Edit Image (EDIIMA) may also be used to change the display order of the images, which will also affect the output order.

Key-in	Description	Range
COMP=	Compress Images?	0=No 1=Yes
COMPQUAL=	Compression quality	0-100
OUTFIL=	Output filename	128 characters
PYRALEVEL=	Pyramid Level	0-6
OUTTYPE=	Output type	0=Same,1=Color,2=Grayscale
WRITEPYRA=	Set image pyramid writing on or off.	0=Off - Don't write image pyramids when writing mosaic images (old image pyramids will still be deleted) 1=On - Write image pyramids when writing mosaic images
BACKCOLOR=	Background color	An integer value representing an RGB color value. Using r,g,b to represent the desired red, green, and blue values, the following formula will calculate the number required for this parameter: (255 << 24) \| ((r & 255) << 16) \| ((g & 255) << 8) \| (b & 255) For example, if solid green is the desired background color, then use the number 4278255360. This is calculated using the above formula with r=0,g=255,b=0.

Specifies the output file color type. Files may be written as one of the following types:

Same as first image	File is written as a color (24-bit) image if the first opened image in VrOne is color, and it will be written as greyscale (8-bit) if the first image in VrOne is greyscale.
Color	File is written as a color (24-bit) image regardless of the image types that are being merged.
Greyscale	File is written as a greyscale (8-bit) image regardless of the image types that are being merged.

If set to Yes, image pyramids will be created as the output image is written. This will result in a slightly longer processing times but will eliminate the need for VrOne to create image pyramids the first time the image is opened. If set to No, old image pyramid files will be deleted but new ones will not be created until the output image is opened.

If set to Yes, then the output image will use JPEG compression. If set to No, the output image will not use compression. The output image will use this setting regardless of the file format of the images being merged. The Output compression quality parameter should be set accordingly if this parameter is Yes.

This is a value from 0 to 100 that determines how much the output image will be compressed. Lower numbers result in greater compression but more loss of image quality. Higher numbers achieve greater image quality with larger file sizes. A good default value is 70, providing a compression ratio around 8 to 1 for color images with a minimal loss of quality.

This option allows the output image to be written out at different pixel size than the images being merged. The output file sizes and image quality will decrease by powers of 2 for each higher pyramid level that is chosen. This option is useful for creating composite images of very large areas that would require too much space if written out at full quality (pyramid level 1). This also provides a quick way to create “thumbnail” images of large areas. When selecting the output pyramid level, the resulting pixel size is displayed for informational purposes only. The pixel size computation is always based in the pixel size of the first opened image in VrOne. The pixel size is read from the TIFF world file (.tfw).

Sets the color to use for pixels that do not fall within an existing image area.

Defines the name of the output image file. This file will be overwritten if it already exists. An extension of .tif will be added to the filename if it is not specified.

	Button	Description	Displays Menu
1	Dig lower lt	Digitizes the lower left corner of the output image area.	Dig Corner
2	Merge All	Merges all open images to create output image. Displays confirmation box first.
3
4
5
6
7	Enter params	Enter parameters from dialog box.
8
9
*
0	Toggle snap	Toggle snap on and off.
#	End	Ends application.

	Button	Description	Displays Menu
1	Dig upper rt	Digitizes the upper right corner of the output image area.	Verify
2	Abandon	Abandons the current output window and returns to the Main menu.	Main
3
4
5
6
7
8
9
*
0	Toggle snap	Toggle snap on and off.
#	End	Ends application.

	Button	Description	Displays Menu
1	Accept	Accepts output window area and writes the output image.	Main
2	Reject	Cancels the current output window and returns to the Main menu.	Main
3
4
5
6
7
8
9
*
0
#	End	Ends application.