-------------------------------- VIDEO V 0.2 --------------------------------
-----------------------------------------------------------------------------
--------- routines to access the Video-Blaster and compatible cards ---------
------------------------------------------(C) 1994 Bernhard Schwall ---------

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Caution !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
You use of this program on your own risk. There is no guarantee that this
program works correct and that it could not damage to your Videocard or
monitor.
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

VIDEO is a program for using the VIDEO-BLASTER and videocards with the
C&T and Philips chipset, as ROMBO Media Pro+ (perhaps Miro Movie) under
DOS and linux without any driver.

To compile the program do the following steps:
DOS:
You have to use the DJGPP (tested with version 2.5.7). You should also use
GNU's make. Otherwise you have to modify the makefile. Type make and the
program should be compiled. If you get an errormessage you have to edit the
makefile. Delete the first 6 lines of the makefile and there should be no
problem to compile the program. Now edit the file VIDEO.CFG (see below) and
start the program.
If you want to install the program into another directory copy VIDEO.EXE and
VIDEO.CFG into the same directory. If you want to move the config file into
a different directory you have to edit the file vid_main.c and set the path
for VIDEO.CFG in the function "main()".
With some modifications it is possible to compile the routines with Borland
C++, but then you can't use the memory-access or you have to rewrite it
completely. I've used this routines under Windows with Borland Pascal 7.0,
using DPMI for memory-access.


Linux:
If you don't have installed the vgalib or svgalib you have to do this before
compiling VIDEO. Then type make and the program should be made. If you get
into trouble edit the makefile and delete line 4 and 6. If you want to
install the program you have to set the path for the config file in the file
vid_main.c in function "main()". You have to compile the program as root or
you do not get permissions to the ports. After compilization you can start
the program as non-root but be shure you only start it once. There is no
test for multiple execution.


To start the Program first edit the file VIDEO.CFG. If you get an error-
message while starting the program you either typed a unknown name or
you've added blanks to a line. Delete them and try again. Lines beginning
with a '#' are ignored. All numbers must be given in decimal values. Ignore 
the lines not usable for your card (especially the 'Volume'-setting).
Especially you must set the port-address of your videocard, the memoryaddress
and the H- and V-sync of your VGA-card for the standard VGA-mode 0x12, 
640x480x16. The settings are the same as used by the original software under
Windows. So you can use this settings if the default settings would'nt give
you a good picture.
The volume setting is only usefull if you have a ROMBO Media Pro Plus (as I).

After editing VIDEO.CFG you can start the program by typing 'VIDEO'. The
following command line options are available:
-d   delete the memory of the videocard while initialisation.
     This should only be used if you have less then 16 MB ram installed.
     Otherwise you meight crash your system.

If you get the program start and see the live-video you can press the 
following keys:
'3'     : display the video with 640x480
'4'     : display the video with 368x286 (half size PAL)
'5'     : display the video with 320x240 (half size NTSC, I think)
's'     : freeze or unfreeze the video
'l','+' : louder (volume on Media Pro+)
'q','-' : quieter (volume on Media Pro+)
'm'     : switch sound off and on (on Media Pro+)
'w'     : save the picture in the actually shown resolution as TARGA-file
          with the name picXXX.tga, where XXX is a number between 0 and 999.
          The number is selected so that no file will be deleted, even if you
          start the program a second time having previor saved pics in the
          directory.
'g'     : read saved pics with the name picXXX.tga and display them in the 
          original size. XXX is a number between 0 and 999. The pics are
          loaded in revers order, first the picture with the highest number,
          then the picture with a lower number, and so on.
'ESC'   : leave the program

About the save and load options:
Use this options only if you have less then 16 MB ram installed and set up 
your config file correctly. Otherwise you meight corrupt your system.

About the pictures:
If you want to show them under linux with XV you will need to convert them
into another format. You can use either tgatoppm to convert them into PPM-
format or cjpeg to convert them into JPG-format.

It would be nice if you would send me your comments and VIDEO.CFG file (if
running).

Bernhard Schwall
e-mail: schwall@athene.informatik.uni-bonn.de

This program comes without any warranty. You are using it at your own risk.
The program is released into the public domain. You may use, modify, copy and
distribute this without restrictions but without charging money for it.
