Introduction
------------

The goal of the WarpVision project is to create an OS/2 multimedia player
that supports the latest formats, as well as the latest hardware features.


Licensing
---------

See the file COPYING


Status
------

The WarpVision Player is currently undergoing development, but in the interim
you can download the beta versions. All of the work on this project is done in
spare time and is distributed under GNU licencing guidelines.

If you know of some new features that you'd like to see implemented, or even
if you'd just like to do something nice for the authors, you can always make
a financial contribution! To find out how you can help the WarpVision team,
please mail us at wvision@os2.ru.


Installation
------------

     Unzip the zip file, and run wvision.exe for help


Command-line options
--------------------

Usage: WarpVision [options] movie_file

 Audio options:
  -noaudio - Disable audio
  -44100   - Resample audio 48kHz to 44kHz
  -48000   - Resample any audio samplerate to 48kHz
  -adevXX  - Select audio device 0...
  -aidXXX  - Select audio channel

 Video options:
  -vrgb    - Output decoded frames in RGB16
  -vbgr    - Output decoded frames in BGR24
  -vyuv    - Output decoded frames in YUV422
  -idx     - Rebuild AVI file index
  -vidXXX  - Select video channel
  -vaspect - Keep aspect ratio
  -vasp43  - Force aspect ratio to 4:3
  -vasp169 - Force aspect ratio to 16:9

 DVD options:
  -dvdXX   - Select and play title (1...)
  -chapter - Select chapter (1...)
  -angle   - Select angle (1...)

  * Audio stream can be selected by -aid option
  * example: wvision.exe -dvd1 g:

Keyboard control
----------------

Left / Right  - seek backward/forward 15 seconds
                (approximately, to the nearest videoframe)
Up   / Down   - seek backward/forward 1 minute
PgUp / PgDown - seek backward/forward 10 minutes
+    / -      - sync correction
<    / >      - gamma correction
p             - pause movie (press any key)
f             - switch full screen/windowed mode
Esc           - quit program
m             - mute/unmute audio
Ins  / Del    - audio volume correction


Supported formats
-----------------
Files: AVI, MPEG, DAT, VOB, ASF
Audio: MPEG Layer-1,2,3, AC-3, Uncompressed PCM
Video: MPEG-1/2, MPEG-4 v1,2,3,4,5 DivX, MJPEG, Windows Media Video 7 (WMV1)


CVS repository
--------------

The latest Warp Vision source code can be found by anonymous CVS at:

cvs -d:pserver:anonymous@www.netlabs.org:/netlabs.cvs/warpvision login
cvs -d:pserver:anonymous@www.netlabs.org:/netlabs.cvs/warpvision co .

Password: readonly


Authors
-------

Alex Strelnikov (lelik@os2.ru) Author of the WarpVision "kernel",
providing us with the porting and adaptation of audio & video CODECs,
sync, resampling and more.

Vlad Stelmahovsky (vladest@os2.kiev.ua) - WarpVision GUI author,
providing skin support, the player's PM interface and the WVGUI builds.

Alex Samorukov (samm@os2.kiev.ua) - Provider of silly advice, skins,
Web support and organization of the project

Konstantin Okounkov (ok@os2.ru)- Provider of project management,
Web support and documentation

Yvon Letourneau (yvon.letourneau@cogeco.ca) - Provider of English proofreading
for Kiev Elephant, and chocolate milk management
(managing to drink it all by himself!) 


Used software
-------------

Warp Vision uses software from the following free software projects:

liba52 (http://liba52.sf.net/) by Aaron Holtzman and Michel Lespinasse
Free library for decoding ATSC A/52 streams. It is also known as AC-3.

libmpdemux, mp3lib (http://www.MPlayerHQ.hu/homepage/) by Arpad Gereoffy (A'rpi/ESP-team)
Parts of MPlayer project. Stream demultiplexing and mp3 audio decoding.

libmpeg2 (http://libmpeg2.sf.net/) by Aaron Holtzman and Michel Lespinasse
Free MPEG-2 video stream decoder.

ffmpeg (http://ffmpeg.sf.net/) by Fabrice Bellard
Fastest encoder/decoders various audio/video formats.

libDART, libDIVE by Andrew Zabolotny (zap@cobra.ru)
OS/2 audio/video libraries

Gamma correction ideas borrowed from xine project (http://xine.sf.net/)

YUV transforms based on parts of libmpeg2 & MPlayer postproc


Thanks to
---------

"OS/2 User Association Switzerland" for DVD sponsoring!

...

(not completed yet!)


Contacts, support
-----------------

Warp Vision Web: http://www.os2.kiev.ua/
