===============================================================================
Name wdemo.txt
Purpose To describe the options of the wdemo program.
Author Pierre Landriau
Date 10-Sep-1997
===============================================================================
Contents:
1. Setup
2. Getting an image.
3. Image processing.
1. Setup
1.1 Select Board (DPW_PCKSelectBoard)
- This option offers a list of board from a drop down list. At statup
board 0 is the default board and when changing board the current board
is the default board. If there is only one board in the system then
the board is selected automatically and this option is not available.
1.2 Load CPF file (DPF_LoadCPF, DBF_SelectCPS, DBF_GetGrabWindow,
DBF_GetCameraDataSize, DBK_MmtCreateImage
- This option puts up the standard file selection dialog box and
allows a user to select a CPF file to be loaded. The image size
specified by the CPF is used to create the images for the demo.
1.3 Setup PPM (DPP_LoadPPF, DBF_QuickGrabAllocSetup,
DBP_PPMSetGrabConfiguration, DBF_QuickGrabSetup,
DBF_QuickGrab)
- This option allows a user to select a PPF file through the standard
file selection dialog box. This causes the grab to be process
through the PPM. This option is not available if there is no PPM.
1.4 PCI BusMastering (DPK_UseBusMasteringMode)
- This option turns bus mastering on or off. With Bus mastering on
the data transfer from the DSP to the PC are faster.
1.5 ComPort Config (DBK_XDCSetComPortNumber)
1.5.1 2ComPorts
- The DSP will use two com ports to send data to the PC. This
generally provides faster throughput to the PC. It is only
valid for PCI boards.
1.5.2 NoSync DMA
- Turn Synchronous DMA transfer mode on or off.
Note that this item is only valid on a PCI bus board.
1.5.3 Synchronous PIO
- Turn Synchronous Programmed IO transfer mode on or off.
Note that this item is only valid on a PCI bus board.
1.6 SetDspClockSpeed (DBK_SetDspClockSpeed)
- This option allows the user to set the DSP clocks speed so that
grab related parameters can be computed correctly. The default is
50mhz. The clock speeds available are 40, 45, 50 and 60.
1.7 Configuration (DPU_GetHostInfo, DBK_MmtReportFreeMemory)
- The configuration of the currently selected board is displayed as
follows:
Software Version: (The software version number)
Board type : (XPG, FPG-ACM, FPG-DCM, LPG-ACM, LPG-DCM)
Bus type : (ISA or PCI)
Display type : (EDB or NONE)
Display Mode : (Single screen or dual screen)
Environment path: (DIPXPG symbol value)
Free memory information (in 32 bit words):"
Global Bus DRAM: (# of free 32 bit words in global Bus DRAM)
Global Bus SRAM: (# of free 32 bit words in global Bus SRAM)
Local Bus DRAM: (# of free 32 bit words in local Bus DRAM)
Local Bus SRAM: (# of free 32 bit words in local Bus SRAM)
TotalPhysical: Total physical memory in K.
AvailPhysical: Available physical memory in K.
TotalPageFile: Total page file momory in K.
AvailPageFile: Available page file memory in K.
AvailVirtual: Available virtual memory in K.
1.8 About
- Standard about box with application logo and the following text:
"XVL DEMO Version x.xx for Microsoft Windows" for Windows 3.1 or
"XVL DEMO Version x.xx for Microsoft Windows 32bit" for Windows 95
and Windows NT.
1.9 Exit (DPK_EndPCK)
- The windows application exits.
2. Getting an image.
2.1 Grab
2.1.2 Grab 1 Image (DBF_QuickGrab (Grabbing through PPM), DBF_Grab,
WDemoDisplayImage)
- This option grabs one image into the current input image (A or B)
and display it on the VGA.
2.1.3 Grab N Images DBF_QuickGrab (Grabbing through PPM), DBF_Grab,
WDemoDisplayImage)
- This option puts up a dialog box to get the number of frames to
be grabbed. Each grab is done and then the image is displayed.
The image count is given on the menu bar as: n of m, where n
goes from 1 to m.
2.1.4 FrameAveraging (DBI_CreateFrameAveragingBuffer, DBI_FrameAveraging)
- This option puts up a dialog box to get the number of frames to
be averaged. Selecting the OK button starts the frame averaging
function. To average more frames select OK again, to reset the
averaging select the RESET button.
2.2 TestImage (DP_TestImage)
- This option creates a test image in the currently selected input
image.
2.3 ImageInfo (DBK_MmtGetImageInfo)
- This option gets the image information for the current input image
and displays it in a message box as follows:
Image # = (Image number of current image)
DataSize = (Data size in bits, 8, 16, 32)
Lines = (Number of lines in the image)
Pixels = (Number of pixels per line)
LongAddr = (DSP longword address of the start of the image)
MappedAddr= (DSP mapped address for the start of the image)
2.4 Image copying
2.4.1 DspImgToDisk
- This option puts up the standard file dialog box to get a file
name for saving an image from the DSP to the disk. Once a file
name has been selected the current input image is copied to disk.
2.4.2 DiskToDspImg
- This option puts up the standard file dialog box to a get an
image file name to load from the disk to the DSP. Once a
file name is selected the data is loaded from the disk to the
DSP into the current input image.
2.4.3 DiskImgToWindows
- This option puts up the standard file dialog box to get file name
of an image to load directly to window. Once the file has been
selected the data is copied directly to the Windows display.
This image cannot be processed as it is not copied to the DSP.
2.5 Tiff image copying
2.5.1 TiffToDspImg
- This option puts up the standard file dialog box to get a Tiff
file name to load an image from disk to the DSP. Once the file
name is selected the data from the Tiff file is copied from the
disk to the current input image.
2.5.2 DspImgToTiff
- This option puts up the standard file dialog box to get a file
name to save an image from the DSP to disk. Once a name has been
selected the current input image is copied from the DSP to the
disk in Tiff format.
2.5.3 TiffToWindows
- This option puts up the standard file dialog box to get a file
name to load directly to window. Once the Tiff file has been
selected the data is loaded directly to Windows display. This
image cannot be processed as it is not copied to the DSP.
2.5.4 WindowsToTiff
- This option puts up the standard file dialog box to get a file
name to save a Windows display to disk in Tiff format. Once the
Tiff file has been selected the data is copied from the Windows
display to the disk file.
2.6 SelectImage
- This option allows the user to select between input image A or input
image B. Selecting an input image causes this image to be the current
input image (ie grabs will be to this image, processing will be on this
image). The two image are necessary for the DBI_Arith function with
two input image operations. The current input image ID is displayed
on the menu bar.
2.7 CopyOutputToA
- This option copies the output image to input image A. This allows a
processed image to be processed again.
2.8 CopyOutputToB
- This option copies the output image to input image B. This allows a
processed image to be processed again.
3. Image processing
3.1 Filtering (DBI_Filter, DBI_FilterSetConvolutionParameter,
DBI_FilterModifyKernel)
- This option puts up a dialog box which provides a drop down list for
the selection of the filtering types (Convolution, Median, Sobel,
ShiftDifference and GradientDirectional), and a drop down list for
the kernel sizes (3x3, 5x5 or 7x7).
- It also has a drop down list for the selection of the filter direction
for ShiftDifference (Vertical, Horizontal and Horizontal-Vertical) and
for the GradientDirectional filter (North, NorthEast, East, SouthEast,
South, SouthWest, West and NorthWest).
- Edit boxes are provided to enter the convolution Scale and the
convolution Offset.
- A button provides access to a convolution kernel editing dialog.
3.2 Arithmetic (DBI_Arith)
- This option provides a drop down list for one image operations (NEGATE,
NOT, Arithmetic Shift, Logical Shift, Scale & Offset,
AND with Constant, OR with constant). The operation selected is
performed on input image A.
- There is a drop down list for two image operations (Add, Subtract,
Multiply, Divide, AND, OR, XOR, AND and Complement, Maximum, Minimum).
The operation selected is performed on input images A and B.
- Edit boxes are provided to enter the Scale, Offset and Constant values.
3.3 Slicing (DBI_FilterSlice)
- This option provides a drop down menu for the filtering slice function
(SliceBright, SliceBrightAndClear, SliceDark and SliceDarkAndClear).
- Edit boxes are provided to enter the Threshold and Output plane values.
3.4 Warping (DBI_CreateWarpBuffer, DBI_GenerateWarpTable, DBI_Warp,
DBI_WarpWithTable)
- This option gets a angle or rotation and a scale factor, from this
it computes the X and Y warp coefficients.
- The warp coefficients are either applied immediately to the input
image (DBI_Warp), if WarpWithGrab is OFF, or used to create a Warp
table which is then used to Grab and Warp (DBI_WarpWithTable) by
toggling the WarpWithGrab button to ON.
3.5 Labeling (DBI_Label, DBI_CreateHistogramBuffer, DBI_Histogram,
DBI_GetPixelValue, DBI_LineProfile, DBI_CreateLutBuffer,
DBI_ImageRemap)
- This option Labels an image.
- There is a edit box to enter the threshold value and a drop down
list to select the image slice type (SliceDark, SliceBright, NOSlice).
- There is an edit box for entering the minimum object size. This causes
object smaller than this size (size is in pixels) to be removed from
the output image. Tthis is done using a histogram and creating a lut
and then processing the image through the lut (DBI_ImageRemap).
- There is a button which can be toggled (from LabelAtEdge to
!LabelAtEdge). !LabelAtEdge causes all the object touching an edge
of the image to be removed. This is done using line profile for each
edge of the image, creating a lut which is used to process the image
(DBI_ImageRemap).
- Point the mouse to an object and double click the right mouse button
to get it's size in pixel. This functionality stops when another
function is done, overwriting the current output image.
3.6 LUT (DBI_Statistics, DBI_CreateLutBuffer, DBI_ImageRemap)
- This option provides a drop down menu with a list of luts to apply
to the image (Inverse, ContrastStretch).
- A button is provided to scale the lut so as not to conflict with
the portions Windows uses (0-9, 246-255).
3.7 Histogram (DBI_CreateHistogramBuffer, DBI_Histogram, DBI_Statistics,
DBI_DrawHistogram, DBG_WriteText)
- This option gets the histogram of the current input image. It then
draws the histogram and writes out some of the image statistics,
using the graphics function, to the histogram image and then displays
it.
3.8 ImageStats (DBI_Statistics)
- This function displays the statistics of the current input image.
The statistics are as follows:
Mean (ä of pixels / Number of pixels)
Variance (ä of (pixel - mean)ý / Number of pixels)
Median (Middle value)
Mode (Most frequent value)
Maximum (Highest pixel value in calculation window)
Minimum (Lowest pixel value in calculation window)
#Samples (Number of pixels in calculation window)
3.9 PixelValue (DBI_GetPixelValue)
- This option turns on or off the displaying of the pixel value at the
cursor. The display is on the menu bar and as the format
(x,y) = Value. When the cursor is off the image there is no value
and no coordinates displayed.
Download Driver Pack
After your driver has been downloaded, follow these simple steps to install it.
Expand the archive file (if the download file is in zip or rar format).
If the expanded file has an .exe extension, double click it and follow the installation instructions.
Otherwise, open Device Manager by right-clicking the Start menu and selecting Device Manager.
Find the device and model you want to update in the device list.
Double-click on it to open the Properties dialog box.
From the Properties dialog box, select the Driver tab.
Click the Update Driver button, then follow the instructions.
Very important: You must reboot your system to ensure that any driver updates have taken effect.
For more help, visit our Driver Support section for step-by-step videos on how to install drivers for every file type.