                               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, SNAP -> WarpOverlay! -> DIVE is auto-selected. 
But if you want to force a specific mode, add the following option.

    -vo kva:mode 
   
  Where, mode can be 'snap', 'wo', 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. Environmental Variables...
-----------------------------

5.1 MPLAYER_HOME
----------------

  Specify the directory where configuration file exist. If this is not 
specified, use 'HOME'. But it is '%HOME%\.mplayer'. And if this is specified 
neither, it is the '.mplayer' directory of the directory where MPlayer is 
installed.

5.2 MPLAYER_OPTIONS
-------------------

  This is not supported any more. Instead use configuration file. It is 
'config' file in the directory where 'MPLAYER_HOME' specify. The following is 
example.

    # Write your default config options here!
    quiet=yes
    vo=kva:dive

This is the same as the following.

    MPLAYER -quiet -vo kva:dive
      
5.3 MPLAYER_CODECS_DIR
----------------------

  Specify the directory where Win32 binary codecs exist. If this is not 
specified, use 'codecs' directory of the directory where MPlayer installed.

5.4 MPLAYER_PATH
----------------

  Specify the full path of MPlayer. This is for Mozilla plugin. If this is not 
specified, MPlayer in 'PATH' is executed.

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. Using Win32 binary codecs
----------------------------

  MPlayer has a feature to use Win32 binary codecs.
  
  To use this feature, you need a Win32 binary codec package. You can get it 
the following.

    http://www.mplayerhq.hu/design7/dload.html
    
  Then, extract all the files to 'MPLAYER_CODECS_DIR'.
  
8. Mozilla Plugin
--------------------

  Very simple plugin is provided. Copy 'npmp.dll' in this package to Mozilla 
plugins directory. This plugin works only with URL which point to media file 
directly. Script is not supported. In this case, you can use 
'MediaPlayerConnectivity'.

9. Limits or Known Bugs...
--------------------------
  
  .SSSE3(Intel Core 2) is not supported( version of 'binutils' of GCC v3.3.5 
   CSD 3 is old )
  .In case of Mozilla plugins, Part of image is displayed outside of plugin 
   window when scrolled on DIVE mode.
   
10. TODOs...
-----------
  
  .Implement video driver fully
  .Merge patches into MPlayer offical sources
 
11. History specific to OS/2
---------------------------

  - dev-SVN-r26012-OS2-3.3.5 ( 2008/02/17 )
    .Support Mozilla plugins
    .Support '-wid' option
    .Support '-nokeepaspect' option
    .Support 'MPLAYER_CODECS_DIR' env. var. for Win32 binary codecs
    .Support 'MPLAYER_PATH' env. var. for Mozilla plugin 
    .Support 'Enter' on Keypad.
    .Use libmp3lame library ( Suggestion by Ilya Zakharevich )
    .Fall back to DIVE if HW is in use when auto-mode
    .Maintain the position and size of window when switching to full screen
    .MPlayer crashed abnormally if SNAP overlay is not supported. Fixed.
    .Dropped support of 'MPLAYER_OPTIONS'

  - dev-SVN-r25844-OS2-3.3.5 ( 2008/01/24 )
    .Support Win32 binary codecs
    .Support YV12 and YVU9 acceleration on snap mode.
    .Support VOCTRL_DRAW_IMAGE
    .Use scale option from cmd line
     ( Use '-sws 0' option for the same performance to the previous build )
    .Changed the order for auto-selection of video mode from wo -> snap -> 
     dive to snap -> wo -> dive.
    .On snap mode, when playing YUY2 movie, diagonal stripes are displayed. 
     Fixed.
    .On snap mode, movie is not displayed on other mode than 16M colors one. 
     Fixed.
    .On snap mode, if a movie size is larger than the acceptable one, MPlayer 
     crashed. Fixed.
    .On snap mode, Once restore a window after minimize it, all attributes are 
     reset. Fixed.
    .SSE is not detected. Fixed( report by Andreas Ludwig )

  - 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 
 
12. How to compile
-----------------

12.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 )
  .libmp3lame v3.97( optional, for mp3lame encoding )
  
12.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
  
13. Official homepage of MPlayer
--------------------------------

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

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

                                                    2008/02/17, KO Myung-Hun
