Read Me

Software Installation - Datapath Vision RGB-PRO Data Capture Card

Windows® 2000/Windows® XP/Windows® Server 2003:

Software for Vision RGB-PRO can be obtained from one of the following sources:

• The Datapath CD supplied with the Vision RGB-PRO data capture card.
• The Datapath web site.

To install the application and drivers:

• Locate the latest version of Vision RGB-PRO download file at: www.datapath.co.uk/down.htm.
• Click on the vrgbpro.zip file and select Save this file to disk.
• Once the download is complete, unzip the file, locate and double click the Vision RGB-PRO install.exe file and the installation process will commence.
• Follow the installation Wizard instructions as prompted.

From the Datapath CD:

• Insert the Datapath CD into your CD drive, the CD will autorun and display a dialog. If the CD drive fails to autorun browse the CD and locate and double click the setup.exe file. Click on Install Software… and follow the installation Wizard instructions as prompted.

Installing the WDM Video Capture Driver

If you wish to capture both inputs of your Vision RGB-PRO2 card at the same time using streaming applications, you need to select the Enable multiple simultaneous WDM streams option in the install. When the installation wizard has finished, the Windows New Hardware Found Wizard will pop up. You need to go through the New Hardware Found Wizard to install extra Vision RGB-PRO devices.

• When the New Hardware Found Wizard asks you if you want to connect to Windows Update you should select No, not this time. The driver is already on your hard disk.
• When the New Hardware Found Wizard asks you to insert the CD you should select Install the software automatically.

The New Hardware Found Wizard will pop up a total of three times, you should follow the above procedure each time.

It is strongly recommended that you read the detailed help instructions on completion of the installation. Each help topic may be printed for ease of use.

Release History

For the most up to date version of the drivers visit our web site.

Version 7.20 - 23^rd July 2007

• Correct a rare BSOD in the streaming driver
• Correct a theoretical fault - believed not to have happened - in the Scatter Gather Table handling.
• Fix UYVY colour format in streaming
• Fix colours in any of the YUV pixel formats

Version 7.19 - 5^th June 2007

• Bug fix during install, error message read 'Invalid access to memory location'.

Version 7.18 - 9^th May 2007

• Bug Fix in driver for single channel Vision RGB Pro devices which have had ADC offset settings made to them (Input settings tab, colour dialog)
• Bug Fix RGB Recorder to correctly handle No Signal presented to the card during a recording.
• Green signal as greyscale functionality added to the driver, obtainable by a registry setting. This is aimed at customers requiring the capture of "greyscale" signals, which present a single intensity signal and syncs. This is usually a 1 wire capture; a green signal with composite syncs.
• Bug Fix RGB Recorder to reliably handle resolution changes whilst recording.

Version 7.17 - 24^th April 2007

• Bug fix for systems with multiple Vision RGB-PRO devices.

Version 7.16 - 16^th April 2007

• Bug fix for accelerated windows when dragged onto a non-Datapath graphics device and then back onto a Datapath device.
• Bug fix during install for error 'The WDM Streaming Device Driver installation has failed. Error 10003.

Version 7.15 - 11^th April 2007

• With Datapath graphics cards we now detect when Windows has supplied the wrong origin coordinates to the display driver. We correct the coordinates used in the driver so that RGB windows appear correctly. We also correct the source of the coordinates.
• Bug fix to 'Save settings' open functionality when a window was minimised.
• Added support for 32 bit Windows Vista operating systems.
• Compressed HTML help file format supported.

Version 7.14 - 9^th November 2006

• Added support for Unicode characters in file names, window captions, input names and on screen display.
• Fixed problem that caused the RGB window user interface to become unresponsive when CPU usage was high.
• Driver modified to prevent very rare system lockups on multi-processor machines.
• Calls to SDK functions after disabling a capture no longer return the RGBERROR_CAPTURE_OUTSTANDING error.

Version 7.13B - 21^st July 2006

• Fixed problem that would display error message RGBERROR_ILLEGAL_CALL when opening saved settings.

Version 7.13A - 12^th July 2006

• Fixed problem that prevented the Vision RGB-PRO application working with non-Datapath graphics cards.

Version 7.13 - 10^th July 2006

• Added Save Settings and Save Settings As to the File menu of the Vision RGB-PRO application. A shortcut can be created to remember the settings of a RGB window.
• Stopped the input name associated with a window being removed when the Configure dialog has been displayed.
• Fixed problem where areas of the RGB window that could not be displayed using Direct to graphics card were displayed with a low quality scaling algorithm when high quality scaling was selected.
• Fixed a problem that could lead to Error 0x00010030 being displayed.

Version 7.12B - 18^th May 2006

• Linked the Help button in the variables dialog to the help file.
• Improved recording and playback.
• Updated the help file.

Version 7.12A - 9^th May 2006

• Improved scrollbar handling for VisionPlayer.
• Removed application hang conditions in VisionPlayer.

Version 7.12 - 2^nd May 2006

• Added Record to the File menu of the Vision RGB-PRO application. The Vision RGB-PRO application can now write captured frames to disk for subsequent playback by the VisionPlayer application.
• Fixed driver fault where a DMA operation was finishing earlier than expected.
• Fixed a crash which could happen when using high performance video cards.
• Fixed error condition check failures in SDK calls.
• RGBCaptureGetParameters now indicates whether blocking calls are in effect.

Version 7.11 - 16^th February 2006

• Added the ability to give names to the inputs in the Vision RGB-PRO application.
• Added support for Datapath Vantage graphics card.
• Added the command line option -Information to RGBCMD.
• Now detect when the horizontal and vertical syncs have been connected the wrong way round and report a Signal out of range error.
• Improved support for PAE.
• Improved the naming of streaming devices allowing the parameters for each device to be saved. This helps applications that do not save the streaming parameters themselves.
• Made the installation of additional streaming devices optional. Additional streaming devices are required only when you wish to capture multiple streams simultaneously.

Version 7.10 - 26^th July 2005

• Added the ability to change the colour balance for an input.

Version 7.09 - 6^th July 2005

• Can now stream simultaneously from both inputs of a single Vision RGB-PRO card. See the notes for installing the WDM Video Capture driver.
• Added command line interface for on screen display.

Version 7.08 - 10^th May 2005

• Streaming now works for users who are not administrators.
• Added command line option -Scaling={fast|slow}.
• Improved PAL and NTSC.

Version 7.07 - 27^th April 2005

• Added scaling options to the Window Properties dialog. You can now select a higher quality (but slower) scaling method.
• Fixed issues with Watchout.
• Improved horizontal and vertical scaling.
• Fixed the HorScale control in the streaming capture properties dialog.
• Fixed memory leaks.
• Fixed problems that would cause a message box with Error 0x0001002A to appear.
• Fixed device selection in RGBDiag.
• Improved initialisation of hardware to fix problems when booting a machine immediately after switching the power on and opening RGB windows simultaneously.
• Reduced capture faults on dual channel boards.

Version 7.06 - 8^th March 2005

• Fixed crash in driver introduced in V7.05.

Version 7.05 - 7^th March 2005

• Integrated support for streaming.
• Added control over which video formats and default resolution are offered to streaming clients (see on-line help for more details).
• Improved the quality of the image in the RGB window when capture is paused.
• Save As now supports BMP, JPEG, GIF, TIFF and PNG file formats.
• The on screen display continues to be displayed when there is no signal.
• Alt+Space now shows the system menu for the RGB window.
• Added command line options -Reset and -ShareCaptureSettings (see on-line help for more details).
• Fixed a problem that would prevent a machine from shutting down.
• Fixed problems capturing PAL.
• Fixed various problems in the formatting of on screen display text.

Version 7.04 - 19^th November 2004

• Fixed problems caused by a user not having write access to the parts of the Registry where video mode information is stored. Users who do not have administrative rights and are using Windows XP were affected.

Version 7.03 - 30^th September 2004

Application

• Added on screen display of text.
• Added a control to change RGB input.
• Fixed command line options DisplayInvalidInputMessage and DisplayMessageAfter.

Device Driver

• Do not switch off acceleration if the image buffer passed into RGBCaptureFrameBufferReady is larger than the image.
• Improved the mode definitions for PAL and NTSC.
• Stopped the system process leaking handles.
• Added support for video modes with refresh rates above 200Hz.

Version 7.00 - 8^th July 2004

• Replaced Vision RGB application, on-line help and install wizard.

Known Problems

• Starting the RGB record functionality whilst the input is "No Signal" causes the recorder to not record and to not exit when stopped.
  Always start and stop recording whilst a signal is present.
• If Windows is configured to use a software cursor and the cursor is placed over an RGB window, the cursor will flash and the CPU usage may increase.
  Configure Windows to use a hardware cursor.
• When Capture Rate is set to 100% and Transfer Data is set to Direct to graphics card, artefacts can be seen in the RGB window as the window is dragged around the desktop.
• Sometimes the On Screen Display of text is not correctly formatted when right aligned.
• Video modes with a dot clock greater than 140MHz or where more than 1438 pixels per line are captured need to be captured in two stages. A vertical comb effect may be visible when capturing these modes.
• Under certain circumstances, Windows Media Encoder will give the following error message when you press the Encode button:
  Invalid or corrupt data was encountered (0xC00D002F).
  Windows Media Encoder prefers YUY2 to the RGB formats that the Vision RGB-PRO supports. Disable the RGB565 and RGB32 pixel formats and enable the YUY2 pixel format. See the section Configure Streaming Driver in the Vision RGB-PRO Help.