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

2. 제작 환경
------------
  
  - 한국어판 OS/2 Warp v4 with FixPak #15
  
  - GCC v3.3.5 CSD 3
  
  - OS/2 ToolKit v4.5
  
  - OS2UNIX 환경 ( GNU Make v3.81r2, cp, rm, ... )

  - lxlite v1.3.3 ( 디버깅 정보 제거 )
      
3. 실행에 필요한 환경
---------------------

  - 오디오 : DART

  - 비디오 : DIVE 또는 WarpOverlay!
  
  - RunTime : kLIBC v0.6.3

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분 앞뒤 이동
down/up             볼륨 1% 씩 낮추기/높이기
Ctrl+down/up        볼륨 5% 씩 낮추기/높이기
mouse click         화면비만큼 위치 이동 
+/-                 글꼴 크기 크게/작게
Alt-0/1/2/3         각각 화면비를 none/original/force43/force169 으로 바꾸기
8/9                 밝기 5 단계씩 어둡게/밝게 ( wo 만 지원 )
i/o                 대비 5 단계씩 낮추기/높이기 ( wo 만 지원 )
k/l                 채도 5 단계씩 낮추기/높이기 ( wo 만 지원 )
,/.                 색상 5 단계씩 낮추기/높이기 ( wo 만 지원 )
/                   밝기/대비/채도/색상 기본값으로 ( wo 만 지원 )
[/]                 텍스트 파일 자막 싱크 0.5 초씩 빨리/느리게

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

6.2.1 주 선택사항
-----------------
-h                  도움말 보여주기
-video driver       비디오 드라이버 설정 (driver=auto/wo/dive)
-x width            폭을 지정
-y height           높이를 지정
-s size             프레임 크기 지정 (폭X높이)
-fs                 전체화면으로 보여줌
-vol level          처음 볼륨값을 퍼센트 단위로 지정
-an                 오디오를 끔
-vn                 비디오를 끔
-ss pos             초단위로 주어진 위치까지 이동
-bytes              바이트 단위로 이동
-nodisp             화면을 보이지 않음
-f fmt              특정 포맷을 선택
-subfont xx.name    자막 글꼴과 크기 지정 (xx=크기, name=글꼴 이름)
-aspect ratio       화면비율 지정 (ratio=none, original, force43, force169)
-framedrop          필요하면 프레임을 표시하지 않음
-hidemouse          전체화면에서 마우스 포인터를 감춤
-brightness level   밝기 지정, wo 만 지원(level=0..255)
-contrast level     대비 지정, wo 만 지원(level=0..255)
-saturation level   채도 지정, wo 만 지원(level=0..255)
-hue level          색상 지정, wo 만 지원(level=0..255)
-res48              48KHz 오디오를 44.1KHz 오디오로 변환(실험중)
-subimg             자막/OSD 를 이미지에 직접 출력
-subcolor f,o,s     자막색을 16진수 RGB 형태로 지정(f=글꼴, o=윤곽, s=그림자) *
-osdcolor f,o,s     OSD색을 16진수 RGB 형태로 지정(f=글꼴, o=윤곽, s=그림자) *

* 기본값은 f=FFFFFF, o=010101, s=010101. 단, 15/16 비트 컬러 모드일 경우 
  o=0F0F0F, s=0F0F0F 추천.

6.2.2 고급 선택사항
-------------------
-ast
-pix_fmt format     화소 형식을 지정
-stats              진행 상태를 보여줌
-debug              디버그 정보를 보여줌
-bug                버그 수정
-vismv              모션 벡터를 시각화하기 
-fast               호환성을 고려하지 않은 최적화
-genpts             pts 만들기
-drp                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      쓰레드 갯수
-fixt23             이미지 축소 기능이 없는 비디오 카드(S3)의 문제 해결
-noaudioshare       오디오를 독점 모드로 사용

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

  - 일부 동영상 파일은 끝까지 재생이 안되거나, 자동종료가 안됩니다.

  - SNAP 오버레이는 지원되지 않습니다(제가 가지고 있지 않아서...ㅠ.ㅠ)
  
  - dive 모드일 때, OSD 와 자막의 테두리와 그림자가 제대로 표시되지 않습니다. 
    GpiBitBlt() 에 필요한 기능이 없습니다. -subimg 을 사용하십시오.
    
  - dive 모드일 때, OSD 와 자막이 깜빡거립니다. -subimg 을 사용하십시오.

  - 자막 파일의 코드 페이지 변환을 지원하지 않습니다.
  
  - 지정한 이름과 크기를 가진 글꼴이 없을 경우, 시스템 기본 글꼴(WarpSans 
    Combined)이 사용됩니다. 하지만 이 경우에는 글꼴 크기를 조절할 수 없습니다.

  - 음파 모드에서 OSD 가 깜박 거립니다.
  
  - 잠시 멈춤 상태에서 갱신될 때 부하가 매우 큽니다.

  - 가끔, 동영상의 끝부분에서 이동 기능이 작동되지 않습니다.

  - Non-interleaved AVI 파일은 제대로 지원되지 않습니다.
  
8. 할 것들...
-------------

  - 설정 파일 지원
  
  - SNAP 오버레이 지원

  - 슬라이더바 지원
  
9. 판번호 보기
---------------

  - v0.3.1 ( 2007/06/24 )
    .비디오 스트림이 없으면 음파 모드로 전환
    .오디오 독점 모드 지원
    .자막, OSD 색 지정 지원
    .비디오 스트림이 없으면 비정성적 종료. 고침( Franz Bakan 씨 제보 )
    .WO 모드일 때, 이미지 축소 기능이 없는 비디오 카드(S3)의 경우, 영상이 
     제대로 표시되지 않음. 고침( Franz Bakan 씨 제보 )
    .음악 파일을 재생할 때, 잠시 멈춤 상태에서도 화면이 지속적으로 갱신됨. 고침
    .-fs 선택사항 제대로 작동하지 않음. 고침
    .높이가 0 이 되면 비정상적 종료. 고침
    .DIVE 모드일 때, 15/16 비트 컬러 모드에서 색상이 다르게 나타남. 고침
    .15/16 비트 컬러 모드에서 -subimg 쓰면 자막이 깨끗하지 않음. 고침
    .15/16 비트 컬러 모드에서 글자 테두리 표시 안됨. -subcolor, -osdcolor 로 
     테두리와 그림자 색을 적당하게 지정하십시오.
     예를 들면 -subcolor ,0F0F0F,0F0F0F -osdcolor ,0F0F0F,0F0F0F
    .osdInvalidate() 에서 SIGSEGV 발생. 고침
    .tbDelete() 에서 SIGSEGV 발생. 고침
    .때때로 창크기가 동영상 크기와 상관없이 640x480 으로 설정됨. 고침
    
  - v0.3.0 ( 2007/05/27 )
    .FFmpeg 2007/05/24 소스 사용
    .자막/OSD 를 이미지에 직접 출력 지원( DIVE 모드일 때 유용 )
    .AAC 오디오 포맷 지원
    .48KHz 오디오를 44.1KHz 로 변환 지원(실험중)
    .libyuv 대신에 libswcale 사용
    .fastmemcpy() 사용
    .자막/OSD 비트맵 오른쪽이 잘림. 고침.
    .이동시 자막이 지워지지 않는 경우가 있음. 고침.
    
  - v0.2.2 ( 2007/03/14 )
    .부동 소숫점 연산이 때때로 실패함. 고침.
    .'/' 눌렀을 때 해당 OSD 출력 안 됨. 고침.
    .자동 종료 확인 방법 바꿈

  - v0.2.1 ( 2007/03/04 )
    .코덱의 이미지 포맷이 YUV420P 일 때, 성능 향상
    .잠시 멈춤 상태에서 화면 갱신 안됨. 고침.
    .음파 모드에서 OSD 출력 안됨. 고침.
    .wo 모드에서 윈도의 보이는 부분이 달라지면, 화면이 깜박 거림. 고침
    .v0.2.0 에서 '-hidemouse' 선택사항의 기여자가 Dmitry Froloff 씨였음을 
     빠뜨렸음. 고침.
    
  - v0.2.0 ( 2007/02/26 )
    .각종 정보를 TitleBar 에 표시하지 않고, OSD 로 표시
    .framedrop 기능 지원
    .전체화면일 때 마우스 포인터 감추기 기능 지원( by Dmitry Froloff )
    .밝기/대비/채도/색상 조절 기능 지원( wo 에서만 )
    .텍스트 파일 자막 싱크 조절 기능 지원
    .WarpCenter 가 있을 때 전체화면으로 바꾸면, WarpCenter 가 사라지지 않음. 
     고침( by Dmitry Froloff )
    .비트맵 글꼴 선택이 안됨. 고침
    
  - v0.1.0 ( 2007/02/12 )
    .재생이 끝나면 자동 종료
    .텍스트 파일 자막 지원( SAMI 파일만 시험했음 )
    .글꼴 크기 바꾸기 지원
    .화면 비율 바꾸기 지원
    .재생 정보를 타이틀바에 표시
    .이동 기능 개선
    .소스 파일 모듈화
    
  - 시험판 ( 2007/02/02 )
    .FFplay 에서 SDL 을 사용하지 않도록 하고, 명칭을 KMP 로 변경.
    .볼륨 조절 기능 추가
    .오디오 켬/끔 기능 추가
    .몇 가지 글쇠 기능 조정
    .잠시 멈춤 기능 개선(잠시 멈춤 상태로 오랜 시간이 지나면 싱크가 맞지 않음)
      
10. 소스 컴파일 하기
--------------------

  소스 파일들을 원하는 디렉토리에 풀고, C_INCLUDE_PATH, CPLUS_INCLUDE_PATH, 
LIBRARY_PATH 에 OS/2 ToolKit 4.5 관련 설정을 해주십시오.
  
  이제 configure.cmd 를 실행시킵니다.
  
  작업이 끝났으면 다음처럼 make 를 실행시킵니다.
  
      make SHELL=/bin/sh

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

  kmp.exe : K Movie Player 실행 파일입니다.

12. 참조한 프로젝트
-------------------

  FFplay      : 기본 플레이어
  WarpVision  : libdart, libsub
  MPlayer     : liba52, libfaad, libvo
  
13. 알아두기
------------

  KMP 는 Morphing 기법을 쓰기 때문에, 항상 텍스트 창이 열립니다. 그래서 파일 
연결 기능을 쓸 때, 항상 열리는 텍스트 창이 성가십니다. 이럴 때는 이렇게 
하시면 됩니다.

  일단, ToolKit 4.5 에 있는 MARKEXE.EXE 가 필요합니다. 준비가 되었으면 이렇게 
하십시오.

    copy kmp.exe kmppm.exe
    markexe windowapi kmppm.exe
  
  이제 kmppm.exe 를 파일 연결에 사용하시면 됩니다. 이렇게 하면, 텍스트 창이 
열리지 않고, KMP 가 실행이 됩니다. 물론 도움말이라든지 기타 정보는 화면에 
표시되지 않습니다. 파일 연결 기능에만 쓰십시오. ^^

14. 하고 싶은 말이 있을 때...
-----------------------------

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