                               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 로 자동 선택됩니다.

  오디오를 독점 모드로 사용하려면 다음처럼 하십시오.
  
    -ao dart:noshare

5. 환경 변수들...
-----------------

5.1 MPLAYER_HOME 환경 변수
--------------------------

  MPlayer 설정 파일이 있는 디렉토리를 지정합니다. 이 환경 변수가 지정되지
않으면 'HOME' 환경 변수가 지정하는 디렉토리의 '.mplayer' 디렉토리로
지정됩니다. 만일 'HOME' 환경 변수도 지정되지 않았다면 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 의 완전한 경로를 지정합니다. 이 환경 변수는 모질라용 플러그인을 위한 
것입니다. 이 환경 변수가 지정되지 않으면 'PATH' 환경 변수에서 MPlayer 를 
찾습니다.

6. 슬레이브 모드
----------------
  
  MPlayer 는 다른 프로그램의 backend 로서 작동할 수 있는 기능을 가지고 
있습니다. 바로 슬레이브 모드입니다. 이 모드에서는 '이름있는 파이프' 를 통해 
외부 프로그램과 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. 모질라용 플러그인
--------------------

  아주 간단한 형태의 플러그인이 제공됩니다. 패키지에 있는 npmp.dll 을 모질라 
플러그인 디렉토리에 복사하면 됩니다. 파일이 직접 지정되어 있는 경우에만 
올바르게 작동합니다. 스크립트의 경우에는 지원되지 않습니다. 이런 경우에는 
MediaPlayerConnectivity 를 쓰시기 바랍니다.
    
9. 제한 사항 또는 알려진 벌레들...
----------------------------------
  
  .SSSE3(Intel Core 2)를 지원하지 않습니다( GCC v3.3.5 CSD 3 의 binutils 
   버전이 낮습니다 ).
  .플러그인의 경우, DIVE 모드일 때 스크롤하면 잔상이 남음
  
10. 할 것들...
-------------
  
  .비디오 드라이버 기능 완전 구현
  .MPlayer 공식 소스에 패치 합치기
  
11. OS/2 관련 판보기
-------------------

  - dev-SVN-r26012-OS2-3.3.5 ( 2008/02/17 )
    .모질라용 플러그인 지원
    .-wid 선택사항 지원
    .-nokeepaspect 선택사항지원
    .'MPLAYER_CODECS_DIR' 환경 변수 지원( Win32 바이너리 코덱용 )
    .'MPLAYER_PATH' 환경 변수 지원( 모질라 플러그인용 )
    .키패드에 있는 'Enter' 지원
    .libmp3lame 3.97 사용 ( Ilya Zakharevich 씨 제안 )
    .자동모드일 때, 하드웨어 가속 기능이 사용 중이면 DIVE 모드로 전환
    .전화면으로 전환했을 때 창 위치 및 크기 보존
    .SNAP 오버레이가 지원되지 않으면 처음 한 번만 실행되고 두 번째부터 
     비정상적으로 종료. 고침. ( Tom Brown 씨 제보 )
    .'MPLAYER_OPTIONS' 환경 변수 지원 철회
  
  - dev-SVN-r25844-OS2-3.3.5 ( 2008/01/24 )
    .Win32 바이너리 코덱 지원
    .snap 모드일 때 YV12, YVU9 가속 기능 지원
    .VOCTRL_DRAW_IMAGE 지원 
    .명령행의 scale 옵션 사용
     ( 이전과 같은 결과를 얻으려면 '-sws 0' 쓸 것 )
    .비디오 모드의 자동 선택 순서를 wo -> snap -> dive 에서 snap -> wo -> dive 
     로 바꿈
    .snap 모드일 때, YUY2 동영상을 재생하면 대각선 줄무늬가 나타남. 고침.
    .snap 모드일 때, 16M 색상 모드가 아니면 동영상이 안 나타남. 고침.
    .snap 모드일 때, 가속 지원 크기보다 큰 동영상을 재생하면 비정상적으로 
     끝남. 고침.
    .snap 모드일 때, 창을 최소화했다가 복원하면 설정한 속성이 사라짐. 고침.
    .SSE 탐지 안됨. 고침( Andreas Ludwig 씨 제보 ).
    
  - dev-SVN-r25520-OS2-3.3.5 ( 2007/12/29 )
    .SNAP 오버레이 지원( snapwrap.dll 필요, Mike Forester 씨께 감사 )
    .XviD 라이브러리 사용
    .Colorkey 에 상관없이 동영상 주변을 검게 표시
    .배포판에 MEncoder.exe 포함( Ilya Zakharevich 씨 제안 )
    
  - dev-SVN-r24878-OS2-3.3.5 Refreshed ( 2007/11/04 )
    .DIVE 모드일 때, 비디오가 나오지 않음. 고침( Mike Forester 씨 제보 ).
    ( libkva 를 재컴파일하시기 바랍니다 )
    
  - dev-SVN-r24878-OS2-3.3.5 ( 2007/10/28 )
    .-vf screenshot 지원
    .와일드 카드 지원
    .프리-스케일링 지원
    .기본 코덱 디렉토리를 /usr/local/lib/codecs 에서 ./codecs 로 바꿈
     ( Rainer 씨 제안 )
    .MPOPT 환경변수를 MPLAYER_OPTIONS 로 바꿈 ( Rainer 씨 제안 )
    .쓰레드 사용
    .상태줄 스크롤 됨. 고침.
    .-aspect 선택사항 지원 안됨. 고침( Mike Forester 씨 제보 )
    .-colorkey 선택사항 지원 안됨. 고침
     ( 단, 이전처럼 쓰기 위해서는 -colorkey 0x000008 쓸 것 )
    
  - dev-SVN-r23698-OS2-3.3.5 ( 2007/07/01 )
    .'MPOPT' 환경변수 지원
    .DART 독점 모드 지원
    .VOCTRL_SET_EQUALIER, VOCTRL_GET_EQUALIZER 지원
     ( 밝기/대조/채도/색상 조절 가능 )
    .지원되는 이미지 포맷에 YV12 추가. 성능 향상
    .콘솔 입력 지원
    .DVD 지원
    .슬레이브 모드 지원
    .WO 모드일 때, 이미지 축소 기능이 없는 비디오 카드(S3)의 경우, 영상이
     제대로 표시되지 않음. 고침( Franz Bakan 씨 제보 ).
    .'-fs' 선택사항을 쓰면 타이틀 바가 활성화되지 않음. 고침.
    .enable_cache() 에서 비정상적 종료. 고침( 쓰레드 스택 크기 늘림 ).
    .init_audio_codec() 에서 비정상적 종료. 고침( 프로그램 스택 크기 늘림 ).

  - dev-SVN-r23385-OS2-3.3.5 ( 2007/05/27 )
    .캐시 기능(네트워크)을 사용하면 'Exit T1' 상태에서 프로그램이 종료되지 
     않음. 고침.
    
  - 시험판 ( 2007/05/12 )
    .DIVE/WarpOverlay!, DART 지원
  
12. 소스 컴파일하기
------------------

12.1 필요한 것들...
------------------

  .GNU 유틸리티( sh, cp, rm, mkdir, ... )
  .GNU Make v3.81r2
  .GCC v3.3.5 CSD 3
  .OS/2 ToolKit v4.5
  .FreeType2 v2.1.9( 선택, 자막/OSD )
  .zlib v1.2.3( 선택, 일부 코덱 )
  .mad v0.14.2b( 선택, mp3 )
  .libpng 1.2.18( 선택, 스크린샷 )
  .pthread( Yuri Dario 씨 것, 선택, 쓰레드 ) 
  .Subversion client v1.4.4( 선택, MPlayer 최신 소스 합치기 )
  .XviD v1.1.3( 선택, XviD 코덱 인코딩 )
  .libmp3lame 3.97( 선택, mp3lame 인코딩 )
  
12.2 컴파일 하기
---------------

  우선 소스를 풀어놓은 디렉토리로 이동합니다. 
  
  해당 디렉토리에서 configure.cmd 를 실행시킵니다.

  성공적으로 작업이 끝났으면, 아래처럼 make 를 실행시킵니다.

      make SHELL=/bin/sh
  
  컴파일이 끝나면 mplayer.exe 와 mencoder.exe 를 얻을 수 있습니다.

  끝으로, 다음과 같이 하면 MPlayer 최신 소스와 합칠 수 있습니다.
  
      svn update
  
13. MPlayer 공식 홈페이지
-------------------------

  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, 고명훈
