BMPRODUCT.EXE  (32 bit DOS, Win95, WindowsNT)

March 29, 1999

NAME

bmproduct.exe multiplies a series of 8 bit bitmaps image file pairs into an 8 bit bitmap output file series.

SYNOPSIS

bmproduct   multiplicand_input_files*.bmp   multiplier_input_files*.bmp   [ -o output ]   [-v]   [ -l ]

Where: multiplicand_input_files*.bmp and multiplier_input_files*.bmp are matched series of bitmap files that will be multiplied together to create an output_file product series.  The most significant 8 bits of the product are kept and the least significant 8 bits are discarded keeping the result 8 bit.

multiplicand_input_files*.bmp are assumed to be gray scale.   Number must be same as multiplier files.   

multiplier_input_files*.bmp are assumed to be gray scale.   Number must be same as multiplicand files.

-o output (no .bmp extension) specifies name of the product 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 result files.  bmproduct.exe should be run with this option before generating the output files to ensure that the two series of input files match up as desired.

DESCRIPTION

bmproduct.exe multiplies a series of pairs of 8 bit gray scale input files specified by mutliplier_input_files*.bmp and multiplicand_input_files*.bmp to be multiplied together to generate an 8 bit product file series.  The product is scaled by 256 (8 bits) so overflow can not occur and compatibility with 8 bit bitmaps is maintained in the resultant product files.  The mutiplicand and multiplier input files must be matched in number and size and ideally palette.  Output file series name 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 output result files.  Note that files numbers need not be continuous, since the command line expands file wild type and sorts 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 mutliplicand and multiplier files into separate directories can help in maintaining file order.  This process is an objective way of determining co-localization on z-section series of files in corresponding pixel locations. 

UTILIZATION EXAMPLE

bmproduct  NaChAb*.bmp   Kv12*.bmp -o co localization : multiplies pairs of 8 bit bitmaps images given by NaChAb*.bmp and Kv12*.bmp to be multiplied into co localization*.bmp.

bmovrlay  subdir1\r*.bmp   subdir2\g*.bmp -o answer : multiplies 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 answer*.bmp in the current directory.

SEE ALSO

tiffsplit.exe   LViewPro.exe   bmovrlay.exe   "Using channel calculations to blend layers and channels" in Adobe Photoshop, 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 in number and dimensions of the bitmap image. 

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.

No doubt there are other bugs that have not been encountered yet.  Please report bugs to mchua@med.unc.edu