[MPlayer-DOCS] [PATCH] reorganize mencoder.xml

[Guillaume POIRIER]

Hi,

This is a resend, the previous message is being held till moderator
approval because the attached file was too big. This on doesn't
feature the attachment.

On 7/22/05, Diego Biurrun <diego at biurrun.de> wrote:
> On Thu, Jul 21, 2005 at 11:30:20PM +0200, Guillaume POIRIER wrote:
> > Here's a patch that reorganize the file mencoder.xml as I think it's
> > not easy to find your way in it. I added at the end of this mail how
> > the index would look like if you apply that patch.
>
> Excellent idea!

You're welcome :o)


> I had this very thought the last time I looked at
> mencoder.xml.  This reminds me that I wanted to break up chapter 2 some
> day, it's far too long.
>
> > I'm still not entirely satisfied with the way it's organized as the
> > sections 7.1 to 7.6 are very short when the sections 7.7 to 7.12 are
> > quite long.
> > Maybe it could be a good idea to group the sections 7.1 to 7.6 into a
> > 'basic usage' section. What do you think
>
> Doesn't sound bad.

I moved all the more advanced sections of mencoder.xml to
encoding-guide.xml (new file).

> Some comments:
>
> >     7.8. Encoding with the libavcodec codec family
> >     7.9. Encoding with the x264 codec
> >     7.10. Encoding with the XviD codec
>
> I think you should put x264 after XviD since XviD and lavc are more
> alike.

Done


> >     7.7. Making a high quality MPEG-4 ("DivX") rip of a DVD movie
> >     7.12. How to deal with telecine and interlacing within NTSC DVDs
>
> Shouldn't these two sections be closer together?  7.12 seems to belong
> in the DVD ripping section.

Here is how it'll look. I think it's much better now:

7. Basic usage of MEncoder

   7.1. Encoding two pass MPEG-4 ("DivX")
   7.2. Encoding to MPEG format
   7.3. Rescaling movies
   7.4. Stream copying
   7.5. Encoding from multiple input image files (JPEG, PNG, TGA, SGI)
   7.6. Extracting DVD subtitles to VOBsub file
   7.7. Preserving aspect ratio

8. Encoding with MEncoder

   8.1. Making a high quality MPEG-4 ("DivX") rip of a DVD movie

       8.1.1. Preparing to encode: Identifying source material and framerate

           8.1.1.1. Identifying source framerate
           8.1.1.2. Identifying source material

       8.1.2. Constant quantizer vs. multipass
       8.1.3. Constraints for efficient encoding
       8.1.4. Cropping and Scaling
       8.1.5. Audio
       8.1.6. Interlacing and Telecine
       8.1.7. Encoding interlaced video
       8.1.8. Filtering
       8.1.9. Muxing

           8.1.9.1. Limitations of the AVI container
           8.1.9.2. Muxing into the Matroska container

   8.2. How to deal with telecine and interlacing within NTSC DVDs

       8.2.1. Introduction
       8.2.2. How to tell what type of video you have

           8.2.2.1. Progressive
           8.2.2.2. Telecined
           8.2.2.3. Interlaced
           8.2.2.4. Mixed progressive and telecine
           8.2.2.5. Mixed progressive and interlaced

       8.2.3. How to encode each category

           8.2.3.1. Progressive
           8.2.3.2. Telecined
           8.2.3.3. Interlaced
           8.2.3.4. Mixed progressive and telecine
           8.2.3.5. Mixed progressive and interlaced

       8.2.4. Footnotes

   8.3. Encoding with the libavcodec codec family

       8.3.1. Encoding options of libavcodec
       8.3.2. Custom inter/intra matrices
       8.3.3. Example


   8.4. Encoding with the XviD codec

       8.4.1. What options should I use to get the best results?
       8.4.2. Encoding options of XviD

   8.5. Encoding with the x264 codec

       8.5.1. Encoding options of x264

           8.5.1.1. Introduction
           8.5.1.2. Options which primarily affect speed and quality
           8.5.1.3. Options pertaining to miscellaneous preferences

   8.6. Using MEncoder to create VCD/SVCD/DVD-compliant files.

       8.6.1. Format Constraints

           8.6.1.1. Format Constraints
           8.6.1.2. GOP Size Constraints
           8.6.1.3. Bitrate Constraints

       8.6.2. Output Options

           8.6.2.1. Aspect Ratio
           8.6.2.2. Sample Rate Conversion

       8.6.3. Using libavcodec for VCD/SVCD/DVD Encoding

           8.6.3.1. Introduction
           8.6.3.2. lavcopts
           8.6.3.3. Examples
           8.6.3.4. Advanced Options

       8.6.4. Encoding Audio

           8.6.4.1. toolame
           8.6.4.2. twolame
           8.6.4.3. libavcodec

       8.6.5. Putting it all Together

           8.6.5.1. PAL DVD
           8.6.5.2. NTSC DVD
           8.6.5.3. PAL AVI Containing AC3 Audio to DVD
           8.6.5.4. NTSC AVI Containing AC3 Audio to DVD
           8.6.5.5. PAL SVCD
           8.6.5.6. NTSC SVCD
           8.6.5.7. PAL VCD
           8.6.5.8. NTSC VCD


--
I feel sorry for people who don't drink.
When they wake up in the morning, that's
as good as they're going to feel all day.
 -- Frank Sinatra