README.TXT Driver File Contents (SAA2000XPETC.zip)

                    FlashBus MCI Overlay Driver

*** In order to use this MCI driver your system must support direct
*** video display.


The Media Control Interface (MCI) driver provides a device independent
interface to the FlashBus board.  Any Windows application which
supports MCI can be used to display and capture video images.  Application
developers can communicate with the MCI driver using command-message
functions, although most developers and all end users will probably find
it easier to use the command-string interface.  The command-string
interface provides control of an MCI device using simple command strings.
Many authoring packages allow sending command strings to an MCI device.


Installing manually:
Installation is done by the setup program, but if your setting
is overridden, you may have to install manually.
NT:
Adding this driver can be done in NT with the 'Multimedia' applet
under the Control Panel.  On the 'Devices' tab, click
'Media Control Devices', then click the 'Add' button.  Choose
'Unlisted or updated driver' and browse to the FlashBus MCI\NT folder.
Select the FlashBus MCI driver it finds in that directory.
Win95:
Alter the 'System.ini' in the Windows directory to have the key:
"Overlay=mcifbus.drv"
in the [mci] section.  Reboot Win95 for this value to take
effect.
Note:  Only one overlay driver can be present at a time.


The following is an example MCI command string sequence used to display a
video window and capture the video image to a .BMP file:
	open overlay alias ov
	window ov state show
	freeze ov
	save ov testfile.bmp depth 24
	close ov

The driver setup dialog can be accessed from the Windows Control
Panel 'Drivers' applet.  It allows setting the default video standard,
type, and source as well as video clipping, sizing and moving behaviors.
Most FlashBus cables supply RGB as Source 0 and Composite/SVideo as
Source 1.  The default settings for the 'Video Control' section are
correct for most applications, however, a brief explanation of the
various controls may help in fine tuning the driver for particular
applications:
	Freeze on overlap
	  Freeze the entire video window when another window overlaps part
	  of the video.
	Position video
	  Reposition the video when the associated window is moved.  This
	  setting can only be disabled by an MCI 'SET AUTOWIN' call.
	Size video
	  Resize the video when the associated window is sized.  This
	  setting can only be disabled by an MCI 'SET AUTOWIN' call.
	Keep aspect
	  Resize the video to maintain a 4:3 aspect ratio in all cases.
	  This setting would normally be combined with 'Adjust window' 
	Adjust window
	  Resize the window to exactly match the video size and position.
	Force paint
	  Force a paint message to the window each time the video is moved
	  or sized.
	Oversize video
	  Round the video size up when the window size and position don't
	  match the DWORD alignment requirements of FlashBus.
	Repaint video
	  Restore the video image from an off screen buffer after an
	  overlap while video is frozen.  Use with caution as a large
	  buffer must be allocated when this setting is enabled.
	Always on top
	  Force the video window on top of all other windows.

Parameters marked with an asterisk (*) are FlashBus extensions to the
MCI spec.  Rectangles are specified in the form: X Y Height Width.

Open
Open the FlashBus MCI driver

	Parameter		Note
	ALIAS alias_name	A convenient name for future references
	PARENT hwnd
	STYLE 0-4294967295	WS_xxxx | WS_xxxx...
	STYLE CHILD
	STYLE OVERLAPPED
	STYLE POPUP
	TYPE device_type	Overlay


Close
Close the FlashBus MCI driver

	Parameter		Note
	None


Info
Get information about the FlashBus MCI driver.

	Parameter		Return
	PRODUCT:		FlashBus MCI v1.0
	WINDOW TEXT:		[video window caption]


Capability
Get capabilities of the MCI driver.

	Parameter		Return
	DEVICE TYPE:		Overlay
	WINDOWS:		1
	CAN EJECT:		False
	CAN PLAY:		False
	CAN RECORD:		False
	COMPOUND DEVICE:	False
	USES FILES:		False
	CAN FREEZE:		True
	CAN STRETCH:		True
	HAS AUDIO:		False
	HAS VIDEO:		True
	CAN SAVE:		True


Set
Control FlashBus Video functions.

	Parameter	Note
	VIDEO		on | off
	HUE*		0-255
	BRIGHTNESS*	0-255
	CONTRAST*	0-255
	SATURATION*	0-255
	SHARPNESS*	0-255
	STANDARD*	0 | 1		(NTSC, PAL)
	TYPE*		0 | 1 | 2	(Composite, SVideo, RGB)
	SOURCE*		0 | 1
	FLASHTYPE*	0 | 1 | 2 | 3	(None, Universal, CCD4000, Dual)
	FLASHDELAY*	0-65535
	GRABALIGN*	0 | 1 | 2	(Even, Odd, Any)
	AUTOWIN*	0-65535		(AutoWindow clipping flags)

Status
Get current FlashBus Video and Audio settings.

	Parameter		Return
	VIDEO 			True | False (on|off)
	STRETCH			True | False
	READY			True | False
	WINDOW HANDLE		[handle of current window]
	MEDIA PRESENT		True
	MODE			Stopped
	HUE*			0-255
	BRIGHTNESS*		0-255
	CONTRAST*		0-255
	SATURATION*		0-255
	SHARPNESS*		0-255
	STANDARD*		0 | 1
	TYPE*			0 | 1 | 2
	SOURCE*			1 | 2
	FLASHTYPE*		0 | 1 | 2 | 3
	FLASHDELAY*		0-65535
	GRABALIGN*		0 | 1 | 2
	AUTOWIN*		0-65535
	SWITCH*			0 | -1 (Serial must be at 200 hex)

Freeze
Stop video acquisition, freezing current frame.  Frame alignment is
determined by the current GRABALIGN status.  Default is Odd/Even.

	Parameter		Return
	None

	
Unfreeze
Start video acquisition into the current FlashBus window.

	Parameter		Return
	None


Put
Defines the source, destination, frame, and video rectangles.

	Parameter			Note
	DESTINATION			Rectangle within destination window
	DESTINATION AT rectangle
	FRAME				Unsupported by FlashBus
	FRAME AT rectangle
	SOURCE				Input rectangle
	SOURCE AT rectangle
	VIDEO				Video acquisition rectangle
	VIDEO AT rectangle


Where
Get the current source, destination, and frame (video acquisition) rectangles.

	Parameter		Return
	DESTINATION		rectangle
	FRAME			rectangle
	SOURCE			rectangle
	VIDEO			rectangle
	SELBOX			rectangle


Window
Specify parameters for the FlashBus video display window.

	Parameter		Note
	HANDLE			Use developer supplied window
	HANDLE DEFAULT		Use driver supplied window
	STATE HIDE		As in Windows ShowWindow() call
	STATE ICONIC
	STATE MAXIMIZED
	STATE MINIMIZE
	STATE MINIMIZED
	STATE NO ACTIVATE
	STATE NO ACTION
	STATE NORMAL
	STATE SHOW
	TEXT			Window Title
	FIXED
	STRETCH
	AT* rectangle


Load
Load an image into the video buffer.  The file type will be determined by
the file extension.

	Parameter		Note
	filename		File type is determined by extension
	AT rectangle		Optional offset and clipping size


Save
Save the video buffer.  The file type will be determined by the file 
extension.

	Parameter		Note
	filename		File type is determined by extension
	AT rectangle		Optional offset and clipping size
	DEPTH* 16 | 24 | 32	Default is 24 BPP
	FLAGS*			0-65535 (0-100 QFactor for JPEG)

COPY
CUT
Put the current video image on the clipboard as a 24 bit DIB.

	Parameter		Note
	AT rectangle		Optional offset and clipping size

Download Driver Pack

How To Update Drivers Manually

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.

server: ftp, load: 1.45