                               MPlayer for OS/2 
                              ------------------
                         
1. 内容
-------

  このプログラムは、MPlayer の OS/2 移植版です。
  
2. 特徴
-------
  
  ・SNAP/WarpOverlay!/DIVE サポート
  ・DART サポート
                             
3. 動作要件
-----------
  
  ・kLIBC v0.6.3
 
4. ビデオ／オーディオドライバーの設定
-------------------------------------

4.1 ビデオドライバーの設定
--------------------------

  以下のオプションを追加した場合、
  
    -vo kva
  
  もしくは（ビデオドライバーのオプションを）何も指定しない場合、
  SNAP → WarpOverlay! → DIVE の順番で自動選択されます。
  強制的に特定のモードにしたい場合は、以下のようにオプションを追加してください。

    -vo kva:mode 
  
  mode の部分は "snap"、"wo"、もしくは "dive" になります。DIVE モードにしたい
  場合は以下のようにしてください。
  
    -vo kva:dive
  
  T23 ラップトップ機の S3 といった、ダウンスケール機能がないビデオカードを
  使う場合は、"t23" オプションが使えます。

    -vo kva:t23
       
4.2 オーディオドライバーの設定
------------------------------

  以下のオプションを追加した場合、
  
    -ao dart
    
  もしくは（オーディオドライバーのオプションを）何も指定しない場合、DART が
  自動選択されます。
  
  DART を占有モードでオープンしたい場合は以下のようにしてください。
  
    -ao dart:noshare

5. 環境変数など
---------------

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

  設定ファイルのある位置を指定します。この変数が指定されていない場合、HOME が
  使われます。ただし、この場合の位置は "%HOME%\.mplayer" になります。どちらの
  変数も指定されていない場合は、MPlayer インストールディレクトリの
  ".mplayer" ディレクトリになります。

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

  この変数はもうサポートされません。代わりに設定ファイルを使ってください。
  設定ファイルは MPLAYER_HOME で指定したディレクトリにある "config" ファイル
  です。以下に例を。

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

  これは以下（のコマンドライン指定）と同じです。

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

  Win32 バイナリコーデックのあるディレクトリを指定します。この変数が指定されて
  いない場合、MPlayer インストールディレクトリの "codecs" ディレクトリが
  用いられます。

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

  MPlayer のフルパスを指定します。これは Mozilla プラグインのためのものです。
  この変数が指定されていない場合、PATH 内にある MPlayer が実行されます。

6. スレーブモード
-----------------

  MPlayer にはバックエンドとして動作する機能、すなわちスレーブモードがあります。
  このモードでは、「ネームドパイプ」で外部プログラムと通信を行います。
  ネームドパイプの名前は、

      \PIPE\MPLAYER\pid
      
  となり、pid の部分が MPlayer のプロセス ID になります。
  
  詳細はソースパッケージの slave.c を参照。
  
7. Win32 バイナリコーデックの利用
---------------------------------

  MPlayer には Win32 バイナリコーデックを利用する機能があります。
  
  この機能を使うには Win32 バイナリコーデックのパッケージが必要です。
  以下の場所から入手できます。

    http://www.mplayerhq.hu/design7/dload.html
    
  ファイルを全部 MPLAYER_CODECS_DIR（の環境変数で指定した場所）に展開すること。
  
8. Mozilla プラグイン
---------------------

  簡単なプラグインが提供されています。本パッケージ中の npmp.dll を Mozilla の
  プラグインディレクトリにコピーしてください。このプラグインはメディアファイルの
  URL が直接指定されている場合にのみ動作します。
  スクリプトはサポートされていません。この場合は MediaPlayerConnectivity が
  使えます。

9. 制限、もしくは既知のバグなど
-------------------------------
  
  ・SSSE3(Intel Core 2) は未サポート（GCC v3.3.5 CSD3 の binutils が古いため）
  ・Mozilla プラグインの場合、DIVE モードではスクロール時に画面表示が
    はみ出す。
   
10. TODO
--------
  
  ・ビデオドライバーをきちんと実装する
  ・MPlayer 本家のソースにパッチをマージ
 
11. 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. コンパイルするには
----------------------

12.1 必要なもの
---------------

  .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 コンパイル
---------------

  まず始めに、ソースアーカイブを展開したディレクトリに移動します。

  それから、configure.cmd を実行。
  
  そのあと、以下のようにして make を実行します。

      make SHELL=/bin/sh
  
  これで mplayer.exe と mencoder.exe のふたつが出来上がり。
  
  最後に、以下のようにして、MPlayer の最新ソースと同期することができます。
  
      svn update
  
13. MPlayer 公式ホームページ
----------------------------

  MPlayer の、特に使い方に関しては、詳しいドキュメントが以下の場所で
  入手できます。
  
      http://www.mplayerhq.hu
      
14. 連絡先
----------

  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

(Japanese translation from readme.eng, by sava)
