# HG changeset patch
# User gabucino
# Date 1005066296 0
# Node ID 62bcea66003e646dedad6966ce5fbfc59127311d
# Parent 205deb33f8ee9eb026da80cbf8664064b866ce11
oh my god what have i done...
format.html, codecs, video, sound.html renumbered, etc
diff -r 205deb33f8ee -r 62bcea66003e DOCS/codecs.html
--- a/DOCS/codecs.html Tue Nov 06 17:04:13 2001 +0000
+++ b/DOCS/codecs.html Tue Nov 06 17:04:56 2001 +0000
@@ -3,32 +3,15 @@
- 2.1. Video Formats, Audio & Video Codecs 2.1.1. Supported input formats MPlayer can read/play from the following devices/formats:
-
-
Note: about realmedia (.ra/.rm) support read the FAQ!
+ -2.1.2. Supported audio & video codecs
+See http://www.mplayerhq.hu/DOCS/codecs-status.html for the complete, daily generated list!!!
-The most important video codecs:
+
The most important ones above all:
The most important audio codecs:
-
If you have a codec not listed here, and not supported yet, just read section 2.1.3 to get info about how to help us adding support +
If you have a Win32 codec not listed here, and not supported yet, just read the codec importing to get info about how to help us adding support for it!
- +This section contains information about the DivX4 codec of ProjectMayo. Their first available alpha version was the OpenDivX 4.0 @@ -110,7 +85,7 @@
2.1.2.2. ffmpeg's DivX/libavcodec
+2.2.1.2. ffmpeg's DivX/libavcodec
Beginning with version 0.4.2 , ffmpeg contains an opensource DivX codec, which is compatible with the traditional DivX. MPlayer supports this codec, @@ -150,15 +125,7 @@ highest resolution DivX/DivX4 movies on my K6/2 500, without framedrop.
-2.1.2.3. Hardware AC3 decoding
- -You'll need an AC3 capable soundcard, with digital out (SP/DIF). The -card's driver must support the AFMT_AC3 format (like SB Live! does). -Connect your AC3 decoder to the SP/DIF output, and use the '-ac hwac3' -option. It may or may not work (experimental). (probably won't...)
- - - +Foreword: using (some) XAnim codecs with other program than XAnim, is ILLEGAL. It is YOUR responsibility to read its license, @@ -185,7 +152,43 @@
Tested codecs are: Indeo 3.2, 4.1, 5.0, CVID, 3ivX, h263.
- + + +TODO
+ + + + +MPEG1 and MPEG2 are decoded with the native library libmpeg2. +Its source code is included in MPlayer, and of course is multiplatform. +We handle buggy MPEG1/2 video files by checking for what signature does +libmpeg2 return, and when it gives sig11 (segmentation fault), we quickly +reinitialize the codec, and continue exactly from where the failure did occur. +No speed decrease is measurable.
+ + + + +The most important audio codecs above all :
+
2.2.2.1. Hardware AC3 decoding
+ +You'll need an AC3 capable soundcard, with digital out (SP/DIF). The +card's driver must support the AFMT_AC3 format (like SB Live! does). +Connect your AC3 decoder to the SP/DIF output, and use the '-ac hwac3' +option. It may or may not work (experimental). (probably won't...)
+ + +libmad is a multiplatform MPEG audio decoding library. If you don't know why is it good, you probably don't need it.
@@ -194,9 +197,9 @@ option. - +2.2.3. Win32 codec importing howto
- +VfW (Video for Windows) is the old Video API for Windows. Its codecs have the .DLL or (rarely) .DRV extension. @@ -224,7 +227,7 @@
ftp://ftp.mplayerhq.hu/MPlayer/incoming/[codecname]/
DirectShow is the newer Video API, which is even worse than its predecessor. Things are harder with DirectShow, since diff -r 205deb33f8ee -r 62bcea66003e DOCS/documentation.html --- a/DOCS/documentation.html Tue Nov 06 17:04:13 2001 +0000 +++ b/DOCS/documentation.html Tue Nov 06 17:04:56 2001 +0000 @@ -29,72 +29,88 @@
MPlayer is basically GPL, but contains some non-GPL code which is not allowed to be distributed in binary form, and also contains the OpenDivX @@ -226,7 +245,8 @@
Then build MPlayer:
@@ -291,7 +320,7 @@ make make install -It is recommended to browse the output of ./configure , it contains info +
ALWAYS browse the output of ./configure , it contains info about what will be built, and what won't. You may also want to view config.h and config.mak files.
@@ -305,7 +334,9 @@ unzip mp-arial-iso-8859-1.zipOnly one thing remains: copy the codecs.conf file from the etc
-directory (relative to the MPlayer tree) to $HOME/.mplayer/codecs.conf.
$HOME/.mplayer/codecs.conf
.
+You should also check the manpage and example.conf
for available options, and insert them
+into your config file, $HOME/.mplayer/config
.
@@ -410,11 +441,21 @@
You can change default behaviour by setting osdlevel=
variable in config file.
2.1. Video Formats, Audio & Video Codecs
+ + + + + -2.2. Video & Audio output devices
+ +2.3. Video & Audio output devices
+ + +2.4. MEncoder - An All-Purpose Encoder
+ diff -r 205deb33f8ee -r 62bcea66003e DOCS/encoding.html --- a/DOCS/encoding.html Tue Nov 06 17:04:13 2001 +0000 +++ b/DOCS/encoding.html Tue Nov 06 17:04:56 2001 +0000 @@ -3,7 +3,7 @@ - +Overview
MEncoder (MPlayer's Movie Encoder) is a simple movie encoder, diff -r 205deb33f8ee -r 62bcea66003e DOCS/formats.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/DOCS/formats.html Tue Nov 06 17:04:56 2001 +0000 @@ -0,0 +1,105 @@ + +
+ + + + + + +MPlayer can read/play from the following devices/formats:
+
Note: about realmedia (.ra/.rm) support read the FAQ!
+ +It's important to clarify a popular mistake. When people see a file with +.AVI extension, they instantly declare that isn't an MPEG file. +That's not true. At least not entirely. If you tell them that such a file +can contain MPEG1 video, they laugh at you. Feel free to kick their dumbass +faces, then tell them to RTFM.
+ +You see, a codec isn't equal to a file format.
+Video codecs are: MPEG1, MPEG2, DivX, Indeo5, 3ivx.
+Video formats are: MPG, VOB, AVI, ASF.
+
In theory, you can happily put an OpenDivX video and MP3 audio +into a .MPG format file. Though most players won't play it, since +they expect MPEG1 video and MP2 audio (.MPG doesn't have the +necessary fields to describe its video and audio streams, like .AVI +does). Or put MPEG1 video to an .AVI. For example ffmpeg can +create these files.
+ +Audio codecs and formats are basically the same terms.
+ + + + + + + ++
-vcd
option to play the VideoCD.Designed by Micro$oft, the AVI (Audio Video Interleaved) is a
+widespread multipurpose format, currently used mostly for DivX and DivX4
+videos. Has many known drawbacks, and inabilities (for example in streaming).
+Has support for one video stream, and 99 audio streams. Can be as big as
+2Gb. There exists an extension for it to be bigger, called OpenDMS.
+M$ is currently strongly discourages its use and propagates ASF/WMV. Not if
+anybody cares.
+NOTE : DV cameras can create two types of AVI format, one is the usual and
+playable, the other is neither.
ASF is a new very undocumented fileformat from M$, and WMV is its +successor. They are very commercial, and anyone who writes an opensource +parser for them, soon meets certain doom. While creating the parser, it +was obvious to see how bulky, shit, and unusable they are. Not if anybody +would expect something else from M$. + + +
+ +They are Apple's formats. Not much to say, basically well designed, +multipurpose, streamable, many features etc. Kinda hard to find documentation, +but we think the parser is perfect. + +
+ +Hey this is new code in MPlayer, be gentle! Seeking is +currently nonexistent, audio too. TODO : complete this section.
+ + + + +Currently MPlayer is still a Movie and not a Media +player, thus the pure audio formats (for example MP3, WAV, audio ASF) are +unplayable. Use xmms, mpg123 +or whatever.
+ + + diff -r 205deb33f8ee -r 62bcea66003e DOCS/sound.html --- a/DOCS/sound.html Tue Nov 06 17:04:13 2001 +0000 +++ b/DOCS/sound.html Tue Nov 06 17:04:56 2001 +0000 @@ -3,7 +3,7 @@ - +MPlayer's audio interface is called libao2. It currently contains these drivers :
@@ -42,7 +42,7 @@On Solaris/FreeBSD systems, use the SUN audio driver with the -ao sun option, otherwise you'll have no video, nor audio playing.
-2.2.2.1. Soundcard experiences, recommendations
+2.3.2.1. Soundcard experiences, recommendations
Aureal Vortex 2 | |||||||||||||||||||
ggi | similar to SDL | ||
aa | textmode rendering with AAlib | ||
vesa | Output to VESA BIOS. | ||
vesa | Output to VESA BIOS. | ||
Card specific: | |||