                             K Movie Player 시험판
                            -----------------------
                            
1. 소개
-------
  
  이 프로그램은 FFplay 를 바탕으로, 다양한 미디어 파일들을 OS/2 와 
eComStation 에서 재생하기 위해 만들어졌습니다.

2. 제작 환경
------------
  
  - 한국어판 OS/2 Warp v4 with FixPak #15
  
  - GCC v3.3.5 CSD1
  
  - OS/2 ToolKit v4.5
  
  - nasm 0.98.38
  
  - OS2UNIX 환경 ( GNU Make 3.81r2, cp, rm, ... )
      
3. 실행에 필요한 환경
---------------------

  - 오디오 : DART

  - 비디오 : DIVE 또는 WarpOverlay

4. 시험 환경
------------

  한국어판 OS/2 Warp v4 with FixPak #15 와 eComStation 1.2MR 에서 
시험했습니다.

5. 설치
-------

  kmp.exe 를 아무 디렉토리에 넣어 두시면 됩니다.
  
6. 사용법 및 선택사항
---------------------

6.1 사용법
----------

6.1.1 실행하기
--------------
    kmp [선택사항] 입력파일

6.1.2 실행 중에
---------------
q                   끝내기
f, Enter            전체화면/창화면 전환
p, SPC              잠시 멈춤/재개 전환
m                   오디오 켬/끔 전환
a                   오디오 채널 순환
v                   비디오 채널 순환
t                   자막 채널 순환
w                   오디오 파형을 보여줌
left/right          10초 앞뒤 이동
ctrl+left/right     1분 앞뒤 이동
ctrl+down/up        볼륨 5% 씩 낮추기/높이기
mouse click         화면비만큼 위치 이동 

6.2 선택사항
------------

6.2.1 주 선택사항
-----------------
-h                  도움말 보여주기
-video driver       비디오 드라이버 설정 (driver=auto/wo/dive)
-x width            폭을 지정
-y height           높이를 지정
-fs                 전체화면으로 보여줌
-vol level          처음 볼륨값을 퍼센트 단위로 지정
-an                 오디오를 끔
-vn                 비디오를 끔
-ss pos             초단위로 주어진 위치까지 이동
-bytes              바이트 단위로 이동
-nodisp             화면을 보이지 않음
-f fmt              특정 포맷을 선택

6.2.2 고급 선택사항
-------------------
-stats              진행 상태를 보여줌
-debug              디버그 정보를 보여줌
-bug                버그 수정
-vismv              모션 벡터를 시각화하기 
-fast               호환성을 고려하지 않은 최적화
-genpts             pts 만들기
-lowres             
-skiploop
-skipframe
-skipidct
-idct algo          idct 알로리즘 설정
-er threshold       오류 탐지 한계를 설정 (0-4)
-ec bit_mask        오류 무시 선택사항
-rtp_tcp            RTP/TCP 프로토콜 사용
-sync type          오디오-비디오 싱크 타입 설정 (type=audio/video/ext)
-threads count      쓰레드 갯수

6.2.3 KMPOPT 환경변수
---------------------
  자주 쓰는 선택사항들은 KMPOPT 환경 변수에 지정해서 쓸 수 있습니다. 예로,
  
      SET KMPOPT=-vol 50
      KMP 비디오파일
   
  위 경우는 
     
      KMP -vol 50 비디오파일
      
  과 같습니다.
  
7. 제한 사항 또는 알려진 벌레
-----------------------------

  - 재생이 끝나도 프로그램이 종료되지 않음. 'q' 또는 종료 버튼으로 종료해야 
    함.
    
  - 깨어진 파일의 경우 끝까지 재생이 안될 수 있습니다.

  - 잠깐 멈춤때, 화면이 갱신되지 않습니다.
    
  - SNAP 오버레이는 지원되지 않습니다(제가 가지고 있지 않아서...ㅠ.ㅠ)
    
8. 할 것들...
-------------

  - OSD 지원
  
  - 텍스트 파일 자막 지원
  
  - 설정 파일 지원
  
  - SNAP 오버레이 지원
  
9. 판번호 보기
---------------

  - 시험판 ( 2007/02/02 )
    .FFplay 에서 SDL 을 사용하지 않도록 하고, 명칭을 KMP 로 변경.
    .볼륨 조절 기능 추가
    .오디오 켬/끔 기능 추가
    .몇 가지 글쇠 기능 조정
    .잠시 멈춤 기능 개선(잠시 멈춤 상태로 오랜 시간이 지나면 싱크가 맞지 않음)
      
10. 소스 컴파일 하기
--------------------
  제작 환경이 모두 갖추어졌다면, 몇 가지 설정을 바꾸실 필요가 있습니다.
  첫번째, config.mak 에서 다음 세 변수를 자신의 소스를 넣어둔 최상위 
디렉토리로 바꾸어야 합니다. 제 것은 이렇습니다.

    SRC_PATH="/lang/work/kmp/kmp-test"
    SRC_PATH_BARE=/lang/work/kmp/kmp-test
    BUILD_ROOT="/lang/work/kmp/kmp-test"
   
  두번째, 만일 FFplay 를 컴파일하고자 한다면 SDL 라이브러리가 필요합니다. 이 
라이브러리를 설치하시고 다음 두 변수를 적절히 바꾸어 주십시오. 제 것은 
이렇습니다( SDL12.lib 을 SDL.lib 으로 이름을 바꾸었음 ).

    SDL_LIBS=-L/usr/lib -lSDL     #SDL.lib 이 있는 곳   
    SDL_CFLAGS=-I/usr/include/SDL #SDL 헤더가 있는 곳
    
  gcc 는 SDL 헤더 파일과 충돌을 일으킵니다. 이에 대한 해결책은 다음 사이트를 
참조하세요.

    http://www.virtualbox.org/wiki/OS/2%20build%20instructions      
    
  굳이 FFplay 가 필요없을 경우에는, Makefile 파일에서 ffplay 와 관련된 부분을 
지우시면 됩니다. 

  끝으로, C_INCLUDE_PATH, CPLUS_INCLUDE_PATH, LIBRARY_PATH 에 OS/2 ToolKit 
4.5 관련 설정을 해주십시오.

  이제 make 를 실행시키시면 됩니다.

11. 모듈 설명
-------------

  kmp.exe : K Movie Player 실행 파일입니다.
  
12. 하고 싶은 말이 있을 때...
-----------------------------

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