# HG changeset patch # User gabucino # Date 1043773917 0 # Node ID 42667fd91d4a06abfcfb03bb4c82812ec7d94462 # Parent 8d6431bea500b763f7a9a69d17e366baf2e85ff7 changing "switch" -> "option" (unwritten DOCS rule) other important fixes, updates diff -r 8d6431bea500 -r 42667fd91d4a DOCS/codecs.html --- a/DOCS/codecs.html Tue Jan 28 01:46:53 2003 +0000 +++ b/DOCS/codecs.html Tue Jan 28 17:11:57 2003 +0000 @@ -243,7 +243,7 @@ 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.

+ --with-reallibdir option.

Note: RealPlayer libraries currently only work with Linux, FreeBSD, NetBSD and Cygwin on the x86 and Alpha platforms.

diff -r 8d6431bea500 -r 42667fd91d4a DOCS/documentation.html --- a/DOCS/documentation.html Tue Jan 28 01:46:53 2003 +0000 +++ b/DOCS/documentation.html Tue Jan 28 17:11:57 2003 +0000 @@ -278,39 +278,18 @@

7. Encoding with MEncoder

Appendix A - Mailing lists

Appendix B - How to report bugs -

Appendix B - How to report bugs

Appendix C - Known bugs

Appendix D - MPlayer skin format

-nortc

$HOME/.mplayer/input.conf

-input

$HOME/.mplayer

Example:

If you don't like the standard location for the lirc-config file (~/.lircrc) - use the -lircconf <filename> switch to specify another file.

3.2.3 Slave mode

The slave mode allow you to build simple frontend to MPlayer. When - enabled (with the -slave switch) MPlayer will read + enabled (with the -slave option) MPlayer will read commands separated by new line (\n) from stdin.

7.1 Encoding to MPEG format

MEncoder can create MPEG (MPEG-PS) format output files. It's probably + useful only with libavcodec's mpeg1video codec, because players + - except MPlayer - expect MPEG1 video, and MPEG1 layer 2 (MP2) audio streams + in MPEG files.

This feature is not very useful right now, aside that it probably has + many bugs, but the more importantly because MEncoder currently cannot encode + MPEG1 layer 2 (MP2) audio, which all other players expect in MPEG files.

To change MEncoder's output file format, use the -of mpeg + option.

Example:
+ mencoder -of mpeg -ovc lavc -lavcopts vcodec=mpeg1video + -oac copy <other options> media.avi -o output.mpg

7.2 Rescaling movies

Often the need to resize movie images' size emerges. Its reasons can be @@ -185,7 +204,7 @@

Examples

The explanation of the -mf option can be found below in the - global Options section and in the man page.

Creating a DivX4 file from all the JPEG files in the current dir:
mencoder -mf on:w=800:h=600:fps=25 -ovc divx4 diff -r 8d6431bea500 -r 42667fd91d4a DOCS/faq.html --- a/DOCS/faq.html Tue Jan 28 01:46:53 2003 +0000 +++ b/DOCS/faq.html Tue Jan 28 17:11:57 2003 +0000 @@ -257,7 +257,7 @@

A: It does, but you have to explicitly specify software scaling (very
     slow) with the -zoom option. You better use XF86VidMode
     support: You must specify the -vm and the -fs
-    switch, and you're done. Make sure you have the right modelines in your
+    option, and you're done. Make sure you have the right modelines in your
     XF86Config file, and try to make the DGA driver
     and SDL's DGA driver work for you.
     It's much faster. If SDL's DGA works, use that, it'll be even faster.


@@ -431,7 +431,7 @@
    
 
   Q: My computer plays M$ DivX AVIs with resolutions ~ 640x300 and stereo
-    mp3 sound too slow. When I use -nosound switch, everything is OK (but
+    mp3 sound too slow. When I use -nosound option, everything is OK (but
     quiet).
   A: Your machine is too slow or your soundcard driver is broken. Consult
     the documentation to see if you can improve performance.
@@ -539,7 +539,7 @@
     my notebook. It works normal when i run it as a user.
   A: This is again a power management effect (see above). Plug the external
     power connector in before you power on your notebook or use the
-    -nortc switch.
+    -nortc option.
 
 
 
@@ -560,7 +560,7 @@
   
   A: Are you running KDE or GNOME with the ARTS or ESD sound daemon? Try
     disabling the sound daemon or use the -ao arts or
-    -ao esd switch to make MPlayer use ARTS or ESD.
+    -ao esd option to make MPlayer use ARTS or ESD.
    
 
   Q: What about the DGA driver? I can't find it!
diff -r 8d6431bea500 -r 42667fd91d4a DOCS/formats.html
--- a/DOCS/formats.html	Tue Jan 28 01:46:53 2003 +0000
+++ b/DOCS/formats.html	Tue Jan 28 17:11:57 2003 +0000
@@ -314,7 +314,7 @@
   ./configure --enable-xmms. If that does not work, you might need
   to set the XMMS plugin and library path explicitly by way of the
   --with-xmmsplugindir and --withxmmslibdir
-  switches.
+  options.
   
 
 
diff -r 8d6431bea500 -r 42667fd91d4a DOCS/sound.html
--- a/DOCS/sound.html	Tue Jan 28 01:46:53 2003 +0000
+++ b/DOCS/sound.html	Tue Jan 28 17:11:57 2003 +0000
@@ -237,7 +237,7 @@
   is normally automated but can be overridden. The filters are activated when
   the properties of the audio data differ from those required by the sound card
   and deactivated if unnecessary. The -af filter1,filter2,...
-  switch is used to override the automatic activation of filters or to insert
+  option is used to override the automatic activation of filters or to insert
   filters that are not automatically inserted. The filters will be executed as
   they appear in the comma separated list.
 
@@ -247,10 +247,10 @@
 would run the sound through the resampling filter followed by the pan filter.
   Observe that the list must not contain any spaces, else it will fail.
 
-The filters often have switches that change their behavior. These switches
+
The filters often have options that change their behavior. These options
   are explained in detail in the sections below. A filter will execute using
-  default settings if its switches are omitted. Here is an example of how to use
-  filters in combination with filter specific switches:
+  default settings if its options are omitted. Here is an example of how to use
+  filters in combination with filter specific options:
 
   mplayer -af resample=11025,pan=1:0.5:0.5 -channels 1
   -srate 11025 media.avi
@@ -259,7 +259,7 @@
   the audio to 1 channel using the pan filter.
 
 The overall execution of the filter layer is controlled using the
-  -af-adv switch. This switch has two suboptions:
+  -af-adv option. This option has two suboptions:
 
 
   force

@@ -296,28 +296,30 @@
   
 
   
list
-  is an alias for the -af switch.
+  is an alias for the -af option.
 
 
-The filter layer is also affected by the following generic switches:
+
The filter layer is also affected by the following generic options:
 
 

   -v
   Increases the verbosity level and makes most filters print out extra
     status messages.
   -channels
-  This option sets the number of output channels your sound card is using.
+  
This option sets the number of output channels you would like your
+    sound card to use.
     It also affects the number of channels that are being decoded from the
     media. If the media contains less channels than requested the channels
     filter (see below) will automatically be inserted. The routing will be the
     default routing for the channels filter.
   -srate
-  This option selects the sample rate of your sound card. If the sample
+  
This option selects the sample rate you would like your sound card to
+    use (of course the cards have limits on this). If the sample
     frequency of your sound card is different from that of the current media,
     the resample filter (see below) will be inserted into the audio filter layer
     to compensate for the difference.
   -format

-  
This option sets the sample format of the audio filter layer and the sound
+  
This option sets the sample format between the audio filter layer and the sound
     card. If the requested sample format of your sound card is different from
     that of the current media, a format filter (see below) will be inserted to
     rectify the difference.
@@ -331,7 +333,7 @@
   have a fixed frequency sound card or if you are stuck with an old sound card
   that is only capable of max 44.1kHz. This filter is automatically enabled if
   it is necessary, but it can also be explicitly enabled on the command line. It
-  has three switches:
+  has three options:
 
 
   srate <8000-192000>
@@ -344,7 +346,7 @@
 
   sloppy
   is an optional binary parameter that allows the output frequency to differ
-    slightly from the frequency given by srate. This switch can be
+    slightly from the frequency given by srate. This option can be
     used if the startup of the playback is extremely slow. It is enabled by
     default.
 
@@ -373,12 +375,12 @@
   channels, it can also be used for routing or copying channels. It is
   automatically enabled when the output from the audio filter layer differs from
   the input layer or when it is requested by another filter. This filter unloads
-  itself if not needed. The number of switches is dynamic:
+  itself if not needed. The number of options is dynamic:
 
 
   nch <1-6>
   is an integer between 1 and 6 that is used for
-    setting the number of output channels. This switch is required, leaving it
+    setting the number of output channels. This option is required, leaving it
     empty results in a runtime error.
 
   nr <1-6>
@@ -421,7 +423,7 @@
 
   bps <number>
   can be 1, 2 or 4 and denotes the
-    number of bytes per sample. This switch is required, leaving it empty
+    number of bytes per sample. This option is required, leaving it empty
     results in a runtime error.
 
   f <format>
@@ -429,7 +431,7 @@
     concatenated mix of: alaw, mulaw or
     imaadpcm, float or int,
     unsigned or signed, le or
-    be (little or big endian). This switch is required, leaving it
+    be (little or big endian). This option is required, leaving it
     empty results in a runtime error.
 
 
@@ -485,7 +487,7 @@
   If there is an external amplifier connected to the computer (this is almost
   always the case), the noise level can be minimized by adjusting the master
   level and the volume knob on the amplifier until the hissing noise in the
-  background is gone. This filter has two switches:
+  background is gone. This filter has two options:
 
 
   v <-200 - +60>
@@ -495,7 +497,7 @@
   c
   is a binary control that turns soft clipping on and off. Soft-clipping can
     make the sound more smooth if very high volume levels are used. Enable this
-    switch if the dynamic range of the loudspeakers is very low. Be aware that
+    option if the dynamic range of the loudspeakers is very low. Be aware that
     this feature creates distortion and should be considered a last resort.
 
 
@@ -554,11 +556,11 @@
   canceling it almost completely around 1kHz.
 
 
-2.3.2.3.7 Panning filter 
+2.3.2.3.7 Panning filter
 
 Use the pan filter to mix channels arbitrarily. It is basically
   a combination of the volume control and the channels filter. There are two
-  major uses for this filter: 
+  major uses for this filter:
 
 
   Down-mixing many channels to only a few, stereo to mono for example.
@@ -566,13 +568,13 @@
 
 
 This filter is hard to use, and will require some tinkering before the
-  desired result is obtained. The number of switches for this filter depends on
+  desired result is obtained. The number of options for this filter depends on
   the number of output channels:
 
 
   nch <1-6>
   is an integer between 1 and 6 and is used for
-    setting the number of output channels. This switch is required, leaving it
+    setting the number of output channels. This option is required, leaving it
     empty results in a runtime error.
 
   l00:l01:l02:..l10:l11:l12:...ln0:ln1:ln2:...
@@ -653,16 +655,14 @@
   speakers.
 
 
-
+2.3.2.4 Audio plugins (deprecated)
 
 Note: Audio plugins have been deprecated by audio filters and will be
   removed soon.
 
-2.3.2.4 Audio plugins (deprecated)
-
 MPlayer has support for audio plugins. Audio plugins can be used to
   change the properties of the audio data before it reaches the sound
-  card. They are enabled using the -aop switch which takes a
+  card. They are enabled using the -aop option which takes a
   list=plugin1,plugin2,... argument. The list argument
   is required and determines which plugins should be used and in which order they
   should be executed. Example:
@@ -672,10 +672,10 @@
 would run the sound through the resampling plugin followed by the format
   plugin.
 
-The plugins can also have switches that change their behavior. These
-  switches are explained in detail in the sections below. A plugin will execute
-  using default settings if its switches are omitted.  Here is an example of how
-  to use plugins in combination with plugin specific switches:
+The plugins can also have options that change their behavior. These
+  options are explained in detail in the sections below. A plugin will execute
+  using default settings if its options are omitted.  Here is an example of how
+  to use plugins in combination with plugin specific options:
 
   mplayer media.avi -aop
   list=resample,format:fout=44100:format=0x8
@@ -692,7 +692,7 @@
   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.
   MPlayer autodetects whether or not usage of this plugin is necessary.
-  This plugin has one switch, fout, which is used for setting the
+  This plugin has one option, fout, which is used for setting the
   desired output sample frequency. The value is given in Hz, and defaults to
   48kHz.
 
@@ -721,7 +721,7 @@
 If your sound card driver does not support signed 16bit int data type,
   this plugin can
   be used to change the format to one which your sound card can understand. It
-  has one switch, format, which can be set to one of the numbers
+  has one option, format, which can be set to one of the numbers
   found in libao2/afmt.h. This plugin is hardly ever needed and is
   intended for advanced users. Keep in mind that this plugin only changes the
   sample format and not the sample frequency or the number of channels.
@@ -749,7 +749,7 @@
   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
   without changing the PCM volume setting in the mixer. It has one
-  switch volume that is used for setting the initial
+  option volume that is used for setting the initial
   sound level. The initial sound level can be set to values between 0
   and 255 and defaults to 101 which equals 0dB amplification. Use this
   plugin with caution since it can reduce the signal to noise ratio of
diff -r 8d6431bea500 -r 42667fd91d4a DOCS/video.html
--- a/DOCS/video.html	Tue Jan 28 01:46:53 2003 +0000
+++ b/DOCS/video.html	Tue Jan 28 17:11:57 2003 +0000
@@ -258,7 +258,7 @@
   --enable-dga.
 
 If the driver couldn't switch to a smaller resolution, experiment with
-  switches -vm (only with X 3.3.x), -fs, -bpp, -zoom to find a video mode that
+  options -vm (only with X 3.3.x), -fs, -bpp, -zoom to find a video mode that
   the movie fits in. There is no converter right now :(
 
 Become root. DGA needs root access to be able to write directly to video
@@ -315,7 +315,7 @@
 
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
   resolution of the video as close as possible. It deliberately ignores the
-  -vm and -fs switches (enabling of video mode switching and fullscreen) -
+  -vm and -fs options (enabling of video mode switching and fullscreen) -
   it always tries to cover as much area of your screen as possible by switching
   the video mode, thus refraining to use a single additional cycle of your CPU
   to scale the image.
@@ -459,7 +459,7 @@
 
SDL video output supports displaying subtitles under the movie, on the (if
   present) black bar.
 
-There are several command line switches for SDL:
+There are several command line options for SDL:
 
   -vo sdl:name
   specifies sdl video driver to use (i.e.. aalib, dga, x11)
@@ -501,7 +501,7 @@
 
 Notes
 
-Be sure not to use the -fs switch, since it toggles the usage of the software
+
Be sure not to use the -fs option, since it toggles the usage of the software
   scaler, and it's slow. If you really need it, use the -sws 4
   option which will produce bad quality, but is somewhat faster.
 
@@ -705,8 +705,8 @@
 NOTE: the rendering is very CPU intensive, especially when using AA-on-X
   (using aalib on X), and it's least CPU intensive on standard,
   non-framebuffer console. Use SVGATextMode to set up a big textmode,
-  then enjoy! (secondary head Hercules cards rock :)) (anyone can enhance
-  fbdev to do conversion/dithering to hgafb? Would be neat :)
+  then enjoy! (secondary head Hercules cards rock :)) (but imho you can use
+  -vop 1bpp option to get graphics on hgafb:)
 
 Use the -framedrop option if your computer isn't fast enough to
   render all frames!
@@ -1041,7 +1041,7 @@
   expand=w:h:x:y:1 (the 5th parameter :1 at the end
   will enable OSD rendering). You may want to move the image up a bit to get a
   bigger black zone for subtitles. You may also want to move subtitles up, if
-  they are outside your TV screen, use the -subpos <0-100> switch
+  they are outside your TV screen, use the -subpos <0-100> option
   to adjust this (-subpos 80 is a good choice).
 
 In order to play non-25fps movies on a PAL TV or with a slow CPU, add the

3.2.3 Slave mode

7.1 Encoding to MPEG format

7.2 Rescaling movies

Examples

2.3.2.3.7 Panning filter

2.3.2.3.7 Panning filter

2.3.2.4 Audio plugins (deprecated)

Note: Audio plugins have been deprecated by audio filters and will be removed soon.

2.3.2.4 Audio plugins (deprecated)

Notes