# HG changeset patch # User diego # Date 1035116439 0 # Node ID 988498df19965c7270713cfea7d322030a28d995 # Parent 76940a39405a88283bc8f2c7de09068d0f8b42c8 MPlayer ---> MPlayer diff -r 76940a39405a -r 988498df1996 DOCS/bugreports.html --- a/DOCS/bugreports.html Sun Oct 20 11:34:06 2002 +0000 +++ b/DOCS/bugreports.html Sun Oct 20 12:20:39 2002 +0000 @@ -16,7 +16,7 @@ software project. But just like writing good software, good problem reports involve some work. Please realize that most developers are extremely busy and receive obscene amounts of email. So while your feedback is crucial in - improving MPlayer and very much appreciated, please understand that you + improving MPlayer and very much appreciated, please understand that you have to provide all of the information we request and follow the instructions in this document closely.

@@ -26,14 +26,14 @@

If you feel have the necessary skills you are invited to have a go at fixing the bug yourself. Or maybe you already did that? Please read this short document to find out how to get - your code included in MPlayer. The people on the + your code included in MPlayer. The people on the mplayer-dev-eng mailing list will assist you if you have questions.

How to report bugs

-

First of all please try the latest CVS version of MPlayer as your bug +

First of all please try the latest CVS version of MPlayer as your bug might already be fixed there. Development moves extremely fast, most problems in official releases are reported within days or even hours, so please use only CVS to report bugs. CVS instructions can be found at the bottom of @@ -46,7 +46,7 @@

Please do not send bug reports privately to individual developers. This is community work and thus there might be several people interested in it. Sometimes other users already experienced your troubles and know how to - circumvent a problem even if it is a bug in MPlayer code.

+ circumvent a problem even if it is a bug in MPlayer code.

Please describe your problem in as much detail as possible. Do a little detective work to narrow down the circumstances under which the problem @@ -164,7 +164,7 @@

For playback problems

-

Please include the output of MPlayer at verbosity level 1, but +

Please include the output of MPlayer at verbosity level 1, but remember to not truncate the output when you paste it into your mail. The developers need all of the messages to properly diagnose a problem. You can direct the output into a file like this:

@@ -179,7 +179,7 @@

Also upload a small text file having the same base name as your file with a .txt extension. Describe the problem you are having with the particular file there and include your email address as well as the output - of MPlayer at verbosity level 1. Usually the first 1-5 MB of a file are + of MPlayer at verbosity level 1. Usually the first 1-5 MB of a file are enough to reproduce the problem, but to be sure we ask you to:

    dd if=yourfile of=smallfile bs=1024k count=5

@@ -220,12 +220,12 @@

How to conserve information about a reproducible crash

-Recompile MPlayer with debugging code enabled: +Recompile MPlayer with debugging code enabled:

    ./configure --enable-debug=3
    make

-and then run MPlayer within gdb using: +and then run MPlayer within gdb using:

    gdb ./mplayer

@@ -254,7 +254,7 @@

I know what I am doing...

If you created a proper bug report following the steps above and you are - confident it is a bug in MPlayer, not a compiler problem or broken + confident it is a bug in MPlayer, not a compiler problem or broken file, you have already read the documentation and you could not find a solution, your sound drivers are OK, then you might want to subscribe to the mplayer-advusers list and send your bug report there to get a better and @@ -263,7 +263,7 @@ in the manual there, you will be ignored or flamed instead of getting an appropriate answer.
So do not flame us and subscribe to -advusers only if you really know - what you are doing and feel like being an advanced MPlayer user or + what you are doing and feel like being an advanced MPlayer user or developer. If you meet these criteria it should not be difficult to find out how to subscribe...

diff -r 76940a39405a -r 988498df1996 DOCS/cd-dvd.html --- a/DOCS/cd-dvd.html Sun Oct 20 11:34:06 2002 +0000 +++ b/DOCS/cd-dvd.html Sun Oct 20 12:20:39 2002 +0000 @@ -60,9 +60,9 @@

4.2 DVD playback

-

MPlayer uses libdvdread and libdvdcss for +

MPlayer uses libdvdread and libdvdcss for DVD decryption and playback. These two libraries are contained in the - libmpdvdkit2/ subdirectory of the MPlayer source tree, you + libmpdvdkit2/ subdirectory of the MPlayer source tree, you do not have to install them separately. We opted for this solution because we had to fix a libdvdread bug, and apply a patch which adds cracked CSS keys caching support to libdvdcss. This results in a large @@ -70,7 +70,7 @@ playing. The cracked keys are stored in the ~/.mplayer/DVDKeys directory.

-

MPlayer can also use system-wide libdvdread and +

MPlayer can also use system-wide libdvdread and libdvdcss libraries, but this solution is not recommended, as it can result in bugs, library incompatibilities, and slower speed.

@@ -80,7 +80,7 @@

Old-style DVD support - OPTIONAL

Useful if you want to play encoded VOBs from hard disk. Compile and - install libcss 0.0.1 (not newer) for this (If MPlayer fails to + install libcss 0.0.1 (not newer) for this (If MPlayer fails to detect it, use the -csslib /path/to/libcss.so option).

For the complete list of available options, please read the man page.

diff -r 76940a39405a -r 988498df1996 DOCS/codecs.html --- a/DOCS/codecs.html Sun Oct 20 11:34:06 2002 +0000 +++ b/DOCS/codecs.html Sun Oct 20 12:20:39 2002 +0000 @@ -47,7 +47,7 @@

This section contains information about the DivX4 and DivX5 codecs of Project Mayo. Their first available alpha version was OpenDivX 4.0 alpha 47 and 48. Support for this was included - in MPlayer in the past, and built by default. We also used its + in MPlayer in the past, and built by default. We also used its postprocessing code to optionally enhance visual quality of MPEG1/2 movies. Now we use our own, for all file types.

@@ -67,7 +67,7 @@

Note: Do not forget adding /usr/local/lib to your /etc/ld.so.conf and running ldconfig!

-

MPlayer autodetects DivX4/DivX5 if it is properly installed, just +

MPlayer autodetects DivX4/DivX5 if it is properly installed, just compile as usual. If it does not detect it, you did not install or configure it correctly.

@@ -76,7 +76,7 @@
-vc odivx
Uses the codec in OpenDivX fashion. In this case it - produces YV12 images in its own buffer, and MPlayer does colorspace + produces YV12 images in its own buffer, and MPlayer does colorspace conversion via libvo. (Fast, recommended!)
-vc divx4
@@ -107,22 +107,22 @@ variants: DivX 3, DivX 4, DivX 5, Windows Media Video 7 (WMV1)

-

If you use an MPlayer release you have libavcodec right in the - package, just build as usual. If you use MPlayer from CVS you have to +

If you use an MPlayer release you have libavcodec right in the + package, just build as usual. If you use MPlayer from CVS you have to extract libavcodec from the FFmpeg CVS tree as FFmpeg 0.4.5 does not - work with MPlayer. In order to achieve this do:

+ work with MPlayer. In order to achieve this do:

  1. cvs -d:pserver:anonymous@cvs.ffmpeg.sourceforge.net:/cvsroot/ffmpeg login
  2. cvs -d:pserver:anonymous@cvs.ffmpeg.sourceforge.net:/cvsroot/ffmpeg co ffmpeg
  3. Move the libavcodec directory from the FFmpeg sources to the - root of the MPlayer CVS tree. It should look like this: + root of the MPlayer CVS tree. It should look like this:

        main/libavcodec

    Symlinking is not enough, you have to copy or move it!
  4. Compile. Configure should detect problems before compilation.
-

Note: MPlayer from CVS does contain a libavcodec +

Note: MPlayer from CVS does contain a libavcodec subdirectory, but it does not contain the source for libavcodec! You must follow the steps above to obtain the source for this library.

@@ -140,7 +140,7 @@ action against anyone for codec-related issues.

-

MPlayer is capable of employing the XAnim codecs for decoding. Follow +

MPlayer is capable of employing the XAnim codecs for decoding. Follow the instructions to enable them:

    @@ -157,7 +157,7 @@

XAnim is video codec family number 10, so you may want to use the -vfm 10 - option to tell MPlayer to use them if possible.

+ option to tell MPlayer to use them if possible.

Tested codecs include: Indeo 3.2, 4.1, 5.0, CVID, 3ivX, h263.

@@ -165,7 +165,7 @@

2.2.1.4 VIVO video

-

MPlayer can play Vivo (1.0 and 2.0) videos. The most suitable codec +

MPlayer can play Vivo (1.0 and 2.0) videos. The most suitable codec for 1.0 files is FFmpeg's H263 decoder, you can use it with the -vc ffh263 option (default). For 2.0 files, use the ivvideo.dll @@ -176,7 +176,7 @@

2.2.1.5 MPEG 1/2 video

MPEG1 and MPEG2 are decoded by the multiplatform native libmpeg2 - library, whose source code is included in MPlayer. We handle buggy + library, whose source code is included in MPlayer. We handle buggy MPEG 1/2 video files by catching sig11 (segmentation fault), and quickly reinitializing the codec, continuing exactly from where the failure occurred. This recovery technique has no measurable speed penalty.

@@ -192,14 +192,14 @@

2.2.1.7 Cinepak CVID

-

MPlayer uses its own open source, multiplatform Cinepak decoder by +

MPlayer uses its own open source, multiplatform Cinepak decoder by default. It supports YUV outputs, so that hardware scaling is possible if the video output driver permits it.

2.2.1.8 RealVideo

-MPlayer supports decoding all versions of RealVideo: +MPlayer supports decoding all versions of RealVideo:

It is recommended to download and install RealPlayer8 or RealONE, because - MPlayer can use their libraries to decode files with RealVideo 2.0 - - 4.0 video. The MPlayer configure script should detect the + MPlayer can use their libraries to decode files with RealVideo 2.0 - + 4.0 video. The MPlayer configure script should detect the RealPlayer libraries in the standard locations of a full installation. If it does not, tell configure where to look with the --with-reallibdir switch.

@@ -258,7 +258,7 @@
  • make -f Makefile.linux
  • Get encore2.h and decore.h from the DivX4Linux package, and copy them to /usr/local/include/.
    • -
  • Recompile MPlayer with --with-xvidcore=/path/to/libcore.a.
    • +
  • Recompile MPlayer with --with-xvidcore=/path/to/libcore.a.
    • @@ -354,13 +354,13 @@ VIVO/2.0 file. VIVO/1.0 files have g.723 audio, and VIVO/2.0 files have Vivo Siren audio. Both are supported. You can grab the g.723/Siren - Win32 DLL from the MPlayer site, + Win32 DLL from the MPlayer site, then copy it into the /usr/lib/win32 directory.

    2.2.2.5 RealAudio

    -MPlayer supports decoding nearly all versions of RealAudio: +MPlayer supports decoding nearly all versions of RealAudio: -
  • Win32 codecs: If you plan to use MPlayer on x86 +
  • Win32 codecs: If you plan to use MPlayer on x86 architecture, you will possibly need them. Download and unzip w32codecs.zip - to /usr/lib/win32 BEFORE compiling MPlayer, otherwise no Win32 + to /usr/lib/win32 BEFORE compiling MPlayer, otherwise no Win32 support will be compiled!
    Note: the avifile project has a similar codecs package, but it differs from ours. If you want to use all supported codecs, then install our package @@ -498,14 +498,14 @@ screen, hardware YUV zoom) for decoding 3ivx and Indeo 3/4/5 movies, and some old formats. And they are multiplatform, so this is the only way to play Indeo on non-x86 platforms (well, apart from using XAnim:). But for - example Cinepak movies are best played with MPlayer's own Cinepak + example Cinepak movies are best played with MPlayer's own Cinepak decoder!
  • For Ogg Vorbis audio decoding you need to install libvorbis properly. Use deb/rpm packages if available, or compile from source (this is a nightly updated tarball of Vorbis CVS).
    • -
  • MPlayer can use the libraries of RealPlayer 8 or RealONE to play +
  • MPlayer can use the libraries of RealPlayer 8 or RealONE to play files with RealVideo 2.0 - 4.0 video, and Sipro/Cook audio. See RealMedia file format section for installation instructions and more information.
    • @@ -528,14 +528,14 @@ to use the mga_vid kernel module instead, for it works much better. Please see the mga_vid section about its installation and usage. It is important to do these steps before - compiling MPlayer, otherwise no mga_vid support will be built. Also + compiling MPlayer, otherwise no mga_vid support will be built. Also check out the Matrox TV-out section. If you don't use Linux, your only possibility is the VIDIX driver: read the VIDIX section.
  • 3Dfx Voodoo3/Banshee cards: please see the tdfxfb section in order to gain big speedup. It is important to do these steps before compiling - MPlayer, otherwise no 3Dfx support will be built. Also see the 3dfx TV-out section. If you use X, use at least 4.2.0, as the 3dfx Xv driver was broken in 4.1.0 and earlier releases.
    • @@ -636,7 +636,7 @@
  • C-Media with SP/DIF out: hardware AC3 passthrough is possible with these cards, see Hardware AC3 decoding section.
    • -
  • Features of other cards aren't supported by MPlayer. +
  • Features of other cards aren't supported by MPlayer. It's very recommended to read the sound card section!
    • @@ -646,14 +646,14 @@ -

    Then build MPlayer:

    +

    Then build MPlayer:

         ./configure
@@ -661,17 +661,17 @@
     make install
    -

    At this point, MPlayer is ready to use. The directory +

    At this point, MPlayer is ready to use. The directory $PREFIX/share/mplayer contains the codecs.conf file, which is used to tell the program all the codecs and their capabilities. This file should always be kept up to date together with the main binary.
    Check if you have codecs.conf in your home directory - (~/.mplayer/codecs.conf) left from old MPlayer versions, and remove it.

    + (~/.mplayer/codecs.conf) left from old MPlayer versions, and remove it.

    Debian users can build a .deb package for themselves, it's very simple. Just exec fakeroot debian/rules binary in - MPlayer's root directory. See + MPlayer's root directory. See Debian packaging for detailed instructions.

    @@ -712,12 +712,12 @@

    Currently you can't use the -gui option on the command line, due to technical reasons.

    -

    As MPlayer doesn't have a skin included, you have to download them if +

    As MPlayer doesn't have a skin included, you have to download them if you want to use the GUI. See the download page. They should be extracted to the usual system-wide directory ($PREFIX/share/mplayer/Skin), or to - $HOME/.mplayer/Skin. MPlayer by default looks in these + $HOME/.mplayer/Skin. MPlayer by default looks in these directories for a directory named default, but you can use the -skin newskin option, or the skin=newskin config file directive to use the skin in */Skin/newskin directory.

    @@ -726,7 +726,7 @@

    1.4 Subtitles and OSD

    - MPlayer can display subtitles along with movie files. Currently the following + MPlayer can display subtitles along with movie files. Currently the following formats are supported:

    @@ -221,18 +221,18 @@
    -
    Q: How do I create a proper patch for MPlayer?
    +
    Q: How do I create a proper patch for MPlayer?
    A: We made a short document describing all the necessary details. Please follow the instructions.
     
    -
    Q: How can I support MPlayer development?
    +
    Q: How can I support MPlayer development?
    A: We are more than happy to accept your hardware and software donations. - They help us in continuously improving MPlayer.
    + They help us in continuously improving MPlayer.
     
    -
    Q: How can I become an MPlayer developer?
    +
    Q: How can I become an MPlayer developer?
    A: We always welcome coders and documenters. Read the technical documentation to get a first grasp. Then you should subscribe to the @@ -240,7 +240,7 @@ mailing list and start coding.
     
    -
    Q: Can I run multiple instances of MPlayer?
    +
    Q: Can I run multiple instances of MPlayer?
    A: Yes. Some video out drivers like xv, dga or (x)mga are exclusive, some are exclusive in combination with certain graphics boards and drivers. You will not be able to run more than one instance of MPlayer with one of those @@ -398,16 +398,16 @@
    A: Probably the audio uses a codec not natively supported by - MPlayer. Install the Win32 codec package as described in the README + MPlayer. Install the Win32 codec package as described in the README or in the Installation section.
     
    Q: ... works with avifile/aviplay but doesn't with MPlayer.
    -
    A: MPlayer is not avifile. +
    A: MPlayer is not avifile. The only common thing between these players is the Win32 DLL loader. The codecs (DLL) set, synchronization, demultiplexing etc is totally different and shouldn't be compared. - If something works with aviplay it doesn't mean that MPlayer will + If something works with aviplay it doesn't mean that MPlayer will work and vice versa.
     
    @@ -426,7 +426,7 @@ 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 a non-patched kernel, - or use MPlayer's -afm 1 option to disable using + or use MPlayer's -afm 1 option to disable using l3codeca.acm.
     
    @@ -439,10 +439,10 @@
    Q: MPlayer dies with "MPlayer interrupted by signal 4 in module: decode_video".
    -
    A: Try running MPlayer on the machine you compiled on. Or recompile +
    A: Try running MPlayer on the machine you compiled on. Or recompile with runtime CPU detection (./configure --enable-runtime-cpudetection). Don't - use MPlayer on a CPU different from the one it was compiled on, + use MPlayer on a CPU different from the one it was compiled on, without using the feature mentioned just now.
     
    @@ -467,7 +467,7 @@ want to use arts sound, specify audio output via our native arts audio driver (-ao arts). If it fails or isn't compiled in, try SDL (-ao sdl) and make sure your SDL can handle arts sound. Yet - another option is to start MPlayer with artsdsp. + another option is to start MPlayer with artsdsp.
     
    Q: I have an AVI that produces a gray screen when played with @@ -481,7 +481,7 @@
    A: This can have multiple reasons.
     
    Q: What about the DGA driver? I can't find it!
    @@ -575,7 +575,7 @@ permissions. Help me!
    A: It works only if running as root! It's a DGA limitation. You should become root (su -), and try again. - Another solution is making MPlayer SUID root, but it's + Another solution is making MPlayer SUID root, but it's not recommended!
        chown root /usr/local/bin/mplayer
        chmod 755 /usr/local/bin/mplayer
    @@ -584,7 +584,7 @@ Warning: security risk
    This is a big security risk! Never do this on a server or on a computer that you do not control completely because other users can - gain root privileges through SUID root MPlayer. You have been + gain root privileges through SUID root MPlayer. You have been warned.
    @@ -670,7 +670,7 @@
    A: Who knows ... It's said to work, so please test it and send feedback. Refer to the documentation of libdvdread and its homepage as well. We're not the authors of libdvdread. Use libmpdvdkit2, which is present in - MPlayer source, and used by default.
    + MPlayer source, and used by default.
     
    Q: What about subtitles? Can MPlayer display them?
    @@ -713,8 +713,8 @@
    -
    Q: If MPlayer is paused and I try to seek or press any key at all, - MPlayer ceases to be paused. I would like to be able to seek in the +
    Q: If MPlayer is paused and I try to seek or press any key at all, + MPlayer ceases to be paused. I would like to be able to seek in the paused movie.
    A: This is very tricky to implement without losing A/V synchronization. All attempts have failed so far, but patches are welcome.
    @@ -740,7 +740,7 @@
    Q: How can I encode?
    -
    A: Read the MEncoder documentation.
    +
    A: Read the MEncoder documentation.
     
    Q: How can I create VCDs?
    diff -r 76940a39405a -r 988498df1996 DOCS/formats.html --- a/DOCS/formats.html Sun Oct 20 11:34:06 2002 +0000 +++ b/DOCS/formats.html Sun Oct 20 12:20:39 2002 +0000 @@ -74,7 +74,7 @@ encourages ASF/WMV. Not that anybody cares.

    There is a hack that allows AVI files to contain an Ogg Vorbis audio - stream, but makes them incompatible with standard AVI. MPlayer + stream, but makes them incompatible with standard AVI. MPlayer supports playing these files. Seeking is also implemented but severely hampered by badly encoded files with confusing headers. Unfortunately the only encoder currently capable of creating these files, NanDub, has this @@ -82,14 +82,14 @@

    Note: DV cameras create raw DV streams that DV grabbing utilities convert to two different types of AVI files. The AVI will then contain either - separate audio and video streams that MPlayer can play or the raw DV + separate audio and video streams that MPlayer can play or the raw DV stream for which support is under development.

    There are two kinds of AVI files:

    • Interleaved: Audio and video content is interleaved. This is the standard usage. Recommended and mostly used. Some tools create - non-interleaved AVIs with bad sync. MPlayer detects these as + non-interleaved AVIs with bad sync. MPlayer 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 -ni option).
      • @@ -98,7 +98,7 @@ CD-Rom difficult. (should be played with the -ni option)
    -

    MPlayer supports two kinds of timings for AVI files:

    +

    MPlayer supports two kinds of timings for AVI files:

    • bps-based: It is based on the bitrate/samplerate of the video/audio stream. This method is used by most players, including avifile @@ -125,7 +125,7 @@ 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 - is just another legal game). MPlayer supports only v1.0, as nobody has + is just another legal game). MPlayer supports only v1.0, as nobody has ever seen v2.0 files :). Note that ASF files nowadays come with the extension .WMA or .WMV.

      @@ -147,7 +147,7 @@

      2.1.1.5 VIVO files

      -

      MPlayer happily demuxes VIVO file formats. The biggest disadvantage +

      MPlayer happily demuxes VIVO file formats. The biggest disadvantage of the format is that it has no index block, nor a fixed packet size or sync bytes and most files lack even keyframes, so forget seeking!

      @@ -163,7 +163,7 @@

      2.1.1.6 FLI files

      FLI is a very old file format used by Autodesk Animator, but it is a - common file format for short animations on the net. MPlayer demuxes + common file format for short animations on the net. MPlayer demuxes and decodes FLI movies and is even able to seek within them (useful when looping with the -loop option). FLI files do not have keyframes, so the picture will be messy for a short time after seeking.

      @@ -171,7 +171,7 @@

      2.1.1.7 RealMedia (RM) files

      -

      Yes, MPlayer can read (demux) RealMedia (.rm) files. Seeking works, +

      Yes, MPlayer can read (demux) RealMedia (.rm) files. Seeking works, but you have to explicitly specify the -forceidx option (the format supports keyframes). Here are the lists of the supported RealVideo @@ -181,11 +181,11 @@

      2.1.1.8 NuppelVideo files

      NuppelVideo - is a TV grabber tool (AFAIK:). MPlayer can read its .NUV files (only + is a TV grabber tool (AFAIK:). MPlayer can read its .NUV files (only NuppelVideo 5.0). Those files can contain uncompressed YV12, YV12+RTJpeg compressed, YV12 RTJpeg+lzo compressed, and YV12+lzo compressed frames. - MPlayer decodes them all (and also encodes them with - MEncoder to DivX/etc!). Seeking works.

      + MPlayer decodes them all (and also encodes them with + MEncoder to DivX/etc!). Seeking works.

      2.1.1.9 yuv4mpeg files

      @@ -213,7 +213,7 @@

      This is a new file format from Xiphophorus. It can contain any video or audio codec, CBR or VBR. You will need to have libogg and libvorbis installed - before compiling MPlayer to be able to play it.

      + before compiling MPlayer to be able to play it.

      2.1.1.13 SDP files

      @@ -226,15 +226,15 @@

      2.1.2 Audio formats

      -

      MPlayer is a Movie and not a Media player, although +

      MPlayer is a Movie and not a Media player, although it can play some audio file formats (they are listed in the sections below). - This is not a recommended usage of MPlayer, you better use + This is not a recommended usage of MPlayer, you better use xmms.

      2.1.2.1 MP3 files

      -

      You may have problems playing certain MP3 files that MPlayer will +

      You may have problems playing certain MP3 files that MPlayer will misdetect as MPEGs and play incorrectly or not at all. This cannot be fixed without dropping support for certain broken MPEG files and thus will remain like this for the foreseeable future. The -demuxer flag diff -r 76940a39405a -r 988498df1996 DOCS/mplayer.1 --- a/DOCS/mplayer.1 Sun Oct 20 11:34:06 2002 +0000 +++ b/DOCS/mplayer.1 Sun Oct 20 12:20:39 2002 +0000 @@ -582,7 +582,7 @@ .I NOTE: .br -Mplayer doesn't accept colons so type dots instead in the device ID +MPlayer doesn't accept colons so type dots instead in the device ID (e.g.\& hw.0,0 instead of hw:0,0). .br Be advised that although you can select any samplerate when using ALSA, diff -r 76940a39405a -r 988498df1996 DOCS/skin.html --- a/DOCS/skin.html Sun Oct 20 11:34:06 2002 +0000 +++ b/DOCS/skin.html Sun Oct 20 12:20:39 2002 +0000 @@ -55,7 +55,7 @@

      1 Introduction

      -The purpose of this document is to describe the MPlayer skin format. +The purpose of this document is to describe the MPlayer skin format. The information contained here might be wrong, for
        @@ -78,7 +78,7 @@

        2 Overview

        It does not really have anything to do with the skin format, but you should -know that MPlayer has no builtin skin, so at least one skin +know that MPlayer has no builtin skin, so at least one skin must be installed in order to be able to use the GUI. @@ -92,7 +92,7 @@

        -Note that the first path may vary according to the way MPlayer was +Note that the first path may vary according to the way MPlayer was configured (see the --prefix and --datadir arguments of the configure script).

        @@ -112,7 +112,7 @@

        In the main window (see below) you can use images with `transparency': Regions filled with the color #FF00FF (magenta) -are fully transparent when viewed by MPlayer. This means that you can even +are fully transparent when viewed by MPlayer. This means that you can even have shaped windows if your X server has the XShape extension.

        @@ -131,7 +131,7 @@
        • -The main window is where you can control MPlayer. The background of +The main window is where you can control MPlayer. The background of the window is an image. Various items can (and must) be placed in the window: buttons, potmeters (sliders) and labels. For every item, you must @@ -179,7 +179,7 @@
        • -The skin menu is just a way to control MPlayer by means of +The skin menu 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 @@ -195,7 +195,7 @@

          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. +menu entries to work, MPlayer must know what to do if they are clicked. This is done by messages (events). For these items you must define the messages to be generated when they are clicked.

          @@ -205,7 +205,7 @@ You need the following files to build a skin:
          • -The configuration file named skin tells MPlayer how +The configuration file named skin tells MPlayer how to put different parts of the skin together and what to do if you click somewhere in the window.
            • @@ -315,7 +315,7 @@

            The name of an image file must be given without leading directories - images are searched for in the Skin directory. You may (but you need not) -specify the extension of the file. If the file does not exist, MPlayer +specify the extension of the file. If the file does not exist, MPlayer tries to load the file <filename>.<ext>, where tga, TGA, bmp, BMP, png and PNG is tried for <ext> @@ -350,7 +350,7 @@ -MPlayer tries to load main, main.tga, +MPlayer tries to load main, main.tga, main.TGA, main.bmp etc, so that main.png will be found.
            @@ -361,7 +361,7 @@ then main.bmp, main.bmp.tga, main.bmp.TGA, -main.bmp.bmp would be searched for and MPlayer would finally +main.bmp.bmp would be searched for and MPlayer would finally give up because there is no main.bmp in the directory, only main.png. diff -r 76940a39405a -r 988498df1996 DOCS/sound.html --- a/DOCS/sound.html Sun Oct 20 11:34:06 2002 +0000 +++ b/DOCS/sound.html Sun Oct 20 12:20:39 2002 +0000 @@ -12,7 +12,7 @@

            2.3.2 Audio output devices

            -

            MPlayer's audio interface is called libao2. It currently +

            MPlayer's audio interface is called libao2. It currently contains these drivers:

            @@ -128,17 +128,17 @@

            Sharing your sound card with another application like XMMS is strongly discouraged! If the other sound application is using ESD, start - MPlayer with the -vo sdl:esd option to combine both + MPlayer with the -vo sdl:esd option to combine both sound streams. In fact, the option -vo sdl:esd could be used - with ESD even when playing Mplayer alone.

            + with ESD even when playing MPlayer alone.

            -

            Feedback to this document is welcome. Please tell us how MPlayer +

            Feedback to this document is welcome. Please tell us how MPlayer and your sound card(s) worked together.

            2.3.2.2 Audio plugins

            -

            MPlayer has support for audio plugins. Audio plugins can be used for +

            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 card. They are enabled using the -aop switch which takes a list=plugin1,plugin2,... argument. The list argument @@ -161,12 +161,12 @@

            would set the output frequency of the resample plugin to 44100Hz and the output format of the format plugin to AFMT_U8.

            -

            Currently audio plugins can not be used in MEncoder.

            +

            Currently audio plugins can not be used in MEncoder.

            2.3.2.2.1 Up/Downsampling
            -

            MPlayer fully supports up/downsampling of the sound. This plugin can +

            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 stuck with an old sound card that is only capable of max 44.1kHz. Limitations in your hardware are not auto detected, so you have to specify @@ -186,7 +186,7 @@

            2.3.2.2.2 Surround Sound decoding
            -

            MPlayer has an audio plugin that can decode matrix encoded +

            MPlayer has an audio plugin that can decode matrix encoded surround sound. Dolby Surround is an example of a matrix encoded format. Many files with 2 channel audio actually contain matrixed surround sound. To use this feature you need a sound card supporting at least 4 channels.

            @@ -222,7 +222,7 @@

            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 - used if one wants to change the output volume of MPlayer + used if one wants to change the output volume of MPlayer without changing the PCM volume setting in the mixer. It has one switch volume that is used for setting the initial sound level. The initial sound level can be set to values between 0 diff -r 76940a39405a -r 988498df1996 DOCS/users_against_developers.html --- a/DOCS/users_against_developers.html Sun Oct 20 11:34:06 2002 +0000 +++ b/DOCS/users_against_developers.html Sun Oct 20 12:20:39 2002 +0000 @@ -43,7 +43,7 @@ Linux kernel news flash about kernel 2.4.17 and Voy Forum. - MPlayer also suffered from intermittent problems that were all solved by + MPlayer also suffered from intermittent problems that were all solved by switching to a different version of GCC. Several projects started implementing workarounds for some of the 2.96 issues, but we refused to fix other people's bugs, especially since some workarounds may imply a performance penalty.

            @@ -77,7 +77,7 @@
            1. Go to the GCC mirrors page page and download gcc-core-3.1.tar.gz. This includes the - complete C compiler and is sufficient for MPlayer. If you also want + complete C compiler and is sufficient for MPlayer. If you also want C++, Java or some of the other advanced GCC features gcc-3.1.tar.gz may better suit your needs.
            2. Extract the archive with
              @@ -100,12 +100,12 @@

              Binary distribution

              This was the second big problem but has been solved as of version - 0.90-pre1. MPlayer previously contained source from the OpenDivX project, + 0.90-pre1. MPlayer previously contained source from the OpenDivX project, which disallows binary redistribution. This code has been removed and you are now welcome to create binary packages as you see fit.

              Another impediment to binary redistribution was compiletime optimizations - for CPU architecture. MPlayer now supports runtime CPU detection + for CPU architecture. MPlayer now supports runtime CPU detection (specify the --enable-runtime-cpudetection option when compiling). It is disabled by default because it implies a small speed sacrifice, it is now possible to create binaries that run on different @@ -138,12 +138,12 @@

              Joe Barr became infamous by writing a less than favorable - MPlayer review. He found MPlayer hard to install, but then + MPlayer review. He found MPlayer hard to install, but then again he is not very fond of reading documentation. He also concluded that the developers were unfriendly and the documentation incomplete and insulting. You be the judge. - He went on to mention MPlayer negatively in his + He went on to mention MPlayer negatively in his 10 Linux predictions for 2002 In a followup review of xine @@ -153,7 +153,7 @@

              However, he also went on to say that he was "surprised" by my column about - Mplayer and thought it was unfair, reminding me that it is a free software + MPlayer and thought it was unfair, reminding me that it is a free software project. "If you don't like it," Bartsch said, "you're free not to use it."
              diff -r 76940a39405a -r 988498df1996 DOCS/video.html --- a/DOCS/video.html Sun Oct 20 11:34:06 2002 +0000 +++ b/DOCS/video.html Sun Oct 20 12:20:39 2002 +0000 @@ -123,9 +123,9 @@ (...etc...)

              It must support YUY2 packed, and YV12 planar pixel formats to be - usable with MPlayer.

              + usable with MPlayer.

              3. -
            3. And finally, check if MPlayer was compiled with 'xv' support. +
            4. And finally, check if MPlayer was compiled with 'xv' support. ./configure prints this.
              5. @@ -179,7 +179,7 @@ refresh rate. If playing seems to be slow, try disabling VSYNC somehow, or set refresh rate to n*(fps of the movie) Hz.
            5. 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 MPlayer you can + 4.1.0 doesn't. And no TV out support. Of course with MPlayer you can happily get accelerated display, with or without TV output, and no libraries or X are needed. Read Vidix section.
              6. @@ -215,7 +215,7 @@
              2.3.1.3.1 Summary

              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 + the DGA video output driver for MPlayer can do (and what it can't).

              @@ -226,7 +226,7 @@ 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 executable (not + as root or by setting the SUID bit on the MPlayer executable (not recommended).

              There are two versions of DGA: DGA1 is used by XFree 3.x.x and DGA2 was @@ -252,7 +252,7 @@

                  (II) Loading extension XFree86-DGA

              -

              See, XFree86 4.0.x or greater is VERY RECOMMENDED! MPlayer's DGA +

              See, XFree86 4.0.x or greater is VERY RECOMMENDED! MPlayer's DGA driver is autodetected on ./configure, or you can force it with --enable-dga.

              @@ -261,7 +261,7 @@ the movie fits in. There is no converter right now :(

              Become root. DGA needs root access to be able to write directly to video - memory. If you want to run it as user, then install MPlayer SUID + memory. If you want to run it as user, then install MPlayer SUID root:

              @@ -275,7 +275,7 @@ Warning: security risk
              This is a big security risk! Never do this on a server or on a computer that can be accessed by other people because they can gain root - privileges through SUID root MPlayer. + privileges through SUID root MPlayer.

              Now use the -vo dga option, and there you go (hope so :))! @@ -303,10 +303,10 @@

              2.3.1.3.5 DGA & MPlayer
              -

              DGA is used in two places with MPlayer: The SDL driver can be made to +

              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 said is true for both; in the following sections I'll explain how the DGA - driver for MPlayer works.

              + driver for MPlayer works.

              2.3.1.3.6 Features of the DGA driver
              @@ -352,7 +352,7 @@

              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 + 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 @@ -426,7 +426,7 @@

              2.3.1.3.B Bug Reports

              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 + 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:

              @@ -446,7 +446,7 @@ (for example) video driver to use with the SDL_VIDEODRIVER environment variable. Well, in theory.

              -

              With MPlayer, we used its X11 driver's software scaler ability for +

              With MPlayer, we used its X11 driver's software scaler ability for cards/drivers that doesn't support XVideo, until we made our own (faster, nicer) software scaler. Also we used its aalib output, but now we have ours which is more comfortable. Its DGA mode was better than ours, until @@ -494,7 +494,7 @@

              Installation

              You'll have to install svgalib and its development package in order for - MPlayer build its SVGAlib driver (autodetected, but can be forced), + MPlayer build its SVGAlib driver (autodetected, but can be forced), and don't forget to edit /etc/vga/libvga.config to suit your card & monitor.

              @@ -506,7 +506,7 @@

              EGA (4bpp) support

              -

              SVGAlib incorporates EGAlib, and MPlayer has the possibility to +

              SVGAlib incorporates EGAlib, and MPlayer has the possibility to display any movie in 16 colors, thus usable in the following sets:

                @@ -575,7 +575,7 @@

              NOTE: FBdev video mode changing _does not work_ with the VESA framebuffer, - and don't ask for it, since it's not an MPlayer limitation.

              + and don't ask for it, since it's not an MPlayer limitation.

              2.3.1.7 Matrox framebuffer (mga_vid)

              @@ -608,9 +608,9 @@ under /lib/modules/<kernel version>/somewhere.

              Then run

              depmod -a

              -
            6. Now you have to (re)compile MPlayer, configure will +
            7. Now you have to (re)compile MPlayer, configure will detect /dev/mga_vid and build the 'mga' driver. Using it from - MPlayer goes by -vo mga if you have matroxfb console, + MPlayer goes by -vo mga if you have matroxfb console, or -vo xmga under XFree86 3.x.x or 4.x.x.
            @@ -630,7 +630,7 @@

            2.3.1.9 OpenGL output

            -

            MPlayer supports displaying movies using OpenGL, but if your +

            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 instead, OpenGL performance is considerably worse. If you have an X11 implementation without xv support, OpenGL is a viable alternative.

            @@ -650,7 +650,7 @@

            AAlib 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. + Quake, etc. MPlayer contains a very usable driver for it. If ./configure detects aalib installed, the aalib libvo driver will be built.

            @@ -663,7 +663,7 @@             - +
            5switch fast rendering on/off
            6set dithering mode (none, error distribution, Floyd Steinberg)
            7invert image
            atoggles between aa and MPlayer control)
            atoggles between aa and MPlayer control)

            The following command line options can be used:

            @@ -782,7 +782,7 @@
            • If you have installed NLS font on your Linux box and run VESA - driver from text-mode then after terminating MPlayer you will have + driver from text-mode then after terminating MPlayer you will have ROM font loaded instead of national. You can load national font again by using setsysfont utility from the Mandrake distribution for example.
              @@ -867,11 +867,11 @@ AAlib for that).
              Note: Everyone can try this trick by commenting out mode switching in vo_vesa driver.
              • -
            • MPlayer's video output driver should know active video mode and be +
            • MPlayer's video output driver should know active video mode and be able to tell to VIDIX subdevice some video characteristics of server.
            -I hope that probably every video output driver of MPlayer will +I hope that probably every video output driver of MPlayer will recognize :vidix subdevice.

            USAGE METHODS

            @@ -879,7 +879,7 @@

            When VIDIX is used as subdevice (-vo vesa:vidix) then video mode configuration is performed by video output device (vo_server in short). Therefore you can pass into command line of - MPlayer the same keys as for vo_server. In addition it understands + MPlayer the same keys as for vo_server. In addition it understands -double key as globally visible parameter. (I recommend using this key with VIDIX at least for ATI's card).
            As for -vo xvidix: currently it recognizes the following @@ -897,7 +897,7 @@ But it's dangerous, and you shouldn't do that. In this case given driver will be forced and result is unpredictable (it may freeze your computer). You should do that ONLY if you are absolutely sure it will work, - and MPlayer doesn't do it automatically. Please tell about it to the + and MPlayer doesn't do it automatically. Please tell about it to the developers. The Right Way is to use VIDIX without arguments to enable driver autodetection.

            @@ -910,14 +910,14 @@ Warning: security risk
            Unfortunately you must have root privileges to use VIDIX due to direct hardware access. At least the SUID bit on the - MPlayer executable must be set. + MPlayer executable must be set.

            VIDEO EQUALIZER

            This is a video equalizer implemented especially for VIDIX. You can use it either with 1-8 keys as described in the man page, or - by command line arguments. MPlayer recognizes the + by command line arguments. MPlayer recognizes the following options:

            @@ -1044,13 +1044,13 @@

            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 - FIRST start XawTV, THEN start MPlayer, wait for - MPlayer to finish and THEN stop XawTV.

            + FIRST start XawTV, THEN start MPlayer, wait for + MPlayer to finish and THEN stop XawTV.

            2.3.1.15 DVB

            -

            MPlayer supports cards with the Siemens DVB chipset from vendors like +

            MPlayer supports cards with the Siemens DVB chipset from vendors like Siemens, Technotrend, Galaxis or Hauppauge. The latest DVB drivers are available from the Linux TV site. If you want to do software transcoding you should have at least a 1GHz CPU.

            @@ -1153,7 +1153,7 @@

            2.3.1.16 DXR3/Hollywood+

            -

            MPlayer supports hardware accelerated playback with the Creative DXR3 +

            MPlayer supports hardware accelerated playback with the Creative DXR3 and Sigma Designs Hollywood Plus cards. These cards both use the em8300 MPEG decoder chip from Sigma Designs.

            @@ -1169,10 +1169,10 @@
            noprebuf turns off prebuffering. Prebuffering is a feature of the em8300 chip that enables it to hold more than one frame of video at a time. This means that when you are running with prebuffering (default) - MPlayer will try to keep the video buffer filled with data at all - times. If you are on a slow machine MPlayer will probably use close + MPlayer will try to keep the video buffer filled with data at all + times. If you are on a slow machine MPlayer will probably use close to, or precisely 100% of CPU. This is especially common if you play pure MPEG - streams (like DVDs, SVCDs a.s.o.) since MPlayer will not have to + streams (like DVDs, SVCDs a.s.o.) since MPlayer will not have to reencode it to MPEG it will fill the buffer very fast.
            With prebuffering video playback is much less sensitive to other programs hogging the CPU, it will not drop frames unless applications hog @@ -1219,12 +1219,12 @@

            Overlay

            To get overlay run dxr3view that comes with the em8300 package before - starting MPlayer. You can set various options in dxr3view by pressing + starting MPlayer. You can set various options in dxr3view by pressing T while holding the mouse cursor above the window.

            MPEG1, MPEG2, VCD and DVD Notes

            -

            MPEG1/2 content should now automatically be detected by MPlayer and +

            MPEG1/2 content should now automatically be detected by MPlayer and it will use the hardware acceleration of the DXR3 to play it. If not, you can force it to hardware acceleration with -vc mpegpes. Also, if you plan to use postprocessing filters you must use -vc mpeg12.

            @@ -1234,7 +1234,7 @@ known bug. The em8300 will also improperly handle subtitles that are too big, and may hang for a second or two. At this time, the only workaround is to use -vc mpeg12 when viewing DVDs with subtitles. When running with - -vc mpeg12 MPlayer will reencode video to MPEG (even if it + -vc mpeg12 MPlayer will reencode video to MPEG (even if it already is MPEG). This means that it will need more CPU power, and you might loose some picture quality.

            @@ -1276,7 +1276,7 @@ TVout/fbset and type make. Install fbset into somewhere in your PATH.
          • - Then enter into the TVout/ directory in the MPlayer + Then enter into the TVout/ directory in the MPlayer source, and execute ./modules as root. Your text-mode console will enter into framebuffer mode (no way back!).
          • Next, EDIT and run the ./matroxtv script. This will present you @@ -1339,7 +1339,7 @@ gatos.
          • ASIC Radeon VIVO: supported by gatos.
            • -
          • Radeon and Rage128: supported by MPlayer! +
          • Radeon and Rage128: supported by MPlayer! Check VESA driver and VIDIX sections.