1. xvl322cdinst.zip Driver
2. README.TXT File Contents

README.TXT Driver File Contents (xvl322cdinst.zip)

This directory contains several sample applications which exhibit the
functionality of the PPM-GEN in ACTIVE GRAB mode, namely with the
PowerBus data passing through the PPM from a camera module for
preprocessing before acquisition by the XPG-1000.

The programs all load any PPFs required, perform any additional setups
then commence grabbing in BYPASS mode. Pressing the escape (ESC) key
will cause the ACTIVE GRAB to commence, with the PPM-GEN configured
for preprocessing. Hitting ESC again will cause the program to exit.

The different PPM-GEN configurations used are specified by PPF
files.  The PPF files can be found in the %DIPXPG%\PPF directory.

The PPMGEN.INI file controls which PPF files are used for each executable 
and which CPF file is used.  Note the comments in the file about switching
PPFs for interlace and areascan cameras.

Note:  It is recommended to reduce the active grab region of your camera's
       CPF file to 256pixels x 256lines to fit within PPM-GEN memory
       limitations.  Once you have the executable executing properly
       with your camera, increase the active grab region to match your
       camera's active size.

Programs:

PGASPIPE: Active grab PPM-GEN pipeline processing.  This program
          can be used to test any active grab mode on the PPM-GEN.
          By default, this program performs convolution.

PGASUB1.EXE: Active grab mode performing frame subtraction.  This sample
             loads the reference image by grabbing it directly to PPM-GEN
             memory.

PGASUB2.EXE: Active grab mode performing frame subtraction.  This sample
             loads the reference image by grabbing it to DSP memory and then
             calling DBP_PPMPutRefImage to upload it to PPM-GEN memory.

PGAWAVG.EXE: Active grab mode performing continous weighted frame averaging.
             In this example, memory banks A and B are used as LUTs to weight
             the incoming frame with the accumulated average.  Memory banks
             C and D toggle back and forth reading the current averaged frame
             and the writing the new averaged result.

PGASAVG1.EXE: Active grab mode performing a simple arithmetic average of
              6 frames at a time.  Internally, the data is accumulated as
              16 bits on the GEN and an output LUT maps the data to 8 bits
              for display.  Because the GEN must sum 6 frames before 
              displaying, the output frame rate is slower than the other 
              programs.
              
PGASAVG2.EXE: Similar to PGASAVG1, except no output LUT is used.  Instead,
              DBP_PPMGetCapturedImage is called to download the 16 bit 
              summed frame into DSP memory before display.

PGA2PTCI.EXE: Active grab mode performing 2 point correction on each pixel
              in a the line of grabbed data.  The first half of the line
              is passed through unaffected and the 2nd half of the line
              is inverted.  This program illustrates the gain portion
              of the 2pt correction function with an offset of 0.

PGA2PTCR.EXE: Active grab mode performing 2 point correction on each pixel
              in a the line of grabbed data.  The incoming pixel data is 
              replaced with a linear ramp.  This program illustrates the 
              offset portion of the 2pt correction function with a gain of 0.

PGHGSUB.EXE:  Passive grab mode performing frame subtraction and 
              histogramming.  Note that the histogram is being calculated,
              but not displayed.

PGPSPIPE.EXE: Passive grab mode illustrating how to perform pipelined 
              operations on an incoming image utilizing a ROI.  Currently
              works for areascan cameras only.

PGPRPIPE.EXE: Process mode sample application.