BMOVRLAY.EXE

March 26, 1999

NAME

bmovrlay.exe merges a series of pairs of 8 bit bitmaps image files into single 24 bit bitmap files making one input image series red and the other input series green.

SYNOPSIS

bmovrlay   red_input_files*.bmp   green_input_files*.bmp   [ -o output ]   [-v]   [ -l ]

Where: red_input_files*.bmp and green_input_files*.bmp are matched series of bitmap files that will expand into the file names that will be the images for the red and green channels respectively of 24 bit output bitmap files. Wild cards (* or ?) are permitted.

red_input_files*.bmp are the files to be placed in the red channel.

green_input_files*.bmp are the files to be placed in the red channel.

-o output (no .bmp extension) specifies name of overlayed bitmap image files to be called outputXX.bmp or  outputXXX.bmp depending on the number of output files. Default is RESULTXX.BMP.

-v verbose displays extra information while processing images.

-l  output a listing of the matched files without generating the overlayed result files.  bmovrlay should be run with this option before generating the output files to ensure that the red and green input files match up as desired.

DESCRIPTION

bmovrlay overlays a series of pairs of 8 bit gray scale input files specified by red_input_files*.bmp and green_input_files*.bmp into 24 bit RGB color bitmaps. The red and green input files must be matched in number and size and ideally palette. Output file series may be specified with -o output. The -v command line switch cause matched file names to be displayed while processing is in progress.  The -l option list pairs of matched file names on the screen without generating the RGB output result files.  Note that files numbers need not be continuous, since the command line expands file wild type as sorted them in text (not numerical) order.  Be careful when file names have numbers that have different numbers of digits.  e.g. files series that include a transition from fred99.bmp to fred100.bmp or jim9.bmp to jim10.bmp.  Placing the files for the red images and files for green images into separate directories is a good idea.

UTILIZATION EXAMPLE

bmovrlay  red*.bmp   green*.bmp -o anaglyph : merges pairs of 8 bit bitmaps images given by redXX.bmp and greenXX.bmp to be overlayed into anaglyphXX.bmp, where XX is a number series.

bmovrlay  subdir1\r*.bmp   subdir2\g*.bmp -o anaglyph : merges pairs of 8 bit bitmaps images given by r*.bmp in the subdir1 directory and g*.bmp in the subdir2 directory and creates a files series called anaglyphXX.bmp in the current directory, where XX is a number series.

SEE ALSO

bmproduct.exe   bmfunctions

BUGS

Input image file can only be 8 bit gray scale bitmap files.  Palettes are assumed to be linear gray scale.  I can not remember what happens if the number of entries in the palette is not 256!  Input file extension must be explicitly specified as .BMP. Input files series must be matched.