From 0d82c273ac106aa38b07081f0d0e1c833de9f7ba Mon Sep 17 00:00:00 2001 From: gabucino Date: Wed, 13 Nov 2002 05:13:51 +0000 Subject: some TOC reorder new sections updates fixes girls etc git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@8178 b3059339-0415-0410-9bf9-f77b7e298cf2 --- DOCS/documentation.html | 145 ++++++++++++++--------- DOCS/formats.html | 19 +++ DOCS/sound.html | 46 +++++--- DOCS/video.html | 304 +++++++++++++++++++++++++++++------------------- 4 files changed, 326 insertions(+), 188 deletions(-) (limited to 'DOCS') diff --git a/DOCS/documentation.html b/DOCS/documentation.html index f22f5699f1..6d37d673e2 100644 --- a/DOCS/documentation.html +++ b/DOCS/documentation.html @@ -63,6 +63,7 @@
  • 2.1.1.11 RoQ files
  • 2.1.1.12 OGG/OGM files
  • 2.1.1.13 SDP files
    • +
  • 2.1.1.14 PVA files
  • 2.1.2 Audio formats @@ -72,6 +73,7 @@
  • 2.1.2.3 OGG/OGM files (Vorbis)
  • 2.1.2.4 WMA/ASF files
  • 2.1.2.5 MP4 files
    • +
  • 2.1.2.6 CD audio
    • @@ -114,65 +116,79 @@
  • 2.3.1 Video output devices
  • 2.3.2 Audio output devices @@ -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.
    • +
  • MPlayer v0.01: Nov 11, 2000
    + TODO: A'rpi, would you say some words here? :)
  • MPlayer v0.3-v0.9: Nov 18-Dec 4, 2000
    It was a pack of two programs: mpg12play v0.95pre6 and my new simple AVI player 'avip' based on avifile's Win32 DLL loader.
    • @@ -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. -
  • MPlayer 0.90 "?" Aug? ??, 2002
    • +
  • MPlayer 0.90pre10 "The BirthdayCounter" Nov 11, 2002
    + 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!
    • +
  • MPlayer 0.90 "?" Date yet unknown
    • @@ -478,6 +499,11 @@
  • libvorbis - optional, needed for playing OGG Vorbis audio.
  • LIVE.COM Streaming Media - optional, needed for playing RTSP/RTP streams.
    • +
  • directfb - optional, from + http://www.directfb.org
    • +
  • cdparanoia - optional, for CDDA support
    • +
  • libfreetype - optional, for TTF fonts support. At least 2.0.9 is + required.

    • Codecs:

    @@ -784,7 +810,16 @@
  • AQTitle
    • -The command line options differ slightly for the different formats: +

    MPlayer can dump the previously listed subtitle formats into the following + destination formats, with the given options:

    + + + +

    The command line options differ slightly for the different formats:

    VobSub subtitles

    @@ -892,6 +927,8 @@ The command line options differ slightly for the different formats: (read TOOLS/subfont-c/README for details)
  • use the font generator GIMP plugin at TOOLS/subfont-GIMP (note: you must have HSI RAW plugin too, see URL below)
    • +
  • using a TrueType (TTF) font, by the means of the freetype + library. Version 2.0.9 or greater is mandatory! TODO: complete this

    • After that, UNZIP the file you downloaded to ~/.mplayer or diff --git a/DOCS/formats.html b/DOCS/formats.html index 2fd53bdc0f..75ec2e2e58 100644 --- a/DOCS/formats.html +++ b/DOCS/formats.html @@ -224,6 +224,15 @@ libraries are required.)

    +

    2.1.1.14 PVA files

    + +

    PVA is an MPEG-like format used by DVB TV boards' software (e.g.: MultiDec, + WinTV) under Windows.

    + +

    The PVA specifications can be downloaded from the following address: + http://www.technotrend.de/download/av_format_v1.pdf

    + +

    2.1.2 Audio formats

    MPlayer is a Movie and not a Media player, although @@ -255,5 +264,15 @@

    2.1.2.5 MP4 files

    + +

    2.1.2.6 CD audio

    + +

    MPlayer can use cdparanoia (lib) to play CDDA (Audio CD). + The scope of this section does not contain enumerating cdparanoia's + features.

    + +

    See the man page's -cdda option which can be used to + pass options to cdparanoia.

    + diff --git a/DOCS/sound.html b/DOCS/sound.html index 23acb250b6..828aa959fa 100644 --- a/DOCS/sound.html +++ b/DOCS/sound.html @@ -12,6 +12,8 @@

    2.3.2 Audio output devices

    +

    2.3.2.1 Description of MPlayer's A/V sync method

    +

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

    @@ -26,8 +28,24 @@ artsnative ARTS driver (mostly for KDE users) -

    Fact is, Linux sound card drivers have compatibility problems. - It may take a while to find your optimal settings.

    +

    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.

    + +

    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.

    + +

    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!).

    + +

    If you happen to have a bad audio driver, try the -autosync + option, it should sort out your problems. See the man page for detailed + information.

    + +

    Some notes:

    -

    On Solaris/FreeBSD systems, use the SUN audio driver with the +

    On Solaris, use the SUN audio driver with the -ao sun option, otherwise neither video nor audio will work.

    -

    2.3.2.1 Sound Card experiences, recommendations

    +

    2.3.2.2 Sound Card experiences, recommendations

    @@ -136,7 +150,7 @@ and your sound card(s) worked together.

    -

    2.3.2.2 Audio plugins

    +

    2.3.2.3 Audio plugins

    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 @@

    Currently audio plugins can not be used in MEncoder.

    -
    2.3.2.2.1 Up/Downsampling
    +
    2.3.2.3.1 Up/Downsampling

    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.

    -
    2.3.2.2.2 Surround Sound decoding
    +
    2.3.2.3.2 Surround Sound decoding

    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 @@   mplayer media.avi -aop list=surround

    -
    2.3.2.2.3 Sample format converter
    +
    2.3.2.3.3 Sample format converter

    If your sound card driver does not support signed 16bit int data type, this plugin can @@ -210,7 +224,7 @@ list=format:format=<required output format>

    -
    2.3.2.2.4 Delay
    +
    2.3.2.3.4 Delay

    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.

    -
    2.3.2.2.5 Software volume control
    +
    2.3.2.3.5 Software volume control

    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

    -
    2.3.2.2.6 Extrastereo
    +
    2.3.2.3.6 Extrastereo

    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.

    -
    2.3.2.2.7 Volume normalizer
    +
    2.3.2.3.7 Volume normalizer

    This plugin maximizes the volume without distorting the sound.

    diff --git a/DOCS/video.html b/DOCS/video.html index be81436f58..c34559738e 100644 --- a/DOCS/video.html +++ b/DOCS/video.html @@ -69,8 +69,9 @@ stepping 0] doesn't support MTRR, but stepping 12's do ('cat /proc/cpuinfo' to check it').

    +

    2.3.1.2 Video outputs for traditional video cards

    -

    2.3.1.2 Xv

    +

    2.3.1.2.1 Xv

    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 @@ -

    2.3.1.2.1 3dfx cards
    +

    2.3.1.2.1.1 3dfx cards

    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 @@ tdfxfb section.

    -
    2.3.1.2.2 S3 cards
    +

    2.3.1.2.1.2 S3 cards

    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.

    -
    2.3.1.2.3 nVidia cards
    +

    2.3.1.2.1.3 nVidia cards

    nVidia isn't a very good choice under Linux (according to nVidia, this is not true).. You'll have to @@ -170,7 +171,7 @@ Complain to nVidia.

    -
    2.3.1.2.4 ATI cards
    +

    2.3.1.2.1.4 ATI cards

    -
    2.3.1.2.5 NeoMagic cards
    +

    2.3.1.2.1.5 NeoMagic cards

    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

    -
    2.3.1.2.6 Trident cards
    +

    2.3.1.2.1.6 Trident cards

    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.

    -

    2.3.1.3 DGA

    +

    2.3.1.2.2 DGA

    -
    2.3.1.3.1 Summary
    +

    2.3.1.2.2.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 can't).

    -
    2.3.1.3.2 What is DGA
    +

    2.3.1.2.2.2 What is DGA

    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 ...

    -
    2.3.1.3.3 Installing DGA support for MPlayer
    +

    2.3.1.2.2.3 Installing DGA support for MPlayer

    First make sure X loads the DGA extension, see in /var/log/XFree86.0.log:

    @@ -283,7 +284,7 @@ much faster.

    -
    2.3.1.3.4 Resolution switching
    +

    2.3.1.2.2.4 Resolution switching

    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 @@

    See appendix A for some sample modeline definitions.

    -
    2.3.1.3.5 DGA & MPlayer
    +

    2.3.1.2.2.5 DGA & MPlayer

    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.

    -
    2.3.1.3.6 Features of the DGA driver
    +

    2.3.1.2.2.6 Features of the DGA driver

    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.

    -
    2.3.1.3.7 Speed issues
    +

    2.3.1.2.2.7 Speed issues

    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.

    -
    2.3.1.3.8 Known bugs
    +

    2.3.1.2.2.8 Known bugs

    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 @@ -

    2.3.1.3.9 Future work
    +

    2.3.1.2.2.9 Future work

    -
    2.3.1.3.A Some modelines
    +

    2.3.1.2.2.A Some modelines

       Section "Modes"
@@ -423,7 +424,7 @@
   module.
    
 
 
-
    2.3.1.3.B Bug Reports
    
+
    2.3.1.2.2.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
@@ -437,7 +438,7 @@
 
    Acki (acki@acki-netz.de, www.acki-netz.de)
    
 
 
-
    2.3.1.4 SDL
    
+
    2.3.1.2.3 SDL
    
 
 
    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 @@
 
 
 
-
    2.3.1.5 SVGAlib
    
+
    2.3.1.2.4 SVGAlib
    
 
 
    Installation
    
 
@@ -525,7 +526,7 @@
     -noaspect
    
 
 
-
    2.3.1.6 Framebuffer output (FBdev)
    
+
    2.3.1.2.5 Framebuffer output (FBdev)
    
 
 
    Whether to build the FBdev target is autodetected during ./configure .
   Read the framebuffer documentation in the kernel sources
@@ -534,8 +535,8 @@
 
    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 ;))
    
+  Doctor (formerly UniVBE) before booting Linux. Use a DOS boot disk or
+  whatever. And don't forget to register your UniVBE ;))
    
 
 
    The FBdev output takes some additional parameters above the others:
    
 
@@ -578,10 +579,10 @@
   and don't ask for it, since it's not an MPlayer limitation.
    
 
 
-
    2.3.1.7 Matrox framebuffer (mga_vid)
    
+
    2.3.1.2.6 Matrox framebuffer (mga_vid)
    
 
 
    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.
    
 
@@ -621,14 +622,14 @@
   change: echo "brightness=120" > /dev/mga_vid
    
 
 
-
    2.3.1.8 3dfx YUV support (tdfxfb)
    
+
    2.3.1.2.7 3dfx YUV support (tdfxfb)
    
 
 
    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 ./configure --enable-tdfxfb
    
 
 
-
    2.3.1.9 OpenGL output
    
+
    2.3.1.2.8 OpenGL output
    
 
 
    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.
    
 
 
-
    2.3.1.10 AAlib - text mode displaying
    
+
    2.3.1.2.9 AAlib - text mode displaying
    
 
 
    AAlib 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 @@
 
 
    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, but vo_aa tries
-  to find the best mode.  See
+  /dev/vcsa<terminal>. That isn't autodetected by aalib, but vo_aa tries
+  to find the best mode. See
   http://aa-project.sourceforge.net/tune/
   for further tuning issues.
    
 
 
-
    2.3.1.11 VESA - output to VESA BIOS
    
+
    2.3.1.2.10 VESA - output to VESA BIOS
    
 
 
    This driver was designed and introduced as a generic driver for any
   video card which has VESA VBE 2.0+ compatible BIOS. Another advantage of this
@@ -800,7 +801,7 @@
 
 
 
-
    2.3.1.12 X11
    
+
    2.3.1.2.11 X11
    
 
 
    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.
    
 
 
-
    2.3.1.13 VIDIX
    
+
    2.3.1.2.12 VIDIX
    
 
 
    VIDIX is the abbreviation for VIDeo Interface for
   *niX.
    
@@ -850,7 +851,7 @@
 
 
    
 
+
    Building a Matrox TV-out cable
    
+
+
    This information was contributed by Rácz Balázs. Of course
+  no one takes any responsibility, nor guarantee for any damage caused
+  by this documentation.
    
+
+
    The CRTC2 connector's fourth pin is the composite video signal. The ground
+  are the sixth, seventh and eighth pins.
    
+
 
-
    2.3.1.A.2 Matrox G450/G550 cards
    
+
    2.3.1.5.2 Matrox G450/G550 cards
    
 
 
    TV output support for these cards has only been recently introduced, and is
   not yet in the mainstream kernel. Currently the mga_vid module
@@ -1339,7 +1407,7 @@ for 16:9 TV:  -vop lavc,expand=-1:576:-1:-1:1,scale=-1:0,dvbscale=1024
   http://www3.sympatico.ca/dan.eriksen/matrox_tvout/
    
 
 
-
    2.3.1.A.3 ATI cards
    
+
    2.3.1.5.3 ATI cards
    
 
 
    PREAMBLE
    
 
@@ -1366,7 +1434,7 @@ for 16:9 TV:  -vop lavc,expand=-1:576:-1:-1:1,scale=-1:0,dvbscale=1024
   POST procedure.
    
 
 
-
    2.3.1.A.4 Voodoo 3
    
+
    2.3.1.5.4 Voodoo 3
    
 
 
    Check this URL.
    
 
-- 
cgit v1.2.3
    VIA onboard chipset (via82cxxx) 48kHz only