int ac3aid = 128
int mpegaid = 0
int pcmaid = 160
See bellow...
> > Is OGG/RM like MPG, like AVI or completely different?
> like avi and asf
2nd try:
MPG/SUB: 0-31 AVI/OGM: 1-99 ASF/RM: 0-127 AC3/DTS: 128-159 LPCM: 160-191
> > 1. man page, html docs, tech docs
> > IMHO (and some others) docs should be sthg like this:
> > syntax/option descriptions -> man page
> > practical use, guides, installation, etc -> html docs
> > tech/detailed docs -> tech/* -> simplified in manpage
> > I therefore thought that many documentation sections should be
> > moved to the manpage: from 2.5 (tv input), over 2.6 (vop
> > filters), till end of 3 (controls) and more. It's also easier
> > to maintain the docs this way. IMHO, the html docs should more
> > be like an accumulation of guides, donno... Diego?
>
> agree.
> maybe we should review tech/ section, move options (like lavc-*, swscaler-*
> etc) to manpage, and keep only developer files (interfaes, how does the
> demuxer work, file format details etc) in tech/
hmm, I actually ment to _base_ the manpage on the tech/* docs.
Shouldn't it be that the manpage is a subset of the particular
tech docs? On the other side it is even better if the developers
themself write the actual manpage section (as long as it's
"user-readable" ;)
> maybe make a new section in manpage, so you don't haveto mix the detailed
> explanation of -lavcopts etc to the common options.
>
> like:
>
> LIBAVCODEC options:
> ... (files from tech/libavc*.txt)
>
> SWSCALER options:
> ...
hmm, I don't like it but maybe/probably you're right. I just hate
separated docs and like the way it is now. Also I don't think
it's necessary to include all aspects of the options in the
manpage (for example chroma skipping in -vop scale), maybe in a
guide section where they are needed. I have a new idea:
Keep it the way it is now and (in future) move all recommend messages
(use this for this, this is a good choice, this is fast, what to do
in which cases, bitrate?,..) to a encoding guide. Maybe with separated
sections (dvd, vcd (mencvcd), tv, ..., donno).
I'd say it would be a really BIG help for many. Afaik there's no guide
like this available for linux and you just have to know the things to
get really good results. For Windows there's the doom9 forum etc.
There was such a guide around on the user ml (for dvd) but it was not
really enough at all (imho). Any volunteers to create such a guide?
-> IDEAS list ;)
> > 2. examples/syntax
> > I'm not sure at all, what to do with all the examples (see 1.
> > idea). Examples are very important for users. They can be:
> > - beside the described option in the manpage
> > - at the end of manpage (that's best choice and very
> > practical IMHO)
> > - in the html docs (see syntax description of vcd too...)
> > You can't move everything to the manpage as some things really
> > are related to the documentation (dvb for example) and the list
> > is already quite long (but this doesn't disturb much IMHO).
> > Another idea was to structure the EXAMPLES section at the end
> > into dvd/encoding/etc...
>
> imho manpage should not have big complete examples, it's the job of the
> tutorial-like docs. manpage may have simple example, like
> -vop filter[=param[:param2]][,filter2...]
> ...
> example:
> -vop scale=640:-2,rgb2bgr,pp=0x22
I more like centralized examples of _basic_ really often
used things, they belong in a manpage IMHO as it's the first
place someone looks at. Otherwise users have to search them
in the whole documentation which they probably won't do.
But I agree for specific long guides (dxr3,dvb,tvout,etc).
> > 3. What about a more detailed TODO/IDEAS?
> > IMHO more things would be done by users/ppl if they were
> > written down in a TODO (other: section for example ;).
> do it :)
I don't know enough and I fear to touch the TODO file. ;)
(Maybe I will do sthg like this outside the main cvs on a
webpage -> comparsion)
> > 4. messages
> > For me it just looks a bit messy: -quiet, -v (-v), normal
> > output, &>/dev/null </dev/null, etc... -quiet should at least
> > produce zero output IMHO, now it showed all pp changes with divx4
> > (autoq)! -> filled my terminal with messages...
>
> no. -quiet just disables status display, but keep the startup messages.
> and it's right imho.
I know, I just would have liked a general interface more than
all those variants. And sorry, I have to consider all those pp
autoq change outputs (with -quiet!) as a bug (hmm, forgot to report ;).
>
> > Nick's colored output looks good too IMHO, it's also easier to
> > read the important informations, especially for new users...
> yes i found it a great idea.
-> IDEAS list ;)
> > 5. TODO/some ideas (see 3.)
> > sw hue,saturation,intensity eq filter?
> intensity==brightness
I meant red_intensity etc...
> saturation = contrast of U,V planes (easy to implement)
> hue = hard to implement and who needs it?
Can't it be used to inverse colors? (someone wrote about crpyted
tv channel who does this)
> the only use of hue is UV swapping, writing a simple U<->V swapper filter is
> easier (using fourcc trick so it doesn't slow things down)
>
> > Write down patch rule to separate cosmetics/spellcheck and real
> > changes, for general syntax changes: Write down procedure
> > ('>' -> '>').
> huh?
IMHO the patch rules should include one which say that cosmetics
in the docs are allowed as long as they are clearly separated by
the real changes. The example bellow replaced all '>' with the
html version '>' to avoid a broken html. If you translate,
it's easier to just follow the rules of the cvs comment than
browsing all changes and find it out yourself.
> > Apply Nick's vidix/mplayerxp changes?
> any volunteers with ati cards? rage128 and radeon 8500 has known bugs.
>
> > '-vo fbdev:device' instead of -vo fbdev -fb device?
> good idea
>
> > '-dvd 9-12' command line possible? (like chapters)
> hmm, why not.
-> IDEAS list ;)
> > pre7 today? ;)
> with the above changes included :)
>
> > Damn, I wanted to write a one line mail, now I've got over 50.
> no. it's just one line, but that shitty mailer wrapped it :)
:)
I just remember the question I wrote the first mail for (I didn't
even include it ;)):
Where is the "-value w/h = original+value" vop parameter
description from? I haven't found sthg like this in vop.txt and
now I'm not sure if it applies to all w/h params, if it doesn't
exist of if it's only for scale.
Oh, and could someone check and comment the manpage patch? If I
get an ok, I'll commit...
Regards
Jonas
--cNdxnHkX5QqsyA0e
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename="manpage_vop.patch2"
--- mplayer.1 2002-08-27 15:29:41.000000000 +0200
+++ mplayer.1 2002-08-27 20:19:03.000000000 +0200
@@ -2,7 +2,7 @@
.\" This man page was/is done by Gabucino <sendmail(a)to.mplayer-users>
.\" (Patches done by Jonas Jermann <sendmail(a)to.mplayer-users>)
.\"
-.TH "MPlayer" "1" "2002-06-24"
+.TH "MPlayer" "1" "2002-08-27"
.SH "NAME"
mplayer \- Movie Player for Linux
@@ -23,7 +23,7 @@
.RB [dvd|vcd|cdda|cddb|tv]://[title]\ [options]
.br
.B mplayer
-.RB [mms|mmst|http|http_proxy|rtp]://[user:pass@]URL[:port]\ [options]
+.RB [mms|mmst|http|http_proxy|rtp|rtsp]://[user:passwd@]URL[:port]\ [options]
.br
.B mencoder
.RB [options]\ [\fIfile\fP\ |\ \fIURL\fP\ |\ \-\ ]\ [\-o\ file]
@@ -74,10 +74,11 @@
.br
You can put all of the options in a config file which will be read every time
.B mplayer
-is run. The system-wide config file is '/etc/mplayer.conf', the user specific
-one is '~/.mplayer/config'. User specific options override system-wide options
-and options given on the command line override either. The syntax of the config
-files is 'option=<value>', everything after a '#' is considered a comment.
+is run. The system-wide config file 'mplayer.conf' is in your configuration
+directory (e.g. /etc/mplayer), the user specific one is '~/.mplayer/config'.
+User specific options override system-wide options and options given on the
+command line override either. The syntax of the config files is
+'option=<value>', everything after a '#' is considered a comment.
Options that work without values can be enabled by setting them to 'yes' or '1'
and disabled by setting them to 'no' or '0'.
@@ -91,10 +92,11 @@
.br
flip=yes
+
.SH "DEMUXER/STREAM OPTIONS"
.TP
.B \-aid <id> (also see \-alang option)
-Select audio channel [MPG: 0\-31 AVI: 1\-99 ASF: 0\-127 VOB: 128\-...]
+Select audio channel [MPG/SUB: 0\-31 AVI/OGM: 1\-99 ASF/RM: 0\-127 VOB: 128\-159 LPCM: 160\-191]
.TP
.B \-alang <two letter\ country\ code> (also see \-aid option)
Works only for DVD playback! Selects DVD audio language. It always tries
@@ -317,7 +319,7 @@
audioid=<value> choose an audio output
of the capture card, if it
has more of them
-.TP
+
.I NOTE:
Mplayer doesn't accept colons so type dots instead in the device ID,
eg. hw.0,0 instead of hw:0,0)
@@ -327,6 +329,9 @@
You'll get an .avi file with no sound when you choose an odd
samplerate and use this codec.
.TP
+.B \-user <user name> (see \-passwd option too!)
+Specify user name for http authentication.
+.TP
.B \-vcd <track>
Play video CD track from device instead of plain file.
.TP
@@ -526,31 +531,89 @@
between them and when to use which, check the DivX4 section in the
documentation.
.TP
-.B \-vop <plugin3[=options],plugin2,plugin1,...>
-Activate comma separated list of video filters (see documentation).
+.B \-vop <...,plugin3[=options],plugin2,plugin1>
+Activate a comma separated list of video filters.
Available plugins are:
- crop[=w:h:x:y] cropping
- rectangle[=w:h:x:y] shows cropping boundaries
- expand[=w:h:x:y:o] expanding and OSD
- flip vertical mirroring
- mirror horizontal mirroring
- rotate[=<0-3>] rotate image +- 90 degrees
- scale[=w:h] software scaling
- yuy2 YV12/I420 \-> YUY2
+ crop[=w:h:x:y] Crops the given part of the
+ image and discards the rest.
+ Useful for removing black
+ bands from widescreen movies.
+
+ rectangle[=w:h:x:y] Draws a white rectangle of the
+ requested width and height at
+ the designated coordinates over
+ the image (used to test crop).
+ (default: maximum w/h, upper
+ left x/y position)
+
+ expand[=w:h:x:y:o] Expands (not scales) movie
+ resolution to the given value
+ and places the unscaled
+ original at coordinates x y.
+ Can be used for placing
+ subtitles/OSD in the resulting
+ black bands. (default: original
+ w/h, centered x/y)
+ parameter (de)activates OSD
+ rendering. (default: 0)
+
+ flip Flips the image upside down.
+
+ mirror Flips the image on Y axis.
+
+ rotate[=<0-3>] Rotates and flips the image
+ +/\- 90 degrees.
+
+ scale[=w:h[:c[:p]]] Scales the image with the
+ software scaler (slow) and
+ performs a YUV<\->RGB
+ colorspace conversion
+ (see \-sws option too!).
+ The value 0 is used for scaled
+ (aspect) destination w/h.
+ (default: original w/h,
+ destination w/h with \-zoom)
+
+ yuy2 Forces software YV12/I420 to
+ YUY2 conversion.
+
rgb2bgr[=swap] RGB 24/32 <\-> BGR 24/32
+ colorspace conversion with
+ optional R <\-> B swapping.
+
palette RGB/BGR 8 \-> 15/16/24/32bpp
- format[=fourcc] restrict colorspace
- pp[=flags] postprocessing (see \-pp)
- lavc[=quality:fps] YV12\->MPEG1 (libavcodec)
- fame YV12\->MPEG1 (libfame)
- dvbscale[=aspect] optimal scaling for DVB
- cards (aspect=
- DVB_HEIGHT*ASPECTRATIO)
- cropdetect[=limit] black border detection
- (print crop values)
- noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]
- add noise
+ colorspace conversion using
+ palette.
+
+ format[=fourcc] Restricts the colorspace for
+ next filter. It does not do
+ any conversion! Use the scale
+ filter for a real conversion.
+
+ pp[=flags] Activates the internal
+ postprocessing filter.
+ (see \-pp option for details!)
+
+ lavc[=quality:fps] Realtime MPEG1 encoder for use
+ with DVB/DXR3 (libavcodec)
+
+ fame Realtime MPEG1 encoder for use
+ with DVB/DXR3 (libfame)
+
+ dvbscale[=aspect] Set up optimal scaling for DVB
+ cards.
+ (aspect=DVB_HEIGHT*ASPECTRATIO)
+
+ cropdetect[=0-255] Calculates necessary cropping
+ parameters and prints the
+ recommended parameters to stdout.
+ The threshold can be optionally
+ specified from nothing (0) to
+ everything (255). (default: 24)
+
+ noise[=luma[u][t|a][h][p]:chroma[u][t|a][h][p]]
+ Adds noise
<0-100> luma noise
<0-100> chroma noise
u uniform noise
@@ -559,26 +622,19 @@
temporal noise
h high quality
p mix with pattern
- eq[=bright:cont] soft equalizer w/interactive
- controls like hardware eq
-.I parameters:
-.br
- w,h destination width/height
- value w/h = value
- \-1 w/h = original (default)
- 0 w/h = scaled (aspect) w/h
- \-value w/h = original+value
- x,y x/y position of the subimage
- value x/y = value
- \-1 x/y = center image (default)
- o enable/disable OSD/SUB rendering
- 0 disabled (default)
- 1 enabled
+ eq[=bright:cont] Activates the software equalizer
+ with interactive controls like
+ the hardware eq controls.
+ The values can be from -100 to
+ 100.
+
+.I NOTE:
+The parameters are optional and if omitted, some of them are set to default values.
+Use -1 to keep the default value.
You can get the list of available plugins executing
.I mplayer \-vop help
-
.TP
.B \-x <x> (MPLAYER only)
Scale image to x width (if sw/hw scaling available). Disables aspect calcs.
@@ -974,9 +1030,6 @@
Frame dropping: decode all (except B) frames, video may skip.
Useful for playback on slow VGA card/bus.
.TP
-.B \-gui (BETA CODE)
-Start MPlayer in GUI mode.
-.TP
.B \-h, \-\-help
Show short summary of options.
.TP
@@ -1556,7 +1609,7 @@
.SH FILES
.TP
-/etc/mplayer.conf
+/etc/mplayer/mplayer.conf
system\-wide settings
.TP
~/.mplayer/config
@@ -1565,6 +1618,12 @@
~/.mplayer/input.conf
input bindings (see '\-input keylist' for full keylist)
.TP
+~/.mplayer/gui.conf
+GUI configuration file
+.TP
+~/.mplayer/gui.pl
+GUI playlist
+.TP
~/.mplayer/font/
font directory (There must be a font.desc file and files with .RAW extension.)
.TP
@@ -1586,6 +1645,9 @@
.B Quickstart DVD playing
mplayer \-dvd 1
.TP
+.B Play in japanese with english subtitles
+mplayer \-dvd 1 \-alang ja \-slang en
+.TP
.B Play only chapters 5, 6, 7
mplayer \-dvd 1 \-chapter 5\-7
.TP
@@ -1619,6 +1681,9 @@
.B The same, but with libavcodec family, MPEG4 (Divx5) compression
mencoder -dvd 2 -o title2.avi -ovc lavc -lavcopts vcodec=mpeg4:vhq:vbitrate=1800 -oac copy
.TP
+.B The same, but with libavcodec family, MJPEG compression
+mencoder -dvd 2 -o titel2.avi -ovc lavc -lavcopts vcodec=mjpeg:vhq:vbitrate=1800 -oac copy
+.TP
.B Encoding all *.jpg files in the current dir
mencoder \\*.jpg -mf on:fps=25 -o output.avi -ovc divx4
.TP
--cNdxnHkX5QqsyA0e--
