diff options
| author |  gabucino <gabucino@b3059339-0415-0410-9bf9-f77b7e298cf2> | 2001-12-16 11:51:02 +0000 |
|---|---|---|
| committer | gabucino <gabucino@b3059339-0415-0410-9bf9-f77b7e298cf2> | 2001-12-16 11:51:02 +0000 |
| commit | 80c90e39c69d726dd273cb4e9b07fed27b52d1ef (patch) | |
| tree | ea742c33f690fd4021be367afa3e7717925cc28f /DOCS | |
| parent | 81826a314f82a82d80aacba9d215bd0bff0dd422 (diff) | |
began updated translation by <nell@skrzynka.pl> (work-in-progress)
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@3524 b3059339-0415-0410-9bf9-f77b7e298cf2
Diffstat (limited to 'DOCS')
| -rw-r--r-- | DOCS/Polish/DVB | 72 | ||||
| -rw-r--r-- | DOCS/Polish/DXR3 | 103 | ||||
| -rw-r--r-- | DOCS/Polish/bugreports.html | 163 | ||||
| -rw-r--r-- | DOCS/Polish/cd-dvd.html | 227 | ||||
| -rw-r--r-- | DOCS/Polish/codecs-in.html | 223 | ||||
| -rw-r--r-- | DOCS/Polish/codecs.html | 352 | ||||
| -rw-r--r-- | DOCS/Polish/documentation.html | 1634 | ||||
| -rw-r--r-- | DOCS/Polish/encoding.html | 255 | ||||
| -rw-r--r-- | DOCS/Polish/faq.html | 923 | ||||
| -rw-r--r-- | DOCS/Polish/formats.html | 168 | ||||
| -rw-r--r-- | DOCS/Polish/gcc-2.96-3.0.html | 111 | ||||
| -rw-r--r-- | DOCS/Polish/mencoder.1 | 256 | ||||
| -rw-r--r-- | DOCS/Polish/mplayer.1 | 643 | ||||
| -rw-r--r-- | DOCS/Polish/skin-en.html | 867 | ||||
| -rw-r--r-- | DOCS/Polish/sound.html | 127 | ||||
| -rw-r--r-- | DOCS/Polish/users_against_developers.html | 128 | ||||
| -rw-r--r-- | DOCS/Polish/video.html | 1005 |
17 files changed, 7257 insertions, 0 deletions
diff --git a/DOCS/Polish/DVB b/DOCS/Polish/DVB new file mode 100644 index 0000000000..874117d676 --- /dev/null +++ b/DOCS/Polish/DVB @@ -0,0 +1,72 @@ + +Some words about Siemens-DVB card support. by A'rpi +========================================== + +NOTE: this is very experimental! + +Requirements: +~~~~~~~~~~~~~ +- Siemens DVB-S card or compatible (technotrend,galaxis,hauppage etc) + see www.linuxtv.org for details and download latest driver there. +- MPlayer-CVS, ffmpeg-libavcodec. divx4linux is recommended for speed & pp. +- Fast CPU - at least for software decoding (divx...) + + +How to enable? +~~~~~~~~~~~~~~ + +1. Download ffmpeg-CVS and copy libavcodec to mplayer (see DOC for details) + Move this line from #ifdef CONFIG_ENCODERS .. #endif section to outside + (after the #endif line) at libavcodec/utils.c:361 : + register_avcodec(&mpeg1video_encoder); + +2. Compile mplayer: + ./configure should detect it. If didn't, force with ./configure --enable-dvb + If you have ost headers at non-standard path, set it with: + --with-extraincdir=<your DVB source dir>/ost/include + make + make install + + +How to use? +~~~~~~~~~~~ +To play standard mpeg 1/2 files: (hardware decoding) + + mplayer -ao mpegpes -vo mpegpes -vc mpegpes file.mpg|vob + +To play non-standard mpeg files: (software decoding) + + mplayer -ao mpegpes -vo mpegpes file.mpg|vob + +To play divx files: + + mplayer -vo mpegpes -vc ffdivx|odivx file.avi|asf + +To play non-25fps movies, or with slow CPU, add option: -framedrop + +Image size: +~~~~~~~~~~~ +DVB card allows only 2 vertical resolutions: 288 and 576. +If your video height differs, you have to clip it or extend by adding +black bands. It's done by mplayer, just specify image size using the +-x and -y options. You must use either -y 288 or -y 576. + +To force pan&scan (16:9 at 4:3 TV), add options: -x 352 -y 288 + +Mailing list: +~~~~~~~~~~~~~ + http://mplayerhq.hu/mailman/listinfo/mplayer-dvb + +List's language is ENGLISH. Please avoid using german or other languages! +Subscribe, and ask/discuss your problems here. +I'll also post feature announces to this list. + +Future plans/TODO: +~~~~~~~~~~~~~~~~~~ + +- display OSD and subtitles using DVB card's OSD feature +- better (more fluent) playback of non-25fps movies +- more speed optimizations +- YUY2 support (for win32 codecs, like Indeo5 and WMV 7/8) +- realtime transcoding between mpeg2 <-> mpeg4 (partial decompression) + diff --git a/DOCS/Polish/DXR3 b/DOCS/Polish/DXR3 new file mode 100644 index 0000000000..b3f7fd60e9 --- /dev/null +++ b/DOCS/Polish/DXR3 @@ -0,0 +1,103 @@ +DXR3/H+ video/audio output plugins manual by David Holm +======================================================= + +2001-12-04: Thanks to Inaki Garci'a Etxebarria of + zapping.sourceforge.net we have now + abandoned rte since it caused problems for + users who didn't rtfm and compiled it with + ffmpeg support. Instead we are now using + libmp1e which is a modified version of mp1e. + +2001-11-29: Thanks to Felix Buenemann I managed to + optimize the odivx playback as well as add + support for the rest of the codecs! + +2001-11-28: ffmpeg replaced with mp1e, divx playback + won't get much faster than this, huge thanks + goes out to Ivan Kalvachev for helping me + fix the final mp1e bugs (and contributing + to the libvo2 development) + +1. Introduction + +The DXR3 and Hollywood+ are two not too different mpeg-(1/2) and ac3 +hardware playback cards that came at about the same time as the first +dvd-rom drives hit the market. At that time most computers weren't +powerful enough for synced software dvd playback. And even the faster +(intel-based) computers had troubles with artifacts. +Sigma Designs came up with the great idea to create a hardware +mpeg-(1/2), ac3 decoder. Sigma Designs are known for their realmagic +hardware (or they bought the company who came up with the first +realmagic boards, I don't know which). +Later Creative Labs thought, hey, we also wan't this product, and to +distribute it with our dvd-drives (the DVD Encore packages if I recall +correctly). So they bought the designs for the Hollywood plus and +replaced the circuit used to produce a proper video feed for tv's +called adv7170 or adv7175a depending on which h+ board you own with +a bt865. The reason for this is beyond my understanding as this seems +complete illogical to me, but I have had great experiences with +bt(brooktree) circuits in the past, so I don't mind. +Well, nowadays most people have no use for a mpeg-(1/2) or ac3 +hardware decoder since most computers these days have no problem doing +this in software and have cycles left for posprocessing (removing of +artefacts and other garbage produced by compression). +These days, you have two uses for this card: +1. You have a slow computer which you use for vcd/dvd playback +2. You discover what I have done with the implementation of this as + an audio/video output device for mplayer (read on and you'll find + out). + + + +2. Requirements + + * First of all you will need the DXR3/H+ drivers properly installed. + Version 0.9.0 or later + + * Run <mplayerdir>/configure and make sure that DXR3/H+ support = yes + + From here on compilation (of at least my code ;) should go without any + problems. + + + +3. Usage + +After installation you will have two new outdevices in mplayer: + -vo dxr3 For video output + -ao dxr3 For audio output + +MPEG-1, MPEG-2, VCD and DVD Notes +There are some notes to take into account here for optimum playback. +When playing any mpeg-(1/2) file, this including usage of the "-dvd" +and "-vcd" options you must either add the "-vc mpegpes" or edit +codecs.conf and make sure videocodec mpegpes is listed above mpeg12. +If you fail to do this you will only get software playback which kinda +spoils most of the useful features of this card except for tv-out ;). +Remember that if you edit the codecs.conf file and move the mpegpes +section will have to specify "-vc mpeg12" if you want to playback +any of these video types _without_ "-vo dxr3"! + +DIVX Notes +When playing divx's add "-vc odivx" for maximum performance. +I've switched to mp1e from ffmpeg so it should be lightning fast now. + +Other codecs: +No "-vc <codec>" switches should be required as mplayer will autodetect. +If you find an unsupported codec please contact me! + +* Avoid running mplayer as root or setuid root as rtc timing seems to + slow down playback on the dxr3 for some users. I will look into this + at a later point as this hardly qualifies as a severe bug * + + + +4. Contacting me + +You can contact me either by e-mailing me, <dholm@iname.com> or by using +icq: 798427 +Feedback, bugreports and general suggestions are appreciated (preferably +by e-mail). My name is David Holm for those of you who are incapable of +reading a heading. ;) + + diff --git a/DOCS/Polish/bugreports.html b/DOCS/Polish/bugreports.html new file mode 100644 index 0000000000..337f8d144b --- /dev/null +++ b/DOCS/Polish/bugreports.html @@ -0,0 +1,163 @@ +<HTML> +<BODY BGCOLOR=white> + +<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + +<P><B><A NAME=C>Appendix C - How to report bugs</A></B></P> + +<P><B>How to report bugs?</B></P> + +<P>First read <A HREF="documentation.html#D">Appendix D</A>, and other docs. If your problem isn't +known or isn't solved by our instructions, then report the bug:</P> + +<P><B>Where?</B></P> + +<P>Subscribe to the mplayer-users mailing list:<BR> + <A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-users">http://mplayerhq.hu/mailman/listinfo/mplayer-users</A><BR> +and send your bugreport to:<BR> + <A HREF="mailto:mplayer-users@mplayehq.hu">mplayer-users@mplayerhq.hu</A><BR> +We won't CC: so please subscribe!!!</P> + +<P>Don't send bugreports private, directly to author's address!!! +We are working together on code, so everyone is interested in it. +BTW many times other users know the solution (system config probs, +bad drivers etc), even when we think it's a bug in our code. +The language of this list is ENGLISH!</P> + +<P>Please describe your problem in details, examples etc, and don't +forget to include these:</P> + +<P><B>What?</B></P> + +<P><B><I>1. The system info what we always want:</I></B></P> + +<UL> +<LI>linux distribution<BR> +examples:<UL> + <LI>RedHat 7.1 + <LI>Slackware 7.0 + devel packs from 7.1 ...</UL> +<LI>kernel version:<BR> + <CODE>uname -a</CODE> +<LI>libc version:<BR> + <CODE>ls -l /lib/libc[.-]*</CODE> +<LI>X version:<BR> + <CODE>X -version</CODE> +<LI>gcc and ld version:<BR> + <CODE>gcc -v<BR> + ld -v</CODE> +<LI>binutils version:<BR> + <CODE>as --version</CODE> +</UL> + +<P><B><I>2. Hardware & drivers:</I></B></P> + +<UL> +<LI>CPU info:<BR> + <CODE>cat /proc/cpuinfo</CODE> +<LI>video card manufacturer and model<BR> + examples:<BR><UL> + <LI>ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM + <LI>Matrox G400 DH 32MB SGRAM</UL> +<LI>video driver type&version<BR> + examples:<UL> + <LI>X built-in driver + <LI>nvidia 0.9.623 + <LI>Utah-GLX CVS 2001-02-17 + <LI>DRI from X 4.0.3</UL> +<LI>sound card type & driver<BR> + examples:<BR><UL> + <LI>Creative SBLive! Gold with OSS driver from oss.creative.com + <LI>Creative SB16 with OSS drivers of kernel + <LI>GUS PnP with ALSA OSS emulation</UL> +<LI>if you are unsure, attach output of lspci -v +</UL> + +<P><B>For compiling problems/errors</B></P> + +<P><B><I>3. these files:</I></B></P> +<UL><LI>configure.log +<LI>config.h +<LI>config.mak +<LI>libvo/config.mak +</UL> + +<P><B>For playback problems:</B></P> + +<P><B><I>3. Output of mplayer at verbose level 1 (-v)</I></B></P> +<P><CODE> mplayer -v [options] filename &> mplayer.log</CODE></P> + +<P><B><I>4. If the problem is specific to one or a few files, + then please upload that file to:</I></B></P> +<P><CODE> ftp://mplayerhq.hu/MPlayer/incoming/</CODE></P> + Also upload a small .txt file with the same name as your file, + describing the problem!<BR> + Usually first 1-5 MB of the file is enough to reproduce + the problem, but first you should try it: +<P><CODE> dd if=yourfile of=smallfile bs=1k count=1024</CODE></P> + (it will cut first 1MB of 'yourfile' and save to 'smallfile') + Then try again on this small file, and if bug still exists + then it's enough to upload this small file.<BR> + NEVER send such files via mail! Upload it, and send only + the path/filename of the file on the FTP. + If the file is accessible on the net, then sending the + _exact_ URL is enough! + +<P><B><I>5. For crashes (segfault, SIGILL, signal 4 etc):</I></B></P> + +<P><I>If you have coredump of the crash, see 5.a, else see 5.b:</I></P> + +<P><B><I>5.a: Please print us coredump (if it was created).</I></B></P> + +<P>Howto: +please create following command file:</P> + +<P><CODE>disass $eip-32 $eip+32<BR> +printf "eax=%08lX\n",$eax<BR> +printf "ebx=%08lX\n",$ebx<BR> +printf "ecx=%08lX\n",$ecx<BR> +printf "edx=%08lX\n",$edx<BR> +printf "esp=%08lX\n",$esp<BR> +printf "ebp=%08lX\n",$ebp<BR> +printf "edi=%08lX\n",$edi<BR> +printf "esi=%08lX\n",$esi<BR> +</CODE></P> + +<P>Then simply execute following command line:</P> +<P> <CODE>gdb mplayer --core=core -batch --command=command_file >mplayer.bug</CODE></P> + +<P><B><I>5.b.: run MPlayer in gdb:</I></B></P> +<P>Re-compile mplayer with debugging code enabled:<BR> +./configure --enable-debug<BR> +make +</P> +<P>[at root/user shell prompt:]<BR> + <CODE># gdb mplayer</CODE><BR> +[at gdb prompt:]<BR> + <CODE>> run -v [options-to-mplayer] filename</CODE><BR> + ... (wait until it will crash)<BR> + <CODE>> bt</CODE><BR> + <CODE>> disass $eip-32 $eip+32</CODE><BR> +Send us the full output of the above things! +</P> + +<P><B>In general:</B></P> + +<P>If something is big (logs etc) then it's better to upload to the ftp +(gzipped), and include only path/filename in the bugreport!</P> + +<P><B>I know what am I doing...</B></P> + +<P>If you created a proper bugreport following the above steps, and you are +sure it's mplayer bug, not compiler's problem or broken file, you've already +readed through docs and you didn't find the solution, your sound drivers are ok, +then you may want to subscribe to the mplayer-advusers list and send your +bugreport there to get better and faster answer. But BE WARNED: if you post +newbie or rtfm-type questions there, you'll be immediatelly banned, instead or +getting answered!!! So don't flame us, subscribe -advusers only if you really +know what are you doing and you feel you as advanced mplayer user or developer. +(and about how to subscribe: find it out! if you're really an advanced user, +it shouldn't be a problem for you...) +</P> + +</BODY> +</HTML> diff --git a/DOCS/Polish/cd-dvd.html b/DOCS/Polish/cd-dvd.html new file mode 100644 index 0000000000..a37c97d94d --- /dev/null +++ b/DOCS/Polish/cd-dvd.html @@ -0,0 +1,227 @@ +<HTML> +<BODY BGCOLOR=white> + +<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + +<P><B><A NAME=4.1>4.1. CD-ROM drives</A></B></P> + +<P>Playing standard Video CDs:</P> + +<P> +mplayer -vcd <I>trackno</I> [device]<BR><BR> +Examples:<BR> +mplayer -vcd 1<BR> +mplayer -fs -vcd 2 /dev/hdc<BR> +</P> + +<P> +Notes:<BR> +- Do NOT mount VCD disks and play DAT files directly! It may work under windows +but won't work under linux. You have to play them directly, with the -vcd +option!<BR> +- VCD disks usually have 2 tracks: a data track (containing autostart windows +playback program, karaoke data etc) and a mode-2 track (the movie), so try +-vcd 2 first!<BR> +- the default VCD device is /dev/cdrom. if your device differs, then you have +to make a symlink, or specify it in command line! +</P> + +<P>From Linux documentation:</P> + +<P>Some CDROM drives are capable of changing their head-speed. There are several +reasons for changing the speed of a CDROM drive. Badly pressed CDROMs may +benefit from less-than-maximum head rate. Modern CDROM drives can obtain very +high head rates (up to 24-times is common). It has been reported that these +drives can make reading errors at these high speeds, reducing the speed can +prevent data loss in these circumstances. Finally, some of these drives can +make an annoyingly loud noise, which a lower speed may reduce.</P> + +<P>The recommended way to do it is with a program called 'setcd' . It's kinda +old, but won't be too hard to find on the Net. (UPDATE : new hdparm +has an option for this !) +Use it with :</P> + +<P> <CODE>setcd -x [speed] [cdrom device]</CODE></P> + +<P>Also you can try:</P> + +<P> <CODE>echo current_speed:4 >/proc/ide/[cdrom device]/settings</CODE></P> + +<P>but you'll need root privileges. I use following command too:</P> + +<P> <CODE>echo file_readahead:2000000 >/proc/ide/[cdrom device]/settings</CODE></P> + +<P>for 2MB prefetched reading from the file (it's useful for scratched CDROMs). +It's recommended that you tuneup your CDROM drive also with hdparm:</P> + +<P> <CODE>hdparm -d1 -a8 -u1 (cdrom device)</CODE></P> + +<P>to enable using DMA access, readahead, and IRQ unmasking. +(if you don't understand these, *read the hdparm manpage*)</P> + +<P>Please refer to "<CODE>/proc/ide/[cdrom device]/settings</CODE>" for fine-tuning your +CDROM.</P> + +<P><B><A NAME=4.2>4.2. DVD playback</A></B></P> + +<P>Yes, the real DVD support has been arrived. You don't need to play VOB files +manually from disk thinking of the purpose of a file in the video_ts +directory, you don't need worry it it's an encrypted disk or not (in old +<B>MPlayer</B> you had to put '-dvdauth /dev/dvd' into the command line in case +of encrypted discs), and you don't need even mount your disk to be able to +play :)</P> + +<P>IMPORTANT NOTE: please _DO_NOT_ require further features for DVD playback. +This is the first version of some real DVD support inside <B>MPlayer</B> and +we're busy with hunting bugs and implementing basic DVD player features.</P> + +<P><B>MPlayer</B> uses libdvdread which has got built in support for IFO +parsing, reading navi blocks and doing authentication/descrambling. libdvdread +uses libdvdcss to the latter tasks. So you will need libdvdcss and libdvdread +downloaded, compiled and installed BEFORE you run ./configure script of +<B>MPlayer</B> which will autodetect libdvdread for you in this way.</P> + +<UL> +<LI><P><B>Download source of libdvdread and libdvdcss.</B></P> + +<P><I>You can download them from +<A HREF="http://www.dtek.chalmers.se/groups/dvd">http://www.dtek.chalmers.se/groups/dvd</A> +(click 'download' in the menu at the left, and you can find libdvdcss and +libdvdread in a table).</I></P> + +<P><B><I>IMPORTANT !</I></B><BR> +For +<UL> + <LI>libdvdread 0.8 - you'll need <B>libcss</B> instead of libdvdcss</LI> + <LI>libdvdread 0.9 - you'll need <B>libdvdcss 0.0.3</B> ! Don't use newer + versions, they won't work!</LI> + <LI>For example <B><U>never</U></B> use libdvdcss <B>1.0</B>, it will be unusably slow!</LI> +</UL> +</P> +</LI> + +<LI><P><B>Compile and install libdvdcss THEN libdvdread.</B></P> + +<P><I>Read documentation of these packages to do this step easily.</I></P></LI> + +<LI><P><B>Recompile MPlayer.</B></P> + +<P><I>Run <CODE>./configure</CODE>. If you install libdvdread correctly, ./configure +says something similar:<BR><CODE>Checking for DVDread support ... yes</CODE><BR> +(Of course you can put your favourite configure options into the command +line when you run ./configure). That's it! Say: <CODE>make</CODE>, then <CODE>make install</CODE>.</I></P></LI> +</UL> + +<P>Of course after installing libdvdcss and libdvdread you don't need recompile +them at each time when you want to recompile <B>MPlayer</B> (from a new CVS version +for example) since the needed packages have already been installed on your +machine.</P> + +<P><B>Using MPlayer to play DVDs:</B></P> + + +<TABLE BORDER=0 WIDTH=100%> +<TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-dvd <title_id> </TD> +<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Enables DVD support and selects title.</TD><TR> +<TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-chapter <chapter_id> </TD> +<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Selects DVD chapter (default: play from chapter 1)</TD><TR> +<TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-dvdangle <angle_id> </TD> +<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Selects camera angle (default: 1)</TD><TR> +<TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-sid <subtitle_id> </TD> +<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Turns DVD subtitle displaying (of the given subtitle_id or language) on (default: no)<BR> + For the list of available languages, use <CODE>-sid 1 -v</CODE> options and + browse the output.</TD><TR> +</TABLE> + +<P>Default device is <CODE>/dev/dvd</CODE>, you can change it in config.h +(compile time option), or you can specify it as a filename for <B>MPlayer</B>: +</P> + +<P> <CODE>mplayer -dvd 1 /dev/dvd</CODE></P> +<P> <CODE>mplayer -dvd 1 -sid 5 /dev/dvd</CODE></P> +<P> <CODE>mplayer -dvd 2 -chapter 5 -dvdangle 2</CODE></P> + +<P><B><A NAME=4.3>4.3. DVD playback FAQ</A></B></P> + +<TABLE BORDER=0 ALIGN=left WIDTH=100%> + +<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +Playing a DVD, I encountered this error :<BR> +<CODE>mplayer: ifo_read.c:1143: ifoRead_C_ADT_internal: Assertion nfo_length / +sizeof(cell_adr_t) >= c_adt->nr_of_vobs' failed.</CODE> +</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +This is a known libdvdread 0.9.1 bug, it should be already fixed in 0.9.2. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +Can I compile libdvdread and libdvdcss for example on my sweet Sparc/Solaris? +</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +Who knows ... Please test it and send feedback. But it's said that it +should work. Please refer documentation of libdvdread and its homepage +as well. We're not authors of libdvdread. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +What about subtitles? Can MPlayer display them? +</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +Yes! See above in the DVD chapter. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +I've got no sound / bad sound (Spanish audio and other ugly things). +</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +<B>MPlayer</B> currently does not use all of information of IFO blocks from DVD. +You can adjust the right DVD audio stream with: '-aid 128' command line +option, where 128 is the stream id of requested audio stream. You can +experience with numbers of 128,129,... and so on. Of course this problem +will be solved in the future. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +There is some strange effect (interlace like thing) especially when fast +moving objects are shown in the movie. +</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +Known problem, we try to fix it later (when we switch to libvo2). +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +How can I set the region code of my DVD-Drive ? I don't have windows! +</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +Use the 'regionset' tool: +<A HREF="http://www.linuxtv.org/download/dvd/dvd_disc_20000215.tar.gz">http://www.linuxtv.org/download/dvd/dvd_disc_20000215.tar.gz</A> +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +So MPlayer can play DVDs? Then it must use DeCSS! You are under arrest +under the XYZ#$ paragraph of the-- +</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +Get back asshole, there is no DeCSS code in <B>MPlayer</B>. <B>MPlayer</B> uses libdvdread +by linking against it, and libdvdread uses libdvdcss by dynamic loading it.<BR> +<B>UPDATE</B> : DeCSS is free. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +Do I need to be (setuid) root/setuid fibmap_mplayer to be able to play DVD? +</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +No, you don't. This is the past :) However of course you must have got +the proper rights to the DVD device driver entry (in /dev). +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +How can I ... (insert some expectable DVD player feature here)? +</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +The current implementation is the first implementation of some real DVD +player functionality. First, we would like to target existing bugs and +basic features before implementing new features. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top>Q:</TD><TD WIDTH=100%><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +Where can I get libdvdread and libdvdcss packages from? +</B></TD><TR><TD></TD><TD VALIGN=top>A:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> +From the site of Ogle: +<A HREF="http://www.dtek.chalmers.se/groups/dvd">http://www.dtek.chalmers.se/groups/dvd</A>. +</TD><TR><TD COLSPAN=3> </TD><TR> +</TABLE> + +</BODY> +</HTML> diff --git a/DOCS/Polish/codecs-in.html b/DOCS/Polish/codecs-in.html new file mode 100644 index 0000000000..aeeb15e2e5 --- /dev/null +++ b/DOCS/Polish/codecs-in.html @@ -0,0 +1,223 @@ +<HTML><HEAD> +<TITLE>mplayer - codec status table</TITLE> +<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"> +</HEAD> +<BODY BGCOLOR=#FFFFFF text="#000000" link="#666666" vlink="#666666" alink="#666666" leftmargin="0" topmargin="0" marginwidth="0" marginheight="0"> +<table width=750 border="0"> + <tr> + <td align="right"> + <p> </p> + + <p><b><font face="Verdana, Arial, Helvetica, sans-serif" size="2">Status of codecs support</font></b></p> + </td> + </tr> + <td> + <p><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><a href="#vc">Video codecs</a><br><a href="#ac">Audio codecs</a><br></font></p> + </td> + </tr> + <tr> + <td align="center"> + <b><font face="Verdana, Arial, Helvetica, sans-serif" size="5"><a name="vc">Video codecs:</a></font></b><br><br> + + <table width="100%" border="1" cellspacing="0" cellpadding="5" bordercolor=#DDDDDD> + + <tr> + <td colspan=6 bgcolor=#CCCCCC><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>Built-in native codecs</b></font></td> + </tr> + <tr> + <td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codec name</font></b></td> + <td width=70 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">fourcc</font></b></td> + <td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codecfile</font></b></td> + <td width=40 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">out</font></b></td> + <td align=center colspan=2><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">comments</font></b></td> + </tr> +<!-- %0 --> + <tr> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%i</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%F</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%d</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%Y</b></font></td> + <td align=center colspan=2><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%c</b></font></td> + </tr> +<!-- %. --> + + <tr> + <td colspan=6 bgcolor=#CCCCCC><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>Fully functional Win32 VfW/DShow codecs</b></font></td> + </tr> + <tr> + <td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codec name</font></b></td> + <td width=70 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">fourcc</font></b></td> + <td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codecfile</font></b></td> + <td width=40 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">out</font></b></td> + <td align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">DShow</font></b></td> + <td align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">comments</font></b></td> + </tr> +<!-- %1 --> + <tr> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%i</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%F</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%d</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%Y</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%D</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%c</b></font></td> + </tr> +<!-- %. --> + + <tr> + <td colspan=6 bgcolor=#CCCCCC><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>Codecs with problems</b></font></td> + </tr> + <tr> + <td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codec name</font></b></td> + <td width=70 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">fourcc</font></b></td> + <td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codecfile</font></b></td> + <td colspan=3 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">problem</font></b></td> + </tr> +<!-- %2 --> + <tr> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%i</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%F</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%d</b></font></td> + <td align=center colspan=3><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%c</b></font></td> + </tr> +<!-- %. --> + + <tr> + <td colspan=6 bgcolor=#CCCCCC><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>Not yet working codecs:</b></font></td> + </tr> + <tr> + <td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codec name</font></b></td> + <td width=70 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">fourcc</font></b></td> + <td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codecfile</font></b></td> + <td colspan=3 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">problem</font></b></td> + </tr> +<!-- %3 --> + <tr> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%i</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%F</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%d</b></font></td> + <td align=center colspan=3><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%c</b></font></td> + </tr> +<!-- %. --> + + <tr> + <td colspan=6 bgcolor=#CCCCCC><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>Not tested codecs:</b></font></td> + </tr> + <tr> + <td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codec name</font></b></td> + <td width=70 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">fourcc</font></b></td> + <td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codecfile</font></b></td> + <td colspan=3 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">problem</font></b></td> + </tr> +<!-- %4 --> + <tr> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%i</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%F</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%d</b></font></td> + <td align=center colspan=3><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%c</b></font></td> + </tr> +<!-- %. --> + + </table> + + <br><b><font face="Verdana, Arial, Helvetica, sans-serif" size="5"><a name="ac">Audio codecs:</a></font></b><br><br> + + <table width="100%" border="1" cellspacing="0" cellpadding="5" bordercolor=#DDDDDD> + + <tr> + <td colspan=6 bgcolor=#CCCCCC><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>Built-in native codecs</b></font></td> + </tr> + <tr> + <td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codec name</font></b></td> + <td width=70 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">format</font></b></td> + <td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codecfile</font></b></td> + <td align=center colspan=3><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">comments</font></b></td> + </tr> +<!-- %5 --> + <tr> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%i</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%f</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%d</b></font></td> + <td align=center colspan=3><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%c</b></font></td> + </tr> +<!-- %. --> + + <tr> + <td colspan=6 bgcolor=#CCCCCC><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>Fully functional Win32 ACM/DShow codecs</b></font></td> + </tr> + <tr> + <td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codec name</font></b></td> + <td width=70 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">format</font></b></td> + <td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codecfile</font></b></td> + <td width=40 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">DShow</font></b></td> + <td align=center colspan=2><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">comments</font></b></td> + </tr> +<!-- %6 --> + <tr> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%i</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%f</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%d</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%D</b></font></td> + <td align=center colspan=2><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%c</b></font></td> + </tr> +<!-- %. --> + + <tr> + <td colspan=6 bgcolor=#CCCCCC><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>Codecs with problems</b></font></td> + </tr> + <tr> + <td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codec name</font></b></td> + <td width=70 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">format</font></b></td> + <td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codecfile</font></b></td> + <td colspan=3 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">problem</font></b></td> + </tr> +<!-- %7 --> + <tr> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%i</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%f</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%d</b></font></td> + <td align=center colspan=3><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%c</b></font></td> + </tr> +<!-- %. --> + + <tr> + <td colspan=6 bgcolor=#CCCCCC><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>Not yet working codecs</b></font></td> + </tr> + <tr> + <td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codec name</font></b></td> + <td width=70 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">format</font></b></td> + <td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codecfile</font></b></td> + <td colspan=3 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">problem</font></b></td> + </tr> +<!-- %8 --> + <tr> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%i</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%f</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%d</b></font></td> + <td align=center colspan=3><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%c</b></font></td> + </tr> +<!-- %. --> + + <tr> + <td colspan=6 bgcolor=#CCCCCC><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>Not yet tested codecs</b></font></td> + </tr> + <tr> + <td width=150 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codec name</font></b></td> + <td width=70 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">format</font></b></td> + <td width=120 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">codecfile</font></b></td> + <td colspan=3 align=center><b><font color="#AAAAAA" face="Verdana, Arial, Helvetica, sans-serif" size="2">problem</font></b></td> + </tr> +<!-- %9 --> + <tr> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%i</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%f</b></font></td> + <td align=center><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%d</b></font></td> + <td align=center colspan=3><font face="Verdana, Arial, Helvetica, sans-serif" size="2"><b>%c</b></font></td> + </tr> +<!-- %. --> + + </table> + </td> + </tr> +</table> +</BODY> +</HTML> diff --git a/DOCS/Polish/codecs.html b/DOCS/Polish/codecs.html new file mode 100644 index 0000000000..771a21441e --- /dev/null +++ b/DOCS/Polish/codecs.html @@ -0,0 +1,352 @@ +<HTML> +<BODY BGCOLOR=WHITE> + +<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + +<P><B><A NAME=2.2>2.2. Wspierane kodeki</A></B></P> + + +<P><B><A NAME=2.2.1>2.2.1. Kodeki Video</A></B></P> + +<P>Zobacz: +<A HREF="http://www.mplayerhq.hu/DOCS/codecs-status.html"> +http://www.mplayerhq.hu/DOCS/codecs-status.html</A>. Znajdziesz tam kompletn±, +codziennie tworzon± listê!!!</P> + +<P>Najwa¿niejsze kodeki video:<BR> +<UL> +<LI>MPEG1 (VCD) i MPEG2 (DVD) video</LI> +<LI>DivX ;-), OpenDivX (DivX4), 3ivx i inne warianty MPEG4</LI> +<LI>Windows Media Video 7 (WMV1) i 8 (WMV2) wykorzystywany w plikach .wmv</LI> +<LI>Kodeki Intel Indeo (3.1,3.2,4.1,5.0)</LI> +<LI>MJPEG, ASV2 i inne formaty sprzêtowe</LI> +<LI>Kodeki XAnim</LI> +<LI>VIVO</LI> +</UL></P> + +<P>Je¶li masz kodeka Win32 nie wymienionego tutaj, oraz jeszcze nie +obs³ugiwanego, przeczytaj <A HREF="#2.2.3">importowanie kodeków</A>, by uzyskaæ +informacje o tym, jak pomóc nam w dodaniu wsparcia dla niego!</P> + +<P><B><A NAME=2.2.1.1>2.2.1.1. DivX4</A></B></P> + +<P>Ta sekcja zawiera informacje o kodekach DivX4 z <A +HREF="http://www.projectmayo.com">ProjectMayo</A>. Ich pierwsz± dostêpn± wersj± +alfa by³ OpenDivX 4.0 alfa 47 oraz 48. Wsparcie dla nich zosta³o do³±czone w +<B>MPlayerze</B>, i jest kompilowane standardowo. Dawniej u¿ywali¶my kodu +postprocessing z tych kodeków do opcjonalnego zwiêkszenia jako¶ci filmów +MPEG1/2. Teraz ju¿ stosujemy w³asny.</P> + +<P>Nowa generacja tych kodeków potrafi nawet dekodowaæ filmy zrobione z u¿yciem +nies³awnych kodeków DivX! Ale to jeszcze nie wszystko! S± one DU¯O szybsze, ni¿ +tradycyjne DLLe Win32 DivX. Zobacz poni¿ej opis konfiguracji. Jedyn± wad± tych +kodeków jest fakt, ¿e aktualnie s± one closed-source. :(</P> + +<P>Kodeki mo¿na ¶ci±gn±æ z nastêpuj±cego URL:</P> + +<P> <A HREF="http://download2.projectmayo.com/dnload/divx4linux/divx4linux-20010718.zip">http://download2.projectmayo.com/dnload/divx4linux/divx4linux-20010718.zip</A></P> + +<P>Rozpakuj je i uruchom, jako root, polecenie: <CODE>./install.sh</CODE> .</P> + +<P>Uwaga: NIE zapomnij dodaæ /usr/local/lib do /etc/ld.so.conf !</P> + +<P><B>MPlayer</B> automatycznie wykrywa czy DivX4 jest (w³a¶ciwie) +zainstalowany, wystarczy go, tak jak zawsze, skompilowaæ. Je¶li mplayer nie +wykrywa DivX4, oznacza to, ¿e nie zainstalowa³e¶ go w taki sposób jak powy¿ej +podano, i/lub popsu³e¶ konfiguracjê (zobacz ostatnie pytanie w sekcji 5.1).</P> + +<P>U¿ywanie tego kodeka jest trochê skomplikowane. Poniewa¿ powstaje konflikt +ze starym OpenDivX (jego API jest bardzo podobne do do tego z OpenDivX), kod +OpenDivX jest wy³±czony, równie¿ sterownik OpenDivX wywo³uje t± bibliotekê.</P> + +<P>Ogólnie mo¿emy sprowadziæ to zagadnienie do faktu, ¿e masz dwie opcje do +zastosowania tego kodeka:</P> + +<P><TABLE BORDER=0> +<TD> </TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, +sans-serif" size=2>-vc odivx</TD><TD> </TD> <TD><FONT +face="Verdana, Arial, Helvetica, sans-serif" size=2>u¿ycie kodeka divx4 jako +nowej wersji OpenDivX. W tym przypadku produkuje on we w³asnym buforze obrazy +YV12 oraz <B>MPlayer</B> (libvo) dokonuje konwersji przestrzeni kolorów. +(<B>REKOMENDOWANE!</B>)</TD><TR> <TD></TD><TD VALIGN=top><FONT face="Verdana, +Arial, Helvetica, sans-serif" size=2>-vc divx4</TD><TD></TD> <TD><FONT +face="Verdana, Arial, Helvetica, sans-serif" size=2>u¿ycie konwersji +przestrzeni kolorów z kodeka divx4. W tym trybie mo¿na u¿yæ równie¿ +YUY2/UYVY.</TD></TR> +</TABLE></P> + +<P>Metoda 'odivx' jest zazwyczaj szybsza, ze wzglêdu na fakt, ¿e przenosi ona +dane obrazu do formatu YV12 (planar YUV 4:2:0), a to wymaga du¿o mniejszego +pasma przenoszenia na szynie. W trybie spakowanego YUV (YUY2, UYVY) stosuj +metodê 'divx4'. W trybie RGB mo¿esz dowolnie wybieraæ, poniewa¿ prêdko¶ci ich +s± takie same, ró¿ni± siê byæ mo¿e tylko w odniesieniu do aktualnego bpp.</P> + +<P>Uwaga: ten kodek wspiera równie¿ postprocessing, ale zakres warto¶ci jest +dziwny: (UAKTUALNIÆ)</P> + +<P><TABLE BORDER=0> +<TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>0</TD><TD> </TD> +<TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>bez postproc</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>10 .. 20</TD> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>postprocessing, normalny (jak na poziomie 2 z divxd)</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>30 .. 60</TD> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>mocny prostprocessing, obci±¿a mocno CPU (podobnie jak poziom 4 z divxd</TD><TR> +</TABLE></P> + +<P><B><A NAME=2.2.1.2>2.2.1.2. DivX/libavcodec z ffmpeg</A></B></P> + +<P>Poczynaj±c od wersji 0.4.2, <A +HREF="http://ffmpeg.sourceforge.net">ffmpeg</A> zawiera kodek DivX +<B>opensource</B>, który jest kompatybilny z tradycyjnym DivX. <B>MPlayer</B> +wspiera ten kodek i dziêki temu mo¿liwe staje siê <B>ogl±danie filmów +DivX/DivX4 na platformach innych ni¿ x86</B> oraz osi±ganie du¿o szybszej +prêdko¶ci dekodowania <B>DivX/DivX4</B>, ni¿ za pomoc± kodeków Win32 i +oryginalnych bibliotek DivX4<BR>. Poniewa¿ zosta³o to usuniête z drzewa cvs +<B>MPlayera</B>, musisz ¶ci±gn±æ to rêcznie bezpo¶rednio z drzewa cvs +<B>FFmpeg</B></P>. + +<P><CODE> + cvs -d:pserver:anonymous@cvs.ffmpeg.sourceforge.net:/cvsroot/ffmpeg login<BR> + cvs -d:pserver:anonymous@cvs.ffmpeg.sourceforge.net:/cvsroot/ffmpeg co ffmpeg +</CODE></P> + +<P>UWAGA: <I>Je¶li kopiujesz z podkatalogami CVS, nastêpnym razem wystarczy +zrobiæ 'cvs update'.</I></P> + +<P>Teraz przenie¶ nowo ¶ci±gniête ¼ród³a ffmpeg: katalog <B>libavcodec</B>, (ze +wszystkimi jego podkatalogami) do drzewa katalogowego <B>MPlayera</B>, tak, aby +to wygl±da³o w taki sposób:</P> + +<P> <CODE>main/libavcodec</CODE></P> + +<P>Linkowanie symboliczne NIE jest wystarczaj±ce. Musisz to skopiowaæ b±d¼ +przenie¶æ!!!</P> + +<P>Nastêpnie skompiluj. configure wykrywa czy wszystko jest w porz±dku i mo¿e +byæ skompilowane. Ten kodek równie¿ <B>wspiera postprocessing!</B></P> + +<P>W celu u¿ycia go, od¶wie¿ swój plik codecs.conf, zgodnie z tym, co mówi± +strony podrêcznika lub example.conf (opcja -vfm).</P> + +<P>Aby osi±gn±æ <B>najwiêksz± prêdko¶æ</B> na moim K6, usuwam sekcjê +<CODE>ffmpeg12</CODE> z codecs.conf (ten kodek nie jest zoptymalizowany a +libmpeg2 jest dwa razy szybszy), i wpisujê <CODE>vfm=5</CODE> w moim pliku +konfiguracyjnym. Po czym <B>MPlayer</B> zawsze ju¿ u¿ywa <B>ffdivx/ffodivx</B> +do dekodowania plików <B>DivX/DivX4</B> oraz libmpeg2 do plików MPEG1/2. Przy +takiej konfiguracji na moim K6/2 500 z Matrox G400 mogê ogl±daæ filmy +DivX/DivX4 w najwy¿szej rozdzielczo¶ci, bez straty klatek (framedrop).</P> + +<P><B><A NAME=2.2.1.3>2.2.1.3. Kodeki XAnim</A></B></P> + +<P>U¿ywanie (niektórych) kodeków XAnim z innym programem ni¿ XAnim, jest +<B><I>NIELEGALNE</I></B>. <B>TWOIM</B> obowi±zkiem jest przeczytanie +licencji i zastosowanie siê do niej. Autorzy <B>MPlayera</B> nie mog± zostaæ +poci±gniêci do odpowiedzialno¶ci za jakiekolwiek, sprzeczne z prawem, +zachowania u¿ytkowników.</P> + +<P>A wiêc: tak, <B>MPlayer</B> potrafi u¿ywaæ do dekodowania kodeków XAnim. +W³±czenie ich jest bardzo proste:</P> + +<P> +<UL> + <LI>¦ci±gnij kodeki, których chcesz u¿ywaæ ze +<A HREF="http://xanim.va.pubnix.com">strony XAnim</A>. Nie ma tam kodeka +<B>3ivx</B> , wiêc ¶ci±gnij go ze <A HREF="http://www.3ivx.com">strony +3ivx</A>.</LI> + + <LI>U¿yj opcji <CODE>--with-xanimlibdir</CODE>, aby podaæ dla configure, +gdzie znajduj± siê kodeki xanim. Domy¶lnie s± one szukane w katalogu +<CODE>/</CODE> (...) .</LI> + + <LI>Zmieñ nazwy plików, obcinaj±c czê¶æ dotycz±c± architektury tak, aby +wygl±da³y one nastêpuj±co: <CODE>vid_cvid.xa, vid_h263.xa, vid_iv50.xa</CODE> + +</UL> +</P> + +<P>Jest to rodzina kodeków video o numerze 10, przydatne wiêc bêdzie u¿ycie +opcji <CODE>-vfm 10</CODE> i poinformowanie <B>MPlayera</B>, by ich u¿y³ je¶li +to mo¿liwe.</P> + +<P>Testowane kodeki: <B>Indeo 3.2</B>, <B>4.1</B>, <B>5.0</B>, <B>CVID</B>, <B>3ivX</B>, <B>h263</B>.</P> + + +<P><B><A NAME=2.2.1.4>2.2.1.4. Obraz VIVO</A></B></P> + +<P><B>MPlayer</B> potrafi odgrywaæ obrazy Vivo (1.0 i 2.0). Najbardziej +odpowiedni kodek do plików 1.0, to dekoder FFmpeg's H263, Mo¿esz go u¿yæ za +pomoc± opcji <CODE>-vc ffh263</CODE> (bêdziesz potrzebowa³ najnowszego +libavcodec!). Do plików 2.0 u¿yj <CODE>ivvideo.dll</CODE> pliku DLL Win32 (do +sci±gniêcia <A +HREF="http://www.mplayerhq.hu/MPlayer/samples/drivers32/ivvideo.dll">tutaj</A>), +zainstaluj go w <CODE>/usr/lib/win32</CODE>, b±d¼ w innym miejscu, w którym +przechowujesz kodeki Win32. Ten pó¼niejszy kodek nie obs³uguje trybów YV12 ani +YUY2, a tylko BGR i jest u¿yteczny wy³±cznie z wyj¶ciami X11 i OpenGL. Miejmy +nadziejê, ¿e ffh263 bêdzie wspiera³ pliki VIVO 2.0 w przysz³o¶ci.</P> + + +<P><B><A NAME=2.2.1.5>2.2.1.5. Obraz MPEG 1/2</A></B></P> + +<P>MPEG1 i MPEG2 s± dekodowane za pomoc± biblioteki w³asnej <B>libmpeg2</B>. +Jej kod ¼ród³owy jest zawarty w <B>MPlayerze</B> i oczywi¶cie jest +wieloplatformowy. Obs³ugujemy pliki video MPEG1/2 z b³êdami przez sprawdzanie, +jak± sygnaturê zwraca libmpeg2, i kiedy jest to sig11 (segmentation fault), +szybko inicjalizujemy ponownie kodek, i kontynuujemy dok³adnie z tego miejsca, +w którym pojawi³ siê b³±d. Nie ma tu zauwa¿alnej straty prêdko¶ci.</P> + + +<P><B><A NAME=2.2.1.6>2.2.1.6. MS Video1</A></B></P> + +<P>Jest bardzo stary i bardzo z³y kodek Microsoftu. W przesz³o¶ci by³ on +dekodowany z kodekiem Win32 <CODE>msvidc32.dll</CODE>, teraz mamy w³asn± +implementacjê open-source wykonan± przez <A +HREF="mailto:melanson@pcisys.net">Mike'a Melansona</A>).</P> + + +<P><B><A NAME=2.2.1.7>2.2.1.7. Cinepak CVID</A></B></P> + +<P>Najlepszym sposobem, aby ogl±daæ obrazy Cinepak za pomoc± <B>MPlayera</B> +jest u¿ycie kodeka XAnim <CODE>vid_cvid.xa</CODE>, poniewa¿ obs³uguje on wyj¶cia +YV12, YUY2, w przeciwieñstwie do kodeka Win32, który wspiera wy³±cznie RGB.</P> + + +<P><B><A NAME=2.2.2>2.2.2. Kodeki d¼wiêku</A></B></P> + +<P>Najwa¿niejsze kodeki d¼wiêku, to:<BR> +<UL> +<LI>MPEG layer 2 oraz layer 3 (MP3) audio(<B>w³asny</B> kod, z optymalizacj± MMX/SSE/3DNow!)</LI> +<LI>MPEG layer 1 audio(<B>w³asny</B> kod, z libavcodec)</LI> +<LI>AC3 Dolby audio (<B>w³asny</B> kod, z optymalizacj± SSE/3DNow!)</LI> +<LI>Ogg Vorbis kodek audio (<B>w³asna</B> biblioteka)</LI> +<LI>Voxware audio (u¿ycie DirectShow DLL)</LI> +<LI>alaw, msgsm, pcm i inne proste stare formaty d¼wiêkowe</LI> +</UL></P> + + +<P><B><A NAME=2.2.2.1>2.2.2.1. Programowe dekodowanie AC3</A></B></P> + +<P>Domy¶lny dekoder, u¿ywany do plików z d¼wiêkiem AC3.</P> + +<P>Dekoder AC3 mo¿e tworzyæ mieszanki wyj¶ciowego d¼wiêku dla 2, 4 lub 6 +g³o¶ników. Skonfigurowany dla 6 g³o¶ników, dekoder ten dostarcza oddzielne +wyj¶cia dla wszystkich kana³ów AC3 do sterownika karty d¼wiêkowej, umo¿liwiaj±c +do¶wiadczenie wra¿enia pe³nego "d¼wiêku otaczaj±cego", bez wymagania od +zewnêtrznego dekodera AC3 u¿ycia kodeka hwac3.</P> + +<P>U¿yj opcji <CODE>-channels</CODE>, aby wybraæ ilo¶æ kana³ów wyj¶ciowych. +U¿yj opcji <CODE>-channels 2</CODE> dla stereo downmix. Dla czterokana³owego +downmix (wyj¶cia lewo-przód, prawo-przód, lewo-ty³, prawo-ty³), u¿yj opcji +<CODE>-channels 4</CODE>. W tym przypadku jakikolwiek centralny kana³ bêdzie +miksowany odpowiednio do przednich kana³ów. Ostatecznie, "-channels 6" bêdzie +wyprowadza³o wszystkie kana³y AC3 tak, jak s± zakodowane - w kolejno¶ci lewy, +prawy, lewy-tylny, prawy-tylny, centralny oraz LFE.</P> + +<P>Domy¶lna liczba kana³ów wyj¶ciowych wynosi 2.</P> + +<P>Aby korzystaæ z wiêcej ni¿ dwóch kana³ów wyj¶ciowych, musisz u¿yæ OSS, i +posiadaæ sterownik dla karty d¼wiêkowej, który obs³uguje odpowiedni± liczbê +kana³ów wyj¶ciowych przez SNDCTL_DSP_CHANNELS ioctl. Na przyk³ad wersja +sterownika emu10k1 (u¿ywanego z kartami SB Live), nowsza ni¿ z sierpnia 2001, +powinna byæ odpowiednia.</P> + +<P>Miksowanie na wyj¶ciu wiêcej ni¿ dwóch kana³ów powinno byæ traktowane jako +eksperymentalne.</P> + +<P><B><A NAME=2.2.2.2>2.2.2.2. Sprzêtowe dekodowanie AC3</A></B></P> + +<P>Potrzebna ci bêdzie karta d¼wiêkowa, zdolna do obs³ugi AC3, z cyfrowym +wyj¶ciem (SP/DIF). Sterownik karty d¼wiêkowej musi obs³ugiwaæ format AFMT_AC3 +(tak, jak to jest w SB Live!). Po³±cz swój dekoder AC3 do wyj¶cia SP/DIF oraz +u¿yj opcji '-ac hwac3'. To mo¿e zadzia³aæ, b±d¼ nie (status eksperymentalny - +najprawdopodobniej nie zadzia³a).</P> + + +<P><B><A NAME=2.2.2.3>2.2.2.3. Obs³uga libmad</A></B></P> + +<P><A HREF="http://mad.sourceforge.net">libmad</A> jest wieloplatformow± +bibliotek± dekodowania d¼wiêku MPEG. Je¶li nie wiesz dlaczego to jest dobre, +prawdopodobnie nie potrzebujesz tego. </P> + +<P>Aby w³±czyæ obs³ugê, skompiluj ¼ród³a z opcj± <CODE>--enable-mad</CODE>. +</P> + + +<P><B><A NAME=2.2.2.4>2.2.2.4. D¼wiêk VIVO</A></B></P> + +<P>Kodek d¼wiêku stosowany do plików VIVO zale¿y od tego, czy jest to plik +VIVO/1.0, czy VIVO/2.0. Pliki VIVO/1.0 zawieraj± d¼wiêk <B>g.723</B>, za¶ pliki +VIVO/2.0 maj± <B>Vivo Siren</B>. Obecnie ¿aden z nich nie jest wspierany, ale +mo¿esz ¶ci±gn±æ kodek g.723 z +<A HREF="http://www.mplayerhq.hu/MPlayer/samples/drivers32/vivog723.acm">tej +strony</A>, a nastêpnie skopiowaæ go do katalogu <CODE>/usr/lib/win32</CODE> +lub innego odpowiedniego.</P> + + +<P><B><A NAME=2.2.3>2.2.3. Importowanie kodeków Win32</A></B></P> + +<P><B><A NAME=2.2.3.1>2.2.3.1. Kodeki VFW</A></B></P> + +<P>VfW (Video for Windows), jest to stare Video API dla Windows. Jego kodeki +maj± rozszerzenia .DLL lub (rzadziej) .DRV. +Je¶li <B>MPlayer</B> nie dzia³a z twoim AVI:</P> + +<P> <CODE>UNKNOWN video codec: HFYU (0x55594648)</CODE></P> + +<P>To oznacza, ¿e twój AVI jest zakodowany za pomoc± kodeka, który ma HFYU +fourcc (HFYU = kodek HuffYUV, DIV3 = DivX Low Motion, itd....). Teraz, gdy ju¿ +to wiemy, bêdziemy musieli dowiedzieæ siê, któr± bibliotekê DLL z Windows +za³adowaæ, aby móc odtworzyæ ten plik. W naszym przypadku system.ini zawiera to +(oraz wiele innych):</P> + +<P> <CODE>VIDC.HFYU=huffyuv.dll</CODE></P> + +<P>Tak wiêc bêdziemy potrzebowaæ pliku huffyuv.dll. Zauwa¿, ¿e kodeki d¼wiêku s± wyró¿nione za pomoc± prefiksu MSACM:</P> + +<P> <CODE>msacm.l3acm=L3codeca.acm</CODE></P> + + +<P>To jest kodek MP3. Maj±c ju¿ wszystkie potrzebne informacje (fourcc, +plik z kodekiem, próbka AVI), wy¶lij ¿±danie wsparcia dla twojego kodeka mailem +i za³aduj te pliki przez FTP:</P> + +<P> <CODE>ftp://ftp.mplayerhq.hu/MPlayer/incoming/[nazwa_kodeka]/</CODE></P> + + +<P><B><A NAME=2.2.3.2>2.2.3.2. Kodeki DirectShow</A></B></P> + +<P>DirectShow to najnowsze Video API, które jest nawet gorsze, ni¿ jego +poprzednik. Sprawy siê bardziej komplikuj±, odk±d: +<UL> +<LI>system.ini nie zawiera potrzebnych informacji, a w zamian za to jest przechowywany w rejestrze :( +<LI>bêdzie potrzebny nam GUID kodeka. +</UL></P> + +<P>Wiêc znajd¼my ten przeklêty rejestr ... +<UL> +<LI>Uruchom 'regedit'. +<LI>Wci¶nij ctrl-f, odznacz pierwsze dwie opcje i zaznacz trzeci±. Wpisz +fourcc kodeka (np.: TM20). +<LI>Powinno siê pokazaæ pole ze ¶cie¿k± i nazw± pliku (np. : +C:\WINDOWS\SYSTEM\TM20DEC.AX). +<LI>Skoro mamy ju¿ plik, potrzebne nam jeszcze GUID. Spróbuj jeszcze raz +poszukaæ, ale tym razem nazwy kodeka, nie fourcc. Jego nazwê mo¿na odczytaæ w +File/Properties/Advanced, podczas odtwarzania tego pliku przez Media Player. +Je¶li siê nie da, to pech ;) Spróbuj zgadn±æ (np. szukaj: TrueMotion). +<LI>Je¶li znalaz³e¶ (w rejestrze), powinno byæ tam pole FriendlyName oraz pole +CLSID. Zapisz, ¿e 16 bajtów CLSID, to potrzebne nam GUID. +</UL></P> + +<P>UWAGA:Poszukuj±c plików, staraj siê w³±czyæ wszystkie pola wyboru ... +Mo¿esz dostaæ wiele nieprzydatnych odpowiedzi, ale byæ mo¿e dostaniesz te +w³a¶ciwe przy okazji ... </P> + +<P>UWAGA: W razie niepowodzenia zrzuæ wszystko na M$.</P> + + +<P>Maj±c ju¿ wszystkie potrzebne informacje (fourcc, GUID, plik z kodekiem, +próbka AVI), wy¶lij zg³oszenie wsparcia dla swojego kodeka mailem, i prze¶lij +te pliki na adres FTP:<BR> +ftp://ftp.mplayerhq.hu/MPlayer/incoming/[nazwa_kodeka]/</P> + +</BODY> +</HTML> diff --git a/DOCS/Polish/documentation.html b/DOCS/Polish/documentation.html new file mode 100644 index 0000000000..bf71ae0431 --- /dev/null +++ b/DOCS/Polish/documentation.html @@ -0,0 +1,1634 @@ +<HTML> +<BODY BGCOLOR=WHITE> + +<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + +<P><CENTER><B>MPlayer - Movie Player for LINUX (C) 2000-2001 Arpad Gereoffy (A'rpi/ESP-team)</B><BR> +<BR><A HREF="http://www.mplayerhq.hu">http://www.mplayerhq.hu</A><BR><BR> +<BR><A HREF="../documentation.html">[ Angielski ]</A> +<A HREF="../Hungarian/documentation.html">[ Wêgierski ]</A> +<A HREF="../German/documentation.html">[ Niemiecki ]</A> +<A HREF="../French/documentation.html">[ Francuski ]</A> +[ Polski ] +</CENTER></P> + +<P><HR></P> + +<P>Spis tre¶ci</P> + +<P><HR></P> + +<P> +<UL> + <LI><A HREF="#1">1. Wprowadzenie</A></LI> + <UL> + <LI><A HREF="#1.1">1.1 O programie</A></LI> + <LI><A HREF="#1.2">1.2 Historia</A></LI> + <LI><A HREF="#1.3">1.3 Instalacja</A></LI> + <LI><A HREF="#1.4">1.4 A co z GUI?</A></LI> + <LI><A HREF="#1.5">1.5 Napisy i OSD</A></LI> + </UL> + <LI><A HREF="#2">2. W³a¶ciwo¶ci</A></LI> + <UL> + <LI><A HREF="formats.html">2.1 Wspierane formaty</A></LI> + <UL> + <LI><A HREF="formats.html#2.1.1">2.1.1 Obraz</A></LI> + <UL> + <LI><A HREF="formats.html#2.1.1.1">2.1.1.1 Pliki MPG, VOB i DAT</A></LI> + <LI><A HREF="formats.html#2.1.1.2">2.1.1.2 Pliki AVI</A></LI> + <LI><A HREF="formats.html#2.1.1.3">2.1.1.3 Pliki ASF/WMV</A></LI> + <LI><A HREF="formats.html#2.1.1.4">2.1.1.4 Pliki QT/MOV</A></LI> + <LI><A HREF="formats.html#2.1.1.5">2.1.1.5 Pliki VIV</A></LI> + </UL> + <LI><A HREF="formats.html#2.1.2">2.1.2 D¼wiêk</A></LI> + </UL> + <LI><A HREF="codecs.html#2.2">2.2 Wspierane kodeki</A></LI> + <UL> + <LI><A HREF="codecs.html#2.2.1">2.2.1 Obraz</A></LI> + <UL> + <LI><A HREF="codecs.html#2.2.1.1">2.2.1.1 DivX4</A></LI> + <LI><A HREF="codecs.html#2.2.1.2">2.2.1.2 DivX/libavcodec w ffmpeg</A></LI> + <LI><A HREF="codecs.html#2.2.1.3">2.2.1.3 Kodeki XAnim</A></LI> + <LI><A HREF="codecs.html#2.2.1.4">2.2.1.4 Obraz VIVO</A></LI> + <LI><A HREF="codecs.html#2.2.1.5">2.2.1.5 Obraz MPEG1/2</A></LI> + <LI><A HREF="codecs.html#2.2.1.6">2.2.1.6 MS Video1</A></LI> + <LI><A HREF="codecs.html#2.2.1.7">2.2.1.7 Cinepak CVID</A></LI> + </UL> + <LI><A HREF="codecs.html#2.2.2">2.2.2 D¼wiêk</A></LI> + <UL> + <LI><A HREF="codecs.html#2.2.2.1">2.2.2.1 Dekodowanie programowe AC3</A></LI> + <LI><A HREF="codecs.html#2.2.2.2">2.2.2.2 Dekodowanie sprzêtowe AC3</A></LI> + <LI><A HREF="codecs.html#2.2.2.3">2.2.2.3 Wsparcie dla libmad</A></LI> + <LI><A HREF="codecs.html#2.2.2.4">2.2.2.4 D¼wiêk VIVO</A></LI> + </UL> + <LI><A HREF="codecs.html#2.2.3">2.2.3 Jak importowaæ kodeki Win32</A></LI> + <UL> + <LI><A HREF="codecs.html#2.2.3.1">2.2.3.1 Kodeki VFW</A></LI> + <LI><A HREF="codecs.html#2.2.3.2">2.2.3.2 Kodeki DirectShow</A></LI> + </UL> + </UL> + <LI><A HREF="video.html">2.3 Urz±dzenia wyj¶ciowe</A></LI> + <UL> + <LI><A HREF="video.html#2.3.1">2.3.1 Obraz</A></LI> + <UL> + <LI><A HREF="video.html#2.3.1.1">2.3.1.1 Ustawienie MTRR</A></LI> + <LI><A HREF="video.html#2.3.1.2">2.3.1.2 Xv</A></LI> + <UL> + <LI><A HREF="video.html#2.3.1.2.1">2.3.1.2.1 3dfx</A></LI> + <LI><A HREF="video.html#2.3.1.2.2">2.3.1.2.2 S3</A></LI> + <LI><A HREF="video.html#2.3.1.2.3">2.3.1.2.3 nVidia</A></LI> + <LI><A HREF="video.html#2.3.1.2.4">2.3.1.2.4 ATI</A></LI> + <LI><A HREF="video.html#2.3.1.2.5">2.3.1.2.5 NeoMagic</A></LI> + </UL> + <LI><A HREF="video.html#2.3.1.3">2.3.1.3 DGA</A></LI> + <UL> + <LI><A HREF="video.html#2.3.1.3.1">2.3.1.3.1 Podsumowanie</A></LI> + <LI><A HREF="video.html#2.3.1.3.2">2.3.1.3.2 Czym jest DGA</A></LI> + <LI><A HREF="video.html#2.3.1.3.3">2.3.1.3.3 Instalacja wsparcia DGA dla MPlayera</A></LI> + <LI><A HREF="video.html#2.3.1.3.4">2.3.1.3.4 Prze³±czanie rozdzielczo¶ci</A></LI> + <LI><A HREF="video.html#2.3.1.3.5">2.3.1.3.5 DGA i MPlayer</A></LI> + <LI><A HREF="video.html#2.3.1.3.6">2.3.1.3.6 W³a¶ciwo¶ci sterownika DGA</A></LI> + <LI><A HREF="video.html#2.3.1.3.7">2.3.1.3.7 Zagadnienie szybko¶ci</A></LI> + <LI><A HREF="video.html#2.3.1.3.8">2.3.1.3.8 Znane b³êdy</A></LI> + <LI><A HREF="video.html#2.3.1.3.9">2.3.1.3.9 Plany na przysz³o¶æ</A></LI> + <LI><A HREF="video.html#2.3.1.3.A">2.3.1.3.A Wybrane modeline</A></LI> + <LI><A HREF="video.html#2.3.1.3.B">2.3.1.3.B Raporty o b³êdach</A></LI> + </UL> + <LI><A HREF="video.html#2.3.1.4">2.3.1.4 SDL</A></LI> + <LI><A HREF="video.html#2.3.1.5">2.3.1.5 SVGAlib</A></LI> + <LI><A HREF="video.html#2.3.1.6">2.3.1.6 Wyj¶cie framebuffera (FBdev)</A></LI> + <LI><A HREF="video.html#2.3.1.7">2.3.1.7 Framebuffer Matroxa (mga_vid)</A></LI> + <LI><A HREF="video.html#2.3.1.8">2.3.1.8 Framebuffer SiS 6326 (sis_vid)</A></LI> + <LI><A HREF="video.html#2.3.1.9">2.3.1.9 Wsparcie dla 3dfx YUV (tdfxfb)</A></LI> + <LI><A HREF="video.html#2.3.1.10">2.3.1.10 Wyj¶cie OpenGL</A></LI> + <LI><A HREF="video.html#2.3.1.11">2.3.1.11 AAlib - wy¶wietlanie w trybie tekstowym</A></LI> + <LI><A HREF="video.html#2.3.1.12">2.3.1.12 VESA - wyj¶cie do BIOSu VESA </A></LI> + <LI><A HREF="video.html#2.3.1.13">2.3.1.13 X11</A></LI> + <LI><A HREF="video.html#2.3.1.14">2.3.1.14 Rage128 / Radeon - nak³adkowanie obrazu</A></LI> + <LI><A HREF="video.html#2.3.1.A">2.3.1.A TVout</A></LI> + <UL> + <LI><A HREF="video.html#2.3.1.A.1">2.3.1.A.1 Matrox</A></LI> + <LI><A HREF="video.html#2.3.1.A.2">2.3.1.A.2 ATI</A></LI> + <LI><A HREF="video.html#2.3.1.A.3">2.3.1.A.3 Voodoo 3/Banshee</A></LI> + </UL> + </UL> + <LI><A HREF="sound.html#2.3.2">2.3.2 D¼wiêk</A></LI> + <UL> + <LI><A HREF="sound.html#2.3.2.1">2.3.2.1 Do¶wiadczenia z kartami d¼wiêkowymi, rekomendacje</A></LI> + </UL> + </UL> + <LI><A HREF="encoding.html#2.4">2.4 MEncoder - koder oparty na MPlayerze</A></LI> + <UL> + <LI><A HREF="encoding.html#2.4.1">2.4.1 O programie</A></LI> + <LI><A HREF="encoding.html#2.4.2">2.4.2 Kompilacja</A></LI> + <LI><A HREF="encoding.html#2.4.3">2.4.3 W³a¶ciwo¶ci</A></LI> + <UL> + <LI><A HREF="encoding.html#2.4.3">2.4.3 Podsumowanie</A></LI> + <LI><A HREF="encoding.html#2.4.3.1">2.4.3.1 Kodowanie dwupasmowe DivX4</A></LI> + <LI><A HREF="encoding.html#2.4.3.2">2.4.3.2 Przeskalowywanie filmów</A></LI> + <LI><A HREF="encoding.html#2.4.3.3">2.4.3.3 Streamcopy</A></LI> + </UL> + <LI><A HREF="encoding.html#2.4.4">2.4.4 Sk³adnia</A></LI> + <LI><A HREF="encoding.html#2.4.5">2.4.5 Dostêpne opcje</A></LI> + <LI><A HREF="encoding.html#2.4.6">2.4.6 Przyk³ady</A></LI> + </UL> + <LI><A HREF=#2.5>2.5 Wej¶cie TV</A></LI> + </UL> + <LI><A HREF="#3">3. Sposób u¿ycia</A></LI> + <UL> + <LI><A HREF="#3.1">3.1 Sterowanie za pomoc± klawiatury</A></LI> + <LI><A HREF="#3.2">3.2 Sterowanie przez LIRC (Linux Infrared Remote Control)</A></LI> + <LI><A HREF="#3.3">3.3 Obs³uga potoków z sieci, b±d¼ jako pipe</A></LI> + </UL> + <LI><A HREF="cd-dvd.html#4">4. Sekcja CD/DVD</A></LI> + <UL> + <LI><A HREF="cd-dvd.html#4.1">4.1 Napêdy CD</A></LI> + <LI><A HREF="cd-dvd.html#4.2">4.2 Odtwarzanie DVD</A></LI> + <LI><A HREF="cd-dvd.html#4.3">4.3 Odtwarzanie DVD - FAQ</A></LI> + </UL> + <LI><A HREF="faq.html">5. Sekcja FAQ</A></LI> + <UL> + <LI><A HREF="faq.html#5.1">5.1 Kompilacja</A></LI> + <LI><A HREF="faq.html#5.2">5.2 Ogólne pytania</A></LI> + <LI><A HREF="faq.html#5.3">5.3 Problemy z odgrywaniem plików</A></LI> + <LI><A HREF="faq.html#5.4">5.4 Problemy ze sterownikami video/audio</A></LI> + <LI><A HREF="faq.html#5.5">5.5 Wymagania okre¶lonnych zachowañ</A></LI> + <LI><A HREF="faq.html#5.6">5.6 Kodowanie</A></LI> + </UL> + <LI><A HREF="#6">6. Ró¿ne systemy operacyjne</A></LI> + <UL> + <LI><A HREF="#6.1">6.1 Pakiety Debiana</A></LI> + <LI><A HREF="#6.2">6.2 FreeBSD</A></LI> + <LI><A HREF="#6.3">6.3 Solaris</A></LI> + <LI><A HREF="#6.4">6.4 StrongARM</A></LI> + <LI><A HREF="#6.5">6.5 SGI/Irix</A></LI> + <LI><A HREF="#6.6">6.6 QNX</A></LI> + </UL> + <LI><A HREF="#A">A. Autorzy</A></LI> + <UL> + <LI><A HREF="#A2">A/2. Maintainerzy</A></LI> + </UL> + <LI><A HREF="#B">B. Listy dyskusyjne</A></LI> + <LI><A HREF="bugreports.html">C. Jak zg³aszaæ b³êdy</A></LI> + <UL> + <LI><A HREF="tech/patches.txt">C/2. Jak wysy³aæ ³aty</A></LI> + </UL> + <LI><A HREF="#D">D. Znane b³êdy</A></LI> + <LI><A HREF="skin-en.html">X. Jak zostaæ s³awnym twórc± skórki w 5 minut!</A></LI> +</UL> +</P> + +<P><HR></P> + +<P><B><A NAME=1>1. Wprowadzenie</A></B></P> + +<P><B><A NAME=1.1>1.1. O programie</A></B></P> + +<P><B>MPlayer</B> jest odgrywark± filmów pod LINUXem (dzia³a pod wieloma innymi +Unixami, i systemami opartymi na innych procesorach ni¿ <B>x86</B>, zobacz <A +HREF="#6">sekcja 6</A>). Wy¶wietla wiêkszo¶æ plików MPEG, VOB, AVI, VIVO, +ASF/WMV, QT/MOV oraz FLI, korzystaj±c z wielu w³asnych, XAnim oraz Win32 DLL +kodeków. Mo¿esz równie¿ ogl±daæ <B>VideoCD</B>, <B>SVCD</B>, <B>DVD</B>, +<B>3ivx</B>, a nawet filmy <B>DivX</B> (i nie potrzebujesz wcale biblioteki +avifile. Kolejn± du¿± zalet± mplayera jest szeroki wachlarz sterowników +wyj¶cia. Mplayer dzia³a z X11, Xv, DGA, OpenGL, SVGAlib, fbdev, AAlib, +DirectFB, ale mo¿esz te¿ korzystaæ z GGI i SDL ( i w ten sposób z wielu +sterowników dostarczanych przez SDL) oraz z niskopoziomowych sterowników +specyficznych dla danej karty (dla Matrox, 3Dfx i Radeon) tak¿e! Wiêkszo¶æ +dostêpnych sterowników wspiera sklaowanie programowe i sprzêtowe, mo¿esz wiêc +cieszyæ siê ogl±daniem filmów w trybie pe³noekranowym. <B>MPlayer</B> wspiera +wy¶wietlanie poprzez pewne sprzêtowe karty dekoduj±ce MPEG , takie jak <B><A +HREF="DVB">DVB</A></B> i <B> <A HREF="DXR3">DXR3/Hollywood+</A></B> ! A co +powiesz na ³adne, du¿e, antyaliasowane podtytu³y z cieniem (<B>wspieranych jest +9 typów!!!</B>) z europejskim ISO 8859-1,2 (wêgierskimi, angielskimi, czeskimi +itd.), cyrylic±, koreañskimi fontami oraz OSD?</P> + +<P><B>MPlayer</B> is basically GPL, but contains some non-GPL code which is not +allowed to be distributed in binary form, and also contains the OpenDivX +library which has special license. We are still developing towards GPL.</P> + +<P>Distributing <B>MPlayer</B> in the form of binaries and/or binary packages +is currently impossible, speaking about both <B>technical</B> and <B>law</B> +areas. Detailed information can be found in the second part of <A HREF="users_against_developers.html">this file</A>, +and it is recommended to read it.</P> + +<P>I didn't write any codecs, just some players. I spent +a lot of time finding the best way to parse bad damaged input files +(both MPEG and AVI) and to do perfect A-V sync with seeking ability. +My player is rock solid playing damaged MPEG files (useful for some VCDs), +and it plays bad AVI files which are unplayable with the famous +windows media player. Even AVI files without index chunk are playable, and +you can rebuild their indexes with the -idx option, thus enabling seeking! +As you see, stability and quality are the most important things for me, +but the speed is also amazing.</P> + +<P><B><A NAME=1.2>1.2. Historia</A></B></P> + +<P>Wszystko zaczê³o siê rok temu... +Próbowa³em wielu odgrywarek pod linuxa (mtv,xmps,dvdview,livid/oms,VideoLAN, +xine,xanim,avifile,xmmp) ale wszystkie mia³y jakie¶ wady. G³ównie z odtwarzaniem +szczególnych plików oraz z synchronizacj± obrazu i d¼wiêku. Wiêkszo¶æ z nich +nie potrafi odgrywaæ plików w obu formatach MPEG1/2 i AVI (DivX). Wiele z nich +mia³o równie¿ problemy z jako¶ci± obrazu oraz prêdko¶ci±. +Postanowi³em wiêc napisaæ nowy lub zmodyfikowaæ jeden z tych programów...</P> + +<P><UL> +<LI><B>mpg12play v0.1-v0.3:</B><BR> + The first try, hacked together in a half hour! + I've used libmpeg3 from www.heroinewarrior.com up to the version 0.3, + but there were image quality and speed problems with it. +<LI><B>mpg12play v0.5-v0.87:</B><BR> + Mpeg codec replaced with DVDview by Dirk Farin, it was a great stuff, + but it was slow and was written in C++ (I hate C++!!!) +<LI><B>mpg12play v0.9-v0.95pre5:</B><BR> + Mpeg codec was libmpeg2 (mpeg2dec) by Aaron Holtzman & Michel Lespinasse. + It's great, optimized very fast C code with perfect image quality and + 100% MPEG standard conformance. +<LI><B>MPlayer v0.3-v0.9:</B><BR> + It was a pack of two programs: mpg12playv0.95pre6 and my new simple AVI + player 'avip' based on avifile's Win32 DLL loader. +<LI><B>MPlayer v0.10:</B><BR> + The MPEG and AVI player in a single binary! +<LI><B>MPlayer v0.11:</B><BR> + Some new developers joined and from 0.11 the mplayer project is a team-work! + Added .ASF file support, and OpenDivX (see www.projectmayo.com) en/decoding. +<LI><B>MPlayer v0.17 "The IdegCounter"</B><BR> + The release version of the 0.11pre after 4 months of heavy development! + Try it, and be amazed! Thousands of new features added... and of course + old code was improved too, bugs removed etc. +<LI><B>MPlayer 0.18 "The BugCounter"</B><BR> + 2 months since 0.17 and here's a new release.. Completed ASF support, + more subtitle formats, introduced libao (similar to libvo but to audio), + even more stable than ever, and so on. It's a MUST ! +<LI><B>MPlayer 0.50 "The Faszom(C)ounter"</B><BR> + Hmm. Release again. Tons of new features, beta GUI version, bugs fixed, + new vo and ao drivers, ported to many systems, including opensource DivX + codecs and much more. Try it! + +</UL></P> + +<P><B><A NAME=1.3>1.3. Instalacja</A></B></P> + +<P>In this chapter I'll try to guide you through the compiling and +configuring process of <B>MPlayer</B>. It's not easy, but it won't neccessarily +be hard. If you experience a different behaviour than what I explain, please +search through this documentation and you'll find your answers. If you +see links, please follow them and read carefully what they contain. It +will take some time, but it DOES worth it.</P> + +<P>You need a fairly recent system. On Linux, 2.4.x kernels are required, but +with 2.4.10 and above you'll ocassionally experience problems (licensing, +kernel bugs, etc) so they are discouraged.</P> + +<P><B><I>WYMAGANIA SPRZÊTOWE</I></B><BR> + +<UL> + <LI><B>binutils</B> - suggested version is <B>2.11.x</B> . This program is + responsible for generating MMX/3DNow!/etc instructions, thus very important.</LI> + <LI><B>gcc</B> - suggested version is from <B>2.95.2</B> to <B>2.95.4</B>. + <B>NEVER</B> use 2.96 or 3.x.x !!! They generate faulty code. If you decide + to change gcc from 2.96, then don't decide in favor of 3.0 juts because + it's newer! In some ways it's even worse than 2.96. So downgrade to + 2.95.x (downgrade libstdc++ too!) or don't up/downgrade at all (but in + this case, be prepared for runtime problems). + Detailed information about gcc 2.96's bugs can be found + <A HREF="users_against_developers.html"><B><I>here</I></B></A> and in the + <A HREF="faq.html">FAQ</A> !</I></B></LI> + <LI><B>XFree86</B> - suggested version is <B>always the newest (4.1.0)</B>. + Normally everyone wants this, as starting from XFree86 4.0.2, it contains + the <A HREF="video.html#2.3.1.2">XVideo</A> extension (somewhere referred + as <B>Xv</B>) which is needed to enable the hardware YUV acceleration (fast + image display) on cards that support it. <A HREF="video.html#2.3.1.2">More + information available.</A><BR> + Make sure its <B>development package</B> is installed too otherwise + it won't work.<BR> + For some videocards you don't need XFree86. See list below.</LI> + <LI><B>make</B> - suggested version is <B>always the newest</B> (at least 3.79.x). This + usually isn't important.</LI> + <LI><B>SDL</B> - it's not mandatory, but can help in some cases. Always + use the newest (beginning from 1.2.x).</LI> +</UL> + +<P><B><I>KODEKI</I></B></P> + +<UL> +<LI><B>libavcodec</B> : If you want to use this DivX3/DivX4/etc codec, check the +<A HREF="codecs.html#2.2.1.2">2.2.1.2</A> section before compiling. Features :<BR> +<UL> + <LI>you can <B>gain <I>DivX/DivX4</I> playing on non-x86 machines</B></LI> + <LI>this codec has the <B>greatest decoding speed</B> for DivX and DivX4 +movies (even faster than the original DivX4 library itself) ! Recommended!</LI> +</UL> +</LI> + +<LI><B>Win32 codecs</B> : If you plan to use <B>MPlayer</B> on x86 +architecture, you will possibly need them. Download and unzip w32codecs.zip to +/usr/lib/win32 . Note: the avifile project has similar codecs package, but it +differs from ours, so if you want to use all supported codecs, then use our +package! However, you can use our codecs package with avifile. Features :<BR> +<UL> + <LI>you need this if you want to play or encode for example movies recorded + with digital cameras (example: DV)</LI> + <LI>needed if you want to play <B>WMV movies</B> or older ASF's</LI> +</UL> +</LI> + +<LI><B>DivX4</B> : information about this codec is available in the +<A HREF="codecs.html#2.2.1.1">2.2.1.1</A> section. If you don't want to use +<B>MEncoder</B>, you possibly don't want this codec as <B>libavcodec</B> (see +above) is much faster than this.<BR> +Features :<UL> + <LI>can play old <B>DivX3</B> movies much faster than the Win32 DLL but + slower than <B>libavcodec</B> !</LI> + <LI>it's closed-source, and only an x86 version is available.</LI> + <LI><I>You also need this codec for <B>MEncoder</B>, see below !</I></LI> +</UL> +</LI> + +<LI>If you want to play <B>3ivx</B> movies, check the <A HREF=codecs.html#2.2.1.3> +XAnim codecs section</A>.</LI> + +<LI>The <A HREF=codecs.html#2.2.1.3>XAnim codecs</A> are the best (full screen, +hardware YUV zoom) for decoding old videos like Indeo 3/4/5, Cinepak, and some +others. And they are multiplatform, so this is the only way to play Indeo on +non-x86 platforms (well, apart from using XAnim:).</LI> + +</UL> + +<P><B><I>KARTY GRAFICZNE</I></B></P> + +<P>There are generally two kind of videocards. One kind (the newer cards) has +<B>hardware YUV acceleration</B> support, the other cards don't.</P> + +<P> +<B><I>KARTY YUV</I></B></P> + +<P> +They can display and scale (zoom) the picture to any size that fits in +their memory, with <B>small CPU usage</B> (zooming doesn't increase it!), thus +you get a nice and very fast fullscreen playing.</P> + +<P> +<UL> +<LI><B>Karty Matrox G200/G400/G450/G550</B> : please see the <A HREF="video.html#2.3.1.7">mga_vid</A> +section in order to gain big speedup. It is important to do these steps +<I>before</I> compiling <B>MPlayer</B>, otherwise no Matrox-specific support will be +built. Also check out the <A HREF="video.html#2.3.1.A.1">Matrox TV-out</A> +section.</LI> + +<LI><B>Karty 3Dfx Voodoo3/Banshee</B> : please see the <A +HREF="video.html#2.3.1.9">2.3.1.9</A> section in order to gain big speedup. It +is important to do these steps <I>before</I> compiling <B>MPlayer</B>, +otherwise no 3Dfx support will be built. Also see the <A HREF="video.html#2.3.1.A.3">3dfx +TV out section</A>.</LI> + +<LI><B>Karty ATI</B> : see the <A HREF="video.html#2.3.1.A.2">ATI cards +section</A> of the TV-out documentation, to know what features of your card is +supported under Linux/MPlayer. If you have a <B>Radeon</B> or <B>Rage128</B> card, we have a +<B>XXX_vid</B> driver for you, with TV out ! Check <A +HREF="video.html#2.3.1.14">this</A> section !</LI> + +<LI><B>Karty S3</B> : the Savage chips have hardware acceleration. Use as +new XFree86 version as possible, older drivers are buggy. Savage chips +have problems with YV12 display, see <A HREF="video.html#2.3.1.2.2">S3 Xv +section</A> for details. Older, non-Savage cards have no, or slow hardware +support.</LI> + +<LI><B>Karty Nvidia</B> : very bad choice for video playing. Nvidia's +cards are manufactured on the far-east, and have very cheap and bad +quality chips. Moreover, <U>the built-in Nvidia driver in XFree86 doesn't +contain support for hardware YUV acceleration!</U> You have to download +Nvidia's closed-source drivers from nvidia.com . See details in <A +HREF="video.html#2.3.1.2.3">Nvidia Xv driver</A> section.</LI> + +<LI><B>Inne karty</B> : none of the above? + <UL> + <LI>Try if the XFree86 driver (and your card) supports hardware + acceleration. See the <A HREF="video.html#2.3.1.2">Xv section</A> for + details.</LI> + <LI>If it doesn't, your card is one of the :</LI> + </UL> +</LI> + +</UL> +</P> + +<P> +<B><I>Karty bez YUV</I></B></P> + +<P> +Fullscreen playing can be achieved by either zooming +(<B>by software</B>, this is slooow), or changing to a smaller videomode, for +example to 352x288. If you don't have YUV accel, this latter method is +the recommended one. Throughout <B>MPlayer</B>, <U>this behaviour can +be switched on by using the <CODE>-vm</CODE> option</U> and with +the following drivers : +<UL> + <LI><B>using</B> XFree86 : see details in + <A HREF="video.html#2.3.1.3">DGA driver</A> and + <A HREF="video.html#2.3.1.13">X11 driver</A> sections. DGA is + recommended!</LI> + <LI><B>not using</B> XFree86 : try the drivers in the following order : + <A HREF="video.html#2.3.1.12">vesa</A>, + <A HREF="video.html#2.3.1.6">fbdev</A>, + <A HREF="video.html#2.3.1.5">svgalib</A>, + <A HREF="video.html#2.3.1.11">aalib</A>.</LI> +</UL> +</P> + +<P><B><I>KARTY D¯WIÊKOWE</I></B></P> + +<UL> + +<LI><B>Soundblaster Live!</B> : with this card you can use 4 or 6 (<B>5.1</B>) +channels AC3 decoding instead of 2. Read the +<A HREF="codecs.html#2.2.2.1">Software AC3 decoding</A> section.</LI> + +<LI><B>other cards'</B> features aren't supported by <B>MPlayer</B>. + <U>It's very recommended to read the <A HREF="sound.html#2.3.2">soundcards + section</A> !</U> +</UL> + +<P><B><I>W£A¦CIWO¦CI</I></B></P> + +<UL> +<LI>For DVD support, you'll have to compile libdvdcss and libdvdread, and +in this order! +See <A HREF="cd-dvd.html#4.2">section 4.2</A> for more information.</LI> + +<LI>Decide if you need GUI. If you do, see the <A HREF=#1.4>1.4 section</A> +before compiling.</LI> + +<LI>If you want to install <B>MEncoder</B> (our great all-purpose encoder), +see the <A HREF="encoding.html#2.4">MEncoder section</A> .</LI> + + +<LI>If you have a V4L compatible <B>TV tuner</B> card, and wish to watch/grab and +encode movies with <B>MPlayer</B>, read the <A HREF=#2.5>TV input</A> section.</LI> + +<LI>There are two timer codes in <B>MPlayer</B>. To use the old +method, you don't have to do anything. It uses <CODE>usleep()</CODE> to tune +A/V sync, with +/- 10ms accuracy. However sometimes the sync has to be tuned +even finer. The new timer code uses PC's RTC (Real Time Clock) for this task, +because it has precise 1ms timers. This requires root, or a <I>setuid root</I> +<B>MPlayer</B> binary (or a little kernel hacking, but that's unadvised). You +can see the new timer's efficiency in the status line. Note: <B>NEVER install +setuid MPlayer binary on a multiuser system!</B> It's a clear way for everyone +to gain root.</LI> + +</UL> + +<P>Then build <B>MPlayer</B>:</P> + +<PRE> ./configure + make + make install</PRE> + +<P><B><I>ALWAYS browse the output of ./configure</I></B>, and the +<CODE>configure.log</CODE> file, they contain info about what will be built, +and what won't. You may also want to view config.h and config.mak files.</P> + +<P>Though not mandatory, the fonts should be installed in order to gain +OSD, and subtitle functionality. Download mp-arial-iso-8859-*.zip and/or optional +(if exists) language updates. It's VERY RECOMMENDED to check +<A HREF=#1.5>section 1.5</A> for details.</P> + +<PRE> mkdir ~/.mplayer/font + cd ~/.mplayer/font + unzip mp-arial-iso-8859-1.zip</PRE> + +<P>Only one thing remains: copy the <B>codecs.conf</B> file from the <CODE>etc</CODE> +directory (relative to the <B>MPlayer</B> tree) to <CODE>$HOME/.mplayer/codecs.conf</CODE> . +You should also check the manpage and <CODE>example.conf</CODE> for available options, and insert them +into your config file, <CODE>$HOME/.mplayer/config</CODE> .</P> + + +<P><B><A NAME=1.4>1.4. A co z GUI?</A></B></P> + +<P>The GUI needs GTK (it isn't GTK, but the panels are). The skins are stored +in PNG format, so gtk, libpng (and their devel stuff) has to be installed. +You can build it by specifying <CODE>--enable-gui</CODE> during ./configure . +Then, to turn on GUI mode, you either +<UL> + <LI>use the <CODE>-gui</CODE> option</LI> + <LI>specify <CODE>gui=yes</CODE> in your config file</LI> + <LI><CODE>ln -s /usr/local/bin/mplayer /usr/local/bin/gmplayer</CODE> , + and call <CODE>gmplayer</CODE> instead. +</UL> +</P> + +<P>Since GTK doesn't run from a <B>setuid root</B> binary, you can't use +the GUI and the <B>new timer code</B> (mentioned above) together (unless +you run <B>MPlayer</B> as root, of course).</P> + +<P>As <B>MPlayer</B> doesn't have a skin included, you have to download them +if you want to use the GUI. See the <A HREF="http://www.mplayerhq.hu/homepage/dload.html">download page</A>. +They should be extracted to the usual system-wide directory (<CODE>/usr/local/share/mplayer/Skin</CODE>), +or to <CODE>$HOME/.mplayer/Skin</CODE> . <B>MPlayer</B> by default looks in +these directories for a <I>default</I> named directory, but you can use the +<I>-skin newskin</I> option, or the <I>skin=newskin</I> config file +directive to use the skin in <CODE>*/Skin/newskin</CODE> directory.</P> + +<P><B><A NAME=1.5>1.5. Napisy i OSD</A></B></P> + +<P>Yes, <B>MPlayer</B> also supports many kinds of subtitles. Currently +8 kinds of subtitle can be used by the subreader code. To see what are +these subtitle formats, see subreader.c, line ~30.</P> + +<P>About DVD subtitles, read the <A HREF="cd-dvd.html#4.2">DVD section</A>.</P> + +<P><B>MPlayer</B> introduces a new subtitle format called <B><I>MPsub</I></B>. +It was designed by me (Gabucino). Basically its main feature is being +<I>dynamically</I> time-based (although it has frame-based mode too). Example (from +<A HREF="http://www.mplayerhq.hu/DOCS/tech/mpsub.sub">DOCS/tech/mpsub.sub</A>) : +</P> + +<P><CODE><I> +# first number : wait this much after previous subtitle disappeared<BR> +# second number : display the current subtitle for this many seconds<BR> +<BR> +15 3<BR> +A long, long time ago...<BR> +<BR> +0 3<BR> +in a galaxy far away...<BR> +<BR> +0 3<BR> +Naboo was under an attack.<BR> +</I></CODE></P> + +<P>So you see, the main goal was to <B>make subtitle editing/timing/joining/cutting easy</B>. And, +if you - say - get an SSA subtitle but it's badly timed/delayed to your +version of the movie, you simply do a <I>mplayer dummy.avi -sub source.ssa +-dumpmpsub</I> . A <CODE>dump.mpsub</CODE> file will be created in the +current directory, which will contain the source subtitle's text, but in +<B>MPsub</B> format. Then you can freely add/substract seconds to/from the +subtitle.</P> + +<P>Subtitles are displayed with a technique called <B>'OSD', On Screen Display</B>. +OSD is used to display current time, volume bar, seek bar etc.</P> + +<P><B>INSTALACJA OSD i SUB</B></P> + +<P>You need an <B>MPlayer</B> font package to be able to use OSD/SUB feature. +There are many ways to get it: +<UL> + +<LI>download ready-to-use font packages from <B>MPlayer</B> 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. +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 <video_name>.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.<BR> +Some URLs: +<UL> + <LI><A HREF="ftp://ftp.mplayerhq.hu/MPlayer/releases/">ftp://ftp.mplayerhq.hu/MPlayer/releases/</A> - ISO fonts + <LI><A HREF="ftp://ftp.mplayerhq.hu/MPlayer/contrib/fonts/">ftp://ftp.mplayerhq.hu/MPlayer/contrib/fonts/</A> - various fonts by users + <LI><A HREF="http://realtime.ssu.ac.kr/~lethean/mplayer">http://realtime.ssu.ac.kr/~lethean/mplayer</A> - korean fonts & RAW plugin +</UL> + +<LI>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) + +<LI>use the font generator GIMP plugin at TOOLS/subfont-GIMP +(note: you must have HSI RAW plugin too, see URL below) +</UL> +</P> + +<P>After that, UNZIP the files to ~/.mplayer/font/ . +Now you have to see a timer at the upper left corner of the movie +(switch it off with 'o') .</P> + +<P>OSD has 3 states: (switch with 'o')<BR> +<UL> + <LI>timer + volume bar + seek bar + subtitles (default) + <LI>volume bar + seek bar + subtitles + <LI>subtitles only +</UL> + +<P>You can change default behaviour by setting <CODE>osdlevel=</CODE> variable in config file.</P> + + +<P><B><A NAME=2>2. W³a¶ciwo¶ci</A></B></P> + + +<P><A NAME=2.1>2.1. <A HREF="formats.html">Supported formats</A></P> + + +<P><A NAME=2.2>2.2. <A HREF="codecs.html">Supported codecs</A></P> + + +<P><A NAME=2.3>2.3. <A HREF="video.html">Video</A> & <A HREF="sound.html">Audio</A> output devices</P> + + +<P><A NAME=2.4>2.4. <A HREF="encoding.html">MEncoder - An All-Purpose Encoder</P> + + +<P><A NAME=2.5><B>2.5. TV input</B></P> + +<P>This section is about how to enable <B>watching/grabbing from V4L compatible +TV tuner</B>.</P> + +<P><B><I>Compilation</I></B></P> + +<P> +<UL> + <LI>first, you have to add the <CODE>--enable-tv</CODE> flag to <CODE>./configure</CODE>, + and recompile.</LI> + <LI>make sure your tuner works with another TV softwares in Linux, for example + xawtv.</LI> +</UL> +</P> + +<P><B>Hint</B>: if <B>MPlayer</B> prints <CODE>ioctl: can't sync</CODE> or something + like this, your tuner can't capture the requested image size. Try using + <CODE>width=640:height=480</CODE> options.</P> + +<P><B>Hint #2</B> : are the colors fucked up? Then your tuner can't display + in YV12 colorspace. Try YUY2, UYVY or if none of these works: RGB32 (this one + with <CODE>-vo sdl</CODE>). + You can specify these with the <CODE>outfmt=YV12</CODE> option see below.</P> + +<P><B><I>Available options</I></B><BR> +<TABLE BORDER=0> +<TR> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><I>on</I></TD> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>use TV + input</TD> +</TR> +<TR> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><I>driver</I></TD> + <TD></TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + <B>dummy</B> - NULL TV input :) Used for testing only, generates dummy + input.<BR> + <B>v4l</B> - captures images from standard V4L interface (default + <CODE>/dev/video0</CODE>)</TD> +</TR> +<TR> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><I>device</I></TD> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>specify other + device than the default <CODE>/dev/video0</CODE></TD> +</TR> +<TR> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><I>input</I></TD> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>give from which + input of the TV tuner you which to grab from (e.g. <B>television</B>, + <B>s-video</B>, <B>composite</B>, ...)<BR> + Prints the available ones during init.</TD> +</TR> +<TR> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><I>freq</I></TD> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>specify the + frequency to set the tuner (e.g. <B>511.250</B>)</TD> +</TR> +<TR> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><I>outfmt</I></TD> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>in which output + format to display images (<B>rgb32</B>, <B>rgb24</B>, <B>yv12</B>, + <B>uyvy</B>)<BR> + The following option must have the same setting !</TD> +</TR> +<TR> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><I>width</I></TD> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + the width of the output window, in pixels</TD> +</TR> +<TR> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><I>height</I></TD> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + the height of the output window, in pixels</TD> +</TR> +<TR> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><I>norm</I></TD> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + available: PAL, SECAM, NTSC</TD> +</TR> +<TR> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><I>channel</I></TD> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + set the tuner to the given channel</TD> +</TR> +<TR> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><I>chanlist</I></TD> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + available: <CODE>us-bcast, us-cable, europe-west, europe-east, etc</CODE></TD> +</TR> +</TABLE> +</P> + +<P><B><I>Keyboard control</I></B></P> + +<TABLE BORDER=0> +<TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>h or l</TD><TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>select previous/next channel</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>n</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>change norm</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>b</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>change channel list</TD><TR> +</TABLE> + +<P><B><I>Examples</I></B></P> + +<P> +Dummy output, to AAlib :)<BR> +<CODE> mplayer -tv on:driver=dummy:width=640:height=480 -vo aa</CODE><BR> +<BR> +Input from standard V4L<BR> +<CODE> mplayer -tv on:driver=v4l:width=800:height=600:device=/dev/video0:input=television:outfmt=yv12 -vo xv</CODE><BR> +</P> + + +<P><B><A NAME=3>3. U¿ytkowanie</A></B></P> + +<P><TABLE BORDER=0> +<TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>file</TD><TD> </TD><TD><CODE><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>mplayer [options] [path/]filename</CODE></TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>VCD</TD><TD></TD><TD><CODE><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>mplayer [options] -vcd trackno /dev/cdrom</CODE></TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>DVD</TD><TD></TD><TD><CODE><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>mplayer [options] -dvd titleno [/dev/dvd]</CODE></TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>net</TD><TD></TD><TD><CODE><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>mplayer [options] http://site.com/file.[mpg|avi]</CODE></TD><TR> +</TABLE></P> + +<P><PRE> mplayer -vo x11 /mnt/Films/Contact/contact2.mpg + mplayer -vcd 2 /dev/cdrom + mplayer -afm 3 /mnt/DVDtrailers/alien4.vob + mplayer -dvd 1 /dev/dvd + mplayer -abs 65536 -delay -0.4 -nobps ~/movies/test.avi</PRE></P> + + +<P><B><A NAME=3.1>3.1. Sterowanie za pomoc± kalwiatury</A></B></P> + +<P><TABLE BORDER=0> +<TR><TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><- or -></TD><TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>seek backward/forward 10 seconds</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>up or down</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>seek backward/forward 1 minute</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>pgup/pgdown</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>seek backward/forward 10 minutes</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>< or ></TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>seek backward/forward in playlist</TD><TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>p or SPACE</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>pause movie (press any key)</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>q or ESC</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>stop playing and quit program</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>+ or -</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>adjust audio delay by +/- 0.1 second</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>/ or *</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>decrease/increase volume</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>o</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>toggle OSD: none / seek / seek+timer</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>m</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>toggle using master/pcm volume</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>z or x</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>adjust subtitle delay by +/- 0.1 second</TD></TR> + +<TR><TD COLSPAN=4><P><I><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>(the following keys are valid only when using DirectShow DivX codec or DivX4 codec with -vc divx4)</I></P></TD></TR> + +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>1 or 2</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>adjust contrast</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>3 or 4</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>adjust brightness</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>5 or 6</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>adjust hue</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>7 or 8</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>adjust saturation</TD></TR> + +<TR><TD COLSPAN=4><P><I><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>(the following keys are valid only with TV input support</I></P></TD></TR> + +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>h or l</TD><TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>select previous/next channel</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>n</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>change norm</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>b</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>change channel list</TD></TR> +</TABLE></P> + +<P><B>Obs³uga GUI z klawiatury</B></P> + +<P><TABLE BORDER=0> +<TR><TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>, and .</TD><TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>previous / next file</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>gray - or +</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>decrease / increase volume</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>enter</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>start playing</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>space</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>pause</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>s</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>stop</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>a</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>about</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>l</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>load file</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>b</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>skin browser</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>e</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>toggle equalizer</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>p</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>toggle playlist</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>f</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>toggle fullscreen</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>m</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>toggle mute</TD> +</TABLE></P> + +<P><B>Sterowanie wej¶ciem TV</B></P> + +<P><TABLE BORDER=0> +<TR><TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>h or l</TD><TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>select previous/next channel</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>n</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>change norm</TD></TR> +<TR><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>b</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>change channel list</TD></TR> + +</TABLE></P> + +<P><B><A NAME=3.2>3.2. Sterowanie za pomoc± LIRC</A></B></P> + +<P>Linux Infrared Remote Control - use an easy to build home-brewn IR-receiver, +an (almost) arbitrary remote control and control your linux box with it! +More about it at <A HREF="http://www.lirc.org">www.lirc.org</A>.</P> + +<P>If you have installed the lirc-package, you can compile <B>MPlayer</B> with LIRC +support using ./configure --enable-lirc</P> + +<P>If everything went fine, <B>MPlayer</B> will print a message like +LIRC init was successful. +on startup. If an error occurs it will tell you. If it doesn't tell you +anything about LIRC there's no support compiled in. That's it :-)</P> + +<P>The application name for <B>MPlayer</B> is - oh wonder - mplayer_lirc. +It understands the following commands:</P> + +<P><TABLE BORDER=0> +<TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>PAUSE</TD><TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>pause playing. Any other keystroke will continue replay.</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>QUIT</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>exit MPlayer</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>RWND</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>10 secs back</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>FRWND</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>60 secs back</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>FWD</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>skip 10 secs</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>FFWD</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>skip 60 secs</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>INCVOL</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>increase volume one percent</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>DECVOL</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>decrease volume one percent</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>MASTER</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>use master mixer channel</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>PCM</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>use pcm mixer channel</TD><TR> +</TABLE></P> + +<P> Don't forget to enable the repeat flag for RWND/FWD in .lircrc. Here's an +excerpt from my .lircrc:</P> + +<P><PRE> begin + remote = CU-SX070 + prog = mplayer_lirc + button = Tape_Play + repeat = 1 + config = FFWD + end + + begin + remote = CU-SX070 + prog = mplayer_lirc + button = Tape_Stop + config = QUIT + end</PRE></P> + +<P>If you don't like the standard location for the lirc-config file (~/.lircrc) +use the -lircconf <filename> switch to specify another file.</P> + +<P><B><A NAME=3.3>3.3. Obs³uga potoków z sieci, b±d¼ jako pipe</A></B></P> + +<P><B>MPlayer</B> can play files from network, using the HTTP protocol. +Configuring it is simple, just recompile <B>MPlayer</B> with</P> + +<P><CODE> ./configure --enable-streaming</CODE></P> + +<P>MPlayer <B>can NOT read ASF</B> files from network by the MMS protocol, only by plain HTTP.</P> + +<P><B>MPlayer</B> can read from stdin (NOT named pipes). This can be for example +used to play from FTP:</P> + +<P><CODE> wget ftp://micorsops.com/something.avi -O - | mplayer -</CODE></P> + +<P><B><A NAME=4>4. <A HREF="faq.html">FAQ section</A></A></B></P> + +<P><B><A NAME=5>5. <A HREF="cd-dvd.html">CD/DVD section</A></A></B></P> + +<P><B><A NAME=6>6. Ró¿ne systemy operacyjne</A></B></P> + +<P><B><A NAME=6.1>6.1. Pakiety Debiana</A></B></P> + +<P>To build the package, get the cvs version, or .tgz and uncompress it, +and cd into programs directory:</P> + +<P><PRE> cd main + fakeroot debian/rules binary</PRE></P> + +<P>(... mplayer detects hardware/software, builds itself and.. ) +dpkg-deb: building package `mplayer' in `../mplayer_0.18-1_i386.deb'.</P> + +<P>And now just become root, and:</P> + +<P><PRE> dpkg -i ../mplayer_0.18-1_i386.deb as root.</PRE></P> + +<P>Here's how it looks like:</P> + +<P><PRE> eyck@incubus:/src/main$ sudo dpkg -i ../mplayer_0.18-1_i386.deb + Password: + (Reading database ... 26946 files and directories currently installed.) + Preparing to replace mplayer 0.17a-1 (using ../mplayer_0.18-1_i386.deb) + Unpacking replacement mplayer ... + Setting up mplayer (0.18-1) ...</PRE></P> + + +<P><B><A NAME=6.2>6.2. FreeBSD</A></B></P> + +<P>To build the package you will need GNU make (gmake, /usr/ports/devel/gmake), +native BSD make will not work.</P> + +<P>To run <B>MPlayer</B> you will need to re-compile the kernel with +"options USER_LDT" (unless you are running -CURRENT, where this is default). +If you have a CPU with SSE also use "options CPU_ENABLE_SSE" to use it +(FreeBSD-STABLE required, or use kernel patches).</P> + +<P>If <B>MPlayer</B> complains about "CD-ROM Device '/dev/cdrom' not found!" make a +symbolic link: <CODE>ln -s /dev/(your_cdrom_device) /dev/cdrom</CODE></P> + +<P>There's no DVD support for FreeBSD yet.</P> + +<P><B><A NAME=6.3>6.3. Solaris</A></B></P> + +<P>MPlayer should work on Solaris 2.6 or newer.</P> + +<P>AVI file playback works best on Solaris x86, because you have the +option to use the win32 codecs on the x86 platform, or can use MMX/MMX2/3DNow/etc +instructions for MP3/DivX/DVD/whatever. On Solaris SPARC, +you'll find quite a few AVI files with non working video and/or +audio playback, because the video/audio codecs using the Win32 DLLs +are not available. However, <B>DivX/OpenDivX</B> movies should work, +when using libavcodec.</P> + +<P>On <B>UltraSPARC</B>s, <B>MPlayer</B> takes advantage of their <B>VIS</B> +extensions (equivalent to MMX), currently only in <I>libmpeg2</I>, +<I>libvo</I> and <I>libavcodec</I>, but not in mp3lib. You can watch a VOB file +on a 400Mhz CPU. You'll need <A +HREF="http://www.sun.com/sparc/vis/mediaLib.html">mLib</A> installed.</P> + +<P>To build the package you will need GNU make (gmake, /opt/sfw/gmake), native +Solaris make will not work. Typical error you get when building with solaris' +make instead of GNU make:</P> + +<P><PRE> % /usr/ccs/bin/make + make: Fatal error in reader: Makefile, line 25: Unexpected end of line seen</P></PRE> + +<P>On Solaris SPARC, you need the GNU C/C++ Compiler; it does not matter +if GNU C/C++ compiler is configured with or without the GNU assembler.</P> + +<P>On Solaris x86, you need the GNU assembler and the GNU C/C++ +compiler, configured to use the GNU assembler! The mplayer code on +the x86 platform makes heavy use of MMX, SSE and 3DNOW! +instructions that cannot be compiled using Sun's assembler +<CODE>/usr/ccs/bin/as</CODE>.</P> + +<P>The configure script tries to find out, which assembler program is +used by your "gcc" command (in case the autodetection fails, use +the "--as=/whereever/you/have/installed/gnu-as" option to tell the +configure script where it can find GNU "as" on your system).</P> + +<P>Error message from configure on a Solaris x86 system using GCC +without GNU assembler:</P> + +<P><PRE> % configure + ... + Checking assembler (/usr/ccs/bin/as) ... , failed + Please upgrade(downgrade) binutils to 2.10.1...</PRE></P> + +<P>(Solution: Install and use a gcc configured with "--with-as=gas")</P> + +<P>Typical error you get when building with a GNU C compiler that does +not use GNU as:</P> + +<P><PRE> % gmake + ... + gcc -c -Iloader -Ilibvo -O4 -march=i686 -mcpu=i686 -pipe -ffast-math + -fomit-frame-pointer -I/usr/local/include -o mplayer.o mplayer.c + Assembler: mplayer.c + "(stdin)", line 3567 : Illegal mnemonic + "(stdin)", line 3567 : Syntax error + ... more "Illegal mnemonic" and "Syntax error" errors ...</PRE></P> + +<P>For DVD support you must have the patched libcss installed. Patch: +<A HREF="http://www.tools.de/solaris/mplayer/">http://www.tools.de/solaris/mplayer/</A>.</P> + +<P>Due to two bugs in solaris 8 x86, you cannot reliably play DVDs using a +capacity >4GB:</P> + +<P><UL><LI>The sd(7D) driver on solaris 8 x86 driver has bug when accessing a +disk block >4GB on a device using a logical blocksize != DEV_BSIZE +(i.e. CDROM and DVD media). Due to a 32bit int overflow, a disk +address modulo 4GB is accessed. +(<A HREF="http://groups.yahoo.com/group/solarisonintel/message/22516">http://groups.yahoo.com/group/solarisonintel/message/22516</A>) + +<LI>The similar bug is present in the hsfs(7FS) filesystem code (aka +ISO9660), hsfs currently does not support partitions/disks >4GB, +all data is accessed modulo 4GB +(<A HREF="http://groups.yahoo.com/group/solarisonintel/message/22592">http://groups.yahoo.com/group/solarisonintel/message/22592</A>) +</UL></P> + +<P>On Solaris with an UltraSPARC CPU, you can get some extra speed by + using the CPU's VIS instructions for certain time consuming operations. + VIS acceleration can be used in MPlayer by calling functions in Sun's + <A HREF="http://www.sun.com/sparc/vis/mediaLib.html">mediaLib</A>.</P> + +<P>VIS accelerated operations from mediaLib are used for mpeg2 video + decoding and for color space conversion in the video output drivers.</P> + + +<P><B><A NAME=6.4>6.4. StrongARM</A></B></P> + +<P><B>MPlayer</B> is reported to compile on StrongARM. Use the following command line:</P> + +<P><PRE> ./configure --target=arm-linux --disable-css --with-x11libdir=/usr/arm/lib + --with-x11incdir=/usr/arm/lib --disable-gcc-checking</PRE></P> + + +<P><B><A NAME=6.5>6.5. Silicon Graphics Indigo / IRIX</A></B></P> + +<P>Reported working. You'll probably have to use the <I>sgi</I> ao driver. +Anyone has closer info?</P> + + +<P><B><A NAME=6.6>6.6. QNX</A></B></P> + +<P>Works. Only has <CODE>-vo x11</CODE> output which is even much slower +than on Linux, since QNX has only X <I>emulation</I> which is VERY slow. +No closer info yet.</P> + + +<P><B><A NAME=A>Appendix A - Authors</A></B></P> + +<P>NOTE: Do *NOT* send bugreports, help & feature requests directly to the authors!</P> + +<P>Read Appendix <A HREF="#C">C</A> and subscribe to mplayer-users mailing lists.</P> + +<P ALIGN=center><B><U>The <B>MPlayer</B> project:</U></B></P> + +<P><UL> + +<LI><B><A HREF="mailto:arpi@thot.banki.hu">Árpád Gereöffy (A'rpi/ESP-team)</A></B> +<UL> + <LI>player code (mpeg stream demultiplexer and avi/asf parser, A-V sync, seek...)</LI> + <LI>mp3lib, based on mpglib sources [MP3 audio decoder]</LI> + <LI>getch2 [keyboard handler]</LI> + <LI>some changes in libmpeg2 code (progressive frames, bitrate & fps support)</LI> + <LI>libvo improvements: adding OpenGL support, bugfix in mga driver...</LI> + <LI>triple buffering & YUY2 support (for DivX/MPEG4) into mga_vid driver</LI> + <LI>scripts in the TVout directory (TVout on Matrox G400DH, read documentation)</LI> + <LI>hacking DivX/Mpeg4 VfW codecs to get YUV output</LI> + <LI>opendivx decoder speed optimizations (see opendivx/ChangeLog)</LI> + <LI>OSD & SUB display code</LI> + <LI>ffmpeg/libavcodec integration</LI> + <LI>DivX4Linux (ProjectMayo) support (see documentation)</LI> + <LI>New DVD-Support using libdvdread</LI> + <LI>DVB support</LI> + <LI>MPEG PES output</LI> + <LI>anything that isn't mentioned elsewhere</LI> +</UL></LI> + +<LI><B><A HREF="mailto:pontscho@makacs.poliod.hu">Zoltán Ponekker (Pontscho/Fresh!)</A></B> +<UL> + <LI>configure script and Makefiles for easy compile</LI> + <LI>GUI system</LI> + <LI>3DNow! support into mp3lib</LI> + <LI>3DNow! support into fastmemcpy.h</LI> + <LI>various X11 driver changes (keyboard handling, fullscreen, bpp detect, etc)</LI> + <LI>libvo: adding xmga driver, and fullscreen support to xv</LI> + <LI>audio mixer (volume) support</LI> +</UL></LI> + +<LI><B><A HREF="mailto:lgb@lgb.hu">Gábor Lénárt (LGB)</A></B> +<UL> + <LI>./configure script improvements</LI> + <LI>Makefile improvements</LI> + <LI>prelimenary DVD support</LI> + <LI>various X11 cleanups and fixes</LI> + <LI>HTMLization of documentation</LI> +</UL></LI> + +<LI><B><A HREF="mailto:gabucino@mplayerhq.hu">Gábor Bérczi (Gabucino)</A></B> +<UL> + <LI>documentation writer & maintainer</LI> + <LI>hungarian translation of documentation, homepage, and help output</LI> + <LI>second homepage design&gfx</LI> + <LI>homepage maintainer</LI> + <LI>testing, codecs quality & speed comparsions</LI> + <LI>IRC channels operator (#MPlayer is user channel)</LI> + <LI>experimental MINIX port :) (what's funny about it?)</LI> + <LI>MPsub subtitle format design</LI> +</UL></LI> + +<LI><B><A HREF="mailto:szabi@inf.elte.hu">Szabolcs Berecz (Szabi)</A></B> +<UL> + <LI>codecs.conf file parser</LI> + <LI>config file and command line parser</LI> + <LI>mga_vid fixes, module option etc.</LI> + <LI>fbdev support in libvo</LI> + <LI>type #7 subtitle support</LI> +</UL></LI> + +<LI><B><A HREF="mailto:lez@sch.bme.hu">László Megyer (Lez, Laaz)</A></B> +<UL> + <LI>SUB reader</LI> + <LI>screensaver+DPMS disable for libvo</LI> +</UL></LI> + +<LI><B><A HREF="mailto:chass-@freemail.hu">Gyula László (Chass, Tégla)</A></B> +<UL> + <LI>first fonts (mp_font1.zip)</LI> + <LI>third (current) homepage design&gfx</LI> +</UL></LI> + +<LI><B><A HREF="mailto:se7en@sch.bme.hu">Zoltán Márk Vicián (Se7en)</A></B> +<UL> + <LI>SVGAlib support in libvo</LI> +</UL></LI> + +<LI><B><A HREF="mailto:alex@naxine.org">Alex Beregszaszi (Al3x)</A></B> +<UL> + <LI>ALSA output driver in libao2</LI> + <LI>vo_ggi output driver in libvo (www.ggi-project.org)</LI> + <LI>xanim codecs support (incomplete yet!)</LI> + <LI>VIVO files support</LI> + <LI>TV grabbing support</LI> +</UL></LI> + +<LI><B><A HREF="mailto:asackerm@stud.informatik.uni-erlangen.de">Andreas Ackermann (Acki)</A></B> +<UL> + <LI>LIRC support (see documentation)</LI> + <LI>DGA support in libvo</LI> +</UL></LI> + +<LI><B><A HREF="mailto:atmosfear@users.sourceforge.net">Felix Bünemann (Atmos)</A></B> +<UL> + <LI>SDL driver maintainer</LI> + <LI>Additional YUV formats fixes</LI> + <LI>New font (mp_font2.zip)</LI> + <LI>PNG file output support in libvo</LI> + <LI>flipping support (for Indeo 3/4, etc)</LI> + <LI>SDL audio driver in libao2</LI> + <LI>RAW PCM/WAVE file writer for libao2</LI> + <LI>OggVorbis audio support</LI> + <LI>Various aspect code</LI> + <LI>Win32 port</LI> +</UL></LI> + +<LI><B><A HREF="mailto:telenieko@telenieko.com">TeLeNiEkO</A></B> +<UL> + <LI>spanish translation of documentation</LI> +</UL></LI> + +<LI><B><A HREF="mailto:mgraffam@idsi.net">Michael Graffam</A></B> +<UL> + <LI>XF86VidMode support to vo_x11 and vo_dga</LI> + <LI>Video mode switching code to vo_dga</LI> +</UL></LI> + +<LI><B><A HREF="mailto:hoffmajs@gmx.de">Jens Hoffmann</A></B> +<UL> + <LI>Additional YUV formats support</LI> + <LI>found the big BITMAPINFOHEADER problem -> solved ASV2 pixelization</LI> +</UL></LI> + +<LI><B><A HREF="mailto:nickols_k@mail.ru">Nick Kurshev</A></B> +<UL> + <LI>memcpy optimizations for AMD K7 and Intel Pentium III (fastmemcpy.h)</LI> + <LI>CDROM tune info</LI> + <LI>further 3DNow! optimizations into mp3lib and libac3 and ffmpeg</LI> + <LI>russian translation of documentation</LI> + <LI>radeonfb</LI> + <LI>libvo driver: vo_vesa</LI> +</UL></LI> + +<LI><B><A HREF="mailto:german@piraos.com">German Gomez Garcia</A></B> +<UL> + <LI>SPDIF AC3 output for SBLive!</LI> +</UL></LI> + +<LI><B><A HREF="mailto:eyck@incubus.ar.lublin.pl">Dariush Pietrzak (Eyck)</A></B> +<UL> + <LI>debian packaging support (see debian/* and this documentation)</LI> + <LI>support for vplayer subtitle format</LI> + <LI>prelimenary support for .RT subtitle format</LI> +</UL></LI> + +<LI><B><A HREF="mailto:marcus@idonex.se">Marcus Comstedt</A></B> +<UL> + <LI>initial solaris8-x86 support</LI> +</UL></LI> + +<LI><B><A HREF="mailto:jk@tools.de">Jürgen Keil and Marcus Comstedt</A></B> +<UL> + <LI>patched <B>MPlayer</B> to work on Solaris 8 x86</LI> + <LI>configure fixes</LI> + <LI>various fixes (win32, configure, etc)</LI> + <LI>SUN audio driver in libao2</LI> + <LI>mediaLib support in libavcodec</LI> +</UL></LI> + +<LI><B><A HREF="mailto:vkushnir@Alfacom.net">Vladimir Kushnir</A></B> +<UL> + <LI>patched <B>MPlayer</B> to work on FreeBSD x86</LI> +</UL></LI> + +<LI><B><A HREF="mailto:bertrand_baudet@yahoo.com">Bertrand BAUDET</A></B> +<UL> + <LI>network streaming support</LI> +</UL></LI> + +<LI><B><A HREF="mailto:zybi@fanthom.irc.pl">Artur Zaprzala</A></B> +<UL> + <LI>Complete font generator prog + OSD font (TOOLS/subfont-c)</LI> +</UL></LI> + +<LI><B><A HREF="mailto:lanzz@lanzz.org">lanzz@lanzz.org</A></B> +<UL> + <LI>GIMP font generator plugin (TOOLS/subfont-gimp)</LI> +</UL></LI> + +<LI><B><A HREF="mailto:atlka@pg.gda.pl">Adam Tla/lka</A></B> +<UL> + <LI>osd/sub review, fixes, optimization, utf8 support</LI> + <LI>various fixes</LI> +</UL></LI> + +<LI><B><A HREF="mailto:folke@ashberg.de">Folke Ashberg</A></B> +<UL> + <LI>native AAlib driver (-vo aa)</LI> +</UL></LI> + +<LI><B><A HREF="mailto:ktoman@email.cz">Kamil Toman</A></B> +<UL> + <LI>czech fonts</LI> +</UL></LI> + +<LI><B><A HREF="mailto:iive@yahoo.com">Ivan Kalvatchev</A></B> +<UL> + <LI>interlaced MPEG2 support</LI> +</UL></LI> + +<LI><B><A HREF="mailto:p_l@gmx.fr">pl</A></B> +<UL> + <LI>./configure fixes</LI> +</UL></LI> + +<LI><B><A HREF="mailto:michaelni@gmx.at">Michael Niedermayer</A></B> +<UL> + <LI>postprocessing support</LI> + <LI>software scaling C/MMX/MMX2/3DNow support (swscale.c)</LI> +</UL></LI> + +<LI><B><A HREF="mailto:sgoethel@jausoft.com">Sven Goethel</A></B> +<UL> + <LI>libvo driver: vo_gl2</LI> +</UL></LI> + +<LI><B><A HREF="mailto:joy@pingfm.org">joy_ping</A></B> +<UL> + <LI>ao_alsa9 fixes</LI> +</UL></LI> + +<LI><B><A HREF="mailto:eanholt@gladstone.uoregon.edu">Eric Anholt</A></B> +<UL> + <LI>runtime CPU detection</LI> +</UL></LI> + +<LI><B><A HREF="mailto:Jiri.Svoboda@seznam.cz">Jiri Svoboda</A></B> +<UL> + <LI>AQT type subtitles support</LI> + <LI>CRTC2 YUV support in mga_vid</LI> + <LI>DirectFB video output driver</LI> +</UL></LI> + +<LI><B><A HREF="mailto:oliver.schoenbrunner@jku.at">Oliver Schoenbrunner</A></B> +<UL> + <LI>SGI audio driver</LI> + <LI>MIPS support</LI> +</UL></LI> + +<LI><B><A HREF="mailto:jeroen.dobbelaere@acunia.com">Jeroen Dobbelaere</A></B> +<UL> + <LI><A HREF="http://mad.sourceforge.net">libmad</A> support</LI> +</UL></LI> + +<LI><B><A HREF="mailto:dholm@telia.com">David Holm</A></B> +<UL> + <LI>DXR3 support</LI> +</UL></LI> + +<LI><B><A HREF="mailto:takis@lumumba.luc.ac.be">Panagiotis Issaris</A></B> +<UL> + <LI>-playlist option</LI> +</UL></LI> + +<LI><B><A HREF="mailto:melanson@pcisys.net">Mike Melanson</A></B> +<UL> + <LI>MS Video1 codec open-source implementation</LI> + <LI>FLI demuxer, decoder</LI> +</UL></LI> + +<LI><B><A HREF="mailto:ranma@gmx.at">Tobias Diedrich</A></B> +<UL> + <LI>NAS audio output driver</LI> +</UL></LI> + +<LI><B><A HREF="mailto:foth@informatik.uni-hamburg.de">Kilian A. Foth</A></B> +<UL> + <LI>-slave mode</LI> +</UL></LI> + +</UL></P> + +<P>Main testers:</P> + +<P><UL> +<LI>Tibor Balázs (Tibcu) +<LI>Péter Sasi (SaPe) +<LI>Christoph H. Lampert +<LI>Attila Kinali +<LI>Dirk Vornheder +<LI>Bohdan Horst (Nexus) +</UL></P> + +<P ALIGN=center><B><U>The codecs, libs:</U></B></P> + +<P><UL> +<LI>Aaron Holtzman: <aholtzma@engr.uvic.ca> +<UL><LI>ac3dec (and libac3) author [AC3 audio decoder] +</LI><LI>mga_vid driver [Matrox G200/G400 YUV Back-end Scaler] +</LI><LI>mpeg2dec [Fast MPEG1/MPEG2 video decoder, currently used in player] +</LI></UL> + +</LI><LI>Michel Lespinasse: <walken@zoy.org> +<UL><LI>did large libmpeg2 changes for better speed and mpeg conformance +</LI></UL> + +</LI><LI>Eugene Kuznetsov: <divx@euro.ru> +<UL><LI>avifile author [AVI player library for linux, using Win32 VfW/ACM codecs] +</LI><LI>technical help about AVI and ASF formats, and how to get YUV using VfW... +</LI><LI>divx4linux techical support +</LI></UL> + +</LI><LI>Zdenek Kabelac: <kabi@informatics.muni.cz> +<UL><LI>current avifile maintainer(?) +</LI><LI>some technical help about the win32 stuff and timers +</LI></UL> + +</LI><LI>Gerard Lantau: <glantau@yahoo.fr> +<UL><LI>ffmpeg/libavcodec author,maintainer (opensource mpeg, mjpeg, divx en/decoder) +</LI></UL> + +</LI><LI>Project Mayo: <<A HREF="http://www.projectmayo.com">http://www.projectmayo.com</A>> +<UL><LI>the OpenDivX codec authors +</LI></UL> + +</LI><LI>Michael Hipp: +<UL><LI>mpglib author [isn't used directly but some parts in mp3lib] +</LI></UL> + +</LI><LI>Mark Podlipec: +<UL><LI>xa_gsm.c author [MS-GSM audio codec] + [from a GSM library by Jutta Degener and Carsten Bormann] +</LI></UL> + +</LI></UL></P> + +<P>Their code is not used in current player version, but I've got some ideas or +other technical help from:</P> + +<P><UL> +<LI>John F. McGowan http://www.jmcgowan.com/ +<UL><LI>AVI FAQ author/collector. [site with many useful docs on codecs and avi fmt] +</LI></UL> + +</LI><LI>Dirk Farin: <farin@ti.uni-mannheim.de> +<UL><LI>dvdview author [MPEG1/MPEG2 video decoder, used in v0.5-v0.8] +</LI></UL> + +</LI><LI>Adam Williams: <broadcast@earthling.net> +<UL><LI>libmpeg3 (and xmovie) author [MPEG1/MPEG2 video decoder, used in v0.1-v0.4] +</LI></UL> + +</UL></P> + +<P><B><A NAME=A2>Appendix A/2 - maintainerzy kodu i dokumentacji MPlayera</A></B></P> + +<P>Homepage +<UL> + <LI><B>Design</B>: Chass + <LI><B>Zawarto¶æ</B>: Gabucino +</UL></P> +<P>English documentation +<UL> + <LI><B>tech-hun.txt</B>: A'rpi + <LI><B>wszystkie pozosta³e</B>: Gabucino + <LI><B>HTMLization</B>: LGB +</UL></P> +<P>T³umaczenia dokumentacji +<UL> + <LI><B>wêgierskie</B>: Gabucino + <LI><B>niemieckie</B>: <A HREF="mailto:johannes.feigl@mcse.at">Johannes Feigl</A> + <LI><B>francuskie</B>: <A HREF="mailto:smarteau@eso.org">Stephane Marteau</A> (outdated) + <LI><B>w³oskie</B>: TeLeNiEkO (nieuaktualnione) + <LI><B>rosyjskie</B>: Nick Kurshev (nieuaktualnione) + <LI><B>polskie</B>: Dariush Pietrzak oraz Justyna Biala (nieuaktualnione) +</UL></P> +<P>Platformy sprzêtowe/porty +<UL> + <LI><B>pakiety DEBIANa</B>: Dariush Pietrzak + <LI><B>wsparcie dla FreeBSD</B>: Vladimir Kushnir + <LI><B>wsparcie dla Solaris 8</B>: Jürgen Keil + <LI><B>wsparcie dla MIPS</B>: Oliver Schoenbrunner +</UL></P> +<P>Kod MPlayera: +<UL> + <LI><B>wykrywanie formatów plików, demuxers</B>: A'rpi + <LI><B>obs³uga DVD</B>: (werjsa alfa by³a: LGB) teraz: A'rpi + <LI><B>potoki sieciowe</B>: Bertrand BAUDET + <LI><B>Synchronizacja A-V</B>: A'rpi + <LI><B>parser/czytnik plików z napisami</B>: Lez (most of them) + <LI><B>pliki konfiguracyjne & i parser linii poleceñ</B>: Szabi + <LI><B>fastmemcpy</B>: Nick Kurshev + <LI><B>obs³uga LIRC</B>: Acki + <LI><B>renderer SUB/OSD</B>: Adam Tla/lka +</UL></P> +<P>sterowniki libvo: +<UL> + <LI><B>vo_3dfx.c</B> - PRZESTARZA£E, u¿yj w zamian xv lub tdfxfb + <LI><B>vo_tdfxfb.c</B> - <A HREF="mailto:zsteva@ptt.yu">Zeljko Stevanovic</A> + <LI><B>vo_aa.c</B> - Folke Ashberg + <LI><B>vo_dga.c</B> - Acki + <LI><B>vo_fbdev.c</B> - Szabi + <LI><B>vo_fsdga.c</B> - PRZESTARZA£E, u¿yj w zamian dga + <LI><B>vo_ggi.c</B> - al3x + <LI><B>vo_gl.c</B> - A'rpi + <LI><B>vo_gl2.c</B> - <A HREF="mailto:sgoethel@jausoft.com">Sven Goethel</A> + <LI><B>vo_md5.c</B> - A'rpi + <LI><B>vo_mga.c</B> - A'rpi + <LI><B>vo_mpegpes.c</B> - A'rpi + <LI><B>vo_null.c</B> - A'rpi + <LI><B>vo_odivx.c</B> - A'rpi + <LI><B>vo_pgm.c</B> - A'rpi + <LI><B>vo_png.c</B> - Atmos + <LI><B>vo_sdl.c</B> - Atmos + <LI><B>vo_svga.c</B> - se7en + <LI><B>vo_syncfb.c</B> - PRZESTARZA£E, u¿yj w zamian mga + <LI><B>vo_vesa.c</B> - Nick Kurshev + <LI><B>vo_x11.c</B> - Pontscho + <LI><B>vo_xmga.c</B> - Pontscho + <LI><B>vo_xv.c</B> - Pontscho +</UL></P> +<P>sterowniki libao2: +<UL> + <LI><B>ao_alsa5.c</B> - al3x + <LI><B>ao_alsa9.c</B> - al3x (poprawione przez <A HREF="mailto:joy@pingfm.org">joy_ping</A>) + <LI><B>ao_dxr3.c</B> - <A HREF="mailto:dholm@telia.com">David Holm</A> + <LI><B>ao_null.c</B> - A'rpi + <LI><B>ao_oss.c</B> - A'rpi + <LI><B>ao_pcm.c</B> - Atmos + <LI><B>ao_sdl.c</B> - Atmos + <LI><B>ao_sgi.c</B> - <A HREF="oliver.schoenbrunner@jku.at">Oliver Schoenbrunner</A> + <LI><B>ao_sun.c</B> - Jürgen Keil +</UL></P> +<P>NARZÊDZIA: +<UL> + <LI><B>subfont-c</B> - Artur Zaprzala: <zybi@fanthom.irc.pl></B> + <LI><B>subfont-GIMP</B> - lanzz@lanzz.org</B> + <LI><B>*.pl</B> - Atmos</B> + <LI><B>x2mpsub</B> - Gabucino</B> + <LI><B>others</B> - A'rpi</B> +</UL></P> + +<P>Pozosta³e: +<UL> + <LI><B>vbelib.*</B> - Nick Kurshev</B> + <LI><B>lrmi.*</B> - skopiowany przez Nick Kurshev (oryginalnie przez Josh Vanderhoof)</B> +</UL></P> + + +<P><B><A NAME=B>Appendix B - Listy dyskusyjne</A></B></P> + +<P>There are some public mailing lists on <B>MPlayer</B>. Subscribing can be +achieved on the following addresses:</P> + +<P><UL> +<LI>Lista developerów MPlayera:<BR> +<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng">http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng</A> +<P>This list is about mplayer development! Talking about interface/API changes, +new libraryes, code optimization, ./configure changes, and send patches here. +Do NOT send bugreports, user questions, feature requests here! +This list should be kept low-traffic.</P> + +</LI><LI>Lista uzytkowników MPlayera:<BR> +<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-users">http://mplayerhq.hu/mailman/listinfo/mplayer-users</A> +<P><UL> +<LI>send bugreports here (after reading DOCS/BUGS, Appendix <A HREF="#C">C</A>)</LI> +<LI>send feature requests here (after reading bugreports.html)</LI> +<LI>send user questions here (after reading all this documentation)</LI> +</UL></P> + +</LI><LI>Lista u¿ytkowników MPlayera posiadaj±cych Matrox G200/G400/G450/G550:<BR> +<A HREF="http://lists.sourceforge.net/lists/listinfo/mplayer-matrox">http://lists.sourceforge.net/lists/listinfo/mplayer-matrox</A> +<P>Send matrox-related questions here<UL> +<LI>things about mga_vid</LI> +<LI>matrox's official beta drivers (for X 4.x.x)</LI> +<LI>and about matroxfb-TVout stuff.</LI></UL></P> + +</LI><LI>Lista uzytkowników MPlayera posiadaj±cych karty DVB:<BR> +<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-dvb">http://mplayerhq.hu/mailman/listinfo/mplayer-dvb</A> +<P>Things related to the hardware decoder card called DVB.<UL> +</P> + +</LI><LI>MPlayer CVS-log: <BR> +<A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-cvslog">http://mplayerhq.hu/mailman/listinfo/mplayer-cvslog</A> +<P>Send only questions about CVS changes here. +(if you don't understand why a change is required or you've better fix) +Be sure in that your target developer reads this list!</P> + +</LI></UL></P> + +<P>NOTE: language of above lists are ENGLISH, unless explicitly stated +otherwise. Please do not send messages using other language!</P> + +<P>NOTE: you can reach the searchable mailing list archives +<A HREF="http://www.mplayerhq.hu/cgi-bin/htsearch">here</A>. + + +<P><B><A NAME=C><A HREF="bugreports.html">Appendix C</A> - How to report bugs</A></B></P> + +<P><B><A NAME=D>Appendix D - Znane b³êdy</A></B></P> + +<P>Special system/cpu-specific bugs/problems:</P> +<UL> +<LI> SIGILL (signal 4) in draw_frame, on P3 (mostly with 2.2.x kernels):<BR> + Problem: movups is crashing in libvo/fastmemcpy.h<BR> + Workaround: ./configure --disable-fastmemcpy<BR> + SOLVED: disabled SSE code in fastmemcpy.h ;(</LI> + +<LI>No image (black image) in RGB 15/16bpp (x11,dga,fbdev,svga) playing + MPEG or OpenDivX files:<BR> + Problem: gcc 2.96 bug, read <A HREF="gcc-2.96-3.0.html">this</A><BR> + Workaround: ./configure --disable-mmx, or use gcc 2.95.x<BR> + SOLVED: code fixed</LI> + +<LI>SIGILL (signal 4) or other fault at loading l3codeca.acm:<BR> + Problem: shared libs are loaded to 0x00xxxxxx instead of 0x40xxxxxx<BR> + Workaround: mplayer -afm 1 ...<BR> + SOLVED: you are using some security kernel patch, like OpenWall etc.</LI> + +<LI>SIGILL (signal 4) on P3 using 2.2.x kernels:<BR> + Problem: kernel 2.2.x doesn't have proper (working) SSE support<BR> + Solution: upgrade kernel to 2.4.x<BR> + Workaround: ./configure --disable-sse</LI> + +<LI>General SIGILL (signal 4):<BR> + Problem: you compiled and run mplayer in different machines + (for example compiled on P3 and running on celeron)<BR> + Solution: compile MPlayer on the same machine where you will use it!<BR> + Workaround: ./configure --disable-sse etc. options</LI> +</UL> + +<P>Various A-V sync and other audio problems:</P> + +General audio delay or jerky sound (exists with all or many files):<BR> +<UL> +<LI>audio buffer problems (buffer size badly detected)<BR> + Workaround: mplayer -abs option</LI> +<LI>slow machine (cpu or vga)<BR> + try with -vo null, if it plays well, then you have slow VGA card/driver<BR> + Workaround: buy a faster card or read this documentation about how to speed up<BR> + SOLVED: try -framedrop</LI> +</UL><BR> + +Audio delay/de-sync specific to one or a few files:<BR> +<UL> +<LI>bad file (please upload the file, so we can check & fix)<BR> + Workaround: + <UL> + <LI>-ni or -nobps option (for non-interleaved or bad files)</LI> +and/or + <LI>-mc 0 (required for files with badly interleaved VBR audio)</LI> +and/or + <LI>-delay option or +/- keys at runtime to adjust delay</LI> + </UL> +<LI>your soundcard doesn't support 48Khz playback<BR> + Workaround: buy a better soundcard... or try to decrease fps by 10% (use -fps 27 for a 30fps movie)</LI> +<LI>slow machine<BR> + (if A-V is not around 0, and the last number in the status line increasing)<BR> + Workaround: -framedrop</LI> +</UL><BR> + +No sound at all:<BR> +<UL> +<LI>your file uses an unsupported codec<BR> + Workaround: read the documentation and help us adding support for it</LI> +</UL> + +<P>Video-out problems:</P> + +<P>First note: options -fs -vm and -zoom are just recommendations, not (yet) +supported by all drivers. So it isn't a bug if it doesn't work. +Only a few driver supports scaling/zooming, don't expect this from x11 or dga.</P> + +<P>OSD/sub flickering:<BR> +- x11 driver: sorry, it can't be fixed now<BR> +- xv driver: use -double option</P> + +</BODY> +</HTML> diff --git a/DOCS/Polish/encoding.html b/DOCS/Polish/encoding.html new file mode 100644 index 0000000000..10317adee9 --- /dev/null +++ b/DOCS/Polish/encoding.html @@ -0,0 +1,255 @@ +<HTML> +<BODY BGCOLOR=white> + +<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + +<P><B><A NAME=2.4>2.4. Encoding with MEncoder</A></B></P> + +<A NAME=2.4.1><P><B><I>Overview</I></B> +<P><B>MEncoder</B> (<B>MPlayer</B>'s Movie Encoder) is a simple movie encoder, +designed to encode MPlayer-playable movies +(<B>AVI/DVD/VCD/VOB/MPG/MOV/VIV/NET</B>) to other MPlayer-playable formats (see +below). Currently it's in beta stage, and encodes only to <B>DivX4</B> (1 or 2 +passes) video, <B>PCM</B>/<B>MP3</B>/<B>VBRMP3</B> audio. Also has stream +copying abilities. In the future, there will be cropping, resizing filters, and +other interesting stuff.</P> + +<A NAME=2.4.2><P><B><I>Compiling</I></B> + <UL> + <LI>read <B>MPlayer</B>'s compilation instructions, it contains info about + how to install <I>libdvdread</I> for <B>DVD</B> support, etc.</LI> + <LI>download the newest <B>DivX4linux</B> libs + from <A HREF="http://avifile.sourceforge.net/download.htm">avifile.sourceforge.net</A>, + and have them PROPERLY installed. This is needed for DivX4 (1/2 pass) + encoding. And since this is mandatory (now), MEncoder is Linux-only.</LI> + <LI>download and compile <B>libmp3lame</B> (from lame 3.89beta or lame CVS).<BR> + <B>WARNING : DO NOT COMPILE LAME WITH <U>GCC 2.96</U> ! It won't + work properly !</B><BR> + This + is needed for CBR/VBR MP3 audio encoding ability. Note that a single + <CODE>lame</CODE> binary isn't sufficient. BTW: the less optimization + you use for lame, the better the quality will be. You can test + quality by running <CODE>make test</CODE> after lame's compiling process + is over. The resulting number should be less than <B>30</B>. Don't + panic if it's <B>400</B> or so, you shouldn't heard any audible + quality decrease. Oh, and if your compiler doesn't even run <CODE>make test</CODE> ... + Well, delete that <B>GCC 2.96</B>.</LI> + <LI>use <CODE>./configure</CODE> with optional parameters as usual + (use <CODE>--enable-tv</CODE> to include V4L tuner grabbing code), and + type : <CODE>make mencoder</CODE> , then <CODE>make install</CODE>.</LI> + </UL> +</P> + +<P>You are ready. As you probably know, other encoding tools need the +<I>avifile</I> library installed. <B>MEncoder</B> doesn't need it at all.</P> + +<A NAME=2.4.3><P><B><I>MEncoder features</I></B> : + <UL> + <LI>encoding from the wide range of fileformats and decoders of <B>MPlayer</B></LI> + <LI>encoding from <B>V4L compatible TV tuners</B></LI> + <LI>encoding/multiplexing to interleaved AVI files with proper index</LI> + <LI>1 or 2 pass <B>DivX4</B> video</LI> + <LI><B>VBR</B> MP3 audio</LI> + <LI>PCM audio</LI> + <LI>stream copying (CBR audio only)</LI> + <LI>input A/V synchronizing (PTS-based, can be disabled with -mc 0 option)</LI> + <LI>FPS correction with <CODE>-ofps</CODE> option (useful when encoding + 29.97fps VOB to 24fps AVI)</LI> + <LI>movie rescaling</LI> + </UL> +</P> + +<P><B><I>Planned features</I></B> : + <UL> + <LI>using audio from separate file (AC3, MP3, OGG)</LI> + <LI>VBR audio stream copy</LI> + <LI>even wider variety of available en/decoding formats/codecs + (creating VOB files with DivX4/Indeo5/VIVO streams :)</LI> + </UL> +</P> + +<A NAME=2.4.3.1><P><B><I>Encoding 2-pass DivX4</I></B></P> + +<P>The name comes from the fact that this method encodes the file <I>twice</I>. +The first encoding (dubbed <I>pass</I>) creates some temporary files with a +size of few megabytes (do not delete them yet). In the second pass, the output +file is created, using the bitrate data from the temporary file. The resulting +file will have much better image quality. If this is the first time you heard +about this, you should consult some guides available on the Net.</P> + +<P>This example shows how to encode a DVD to a 2-pass DivX4 AVI. Just two +commands are needed :<BR> +<CODE> mencoder -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100 +-o movie.avi -pass 1<BR> + mencoder -dvd 2 -ovc divx4 -oac mp3lame -divx4opts br=1100 -o movie.avi -pass 2</CODE></P> + +<A NAME=2.4.3.2><P><B><I>Rescaling movies</I></B></P> + +<P>Often the need to resize movie images' size emerges. Its reasons can be many, + examples are decreasing output file size, encoding SVCDs to DivX. Ripped DVDs + are mostly rescaled, for example a 4:3 DVD should be 640x480, especially + when you want it to fit to 1 CD, and have good quality at the same time. + SVCDs have 480x480 size, and their header contains the aspect ratio the + player should use (Ex.: 480x480 + 4:3 = 640x480). However when encoding to + AVI (DivX) files, you have be aware that AVI headers don't store this + value. Thus, the only solution is rescaling.</P> + +<P>The output size is specified with the <CODE>-x</CODE>, and <CODE>-y</CODE> + options. Furthermore, there are 3 rescaling filters in <B>MEncoder</B>, <I>0 + : fast 1 : bilinear</I>, <I>2 : bilinear</I>, <I>bicubic</I> (best quality). + They can be specified with the <CODE>-sws</CODE> option. If not specified, + <B>MEncoder</B> will use 0 : fast bilinear.</P> + +<P>Rescaling is very simple :<BR> +<CODE> mencoder sample-svcd.mpg -divx4opts br=1300 -x 640 -y 480 -sws 2 -o output.avi</CODE></P> + +<A NAME=2.4.3.3><P><B><I>Stream copying</I></B></P> + +<P><B>MEncoder</B> can handle input streams in two ways : <B>encode</B> or + <B>copy</B> them. This section is about <B>copying</B>.</P> + +<P> +<UL> + <LI><B>Video stream</B> (option <CODE>-ovc copy</CODE>) : nice stuff can be done :)<BR> + Like, putting (not converting!) FLI or VIVO or MPEG1 video into an AVI file ! + Of course only <B>MPlayer</B> can play such files :) And it probably has no + real life value at all. Rationally : video stream copying can be useful for + example when only the audio stream has to be encoded (like, uncompressed PCM + to MP3).</LI> + + <LI><B>Audio stream</B> (option <CODE>-oac copy</CODE>) : straightforward.</LI> +</UL> +</P> + +<A NAME=2.4.4><P><B><I>Syntax</I></B></P> + +<P> <CODE>mencoder [options] [input file] [options] ...</P> + +<A NAME=2.4.5><P><B><I>Available options</I></B></P> + +<P>NOTE : for all available options, <B>read the manpage !</B></P> + +<TABLE BORDER=0> +<TR> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + <I>-o</I> filename</TD> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + specify output filename + </TD> +</TR> +<TR> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + <I>-x</I> width in pixels</TD> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + rescale output video to given pixels width + </TD> +</TR> +<TR> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + <I>-y</I> height in pixels</TD> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + rescale output video to given pixels height + </TD> +</TR> +<TR> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + <I>-sws</I> 0-2</TD> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + type of scaling method<BR> + 0 - fast bilinear<BR> + 1 - bilinear<BR> + 2 - bicubic (best quality)<BR> + </TD> +</TR> +<TR> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + <I>-ovc</I> codecname</TD> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + Encode with the given codec (codec names are from codecs.conf). Examples:<BR> + <B>help</B> - get list of available codecs<BR> + <B>copy</B> - no encoding, just copy the stream (only from AVI/ASF now)<BR> + <B>divx4</B> - encode to DivX4<BR> + </TD> +</TR> +<TR> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + <I>-oac</I> codecname</TD> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + Encode with the given codec (codec names are from codecs.conf). Examples:<BR> + <B>help</B> - get list of available codecs<BR> + <B>copy</B> - no encoding, just copy the stream (only from AVI/ASF now)<BR> + <B>pcm</B> - encode to uncompressed PCM<BR> + <B>mp3lame</B> - encode to MP3 (using Lame)<BR> + </TD> +</TR> +<TR> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + <I>-divx4opts</I></TD> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + If encoding to DivX4, you can specify its parameters here, like:<BR> + <CODE>-divx4opts br=1800:deinterlace:key=250</CODE><BR> + Common options: <B>(for full list, check the manpage!)</B><BR> + <B>help</B> - get help<BR> + <B>br</B>=XXX - specify bitrate in kbit <4-16000> or bit <16001-24000000><BR> + <B>q</B>=XXXX - quality (1-fastest, 5-best - default 5)<BR> + </TD> +</TR> +<TR> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + <I>-lameopts</I></TD> + <TD> </TD> + <TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + If encoding to MP3 with libmp3lame, you can specify its parameters here, like:<BR> + <CODE>-lameopts q=3</CODE><BR> + <CODE>-lameopts br=192:cbr</CODE><BR> + Common options: <B>(for full list, check the manpage!)</B><BR> + <B>help</B> - get help<BR> + <B>cbr</B> - select <B>CBR</B> MP3 (default is <B>VBR</B>)<BR> + <B>br</B>=XXX - specify bitrate in kbit <0-1024> (this is for <B>CBR</B> only!)<BR> + <B>q</B>=XXXX - quality (0-highest, 9-fastest - default 0) (this is for <B>VBR</B> only!)<BR> + </TD> +</TR> +</TABLE> + +<A NAME=2.4.6><P><B><I>Examples</I></B></P> + +<P>Using <B>MEncoder</B> is the easiest thing on Earth. See the following :</P> + +<P>Encoding from DVD, title 2 :<BR> + <CODE> mencoder -dvd 2 -o title2.avi</CODE></P> + +<P>Encoding from DVD, title 2, with rescaling :<BR> + <CODE> mencoder -dvd 2 -x 640 -y 480 -sws 2 -o title2.avi</CODE></P> + +<P>Encoding from HTTP :<BR> + <CODE> mencoder http://mplayer.hq/example.avi -o example.avi</CODE></P> + +<P>Encoding from a pipe :<BR> + <CODE> rar p test-SVCD.rar | mencoder -divx4opts br=800 -ofps 24 -pass 1 -- -</CODE></P> + +<P>Encoding multiple *.vob files :<BR> + <CODE> cat *.vob | mencoder <options> -</CODE></P> + +<P>Encoding from tuner (for tuner options <A HREF="documentation.html#2.5">see the TV input section !</A>) :<BR> + <CODE> mencoder -tv on:driver=v4l:width=640:height=480 <options></CODE></P> + +<P>For all available options, <B><I>check the MEncoder man page !</I></B> +<P> +</FONT> +</BODY> +</HTML> diff --git a/DOCS/Polish/faq.html b/DOCS/Polish/faq.html new file mode 100644 index 0000000000..cfefb057e5 --- /dev/null +++ b/DOCS/Polish/faq.html @@ -0,0 +1,923 @@ +<HTML> +<BODY BGCOLOR=white> + +<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + +<P><B><A NAME=5>5. FAQ section</A></B></P> + +<TABLE BORDER=0 WIDTH=100% ALIGN=left> + +<TD COLSPAN=3><P><B><A NAME=5.1><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>5.1 Compilation</A></B></P> +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD> </TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +configure ends with this text, and MPlayer won't compile !<BR> +<CODE>Your gcc does not support even i386 for '-march' and '-mcpu'.</CODE> +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Your gcc isn't installed correctly, check <CODE>config.log</CODE> file +for details. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD> </TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +What does "No such file or directory" means ? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Probably there is no such file or directory. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD> </TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +What's the problem with gcc 2.96 ? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +To be short: <B><I>DO NOT USE gcc 2.96 !!!</I></B><BR> +Check <A HREF="gcc-2.96-3.0.html">this</A> and <A HREF="users_against_developers.html">this</A> texts! +If you still really really want to do so, be sure to use the latest release. +<BR> +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Great, I have gcc 3.0.1 from RedHat/Mandrake, then I'm fine--! +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +No, since there have been/are issues with those compilers.<BR> +Use 2.95.x series for reliability (not <A HREF="gcc-2.96-3.0.html">2.96</A>). +Use the latest gcc 3.0.x (starting at 3.0.2) if you want to use a 3.0.x version. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +I tried to compile MPlayer, but I got this output:<BR> +<PRE> +In file included from /usr/include/g++-v3/bits/std_cwchar.h:42, + from /usr/include/g++-v3/bits/fpos.h:40, + from /usr/include/g++-v3/bits/char_traits.h:40, + from /usr/include/g++-v3/bits/std_string.h:41, + from /usr/include/g++-v3/string:31, + from libwin32.h:36, + from DS_AudioDecoder.h:4, + from DS_AudioDec.cpp:5: +/usr/include/wchar.h: In function Long long int wcstoq(const wchar_t*, + wchar_t**, int)': +/usr/include/wchar.h:514: cannot convert `const wchar_t* __restrict' to +`const +</PRE> +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Upgrade your glibc to the newest. On Mandrake, use 2.2.4-8mdk . +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +...gcc 2.96... (yes, some people are STILL flaming about their gcc 2.96!!) +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +<P>But we has idegs (the word 'ideg' is described further in the FAQ). And our +idegcounters overflow again and again.</P> + +<P>Unfortunately MPlayer is out of our control. It's used by lamers, Linux users +who can't even use windows, and never tried to compile a kernel. They installed +(with default options) Mandrake or RedHat or Suse, and without RTFM'ing they +send messages saying 'it doesn't work! help me! please! i'm new to the linux! +help! oh! help me!'. We can't stop them, but at least we try to force them RTFM +and to read fuckin' messages of ./configure and mplayer.</P> + +<P>And you clever guys come and flame us with gcc 2.96 and binary packages. +Instead of helping users or making patches to help solve problems.</P> + +<P>Half of our spare/free time is spent by answering silly mails here and +making newer tricks and checks to configure to avoid such mails.</P> + +<P>And there is a balance. On one hand are you, clever guys, saying we are very +bad because we don't like buggy gcc 2.96, and at the other hand there are the +'new to linux' guys who are showing us gcc 2.96 is buggy.</P> + +<P>Conclusion: we can't be good. Half of people always will say we are bad.</P> + +<P>Maybe we should close the project, make it closed source, commercial, and +provide install support for it. then we could leave current work, so +development could go faster, and we earn lots of money with it and buy a big +house, etc etc. Do you really want it? It seems.</P> + +<P ALIGN=RIGHT>Arpi (a mail on the mplayer-users list)</P> +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Where can I find information about gcc 2.96 bugs ? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +In <A HREF="gcc-2.96-3.0.html">this</A> documentation. And <A HREF="users_against_developers.html">this</A> +documentation describes why RedHat released 2.96 and other interesting things. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +SDL output doesn't work or compile. Problem is .... +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +It is tested with newest SDL (probably runs on 1.1.7+). +It does NOT work with any previous version, so don't ask. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +I am still having trouble compiling with SDL support. gcc says something +about "undefined reference to `SDL_EnableKeyRepeat'" What's now? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Where did you install the SDL library? If you installed in /usr/local +(the default) then edit the top level config.mak and add +"-L/usr/local/lib " after "X_LIBS=" Now type make. You're done! +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +It doesn't compile, and it misses uint64_t inttypes.h and similar things... +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +copy etc/inttypes.h to <B>MPlayer</B> directory (cp etc/inttypes.h .) +try again... +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +I have Pentium III but ./configure doesn't detect SSE +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Only kernel versions 2.4.x supports SSE (or try latest 2.2.19 or newer, but +be prepared for problems) +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +I have G200/G400, how to compile/use mga_vid driver? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Read all this documentation. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Are there rpm/deb/... packages of <B>MPlayer</B>? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +You can make a .deb package for yourself, check section <A HREF="documentation.html#6.1">6.1</A>. +It's _STRONGLY_ discouraged to use precompiled packages +of <B>MPlayer</B>, since it (currently) _highly_ depends on compile-time +options and optimizations! +Precompiled packages are COMPLETELY unsupported by the <B>MPlayer</B> team! +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +During 'make', MPlayer complains about X11 libraries. I don't understand, +I DO have X installed!? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +...but you don't have the X development package installed. Or not +correctly. It's called XFree86-devel* under RedHat, and xlib6g-dev* under +Debian. Also check if the /usr/X11 symlink exists (this can be a problem on +Mandrake systems). It can be created with the<BR> + <CODE>$ ln -sf /usr/X11R6 /usr/X11</CODE><BR> + command. Also check the /usr/include/X11 link :<BR> + <CODE>$ ln -sf /usr/X11R6/include/X11 /usr/include/X11</CODE><BR> +Your distribution may differ from the Linux Filesystem Standard. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +What about DGA driver? I can't find it!!! +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +./configure autodetects your DGA driver. If -vo help doesn't show +DGA, then there's a problem with your X installation. +Try ./configure --enable-dga (and RTFM) +Alternatively, try SDL's DGA driver with '-vo sdl:dga' options. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +I can't compile SVGAlib.. I'm using 2.3/2.4 kernel. +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +You have to edit SVGAlib's Makefile.cfg and comment "BACKGROUND = y" out. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +I compiled MPlayer with libdvdcss/libdivxdecore support, but when +I try to start it, it says:<BR> +<CODE>> error while loading shared libraries: lib*.so.0: cannot load +shared object file: No such file or directory</CODE><BR> +I checked up on the file and it IS there in /usr/local/lib. +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +What are you doing on Linux? Can't you install a library? Why do +we get these questions? It's not <B>MPlayer</B> specific at all! Add +/usr/local/lib to <B>/etc/ld.so.conf</B> and run <B>ldconfig</B> . +Or install it to /usr/lib , because if you can't solve the /usr/local +problem, you are careless enough to do such things. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +MPlayer doesn't seem to find my libcss. What am I doing wrong ? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +It's normal. <B>MPlayer</B> no longer depends on libcss to play a DVD. You +have to install <B>libdvdread</B> and <B>libdvdcss</B>. Check for DVD Playback +part <A HREF="cd-dvd.html">here</A>. libcss is to be used for example when you +want to play encrypted VOB files from hard disk (not for general users). +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Hmm, strange. When loading the mga_vid.o kernel module, I found this in the logs:<BR> +<CODE>Warning: loading mga_vid.o will taint the kernel: no license</CODE> +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +The latest kernels modules needs require a flag indicating its license (mainly +to avoid kernel hackers' debugging closed sources drivers). +Upgrade your kernel and your modutils and <B>MPlayer</B>. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +When compiling <B>MEncoder</B>, it segfaults at linking !!! +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Dunno, upgrading binutils should help (2.11.92.* or newer should be good). Not our fault, do NOT report! +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +I'd like to compile <B>MPlayer</B> on Minix ! +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Me too. +</TD><TR><TD COLSPAN=3> </TD><TR> + + +<TD COLSPAN=3><B><A NAME=5.2><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>5.2. General questions</A></B> +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +What about DVD playing ? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Read the CD/DVD section in <A HREF="cd-dvd.html">this page</A>. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +-xy or -fs option doesn't work with x11 driver (-vo x11) +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +It does, but you have to explicitly specify software scaling (it's SLOW!) with +the <CODE>-zoom</CODE> option. You better use XF86VidMode support: +you must specify the -vm and the -fs switch, and you're done. +Make sure you have the right Modelines in your XF86Config file, and +try if the DGA driver (and SDL's DGA driver, see RTFM) works for you. +It's much faster. If SDL's DGA works too, use that, it'll be EVEN faster! +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +What is the meaning of numbers in the status line? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +See: <CODE><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A: 2.1 V: 2.2 A-V: -0.167 ct: 0.042 57 41% 0% 2.6% 0 4</CODE><BR> +<UL> +<LI><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A: audio position in seconds +<LI>V: video position in seconds +<LI>A-V: audio-video difference in seconds (delay) +<LI>ct: total A-V sync correction done +<LI>frames played (counting from last seek) +<LI>video codec cpu usage in percent (for mpeg it includes video_out too!) +<LI>video_out cpu usage for avi, 0 for mpg (see above) +<LI>audio codec cpu usage in percent +<LI>frames needed to drop to maintain A-V sync +<LI>current level of image postprocessing (when using -autoq) +</UL> +<I>Most of them are for debug purposes, and will be removed soon.</I> +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +What if I don't want them to appear? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Then you use the -quiet option, and read the manpage. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Why is video_out cpu usage zero (0%) for mpeg files? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +It's not zero, but it's built in into codec, so can't be measured separated. +You should try to play the file using -vo null and then -vo ... and check +the difference to see video_out speed... +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +What's XMMP? (is it XMMS or XMPS but mispelled?) +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +It's a new project, see http://frozenproductions.com for details +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +There are error messages about file not found /usr/lib/win32/.... +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Download <A HREF="ftp://ftp.mplayerhq.hu/MPlayer/releases/w32codec.zip">w32codec.zip</A> +from *our* FTP (avifile's codec package has different DLL set). +Install it. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Are there any mailing lists on MPlayer? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Yes! See RTFM on how to subscribe them! +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +I've found a nasty bug when I tried to play my favourite video!! +Who should I inform? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +See Appendix <A HREF="bugreports.html">C</A>. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +I have problems playing files with ... codec. Can I use'em? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Check <A HREF="http://www.mplayerhq.hu/DOCS/codecs-status.html">http://www.mplayerhq.hu/DOCS/codecs-status.html</A>, +if it doesn't contain your codec, read +<A HREF="codecs.html#2.1.3">section 2.1.3</A>, and contact us. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Umm, what is "IdegCounter"? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +A mixture of a hungarian and an english word. In english, "Ideg" means +"nerve", and is pronounced as something like "ydaegh" . It was first used +to measure the nervousness of A'rpi, after some (umm) "mystic" disappearance +of CVS code ;) +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +And what is "Faszom(C)ounter" ? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +"Fasz" is a hungarian word you don't want to know, the others are in +connection with the pervert minds of the MPlayer developers. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +LIRC doesn't work, because ... +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Are you sure you use "mplayer_lirc" instead of "mplayer"? +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Subtitles are very nice, the most beautiful I've ever seen, but they slow +down the playing! I know it's unlikely... +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +After running ./configure , edit config.h and replace <CODE>#undef FAST_OSD</CODE> with +<CODE>#define FAST_OSD</CODE>. Then recompile. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +The OSD is flickering! +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +You use a vo driver with single buffering (x11,xv). With xv, +use -double option. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +What exactly is this libavcodec? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +See the <A HREF="codecs.html#2.1.2.2">2.1.2.2 section</A>. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +But configure tells me "Checking for libavcodec ... no"! +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +You need to get libavcodec from FFmpeg's CVS. Read the instructions in +the <A HREF="codecs.html#2.1.2.2">ffmpeg section</A>. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +The GUI isn't usable with icewm, because some panel are over the movie!! +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Known, icewm is shit and dictatoric. Unsolvable. In detail: icewm sucks +because its taskbar overrides GUI's window resize queries. If it asks for +resize to 800x600, then it resizes window to 800x(600-taskbar_size). It's bad. +Very bad. In short: shit. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +I can't access the GUI menu. I press right click, but I can't access any +menu items ! +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Are you using FVWM ? Try the following :<BR> +Start -> Settings -> Configuration -> Base Configuration<BR> +<BR> +Set "Use Applications position hints" to Yes. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD COLSPAN=3> +<B><A NAME=5.3><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>5.3. File playing problems</A></B> +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +...... works with avifile/aviplay while doesn't with MPlayer. +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +<B>MPlayer</B> != avifile +The only common thing between these players is the Win32 DLL loader. +The codecs (dll) sets, syncronization, demultiplexing etc is totaly +different and shouldn't be compared. +If something works with aviplay it doesn't mean that <B>MPlayer</B> should do +it and vice versa. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Audio goes out of sync playing .avi file. +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Try with -bps or -nobps option +if still bad, send me (upload to ftp) that file, I'll check. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Indeo 3.x/4.x movies are viewed upside-down!!!? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +It's a known bug (really it's a bug/limitation of the DLL codec) +Try if your vo driver supports the -flip switch. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Indeo 3.x,4.x video doesn't work at 32bpp resolutions (16,24 bpp are ok). +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +It's a known bug (really it's a bug/limitation of the DLL codec). +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +MPlayer exits with something error when using l3codeca.acm. +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Check 'ldd /usr/local/bin/mplayer' output. If it contains<BR> + <CODE>libc.so.6 => /lib/libc.so.6 (0x4???????)</CODE><BR> +where "?" is any number then it's ok, the error is not here. If it is:<BR> + <CODE>libc.so.6 => /lib/libc.so.6 (0x00??????)</CODE><BR> +then there is problem with your kernel/libc. Maybe you are using some +security patches (for example Solar Designer's OpenWall patch) which +forces loading libraries to very low addresses. +Because l3codeca.acm is a non-relocatable DLL, it must be loaded to +0x00400000, we can't change this. You should use non-patched kernel, +or use <B>MPlayer</B>'s -afm 1 option to disable using l3codeca.acm. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +My computer plays M$ DivX AVIs with resolutions ~ 640x300 and stereo mp3 +sound too slow. When I use -nosound switch, everything is ok (but quiet). +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Ok son, your machine is too slow. RTFM or anything. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +MPlayer dies with "MPlayer interrupted by signal 4 in module: decode_video". +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Try running <B>MPlayer</B> on the machine you compiled on. Or recompile. Don't +use <B>MPlayer</B> on different CPU than it was compiled on. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +I have problems with [your window manager] and fullscreen xv/xmga/sdl/x11 modes.. +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Use the -fsmode switch. See example.conf or manpage. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +But it works with avifile! +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +So what? +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Then avifile is better! +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Then use avifile, it has nice GUI and nice C++ code :) +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +I got this playing mpeg files: Can't find codec for video format 0x10000001! +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +You have old version of codecs.conf at ~/.mplayer/. Upgrade it from etc/<BR> +<B>OR</B> you have the <CODE>vc=</CODE> option or similar, in your +config file(s). +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +After starting mplayer under KDE(1/2) I just get a black screen and nothing +happens, after about one minute the video starts playing. +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +The KDE arts sound daemon is blocking the sound device, either wait the time +until video starts or you disable the arts-daemon in kontrollcenter. +If you want to use arts sound, specify audio output via SDL (ao=sdl), and +make sure your SDL can handle arts sound. Yet another option is to start +mplayer with artsdsp. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +I have an AVI that plays with grey screen with -vc odivx, and green with -vc divx4 . +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +It's not a DivX file, but an M$ MPEG4v3 . Update your codecs.conf. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +There this movie is, and when I play it I get video-audio desync and/or MPlayer crashes with the following:<BR> +<CODE>DEMUXER: Too many (945 in 8390980 bytes) video packets in the buffer!</CODE> +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +This can have multiple reasons.<BR> + <LI>your CPU <B>and/or</B> video card <B>and/or</B> bus is too SLOW. <B>MPlayer</B> + displays a message if this is the case. (and the dropped frames counter is going up fast)</LI> + <LI>if it is an AVI, maybe it has shit interleaving. Try the <I>-ni</I> option.</LI> + <LI>your sound driver is shit, or you use ALSA 0.5 with <I>-ao oss</I>. See the <A HREF="sound.html">soundcards section</A>.</LI> + <LI>the AVI has shit header, try with the <I>-nobps</I> option, and/or <I>-mc 0</I> .</LI> +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +I have an MJPEG file which works with other players but displays only black +image in MPlayer. +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Disable the Windows DLL in <CODE>codecs.conf</CODE>, or use <CODE>-vc ffmjpeg</CODE> option (you have to +compile MPlayer with libavcodec). +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +When I try to grab from my tuner, it works, but colors are strange. It's ok +with other applications. +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Your card probably misreports its colorspace capacity. Try with YUY2 instead +of default YV12 (see TV input documentation). +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +When I try to start playing, I get this message, but playing is good :<BR> +<CODE>Linux RTC init: ioctl (rtc_pie_on): Permission denied</CODE> +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +See the <A HREF="documentation.html#1.3">Installation section</A>. The part +about new sync code. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +I have A/V sync problems. Some of my AVIs play fine, but some play with +double speed ! +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +You have buggy soundcard/driver. Most likely it's fixed at 44100Hz, and +you try to play a file which has 22050Hz audio. Try the <CODE>-ao sdl</CODE> +driver. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +All the WMV (or other..) files I play gives green/gray window and there is +only sound! It prints:<BR> +<CODE>Detected video codec: [null] drv:0 (NULL codec (no decoding))</CODE> +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Update your <CODE>codecs.conf</CODE> +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +I'm using the GUI. During startup, MPlayer prints :<BR> +<PRE><CODE>Gtk-WARNING **: This process is currently running setuid or setgid. +This is not a supported use of GTK+. You must create a helper +program instead. For further details, see...</CODE></PRE> +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +You can't use GTK in a suid-root binary, as pointed out in the GUI section. +</TD><TR><TD COLSPAN=3> </TD><TR> + + +<TD COLSPAN=3> +<B><A NAME=5.4><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>5.4. Video/audio driver problems (vo/ao)</A></B> +</TD><TR><TD COLSPAN=3> </TD><TR> + + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Ok, -vo help shows DGA driver, but it is babbling about permissions! +Help me! +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +It works only if running as root! It's a DGA limitation. +You should become to root (su -), and try again. +Another solution is making mplayer SUID root, but its NOT RECOMMENDED!<BR> + <CODE>chown root /usr/local/bin/mplayer</CODE><BR> + <CODE>chmod 750 /usr/local/bin/mplayer</CODE><BR> + <CODE>chmod +s /usr/local/bin/mplayer</CODE><BR> +<B>!!!! BUT STAY TUNED !!!!</B><BR> +This is a *BIG* security risk! *NEVER* do this on a server or on a computer +can be accessed by more people than only you because they can gain root +privilegies through suid root mplayer!!!<BR> +<B>!!!! SO YOU HAVE BEEN WARNED ... !!!!</B> +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +When using Xvideo, my Voodoo 3/Banshee says:<BR> +<CODE>X Error of failed request: BadAccess (attempt to access private resource denied)<BR> + Major opcode of failed request: 147 (MIT-SHM)<BR> + Minor opcode of failed request: 1 (X_ShmAttach)<BR> + Serial number of failed request: 26<BR> + Current serial number in output stream:27</CODE><BR> +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Your driver is old, update it. Either download (at least) DRI version 0.6 +from <A HREF="http://dri.sourceforge.net">http://dri.sourceforge.net</A>, +or use the DRI cvs. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +When using Xvideo, I can't play DivX avis with my Voodoo 3/Banshee! +It says:<BR> +...<BR> +<CODE>Xvideo image format: 0x32315659 (YV12) planar<BR> +Xvideo image format: 0x30323449 (I420) planar<BR></CODE> +... +</B></TD><TR><TD></TD><TD VALIGN=top><font face="Verdana, Arial, Helvetica, sans-serif" size="2">A1:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +See the previous answer. +</TD><TR><TD></TD><TD VALIGN=top><font face="Verdana, Arial, Helvetica, sans-serif" size="2">A2:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Since 0.18pre4 we support libavcodec from the ffmpeg package. It contains +a C language DivX and OpenDivX decoder. The DivX decoder uses YV12 format +for output, thus it should work for you. Compile in libavcodec support. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +OpenGL (-vo gl) output doesn't work (hangup/black window/X11 errors/...). +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Your opengl driver doesn't support dynamic texture changes (glTexSubImage) +It's known not to work with nVidia's binary shit. +It's known to work with Utah-GLX/DRI and Matrox G400 card. Also with +DRI and Radeon card. It won't work with DRI others than these. +it will not work with 3DFX cards because the 256x256 texture size limit. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +I have an nVidia TNT/TNT2 card, and I have a band with strange colours, +right under the movie! Whose fault is this? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +It's the nVidia X driver's. These bugs are ONLY with the TNT/TNT2 cards, +and we can't do anything about it, it's not our bug. UPDATE : it's fixed +in newest drivers, at last.. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +I have an nVidia XYZ card, and when I click on the GUI's diplay window to toggle +displaying the GUI panel, a black square appears where I clicked. I have +the newest driver. +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Yes, nvidia corrected a previous bug (above), and implemented a new one. Let's +congratule them. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +When I use the GUI with SDL video output, a second video window is created. +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Known, don't use SDL for GUI yet. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD COLSPAN=3> +<B><A NAME=5.5><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>5.5. Feature requests</A></B> +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Is there a hint on how to watch RealMedia movies in MPlayer? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +There's no way to do it. Therefore this format deserves to die in flames. +Theoretically you can reverse engineer Real codecs built for Linux (they +are available as .so files), but in practice that's really difficult, even +if you know how the compiler used by Real is making assembler code. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +When will be <your favourite video feature> (like subtitle placement) implemented? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Wait for libvo2. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +I want to play MP3 files with MPlayer ! +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +This feature is not planned. There are much better players (mpg123, 3pm, xmms) +for this task, use them. BTW, MPlayer stands for Movie Player. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +I'd like to seek +/- 1 frames, instead of 10 seconds. +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +This won't be done. It was, but then it fucked up A/V sync. Feel free to +implement it, and send a patch. Don't ask for it. +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> + Where is the Windows version ? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> + It's not released, and won't be. Look around the windows scene (opensource + ASF parsers, opensource ASF encoders, etc) and you'll know why. We don't + want to go to jail. +</TD><TR><TD COLSPAN=3> </TD><TR> + + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +What card you may suggest me to buy?</font></font></b></td> +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A0:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +It's for your opinion only but our issues are:</font></font> +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A1:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Speed:</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1>This +parameter can be computed very easy:</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1><b>a)</b> +which movies do you plan to watch:</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1><b>- +MPEG1:</b> 320x200@32=256000</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1>so +you need only 256*25fps=6.4Mb/sec bandwidth (This format can be played +in real-time on any PC since P-100 + S3Virge)</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1><b>- +MPEG4:</b> 640x480@32=1228800</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1>you +need videobandwidth 1.2*25fps=30Mb/sec To watch such movie in real-time +you need enough power PC: (Celeron-450+DIMM based video card)</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1><b>- +MPEG2 (aka DVD or SDTV):</b> 1024x768@32=3145728</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1>you +need videobandwidth 3*30fps=90Mb/sec In extremal cases (if your video card +supports IDCT decoding) this can be played on the same PC as for MPEG4</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1><b>- +HDTV (HighData TeleVision):</b> 2000x2000@32=16000000</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1>i.e. +videobandwidth = 16*30fps=480Mb/sec (This means also that you need at least +32Mb of video memory to watch this stream: 16Mb for RGB area and 16Mb for +YUV area)</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1><b>b)</b> +Bandwidth of PCI slot is: 33Mhz*32bit=132Mb/sec And PCI2.1 has 66MHz*32bit=265Mb/sec +that is far enough for any movie playback (except HDTV streams which really +require AGP bus).</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1><b>c)</b> +What memory type should be installed on video card:</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1><b>SIMM</b> +- avoid that</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1><b>DIMM</b> +- good if your video card has 128-bit memory access.</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1><b>DDR</b> +- is far enough for all types.</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1>Note: +By DGA comparision - there is no any visible difference between video cards +which have installed the same type of video memory.</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1><b>Resume:</b> +If you have enough power CPU (Celeron-450 or K6-2-500) it would be enough +to buy any video card which has at least 8Mb of DIMM or DDR memory.</font></font> +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A2:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Quality:</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1>This +question was investigated in depth at:</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1><a href="http://www.anandtech.com">http://www.anadtech.com</a> +AnandTech - Video Card Roundup - DVD Quality, Features & Performance +(October 2000)</font></font> +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A3:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +WORKING features under Linux:</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1>If +you are win32 user then probably you have support (from driver and DirectX8 +side) for any feature which was introduced in your chip.</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1>But +for <b>linux </b>users:</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1>Currently +I know only several vendors which have more or less advanced support under +Linux:</font></font> +<br> +<table BORDER COLS=5 WIDTH="100%" NOSAVE > +<tr> +<td> </td> + +<td> +<center>Matrox</center> +</td> + +<td> +<center>ATI</center> +</td> + +<td> +<center>NVidia</center> +</td> + +<td> +<center>S4 Savage</center> +</td> +</tr> + +<tr> +<td>Driver's provider</td> + +<td>enthusiasts</td> + +<td>enthusiasts</td> + +<td>OEM + enthusiasts</td> + +<td>enthusiasts</td> +</tr> + +<tr> +<td>Driver's quality</td> + +<td>Best(X11,kernel)</td> + +<td>Best(X11,GATOS,kernel)</td> + +<td>Buggy(X11 only)</td> + +<td>Best(X11 only)</td> +</tr> + +<tr> +<td>VIDEO OVERLAY</td> + +<td></td> + +<td></td> + +<td></td> + +<td></td> +</tr> + +<tr> +<td>BES and YV2RGB</td> + +<td>YES</td> + +<td>YES</td> + +<td>YES</td> + +<td>YES</td> +</tr> + +<tr> +<td>scaling filters</td> + +<td>N/A</td> + +<td>YES</td> + +<td>N/A</td> + +<td>N/A</td> +</tr> + +<tr> +<td>adaptive deinterlace</td> + +<td>NO</td> + +<td>YES</td> + +<td>N/A</td> + +<td>N/A</td> +</tr> + +<tr> +<td>Video equalizer (hue, contrast, saturation, color correction)</td> + +<td>N/A</td> + +<td>PARTLY (under devel)</td> + +<td>N/A</td> + +<td>N/A</td> +</tr> + +<tr> +<td>Alpha blending, color and video keys</td> + +<td>PARTLY</td> + +<td>PARTLY (under devel)</td> + +<td>N/A</td> + +<td>N/A</td> +</tr> + +<tr> +<td>Video capture</td> + +<td>N/A</td> + +<td>YES(GATOS)</td> + +<td>N/A</td> + +<td>N/A</td> +</tr> + +<tr> +<td>TV-out</td> + +<td>YES</td> + +<td>YES</td> + +<td>N/A</td> + +<td>N/A</td> +</tr> +</table> + +<p><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1>Well +- it's very rude observing of video card. Indeed we should pay our attention +for models of video card:</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1>For +example if MatroxG400(G450) drivers support TV-out then G550 has no such +support.</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1>Other +sample: Adaptive deinterlacing exists only since Rage128 chip and isn't +present on Mach64+ ones. Same as 3D features are far different from Mach64 +to Radeon2 8500 with trueform possibilities.</font></font> +<p><b><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1>ANYWAY +- MPLAYER'S TEAM DOESN'T ACCEPT ANY CLAIMS IF YOU AFTER</font></font></b> +<br><b><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1>READING +OF THIS MATERIAL WILL BUY CARD WHICH IS UNSUCCESSFUL FOR YOU!!!</font></font></b> +<br><b><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1>THIS +MATERIAL IS ONLY OUR VISION.</font></font></b> +<p><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1><b>Q:</b> +If PCI slot is far enough for most types of movies then why S3 Virge</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1>is +too slow for them?</font></font> +<br><font face="Verdana, Arial, Helvetica, sans-serif"><font size=-1><b>A:</b> +Due to its SIMM memory.</font></font> +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD COLSPAN=3> +<B><A NAME=5.6><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>5.6. Encoding</A></B> +</TD><TR><TD COLSPAN=3> </TD><TR> + +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Q:</TD><TD WIDTH=100%><B><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +How can I encode ? +</B></TD><TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>A:</TD><TD><font face="Verdana, Arial, Helvetica, sans-serif" size="2"> +Check <A HREF="encoding.html">this documentation</A>. +</TD><TR><TD COLSPAN=3> </TD><TR> + +</TABLE> + +</BODY> +</HTML> diff --git a/DOCS/Polish/formats.html b/DOCS/Polish/formats.html new file mode 100644 index 0000000000..3d8cc6e576 --- /dev/null +++ b/DOCS/Polish/formats.html @@ -0,0 +1,168 @@ +<HTML> +<BODY BGCOLOR=WHITE> + +<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + + +<P><B><A NAME=2.1>2.1. Supported formats</A></B></P> + +<P><B>MPlayer</B> can read/play from the following devices/formats:<BR> +<UL> +<LI> <A HREF="#2.1.1.1">VCD</A> (Video CD) directly from CD-ROM or from CDRwin's .bin image file +<LI> <A HREF="#2.1.1.1">DVD</A>, directly from your DVD disk, using libdvdread for decryption +<LI> <A HREF="#2.1.1.1">MPEG 1/2</A> System Stream (PS/PES/VOB) and Elementary Stream (ES) file + formats +<LI> <A HREF="#2.1.1.2">RIFF AVI</A> file format +<LI> <A HREF="#2.1.1.3">ASF/WMV</A> 1.0 file format +<LI> <A HREF="#2.1.1.4">QT/MOV</A> file format with (un)compressed headers +<LI> <A HREF="#2.1.1.5">VIVO</A> format (.viv files) +<LI> supports <A HREF="documentation.html#3.3">reading from stdin</A>, or network via HTTP +</UL></P> + +<P>Note: about realmedia (.ra/.rm) support read the FAQ!</P> + +<P>It's important to clarify a popular mistake. When people see a file with +<B>.AVI</B> extension, they instantly declare that isn't an MPEG file. +That's not true. At least not entirely. If you tell them that such a file +can contain MPEG1 video, they laugh at you. Feel free to kick their dumbass +faces, then tell them to RTFM.</P> + +<P>You see, a <B>codec</B> isn't equal to a <B>file format</B>.<BR> +Video <B>codecs</B> are: MPEG1, MPEG2, DivX, Indeo5, 3ivx.<BR> +Video <B>formats</B> are: MPG, AVI, ASF.<BR> +</P> + +<P>In theory, you can happily put an OpenDivX video and MP3 audio +into a <B>.MPG</B> format file. Though most players won't play it, since +they expect MPEG1 video and MP2 audio (<B>.MPG</B> doesn't have the +necessary fields to describe its video and audio streams, like <B>.AVI</B> +does). Or put MPEG1 video to an .AVI. For example <A HREF="http://ffmpeg.sourceforge.net">ffmpeg</A> can +create these files.</P> + +<P>Audio <B>codecs</B> and <B>formats</B> are basically the same terms.</P> + + +<P><B><A NAME=2.1.1>2.1.1. Video formats</A></B></P> + + +<P><B><A NAME=2.1.1.1>2.1.1.1. MPEG files</A></B></P> + +<P> +<LI>MPG : this is the most <B>basic</B> form of MPEG file formats. Contains +MPEG1 video, and MP2 (MPEG-1 layer 2) audio, or rarely MP1.</LI> +<LI>DAT : this is the very same format as MPG, just different extension. Used +on <B>Video CD</B>s. Due to the nature VCDs are created and Linux is designed, +the DAT files can't be played nor copied from VCDs. You have to use the +<CODE>-vcd</CODE> option to play the VideoCD.</LI> +<LI>VOB : this is the MPEG file format on <B>DVD</B>s. The same as MPG, plus +capability to contain subtitles, or non-MPEG (AC3) audio. Contains encoded MPEG2 +video, and usually AC3 audio, but MP2 is allowed too.<BR> +<B>Read the <A HREF="cd-dvd.html#4.2">DVD section</A> !</B></LI> +</P> + +<P>In MPEG files, series of frames are grouped together, and are independent +from the other groups. What this means is you can cut/join an MPEG file with +standard file-tools (like dd, cut), and it remains completely functional.</P> + +<P>One important feature for MPGs is that they have a field to describe +the aspect ratio of the video stream within. For example SVCDs have +480x480 resolution video, and in the header that field is set to 4:3, so +it's played at 640x480. AVI files don't have this field, so one has to +rescale it during encoding.</P> + + +<P><B><A NAME=2.1.1.2>2.1.1.2. AVI files</A></B></P> + +<P>Designed by Micro$oft, the <B>AVI (Audio Video Interleaved)</B> is a +widespread multipurpose format, currently used mostly for DivX and DivX4 +videos. Has many known drawbacks, and inabilities (for example in streaming). +Has support for one video stream, and 99 audio streams. Can be as big as +2Gb. There exists an extension for it to be bigger, called <B>OpenDMS</B>. +M$ currently strongly discourages its use and propagates ASF/WMV. Not if +anybody cares.<BR> +<B>NOTE</B> : DV cameras can create two types of AVI format, one is the usual and +playable, the other is neither.</P> + +<P>There are two kinds of AVI files: +<UL> + <LI><B>Interleaved</B> : audio and video content is interleaved. This is the + standard usage. Recommended and mostly used. Some tools create interleaved + AVIs with bad sync. <B>MPlayer</B> detects these as interleaved, and this + climaxes in loss of A/V sync, probably at seeking. These files should be + played as non-interleaved (with the <CODE>-ni</CODE> option).</LI> + <LI><B>Non-interleaved</B> : bad. First come the whole video stream, then the whole + audio stream, thus needs a lot of seeking. It's very bad when playing from + network or CDROM.</LI> +</UL> +</P> + +<P>MPlayer supports 2 kind of timing for AVI files: +<UL> + <LI><B>bps-based</B> : it is based on bitrate/samplerate of video/audio stream. This + method is used by most players, including avifile and windows media player. + Files with broken headers, and files created with VBR audio but not + VBR-compliant encoder will result in A/V desync with this method (mostly at + seeking).</LI> + <LI><B>interleaving-based</B> : it doesn't use bitrate value of the header, instead + it uses the relative position of interleaved audio and video chunks. Makes + some badly encoded file with VBR audio playable.</LI> +</UL> +</P> + +<P>Any audio and video codec is allowed, but note that VBR audio isn't well +supported by most of the players. The file format makes it possible to use VBR +audio, but most players expect CBR audio, thus they fail with VBR. VBR is +unusual, and Microsoft's AVI specs only describe CBR audio. I also note, that +most AVI encoders/multiplexers create bad files if using VBR audio. Only 2 +exception (known by me): NaNDub and <A HREF="encoding.html">MEncoder</A>.</P> + + +<P><B><A NAME=2.1.1.3>2.1.1.3. ASF/WMV files</A></B></P> + +<P>ASF (active streaming format) comes from Microsoft. They developed two +variants of ASF, v1.0 and v2.0. v1.0 is used by their media tools (windows +media player and windows media encoder) and is very secret. v2.0 is published +and patented :). Of course they differ, there is no compatibility at all (it's +just another legal game). <B>MPlayer</B> supports only v1.0, as nobody has ever seen +v2.0 files :) . Note, that .ASF files nowdays come with the extension .WMA or +.WMV.</P> + + +<P><B><A NAME=2.1.1.4>2.1.1.4. QuickTime/MOV files</A></B></P> + +<P>These are from Macintosh. Usually have extensions of .QT or .MOV . Note +that since the MPEG4 Group chose QuickTime as the recommended file format +for MPEG4, their .MOV files come with .MPG or .MP4 extension (interesting +that in these files the video stream is a real .MPG file. With the +<CODE>-dumpvideo</CODE> option you can even extract it.).</P> + +<P><B>Codecs</B>: any codecs allowed, both CBR and VBR. Note: most new mov files use +<B>Sorenson</B> video and QDesign Music audio. These formats are completely +secret, and only Apple's quicktime player is able to play these files (on +win/mac only).</P> + + +<P><B><A NAME=2.1.1.5>2.1.1.5. VIV files</A></B></P> + +<P><B>MPlayer</B> happily demuxes VIVO file formats. The format's big +disadvantage is that it has no index block, nor fixed packetsize or sync bytes, +and most files lack even keyframes, so forget seeking!</P> + +<P>VIVO/1.0 files' video codec is standard <B>h.263</B> . The VIVO/2.0 files' +video codec is a modified, nonstandard <B>h.263</B> . Audio is the same, +it may be <B>g.723</B> (standard), or <B>Vivo Siren</B> .</P> + +<P>See the <A HREF=codecs.html#2.2.1.4>VIVO video codec</A> +and <A HREF=codecs.html#2.2.2.4>VIVO audio codec</A> sections for installation +instructions.</P> + + +<P><B><A NAME=2.1.2>2.1.2. Audio formats</A></B></P> + +<P>Currently <B>MPlayer</B> is still a <B>Movie</B> and not a <B>Media</B> +player, thus the pure audio formats (for example MP3, WAV, audio ASF) are +unplayable. Use <A HREF="http://www.xmms.org">xmms</A>, <A HREF="http://www.mpg123.de">mpg123</A> +or whatever.</P> + +</BODY> +</HTML> diff --git a/DOCS/Polish/gcc-2.96-3.0.html b/DOCS/Polish/gcc-2.96-3.0.html new file mode 100644 index 0000000000..73cb16534e --- /dev/null +++ b/DOCS/Polish/gcc-2.96-3.0.html @@ -0,0 +1,111 @@ +<HTML> +<BODY BGCOLOR=WHITE> +<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + +<P> +<B>Question:</B> What is GCC 2.96 ? I can't find it at GNU site. +</P> + +<P> +<B>Answer:</B> Read the <A HREF="http://gcc.gnu.org/gcc-2.96.html">official answer from GNU GCC team.</A> +</P> + +<P> +<B>Question:</B> What is the problem with GCC 2.96 ? And with 3.x ? +</P> + +<P> +<B>Answer:</B> +</P> + +<P> +And for the people, who periodically asks what are the exact problems with +gcc 2.96, my answer: <I>we don't know exactly.</I> +There were various problems and new problems / bugs come up periodically. +It is <I>not a single bug/problem</I>. We just see various bugreports, mostly +gcc internal bugs, compiler syntax errors in source or bad code compiled. They +all are solved using different version of gcc. I understand that gcc 2.96 +has different default optimization flags and they conflicts with our inline +asm code, but we can't fix them, and we really don't want to fix them as they +work with other compilers or gcc versions, and the fix may cause speed loss. +</P> + +<P> +I think that the gcc 2.96 should be fixed to be option-compatible with other +releases, but redhat guys refused to do it. If someone interested - ask +Eugene K., avifile author, he has a long mailing with them, because they had +the same problems with avifile. Finally he changed avifile source to +<I>workaround</I> gcc 2.96 bugs... +We simply has no interest and time to do it. +</P> + +<P> +Ah, and about the pipe-in-comment bug: it wasn't really our bug. +I've talked one of gcc maintainers, and he told me that gcc 2.96 and 3.x +supports intel asm syntax, and it caused the pipe bug. But it <I>is</I> a bug, +because gcc <I>silently</I>, without any warning, ignored the whole asm block! +</P> + +<P> +Other gcc 3.x problems comes from broken libstdc++ or glibc header (std_*.h) +installation. They are not our fault. MPlayer compiles and works well with +gcc 3.x versions. <B>Only 2.96 is broken</B>, but it depends on many environment +elements, including gcc 2.96 release number, enabled mplayer features, etc. +<I>If it works for you using gcc 2.96, it doesn't mean it will work for everyone.</I> +</P> + +<P><B>Answer 2:</B></P> + +<P> +Also read <A HREF="users_against_developers.html">this</A> text !!!</P> + +<P> +<B>Question:</B> No! You are wrong! Everything works with gcc 2.96 <I>but</I> MPlayer +</P> + +<P> +<B>Answer:</B> +</P> + +<P> +No. You are wrong! +Several projects (mainly which source contains high optimized inline asm code) +had problems with gcc 2.96. For example: avifile, MESA / DRI, Wine, ffmpeg, lame. +But other projects already workarounded gcc bugs (changed code which +triggered compiler bugs) so they work for now. +</P> + +<P> +<B>Question:</B> No! You are wrong! Everything works with gcc 2.96 <I>including</I> MPlayer +</P> + +<P> +<B>Answer:</B> +</P> + +Good. Be happy. But you must know, it depends on many environment +elements, including gcc 2.96 release number, enabled mplayer features, etc. +<I>If it works for you using gcc 2.96, it doesn't mean it will work for everyone!</I> +It only means that you are lucky, until you find a problem. But don't forget the +<B>No.1 rule of gcc 2.96 users: NEVER REPORT BUGS OR PROBLEMS IF YOU ARE USING GCC 2.96</B> + +<P> +<B>Question:</B> Ok. Understood. But I want to give it a try... how to compile with gcc 2.96? +</P> + +<P> +<B>Answer:</B> Really? Are you sure? Ok. You know... here is it: ./configure --disable-gcc-checking +</P> + +<P> +<B>Question:</B> No! I don't agree with you, because ... +</P> + +<P> +<B>Answer:</B> It doesn't matter. Keep your commets for yourself. We're not interested in gcc 2.96 stories. +</P> + + +</FONT> +</BODY> +</HTML> diff --git a/DOCS/Polish/mencoder.1 b/DOCS/Polish/mencoder.1 new file mode 100644 index 0000000000..aeeaaaa1b2 --- /dev/null +++ b/DOCS/Polish/mencoder.1 @@ -0,0 +1,256 @@ +.\" MEncoder (C) 2000-2001 Arpad Gereoffy <arpi@esp-team.scene.hu> +.\" This manpage was/is done by Gabucino +.\" +.TH MEncoder +.SH NAME +mencoder \- Movie Encoder for Linux +.SH SYNOPSIS +.B mencoder +.RB [ \-vcd\ <track\ number> ] +.RB [ \-dvd\ <titleid> ] +.RB [ \-chapter\ <chapterid> ] +.RB [ \-dvdangle\ <angleid> ] +.RB [ \-dvdkey\ <key> ] +.RB [ \-nobps ] +.RB [ \-aid\ <id> ] +.RB [ \-vid\ <id> ] +.RB [ \-pp\ <quality> ] +.RB [ \-vc\ <video\ codec\ name> ] +.RB [ \-ac\ <audio\ codec\ name> ] +.RB [ \-vfm\ <video\ codec\ family> ] +.RB [ \-afm\ <audio\ codec\ family> ] +.RB [ \-include\ <configfile> ] +.RB [ \-mc\ seconds/5f ] +.RB [ \-v ] +.RB [ \-mp3file\ <filename> ] +.RB [ \-ac3file\ <filename> ] +.RB [ \-ovc\ <video\ codec\ name> ] +.RB [ \-oac\ <audio\ codec\ name> ] +.RB [ \-divx4opts\ <codec\ options> ] +.RB [ \-lameopts\ <codec\ options> ] +.RB [ \-pass\ <1/2> ] +.RB [ \-passlogfile\ <filename> ] +.RB [ \-ofps\ <fps> ] +.RB [ \-o\ <filename> ] +.RB [ \-frames\ <number> ] +.RB [ \-x\ <rescale\ width> ] +.RB [ \-y\ <rescale\ height> ] +.RB [ \-sws\ <0-2> ] +.I - or file or device +.PP +.SH DESCRIPTION +.I mencoder +MEncoder (MPlayer's Movie Encoder) is a simple movie encoder, designed to +encode MPlayer-playable movies (AVI/DVD/VCD/VOB/MPG/MOV/VIV/NET) to other +MPlayer-playable formats (see below). Currently it's in beta stage, and encodes +only to DivX4 (1 or 2 passes) video, PCM/MP3/VBRMP3 audio. Also has stream +copying abilities. In the future, there will be cropping, resizing filters, and +other interesting stuff. +.LP +.SH "GENERAL OPTIONS" +.TP +.I NOTE +Every "flag" option has "noflag" pair, e.g. -flag opposite is -noflag +.TP +.I NOTE +CHECK THE HTML DOCUMENTATION TOO ! +.TP +.B \-vcd <track number> +Encode the specified VCD track. +.TP +.B \-dvd <title number> +Encode the specified DVD title. +.TP +.B \-chapter <chapter id> +Use with -dvd option (see above). Start encoding at the specified chapter. +.TP +.B \-dvdangle <angle id> +Use with -dvd option (see above), and if the DVD disc has multiple angles. +It will encode the angle specified here. +.TP +.B \-dvdkey <key> +Used to decrypt CSS-encrypted streams on hard disk (with given CSS decrypt +key). +.TP +.B \-nobps +Used only for AVIs. Doesn't use the bps value in the AVI header, instead +calculates it. +.TP +.B \-aid <audio stream id> +If the source media contains multiple audio streams (for example DVDs), encode +the specified one. +.TP +.B \-vid <video stream id> +If the source media contains multiple video streams, encode the specified one. +.TP +.B \-pp <value> +Apply a postprocess filter to enhance image quality. (values TODO) +.TP +.B \-vc <codec name> +Use specified codec (according to codecs.conf) for decoding input video +stream. +.TP +.B \-ac <codec name> +Use specified codec (according to codecs.conf) for decoding input audio +stream. +.TP +.B \-vfm <video codec family> +Force decoding by using a specific codec FAMILY, and FALLBACK to default +if failed. For examples see MPlayer manpage. +.TP +.B \-afm <audio codec family> +Force decoding by using a specific codec FAMILY, and FALLBACK to default +if failed. For examples see MPlayer manpage. +.TP +.B \-include +specify config file to be parsed after the default +.TP +.B \-mc\ seconds/5frame +maximum sync correction per 5 frames (in seconds). +Use -mc 0 to disable input A/V sync. +.TP +.B \-v +Increase verbosity. +.TP +.B \-ovc <codecname> +Encode with the given codec (codec names are from codecs.conf). +Examples: + + -ovc help get help + -ovc copy no encoding, just streamcopy + -ovc divx4 encode to DivX4 +.TP +.B \-oac <codecname> +Encode with the given codec (codec names are from codecs.conf). +Examples: + + -oac help get help + -oac copy no encoding, just streamcopy + -oac pcm encode to uncompressed PCM + -oac mp3lame encode to MP3 (using Lame) +.TP +.B \-divx4opts +If encoding to DivX4, you can specify its parameters here, like: + + -divx4opts br=1800:deinterlace:key=250 + +Available options: + + help get help + br=XXX specify bitrate in + kbit <4-16000> or + bit <16001-24000000> + key=XXX maximum keyframe interval + (in frames) + deinterlace enable deinterlacing + (don't use, DivX4 is buggy!) + q=XXXX quality (1-fastest, 5-best) + min_quant=XXX minimum quantizer (0-32) + max_quant=XXX maximum quantizer (0-32) + rc_period=XXX rate control period + rc_reaction_period=XXX rate control + reaction period + rc_reaction_ratio=XXX rate control + reaction ratio + +.TP +.B \-lameopts +If encoding to MP3 with libmp3lame, you can specify its parameters here, like: + + -lameopts br=192 + +Available options: + + help get help + br=XXX specify bitrate in + kbit <0-1024> + (only for CBR) + q=XXX Quality + (0-highest, 9-fastest) + (for VBR) + vbr=XXX variable bitrate method + 0=cbr + 1=mt + 2=rh(default) + 3=abr + 4=mtrh + cbr constant bitrate + mode=XXX 0=stereo + 1=joint-stereo + 2=dualchannel + 3=mono + (default: auto) + padding=XXX 0=no + 1=all + 2=adjust + ratio=XXX compression ratio <1-100> + +.TP +.B \-pass <1/2> +With this you can encode 2pass DivX4 files. First encode with -pass 1, then +with the same parameters, encode with -pass 2. +.TP +.B \-passlogfile <filename> +When encoding in 2pass mode, MEncoder dumps first pass' informations +to the given file instead of the default divx2pass.log . +.TP +.B \-ofps <fps> +The output file will have different frame/sec than the source. +.TP +.B \-o <filename> +Outputs to the given filename, instead of the default 'test.avi' . +.TP +.B \-frames <number> +Encode only given number of frames. +.TP +.B \-x <rescale width> +Rescale output movie to given pixels wide. +.TP +.B \-y <rescale height> +Rescale output movie to given pixels tall. +.TP +.B \-sws (0-2> +Type of scaling method + + 0 fast bilinear + 1 bilinear + 2 bicubic (best quality) + +.SH FILES AND DIRECTORIES +.IP +.SH "EXAMPLES" +.B Encoding DVD title #2 +mencoder -dvd 2 -o title2.avi +.TP +.B Encoding from HTTP +mencoder http://mplayer.hq/example.avi -o example.avi +.TP +.B Encoding from a pipe +rar p test-SVCD.rar | mencoder -divx4opts br=800 -ofps 24 -pass 1 -- - +.TP +.B Encoding multiple *.vob files +cat *.vob | mencoder <options> - +.IP +.SH BUGS +Probably. Check the documentation. + +Bugreports should be addressed to the MPlayer-users mailing list +(mplayer-users@mplayerhq.hu) ! If you want to submit a bugreport +(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 documentation ! + +MPlayer is (C) 2000-2001 +.I Arpad Gereoffy <arpi@thot.banki.hu> + +This manpage is written and maintained by +.I Gabucino . +.LP +.SH STANDARD DISCLAIMER +Use only at your own risk! There may be errors and inaccuracies that could +be damaging to your system or your eye. Proceed with caution, and although +this is highly unlikely, the author doesn't take any responsibility for that! +.\" end of file diff --git a/DOCS/Polish/mplayer.1 b/DOCS/Polish/mplayer.1 new file mode 100644 index 0000000000..8565cec0f9 --- /dev/null +++ b/DOCS/Polish/mplayer.1 @@ -0,0 +1,643 @@ +.\" MPlayer (C) 2000-2001 Arpad Gereoffy <arpi@esp-team.scene.hu> +.\" This manpage was/is done by Gabucino +.\" +.TH MPlayer +.SH NAME +mplayer \- Movie Player for Linux +.SH SYNOPSIS +.B mplayer +.RB [ \-gui ] +.RB [ \-v ] +.RB [ \-quiet ] +.RB [ \-vo\ <driver>[:<device>] ] +.RB [ \-ao\ <driver>[:<device>] ] +.RB [ \-vcd\ track\ number ] +.RB [ \-sb\ byte\ position ] +.RB [ \-nosound ] +.RB [ \-abs\ bytes ] +.RB [ \-delay\ secs ] +.RB [ \-nobps ] +.RB [ \-aid\ id ] +.RB [ \-vid\ id ] +.RB [ \-fps\ rate ] +.RB [ \-mc\ seconds/5f ] +.RB [ \-fs ] +.RB [ \-vm ] +.RB [ \-zoom ] +.RB [ \-x\ x ] +.RB [ \-y\ y ] +.RB [ \-xy\ factor ] +.RB [ \-pp\ quality ] +.RB [ \-include\ configfile ] +.RB [ \-lircconf\ configfile ] +.RB [ \-ffactor\ number ] +.RB [ \-sub\ file ] +.RB [ \-subfps\ rate ] +.RB [ \-subdelay\ sec ] +.RB [ \-z\ <0-8> ] +.RB [ \-idx ] +.RB [ \-forceidx ] +.RB [ \-nodshow ] +.RB [ \-noxv ] +.RB [ \-forcexv ] +.RB [ \-ss\ time ] +.RB [ \-dumpaudio ] +.RB [ \-dumpvideo ] +.RB [ \-dumpstream ] +.RB [ \-noframedrop ] +.RB [ \-framedrop ] +.RB [ \-nodouble ] +.RB [ \-double ] +.RB [ \-stereo\ mode ] +.RB [ \-channels\ n ] +.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 ] +.RB [ \-skin\ skin ] +.RB [ \-aspect\ ratio ] +.RB [ \-monitoraspect\ ratio ] +.RB [ \-subcp\ codepage ] +.RB [ \-dumpmpsub ] +.RB [ \-screenw\ pixels ] +.RB [ \-screenh\ pixels ] +.RB [ \-cache\ kbytes ] +.RB [ \-bpp\ depth ] +.RB [ \-flip ] +.RB [ \-playlist\ <filename> ] +.RB [ \-slave ] +.I - or file or device +.PP +.SH DESCRIPTION +.I mplayer +MPlayer is a movie player for LINUX (runs on many other Unices, and +non-x86 CPUs, see section 6). It plays most MPEG, AVI and ASF/WMV files, +supported by many native and Win32 DLL codecs. You can watch VideoCD, +SVCD, DVD and even DivX movies too (and you don't need the avifile library +at all!). The another big feature of mplayer is the wide range of +supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib, +fbdev, AAlib, but you can use SDL (and this way all drivers of SDL) and +some lowlevel card-specific drivers (for Matrox, 3Dfx and Radeon) too! +Most of them supports software or hardware scaling, so you can enjoy +movies in fullscreen. And what about the nice big antialiased shaded +subtitles (7 supported types!!!) with european/ISO 8859-1,2 (hungarian, +english, czech, etc), cyrillic, korean fonts, and OSD? +.LP +.SH "GENERAL OPTIONS" +.TP +.I NOTE +Every "flag" option has "noflag" pair, e.g. -fs opposite is -nofs +.TP +.B \-gui +start MPlayer with the GUI mode. You have to compile it in, for details +see the documentation. +.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 \-sid\ id +Turns on DVD subtitle displaying. Also, you MUST specify a number which +corresponds to a DVD subtitle language (1-...). For the list of available +subtitles, use with the -v switch and look at the output. (EXPERIMENTAL) +.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 angles to use. Examples can be found below. +.TP +.B \-vo\ <driver>[:<device>] +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). + +you can get the list of available drivers executing +.I mplayer -vo help + +.TP +.B \-ao\ <driver>[:<device>] +select audio output driver and optinaly device. "device" is valid with +SDL too, it means sub-driver then (for example: -vo sdl:esd). + +If using OSS, you can specify which sound device to use like this : +-ao oss:/dev/dsp1 (replaces the old -dsp option) + +you can get the list of available drivers executing +.I mplayer -ao help + +.TP +.B \-vcd\ track +play video cd track from device instead of plain file +.TP +.B \-nosound +don't play sound +.TP +.B \-fs +fullscreen playing (centers movie, and makes black +bands around it) +.TP +.B \-vm +try to change to a different video mode. dga2, x11 (XF86VidMode) and sdl +output drivers support it. +.TP +.B \-zoom +use software scaling, where available (use with -nofs). svga, x11, vesa +output drivers support it. +.TP +.B \-flip +flip image (useful for example for old Indeo codecs). Supported only(?) +by the 'sdl' and 'x11' outputs. +.TP +.B \-x\ x +scale image to x width [if driver suppports!] +.TP +.B \-y\ y +scale image to y height +.TP +.B \-xy\ factor +scale image by <factor> +.TP +.B \-pp\ quality +apply postprocess filter on decoded image. +You need a STRONG CPU in order to use this! +The supported formats and settings are: + + MPEG 1/2 0 (none), TODO + OpenDivX 0 (none), TODO + DivX4 0 (none), TODO + DivX 0 (none), TODO + + -pp 0x20000 TODO + +.TP +.B \-autoq\ quality +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. You don't have to (and don't) use together with -pp ! +.TP +.B \-ffactor\ number +resample alphamap of the font. Can be: + + 0 plain white fonts + 0.75 very narrow black outline [default] + 1 narrow black outline + 10 bold black outline +.TP +.B \-sub\ file +use/display this subtitle file +.TP +.B \-subfps\ rate +specify frame/sec rate of subtitle file +(ONLY for frame-based SUB files, i.e. NOT MicroDVD format!) +(default: the same as the movie) +.TP +.B \-subdelay\ sec +delays subtitles by <sec> seconds. Can be negative. +.TP +.B \-osdlevel\ level +specifies which mode the OSD should start in (0 : none, 1 : seek, 2: seek+timer) +(default = 2) +.TP +.B \-lircconf\ configfile +specifies a configfile for LIRC (see http://www.lirc.org) if you don't like the default ~/.lircrc +.TP +.B \-v +enable verbose output (more -v means more verbose) +.TP +.B \-quiet +display less output, status messages. +.TP +.B \-benchmark +used in combination with -nosound and -vo null for benchmarking. +.TP +.B \-skin skin directory +load skin from this directory (WITHOUT path name!). For example '-skin fittyfene' tries these : + + /usr/local/share/mplayer/Skin/fittyfene + ~/.mplayer/Skin/fittyfene +.TP +.B \-aspect ratio +set aspect ratio of movies. It's autodetected on MPEG files, and can't be +autodetected on AVI files. Examples: + + -aspect 4:3 or -aspect 1.3333 + -aspect 16:9 or -aspect 1.7777 + +(has -noaspect pair) +.TP +.B \-monitoraspect ratio +set aspect ratio of your screen. Examples: + + -monitoraspect 4:3 or 1.3333 + -monitoraspect 16:9 or 1.7777 + +.TP +.B \-playlist <file> +play files according to this filelist (1 file/row). +.TP +.B \-slave +This option switches on slave mode. This is intended for use +of MPlayer as a backend to other programs. Instead of intercepting keyboard +events, MPlayer will read simplistic command lines from its stdin. +See section +.B SLAVE MODE PROTOCOL +for the syntax. +.IP +.SH "ADVANCED OPTIONS" +.TP +.I NOTE +These options can help you solve your particular problem.. Also, see the +documentation ! +.TP +.B \-vc <name> +force usage of a specific video codec, according to its name in codecs.conf, +for example : + + -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 + +See -vc help for FULL list ! +.TP +.B \-ac <name> +force usage of a specific audio codec, according to its name in codecs.conf, +for example : + + -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) + -ac vorbis use libvorbis + -ac ffmp3 use ffmpeg's MP3 decoder (SLOW) + +See -ac help for FULL list ! +.TP +.B \-vfm <1-12> +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/DivX4 codec (YV12) + (same as -vc odivx but fallback) + -vfm 4 use DirectShow (Win32) codecs + -vfm 5 use libavcodec codecs + -vfm 7 use DivX4 codec (YUY2) + (same as -vc divx4 but fallback) + -vfm 10 use XAnim codecs + +See -vc help for FULL list ! + +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-12> +force usage of a specific audio format. For example: + + -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 + -afm 5 use aLaw/uLaw driver + -afm 10 use libvorbis + -afm 11 use ffmpeg's MP3 decoder (even mp1) + +See -ac help for FULL list ! +.TP +.B \-sb\ position +seek to byte position +.TP +.B \-ss\ time +seek to given time position. For example : + + -ss 56 + -ss 01:10:00 + +.TP +.B \-bpp\ depth +use different color depth than autodetect. Not all -vo drivers support +it (fbdev, dga2, svga, vesa). +.TP +.B \-abs\ bytes +sound card audio buffer size (in bytes, default: measuring) +.TP +.B \-delay\ secs +audio delay in seconds (may be +/- float value) +.TP +.B \-nobps +don't use avg. byte/sec value for A-V sync (AVI) +.TP +.B \-aid\ id +select audio channel [MPG: 0-31 AVI: 1-99 ASF: 0-127 VOB: 128-...] +.TP +.B \-vid\ id +select video channel [MPG: 0-15 AVI: -- ] +.TP +.B \-fps\ value +force frame rate (if value is wrong in the header) +.TP +.B \-mc\ seconds/5frame +maximum sync correction per 5 frames (in seconds) +.TP +.B \-ni +force usage of non-interleaved AVI parser +.TP +.B \-include configfile +specify config file to be parsed after the default +.TP +.B \-z\ <0-8> +specifies compression level for PNG output + 0 : no compression + 8 : max compression +.TP +.B \-idx +rebuilds INDEX of the AVI. Useful with broken downloads, or badly +created AVIs. +.TP +.B \-forceidx +force rebuilding of INDEX. Useful for testing, or AVIs with bad +indexes. +.TP +.B \-nodshow +disables usage of DirectShow video codecs +.TP +.B \-noxv +disable XVideo hardware acceleration (with SDL only!) +.TP +.B \-forcexv +force using XVideo (SDL!) +.TP +.B \-dumpaudio +writes audio stream of the file to ./stream.dump (mostly usable +with mpeg/ac3) +.TP +.B \-dumpstream +dumps the file to ./stream.dump . Useful for example +when ripping from DVD. +.TP +.B \-noframedrop +no frame dropping : every frame is played, audio and video may be out of +sync (default) +.TP +.B \-framedrop +frame dropping : decode all frames, video may skip +.TP +.B \-nodouble +disable doublebuffering (default). Currently this is only honoured by the Xv and the DGA driver. +With the DGA driver this also disables OSD support but yields some speed gain. +.TP +.B \-double +enable doublebuffering. Currently this is only honoured by the Xv and the DGA driver. +.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 -dvd option!) +.TP +.B \-stereo mode +select type of MP2/MP3 stereo output. + + Stereo 0 + Left channel 1 + Right channel 2 +.TP +.B \-channels n +select number of audio output channels to be used + + Stereo 2 + Surround 4 + Full 5.1 6 + +Currently this option is only honoured for AC3 audio. +.TP +.B \-srate Hz +specifies Hz to playback audio on. Has effect on playback speed! +.TP +.B \-config configfile +specifies where to search for config file +.TP +.B \-display name +specify the hostname and display number of the X server you want +to display on. For example : -display xtest.localdomain:0 +.TP +.B \-unicode +tells MPlayer to handle the subtitle file as UNICODE. +Contrary: -nounicode +.TP +.B \-utf8 +tells MPlayer to handle the subtitle file as UTF8. +.TP +.B \-fsmode\ mode +This option workarounds some problems when using specific windowmanagers and +fullscreen mode. If you experience fullscreen problems, try changing this +value between 0 and 7. + + -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 <number> frames, then quits. +.TP +.B \-fb\ device +Specifies the framebuffer device to use. By default it uses /dev/fb0 . +Only valid for the fbdev driver. +.TP +.B \-fbmode\ modename +Change videomode to the one that is labelled as <modename> in /etc/fb.modes . +Only valid for the fbdev driver. +.TP +.I NOTE +VESA framebuffer doesn't support mode changing. +.TP +.B \-fbmodeconfig\ filename +Use this config file instead of the default /etc/fb.modes . +Only valid for the fbdev driver. +.TP +.B \-subcp\ codepage +If your system supports iconv(3), you can use this option to +specify codepage of the subtitle. Examples: + + -subcp latin2 + -subcp cp1250 + +.TP +.B \-dumpmpsub +Convert the given subtitle (specified with the -sub switch) to MPlayer's +subtitle format, MPsub. Dumps a dump.mpsub file to current directory. +.TP +.B \-screenw\ pixels +If you use an output driver which can't know the resolution of the screen +(mga/fbdev/x11 and/or TVout) this is where you can specify the horizontal +resolution. +.TP +.B \-screenh\ pixels +If you use an output driver which can't know the resolution of the screen +(mga/fbdev/x11 and/or TVout) this is where you can specify the vertical +resolution. +.TP +.B \-cache\ kbytes +This option specifies how much memory to use when precaching a file/URL . +Especially useful on slow media. Default is off. +.IP +.SH "ALPHA/BETA CODE" +.TP +.I NOTE +These are included in this manpage just for completeness! These may or may NOT +work! If you don't know what are these, you DON'T need these! In either case, +double-check the documentation ! +.TP +.B \-br\ rate +used with '-vo odivx' . +Specifies the bitrate to encode OpenDivx at +(in bits! e.g: 780000). +.TP +.I NOTE +You CAN'T encode sound, only video right now! Don't ask for it, +it's on the TODO list. +.TP +.B \-encode\ file +used with '-vo odivx' . +Specifies the output OpenDivX file. Won't overwrite. +.TP +.B \-dumpvideo +dump video stream to ./stream.dump (only with MPEG-PS) (not very usable) +.IP +.SH KEYBOARD CONTROL +.TP +.I NOTE +These keys may/may not work, depending on your video output driver. +.TP + <- or -> seek backward/forward 10 seconds + +up or down seek backward/forward 1 minute + +pgup/pgdown seek backward/forward 10 minutes + +p or SPACE pause movie (press any key) + +q or ESC stop playing and quit program + ++ or - adjust audio delay by +/- 0.1 second + +/ or * decrease/increase volume + +o toggle OSD: none / seek / seek+timer + +m toggle using master/pcm volume + +z or x adjust subtitle delay by +/- 0.1 second + +(the following keys are valid only when using DirectShow DivX codec, or +the DivX4 codec with -vc divx4) + +1 or 2 adjust contrast + +3 or 4 adjust brightness + +5 or 6 adjust hue + +7 or 8 adjust saturation + +.IP +.SH SLAVE MODE PROTOCOL +If the -slave switch is given, playback is controlled by a +line-based protocol with the following tokens: +.TP + stop pause playback + +play resume playback + +seek <NUM> continue at second NUM + +skip <NUM> skip NUM seconds (may be negative) + +quit exit mplayer + +.IP +.SH FILES AND DIRECTORIES +.TP +.I CONFIG FILES +Settings are stored system-wide in the /etc/mplayer.conf file, +and per-user in $HOME/.mplayer/config. The directory +$HOME/.mplayer and the 'config' are created if doesn't exist. +.TP +.I FONTS +Fonts are searched in $HOME/.mplayer/font. There must be a font.desc +file, and files with .RAW extension. +.TP +.I SUBTITLE FILES +MPlayer currently supports 9 subtitle formats : MicroDVD, SubRip, unnamed, +SAMI (smi), vplayer, RealMedia RT, ssa (Sub Station Alpha), AQT, and our own: MPsub. +Sub files are searched in this priority : (for example /mnt/cdrom/movie.avi) + /mnt/cdrom/movie.sub + (utf/UTF/sub/SUB/srt/SRT/smi/SMI/rt/RT/txt/TXT/ssa/SSA) + $HOME/.mplayer/sub/movie.sub + (utf/UTF/sub/SUB/srt/SRT/smi/SMI/rt/RT/txt/TXT/ssa/SSA) + $HOME/.mplayer/default.sub +.IP +.SH "EXAMPLES" +.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 +.TP +.B Convert subtitle to MPsub (to ./dump.mpsub) +mplayer dummy.avi -sub source.sub -dumpmpsub +.LP +.SH BUGS +Probably. Check the documentation. + +Bugreports should be addressed to the MPlayer-users mailing list +(mplayer-users@mplayerhq.hu) ! If you want to submit a bugreport +(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 documentation ! + +MPlayer is (C) 2000-2001 +.I Arpad Gereoffy <arpi@thot.banki.hu> + +This manpage is written and maintained by +.I Gabucino . +.LP +.SH STANDARD DISCLAIMER +Use only at your own risk! There may be errors and inaccuracies that could +be damaging to your system or your eye. Proceed with caution, and although +this is highly unlikely, the author doesn't take any responsibility for that! +.\" end of file diff --git a/DOCS/Polish/skin-en.html b/DOCS/Polish/skin-en.html new file mode 100644 index 0000000000..720fd77bca --- /dev/null +++ b/DOCS/Polish/skin-en.html @@ -0,0 +1,867 @@ +<html> +<head> +<meta http-equiv=Content-Type content="text/html; charset=iso-8859-1"> +<title>MPlayer skin format</title> +<style type="text/css"> +em.note {color: green} +em.warn {color: red} +</style> +</head> + +<body bgcolor=white text=black> + +<h1 align="center">MPlayer skin format</h1> + +<hr> + +<h2>Contents</h2> + +<ul type=disc> +<li><a href="#intro">1 Introduction</a></li> +<li><a href="#overview">2 Overview</a></li> + <ul type=circle> + <li><a href="#dirs">2.1 Directories</a></li> + <li><a href="#images">2.2 Images</a></li> + <li><a href="#parts">2.3 Parts of a skin</a></li> + <li><a href="#files">2.4 Files</a></li> + </ul> +<li><a href="#skin">3 The <code>skin</code> file</a></li> + <ul type=circle> + <li><a href="#mainwin">3.1 Main window</a></li> + <li><a href="#subwindow">3.2 Subwindow</a></li> + <li><a href="#skinmenu">3.3 Skin menu</a></li> + </ul> +<li><a href="#fonts">4 Fonts</a></li> + <ul type=circle> + <li><a href="#symbols">4.1 Symbols</a></li> + </ul> +<li><a href="#guimsg">Appendix A: GUI messages</a></li> +</ul> + +<hr> + +<div align=center> +Last modified: Sep 10, 2001 +</div> + +<hr> + +<h2><a name="intro">1 Introduction</a></h2> + +The purpose of this document is to describe the MPlayer skin format. +The information contained here might be wrong, for <em>a)</em> it is not me +who wrote the GUI, <em>b)</em> the GUI is not finished, <em>c)</em> I might +be wrong. So do not be surprised if something does not work as described here. + +<p> +Thanks to <em>Zoltán Ponekker</em> for his help. + +<p> +<em>András Mohari <mayday@freemail.hu></em> + + +<h2><a name="overview">2 Overview</a></h2> + +It does not really have anything to do with the skin format, but you should +know that <em>MPlayer has <b>no</b> builtin skin, so <b>at least one skin +must be installed in order to be able to use the GUI.</b></em> + + +<h3><a name="dirs">2.1 Directories</a></h3> + +The directories searched for skins are (in order): +<pre> + /usr/local/share/mplayer/Skin/ + ~/.mplayer/Skin/ +</pre> + +<p> +Note that the first path may vary according to the way MPlayer was configured +(see the <code>--datadir</code> argument of the <code>configure</code> +script). + +<p> +Every skin is installed into its own directory under one of the directories +listed above, for example: +<pre> + /usr/local/share/mplayer/Skin/default/ +</pre> + + +<h3><a name="images">2.2 Image formats</a></h3> + +Images must be truecolor (24 or 32 bpp) and can be in +BMP, PNG and TGA format (note that TGA images must be uncompressed). +<em>The preferred format is PNG as it compresses very well.</em> + +<p> +In the main window (see below) you can use images with `transparency': +regions filled with the color #FF00FF (<font color="#FF00FF">magenta</font>) +are fully transparent when viewed by MPlayer. This means that you can even +have shaped windows if your X server has the XShape extension. + + +<h3><a name="parts">2.3 Parts of a skin</a></h3> + +Skins are quite free-format (unlike the fixed-format skins of +Winamp/XMMS, for example), so it is up to you to create something great. + +<p> +Currently there are three windows to be decorated: the +<a href="#mainwin">main window</a>, the <a href="#subwindow">subwindow</a> and +the <a href="#skinmenu">skin menu</a> (which can be activated by a right +click). + +<ul> +<li> +The <b>main window</b> is where you can control MPlayer. The background of +the window is an image. Various items can (and must) be +placed in the window: <em>buttons</em>, <em>potmeters</em> (sliders, if +you like it better) and <em>labels</em>. For every item, you must +specify its position and size. + +<p> +A <b>button</b> has three states (pressed, released, +disabled), so its image must be divided into three parts vertically. +See the <a href="#main.button">button</a> item for details. +<p> +A <b>potmeter</b> (mainly used for the seek bar and volume/balance +control) can have any number of phases by dividing its image into different +parts below each other. +See <a href="#main.hpotmeter">hpotmeter</a> and +<a href="#main.potmeter">potmeter</a> for details. + +<p> +<b>Labels</b> are a bit special: the characters needed to draw them are taken +from an image file, and the characters in the image are described +by a <a href="#fonts">font description file</a>. +The latter is a plain text file which specifies +the x,y position and size of each character in the image. (So the +image file and its font description file form a font <em>together</em>.) +See <a href="#main.dlabel">dlabel</a> and <a href="#main.slabel">slabel</a> +for details. + +<p> +<em class=note> +<b>Note:</b> all images can have full transparency as described in the +section about <a href="#images">image formats</a>. +</em> +</li> + +<li> +The <b>subwindow</b> is where the movie appears. It can display a specified +image if there is no movie loaded (it is quite boring to have an empty +window :-)) +<em class=note><b>Note:</b> transparency +is <b>not allowed</b> here.</em> +</li> + +<li> +The <b>skin menu</b> is just a way to control MPlayer by means of +menu entries. Two images are required for the menu: one of them is the base +image that shows the menu in its normal state, the other one is used to +display the selected entries. When you pop up the menu, the first image is +shown. If you move the mouse over the menu entries, the currently selected +entry is copied from the second image over the menu entry below the mouse +pointer. (So the second image is never shown in whole.) +<p> +A menu entry is defined by its position and size in the image (see the +section about the <a href="#skinmenu">skin menu</a> for details). +</li> +</ul> + +<p> +There is an important thing not mentioned yet: for buttons, potmeters and +menu entries to work, MPlayer must know what to do if they are clicked. +This is done by <a href="#guimsg">messages</a> (events). For these items +you must define the messages to be genereated when they are clicked. + +<h3><a name="files">2.4 Files</a></h3> + +You need the following files to build a skin. +<ul> +<li> +The configuration file named <a href="#skin">skin</a> tells MPlayer how +to put different parts of the skin together and what to do if you click +somewhere in the window. +</li> +<li>The background image for the main window.</li> +<li>Images for the items in the main window (including one or more font +description files needed to draw labels).</li> +<li>The image to be displayed in the subwindow (optional).</li> +<li>Two images for the skin menu (they are needed only if you want to create +a menu). +</ul> + +With the exception of the skin configuration file, you can name the other +files whatever you want (but note that font description files must have +.fnt extension). + + +<h2><a name="skin">3 The <code><b>skin</b></code> file</a></h2> + +<p> +As mentioned above, this is the skin configuration file. +It is line oriented; comment lines start with a '<code>;</code>' character +at the beginning of the line (only spaces and tabs are allowed before the +'<code>;</code>'). + +<p> +The file is made up of sections. Each section describes the skin for an +application and has the following form: +<table border=1 width="100%"><tr bgcolor=silver><td><pre> +section = <i>section name</i> +. +. +. +end +</pre></td></tr></table> + +<p> +Currently there is only one application, so you need only one section: +its name is <b>movieplayer</b>. + +<p> +Within this section each window is described by a block in the following form: +<table border=1 width="100%"><tr bgcolor=silver><td><pre> +window = <i>window name</i> +. +. +. +end +</pre></tr></td></table> +where <i>window name</i> can be one of these strings: +<ul> +<li><b>main</b> - for the main window</li> +<li><b>sub</b> - for the subwindow</li> +<li><b>menu</b> - for the skin menu</li> +</ul> + +<p> +(The sub and menu block is optional---you do not need to create a menu or +to decorate the subwindow.) + +<p> +Within a window block, you can define each item for the window +by a line in this form: + +<blockquote> +<pre> +item = parameter +</pre> +</blockquote> + +<p> +where <i>item</i> is a string that identifies the type of the GUI item, +<i>parameter</i> is a numeric or textual value (or a list of values +separated by commas). +</p> + +<p> +Putting the above together, the whole file looks something like this: + +<p> +<table border=1 width="100%"><tr bgcolor=silver><td><pre> +section = movieplayer + window = main + ; ... items for main window ... + end + + window = sub + ; ... items for subwindow ... + end + + window = menu + ; ... items for skin menu ... + end +end +</pre></tr></td></table> + +<p> +Finally some words about specifying images for the various items. +<br> +The name of an image file must be given without leading directories--- +images are searched in the directory of the skins. You may (but you need not) +specify the file's extension. If the file doesn't exist, MPlayer tries to +load the file <i><filename>.<ext></i>, where <i>tga</i>, +<i>TGA</i>, <i>bmp</i>, <i>BMP</i>, <i>png</i> and <i>PNG</i> is tried +for <i><ext></i> (in this order). The first matching file will be used. + +<p> + +<table border=1 cellpadding=5 width="100%"><tr bgcolor="#ffffcc"><td> +Here is an example to make this clear. Suppose that you have an image called +<i>main.png</i> that you use for the main window: +<blockquote> +<pre> + base = main, -1, -1 +</pre> +</blockquote> + +MPlayer tries to load <i>main</i>, <i>main.tga</i>, <i>main.TGA</i>, +<i>main.bmp</i> etc, so <i>main.png</i> will be found. +<br> +If (by accident) you wrote +<blockquote> +<pre> + base = main.bmp, -1, -1 +</pre> +</blockquote> +then <i>main.bmp</i>, <i>main.bmp.tga</i>, <i>main.bmp.TGA</i>, +<i>main.bmp.bmp</i> would be searched and MPlayer would finally give up +because there is no <i>main.bmp</i> in the directory, but <i>main.png</i>. +</td></tr></table> + + +<h3><a name="mainwin">3.1 Main window</a></h3> + +Below you can see the list of items that can be used in the +'<code>window = main</code>' . . . '<code>end</code>' block. + +<dl> +<dt><a name="main.base"> +<b>base = <i>image, x, y</i></b> +</a></dt> +<dd> +Lets you specify the background image to be used for the main window. +The window will appear at the given <i>x</i>,<i>y</i> position +on the screen (0,0 is the top left corner). You can specify -1 for center +and -2 for right (x) and bottom (y). The window will be as large as the image. +<p> +<em class=warn> +<b>Warning:</b> transparent regions in the image (colored #FF00FF) appear +black on X servers without the XShape extension. +</em> +</dd> +</dl> + +<dl> +<dt><a name="main.button"> +<b>button = <i>image, x, y, width, height, message</i></b></a></dt> +<dd> +Place a button of <i>width</i> * <i>height</i> size at the +<i>x</i>,<i>y</i> position. The specified message is generated when +the button is clicked. +The image given by <i>image</i> must have three parts below each other +(according to the possible states of the button), like this: +<div align=center><table><tr><td><pre><small> ++------------+ +| pressed | ++------------+ +| released | ++------------+ +| disabled | ++------------+ +</small></pre></td></tr></table></div> +</dd> +</dl> + +<dl> +<dt><a name="main.decoration"> +<b>decoration = enable|disable</b> +</a></dt> +<dd> +Enable or disable window manager decoration of the main window. Default +is <b>disable</b>. +</dd> +</dl> + +<dl> +<dt> +<a name="main.hpotmeter"> +<b> +hpotmeter = <i>butt, bw,bh, phases, numphases, default, x, y, w, h, msg</i> +</b> +</a> +</dt> +<dd> +Place a horizontal potmeter of <i>w</i> * <i>h</i> size at the +<i>x</i>,<i>y</i> position. The image can be divided into +different parts for the different phases of the potmeter (for example, +you can have a pot for volume control that turns from green to red +while its value changes from the minimum to the maximum.) +hpotmeter can have a button that can be dragged horizontally. +The parameters are: +<ul> +<li><i>butt</i> - the image to be used for the button +(must have three parts below each other, like in case of +<a href="#main.button">button</a>)</li> +<li><i>bw</i>, <i>bh</i> - size of the button</li> +<li><i>phases</i> - The image to be used for the different phases of the +hpotmeter. The image must be divided into <i>numphases</i> parts vertically +(see below). A special value of <kbd>NULL</kbd> can be used if you want +no such image. +</li> +<li><i>numphases</i> - number of phases stored in the <i>phases</i> +image</li> +<li><i>default</i> - default value for hpotmeter (in the range 0 to +100)</li> +<li><i>x</i>, <i>y</i> - position for the hpotmeter</li> +<li><i>w</i>, <i>h</i> - width and height of the hpotmeter</li> +<li><i>msg</i> - the message to be generated when the value of hpotmeter +is changed</li> +</ul> +The image used for the different phases must look something like this: +<div align=center><table border=0><tr><td><pre><small> ++------------+ +| phase #1 | ++------------+ +| phase #2 | ++------------+ + ... ++------------+ +| phase #n | ++------------+ +</small></pre></td></tr></table></div> +<em class=note> +<b>Note:</b> there will be a vpotmeter item too, but is it not implemented +yet. +</em> +</dd> +</dl> + +<dl> +<dt><a name="main.potmeter"> +<b>potmeter = <i>phases, numphases, default, x, y, w, h, msg</i></b> +</a></dt> +<dd> +A potmeter without a button. (I guess it is ment to be turned round, +but it reacts to horizontal dragging only.) +For the description of the parameters see +<a href="#main.hpotmeter">hpotmeter</a>. <i>phases</i> can be +<code>NULL</code>, but its quite useless, since you can not see where +the potmeter is set. +</dd> +</dl> + +<dl> +<dt><a name="main.font"> +<b>font = <i>fontfile, fontid</i></b> +</a></dt> +<dd> +Defines a font. <i>fontfile</i> is the name of a font description file +with <code>.fnt</code> extension (<b>no need</b> to specify the extension +here). +<i>fontid</i> is used to refer to the font +(see <a href="#main.dlabel">dlabel</a> and <a href="#main.slabel">slabel</a>). +Up to 25 fonts can be defined. +</dd> +</dl> + +<dl> +<dt><a name="main.dlabel"> +<b>dlabel = <i>x, y, length, align, fontid, "text"</i></b> +</a></dt> +<dd> +Place a dynamic label at the <i>x</i>,<i>y</i> position. The label is called +dynamic because its text is refreshed periodically. +The maximum length of the label is given by <i>length</i> (its height is the +height of a character). +If the text to be displayed is wider than that, then it will be +scrolled, otherwise it is aligned within the specified space by the value +of the <i>align</i> parameter: 0 is for right, 1 is for center, +2 is for left. +<br> +The text to be displayed is given by <i>text</i>: it must be written between +double quotes (<code>"</code>) (but the <code>"</code> cannot be part of the +text). The label is displayed using the font identified by <i>fontid</i>. +You can use the following variables in the text. + +<div align=center> +<table valign=top border=1> +<tr align=center><th>Variable</th><th align=left>Meaning</th></tr> +<tr><td align=center><kbd>$1</kbd></td> + <td>play time in <em>hh:mm:ss</em> format</td></tr> +<tr><td align=center><kbd>$2</kbd></td> + <td>play time in <em>mmmm:ss</em> format</td></tr> +<tr><td align=center><kbd>$3</kbd></td> + <td>play time in <em>hh</em> format (hours)</td></tr> +<tr><td align=center><kbd>$4</kbd></td> + <td>play time in <em>mm</em> format (minutes)</td></tr> +<tr><td align=center><kbd>$5</kbd></td> + <td>play time in <em>ss</em> format (seconds)</td></tr> +<tr><td align=center><kbd>$6</kbd></td> + <td>movie's length in <em>hh:mm:ss</em> format</td></tr> +<tr><td align=center><kbd>$7</kbd></td> + <td>movie's length in <em>mmmm:ss</em> format</td></tr> +<tr><td align=center><kbd>$8</kbd></td> + <td>play time in <em>h:mm:ss</em> format</td></tr> +<tr><td align=center><kbd>$v</kbd></td> + <td>volume in <em>xxx.xx%</em> format</td></tr> +<tr><td align=center><kbd>$V</kbd></td> + <td>volume in <em>xxx.x</em> format</td></tr> +<tr><td align=center><kbd>$b</kbd></td> + <td>balance in <em>xxx.xx%</em> format</td></tr> +<tr><td align=center><kbd>$B</kbd></td> + <td>balance in <em>xxx.x</em> format</td></tr> +<tr><td align=center><kbd>$$</kbd></td> + <td>the <kbd>$</kbd> character</td></tr> +<tr><td align=center><kbd>$a</kbd></td> + <td>a character according to the audio type (none: <code>n</code>, + mono: <code>m</code>, stereo: <code>t</code>)</td></tr> +<tr><td align=center><kbd>$t</kbd></td> + <td>track number (in playlist)</td></tr> +<tr><td align=center><kbd>$o</kbd></td> + <td>filename</td></tr> +<tr><td align=center><kbd>$f</kbd></td> + <td>filename in lower case</td></tr> +<tr><td align=center><kbd>$F</kbd></td> + <td>filename in upper case</td></tr> +<tr><td align=center><kbd>$T</kbd></td> + <td>a character according to the stream type (file: <code>f</code>, + video CD: <code>v</code>, DVD: <code>d</code>, URL: <code>u</code>) + </td></tr> +<tr><td align=center><kbd>$p</kbd></td> + <td>the "p" character (if a movie is playing and the font has the "p" + character) + </td></tr> +<tr><td align=center><kbd>$s</kbd></td> + <td>the "s" character (if the movie is stopped and the font has the "s" + character) + </td></tr> +<tr><td align=center><kbd>$e</kbd></td> + <td>the "e" character (if playback is paused and the font has the "e" + character) + </td></tr> +</table></div> +<p> +<b>Note:</b> The <kbd>$a</kbd>, <kbd>$T</kbd>, <kbd>$p</kbd>, <kbd>$s</kbd> +and <kbd>$e</kbd> variables all return characters that should be displayed +as special symbols (for example, "e" is for the pause symbol that usually +looks something like <code>||</code>). You should have a font for normal +characters and a different font for symbols. +See the section about <a href="#symbols">symbols</a> for more information. +</dd> +</dl> + +<dl> +<dt><a name="main.slabel"> +<b>slabel = <i>x, y, fontid, text</i></b> +</a></dt> +<dd> +Place a static label at the <i>x</i>,<i>y</i> position. +<i>text</i> is displayed using the font identified by <i>fontid</i>. +The text is just a raw string ($x variables do not work) that must be enclosed +between double quotes (the <code>"</code> cannot be part of the text). +The label is displayed using the font identified by <i>fontid</i>. +</dd> +</dl> + + +<h3><a name="subwindow">3.2 Subwindow</a></h3> + +The following items can be used in the +'<code>window = sub</code>' . . . '<code>end</code>' block. + +<dl> +<dt><a name="sub.base"> +<b>base = <i>image, x, y, width, height</i></b> +</a></dt> +<dd> +The image to be displayed in the window. +The window will appear at the given <i>x</i>,<i>y</i> position +on the screen (0,0 is the top left corner). You can specify -1 for center +and -2 for right (x) and bottom (y). The window will be as large as the image. +<i>width</i> and <i>height</i> gives the size of the window; they are +optional (if they are missing, the window is the same size as the image). +</dd> +</dl> + +<dl> +<dt><a name="sub.background"> +<b>background = <i>r, g, b</i></b> +</a></dt> +<dd> +Lets you set the background color. It is useful if the image is smaller than +the window. +<i>r</i>, <i>g</i> and <i>b</i> specifies the red, green and blue +component of the color (each of them is a decimal number from 0 to 255). +</dd> +</dl> + + +<h3><a name="skinmenu">3.3 Skin menu</a></h3> + +As mentioned earlier, the menu is displayed using two images. +Normal menu entries are taken from the image specified by the <i>base</i> +item, while the currently selected entry is taken from the image specified +by the <i>selected</i> item. +You must define the position and size of each menu entry by the <i>menu</i> +item. + +<p> +These are the items that can be used in the '<code>window = menu</code>' +. . . '<code>end</code>' block. + +<dl> +<dt><a name="menu.base"> +<b>base = <i>image</i></b> +</a></dt> +<dd> +The image for normal menu entries. +</dl> +</dd> + +<dl> +<dt><a name="menu.selected"> +<b>selected = <i>image</i></b> +</a></dt> +<dd> +The image showing the menu with all entries selected. +</dd> +</dl> + +<dl> +<dt><a name="menu.menu"> +<b>menu = <i>x, y, width, height, message</i></b> +</a></dt> +<dd> +Defines the <i>x</i>,<i>y</i> position and the size of a menu entry in +the images. <i>message</i> is the message to be generated when +the mouse button is released over the entry. +</dd> +</dl> + + +<h2><a name="fonts">4 Fonts</a></h2> + +As mentioned in the section about the parts of a skin, a font is defined +by an image and a description +file. You can place the characters anywhere in the image, but make sure that +their position and size is given in the description file exactly. + +<p> +The font description file (with .fnt extension) can have comment +lines starting with '<code>;</code>'. +The file must have a line in the form +<blockquote> +<pre> +image = <i>image</i> +</pre> +</blockquote> + +<p> +where <i>image</i> is the name of the image file to be used for +the font (you do not have to specify the extension). +The above line is followed by character definition lines of the form: + +<blockquote> +<pre> +"<i>char</i>" = <i>x, y, w, h</i> +</pre> +</blockquote> + +<p> +Here <i>x</i> and <i>y</i> specifies the position of the +<i>char</i> character in the image (0,0 is the upper left corner). +<i>w</i> and <i>h</i> is the width and height of the character +(in pixels, of course). + +<p> +Here is an example that defines the A, B, C characters using font.png. +<table width="100%" border=1><tr bgcolor=silver><td><pre> +; can be "font" instead of "font.png" +image = font.png + +; Three characters are enough for demonstration only. :-) +"A" = 0,0, 7,13 +"B" = 7,0, 7,13 +"C" = 14,0, 7,13 +</pre></td></tr></table> + + +<h3><a name="symbols">4.1 Symbols</a></h3> + +Some characters have special meanings when returned by some of the variables +used in +<a href="#main.dlabel">dlabel</a>; these characters are meant to be +displayed as symbols. (For example, in case of a DVD stream, you could display +a nice DVD logo instead of the character 'd'.) + +<p> +The following table lists all the characters that can be used to display +symbols (and thus require a different font). + +<div align=center> +<table> +<tr><th align=center>Character</th><th align=left>Symbol</th></tr> +<tr><td align=center><kbd>p</kbd></td> + <td align=left>play</td></tr> +<tr><td align=center><kbd>s</kbd></td> + <td align=left>stop</td></tr> +<tr><td align=center><kbd>e</kbd></td> + <td align=left>pause</td></tr> +<tr><td align=center><kbd>n</kbd></td> + <td align=left>no sound</td></tr> +<tr><td align=center><kbd>m</kbd></td> + <td align=left>mono sound</td></tr> +<tr><td align=center><kbd>t</kbd></td> + <td align=left>stereo sound</td></tr> +<tr><td align=center><kbd>f</kbd></td> + <td align=left>stream is a file</td></tr> +<tr><td align=center><kbd>v</kbd></td> + <td align=left>stream is a video CD</td></tr> +<tr><td align=center><kbd>d</kbd></td> + <td align=left>stream is a DVD</td></tr> +<tr><td align=center><kbd>u</kbd></td> + <td align=left>stream is a URL</td></tr> +</table> +</div> + +<p> +<b>Note:</b> currently only 'p', 's', 'e', 'n', 'm' and 't' is used. +</p> + +<h2><a name="guimsg">Appendix A: GUI messages</a></h2> + +These are the messages that can be generated by buttons, potmeters and +menu entries. + +<p> +<em class=note> +<b>Note:</b> some of the messages might not work as expected (or not +work at all). As you know, the GUI is under development.</em> + +<p> +<i>Playback control:</i> +<blockquote> +<dl> +<dt><b>evNext</b> +<dd>Jump to next track in the playlist. + +<dt><b>evPause</b> +<dd>Pause playing. + +<dt><b>evPauseSwitchToPlay</b> +<dd>Forms a switch together with <i>evPlaySwitchToPause</i>. They can be +used to have a common play/pause button. Both messages should be assigned +to buttons displayed at the very same position in the window. This +message pauses playing and the image for the <i>evPlaySwitchToPause</i> button +is displayed (to indicate that the button can be pressed to continue playing). + +<dt><b>evPlay</b> +<dd>Start playing. + +<dt><b>evPlaySwitchToPause</b> +<dd>The opposite of <i>evPauseSwitchToPlay</i>. This message starts playing +and the image for the <i>evPauseSwitchToPlay</i> button is displayed (to +indicate that the button can be pressed to pause playing). + +<dt><b>evPrev</b> +<dd>Jump to previous track in the playlist. + +<dt><b>evStop</b> +<dd>Stop playing. +</dl> +</blockquote> + +<p> +<i>Seeking in the stream:</i> +<blockquote> +<dl> +<dt><b>evBackward10sec</b> +<dt><b>evBackward1min</b> +<dt><b>evBackward10min</b> +<dd>Seek backward 10 seconds / 1 minute / 10 minutes. + +<dt><b>evForward10sec</b> +<dt><b>evForward1min</b> +<dt><b>evForward10min</b> +<dd>Seek forward 10 seconds / 1 minute / 10 minutes. + +<dt><b>evSetMoviePosition</b> +<dd>Seek to position (can be used by a potmeter; the relative +value (0-100%) of the potmeter is used). +</dl> +</blockquote> + +<p> +<i>Video control:</i> +<blockquote> +<dl> +<dt><b>evDoubleSize</b> +<dd>Set the movie window to double size. + +<dt><b>evFullScreen</b> +<dd>Switch fullscreen mode on/off. + +<dt><b>evNormalSize</b> +<dd>Set the movie window to its normal size. +</dl> +</blockquote> + +<p> +<i>Audio control:</i> +<blockquote> +<dl> +<dt><b>evDecAudioBufDelay</b> +<dd>Decrease audio buffer delay. + +<dt><b>evDecBalance</b> +<dd>Decrease balance. + +<dt><b>evDecVolume</b> +<dd>Decrease volume. + +<dt><b>evIncAudioBufDelay</b> +<dd>Increase audio buffer delay. + +<dt><b>evIncBalance</b> +<dd>Increase balance. + +<dt><b>evIncVolume</b> +<dd>Increase volume. + +<dt><b>evMute</b> +<dd>Mute/unmute the sound. + +<dt><b>evSetBalance</b> +<dd>Set balance (can be used by a potmeter; the relative +value (0-100%) of the potmeter is used). + +<dt><b>evSetVolume</b> +<dd>Set volume (can be used by a potmeter; the relative +value (0-100%) of the potmeter is used). +</dl> +</blockquote> + +<p> +<i>Miscellaneous:</i> +<blockquote> +<dl> +<dt><b>evAbout</b> +<dd>Open the about window. + +<dt><b>evEqualeaser</b> +<dd>Turn the equalizer on/off. + +<dt><b>evExit</b> +<dd>Quit from the program. + +<dt><b>evIconify</b> +<dd>Iconify the window. + +<dt><b>evLoad</b> +<dd>Load a file (by opening a file browser window, where you can choose a +file). + +<dt><b>evLoadPlay</b> +<dd>Does the same as <i>evLoad</i>, but it automatically starts +playing after the file is loaded. + +<dt><b>evNone</b> +<dd>Empty message, it has no effect. (Except maybe in CVS versions. :-)) + +<dt><b>evPlayList</b> +<dd>Open/close the playlist window. + +<dt><b>evPreferences</b> +<dd>Open the preferences window. + +<dt><b>evSkinBrowser</b> +<dd>Open the skin browser window. +</dl> +</blockquote> + +</body> +</html> diff --git a/DOCS/Polish/sound.html b/DOCS/Polish/sound.html new file mode 100644 index 0000000000..ee487744d9 --- /dev/null +++ b/DOCS/Polish/sound.html @@ -0,0 +1,127 @@ +<HTML> +<BODY BGCOLOR=white> + +<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + +<P><B><A NAME=2.3.2>2.3.2. Audio output devices</A></P></B> + +<P><B>MPlayer</B>'s audio interface is called <I>libao2</I>. It currently +contains these drivers :</P> + +<TABLE BORDER=0> + +<TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>General:</B></P></TD> + +<TR><TD> </TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>oss</TD><TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS (ioctl) driver</TD></TR> +<TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>sdl</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>SDL driver (supports up/downsampling, <B>ESD</B>, <B>ARTS</B> etc)</TD></TR> +<TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>nas</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>NAS (Network Audio System) driver</TD></TR> +<TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>alsa5</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>native ALSA 0.5 driver</TD></TR> +<TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>alsa9</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>native ALSA 0.9 driver (works, but has problems -> use OSS)</TD></TR> +<TR><TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>sun</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>SUN audio driver (/dev/audio) for BSD and Solaris8 users</TD></TR> + +</TABLE> + +<P>The fact is, Linux soundcard drivers are usually shit, and always as +incompatible as they can be. It MAY take a while to find your optimal settings.</P> +<P><UL> +<LI>if you have OSS as driver, first try with <I>-ao oss</I> (this is the default). +If you experience glitches, halts or anything out of the ordinary, have a +look at <I>-ao sdl</I> (NOTE: of course you'll have to have a new SDL library and its +devel pair installed). It helps in a lot of cases (it also supports ESD, ARTS, and +up/downsampling. /esd is GNOME's, arts is KDE's sound daemon/).</LI> +<LI>if you have ALSA version 0.5, then you ALMOST always have to use <I>-ao alsa5</I> , +since 0.5 has buggy OSS emulation code, and will <B>crash MPlayer</B> with +a message like this:<BR> + <UL> + <CODE>DEMUXER: Too many (945 in 8390980 bytes) video packets in the buffer!</CODE></UL> +</LI> +<LI>if you have ALSA version 0.9, use <I>-ao oss</I> or <I>-ao sdl</I> as you +wish. You can also use <I>-ao alsa9</I> as it works now, however it has many +problems (losing sync, disappearing audio, etc).</LI> +</UL></P> + +<P>On <B>Solaris/FreeBSD</B> systems, use the SUN audio driver with the +<I>-ao sun</I> option, otherwise you'll have no video, nor audio playing.</P> + +<P><B><A NAME=2.3.2.1>2.3.2.1. Soundcard experiences, recommendations</A></B></P> + +<P><TABLE BORDER=0 WIDTH=100%> +<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>VIA onboard chipset (via82cxxx) 48Khz only</B></TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Driver:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> from <A HREF="http://sourceforge.net/project/showfiles.php?group_id=3242&release_id=59602">here</A></TD><TR> + +<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Aureal Vortex 2</B></TD><TR> +<TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>no driver</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS/Pro:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>no driver</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD>48</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Driver:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><A HREF="http://aureal.sourceforge.net">aureal.sourceforge.net</A></TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Driver2:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> from <A HREF="http://makacs.poliod.hu/~pontscho/aureal/au88xx-1.1.3.tar.bz2">here</A><BR> +(<I>buffer size increased to 32k</I>)</TD><TR> + +<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>GUS PnP</B></TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>no driver</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS/Pro:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>48</TD><TR> + +<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>SB Live!</B></TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>(?)</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>48</TD><TR> + +<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>SB AWE 64</B></TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>max 44kHz</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>48kHz sounds shit</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>48</TD><TR> + +<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Gravis UltraSound ACE</B></TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>max 44Khz. <I>not OK</I></TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>48</TD><TR> + +<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Gravis UltraSound MAX</B></TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK (?)</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>48</TD><TR> + +<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ESS 688</B></TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK (?)</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>48</TD><TR> + +<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>C-Media cards (which ones?)</B></TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>not OK (hissing) (?)</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK (?)</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>?</TD><TR> + +<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Yamaha cards (*ymf*)</B></TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>not OK (?) (maybe -ao sdl)</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK only with ALSA 0.5 with OSS emulation <B>AND</B> <I>-ao sdl</I> (!) (?)</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>?</TD><TR> + +<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Cards with envy24 chips (like Terratec EWS88MT)</B></TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>?</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS/Pro:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>?</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>?</TD><TR> + +<TD COLSPAN=3><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>PC Speaker or DAC</B></TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OSS:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>OK (<I>use the SDL driver : -ao sdl</I>)</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>ALSA:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>no driver</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Max kHz:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>the driver emulates 44.1 maybe more</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>Driver:</TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2><A HREF="ftp://ftp.infradead.org/pub/pcsp">ftp://ftp.infradead.org/pub/pcsp</A></TD><TR> +</TABLE></P> + +<P><UL> +<LI>on Linux, use at least kernel 2.4 if possible, 2.2 isn't tested +<LI>if sound clicks when playing from CD-ROM, turn on IRQ unmasking ! + for example "hdparm -u1 /dev/cdrom" (see "man hdparm" !!!) + This is recommended anyways... (for XMMS, etc...) + Read section <A HREF="cd-dvd.html#4.1">4.1</A>. +<LI>don't use your soundcard by other application ( for ex. XMMS ) ! + if you use ESD, start MPlayer with the '-vo sdl:esd' option ! +<LI>Please tell us how MPlayer and your soundcard(s) worked together! +</UL></P> + +</BODY> +</HTML> diff --git a/DOCS/Polish/users_against_developers.html b/DOCS/Polish/users_against_developers.html new file mode 100644 index 0000000000..4b43372264 --- /dev/null +++ b/DOCS/Polish/users_against_developers.html @@ -0,0 +1,128 @@ +<HTML> +<BODY BGCOLOR=white> + +<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + +<P><B><I>In medias res</I></B></P> + +<P>There are two major topic which always causes huge dispute and flame on the +<A HREF="http://www.MPlayerHQ.hu/cgi-bin/htsearch">mplayer-users</A> +mailing list. Number one is of course the topic of the</P> + +<P><B><I>GCC 2.96 series</I></B></P> + +<P><B>Also read <A HREF="gcc-2.96-3.0.html">this</A> text !!!</B></P> + +<P>The <I>background</I> : there were/are the GCC <B>2.95</B> series. The +best of them was 2.95.3 . Please note the style of the version numbering. +This is how the GCC team numbers their compilers. The 2.95 series are good. +We never ever saw anything that was miscompiled because of the 2.95's faultiness.</P> + +<P>The <I>action</I> : <B>RedHat</B> started to include a GCC version of <B>2.96</B> +with their distributions. Note the version numbering. This should be the GCC +team's versioning. They patched the CVS version of GCC (something between 2.95 and 3.0) +They patched it very deep, and used this version in the distrib because 3.0 +wasn't out at time, and they wanted IA64 support ASAP (business reasons). +Oh, and GCC 2.95 miscompiles bash on the s390 architecture (there is +no RedHat distribution for s390..) .</P> + +<P>The <I>facts</I> : <B>MPlayer</B>'s compile process needs the +<CODE>--disable-gcc-checking</CODE> to proceed upon detecting a GCC version of +2.96 (apparently it needs this option on <B>egcs</B> too. It's because we don't +test <B>MPlayer</B> on egcs. Pardon us, but we rather develop <B>MPlayer</B>). +If you know <B>MPlayer</B>, you should know that it has great speed. It +achieves this by having overoptimized MMX/SSE/3DNow/etc codes, fastmemcpy, and +lots of other features. <B>MPlayer</B> contained MMX/3DNow instructions in a +syntax that all Linux compilers accept it... except RedHat's GCC (it's more +standard compliant). It simply <B><I>skips</I></B> them. It doesn't give +errors. It doesn't give warnings. <B>And</B>, there is Lame. With gcc 2.96, its quality check +(<CODE>make test</CODE> after compiling) <I>doesn't even run !!!</I> +But hey, it compiles bash on s390 and IA64.</P> + +<P>The <I>statements</I> : most developers around the world begun having +bad feelings about RedHat's GCC 2.96 , and told their RedHat users to +compile with other compiler than 2.96 . RedHat users' disappointment slowly +went into anger. What was all good +for, apart from giving headaches to developers, putting oil on anti-RedHat +flame, confusing users? The answer, I do not know.</P> + +<P><I>Present age, present time</I> : RedHat says that GCC 2.96-85 and above +is fixed, and works properly. Note the versioning. They should have started +with something like this. What about GCC 2.96.85 ? It doesn't matter now. +I don't search, but I still see bugs with 2.96 . It doesn't matter now, +hopefully now <B>RedHat will forget about 2.96</B> and turn towards <B>3.0</B>. +Towards a deep patched 3.0... +</P> + +<P><I>What I don't understand</I> is why are we hated by RedHat users for +putting warning messages, and stay-away documents in <B>MPlayer</B> . +Why are we called "brain damaged", "total asshole", "childish" by +<B>RedHat users</B>, on our mailing list, and even on the <B>redhat-devel</B> . +They even considered forking <B>MPlayer</B> for themselves. RedHat users. +Why? It's RedHat that made the compiler, why do <U>you</U> have to hate us? +Are you <U>that</U> fellow RedHat worshippers? Please stop it. We don't hold +a grudge against users, doesn't matter how loud you advertise its contrary. +Please go flame Linus Torvalds, the DRI developers (oh, now I know why +there were laid off by VA!), the Wine, avifile. Even if we are arrogant, +are we not the same as the previously listed ones? Why do <B>we</B> have +to suffer from your unrightful wrath?</P> + +<P>I'm closing this topic. Think over it please. I (Gabucino) personally begun +with <A HREF="http://www.redhat.com">RedHat</A>, then used Mandrake (sorry I +don't know their URL), now I have <A +HREF="http://www.linuxfromscratch.com">LFS</A>. Never held a grudge against +RedHat or RedHat users, and I still don't. Hate is only comfortable. It +won't bring you anywhere.</P> + +<P><B><I>Binary distribution of MPlayer</I></B></P> + +<P>Tons of users asked us about this. For example Debian users tend to say: Oh, +I can <CODE>apt-get install avifile</CODE>, why should I <B>compile MPlayer</B> ? +While this may sound reasonable, the problem lies a bit deeper than +those-fuckin-MPlayer-developers-hate-gcc-2.96-and-RedHat-and-Debian.</P> + +<P>Reasons: <B>Law</B></P> + +<P><B>MPlayer</B> describes the <U>sourcecode</U>. It contains several files with incompatible +licenses especially on the redistribution clauses. As source files, they are +allowed to coexist in a same project.</P> + +<P>Therefore, <U>NEITHER BINARIES NOR BINARY PACKAGES OF <B>MPlayer</B> ARE ALLOWED TO EXIST SINCE +SUCH OBJECTS BREAK LICENSES</U>. PEOPLE WHO DISTRIBUTE SUCH BINARY PACKAGES ARE +DOING ILLEGAL ACTIVITIES.</P> + +<P>So if you know somebody who maintains a binary package then forward her/him +this text and (ask him to) contact us. What (s)he is doing is illegal and IT IS +NO LONGER <B>MPlayer</B>, but <U>his/her</U> mplayer. If it breaks, it is +his/her fault. Don't come and cry on the <B>MPlayer</B> mailing lists, you will +most likely be blacklisted.</P> + +<P>For example that french guy called <B>Christian Marillat</B> who denied our +request, and is still distributing binary Debian packages of <B>MPlayer</B>, +despite the fact that there was at least one user who downloaded it and failed +(of course compiling from source helped him). And there is <B>Guillaume +Rousse</B>, who is doing the same, but making RPMs for Mandrake. Do not support +criminals!</P> + +<P>Reasons: <B>Technical</B></P> + +<P> +<UL> + <LI><B>MPlayer's</B> speed (MMX, SSE, fastmemcpy, etc) optimizations are + determined during compilation. Thus a compiled binary contains very + processor-specific code. An <B>MPlayer</B> binary compiled for K6 will die + on Pentiums and vice versa. This has to be workarounded by runtime + detection, which is not an easy thing to do becase it causes massive speed + decrease. If you don't believe (it was explained in details 10000 times on + mplayer-users, search the archive), solve it and send us a patch. Someone + begun work on it, but disappeared since then.</LI> + <LI><B>MPlayer's</B> video/audio system is not plugin based. It is compiled + into the binary, thus making the binary depend on various libraries (the + GUI depends on GTK, DivX4 depends on libdivxdecore, SDL depends on libSDL, + every SDL release contains an unique bug that has to be workarounded during + compiletime, X11 output compiles differently for X3 and X4, etc). You may + say: yes, let's make 30 versions of downloadable binaries! We won't. We + will make these stuff pluggable in the future.</LI> +</UL> + +</HTML> diff --git a/DOCS/Polish/video.html b/DOCS/Polish/video.html new file mode 100644 index 0000000000..7c071f028c --- /dev/null +++ b/DOCS/Polish/video.html @@ -0,0 +1,1005 @@ +<HTML> +<BODY BGCOLOR=white> + +<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> + +<P><B><A NAME=2.3.1>2.3.1. Video output devices</A></B></P> + +<TABLE BORDER=0> + +<TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>General:</B></P></TD><TR> + +<TD> </TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, + sans-serif" size=2><A HREF=#2.3.1.13>x11</A></TD><TD> </TD><TD><FONT + face="Verdana, Arial, Helvetica, sans-serif" size=2>X11 with optional SHM + extension</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2><A HREF=#2.3.1.2>xv</A></TD><TD></TD><TD><FONT face="Verdana, Arial, + Helvetica, sans-serif" size=2>X11 using overlays with the Xvideo extension + (hardware YUV & scaling)</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2><A HREF=#2.3.1.10>gl</A></TD><TD></TD><TD><FONT face="Verdana, Arial, + Helvetica, sans-serif" size=2>OpenGL renderer, so far works only with: +<UL><LI>all cards with Utah-GLX +<LI>Matrox cards with X/DRI >=4.0.3 +<LI>Radeon with X/DRI CVS</UL></TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2><A HREF=#2.3.1.3>dga</A></TD><TD></TD><TD><FONT face="Verdana, Arial, + Helvetica, sans-serif" size=2>X11 DGA extension</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2><A HREF=#2.3.1.6>fbdev</A></TD><TD></TD><TD><FONT face="Verdana, Arial, + Helvetica, sans-serif" size=2>Output to general framebuffers</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2><A HREF=#2.3.1.5>svga</A></TD><TD></TD><TD><FONT face="Verdana, Arial, + Helvetica, sans-serif" size=2>Output to SVGAlib</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2><A HREF=#2.3.1.4>sdl</A></TD><TD></TD><TD><FONT face="Verdana, Arial, + Helvetica, sans-serif" size=2> + <CODE>1.1.7:</CODE> supports software scaling<BR> + <CODE>1.1.8:</CODE> supports Xvideo (hardware scaling/fullscreen)<BR> + <CODE>1.2.0:</CODE> supports AAlib (-vo aa is very recommended, see below!)</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2><A HREF=#2.3.1.14-TODO>ggi</A></TD><TD></TD><TD><FONT face="Verdana, + Arial, Helvetica, sans-serif" size=2>similar to SDL</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2><A HREF=#2.3.1.11>aa</A></TD><TD></TD><TD><FONT face="Verdana, Arial, + Helvetica, sans-serif" size=2>textmode rendering with AAlib</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2><a href=#2.3.1.12>vesa</a></TD><TD></TD><TD><FONT face="Verdana, Arial, + Helvetica, sans-serif" size=2>Output to VESA BIOS.</TD><TR> + +<TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2>Card specific:</B></P></TD><TR> + +<TD> </TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, + sans-serif" size=2><A HREF=#2.3.1.7>mga</A></TD><TD> </TD><TD><FONT + face="Verdana, Arial, Helvetica, sans-serif" size=2>Matrox G200/G400 hardware + YUV overlay via the mga_vid device</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2><A HREF=#2.3.1.7>xmga</A></TD><TD></TD><TD><FONT face="Verdana, Arial, + Helvetica, sans-serif" size=2>Matrox G200/G400 overlay (mga_vid) in X11 + window<BR> +(<I>Xv emulation on X 3.3.x!</I>)</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2>syncfb</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, + sans-serif" size=2>Matrox G400 YUV support on framebuffer (obsoleted, use + mga/xmga)</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2>3dfx</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2>Voodoo3/Banshee hardware YUV (/dev/3dfx) support (not yet tested, maybe + broken)</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2><A HREF=#2.3.1.9>tdfxfb</A></TD><TD></TD><TD><FONT face="Verdana, Arial, + Helvetica, sans-serif" size=2>Voodoo3/Banshee hardware YUV support on tdfx + framebuffer (works!)</TD><TR> + +<TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2>Special:</B></P></TD><TR> + +<TD> </TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, + sans-serif" size=2>png</TD><TD> </TD><TD><FONT face="Verdana, Arial, + Helvetica, sans-serif" size=2>PNG files output (use -z switch to set + compression)</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2>pgm</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2>PGM files output (for testing purposes or ffmpeg encoding)</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2>md5</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2>MD5sum output (for MPEG conformance tests)</TD><TR> +<TD></TD><TD VALIGN=top><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2>null</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" + size=2>Null output (for speed tests/benchmarking)</TD><TR> +</TABLE> + +<P>NOTE: <I>check the following subsections for details and requirements!</I></P> + + +<P><B><A NAME=2.3.1.1>2.3.1.1. Setting up MTRR</A></B></P> + +<P>It is VERY recommended to check if the MTRR registers are set up properly, +because they can give a big performance boost.</P> + +<P>Do a '<CODE>cat /proc/mtrr</CODE>' :</P> + +<P><CODE> +--($:~)-- cat /proc/mtrr<BR> +reg00: base=0xe4000000 (3648MB), size= 16MB: write-combining, count=9<BR> +reg01: base=0xd8000000 (3456MB), size= 128MB: write-combining, count=1<BR> +</CODE></P> + +<P>It's right, shows my Matrox G400 with 16Mb memory. I did this from +XFree 4.x.x , which sets up MTRR registers automatically.</P> + +<P>If nothing worked, you have to do it manually. First, you have to find the base +address. +You have 3 ways to find it:</P> + +<P><UL> +<LI>from X11 startup messages, for example: +<P><CODE>(--) SVGA: PCI: Matrox MGA G400 AGP rev 4, Memory @ 0xd8000000, 0xd4000000<BR> +(--) SVGA: Linear framebuffer at 0xD8000000</CODE></P></LI> +<LI>from /proc/pci (use lspci -v command): +<P> +<CODE>01:00.0 VGA compatible controller: Matrox Graphics, Inc.: Unknown device 0525</CODE> +<CODE>Memory at d8000000 (32-bit, prefetchable)</CODE> +</P> +<LI>from mga_vid kernel driver messages (use dmesg): +<P><CODE>mga_mem_base = d8000000</CODE></P> +</UL></P> + +<P>Then let's find the memory size. This is very easy, just convert video ram +size to hexadecimal, or use this table:</P> + +<TABLE BORDER=0> +<TD> </TD><TD>1 MB</TD><TD WIDTH=10%></TD><TD>0x100000</TD><TR> +<TD></TD><TD>2 MB</TD><TD></TD><TD>0x200000</TD><TR> +<TD></TD><TD>4 MB</TD><TD></TD><TD>0x400000</TD><TR> +<TD></TD><TD>8 MB</TD><TD></TD><TD>0x800000</TD><TR> +<TD></TD><TD>16 MB</TD><TD></TD><TD>0x1000000</TD><TR> +<TD></TD><TD>32 MB</TD><TD></TD><TD>0x2000000</TD><TR> +</TABLE> + + +<P>You know base address and memory size, let's setup mtrr registers! +For example, for the Matrox card above (base=0xd8000000) with 32MB +ram (size=0x2000000) just execute:</P> + + +<P><CODE> echo "base=0xd8000000 size=0x2000000 type=write-combining" >| /proc/mtrr</CODE></P> + + +<P>Not all CPUs support MTRRs. For example older K6-2's [around 266Mhz, +stepping 0] doesn't support MTRR, but stepping 12's do ('<CODE>cat /proc/cpuinfo</CODE>' +to check it').</P> + +<P><B><A NAME=2.3.1.2>2.3.1.2. Xv</A></B></P> + +<P>Under XFree86 4.0.2 or newer, you can use your card's hardware YUV routines +using the XVideo extension. This is what the option '-vo xv' uses. +In order to make this work, be sure to check the following:</P> +<P><UL> +<LI>You have to use XFree86 4.0.2 or newer (former versions don't have XVideo) +<LI>Your card actually supports hardware acceleration (modern cards do) +<LI>X loads the XVideo extension, it's something like this: + +<P><CODE> (II) Loading extension XVideo</CODE></P> +<P>in /var/log/XFree86.0.log</P> + +<P>NOTE: this loads only the XFree86's extension. In a good install, this is +always loaded, and doesn't mean that the _card's_ XVideo support is loaded!</P> + +<LI>Your card has Xv support under Linux. To check, try 'xvinfo', it is the +part of the XFree86 distribution. It should display a long text, similar +to this: +<PRE> + X-Video Extension version 2.2 + screen #0 + Adaptor #0: "Savage Streams Engine" + number of ports: 1 + port base: 43 + operations supported: PutImage + supported visuals: + depth 16, visualID 0x22 + depth 16, visualID 0x23 + number of attributes: 5 + (...) + Number of image formats: 7 + id: 0x32595559 (YUY2) + guid: 59555932-0000-0010-8000-00aa00389b71 + bits per pixel: 16 + number of planes: 1 + type: YUV (packed) + id: 0x32315659 (YV12) + guid: 59563132-0000-0010-8000-00aa00389b71 + bits per pixel: 12 + number of planes: 3 + type: YUV (planar) + (...etc...) +</PRE> + +<P>It must support YUY2 packed, and YV12 planar pixel formats to be +usable with <B>MPlayer</B>.</P> + +<LI>And finally, check if <B>MPlayer</B> was compiled with 'xv' support. +./configure prints this. + +</UL></P> + +<P><B><A NAME=2.3.1.2.1>2.3.1.2.1. 3dfx cards</A></B></P> + +<P>Older 3dfx drivers were known to have problems with XVideo acceleration, +it didn't support either YUY2 or YV12, and so. Verify that you have +XFree86 version 4.1.0 or greater, it works ok. Alternatively, you can use +<A HREF="http://dri.sourceforge.net">DRI</A> cvs. +If you experience strange effects using -vo xv, try SDL (it has XVideo too) +and see if it helps. Check the <A HREF="#2.3.1.4">SDL section</A> for details.</P> + +<P><B>OR</B>, try the NEW -vo tdfxfb driver! See the <A HREF=#2.3.1.9>2.3.1.9</A> +section!</P> + + +<P><B><A NAME=2.3.1.2.2>2.3.1.2.2. S3 cards</A></B></P> + +<P>S3 Savage3D's should work fine, but for Savage4, use XFree86 version 4.0.3 +or greater (in case of image problems, try 16bpp). As for S3 Virge.. sell it.</P> + +<P><B>NOTE</B>: Savage cards have a slow YV12 image displaying capability (it needs +to do YV12->YUY2 conversion, because the Savage hardware can't display YV12). +So when this documentation says at some point "this has YV12 output use this, +it's faster", it's not sure. Try.</P> + + +<P><B><A NAME=2.3.1.2.3>2.3.1.2.3. nVidia cards</A></B></P> + +<P>nVidia isn't a very good choice under Linux.. You'll have to use the +binary closed-source nVidia driver, available at nVidia's website. The standard XFree86 +driver doesn't support XVideo for these cards, due to nVidia's closed +sources/specifications.</P> + +<P>As far as I know the latest XFree86 driver contains XVideo support for +Geforce 2 and 3.</P> + +<P><UL><LI>Riva128 cards don't have XVideo support even with the nvidia driver :( +Complain to NVidia.</UL></P> + + +<P><B><A NAME=2.3.1.2.4>2.3.1.2.4. ATI cards</A></B></P> + +<P> +<LI>The GATOS driver (which you should use) has VSYNC enabled by default. It means that decoding speed +(!) is synced to the monitor's refresh rate. If playing seems to be slow, try +disabling VSYNC somehow, or set refresh rate to n*(fps of the movie) Hz.</LI> + +<LI>Radeon VE - currently only XFree86 CVS has driver for this card, version +4.1.0 doesn't. And no TV out support. Of course with <B>MPlayer</B> you can +happily get <B>accelerated</B> display, with or without <B>TV output</B>, and +no libraries or X are needed. Read <a href=#2.3.1.12>VESA driver</a> and <A +HREF=#2.3.1.14>Radeon video overlay</A> sections).</LI> </P> + + +<P><B><A NAME=2.3.1.2.5>2.3.1.2.5. NeoMagic cards</A></B></P> + +<P> +These cards can be found in many laptops. Under Linux, their peak is only DGA. +Unfortunately, the DGA driver in X 4.1.0 doesn't work, you'll have to wait for +4.2.0, or download a modified driver for 4.0.3 or 4.1.0 from here : +<A HREF="http://www.mplayerhq.hu/MPlayer/contrib/NeoMagic-driver">http://www.mplayerhq.hu/MPlayer/contrib/NeoMagic-driver</A> +(there is also the patch to the driver's source).<BR> +Drivers provided by <A HREF="mailto:tomee@cpi.pl">Tomek Jarzynka</A>. +</P> + + +<P><B><A NAME=2.3.1.3>2.3.1.3. DGA</A></B></P> + +<P><B><A NAME=2.3.1.3.1>2.3.1.3.1. Summary</A></B></P> + +<P>This document tries to explain in some words what DGA is in general and +what the DGA video output driver for mplayer can do (and what it can't).</P> + + +<P><B><A NAME=2.3.1.3.2>2.3.1.3.2. What is DGA</A></B></P> + +<P>DGA is short for Direct Graphics Access and is a means for a program to +bypass the X-Server and directly modifying the framebuffer memory. +Technically spoken this happens by mapping the framebuffer memory into +the memory range of your process. This is allowed by the kernel only +if you have superuser privileges. You can get these either by logging in +as root or by setting the suid bit on the mplayer excecutable (NOT +recommended!).</P> + +<P>There are two versions of DGA: DGA1 is used by XFree 3.x.x and DGA2 was +introduced with XFree 4.0.1.</P> + +<P>DGA1 provides only direct framebuffer access as described above. For +switching the resolution of the video signal you have to rely on the +XVidMode extension.</P> + +<P>DGA2 incorporates the features of XVidMode extension and also allows +switching the depth of the display. So you may, although basically +running a 32 bit depth XServer, switch to a depth of 15 bits and vice +versa. </P> + +<P>However DGA has some drawbacks. It seems it is somewhat dependent on the +graphics chip you use and on the implementation of the XServer's video +driver that controls this chip. So it does not work on every system ...</P> + + +<P><B><A NAME=2.3.1.3.3>2.3.1.3.3. Installing DGA support for MPlayer</A></B></P> + +<P>First make sure X loads the DGA extension, see in /var/log/XFree86.0.log:</P> + +<P> <CODE>(II) Loading extension XFree86-DGA</CODE></P> + +<P>See, XFree86 4.0.x or greater is VERY RECOMMENDED! +<B>MPlayer</B>'s DGA driver is autodetected on ./configure, or you can force it +with --enable-dga.</P> + +<P>If the driver couldn't switch to a smaller resolution, experiment with +switches -vm (only with X 3.3.x), -fs, -bpp, -zoom to find a video mode that +the movie fits in. There is no converter right now.. :(</P> + +<P>Become ROOT. DGA needs root access to be able to write directly video memory. +If you want to run it as user, then install <B>MPlayer</B> SUID root:</P> + +<P><CODE> + chown root /usr/local/bin/mplayer<BR> + chmod 750 /usr/local/bin/mplayer<BR> + chmod +s /usr/local/bin/mplayer</CODE></P> + + +<P>Now it works as a simple user, too.</P> + + +<P><B>!!!! BUT STAY TUNED !!!!</B><BR> +This is a <B>BIG</B> security risk! Never do this on a server or on a computer +can be accessed by more people than only you because they can gain root +privilegies through suid root mplayer.<BR> +<B>!!!! SO YOU HAVE BEEN WARNED ... !!!!</B></P> + +<P>Now use '-vo dga' option, and there you go! (hope so:) +You should also try if the '-vo sdl:dga' option works for you! It's much +faster!!!</P> + +<P><B><A NAME=2.3.1.3.4>2.3.1.3.4. Resolution switching</A></B></P> + +<P>The DGA driver allows for switching the resolution of the output signal. +This avoids the need for doing (slow) software scaling and at the same +time provides a fullscreen image. Ideally it would switch to the exact +resolution (except for honouring aspect ratio) of the video data, but the +XServer only allows switching to resolutions predefined in +<CODE>/etc/X11/XF86Config</CODE> (<CODE>/etc/X11/XF86Config-4</CODE> for XFree 4.0.X respectively). +Those are defined by so-called modelines and depend on the capabilites +of your video hardware. The XServer scans this config file on startup and +disables the modelines not suitable for your hardware. You can find +out which modes survive with the X11 log file. It can be found at: +<CODE>/var/log/XFree86.0.log</CODE>.</P> +<P>See appendix A for some sample modeline definitions.</P> + +<P><B><A NAME=2.3.1.3.5>2.3.1.3.5. DGA & MPlayer</A></B></P> + +<P>DGA is used in two places with <B>MPlayer</B>: The SDL driver can be made to make +use of it (-vo sdl:dga) and within the DGA driver (-vo dga). +The above said is true for both; in the following sections I'll explain +how the DGA driver for <B>MPlayer</B> works.</P> + +<P><B><A NAME=2.3.1.3.6>2.3.1.3.6. Features of the DGA driver</A></B></P> + +<P>The DGA driver is invoked by specifying -vo dga at the command line. +The default behaviour is to switch to a resolution matching the original +resolution of the video as close as possible. It deliberately ignores the +-vm and -fs switches (enabling of video mode switching and fullscreen) - +it always tries to cover as much area of your screen as possible by switching +the video mode, thus refraining to use a single additional cycle of your CPU +to scale the image. +If you don't like the mode it chooses you may force it to choose the mode +matching closest the resolution you specify by -x and -y. +By providing the -v option, the DGA driver will print, among a lot of other +things, a list of all resolutions supported by your current XF86-Config +file. +Having DGA2 you may also force it to use a certain depth by using the -bpp +option. Valid depths are 15, 16, 24 and 32. It depends on your hardware +whether these depths are natively supported or if a (possibly slow) +conversion has to be done.</P> + +<P>If you should be lucky enough to have enough offscreen memory left to +put a whole image there, the DGA driver will use doublebuffering, which +results in much smoother movie replaying. It will tell you whether double- +buffering is enabled or not.</P> + +<P>Doublebuffering means that the next frame of your video is being drawn in +some offscreen memory while the current frame is being displayed. When the +next frame is ready, the graphics chip is just told the location in memory +of the new frame and simply fetches the data to be displayed from there. +In the meantime the other buffer in memory will be filled again with new +video data.</P> + +Doublebuffering may be switched on by using the option -double and may be +disabled with -nodouble. Current default option is to disable +doublebuffering. When using the DGA driver, onscreen display (OSD) only +works with doublebuffering enabled. However, enabling doublebuffering may +result in a big speed penalty (on my K6-II+ 525 it used an additional 20% of +CPU time!) depending on the implementation of DGA for your hardware.</P> + + +<P><B><A NAME=2.3.1.3.7>2.3.1.3.7. Speed issues</A></B></P> + +<P>Generally spoken, DGA framebuffer access should be at least as fast as using +the X11 driver with the additional benefit of getting a fullscreen image. +The percentage speed values printed by mplayer have to be interpreted with +some care, as for example, with the X11 driver they do not include the time +used by the X-Server needed for the actual drawing. Hook a terminal to a +serial line of your box and start top to see what is really going on in your +box ...</P> + +<P>Generally spoken, the speedup done by using DGA against 'normal' use of X11 +highly depends on your graphics card and how well the X-Server module for it +is optimized.</P> + +<P>If you have a slow system, better use 15 or 16bit depth since they require +only half the memory bandwidth of a 32 bit display.</P> + +<P>Using a depth of 24bit is even a good idea if your card natively just supports +32 bit depth since it transfers 25% less data compared to the 32/32 mode.</P> + +<P>I've seen some avi files already be replayed on a Pentium MMX 266. AMD K6-2 +CPUs might work at 400 MHZ and above.</P> + +<P><B><A NAME=2.3.1.3.8>2.3.1.3.8. Known bugs</A></B></P> + +<P>Well, according to some developpers of XFree, DGA is quite a beast. They +tell you better not to use it. Its implementation is not always flawless +with every chipset driver for XFree out there.</P> + +<P><UL> +<LI>with XFree 4.0.3 and nv.o there is a bug resulting in strange colors +<LI>ATI driver requires to switch mode back more than once after finishing +using of DGA +<LI>some drivers simply fail to switch back to normal resolution (use +Ctrl-Alt-Keypad +, - to switch back manually) +<LI>some drivers simply display strange colors +<LI>some drivers lie about the amount of memory they map into the process's +address space, thus vo_dga won't use doublebuffering (SIS?) +<LI>some drivers seem to fail to report even a single valid mode. In this +case the DGA driver will crash telling you about a nonsense mode of +100000x100000 or the like ... +<LI>OSD only works with doublebuffering enabled +</UL></P> + +<P><B><A NAME=2.3.1.3.9>2.3.1.3.9. Future work</A></B></P> + +<P><UL><LI>use of the new X11 render interface for OSD +<LI>where is my TODO list ???? :-(((</UL></P> + + +<P><B><A NAME=2.3.1.3.A>2.3.1.3.A. Some modelines</A></B></P> + +<PRE> + Section "Modes" + Identifier "Modes[0]" + Modeline "800x600" 40 800 840 968 1056 600 601 605 628 + Modeline "712x600" 35.0 712 740 850 900 400 410 412 425 + Modeline "640x480" 25.175 640 664 760 800 480 491 493 525 + Modeline "400x300" 20 400 416 480 528 300 301 303 314 Doublescan + Modeline "352x288" 25.10 352 368 416 432 288 296 290 310 + Modeline "352x240" 15.750 352 368 416 432 240 244 246 262 Doublescan + Modeline "320x240" 12.588 320 336 384 400 240 245 246 262 Doublescan + EndSection +</PRE> + +<P>These entries work fine with my Riva128 chip, using nv.o XServer driver +module.</P> + + +<P><B><A NAME=2.3.1.3.B>2.3.1.3.B. Bug Reports</A></B></P> + +<P>If you experience troubles with the DGA driver please feel free to file +a bug report to me (e-mail address below). Please start mplayer with the +-v option and include all lines in the bug report that start with vo_dga:</P> + +<P>Please do also include the version of X11 you are using, the graphics card +and your CPU type. The X11 driver module (defined in XF86-Config) might +also help. Thanks!</P> + + +<P><I>Acki (acki@acki-netz.de, www.acki-netz.de)</I></P> + + +<P><B><A NAME=2.3.1.4>2.3.1.4. SDL</A></B></P> + +<P>Here are some notes about SDL out in <B>MPlayer</B>.</P> + + + +<P><TABLE BORDER=0> +<TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>There are several commandline switches for SDL:</B></P></TD><TR> +<TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-vo sdl:name</TD><TD> </TD><TD> +<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>specifies sdl video driver to use (ie. aalib, dga, x11)</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-ao sdl:name</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>specifies sdl audio driver to use (ie. dsp, +esd, arts)</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-noxv</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>disables Xvideo hardware acceleration</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-forcexv</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>tries to force Xvideo acceleration</TD><TR> + +<TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>SDL Keys:</B></P></TD><TR> + +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>F</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>toggles fullscreen/windowed mode</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>C</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>cycles available fullscreen modes</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>W/S</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>mappings for * and / (mixer control)</TD><TR> + +</TABLE></P> + +<P><B>KNOWN BUGS:</B></P> +<P><UL><LI>Keys pressed under sdl:aalib console driver repeat forever. (use -vo aa !) +It's bug in SDL, I can't change it (tested with SDL 1.2.1). +</UL></P> + +<P><B><A NAME=2.3.1.5>2.3.1.5. SVGAlib</A></B></P> + +<P>If you don't have X, you can use the SVGAlib target! Be sure not to use the +-fs switch, since it toggles the usage of the software scaler, and it's +SLOOOW now, unless you have a real fast CPU (and/or MTRR?). :(</P> + +<P>Of course you'll have to install svgalib and its development package in +order for <B>MPlayer</B> build its SVGAlib driver (autodetected, but can be +forced), and don't forget to edit /etc/vga/libvga.config to suit your +card & monitor.</P> + +<P><B><A NAME=2.3.1.6>2.3.1.6. Framebuffer output (FBdev)</A></B></P> + +<P>Whether to build the FBdev target is autodetected during ./configure . +Read the framebuffer documentation in the kernel sources +(Documentation/fb/*) for info on how to enable it, etc.. !</P> + +<P>If your card doesn't support VBE 2.0 standard (older ISA/PCI +cards, such as S3 Trio64), only VBE 1.2 (or older?) : +Well, VESAfb is still available, but you'll have to load SciTech Display +Doctor (formerly UniVBE) before booting Linux. Use a DOS boot disk or +whatever. And don't forget to register your UniVBE ;))</P> + +<P>The FBdev output takes some additional parameters above the others:</P> + +<P><TABLE BORDER=0> +<TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-fb</TD><TD> </TD><TD> +<FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>specify the framebuffer device to use (/dev/fd0)</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-fbmode</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>mode name to use (according to /etc/fb.modes)</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-fbmodeconfig</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> config file of modes (default /etc/fb.modes)</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-monitor_hfreq</TD><TD></TD><TD ROWSPAN=3><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>IMPORTANT values, see example.conf</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-monitor_vfreq</TD><TD></TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-monitor_dotclock</TD><TD></TD><TR> +</TABLE></P> + +<P>If you want to change to a specific mode, then use</P> + +<P><CODE> mplayer -vm -fbmode (NameOfMode) filename</CODE></P> + +<P><UL><LI><B>-vm</B> alone will choose the most suitable mode from /etc/fb.modes . Can be +used together with -x and -y options too. The -flip option is supported only +if the movie's pixel format matches the video mode's pixel format. +Pay attention to the bpp value, fbdev driver tries to use the current, +or if you specify the -bpp option, then that.</LI> +<LI><B>-zoom</B> option isn't supported (software scaling is slow). -fs option +isn't supported. You can't use 8bpp (or less) modes.</LI> +<LI>you possibly want to turn the cursor off : <CODE>echo -e '\033[?25l'</CODE><BR> + and the screen saver: <CODE>setterm -blank 0</CODE><BR> + To turn the cursor back on : <CODE>echo -e '\033[?25h'</CODE> +</UL></P> + +<P>NOTE: FBdev video mode changing _does not work_ with the VESA framebuffer, +and don't ask for it, since it's not an <B>MPlayer</B> limitation.</P> + +<P><B><A NAME=2.3.1.7>2.3.1.7. Matrox framebuffer (mga_vid)</A></B></P> + +<P>This section is about the Matrox G200/G400/G450/G550 BES (Back-End Scaler) +support, the mga_vid kernel driver. It's active developed by me (A'rpi), and +it has hardware VSYNC support with triple buffering. It works on both +framebuffer console and under X.</P> + +<P>To use it, you first have to compile mga_vid.o:</P> + +<P><CODE> cd drivers<BR> + make</CODE></P> + +<P>Then create /dev/mga_vid device:</P> + +<P><CODE> mknod /dev/mga_vid c 178 0</CODE></P> + +<P>and load the driver with</P> + +<P><CODE> insmod mga_vid.o</CODE></P> + +<P>You should verify the memory size detection using the 'dmesg' command. If +it's bad, use the mga_ram_size option (rmmod mga_vid first), specify card's +memory size in MB:</P> + +<P><CODE> insmod mga_vid.o mga_ram_size=16</CODE></P> + +<P>To make it load/unload automatically when needed, insert the following line +at the end of /etc/modules.conf:</P> + +<P><CODE> alias char-major-178 mga_vid</CODE></P> + +<P>Then run</P> + +<P><CODE> depmod -a</CODE></P> + +<P>Now you have to (re)compile <B>MPlayer</B>, ./configure will detect /dev/mga_vid +and build the 'mga' driver. Using it from <B>MPlayer</B> goes by '-vo mga' if +you have matroxfb console, or '-vo xmga' under XFree86 3.x.x or 4.x.x.</P> + +<P>The mga_vid driver cooperates with Xv.</P> + + +<P><B><A NAME=2.3.1.8>2.3.1.8. SiS 6326 framebuffer (sis_vid)</A></B></P> + +<P>SiS 6326 YUV Framebuffer driver -> sis_vid kernel driver</P> + +<P>Its interface should be compatible with the mga_vid, but the driver was not +updated after the mga_vid changes, so it's outdated now. Volunteers +needed to test it and bring the code up-to-date.</P> + +<P><B><A NAME=2.3.1.9>2.3.1.9. 3dfx YUV support (tdfxfb)</A></B></P> + +<P>This driver uses the kernel's tdfx framebuffer driver to play movies with +YUV acceleration. You'll need a kernel with tdfxfb support, and recompile with +<CODE>./configure --enable-tdfxfb</CODE></P> + +<P><B><A NAME=2.3.1.10>2.3.1.10. OpenGL output</A></B></P> + +<P><B>MPlayer</B> support displaying movies using OpenGL. Unfortunately, not all +drivers support this ability. For example the Utah-GLX drivers +(for XFree86 3.3.6) have it, with all cards. +See <A HREF="http://utah-glx.sourceforge.net">http://utah-glx.sourceforge.net</A> +for details about how to install it.</P> + +<P>XFree86(DRI) >= 4.0.3 supports it only with Matrox, and Radeon cards. +See <A HREF="http://dri.sourceforge.net">http://dri.sourceforge.net</A> for download, +and installation instructions.</P> + +<P><B><A NAME=2.3.1.11>2.3.1.11. AAlib - text mode displaying</B></P> + +<P><B>AAlib</B> is a library for displaying graphics in text mode, using powerful +ASCII renderer. There are LOTS of programs already supporting it, like Doom, +Quake, etc. MPlayer contains a very usable driver for it. +If ./configure detects aalib installed, the aalib libvo driver will be built.</P> + +<P><TABLE BORDER=0> +<TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>You can use some keys in the AA Window to change rendering options:</B></P></TD><TR> +<TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>1</TD><TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>decrease contrast</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>2</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>increase contrast</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>3</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>decrease brightness</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>4</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>increase brightness</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>5</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>switch fast rendering on/off</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>6</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>set dithering mode (none, error distribution, floyd steinberg)</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>7</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>invert image</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>a</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>toggles between aa and mplayer control)</TD><TR> + +<TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>The following command line options can be used:</B></P></TD><TR> + +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-aaosdcolor=V</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>change osd color</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-aasubcolor=V</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>change subtitle color</TD><TR> +<TD COLSPAN=3></TD><TD><P><I><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>where V can be: (0/normal, 1/dark, 2/bold, 3/boldfont, 4/reverse, 5/special)</P></TD><TR> + +<TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>AAlib itselves provides a large sum of options. +Here are some important:</P></B></TD><TR> + +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-aadriver</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>set recommended aa driver (X11, curses, linux)</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-aaextended</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>use all 256 characters</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-aaeight</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>use eight bit ascii</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-aahelp</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>prints out all aalib options</TD><TR> +</TABLE></P> + +<P>NOTE: the rendering is very CPU intensive, especially when using AA-on-X +(using aalib on X), and it's least CPU intensive on standard, +non-framebuffer console. Use SVGATextMode to set up a big textmode, +then enjoy! (secondary head Hercules cards rock :)) (anyone can enhance +bdev to do conversion/dithering to hgafb? Would be neat :)</P> + +<P>Use the -framedrop option if your comp isn't fast enough to render all frames!</P> + +<P>Playing on terminal you'll get better speed and quality using the linux driver, not +curses (-aadriver linux). But therefore you need write access on /dev/vcsa<terminal>! +That isn't autodetected by aalib, bu vo_aa tries to find the best mode. +See <A HREF="http://aa-project.sourceforge.net/tune/">http://aa-project.sourceforge.net/tune/</A> for further tuning issues.</P> + + +<P><B><A NAME=2.3.1.12>2.3.1.12. VESA - output to VESA BIOS</B></P> +<P> +This driver was designed and introduced as <b>generic driver</b> for any video +card which has VESA VBE 2.0 compatible BIOS. But exists still one reason of +developing of this driver - it's multiple troubles with displaying movie on TV.<BR> +<b>VESA BIOS EXTENSION (VBE) Version 3.0 Date: September 16, 1998</b> (Page 70) +says: +</P> + +<P> +<code><i> +<b>Dual-Controller Designs</b><br> +VBE 3.0 supports the dual-controller design by assuming that since both +controllers are typically provided by the same OEM, under control of a +single BIOS ROM on the same graphics card, it is possible to hide the fact +that two controllers are indeed present from the application. This has the +limitation of preventing simultaneous use of the independent controllers, +but allows applications released before VBE 3.0 to operate normally. The +VBE Function 00h (Return Controller Information) returns the combined +information of both controllers, including the combined list of available modes. +When the application selects a mode, the appropriate controller is activated. +Each of the remaining VBE functions then operates on the active controller. +</i></code> +</P> + +<P> +So you have chances to get working TV-out by using this driver.<br> +(I guess that TV-out frequently is standalone head or standalone output +at least.) +</P> + +<P> +<b>What are pluses:</b><BR> + - You have chances to watch movies <b>if Linux even doesn't know</b> your video hardware.<BR> + - You don't need to have installed any graphics' related things on your Linux +(like X11 (aka XFree86), fbdev and so on). This driver can be run from +<b>text-mode</b>.<BR> + - You have chances to get <b>working TV-out</b>. (It's known at least for ATI's cards).<BR> + - This driver calls <b>int 10h</b> handler thus it's not an emulator - it +calls <b>real</b> things of <b>real</b> BIOS in <b>real</b>-mode. (Finely - +in vm86 mode).<BR> + - Most important :) You can watch <b>DVD at 320x200</b> if you don't have a powerful CPU.<BR> +</P> + +<P> +<b>What are minuses:</b><BR> + - It works only on <b>x86 systems</b>.<BR> + - <b>It's the slowest driver</b> from all the available ones for MPlayer.<BR> + (But only if your card doesn't support <b>DGA mode</b> - otherwise this + driver is comparable by speed with <b>-vo dga</b> and <b>-vo fbdev</b> ones.<BR> + + - It can be used only by <b>ROOT</b>.<BR> + - Currently it's available only for <b>Linux</b>.<BR> + - It <b>doesn't use</b> any <b>hardware accelerations</b> (like YUV overlay or hw scaling).<BR> +</P> + +<P>Don't use this driver with <B>GCC 2.96</B> ! It won't work !</P> + +<P> +<TABLE BORDER=0> +<TD COLSPAN=4><P><B><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>These switches of command line currently are available for VESA:</B></P></TD><TR> +<TD> </TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-vo vesa:opts</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>currently recognized: <b>dga</b> to force dga mode and <b>nodga</b> to disable dga mode. Note: you may omit these parameters to enable <b>autodetect</b> of dga mode. (In the future also will specify mode parameters such as refresh rate, interlacing, doublescan and so on. Samples: i43, 85, d100)</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-screenw, -screenh, -bpp</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>force userdefined mode</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-x, -y</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>set userdefined prescaling</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-zoom</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>enables userdefined prescaling</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-fs</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>scales image to fullscreen</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-fs -zoom</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>scales userdefined prescaling to fullscreen</TD><TR> +<TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>-double</TD><TD></TD><TD><FONT face="Verdana, Arial, Helvetica, sans-serif" size=2>enables double buffering mode. (Available only in DGA mode). Should be slower of single buffering, but has no flickering effects.</TD><TR> +</TABLE> +</P> + +<P> +<b>Known problems and workaround:</b><br> + - If you have installed <b>NLS</b> font on your Linux box and run VESA driver +from text-mode then after terminating mplayer you will have <b>ROM font</b> loaded instead +of national. You can load national font again by using <b><i>setsysfont</i></b> utility +from for example Mandrake distribution.<br> +(<b>Hint</b>: The same utility is used for localizating fbdev).<br> + - Some <b>Linux graphics drivers</b> don't update active <b>BIOS mode</b> in DOS memory. So if you have such +problem - always use VESA driver only from <b>text-mode</b>. Otherwise text-mode (#03) will be +activated anyway and you will need restart your computer.<br> + - Often after terminating VESA driver you get <b>black screen</b>. To return your screen +to original state - simply switch to other console (by pressing <b>Alt-Fx</b>) then switch +to your previous console by the same way.<br> + - To get <b>working TV-out</b> you need have plugged tv-connector in before booting +your PC since video BIOS initializes itself only once during POST procedure. +</P> + + +<P><B><A NAME=2.3.1.13>2.3.1.13. X11</B></P> + +<P>Avoid if possible. Outputs to X11 (uses shared memory extension), with no +hardware acceleration at all. Supports (MMX/3DNow/SSE accelerated, but still +slow) software scaling, use the options <CODE>-fs -zoom</CODE>. Most cards have +hardware scaling support, use the <CODE>-vo xv</CODE> output for them, or +<CODE>-vo xmga</CODE> for Matroxes.</P> + +<P>The problem is that most cards' driver doesn't support +hardware acceleration on the second head/TV. In those cases, you see green/blue +coloured window instead of the movie. This is where this driver comes in +handy, but you need powerful CPU to use software scaling. Don't use the +SDL driver's software output+scaler, it has worse image quality !</P> + +<P>Software scaling is very slow, you better try changing video modes instead. +It's very simple. See the <A HREF=#2.3.1.3.A>DGA section's modelines</A>, and +insert them into your XF86Config. +<UL> + <LI>If you have XFree86 4.x.x - use the <CODE>-vm</CODE> option. It will + change to a resolution your movie fits in. If it doesn't :</LI> + <LI>With XFree86 3.x.x - you have to cycle through available resolutions + with the <B>CTRL-ALT-plus</B> and <B>minus</B> keys.</LI> +</UL> + +If you can't find the modes you inserted, browse XFree86's output. Some +drivers can't use low pixelclocks that are needed for low resolution +video modes.</P> + + +<P><B><A NAME=2.3.1.14>2.3.1.14. Rage128 (Pro) / Radeon video overlay (radeon_vid)</A></B></P> +<P> +<b>radeon_vid</b> and <B>rage128_vid</B> provides support for the <b>BackEnd Scaler</b> on ATI <b>Radeon</b> and Rage128 (Pro) chipsets. +It was designed and introduced as analog of <a href="video.html#2.3.1.7">mga_vid</a> driver, so you can use it in the same way!<br> +But main goal of this driver usage is <a href="video.html#2.3.1.12">VESA</a> driver.<br> +Simply because VESA enables TV-out on ATI's card but Backend scaler is used after +mode switching. This implementation outputs video stream on both: <b>TV-screen</b> and <b>CRTC</b> +display simultaneously. (It slightly degrades quality of video output but it's +much better than nothing). +Sorry! I couldn't find out any video overlay's related information +on ATI pages. (I planned to implement it through <b>int 10h</b> calls). But it was +very easy to implement this stuff through reading/writing Radeon ports. +<br><b>NOTE</b>: XXX_VID technology is perfectly undocumented and maybe in the +future this stuff will be fully rewritten. This is the first public release of +driver.</P> + +<P><B>Installation</B></P> + +<P> +<UL> + <LI> + <CODE>cd drivers/radeon<BR> + make<BR> + make install<BR> + make nodes</CODE></LI> + <LI>add one of the following at the end of the <CODE>/etc/modules.conf</CODE> file :<BR> + <CODE> alias char-major-178 radeon_vid</CODE><BR> + <CODE> alias char-major-178 rage128_vid</CODE></LI> + <LI>run <CODE>depmod -a</CODE></LI> +</UL> +</P> + +<P> +<br><b>Usage:</b><BR> + <CODE>mplayer -vo vesa:lvo:/dev/radeon_vid <your options> filename</CODE> +</P> + +<P>More examples (for hardware deinterlacing, etc) can be found + <A HREF="../drivers/radeon/README">here</A>.</P> + +<P><B>NOTE</B>: don't use any framebuffers when you plan to use this driver ! Use +it only from textmode console.</P> + +<P> +<b>Conclusion:</b> I know there are lot of lacks and bugs. So if you are able +to improve something then simply send me your patches. +</P> + + +<P><B><A NAME=2.3.1.A>2.3.1.A. TV-out support</A></B></P> + +<P><B><A NAME=2.3.1.A.1>2.3.1.A.1. Matrox cards</A></B></P> + +<P>Under Linux you have 2 methods to get TV out working :</P> + +<P> +<UL> + <LI><B>XFree86</B>: using the driver and the HAL module, available from + <A HREF="http://www.matrox.com">Matrox's site</A>. This will give you X on + the TV.<BR> <B>This method doesn't give you accelerated playback</B> as + under Windoze! The second head has only YUV framebuffer, the <I>BES</I> + (Back End Scaler, the YUV scaler on G200/G400/G450/G550 cards) doesn't work + on it! The windows driver somehow workarounds this, probably by using the + 3D engine to zoom, and the YUV framebuffer to display the zoomed + image. If you really want to use X, use the <CODE>-vo x11 -fs -zoom</CODE> + options, but it will be <B>SLOW</B>, and has <B>Macrovision</B> copyprotection + enabled.</LI> + <LI><B>Framebuffer</B>: using the <B>matroxfb modules</B> in the 2.4 kernels. + 2.2 kernels don't have the TVout feature in them, thus unusable for this. + You have to enable ALL matroxfb-specific feature during compilation (except + MultiHead), and compile them into <B>modules</B>! + <UL> + <LI> + Enter <CODE>TVout/matroxset</CODE> and type <CODE>make</CODE>. Install + <CODE>matroxset</CODE> into somewhere in your PATH.</LI> + <LI> + If you don't have <CODE>fbset</CODE> installed, enter + <CODE>TVout/fbset</CODE> and type <CODE>make</CODE>. Install + <CODE>fbset</CODE> into somewhere in your PATH.</LI> + <LI> + Then enter into the <CODE>TVout/</CODE> directory in the <B>MPlayer</B> + source, and execute <CODE>./modules</CODE> as root. Your text-mode console + will enter into framebuffer mode (no way back!).</LI> + <LI>Next, run the <CODE>./matroxtv</CODE> script. This will present you + to a very simple menu. Press <B>2</B> and <B>ENTER</B>. Now you should + have the same picture on your monitor, and TV. The <B>3.</B> option + will turn on independent display, but then you <B>can't use X</B>! If + the TV (PAL !) picture has some weird stripes on it, the script wasn't able to + set the resolution correctly (to 640x512 by default). Use other menu + items randomly and it'll be OK :)</LI> + </UL> + + <P> + Yoh. Next task is to make the cursor on tty1 (or whatever) to disappear, + and turn off screen blanking. Execute the following commands:</P> + + <P> + <CODE>echo -e '\033[?25l'<BR> + setterm -blank 0</CODE> + </P> + + <P> + You possibly want to put the above into a script, and also clear + the screen.. To turn the cursor back :<BR><CODE>echo -e '\033[?25h'</CODE> + </P> + + <P>Yeah kewl. Start movie playing with <CODE>mplayer -vo mga -fs -screenw 640 + -screenh 512 <filename></CODE><BR> + (if you use X, now change to matroxfb with for example CTRL-ALT-F1 !)<BR> + Change 640x512 if you set the resolution to other..<BR> + <B>Enjoy the ultra-fast ultra-featured Matrox TV output (better than Xv) !</B> + </P> + </LI> +</LI> +</UL> +</P> + + +<P><B><A NAME=2.3.1.A.2>2.3.1.A.2. ATI cards</A></B></P> + +<P> +<b>A few word about ATI's TV-out:</b><BR> +Currently ATI doesn't want to support any of its TV-out chips under Linux. +Below is official answer from ATI Inc.: + +<P> +<code> +<i> +<br>> Hello! +<br>> +<br>> On your pages you wrote that you support linux developers. +<br>> Currently I participate with mplayer project (www.mplayerhq.hu) +<br>> I'm interesting with enabling TV-out on Radeon VE chips during +<br>> movie playback. I would be glad to add this feature to radeonfb driver +<br>> (which can be found in CVS tree of mplayer project at main/drivers/radeon). +<br>> Do I have a chance to get any official technical documenation? +</i> +<br>We will not provide TV out related documents due to macrovision concerns. +<br>Also mpeg2 decoding is something that we MAY consider in the future but not +<br>at this current time. This is again due to proprietary and 3rd party +<br>information. +</code> +</P> + +<P>Pity isn't?</P> + +<P> +<code> +<B>Q:What is Macrovision?</B><BR> +A:It's copy protection mechanism.</code> +</P> + +<P>It means that if they open any TV-out related information then +hackers will be able to disable copy protection on their chips. Therefore +we have no chance to get working TV-out on ATI.</P> + +<P>What's status of ATI's tv-out chips under Linux: +<LI><b>ATI Mach64</b> has <i>ImpacTV</i> which is supported by gatos. +<LI><b>ASIC Radeon VIVO</b> has <i>Rage Theatre</i> which is supported by gatos. +<LI><b>Radeon VE</b> and <b>Rage PRO LT</b> have <i>ImpacTV2+</i> which is not supported under Linux. +But with <B>MPlayer</B> you get <B>full hardware acceleration</B> and <B>TV out</B> +for Radeons ! +Check <a href=#2.3.1.12>VESA driver</a> and <A HREF=#2.3.1.14>Radeon +acceleration</A> sections.</P> + +<P> +Fortunately, owners of fast enough CPUs (Duron, Celeron2 and better) <b>can watch +movies on their TV</b> through <a href=#2.3.1.12>VESA drivers</a>. +</P> + +<P> +I should say good words to ATI Inc. too:<br> +<b>they produce top quality BIOSes.</b> +</P> + +<P> +<b>VESA drivers</b> don't use any hardware acceleration but it simulates +<b>DGA</b> through 64K window, which is configured through 32-bit mode +functions of BIOS. ATI cards have enough <b>fast video memory</b> (DIMM or DDR +chips with 64 - 128-bit access) so it's not bottleneck for them. There are no +limitations on which video mode can be displayed on your TV (like on other +cards) so you can use <b>any video mode</b> on your <b>TV</b> (from +<b>320x200</b> up to <b>1024x768</b>).<br> +From other side (it's known at least for <b>Radeons</b>) there is <b>DGA</b> +mode which is detected automatically and in this case you'll get comparable +with <b>-vo dga</b> and <b>-vo fbdev</b> drivers speed.<br> +Only thing you need to do - <b>have TV connector plugged in before booting your +PC</b> since video BIOS initializes itself only once during POST procedure. +</P> + +<P> +For detail see <a href="video.html#2.3.1.12">VESA</a> sections of this +documentation. +</P> + + +<P><B><A NAME=2.3.1.A.3>2.3.1.A.3. Voodoo 3</A></B></P> + +<P> +Check <A HREF="http://www.iki.fi/too/tvout-voodoo3-3000-xfree">this URL</A>. +</P> + +</BODY> +</HTML> |