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

README.TXT Driver File Contents (xvl322cdinst.zip)

==============================================================================
PCDirect samples for Grab and Process To PC Memory:		 September 11, 1997

	RTPROC32.EXE (for Win32 (Windows NT 4.0 and Windows 95))

==============================================================================

GENERAL DESCRIPTION:
====================

This sample demonstrates how to grab and process simultaenously to PC Memory.
Once the menu item "Start Grab and Process" is selected, it grabs camera image data
to PC Memory and calculates the average pixel value for each frame.  The results
are then displayed on the screen.  This sample demonstrates how to grab and process
using 2 different methods.  The first method is to perform the Continuous Grab 
and Process within a separate thread within the application sample code.  The second 
method demonstrates how to grab multiple frames in PC memory and then process the
multiple frames once all the image data is in PC Memory.


SYSTEM REQUIREMENTS:
====================

OS:			Windows 95 or Windows NT 4.0
MEMORY:			Minimum 16 Megs RAM
Video Card:		ISA/PCI (Direct Draw supported video card not necessary)
XVL Release:	3.20
OTHER:			Direct Draw v2.0


SOURCE CODE DESCRIPTION:
========================

The source code within the Grab and Process samples is structured as follows:

RTCOMMON.C	Common Initialization code used by all PCDirect Aplication Samples.
RTSAMP.RC	Common resource file used by all PCDirect Application Samples.	
RTPRCESS.C	This is where the PCDirect Grab to PC Memory XVL Library Calls are used.
RTPRCWIN.C	Message Processing Loop for Grab and Process Application Window.
CMNDLG.C	Common File Dialog.


Hints and Restrictions:
=======================
    
1)  In order to execute these samples make sure Direct Draw is installed.
    Direct Draw is already integrated within Windows NT 4.0.  For Windows 95,
    it must manually be installed using the DXSETUP.EXE located in \DIRECTX directory.
    The PCDirect Library Calls which grab to PC Memory does not use Direct Draw.
    The only reason Direct Draw needs to be installed is that the ddraw.lib
    was implicitly linked in the XVL Library.  As long as the DDRAW.DLL is located
    in the windows\system directory then the PCDIRECT RTPROC32.EXE sample should work.
    For this sample, it is not required to have a PCI Video Card that supports Direct Draw.

2)  The performance of PCDirect can be affected by other
    processes running in the NT and 95 OS environments. Both the disk
    drivers and mouse drivers on these platforms have high enough
    priorities to affect PCDirect's operation.

3)  When creating image buffers in PC memory, the PC Direct S/W will only
    allow the allocation of (Total available PC memory - 8MB).  This is done
    to reserve some memory for the operating system to run adequately.

4)  Only function calls labelled DPW_RT* may be called while using the
    PC Direct functionality.

5)  When using the Grab and Process Sample (RTPROC32), if the Number
    of Frames processed increments slower than the frame rate of the camera,
    the CPF HVideoActive and VVideoActive values needs to be decreased.

6)  If Error -1910 occurs, it indicates that a DSP DMA overrun condition has occurred on 
    the PowerGrabber.  The source of this problem is that the PC is not processing the image data
    fast enough.  The portion of the frame that the DSP is transferring to the PC is 
    too large and the PC can not keep up.  In order to resolve this problem, the HVideoActive
    VVideoactive CPF parameters should be decreased until the problem goes away.

7)  It is not suggested to use ISA Video Cards with PC Direct.  There's been numerous
    problems reported using the PC Direct Application Samples with ISA Video Cards.


Known PCDirect Bugs:
====================

1)  There is occasionally a problem loading a CPF file in the PCDirect
    samples. If this problem is encountered, restart the application.

PCDirect Camera Restrictions:
=============================

1)  A maximum of 2 com ports are supported for grab transfers on any
    camera type (LinePair not supported in PC Direct).  The majority 
    of testing in this release was performed with single com port 
    using RS170 and CCIR cameras.

2)  The maximum camera bandwidth tested for FPG and LPG is:
        17 million bytes per second using 2 XDC com ports
        15 million bytes per second using 1 XDC com port
    Test performed on a Pentium 133MHz with Windows NT, Windows 95 
    performance was in the 13-14 Mb/s range. 2 com port does not 
    apply to the FPG analog.

3)  The maximum camera bandwidth tested for XPG populated with 
    memory on both buses. 
    global and local bus and using 2 XDC com ports for transfers.
        15 million bytes per second to VGA
        12.5 million bytes per second to memory.
    Test performed on a Pentium 133MHz with WindowsNT, Windows 95 
    measurement was not performed.

4)  The following grab features have been tested with PC direct, 
    Frame Holdoff and Frame Skip. Triggering, Exposure, LineSyncOut 
    and Reset have had minimal testing.


==============================================================================