
                               UPDATE.TXT File

     Release Notes for RadiSys Corp. PC Video Development Libraries

				Version 1.01

		  (C) Copyright RadiSys Corporation, 1993

    This document contains release notes for Version 1.01 of the RadiSys Corp. 
    PC Video Development Libraries for DOS/Windows and OS2/PM environment. 

    =======================================================================
    Contents
    =======================================================================

    Part	Description
    ----	-----------

    1		Differences from documentation

    2		New Functions

    3		Enhancements since Version 1.0

    =======================================================================
    Part 1: Differences from documentation.
    =======================================================================

	DOS/WINDOWS
	-----------
	Support is provided for saving and retrieving images to files.  Two
	file formats are available under the library: device-independent
	bitmap, and TIFF (Tagged Image File Format).

	Device-independent bitmap specify pixel color in a form independent
	of the method used by any device to represent color.  Each pixel is
	represented by 24 bits of RGB information.  The file extension for
	bitmap files is .BMP.

	TIFF is a tag based file format designed to promote the interchange 
	of digital image data.  A TIFF file consists definitions of individual 
	fields.  Each pixel is represented by 24 bits of RGB information.  
	The file extension for TIFF files is .TIF.

	The Windows Clipboard allows different application within Windows to
	exchange data.  It provides a place from which applications can pass
	data to other applications.  The new library enables data to be 
	transferred to the clipboard.

	The PCVTuner program supports the above new functionalities.

	OS2/PM
	------
	Support is provided for saving and retrieving images to files.  File
	format available under the library: device-independent bitmap. 
	Clipboard support is also available.

	The PCVTuner program supports the above new functionalities.

	The PM demo program now also implements horizontal scrolling. This 
	demonstrate the technique of moving a viewport around the boundaries 
	of the frame buffer.

    =======================================================================
    Part 2: New Functions
    =======================================================================
	DOS/WINDOWS
	-----------
	PCV_ClipRect (xVI, yVI, cxVI, cyVI)

	This function defines the video input region to be copied on to
	the clipboard.

	Parameter	Type	  Description
	xVI		unsigned  X-position of the video input window's
			short     upper left corner in video input coordinates.

	yVI		unsigned  Y-position of the video input window's
			short     upper left corner in video input coordinates.

	cxVI		unsigned  Width of the video input window's.
			short     

	cyVI		unsigned  Height of the video input window's.
			short     

	Return Value	Description
	PCV_SUCCESS	Image copied onto clipboard.
 	ERR_ALLOCATE	Memory could not be allocated.
	ERR_DATA	Unable to write to clipboard.



	PCV_LoadBmpFormat(lpFile, xVI, yVI)

	This function defines the BMP file to be loaded to the frame buffer.
	The size of the image depends on the definition of the image in the
	BMP file.  If image is greater than the height of the frame buffer,
	there will be a horizontal wrap around.

	Parameter	Type	  Description
	lpFile		char	  Name of BMP file to load.
			far *

	xVI		unsigned  X-position of the start of BMP image 
			short     upper left corner in video input coordinates.

	yVI		unsigned  Y-position of the start of BMP image
			short     upper left corner in video input coordinates.

	Return Value	Description
	PCV_SUCCESS	Image is loaded from file.
 	ERR_API		Protected Mode API services not available.
	ERR_OPEN	File open error, file may not exist.	
 	ERR_ALLOCATE	Memory could not be allocated.
	ERR_DATA	File does not have sufficient data.
	ERR_FORMAT	File is not in BMP format.
	ERR_24RGB	File is not 24 bit RGB format.



	PCV_SaveBmpFormat(lpFile, xVI, yVI, cxVI, cyVI)

	This function defines the video input region to be saved on to
	a BMP file.

	Parameter	Type	  Description
	lpFile		char	  Name of file to save image under.
			far *

	xVI		unsigned  X-position of the video input window's
			short     upper left corner in video input coordinates.

	yVI		unsigned  Y-position of the video input window's
			short     upper left corner in video input coordinates.

	cxVI		unsigned  Width of the video input window's.
			short     

	cyVI		unsigned  Height of the video input window's.
			short     

	Return Value	Description
	PCV_SUCCESS	Image save to file.
 	ERR_API		Protected Mode API services not available.
	ERR_CREATE	File creation error, may be disk problem.
 	ERR_ALLOCATE	Memory could not be allocated.		
	ERR_DISKFULL	File write error, disk may be full.



	PCV_LoadTiffFormat(lpFile, xVI, yVI, hInst)

	This function defines the TIFF file to be loaded to the frame buffer.
	The size of the image depends on the definition of the image in the
	TIFF file. 

	Parameter	Type	  Description
	lpFile		char	  Name of TIFF file to load.
			far *

	xVI		unsigned  X-position of the start of BMP image 
			short     upper left corner in video input coordinates.

	yVI		unsigned  Y-position of the start of BMP image
			short     upper left corner in video input coordinates.

	hInst		HANDLE	  Handle to the instance of current application.

	Return Value	Description
	TRUE		Image is loaded from file.
	FALSE		Image is not loaded.



	PCV_SaveTiffFormat(lpFile, xVI, yVI, cxVI, cyVI, hInst)

	This function defines the video input region to be saved on to
	a TIFF file.

	Parameter	Type	  Description
	lpFile		char	  Name of file to save image under.
			far *

	xVI		unsigned  X-position of the video input window's
			short     upper left corner in video input coordinates.

	yVI		unsigned  Y-position of the video input window's
			short     upper left corner in video input coordinates.

	cxVI		unsigned  Width of the video input window's.
			short     

	cyVI		unsigned  Height of the video input window's.
			short     

	hInst		HANDLE	  Handle to the instance of current application.

	Return Value	Description
	TRUE		Image is saved to file.
	FALSE		Image is not saved.


	OS2/PM
	------
	PCV_ClipRect()
	PCV_LoadBmpFormat()
	PCV_SaveBmpFormat()

	Refer to DOS/WINDOWS for definition.


    =======================================================================
    Part 3: Enhancements since Version 1.0
    =======================================================================

    New Menu Selection
    ------------------
    The PCVTuner program has a new menu selection which allows the user to
    select between VTR or TV mode.  Selecting VTR mode improves the video
    quality when playing back a tape from a video machine.  TV mode improves
    the video quality when viewing broadcast TV.

    New Function
    ------------
    PCV_SetVTR (mode)

    This function defines the VTR/TV mode.

    Parameter	Type	  Description
    mode	unsigned  A zero will set the hardware for broadcast TV and
    		char	  a non-zero value sets the hardware for VTR.


    Bug Fixes/Updates
    -----------------
    When saving a file, if a file extension is not provide, one will be 
    supplied depending on the file format the user has chosen.

    PCVTuner has been updated to display the current mode under the "Standard"
    option.    

    All four I/O base addresses (AD6h, AE6h, BA6h, and BE6h) are now supported.
