Mercurial > mplayer.hg
changeset 8177:1f00a3d29b20
some TOC reorder
new sections
updates
fixes
girls
etc
| author | gabucino |
|---|---|
| date | Wed, 13 Nov 2002 05:13:51 +0000 |
| parents | 15fa4667cddf |
| children | 7f4f16c26884 |
| files | DOCS/documentation.html DOCS/formats.html DOCS/sound.html DOCS/video.html |
| diffstat | 4 files changed, 333 insertions(+), 195 deletions(-) [+] |
line wrap: on
line diff
--- a/DOCS/documentation.html Wed Nov 13 01:17:58 2002 +0000 +++ b/DOCS/documentation.html Wed Nov 13 05:13:51 2002 +0000 @@ -63,6 +63,7 @@ <LI><A HREF="formats.html#roq">2.1.1.11 RoQ files</A></LI> <LI><A HREF="formats.html#ogg">2.1.1.12 OGG/OGM files</A></LI> <LI><A HREF="formats.html#sdp">2.1.1.13 SDP files</A></LI> + <LI><A HREF="formats.html#pva">2.1.1.14 PVA files</A></LI> </UL> </LI> <LI><A HREF="formats.html#audio_formats">2.1.2 Audio formats</A> @@ -72,6 +73,7 @@ <LI><A HREF="formats.html#ogg_vorbis">2.1.2.3 OGG/OGM files (Vorbis)</A></LI> <LI><A HREF="formats.html#wma">2.1.2.4 WMA/ASF files</A></LI> <LI><A HREF="formats.html#mp4">2.1.2.5 MP4 files</A></LI> + <LI><A HREF="formats.html#cdda">2.1.2.6 CD audio</A></LI> </UL> </LI> </UL> @@ -114,65 +116,79 @@ <LI><A HREF="video.html">2.3.1 Video output devices</A> <UL> <LI><A HREF="video.html#mtrr">2.3.1.1 Setting up MTRR</A></LI> - <LI><A HREF="video.html#xv">2.3.1.2 Xv</A> - <UL> - <LI><A HREF="video.html#xv_3dfx">2.3.1.2.1 3dfx cards</A></LI> - <LI><A HREF="video.html#xv_s3">2.3.1.2.2 S3 cards</A></LI> - <LI><A HREF="video.html#xv_nvidia">2.3.1.2.3 nVidia cards</A></LI> - <LI><A HREF="video.html#xv_ati">2.3.1.2.4 ATI cards</A></LI> - <LI><A HREF="video.html#xv_neomagic">2.3.1.2.5 NeoMagic cards</A></LI> - <LI><A HREF="video.html#xv_trident">2.3.1.2.6 Trident cards</A></LI> - </UL> - </LI> - <LI><A HREF="video.html#dga">2.3.1.3 DGA</A> + <LI><A HREF="video.html#normal">2.3.1.2 Video outputs for traditional video cards</A></LI> + <UL> + <LI><A HREF="video.html#xv">2.3.1.2.1 Xv</A> + <UL> + <LI><A HREF="video.html#xv_3dfx">2.3.1.2.1.1 3dfx cards</A></LI> + <LI><A HREF="video.html#xv_s3">2.3.1.2.1.2 S3 cards</A></LI> + <LI><A HREF="video.html#xv_nvidia">2.3.1.2.1.3 nVidia cards</A></LI> + <LI><A HREF="video.html#xv_ati">2.3.1.2.1.4 ATI cards</A></LI> + <LI><A HREF="video.html#xv_neomagic">2.3.1.2.1.5 NeoMagic cards</A></LI> + <LI><A HREF="video.html#xv_trident">2.3.1.2.1.6 Trident cards</A></LI> + </UL> + </LI> + <LI><A HREF="video.html#dga">2.3.1.2.2 DGA</A> + <UL> + <LI><A HREF="video.html#dga_summary">2.3.1.2.2.1 Summary</A></LI> + <LI><A HREF="video.html#dga_whatis">2.3.1.2.2.2 What is DGA</A></LI> + <LI><A HREF="video.html#dga_installation">2.3.1.2.2.3 Installing DGA support for MPlayer</A></LI> + <LI><A HREF="video.html#dga_resolution">2.3.1.2.2.4 Resolution switching</A></LI> + <LI><A HREF="video.html#dga_mplayer">2.3.1.2.2.5 DGA & MPlayer</A></LI> + <LI><A HREF="video.html#dga_features">2.3.1.2.2.6 Features of the DGA driver</A></LI> + <LI><A HREF="video.html#dga_speed">2.3.1.2.2.7 Speed issues</A></LI> + <LI><A HREF="video.html#dga_bugs">2.3.1.2.2.8 Known bugs</A></LI> + <LI><A HREF="video.html#dga_future">2.3.1.2.2.9 Future work</A></LI> + <LI><A HREF="video.html#dga_modelines">2.3.1.2.2.A Some modelines</A></LI> + <LI><A HREF="video.html#dga_bug_reports">2.3.1.2.2.B Bug Reports</A></LI> + </UL> + </LI> + <LI><A HREF="video.html#sdl">2.3.1.2.3 SDL</A></LI> + <LI><A HREF="video.html#svgalib">2.3.1.2.4 SVGAlib</A></LI> + <LI><A HREF="video.html#fbdev">2.3.1.2.5 Framebuffer output (FBdev)</A></LI> + <LI><A HREF="video.html#mga_vid">2.3.1.2.6 Matrox framebuffer (mga_vid)</A></LI> + <LI><A HREF="video.html#tdfxfb">2.3.1.2.7 3dfx YUV support (tdfxfb)</A></LI> + <LI><A HREF="video.html#opengl">2.3.1.2.8 OpenGL output</A></LI> + <LI><A HREF="video.html#aalib">2.3.1.2.9 AAlib - text mode displaying</A></LI> + <LI><A HREF="video.html#vesa">2.3.1.2.10 VESA - output to VESA BIOS</A></LI> + <LI><A HREF="video.html#x11">2.3.1.2.11 X11</A></LI> + <LI><A HREF="video.html#vidix">2.3.1.2.12 VIDIX</A></LI> + <LI><A HREF="video.html#directfb">2.3.1.2.13 DirectFB</A></LI> + <LI><A HREF="video.html#dfbmga">2.3.1.2.14 DirectFB/Matrox (dfbmga)</A></LI> + </UL> + <LI><A HREF="video.html#mpegdec">2.3.1.3 MPEG decoders</A></LI> + <UL> + <LI><A HREF="video.html#dvb">2.3.1.3.1 DVB</A></LI> + <LI><A HREF="video.html#dxr2">2.3.1.3.2 DXR2</A></LI> + <LI><A HREF="video.html#dxr3">2.3.1.3.3 DXR3/Hollywood+</A></LI> + </UL> + <LI><A HREF="video.html#other">2.3.1.4 Other visualization hardware</A></LI> + <UL> + <LI><A HREF="video.html#zr">2.3.1.4.1 Zoran JPEG decoders</A></LI> + <LI><A HREF="video.html#blinken">2.3.1.4.2 Blinkenlights</A></LI> + </UL> + <LI><A HREF="video.html#tv-out">2.3.1.5 TV-out support</A> <UL> - <LI><A HREF="video.html#dga_summary">2.3.1.3.1 Summary</A></LI> - <LI><A HREF="video.html#dga_whatis">2.3.1.3.2 What is DGA</A></LI> - <LI><A HREF="video.html#dga_installation">2.3.1.3.3 Installing DGA support for MPlayer</A></LI> - <LI><A HREF="video.html#dga_resolution">2.3.1.3.4 Resolution switching</A></LI> - <LI><A HREF="video.html#dga_mplayer">2.3.1.3.5 DGA & MPlayer</A></LI> - <LI><A HREF="video.html#dga_features">2.3.1.3.6 Features of the DGA driver</A></LI> - <LI><A HREF="video.html#dga_speed">2.3.1.3.7 Speed issues</A></LI> - <LI><A HREF="video.html#dga_bugs">2.3.1.3.8 Known bugs</A></LI> - <LI><A HREF="video.html#dga_future">2.3.1.3.9 Future work</A></LI> - <LI><A HREF="video.html#dga_modelines">2.3.1.3.A Some modelines</A></LI> - <LI><A HREF="video.html#dga_bug_reports">2.3.1.3.B Bug Reports</A></LI> - </UL> - </LI> - <LI><A HREF="video.html#sdl">2.3.1.4 SDL</A></LI> - <LI><A HREF="video.html#svgalib">2.3.1.5 SVGAlib</A></LI> - <LI><A HREF="video.html#fbdev">2.3.1.6 Framebuffer output (FBdev)</A></LI> - <LI><A HREF="video.html#mga_vid">2.3.1.7 Matrox framebuffer (mga_vid)</A></LI> - <LI><A HREF="video.html#tdfxfb">2.3.1.8 3dfx YUV support (tdfxfb)</A></LI> - <LI><A HREF="video.html#opengl">2.3.1.9 OpenGL output</A></LI> - <LI><A HREF="video.html#aalib">2.3.1.10 AAlib - text mode displaying</A></LI> - <LI><A HREF="video.html#vesa">2.3.1.11 VESA - output to VESA BIOS</A></LI> - <LI><A HREF="video.html#x11">2.3.1.12 X11</A></LI> - <LI><A HREF="video.html#vidix">2.3.1.13 VIDIX</A></LI> - <LI><A HREF="video.html#zr">2.3.1.14 Zr</A></LI> - <LI><A HREF="video.html#dvb">2.3.1.15 DVB</A></LI> - <LI><A HREF="video.html#dxr3">2.3.1.16 DXR3/Hollywood+</A></LI> - <LI><A HREF="video.html#tv-out">2.3.1.A TV-out support</A> - <UL> - <LI><A HREF="video.html#tv-out_matrox">2.3.1.A.1 Matrox G400 cards</A></LI> - <LI><A HREF="video.html#tv-out_matrox_g450">2.3.1.A.2 Matrox G450/G550 cards</A></LI> - <LI><A HREF="video.html#tv-out_ati">2.3.1.A.3 ATI cards</A></LI> - <LI><A HREF="video.html#tv-out_voodoo">2.3.1.A.4 Voodoo 3</A></LI> + <LI><A HREF="video.html#tv-out_matrox">2.3.1.5.1 Matrox G400 cards</A></LI> + <LI><A HREF="video.html#tv-out_matrox_g450">2.3.1.5.2 Matrox G450/G550 cards</A></LI> + <LI><A HREF="video.html#tv-out_ati">2.3.1.5.3 ATI cards</A></LI> + <LI><A HREF="video.html#tv-out_voodoo">2.3.1.5.4 Voodoo 3</A></LI> </UL> </LI> </UL> <LI><A HREF="sound.html">2.3.2 Audio output devices</A> <UL> - <LI><A HREF="sound.html#experiences">2.3.2.1 Sound card experiences, recommendations</A></LI> - <LI><A HREF="sound.html#plugins">2.3.2.2 Audio plugins</A> + <LI><A HREF="sound.html#sync">2.3.2.1 Description of MPlayer's A/V sync method</A></LI> + <LI><A HREF="sound.html#experiences">2.3.2.2 Sound card experiences, recommendations</A></LI> + <LI><A HREF="sound.html#plugins">2.3.2.3 Audio plugins</A> <UL> - <LI><A HREF="sound.html#resample">2.3.2.2.1 Up/Downsampling</A></LI> - <LI><A HREF="sound.html#surround_decoding">2.3.2.2.2 Surround Sound decoding</A></LI> - <LI><A HREF="sound.html#format">2.3.2.2.3 Sample format converter</A></LI> - <LI><A HREF="sound.html#delay">2.3.2.2.4 Delay</A></LI> - <LI><A HREF="sound.html#volume">2.3.2.2.5 Software volume control</A></LI> - <LI><A HREF="sound.html#extrastereo">2.3.2.2.6 Extrastereo</A></LI> - <LI><A HREF="sound.html#normalizer">2.3.2.2.7 Volume Normalizer</A></LI> + <LI><A HREF="sound.html#resample">2.3.2.3.1 Up/Downsampling</A></LI> + <LI><A HREF="sound.html#surround_decoding">2.3.2.3.2 Surround Sound decoding</A></LI> + <LI><A HREF="sound.html#format">2.3.2.3.3 Sample format converter</A></LI> + <LI><A HREF="sound.html#delay">2.3.2.3.4 Delay</A></LI> + <LI><A HREF="sound.html#volume">2.3.2.3.5 Software volume control</A></LI> + <LI><A HREF="sound.html#extrastereo">2.3.2.3.6 Extrastereo</A></LI> + <LI><A HREF="sound.html#normalizer">2.3.2.3.7 Volume Normalizer</A></LI> </UL> </LI> </UL> @@ -399,6 +415,8 @@ 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> + <LI><B>MPlayer v0.01:</B> Nov 11, 2000<BR> + TODO: A'rpi, would you say some words here? :)</LI> <LI><B>MPlayer v0.3-v0.9:</B> Nov 18-Dec 4, 2000<BR> It was a pack of two programs: mpg12play v0.95pre6 and my new simple AVI player 'avip' based on avifile's Win32 DLL loader.</LI> @@ -423,7 +441,10 @@ MOV/VIVO/RM/FLI/NUV fileformats support, native CRAM, Cinepak, ADPCM codecs, and support for XAnim's binary codecs; DVD subtitles support, first release of MEncoder, TV grabbing, cache, liba52, countless fixes.</LI> - <LI><B>MPlayer 0.90 "?"</B> Aug? ??, 2002</LI> + <LI><B>MPlayer 0.90pre10 "The BirthdayCounter"</B> Nov 11, 2002<BR> + Although this is not a release, I am going to mention it because it + came out 2 years after MPlayer v0.01. Happy birthday, MPlayer!</LI> + <LI><B>MPlayer 0.90 "?"</B> Date yet unknown</LI> </UL> @@ -478,6 +499,11 @@ <LI><B>libvorbis</B> - optional, needed for playing OGG Vorbis audio.</LI> <LI><B><A HREF="http://www.live.com/mplayer/">LIVE.COM Streaming Media</A></B> - optional, needed for playing RTSP/RTP streams.</LI> + <LI><B>directfb</B> - optional, from + <A HREF="http://www.directfb.org">http://www.directfb.org</A></LI> + <LI><B>cdparanoia</B> - optional, for CDDA support</LI> + <LI><B>libfreetype</B> - optional, for TTF fonts support. At least 2.0.9 is + required.</LI> </UL> <H4>Codecs:</H4> @@ -784,7 +810,16 @@ <LI>AQTitle</LI> </UL> -The command line options differ slightly for the different formats: +<P>MPlayer can dump the previously listed subtitle formats into the following + destination formats, with the given options:</P> + +<UL> + <LI>MPsub: <CODE>-dumpmpsub</CODE></LI> + <LI>SubRip: <CODE>-dumpsrtsub</CODE></LI> + <LI>Microdvd: <CODE>-dumpmicrodvdsub</CODE></LI> +</UL> + +<P>The command line options differ slightly for the different formats:</P> <H4>VobSub subtitles</H4> @@ -892,6 +927,8 @@ (read TOOLS/subfont-c/README for details)</LI> <LI>use the font generator GIMP plugin at TOOLS/subfont-GIMP (note: you must have HSI RAW plugin too, see URL below)</LI> + <LI>using a TrueType (TTF) font, by the means of the <B>freetype</B> + library. Version 2.0.9 or greater is mandatory! TODO: complete this</LI> </UL> <P>After that, UNZIP the file you downloaded to <CODE>~/.mplayer</CODE> or
--- a/DOCS/formats.html Wed Nov 13 01:17:58 2002 +0000 +++ b/DOCS/formats.html Wed Nov 13 05:13:51 2002 +0000 @@ -224,6 +224,15 @@ libraries are required.)</P> +<H4><A NAME="pva">2.1.1.14 PVA files</A></H4> + +<P>PVA is an MPEG-like format used by DVB TV boards' software (e.g.: MultiDec, + WinTV) under Windows.</P> + +<P>The PVA specifications can be downloaded from the following address: + <A HREF="http://www.technotrend.de/download/av_format_v1.pdf">http://www.technotrend.de/download/av_format_v1.pdf</A></P> + + <H3><A NAME="audio_formats">2.1.2 Audio formats</A></H3> <P>MPlayer is a <B>Movie</B> and not a <B>Media</B> player, although @@ -255,5 +264,15 @@ <H4><A NAME="mp4">2.1.2.5 MP4 files</A></H4> + +<H4><A NAME="cdda">2.1.2.6 CD audio</A></H4> + +<P>MPlayer can use <B>cdparanoia</B> (lib) to play CDDA (Audio CD). + The scope of this section does not contain enumerating cdparanoia's + features.</P> + +<P>See the man page's <CODE>-cdda</CODE> option which can be used to + pass options to cdparanoia.</P> + </BODY> </HTML>
--- a/DOCS/sound.html Wed Nov 13 01:17:58 2002 +0000 +++ b/DOCS/sound.html Wed Nov 13 05:13:51 2002 +0000 @@ -12,6 +12,8 @@ <H3><A NAME="audio">2.3.2 Audio output devices</A></H3> +<H4><A NAME="sync">2.3.2.1 Description of MPlayer's A/V sync method</A></H4> + <P>MPlayer's audio interface is called <I>libao2</I>. It currently contains these drivers:</P> @@ -26,8 +28,24 @@ <TR><TD></TD><TD VALIGN=top>arts</TD><TD></TD><TD>native ARTS driver (mostly for KDE users)</TD></TR> </TABLE> -<P>Fact is, Linux sound card drivers have compatibility problems. - It <B>may</B> take a while to find your optimal settings.</P> +<P>Fact is, Linux sound card drivers have compatibility problems. The cause + is that MPlayer uses a feature of normally coded audio drivers to maintain + audio/video sync. Regrettably, some driver authors don't care of this + function: it isn't needed for playing MP3s, or sound effects.</P> + +<P>Other media players like aviplay or xine possibly work out-of-the-box with + these drivers because they use "simple" methods with internal timing. A note: + time showed their methods aren't AS efficient as MPlayer's.</P> + +<P>Using MPlayer with a correctly written audio driver won't ever give you A/V + desyncs related to the audio, only with very badly created files (check the + documentation for workarounds!).</P> + +<P>If you happen to have a bad audio driver, try the <CODE>-autosync</CODE> + option, it should sort out your problems. See the man page for detailed + information.</P> + +<P>Some notes:</P> <UL> <LI>If you have an OSS driver, first try <CODE>-ao oss</CODE> (this is the @@ -40,17 +58,13 @@ <CODE>-ao alsa5</CODE> , since ALSA 0.5 has buggy OSS emulation code, and will <B>crash MPlayer</B> with a message like this:<BR> <CODE>DEMUXER: Too many (945 in 8390980 bytes) video packets in the buffer!</CODE></LI> - <LI>If you have ALSA version 0.9 you may choose between <CODE>-ao oss</CODE> - and <CODE>-ao sdl</CODE>. You can also use <CODE>-ao alsa9</CODE>. It - works, but there may be problems like lost sync and disappearing - audio.</LI> </UL> -<P>On <B>Solaris/FreeBSD</B> systems, use the SUN audio driver with the +<P>On <B>Solaris</B>, use the SUN audio driver with the <CODE>-ao sun</CODE> option, otherwise neither video nor audio will work.</P> -<H4><A NAME="experiences">2.3.2.1 Sound Card experiences, recommendations</A></H4> +<H4><A NAME="experiences">2.3.2.2 Sound Card experiences, recommendations</A></H4> <TABLE BORDER=0 WIDTH="100%"> <TR><TD COLSPAN=3><B>VIA onboard chipset (via82cxxx) 48kHz only</B></TD></TR> @@ -136,7 +150,7 @@ and your sound card(s) worked together.</P> -<H4><A NAME="plugins">2.3.2.2 Audio plugins</A></H4> +<H4><A NAME="plugins">2.3.2.3 Audio plugins</A></H4> <P>MPlayer has support for audio plugins. Audio plugins can be used for changing the properties of the audio data before the sound reaches the sound @@ -164,7 +178,7 @@ <P>Currently audio plugins can not be used in MEncoder.</P> -<H5><A NAME="resample">2.3.2.2.1 Up/Downsampling</A></H5> +<H5><A NAME="resample">2.3.2.3.1 Up/Downsampling</A></H5> <P>MPlayer fully supports up/downsampling of the sound. This plugin can be used if you have a fixed frequency sound card or if you are @@ -184,7 +198,7 @@ in addition to audio distortion.</P> -<H5><A NAME="surround_decoding">2.3.2.2.2 Surround Sound decoding</A></H5> +<H5><A NAME="surround_decoding">2.3.2.3.2 Surround Sound decoding</A></H5> <P>MPlayer has an audio plugin that can decode matrix encoded surround sound. Dolby Surround is an example of a matrix encoded format. @@ -195,7 +209,7 @@ <CODE>mplayer media.avi -aop list=surround</CODE></P> -<H5><A NAME="format">2.3.2.2.3 Sample format converter</A></H5> +<H5><A NAME="format">2.3.2.3.3 Sample format converter</A></H5> <P>If your sound card driver does not support signed 16bit <CODE>int</CODE> data type, this plugin can @@ -210,7 +224,7 @@ list=format:format=<required output format></CODE></P> -<H5><A NAME="delay">2.3.2.2.4 Delay</A></H5> +<H5><A NAME="delay">2.3.2.3.4 Delay</A></H5> <P>This plugin delays the sound and is intended as an example of how to develop new plugins. It can not be used for anything useful from a users perspective @@ -218,7 +232,7 @@ plugin unless you are a developer.</P> -<H5><A NAME="volume">2.3.2.2.5 Software volume control</A></H5> +<H5><A NAME="volume">2.3.2.3.5 Software volume control</A></H5> <P>This plugin is a software replacement for the volume control, and can be used on machines with a broken mixer device. It can also be @@ -251,7 +265,7 @@ list=volume:softclip</CODE></P> -<H5><A NAME="extrastereo">2.3.2.2.6 Extrastereo</A></H5> +<H5><A NAME="extrastereo">2.3.2.3.6 Extrastereo</A></H5> <P>This plugin (linearly) increases the difference between left and right channels (like the XMMS extrastereo plugin) which gives some sort of "live" @@ -267,7 +281,7 @@ -1.0, left and right channels will be swapped.</P> -<H5><A NAME="normalizer">2.3.2.2.7 Volume normalizer</A></H5> +<H5><A NAME="normalizer">2.3.2.3.7 Volume normalizer</A></H5> <P>This plugin maximizes the volume without distorting the sound.</P>
--- a/DOCS/video.html Wed Nov 13 01:17:58 2002 +0000 +++ b/DOCS/video.html Wed Nov 13 05:13:51 2002 +0000 @@ -69,8 +69,9 @@ stepping 0] doesn't support MTRR, but stepping 12's do ('<CODE>cat /proc/cpuinfo</CODE>' to check it').</P> +<H4><A NAME="normal">2.3.1.2 Video outputs for traditional video cards</A></H4> -<H4><A NAME="xv">2.3.1.2 Xv</A></H4> +<H4><A NAME="xv">2.3.1.2.1 Xv</A></H4> <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. Also, @@ -130,7 +131,7 @@ </UL> -<H5><A NAME="xv_3dfx">2.3.1.2.1 3dfx cards</A></H5> +<H4><A NAME="xv_3dfx">2.3.1.2.1.1 3dfx cards</A></H4> <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 @@ -143,7 +144,7 @@ <A HREF="#tdfxfb">tdfxfb</A> section.</P> -<H5><A NAME="xv_s3">2.3.1.2.2 S3 cards</A></H5> +<H4><A NAME="xv_s3">2.3.1.2.1.2 S3 cards</A></H4> <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.. there is @@ -155,7 +156,7 @@ driver.</P> -<H5><A NAME="xv_nvidia">2.3.1.2.3 nVidia cards</A></H5> +<H4><A NAME="xv_nvidia">2.3.1.2.1.3 nVidia cards</A></H4> <P>nVidia isn't a very good choice under Linux (according to nVidia, this is <A HREF="users_against_developers.html#nvidia">not true</A>).. You'll have to @@ -170,7 +171,7 @@ Complain to nVidia.</P> -<H5><A NAME="xv_ati">2.3.1.2.4 ATI cards</A></H5> +<H4><A NAME="xv_ati">2.3.1.2.1.4 ATI cards</A></H4> <UL> <LI>The <A HREF="http://gatos.sourceforge.net">GATOS driver</A> (which you @@ -185,7 +186,7 @@ </UL> -<H5><A NAME="xv_neomagic">2.3.1.2.5 NeoMagic cards</A></H5> +<H4><A NAME="xv_neomagic">2.3.1.2.1.5 NeoMagic cards</A></H4> <P>These cards can be found in many laptops. Unfortunately, the driver in X 4.2.0 can't do Xv, but we have a modified, Xv-capable driver for you. @@ -202,24 +203,24 @@ EndSection</P> -<H5><A NAME="xv_trident">2.3.1.2.6 Trident cards</A></H5> +<H4><A NAME="xv_trident">2.3.1.2.1.6 Trident cards</A></H4> <P>If you want to use xv with a trident card, provided that it doesn't work with 4.1.0, install XFree 4.2.0. 4.2.0 adds support for fullscreen xv support with the Cyberblade XP card.</P> -<H4><A NAME="dga">2.3.1.3 DGA</A></H4> +<H4><A NAME="dga">2.3.1.2.2 DGA</A></H4> -<H5><A NAME="dga_summary">2.3.1.3.1 Summary</A></H5> +<H4><A NAME="dga_summary">2.3.1.2.2.1 Summary</A></H4> <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> -<H5><A NAME="dga_whatis">2.3.1.3.2 What is DGA</A></H5> +<H4><A NAME="dga_whatis">2.3.1.2.2.2 What is DGA</A></H4> <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. @@ -246,7 +247,7 @@ driver that controls this chip. So it does not work on every system ...</P> -<H5><A NAME="dga_installation">2.3.1.3.3 Installing DGA support for MPlayer</A></H5> +<H4><A NAME="dga_installation">2.3.1.2.2.3 Installing DGA support for MPlayer</A></H4> <P>First make sure X loads the DGA extension, see in /var/log/XFree86.0.log:</P> @@ -283,7 +284,7 @@ much faster.</P> -<H5><A NAME="dga_resolution">2.3.1.3.4 Resolution switching</A></H5> +<H4><A NAME="dga_resolution">2.3.1.2.2.4 Resolution switching</A></H4> <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 @@ -301,7 +302,7 @@ <P>See appendix A for some sample modeline definitions.</P> -<H5><A NAME="dga_mplayer">2.3.1.3.5 DGA & MPlayer</A></H5> +<H4><A NAME="dga_mplayer">2.3.1.2.2.5 DGA & MPlayer</A></H4> <P>DGA is used in two places with MPlayer: The SDL driver can be made to make use of it (-vo sdl:dga) and within the DGA driver (-vo dga). The above @@ -309,7 +310,7 @@ driver for MPlayer works.</P> -<H5><A NAME="dga_features">2.3.1.3.6 Features of the DGA driver</A></H5> +<H4><A NAME="dga_features">2.3.1.2.2.6 Features of the DGA driver</A></H4> <P>The DGA driver is invoked by specifying -vo dga at the command line. The default behavior is to switch to a resolution matching the original @@ -348,7 +349,7 @@ CPU time!) depending on the implementation of DGA for your hardware.</P> -<H5><A NAME="dga_speed">2.3.1.3.7 Speed issues</A></H5> +<H4><A NAME="dga_speed">2.3.1.2.2.7 Speed issues</A></H4> <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. @@ -373,7 +374,7 @@ CPUs might work at 400 MHZ and above.</P> -<H5><A NAME="dga_bugs">2.3.1.3.8 Known bugs</A></H5> +<H4><A NAME="dga_bugs">2.3.1.2.2.8 Known bugs</A></H4> <P>Well, according to some developers of XFree, DGA is quite a beast. They tell you better not to use it. Its implementation is not always flawless @@ -396,7 +397,7 @@ </UL> -<H5><A NAME="dga_future">2.3.1.3.9 Future work</A></H5> +<H4><A NAME="dga_future">2.3.1.2.2.9 Future work</A></H4> <UL> <LI>use of the new X11 render interface for OSD</LI> @@ -404,7 +405,7 @@ </UL> -<H5><A NAME="dga_modelines">2.3.1.3.A Some modelines</A></H5> +<H4><A NAME="dga_modelines">2.3.1.2.2.A Some modelines</A></H4> <PRE> Section "Modes" @@ -423,7 +424,7 @@ module.</P> -<H5><A NAME="dga_bug_reports">2.3.1.3.B Bug Reports</A></H5> +<H4><A NAME="dga_bug_reports">2.3.1.2.2.B Bug Reports</A></H4> <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 @@ -437,7 +438,7 @@ <P><I>Acki (acki@acki-netz.de, www.acki-netz.de)</I></P> -<H4><A NAME="sdl">2.3.1.4 SDL</A></H4> +<H4><A NAME="sdl">2.3.1.2.3 SDL</A></H4> <P>SDL (Simple Directmedia Layer) is basically a unified video/audio interface. Programs that use it know only about SDL, and not about what video @@ -489,7 +490,7 @@ </UL> -<H4><A NAME="svgalib">2.3.1.5 SVGAlib</A></H4> +<H4><A NAME="svgalib">2.3.1.2.4 SVGAlib</A></H4> <H4>Installation</H4> @@ -525,7 +526,7 @@ <CODE>-noaspect</CODE></P> -<H4><A NAME="fbdev">2.3.1.6 Framebuffer output (FBdev)</A></H4> +<H4><A NAME="fbdev">2.3.1.2.5 Framebuffer output (FBdev)</A></H4> <P>Whether to build the FBdev target is autodetected during ./configure . Read the framebuffer documentation in the kernel sources @@ -534,8 +535,8 @@ <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> + 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> @@ -578,10 +579,10 @@ and don't ask for it, since it's not an MPlayer limitation.</P> -<H4><A NAME="mga_vid">2.3.1.7 Matrox framebuffer (mga_vid)</A></H4> +<H4><A NAME="mga_vid">2.3.1.2.6 Matrox framebuffer (mga_vid)</A></H4> <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 + 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> @@ -621,14 +622,14 @@ change: <CODE>echo "brightness=120" > /dev/mga_vid</CODE></P> -<H4><A NAME="tdfxfb">2.3.1.8 3dfx YUV support (tdfxfb)</A></H4> +<H4><A NAME="tdfxfb">2.3.1.2.7 3dfx YUV support (tdfxfb)</A></H4> <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> -<H4><A NAME="opengl">2.3.1.9 OpenGL output</A></H4> +<H4><A NAME="opengl">2.3.1.2.8 OpenGL output</A></H4> <P>MPlayer supports displaying movies using OpenGL, but if your platform/driver supports xv as should be the case on a PC with Linux, use xv @@ -646,7 +647,7 @@ for download and installation instructions.</P> -<H4><A NAME="aalib">2.3.1.10 AAlib - text mode displaying</A></H4> +<H4><A NAME="aalib">2.3.1.2.9 AAlib - text mode displaying</A></H4> <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, @@ -704,13 +705,13 @@ <P>Playing on terminal you'll get better speed and quality using the Linux driver, not curses (<CODE>-aadriver linux</CODE>). But therefore you need write access on - <CODE>/dev/vcsa<terminal></CODE>. That isn't autodetected by aalib, but vo_aa tries - to find the best mode. See + <CODE>/dev/vcsa<terminal></CODE>. That isn't autodetected by aalib, but 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> -<H4><A NAME="vesa">2.3.1.11 VESA - output to VESA BIOS</A></H4> +<H4><A NAME="vesa">2.3.1.2.10 VESA - output to VESA BIOS</A></H4> <P>This driver was designed and introduced as a <B>generic driver</B> for any video card which has VESA VBE 2.0+ compatible BIOS. Another advantage of this @@ -800,7 +801,7 @@ </UL> -<H4><A NAME="x11">2.3.1.12 X11</A></H4> +<H4><A NAME="x11">2.3.1.2.11 X11</A></H4> <P>Avoid if possible. Outputs to X11 (uses shared memory extension), with no hardware acceleration at all. Supports (MMX/3DNow/SSE accelerated, but still @@ -830,7 +831,7 @@ video modes.</P> -<H4><A NAME="vidix">2.3.1.13 VIDIX</A></H4> +<H4><A NAME="vidix">2.3.1.2.12 VIDIX</A></H4> <P>VIDIX is the abbreviation for <B>VID</B>eo <B>I</B>nterface for *ni<B>X</B>.<BR> @@ -850,7 +851,7 @@ <UL> <LI>You can use standalone video output driver: <CODE>-vo xvidix</CODE><BR> - This driver was developed as X11's front end to VIDIX technology. It + This driver was developed as X11's front end to VIDIX technology. It requires X server and can work only under X server. Note that, as it directly accesses the hardware and circumvents the X driver, pixmaps cached in the graphics card's memory may be corrupted. You can prevent @@ -938,11 +939,11 @@ brightness.</DD> <DT><CODE>-saturation</CODE></DT> - <DD>Adjust <B>SATURATION</B> of video output. You can get grayscale + <DD>Adjust <B>SATURATION</B> of video output. You can get grayscale output with this option.</DD> <DT><CODE>-hue</CODE></DT> - <DD>Adjust <B>HUE</B> of video signal. You can get colored negative + <DD>Adjust <B>HUE</B> of video signal. You can get colored negative of image with this option.</DD> <DT><CODE>-red_intensity</CODE></DT> @@ -970,95 +971,47 @@ filename.vob</CODE></P> -<H4><A NAME="zr">2.3.1.14 Zr</A></H4> - -<P>This is a display-driver (<CODE>-vo zr</CODE>) for a number of MJPEG - capture/playback cards (tested for DC10+ and Buz, and it should work for the - LML33 and the original DC10). The driver works by encoding the frame to jpeg - and then sending it to the card. For the jpeg encoding <B>libavcodec</B> is - used, and required. With the special <I>cinerama</I> mode, you can watch - movies in true wide screen provided that you have two beamers and two - MJPEG cards. Depending on resolution and quality settings, this driver - may require a lot of CPU power, remember to specify <CODE>-framedrop</CODE> - if your machine is too slow. Note: My AMD K6-2 350MHz is (with <CODE> - -framedrop</CODE>) quite adequate for watching VCD sized material and - downscaled movies. - -<P>This driver talks to the kernel driver available at - <A HREF="http://mjpeg.sourceforge.net">http://mjpeg.sourceforge.net</A>, so - you must get it working first. The presence of an MJPEG card is autodetected - by the configure script, if autodetection fails, force detection with +<H4><A NAME="directfb">2.3.1.2.13 DirectFB</A></H4> -<PRE> - ./configure --enable-zr -</PRE> - -<P>The output can be controlled by several options, a long description of the - options can be found in the man page, a short list of options can be - viewed by running +<P><I>"DirectFB is a graphics library which was designed with embedded systems in + mind. It offers maximum hardware accelerated performance at a minimum of + resource usage and overhead."</I> - quoted from + <A HREF="http://www.directfb.org">http://www.directfb.org</A>.</P> -<PRE> - mplayer -zrhelp -</PRE> - -<P>Things like scaling and the OSD (on screen display) are not handled by - this driver but can be done using the video filters. For example, - suppose that you have a movie with a resolution of <CODE>512x272</CODE> and - you want to view it fullscreen on your DC10+. There are three main - possibilities, you may scale the movie to a width of <CODE>768</CODE>, - <CODE>384</CODE> or <CODE>192</CODE>. For performance and quality reasons, - I would choose to scale the movie to <CODE>384x204</CODE> using the fast - bilinear software scaler. The commandline is +<P>I'll exclude DirectFB features from this section.</P> -<PRE> - mplayer -vo zr -sws 0 -vop scale=384:204 movie.avi -</PRE> - -<P>Cropping can be done by the <CODE>crop</CODE> filter and by - this driver itself. Suppose that a movie is too wide for display on your - Buz and that you want to use <CODE>-zrcrop</CODE> to make the movie less - wide, the you would issue the following command - -<PRE> - mplayer -vo zr -zrcrop 720x320+80+0 benhur.avi -</PRE> - - if you want to use the <CODE>crop</CODE> filter, you would do - -<PRE> - mplayer -vo zr -vop crop=720:320:80:0 benhur.avi -</PRE> +<P>Though MPlayer is not supported as a "video provider" in DirectFB, this + output driver will enable video playback through DirectFB. It will - + of course - be accelerated, on my Matrox G400 DirectFB's speed was the + same as XVideo.</P> -<P>Extra occurances of <CODE>-zrcrop</CODE> invoke <I>cinerama</I> mode, i.e. - you can distribute the movie over several TV's or beamers to create a larger - screen. Suppose you have two beamers. The left one is connected to your Buz - at <CODE>/dev/video1</CODE> and the right one is connected to your DC10+ at - <CODE>/dev/video0</CODE>. The movie has a resolution of <CODE>704x288</CODE>. - Suppose also that you want the right beamer in black and white and that - the right beamer should have jpeg frames at quality <CODE>10</CODE>, - then you would issue the following command - -<PRE> - mplayer -vo zr -zrdev /dev/video0 -zrcrop 352x288+352+0 -zrxdoff 0 -zrbw \ - -zrcrop 352x288+0+0 -zrdev /dev/video1 -zrquality 10 movie.avi -</PRE> - -<P>You see that the options appearing before the second <CODE>-zrcrop</CODE> - only apply to the DC10+ and that the options after the second - <CODE>-zrcrop</CODE> apply to the Buz. The maximum number of MJPEG cards - participating in <I>cinerama</I> is four, so you can buid a <CODE>2x2</CODE> - vidiwall.</P> - -<P>Finally an important remark: Do not start or stop XawTV on the playback - device during playback, it will crash your computer. It is, however, fine to - <B>FIRST</B> start XawTV, <B>THEN</B> start MPlayer, wait for - MPlayer to finish and <B>THEN</B> stop XawTV.</P> +<P>Always try to use the newest version of DirectFB. You can use DirectFB + options on the command line, using the <CODE>-dfbopts</CODE> option. + Layer selection can be done by the subdevice method, e.g.: <CODE>-vo + directfb:2</CODE> (layer -1 is default: autodetect)</P> -<H4><A NAME="dvb">2.3.1.15 DVB</A></H4> +<H4><A NAME="dfbmga">2.3.1.2.14 DirectFB/Matrox (dfbmga)</A></H4> + +<P>Please read the <A HREF=#directfb>main DirectFB section</A> for general + informations.</P> + +<P>This video output driver will enable CRTC2 (on the second head) on the + Matrox G400 card, displaying video <B>independently</B> of the first head.</P> + +<P>Instructions on how to make it work can be found here: + <A HREF="http://www.sci.fi/~syrjala/directfb/readme.txt">http://www.sci.fi/~syrjala/directfb/readme.txt</A></P> + +<P>Note: we haven't been able to make this work, but others did. Anyway, + porting of the CRTC2 code to <B>mga_vid</B> is underway.</P> + + +<H4><A NAME="mpegdec">2.3.1.3 MPEG decoders</A></H4> + +<H4><A NAME="dvb">2.3.1.3.1 DVB</A></H4> <P>MPlayer supports cards with the Siemens DVB chipset from vendors like - Siemens, Technotrend, Galaxis or Hauppauge. The latest DVB drivers are + Siemens, Technotrend, Galaxis or Hauppauge. The latest DVB drivers are available from the <A HREF="http://www.linuxtv.org">Linux TV site</A>. If you want to do software transcoding you should have at least a 1GHz CPU.</P> @@ -1158,7 +1111,12 @@ decompression).</P> -<H4><A NAME="dxr3">2.3.1.16 DXR3/Hollywood+</A></H4> +<H4><A NAME="dxr2">2.3.1.3.2 DXR2</A></H4> + +<P>TODO: somebody please fill this section with information.</P> + + +<H4><A NAME="dxr3">2.3.1.3.3 DXR3/Hollywood+</A></H4> <P>MPlayer supports hardware accelerated playback with the Creative DXR3 and Sigma Designs Hollywood Plus cards. These cards both use the em8300 MPEG @@ -1233,7 +1191,15 @@ reason for this is unknown to us. If you set it to somewhere between 25 and 27 the picture becomes stable. For now all we can do is accept this for a fact.</DD> - + + <DT><CODE>-vop lavc,expand=-1:-1:-1:-1:1</CODE></DT> + <DD>Altough the DXR3 driver can put some OSD onto the MPEG1/2/4 video, + it has much lower quality than MPlayer's traditional OSD, and has several + refresh problems as well. The command line above will firstly convert the + input video to MPEG4 (this is mandatory, sorry), then apply an expand + filter which won't expand anything (-1: default), but apply the normal OSD + onto the picture (that's what the "1" at the end does).</DD> + <DT><CODE>-ac hwac3</CODE></DT> <DD>The em8300 supports playing back AC3 audio (surround sound) through the digital audio output of the card. See the <CODE>-ao oss</CODE> option @@ -1253,10 +1219,103 @@ that it will need more CPU power, and you might loose some picture quality.</P> -<H4><A NAME="tv-out">2.3.1.A TV-out support</A></H4> +<H4><A NAME="other">2.3.1.4 Other visualization hardware</A></H4> + +<H4><A NAME="zr">2.3.1.4.1 Zr</A></H4> + +<P>This is a display-driver (<CODE>-vo zr</CODE>) for a number of MJPEG + capture/playback cards (tested for DC10+ and Buz, and it should work for the + LML33 and the original DC10). The driver works by encoding the frame to jpeg + and then sending it to the card. For the jpeg encoding <B>libavcodec</B> is + used, and required. With the special <I>cinerama</I> mode, you can watch + movies in true wide screen provided that you have two beamers and two + MJPEG cards. Depending on resolution and quality settings, this driver + may require a lot of CPU power, remember to specify <CODE>-framedrop</CODE> + if your machine is too slow. Note: My AMD K6-2 350MHz is (with <CODE> + -framedrop</CODE>) quite adequate for watching VCD sized material and + downscaled movies. + +<P>This driver talks to the kernel driver available at + <A HREF="http://mjpeg.sourceforge.net">http://mjpeg.sourceforge.net</A>, so + you must get it working first. The presence of an MJPEG card is autodetected + by the configure script, if autodetection fails, force detection with + +<PRE> + ./configure --enable-zr +</PRE> + +<P>The output can be controlled by several options, a long description of the + options can be found in the man page, a short list of options can be + viewed by running + +<PRE> + mplayer -zrhelp +</PRE> + +<P>Things like scaling and the OSD (on screen display) are not handled by + this driver but can be done using the video filters. For example, + suppose that you have a movie with a resolution of <CODE>512x272</CODE> and + you want to view it fullscreen on your DC10+. There are three main + possibilities, you may scale the movie to a width of <CODE>768</CODE>, + <CODE>384</CODE> or <CODE>192</CODE>. For performance and quality reasons, + I would choose to scale the movie to <CODE>384x204</CODE> using the fast + bilinear software scaler. The commandline is + +<PRE> + mplayer -vo zr -sws 0 -vop scale=384:204 movie.avi +</PRE> + +<P>Cropping can be done by the <CODE>crop</CODE> filter and by + this driver itself. Suppose that a movie is too wide for display on your + Buz and that you want to use <CODE>-zrcrop</CODE> to make the movie less + wide, the you would issue the following command + +<PRE> + mplayer -vo zr -zrcrop 720x320+80+0 benhur.avi +</PRE> + + if you want to use the <CODE>crop</CODE> filter, you would do + +<PRE> + mplayer -vo zr -vop crop=720:320:80:0 benhur.avi +</PRE> + +<P>Extra occurances of <CODE>-zrcrop</CODE> invoke <I>cinerama</I> mode, i.e. + you can distribute the movie over several TV's or beamers to create a larger + screen. Suppose you have two beamers. The left one is connected to your Buz + at <CODE>/dev/video1</CODE> and the right one is connected to your DC10+ at + <CODE>/dev/video0</CODE>. The movie has a resolution of <CODE>704x288</CODE>. + Suppose also that you want the right beamer in black and white and that + the right beamer should have jpeg frames at quality <CODE>10</CODE>, + then you would issue the following command + +<PRE> + mplayer -vo zr -zrdev /dev/video0 -zrcrop 352x288+352+0 -zrxdoff 0 -zrbw \ + -zrcrop 352x288+0+0 -zrdev /dev/video1 -zrquality 10 movie.avi +</PRE> + +<P>You see that the options appearing before the second <CODE>-zrcrop</CODE> + only apply to the DC10+ and that the options after the second + <CODE>-zrcrop</CODE> apply to the Buz. The maximum number of MJPEG cards + participating in <I>cinerama</I> is four, so you can buid a <CODE>2x2</CODE> + vidiwall.</P> + +<P>Finally an important remark: Do not start or stop XawTV on the playback + device during playback, it will crash your computer. It is, however, fine to + <B>FIRST</B> start XawTV, <B>THEN</B> start MPlayer, wait for + MPlayer to finish and <B>THEN</B> stop XawTV.</P> -<H5><A NAME="tv-out_matrox">2.3.1.A.1 Matrox G400 cards</A></H5> +<H4><A NAME="blinken">2.3.1.4.2 Blinkenlights</A></H4> + +<P>This driver is capable of playback using the Blinkenlights UPD protocol. + If you don't know what Blinkenlights is, you don't need this driver.</P> + + +<H4><A NAME="tv-out">2.3.1.5 TV-out support</A></H4> + + +<H4><A NAME="tv-out_matrox">2.3.1.5.1 Matrox G400 cards</A></H4> <P>Under Linux you have 2 methods to get G400 TV out working:</P> @@ -1319,8 +1378,17 @@ </LI> </UL> +<H4>Building a Matrox TV-out cable</H4> -<H5><A NAME="tv-out_matrox_g450">2.3.1.A.2 Matrox G450/G550 cards</A></H5> +<P>This information was contributed by <B>Rácz Balázs</B>. Of course + no one takes any responsibility, nor guarantee for any damage caused + by this documentation.</P> + +<P>The CRTC2 connector's fourth pin is the composite video signal. The ground + are the sixth, seventh and eighth pins.</P> + + +<H4><A NAME="tv-out_matrox_g450">2.3.1.5.2 Matrox G450/G550 cards</A></H4> <P>TV output support for these cards has only been recently introduced, and is not yet in the mainstream kernel. Currently the <B>mga_vid</B> module @@ -1339,7 +1407,7 @@ <A HREF="http://www3.sympatico.ca/dan.eriksen/matrox_tvout/">http://www3.sympatico.ca/dan.eriksen/matrox_tvout/</A></P> -<H5><A NAME="tv-out_ati">2.3.1.A.3 ATI cards</A></H5> +<H4><A NAME="tv-out_ati">2.3.1.5.3 ATI cards</A></H4> <H5>PREAMBLE</H5> @@ -1366,7 +1434,7 @@ POST procedure.</P> -<H5><A NAME="tv-out_voodoo">2.3.1.A.4 Voodoo 3</A></H5> +<H4><A NAME="tv-out_voodoo">2.3.1.5.4 Voodoo 3</A></H4> <P>Check <A HREF="http://www.iki.fi/too/tvout-voodoo3-3000-xfree">this URL</A>.</P>