                               MPlayer for OS/2 
                              ------------------
                         
1. Introduction
---------------

  This program is the OS/2 port of MPlayer.
  
2. Features
-----------
  
  .Supports SNAP/WarpOverlay!/DIVE
  .Supports DART
                             
3. Requirements
---------------
  
  .kLIBC v0.6.3
 
4. Setting Video/Audio Driver
-----------------------------

4.1 Setting Video Driver
------------------------

  Add the following option.
  
    -vo kva
    
  Or, if you specify nothing, WarpOverlay! -> SNAP -> DIVE is auto-selected. 
But if you want to force a specific mode, add the following option.

    -vo kva:mode 
   
  Where, mode can be 'wo', 'snap', or 'dive'. If you want DIVE mode, do the 
following.
  
    -vo kva:dive
    
  If you have a video card such as S3 on T23 laptop which doesn't have ability 
to downscale, you can use 't23' option.

    -vo kva:t23
       
4.2 Setting Audio Driver
------------------------

  Add the foloowing options.
  
    -ao dart
    
  Or, if you specify nothing, DART is auto-selected.
  
  If you want to open dart as exclusive mode, do the following.
  
    -ao dart:noshare

5. 'MPLAYER_OPTIONS' environment var.
-------------------------------------

  You can use MPLAYER_OPTIONS as well as configuration file to specify your 
favorite options. For examples,

      SET MPLAYER_OPTIONS=-quiet -vo kva:dive
      
  This is the same as the following
  
      MPLAYER -quiet -vo kva:dive
      
6. Slave mode
-------------

  MPlayer has a feature to work as backend, which is slave mode. By this mode, 
MPlayer communicate external program with a 'named pipe'. The format of named 
pipe should be

      \PIPE\MPLAYER\pid
      
  where, pid is process ID of MPlayer.
  
  For details, see 'slave.c' of source package.
  
7. Limits or Known Bugs...
--------------------------
  
  .Win32 codecs is not supported
  .SSSE3(Intel Core 2) is not supported( version of 'binutils' of GCC v3.3.5 
   CSD 3 is old )
    
8. TODOs...
-----------
  
  .Supports Win32 codecs
  .Implement video driver fully
  .Merge patches into MPlayer offical sources
 
9. History specific to OS/2
---------------------------

  - dev-SVN-r25520-OS2-3.3.5 ( 2007/12/29 )
    .Support SNAP overlay( snapwrap.dll is needed, Thanks to Mike Forester )
    .Use XviD library
    .Regardless of colorkey, boundary of movie is fiiled with black color
    .Now, MEncoder.exe is shipped as well( Suggestion by Ilya Zakharevich )

  - dev-SVN-r24878-OS2-3.3.5 Refresh ( 2007/11/04 )
    .On DIVE mode, video is not displayed. Fixed( Report by Mike Forester )
    ( Recompile libkva to make refresh build )

  - dev-SVN-r24878-OS2-3.3.5 ( 2007/10/28 )
    .Support -vf screenshot
    .Support wild cards
    .Support pre-scaling
    .Changed the default dir from /usr/local/lib/codecs to /codecs 
     ( Suggestion by Rainer )
    .Changed 'MPOPT' env. var. to 'MPLAYER_OPTIONS' ( Suggestion by Rainer )
    .Use thread
    .Status line is scrolled. Fixed.
    .-aspect option doesn't work. Fixed( Report by Mike Forester )
    .-colorkey option doesn't work. Fixed.
     ( Use '-colorkey 0x000008' for the same as before )

  - dev-SVN-r23698-OS2-3.3.5 ( 2007/07/01 )
    .Support 'MPOPT' environment variable
    .Support exclusive mode of DART
    .Support VOCTRL_SET_EQUALIER, VOCTRL_GET_EQUALIZER
     ( Brightness/Contrast/Saturation/Hue )
    .Added YV12 as supported image format. Performance Improved
    .Support console input
    .Support DVD
    .Support slave mode
    .Movie is not displayed correctly on WO mode, if you have a video card 
     such as S3 of T23 laptop which doesn't has ability to downscale. Fixed.
     ( Thanks to Franz Bakan for his reporting and testing )
    .Title bar is not activated when using '-fs' option. Fixed
    .Crashed in enable_cache(). Fixed( enlarge stack size of thread )
    .Crashed in init_audio_codec(). Fixed( enlarge stack size of program )

  - dev-SVN-r23385-OS2-3.3.5 ( 2007/05/27 )
    .If cache is used, such as network, MPlayer remains 'Exit T1' status and 
     system hang. Fixed.
    
  - Test ver. ( 2007/05/12 )
    .Support DIVE/WarpOverlay!, DART 
 
10. How to compile
-----------------

10.1 Requirements...
-------------------

  .GNU utilities( sh, cp, rm, mkdir, ... )
  .GNU Make v3.81r2
  .GCC v3.3.5 CSD 3
  .OS/2 ToolKit v4.5
  .FreeType2 v2.1.9( optional, for subtitle/OSD )
  .zlib v1.2.3( optional, for some codecs )
  .mad v0.14.2b( optional, for mp3 )
  .libpng 1.2.18( optional, for screenshot )
  .pthread( Yuri Dario version, optional, for thread ) 
  .Subversion client v1.4.4( optional, for sync with MPlayer latest sources )
  .XviD v1.1.3( optional, for XviD encoding )
  
10.2 Compilation
---------------

  First of all, move to the directory on which you decompressed source archive.

  Then, execute 'configure.cmd'.
  
  After, execute 'make' as the following.

      make SHELL=/bin/sh
  
  Now you can get both 'mplayer.exe' and 'mencoder.exe'.
  
  Finally, you can sync with MPlayer latest sources by doing as the following.
  
      svn update
  
11. Official homepage of MPlayer
--------------------------------

  You can get detailed documents for MPlayer, especially for usage, at 
  
      http://www.mplayerhq.hu
      
12. Contacts...
---------------

  e-mail : komh@chollian.net
  ICQ    : 124861818
  MSN    : komh@chollian.net
  IRC    : lvzuufx, #os2 at HANIRC(irc.hanirc.org)

                                                    2007/12/29, KO Myung-Hun
