C. How to report bugs
@@ -213,6 +215,58 @@
It's still under development, but it will be merged and released real soon.
BTW he needs some nice skins, if you are a good graphician, contact him!!!
+1.5. Subtitles and OSD
+
+Yes, MPlayer also supports many kinds of subtitles. Currently
+7 kinds of subtitle can be used by the subreader code. To see what are
+these subtitle formats, see subreader.c, line ~20.
+
+Subtitles are displayed with a technique called 'OSD', On Screen Display.
+OSD is used to display current time, volume bar, seek bar etc.
+
+INSTALLING OSD and SUB
+
+You need an MPlayer font package to be able to use OSD/SUB feature.
+There are many ways to get it:
+
+
+- use the font generator tool at TOOLS/subfont-c
+It's a complete tool to convert from TTF/Type1/etc font to mplayer font pkg.
+(read TOOLS/subfont-c/README for details)
+
+
- use the font generator GIMP plugin at TOOLS/subfont-GIMP
+(note: you must have HSI RAW plugin too, see URL below)
+
+
- download ready-to-use font packages from MPlayer site.
+Note: currently available fonts are limited for iso 8859-1/2 support,
+and there are a few special versions for korean, russian etc codepages.
+You better build fonts yourself with the tool mentioned above.
+Font should have appropriate font.desc file which maps unicode font
+positions to the actual code page of the subtitles text. Other solution
+is to have subtitles encoded in utf8 encoding and use -utf8 option
+or just name the subtitles file .utf and have it in the same
+dir as the video file. Recoding from different codepages to utf8 could be
+done by using konwert (debian) or iconv (RedHat) programs.
+Some URLs:
+
+
+After that, UNZIP the files to ~/.mplayer/font/ .
+Now you have to see a clock at the upper left corner of the movie
+(switch it off with 'o') .
+
+OSD has 3 states: (switch with 'o')
+
+ - clock + volume bar + seek bar + subtitles (default)
+
- volume bar + seek bar + subtitles
+
- subtitles only
+
+
+You can change default behaviour by setting osdlevel= variable in config file.
+
2. Features
2.1. Video Formats, Audio & Video Codecs
@@ -306,7 +360,7 @@
end
If you don't like the standard location for the lirc-config file (~/.lircrc)
-use the -lircconf [filename] switch to specify another file.
+use the -lircconf <filename> switch to specify another file.
3.3. Streaming from network or pipes
@@ -465,7 +519,7 @@
The MPlayer project:
-- Árpád Gereöffy (A'rpi/ESP-team): [arpi@thot.banki.hu]
+
- Árpád Gereöffy (A'rpi/ESP-team): <arpi@thot.banki.hu>
- player code (mpeg stream demultiplexer and avi/asf parser, A-V sync, seek...)
- mp3lib, based on mpglib sources [MP3 audio decoder]
- getch2 [keyboard handler]
@@ -480,9 +534,9 @@
- DivX4Linux (ProjectMayo) support (see documentation)
- - Zoltán Ponekker (Pontscho/Fresh!): [pontscho@makacs.poliod.hu]
+
- Zoltán Ponekker (Pontscho/Fresh!): <pontscho@makacs.poliod.hu>
- configure script and Makefiles for easy compile
-
- GUI system (near complete!?)
+
- GUI system
- 3DNow! support into mp3lib
- 3DNow! support into fastmemcpy.h
- various X11 driver changes (keyboard handling, fullscreen, bpp detect, etc)
@@ -490,15 +544,14 @@
- audio mixer (volume) support
- - Gábor Lénárt (LGB): [lgb@lgb.hu]
+
- Gábor Lénárt (LGB): <lgb@lgb.hu>
- ./configure script improvements
- Makefile improvements
- prelimenary DVD support
-
- another GUI code (is that so..?)
- various X11 cleanups and fixes
- - Gábor Bérczi (Gabucino): [gabucino@k2.jozsef.kando.hu]
+
- Gábor Bérczi (Gabucino): <gabucino@k2.jozsef.kando.hu>
- documentation maintainer
- hungarian translation of documentation
- second webpage design&gfx
@@ -509,7 +562,7 @@
- experimental MINIX port :)
- - Szabolcs Berecz (Szabi): [szabi@inf.elte.hu]
+
- Szabolcs Berecz (Szabi): <szabi@inf.elte.hu>
- codecs.conf file parser
- config file and command line parser
- mga_vid fixes, module option etc.
@@ -517,31 +570,31 @@
- type #7 subtitle support
- - László Megyer (Lez, Laaz): [lez@sch.bme.hu]
+
- László Megyer (Lez, Laaz): <lez@sch.bme.hu>
- SUB reader
- screensaver+DPMS disable for libvo
- - Gyula László (Chass, Tégla): [chass-@freemail.hu]
+
- Gyula László (Chass, Tégla): <chass-@freemail.hu>
- first fonts (mp_font1.zip)
- third (current) homepage design&gfx
- - Zoltán Márk Vicián (Se7en): [se7en@sch.bme.hu]
+
- Zoltán Márk Vicián (Se7en): <se7en@sch.bme.hu>
-
- Alex Beregszaszi (Al3x): [alex@naxine.org]
+
- Alex Beregszaszi (Al3x): <alex@naxine.org>
- ALSA output driver in libao2
- vo_ggi output driver in libvo (www.ggi-project.org)
- - Andreas Ackermann (Acki): [asackerm@stud.informatik.uni-erlangen.de]
+
- Andreas Ackermann (Acki): <asackerm@stud.informatik.uni-erlangen.de>
- LIRC support (see documentation)
- DGA support in libvo
- - Felix Bünemann (Atmos): [atmosfear@users.sourceforge.net]
+
- Felix Bünemann (Atmos): <atmosfear@users.sourceforge.net>
- SDL driver maintainer
- Additional YUV formats fixes
- New font (mp_font2.zip)
@@ -551,54 +604,54 @@
- RAW PCM/WAVE file writer for libao2
- - TeLeNiEkO: [telenieko@telenieko.com]
+
- TeLeNiEkO: <telenieko@telenieko.com>
- spanish translation of documentation
- - Michael Graffam: [mgraffam@idsi.net]
+
- Michael Graffam: <mgraffam@idsi.net>
- XF86VidMode support to vo_x11 and vo_dga
- Video mode switching code to vo_dga
- - Jens Hoffmann: [hoffmajs@gmx.de]
+
- Jens Hoffmann: <hoffmajs@gmx.de>
- Additional YUV formats support
- found the big BITMAPINFOHEADER problem -> solved ASV2 pixelization
- - Nick Kurshev: [nickols_k@mail.ru]
+
- Nick Kurshev: <nickols_k@mail.ru>
- memcpy optimizations for AMD K7 and Intel Pentium III (fastmemcpy.h)
- CDROM tune info
- further 3DNow! optimizations into mp3lib and libac3 and ffmpeg
- russian translation of documentation
- - German Gomez Garcia: [german@piraos.com]
+
- German Gomez Garcia: <german@piraos.com>
- DVD .ifo parser and chapter selection [not yet in the main trunk]
- SPDIF AC3 output for SBLive!
- - Dariush Pietrzak (Eyck): [eyck@incubus.ar.lublin.pl]
+
- Dariush Pietrzak (Eyck): <eyck@incubus.ar.lublin.pl>
- debian packaging support (see debian/* and this documentation)
- support for vplayer subtitle format
- prelimenary support for .RT subtitle format
- - Marcus Comstedt: [marcus@idonex.se]
+
- Marcus Comstedt: <marcus@idonex.se>
- initial solaris8-x86 support
- - Jürgen Keil and Marcus Comstedt: [jk@tools.de] [marcus@idonex.se]
+
- Jürgen Keil and Marcus Comstedt: <jk@tools.de> <marcus@idonex.se>
- patched MPlayer to work on Solaris 8 x86
- configure fixes
- various fixes (win32, configure, etc)
- SUN audio driver in libao2
- - Vladimir Kushnir: [vkushnir@Alfacom.net]
+
- Vladimir Kushnir: <vkushnir@Alfacom.net>
- patched MPlayer to work on FreeBSD x86
- - Bertrand BAUDET: [bertrand_baudet@yahoo.com]
+
- Bertrand BAUDET: <bertrand_baudet@yahoo.com>
- network streaming support
@@ -610,12 +663,12 @@
- GIMP font generator plugin (TOOLS/subfont-gimp)
- - Adam Tla/lka: [atlka@pg.gda.pl]
+
- Adam Tla/lka: <atlka@pg.gda.pl>
- osd/sub review, fixes, optimization, utf8 support
various fixes
-Folke Ashberg: <folke@ashberg.de>
- native AAlib driver (-vo aa)
@@ -634,32 +687,32 @@
The codecs, libs:
-- Aaron Holtzman: [aholtzma@engr.uvic.ca]
+
- Aaron Holtzman: <aholtzma@engr.uvic.ca>
- ac3dec (and libac3) author [AC3 audio decoder]
- mga_vid driver [Matrox G200/G400 YUV Back-end Scaler]
- mpeg2dec [Fast MPEG1/MPEG2 video decoder, currently used in player]
- - Michel Lespinasse: [walken@zoy.org]
+
- Michel Lespinasse: <walken@zoy.org>
- did large libmpeg2 changes for better speed and mpeg conformance
- - Eugene Kuznetsov: [divx@euro.ru]
+
- Eugene Kuznetsov: <divx@euro.ru>
- avifile author [AVI player library for linux, using Win32 VfW/ACM codecs]
- technical help about AVI and ASF formats, and how to get YUV using VfW...
- divx4linux techical support
- - Zdenek Kabelac: [kabi@informatics.muni.cz]
+
- Zdenek Kabelac: <kabi@informatics.muni.cz>
- current avifile maintainer(?)
- some technical help about the win32 stuff and timers
- - Gerard Lantau: [glantau@yahoo.fr]
+
- Gerard Lantau: <glantau@yahoo.fr>
- ffmpeg/libavcodec author,maintainer (opensource mpeg, mjpeg, divx en/decoder)
- - Project Mayo: [http://www.projectmayo.com]
+
- Project Mayo: <http://www.projectmayo.com>
- the OpenDivX codec authors
@@ -682,16 +735,95 @@
- AVI FAQ author/collector. [site with many useful docs on codecs and avi fmt]
- - Dirk Farin: [farin@ti.uni-mannheim.de]
+
- Dirk Farin: <farin@ti.uni-mannheim.de>
- dvdview author [MPEG1/MPEG2 video decoder, used in v0.5-v0.8]
- - Adam Williams: [broadcast@earthling.net]
+
- Adam Williams: <broadcast@earthling.net>
- libmpeg3 (and xmovie) author [MPEG1/MPEG2 video decoder, used in v0.1-v0.4]
+Appendix A/2 - MPlayer code and documentation maintainers
+
+Homepage
+
+ - Design: Chass
+
- Contents: Gabucino
+
+English documentation
+
+ - tech-*.txt: A'rpi
+
- all the others: Gabucino
+
+Documentation translations
+
+ - Hungarian: Gabucino
+
- Spanish: TeLeNiEkO (outdated)
+
- Russian: Nick Kurshev (outdated)
+
- Polish: Dariush Pietrzak (outdated)
+
- German: Atmosfear (outdated)
+
+Platforms/ports
+
+ - DEBIAN packaging: Dariush Pietrzak
+
- FreeBSD support: Vladimir Kushnir
+
- Solaris 8 support: Jürgen Keil
+
+MPlayer code:
+
+ - fileformat detection, demuxers: A'rpi
+
- DVD support: (alpha version was: LGB) now: ?
+
- network streaming: Bertrand BAUDET
+
- A-V sync code: A'rpi
+
- subtitles file parser/reader: Lez (most of them)
+
- config files & commandline parser: Szabi
+
- fastmemcpy: Nick Kurshev
+
- LIRC support: Acki
+
- SUB/OSD renderer: Adam Tla/lka
+
+libvo drivers:
+
+ - vo_3dfx.c - OBSOLETED, use xv
+
- vo_aa.c - Folke Ashberg
+
- vo_dga.c - Acki
+
- vo_fbdev.c - Szabi
+
- vo_fsdga.c - OBSOLETED, use dga
+
- vo_ggi.c - al3x
+
- vo_gl.c - A'rpi
+
- vo_md5.c - A'rpi
+
- vo_mga.c - A'rpi
+
- vo_null.c - A'rpi
+
- vo_odivx.c - A'rpi
+
- vo_pgm.c - A'rpi
+
- vo_png.c - Atmos
+
- vo_sdl.c - Atmos
+
- vo_svga.c - se7en
+
- vo_syncfb.c - OBSOLETED, use mga
+
- vo_x11.c - Pontscho
+
- vo_xmga.c - Pontscho
+
- vo_xv.c - Pontscho
+
- vo_aa.c - Folke Ashberg
+
+libao2 drivers:
+
+ - ao_alsa5.c - al3x
+
- ao_alsa9.c - al3x (BUGGY, use oss)
+
- ao_null.c - A'rpi
+
- ao_oss.c - A'rpi
+
- ao_pcm.c - Atmos
+
- ao_sdl.c - Atmos
+
- ao_sun.c - Jürgen Keil
+
+TOOLS:
+
+ - subfont-c - Artur Zaprzala:
+
- subfont-GIMP - lanzz@lanzz.org
+
- *.pl - Atmos
+
- others - A'rpi
+
+
Appendix B - Mailing lists
There are some public mailing lists on MPlayer. Subscribing can be
diff -r ab35bee402ff -r b42b78566029 DOCS/mplayer.1
--- a/DOCS/mplayer.1 Mon Aug 27 15:25:11 2001 +0000
+++ b/DOCS/mplayer.1 Mon Aug 27 16:34:31 2001 +0000
@@ -6,23 +6,23 @@
mplayer \- Movie Player for Linux
.SH SYNOPSIS
.B mplayer
-.RB [ \-v\ ]
-.RB [ \-quiet\ ]
-.RB [ \-vo\ [:]\ ]
-.RB [ \-ao\ [:]\ ]
+.RB [ \-v ]
+.RB [ \-quiet ]
+.RB [ \-vo\ [:] ]
+.RB [ \-ao\ [:] ]
.RB [ \-vcd\ track\ number ]
.RB [ \-sb\ byte\ position ]
-.RB [ \-nosound\ ]
+.RB [ \-nosound ]
.RB [ \-abs\ seconds ]
.RB [ \-delay\ secs ]
-.RB [ \-bps\ ]
+.RB [ \-bps ]
.RB [ \-aid\ id ]
.RB [ \-vid\ id ]
.RB [ \-fps\ rate ]
.RB [ \-mc\ seconds/5f ]
-.RB [ \-fs\ ]
-.RB [ \-vm\ ]
-.RB [ \-zoom\ ]
+.RB [ \-fs ]
+.RB [ \-vm ]
+.RB [ \-zoom ]
.RB [ \-x\ x ]
.RB [ \-y\ y ]
.RB [ \-xy\ factor ]
@@ -33,40 +33,42 @@
.RB [ \-sub\ file ]
.RB [ \-subfps\ rate ]
.RB [ \-subdelay\ sec ]
-.RB [ \-dvdauth\ device ]
.RB [ \-z\ <0-8> ]
.RB [ \-idx ]
.RB [ \-forceidx ]
.RB [ \-nodshow ]
.RB [ \-noxv ]
.RB [ \-forcexv ]
-.RB [ \-ss\ sec ]
-.RB [ \-dumpaudio ]
-.RB [ \-dumpvideo ]
-.RB [ \-noframedrop ]
-.RB [ \-framedrop ]
-.RB [ \-nodouble ]
-.RB [ \-double ]
-.RB [ \-dvdkey\ key ]
-.RB [ \-stereo\ mode ]
-.RB [ \-srate\ Hz ]
-.RB [ \-osdlevel\ level ]
-.RB [ \-config\ file ]
-.RB [ \-display\ name ]
-.RB [ \-unicode ]
-.RB [ \-utf8 ]
-.RB [ \-fsmode\ mode ]
-.RB [ \-vc\ video\ codec\ name ]
-.RB [ \-ac\ audio\ codec\ name ]
-.RB [ \-vfm\ video\ codec\ family ]
-.RB [ \-afm\ audio\ codec\ family ]
-.RB [ \-frames\ number ]
-.RB [ \-autoq\ quality ]
-.RB [ \-fb\ device ]
-.RB [ \-fbmode\ modename ]
-.RB [ \-fbmodeconfig filename ]
-.RB [ \-benchmark ]
-.I - or file
+.RB [ \-ss\ sec\]
+.RB [ \-dumpaudio]
+.RB [ \-dumpvideo]
+.RB [ \-noframedrop]
+.RB [ \-framedrop]
+.RB [ \-nodouble]
+.RB [ \-double]
+.RB [ \-stereo\ mode]
+.RB [ \-srate\ Hz]
+.RB [ \-osdlevel\ level]
+.RB [ \-config\ file]
+.RB [ \-display\ name]
+.RB [ \-unicode]
+.RB [ \-utf8]
+.RB [ \-fsmode\ mode]
+.RB [ \-vc\ video\ codec\ name]
+.RB [ \-ac\ audio\ codec\ name]
+.RB [ \-vfm\ video\ codec\ family]
+.RB [ \-afm\ audio\ codec\ family]
+.RB [ \-frames\ number]
+.RB [ \-autoq\ quality]
+.RB [ \-fb\ device]
+.RB [ \-fbmode\ modename]
+.RB [ \-fbmodeconfig\ filename]
+.RB [ \-benchmark]
+.RB [ \-dvd\ titleid]
+.RB [ \-chapter\ chapterid]
+.RB [ \-dvdangle\ angleid]
+.RB [ \-dvdkey\ key]
+.I - or file or device
.PP
.SH DESCRIPTION
.I mplayer
@@ -87,6 +89,17 @@
.I NOTE
Every "flag" option has "noflag" pair, e.g. -fs opposite is -nofs
.TP
+.B \-dvd\ titleid
+tell MPlayer which movies (marked with titleid) to play. For example
+sometimes '1' are trailers, and '2' is the real movie.
+.TP
+.B \-chapter\ chapterid
+specify which chapter to start playing at. Examples can be found below.
+.TP
+.B \-dvdangle\ angleid
+some DVD discs contain scenes that can be viewed from multiple angles.
+Here you can tell MPlayer which angels to use. Examples can be found below.
+.TP
.B \-vo\ [:]
select video output driver and optinaly device. "device" is valid with
SDL and GGI too, it means sub-driver then (for example: -vo sdl:aalib).
@@ -109,10 +122,6 @@
.B \-vcd\ track
play video cd track from device instead of plain file
.TP
-.B \-dvdauth\ device
-specify DVD-ROM drive to use for MPEG2 decoding.
-(use *_only_* when playing from DVD!)
-.TP
.B \-nosound
don't play sound
.TP
@@ -152,7 +161,7 @@
dynamically changes the level of postprocess, depending on spare CPU
time available. Uses the same value ranges as -pp . The number you
specify will be the maximum level used. Usually you can use some big
-number.
+number. You don't have to (and don't) use together with -pp !
.TP
.B \-ffactor\ number
resample alphamap of the font. Can be:
@@ -192,7 +201,8 @@
.SH "ADVANCED OPTIONS"
.TP
.I NOTE
-These options can help you solve your particular problem.. Also, see the DOCS!
+These options can help you solve your particular problem.. Also, see the
+documentation !
.TP
.B \-vc
force usage of a specific video codec, according to its name in codecs.conf,
@@ -201,6 +211,7 @@
-vc divx use VFW DivX codec
-vc divxds use DirectShow DivX codec
-vc ffdivx use libavcodec's DivX codec
+ -vc ffmpeg12 use libavcodec's MPEG1/2 codec
-vc divx4 use ProjectMayo's DivX codec
.TP
.B \-ac
@@ -210,27 +221,31 @@
-ac mp3 use libmp3 MP3 codec
-ac mp3acm use l3codeca.acm MP3 codec
-ac ac3 use AC3 codec
+ -ac hwac3 enable Hardware AC3 passthrough
+ (see documentation)
.TP
.B \-vfm <1-5>
force usage of a specific codec FAMILY, and FALLBACK to default if failed.
For example:
-vfm 2 use VFW (Win32) codecs
- -vfm 3 use OpenDivX codec (YV12)
+ -vfm 3 use OpenDivX/DivX4 codec (YV12)
(same as -vc odivx but fallback)
-vfm 4 use DirectShow (Win32) codecs
-vfm 5 use libavcodec codecs
- -vfm 7 use DivX4Linux codec (YUY2)
+ -vfm 7 use DivX4 codec (YUY2)
(same as -vc divx4 but fallback)
-NOTE : type 3 and 7 now contains just the one same codec, then OpenDivX 4.0
-beta. For difference between them and when to use which, check the OpenDivX
-section in the documentation.
+NOTE : if libdivxdecore support was compiled in, then type 3 and 7 now contains
+just the same DivX4 codec, but different APIs to reach it. For difference
+between them and when to use which, check the DivX4 section in the
+documentation.
.TP
.B \-afm <1-5>
force usage of a specific audio format. For example:
- -afm 1 use libmp3 (mp1/mp2/mp3)
+ -afm 1 use libmp3 (mp2/mp3,
+ but not mp1)
-afm 2 suppose raw PCM audio
-afm 3 use libac3
-afm 4 use a matching Win32 codec
@@ -311,10 +326,10 @@
.TP
.B \-dvdkey key
key to decrypt stream encrypted with CSS. For example : -dvdkey F169072699
-(this is NOT for DVD playing! For DVD use the -dvdauth option!)
+(this is NOT for DVD playing! For DVD use the -dvd option!)
.TP
.B \-stereo mode
-select type of MPEG1 stereo output. Mode may be 0:stereo 1:left 2:right
+select type of MPEG1 stereo output.
Stereo 0
Left channel 1
@@ -343,10 +358,12 @@
fullscreen mode. If you experience fullscreen problems, try changing this
value between 0 and 7.
- -fsmode 0 new method (since 0.18pre3)
- -fsmode 1 ICCCWM patch (for KDE2/icewm)
- -fsmode 2 old method (0.17a)
- -fsmode 3 ICCCWM patch + Motif method
+ -fsmode 0 new method
+ -fsmode 1 ICCCWM patch
+ (for KDE2/icewm)
+ -fsmode 2 old method
+ -fsmode 3 ICCCWM patch
+ plus Motif method
.TP
.B \-frames\ number
MPlayer plays frames, then quits.
@@ -370,7 +387,8 @@
.TP
.I NOTE
These are included in this manpage just for completeness! If you don't
-know what are these, you DON'T need these! In either case, double-check DOCS!
+know what are these, you DON'T need these! In either case, double-check the
+documentation !
.TP
.B \-br\ rate
used with '-vo odivx' .
@@ -383,6 +401,9 @@
.TP
.B \-dumpvideo
dump video stream to ./stream.dump (only with MPEG-PS) (not very usable)
+.TP
+.B \-sid
+specify DVD subtitle (?)
.IP
.SH KEYBOARD CONTROL
.TP
@@ -436,31 +457,41 @@
SAMI (smi), vplayer, RealMedia RT, ssa (Sub Station Alpha).
Sub files are searched in this priority : (for example /mnt/cdrom/movie.avi)
/mnt/cdrom/movie.sub
- (SUB/srt/SRT/smi/SMI/rt/RT/txt/TXT)
+ (utf/UTF/sub/SUB/srt/SRT/smi/SMI/rt/RT/txt/TXT/ssa/SSA)
$HOME/.mplayer/sub/movie.sub
- (SUB/srt/SRT/smi/SMI/rt/RT/txt/TXT)
+ (utf/UTF/sub/SUB/srt/SRT/smi/SMI/rt/RT/txt/TXT/ssa/SSA)
$HOME/.mplayer/default.sub
.IP
.SH "EXAMPLES"
-Just launch it! :)
+.B Quickstart DVD playing
+mplayer -dvd 1
+.TP
+.B Multiangle DVD playing
+mplayer -dvd 1 -dvdangle 2
+.TP
+.B Playing from a different DVD device
+mplayer -dvd 1 /dev/dvd2
+.TP
+.B Stream from HTTP
+mplayer http://mplayer.hq/example.avi
.LP
.SH BUGS
-Probably. Check DOCS.
+Probably. Check the documentation.
Bugreports should be addressed to the MPlayer-users mailing list
(mplayer-users@lists.sourceforge.net) ! If you want to submit a bugreport
-(which we love to receive!), please double-check the DOCS/BUGREPORTS, and
+(which we love to receive!), please double-check the bugreports.html, and
tell us all that we need to know to identify your problem.
.LP
.SH AUTHORS
-Check DOCS/AUTHORS !
+Check documentation !
MPlayer is (C) 2000-2001
.I Arpad Gereoffy
This manpage is maintained by
-.I Gabucino.
+.I Gabucino .
.LP
.SH STANDARD DISCLAIMER
Use only at your own risk! There may be errors and inaccuracies that could