WarpVision GUI

Description.
The program is representing GUI for WarpVision created by Alex Strelnikov
It is not "launcher" for WV CLI, but includes latest WV CLI features
In future, these sparated projects will be compound in one

Donations.
The WV project is donation-based. It's mean that you can support autors
donating some money for them. Your's support will allow project to live
and growing.
Feel free to donate us via BMT Micro at:
https://secure.bmtmicro.com/ECommerce-OffSite/11980000.html
or directly,by contacting via email

Features.
- plays video media formats: mpeg1/2, avi, asf, mov, mp3 audio, wav
- audio codecs support (pcm, mp3, ac3, wma1, wma2, ms adpcm)
- HWENDIVE/WarpOverlay support (color in YUV422)
- autodetecting color scheme (not always works correctly)
- fullscreen/windowed mode
- aspect ratio on/off in windowed mode
- skin support
- playlist support
- plays last played file (from stop place)
- basic dvd support (uncrypted)
- DVD subtitles support 
- OSD support (On Screen Display)
- reading/writing playlists in WinAmp format
- drag'n'drop to playlist and control window (files and directories)
- play loop for files and lists
- basic (due lack of drivers which support > 2 channels except
  Ruediger "Rudi" Ihle CMedia drivers) multichannel audio support
- PNG support for skins (thanks to Igor Saveliev aka gorynych)
- pipe interface
- Remote control support (Using Remote control daemon from TVSHOW project)
- Single copy running: when wv already running, second wv just exit
  if second wv have file name as parametr, wv pass it to first copy, which
  start play it immideately

Startup.
VIDEO2.EXE [parameters] [media file name]

Command line parameters
  -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
             (MPEG: 0-31 | AVI: 1-99 | ASF: 0-127 | VOB: 128-...)
  -vrgb    - Output decoded frames in BGR24 (default)
  -vyuv    - Output decoded frames in YUV422 (usable if you have hwendive
             or WarpOverlay)
  -idx     - Rebuild AVI file index
  -vaspect - Keep aspect ratio
  -vidXXX  - Select video channel (MPEG: 0-15 | AVI: ...)
  -bri	   - Bright (-128 / 128)
  -pricls  - priority class 0 - 4 (3 by default)
  -pridta  - priority delta -31 - 31 (-31 by default)
  -win     - show movie window at startup
  -nowin   - dont show
  -f<file> - load media file at program startup

NOTE, that there is no spaces between cmdline key and cmdline value  

You can set these parameters only once. Then they will got from INI-file

FullScreen - just double click by left mouse button on show window
	     second doble click will return initial window size

WARNING!! Dont try to switch out on full screen!
          Return to windowed mode first!

Hot keys: (only for Movie window)
   Ctrl-Enter,F       - toggle FS/Window
   Space,P       - pause
   Left, Right   - seek forward/backward at 10 sec
   Up, Down      - seek forward/backward at 60 sec
   PgUp,PgDown   - seek forward/backward at 600 sec
   +/-,Q/A       - sync correction
   Grey +/-      - Audio Volume
   </>           - Bright
   Esc           - return from fullscreen
    Only if Keep Aspect Ratio is turned on:
      Ctrl-1     - force aspect 16:9
      Ctrl-2     - force aspect 4:3
      Ctrl-3     - force aspect 16:9 with cutting edges
      Ctrl-4     - original aspect
   Alt-X         - snap to X
   Ctrl-P        - OSD progress bar on/off

  Warp Overlay only hotkeys:
   W/S - Hardware brigtness (Pressed with control will reset to default)
   E/D - Hardware contrast (Pressed with control will reset to default)
   T/G - Hardware saturation (Pressed with control will reset to default)
   Y/H - Hardware hue (Pressed with control will reset to default)

Hot keys: (only for control window)
   Ctrl-P        - open playlist
   Ctrl-L        - load last played file
   Ctrl-O        - load file
   Alt-F4        - exit

Player control (named pipe interface)
-------------------------------------

The named pipe interface provides simple way to control running copy
of WarpVision. After start, WarpVision prepares server-side
named pipe \PIPE\WV and waits for command.
Command can be send using either programmatically, using DosWrite() API
(or appropriate equivalent in used programming language) or from
command line using "echo" command. For example:

    [Z:\]echo seek fwd 10>\pipe\wv

Following commands are recognised:

    open <name>      - open and play file <name>
    flip pause       - Flip play/stop
    flip fs          - Flip FS/window
    flip mute        - Mute on/off
    seek fwd NNN     - Seek forward for NNN seconds (*)
    seek back NNN    - Seek backward for NNN seconds (*)
    seek pos NNN     - Seek to absolute position (*)
    set gamma NNN    - Set gamma correction to NNN (**)
    set contrast NNN - Set contrast to NNN (**)
    set sync NNN     - Correct synchronization for NNN (***)
    set volume NNN   - Set volume to NNN
    fs               - Switch to FS mode
    window           - Switch to windowed mode
    pause            - Pause playback
    play             - Play media
    mute             - Mute audio output
    unmute           - Enable audio output
    exit             - End playing media (****)
    shutdown         - Shutdown WarpVision

*    Actual seek is performed to the nearest sync frame.
**   Value must be in range from -127 to 127 (inclusively)
***  Value specified in tenth of second
**** Next media is started if available. If not, then player
     exist unless -perm command line switch or appropriate
     configuration file option is specified

Restrictions.
 PlayList is under construction

Requirements.

IBM compatible PC with
OS/2 Warp4 and higher
Video 64k and higher
DIVE
Sound card
UDF for dvd


What is WarpOverlay?

WarpOverlay is replacement of HWENDIVE
WarpOverlay cannot work together with HWENDIVE but WVGUI support both

It is hardware-independent API for video-overlay HW.

Why it developed?
Overlay HW probably the best acceleration HW for motion video players.
Unfortunately,  DIVE  is not best API to work with overlay for many different
reasons. First of all, because DIVE does not take attention to some principle
features of overlays.
1) Overlay limited to only one accelerated window at time.
2) There are no ways to complex (multiple rectangles) clipping. This enforce
   us to use color-keying.
3) Overlay in most cases has different picture controls, like gamma, saturat-
   ion, different filtering modes.

WarpOverlay consist of three main parts: VRAM manager, HW driver, API DLL.
First to is a GRADD drivers, last - stand alone DLL.

WarpOverlay distribution:
 Author WarpOverlay is Valery Gaynullin
 WV authors DOES NOT distributing and supporting WarpOverlay!!!
 More info about WarpOverlay you can find at http://os2.kiev.ua


Authors:
  MPlayer team - original player under OS Linux (demuxer etc)
  Alex Strelnikov - OS/2 version, WV engine
  Vlad Stelmahovsky - GUI version
  Alex Samorukov - skin, web designer & master of http://os2.kiev.ua
  Valery Gaynullin - HWENDIVE, WarpOverlay
  Michal Moucka     - WARPSKIN 

Thanks

Alex Strelnikov aka Lelik for WarpVision
Alex Samorukov aka Samm for skin design, and beta-testing
Sergey Evtushenko aka es for config library and many advices
Dmitry Zakharov aka MadInt for Advanced Controls (playlist)
os/2 comunity silently :)) moral support :)
ibm for..you know :)

Special thanks:
Rostislav Sambook-Nagorny aka DiVersant
Yvon Letourneau aka Yvon
Eirik Oeverby aka Ltning
Jan-Erik L?rka
Dan Rudolph

Contacts.

Vlad Stelmahovsky

vlad_est@mail.ru
vladest@os2.kiev.ua
#os2russian, EFNet, vladest
icq: 5192264

Contacts of other team members You can find at
http://os2.kiev.ua or http://os2.ru

