home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / videotlk.zip / README.1ST < prev    next >
Text File  |  2000-05-24  |  6KB  |  153 lines
  1.  
  2.                         Video Toolkit For OS/2
  3.                         ======================
  4.  
  5. Last Updated 24th May 2000
  6.  
  7. Introduction
  8. ============
  9.  
  10. The OS/2 Video Toolkit has been designed to fulfill two functions :
  11.  
  12. 1) Provide support for live video overlay & image capture under OS/2 2.X
  13.    and later
  14. 2) Provide examples and libraries so that 3rd parties can develop
  15.    their own TV aware applications - quickly and simply.
  16.  
  17. This toolkit is for use with the Hauppauge Win/TV Celebrity, Prism, HighQ
  18. and the Wincast range of video capture devices. It contains 4 sample
  19. applications plus full documentation and files for building your own
  20. Presentation Manager multimedia applications based around the cards.
  21. The OS/2 Video Toolkit supports video from cable TV, camcorder, video
  22. cameras and VCRs.
  23.  
  24. All tools, utilities and examples are designed to work under all
  25. versions of OS/2 after & including OS/2 2.0.
  26.  
  27. The toolkit contains the following utilities :-
  28.  
  29.     TV2CFG.EXE  - Utility for configuring Win/TV Celebrity & HighQ
  30.                   for OS/2 2.X
  31.     PMTV2.EXE   - Celebrity TV utility for OS/2 2.X
  32.     RCON.EXE    - Rocket Remote Control
  33.     PIP.EXE     - Picture In Picture which allows more than one
  34.                   video input to be displayed in one apllication.
  35.     PMDIAG.EXE  - Utility to diagnose & display current TV settings.
  36.  
  37. The toolkit contains the following example source programs :-
  38.  
  39.     DIAG - A simple command line diagnostic tool. The makefile supplied
  40.         with this tool assumes you are using Microsoft C6.
  41.     EX1 - The Hello World TV app. Puts a TV on the desktop
  42.     EX2 - EX1 + remote control
  43.     EX3 - EX2 + invoke configuration settings
  44.     EX4 - EX3 + single frame capture
  45.     DIVE An example application using Dive
  46.     CAM - A simple example web cam system
  47.  
  48. The source code examples require the IBM CSet 'C' compiler. Alternative
  49. 32 bit 'C' compilers may be used.
  50.  
  51. The toolkit contains the following on-line development docs :-
  52.  
  53.     Document for the MMPM/2 low level IOCTL interface.
  54.     N.B. These docs are now out of date.
  55.  
  56.  
  57. Requirements
  58. ============
  59.  
  60. In order to use the Video Toolkit For OS/2 you must have the Multmedia For OS/2
  61. installed. You must also have a copy of the following files which will be
  62. shipped with WarpTV for OS/2 Warp. The files are as follows :-
  63.  
  64.             1)  CELEB.SYS    - Celebrity card device driver.
  65.             2)  VCAI.DLL     - MMPM/2 low level IOCTL interface.
  66.             3)  CELEBNB.DLL  - Configuration pages for the Celebrity
  67.                                card.
  68.  
  69. For the Wincast boards the files will be :-
  70.  
  71.             1)  WCAST.SYS    - Wincast card device driver.
  72.             2)  VCAI.DLL     - MMPM/2 low level IOCTL interface.
  73.             3)  WCASTNB.DLL  - Configuration pages for the Wincast
  74.                                card.
  75.  
  76.  
  77. Creating An Installation Diskette from ZIP file
  78. ===============================================
  79.  
  80. If this toolkit was shipped to you in a zipped format you will need to
  81. create an image to install from.
  82.  
  83. To create an installation image take the following steps :-
  84.  
  85.         1)  Insert a blank formatted floppy disk into drive A.
  86.  
  87.         2)  From the directory containing VIDTLKT.ZIP type the
  88.             following :-
  89.                     pkunzip -d vidtlkt *.*
  90.  
  91.  
  92.             N.B. This will unzip all the files into the current
  93.                  directory.
  94.  
  95.  
  96. Installation
  97. ============
  98.  
  99. To install the Video Toolkit For OS/2 you must take the following steps :-
  100.  
  101.         1)  Go to the directory containing the video toolkit image.
  102.  
  103.         2)  To install the toolkit you must supply the installation
  104.             script (INSTALL.CMD) with a drive letter and the name of the
  105.             directory you wish to use for the toolkit. For example :-
  106.  
  107.                     install c:\vcatlkt <return>
  108.  
  109.         3)  The installation will create all the directories used by the
  110.             toolkit and then copy all the files to the relevant directories.
  111.             Once the files have been copied the installation script will
  112.             create a desktop folder containing three subsequent folders
  113.             which contain the Samples, Information, and Utilities.
  114.  
  115.         4)  In order to develop applications to use the VCAI.DLL which is
  116.             supplied with WarpTV you must first copy the include files in
  117.             the H subdirectory to your compiler's include directory or add
  118.             the H subdirectory to your include path. You must also copy the
  119.             library files in the LIB subdirectory to your compiler's lib
  120.             directory or add the LIB subdirectory to your lib path.
  121.  
  122.  
  123. If you have any problems installing/using the toolkit then please fill in
  124. a defect report, a copy of which is in the toolkit directory, and contact us as
  125. follows :-
  126.  
  127. Abbotsbury Software Ltd.,
  128. West Yard Barn,
  129. West Street,
  130. Abbotsbury,
  131. Dorset,
  132. England DT3 4JT.
  133. Telephone : +44 (0)1305 871543
  134. Fax :       +44 (0)1305 871688
  135. E-Mail :    tim@wdi.co.uk
  136. URL         http://www.os2tv.com
  137.  
  138. Uninstalling
  139. ============
  140.  
  141. To uninstall change directory to the toolkit directory and type the following
  142. command :-
  143.  
  144.                 uninst <return>
  145.  
  146. This will delete all of the toolkit files and destroy the desktop objects.
  147.  
  148. WARNING:
  149.  
  150. This utility deletes all files in the current directory and all subdirectories.
  151. Please make sure you have backed up ALL files you do not want to delete.
  152.  
  153.