manpage... Re: [Mplayer-cvslog] CVS: main/DOCS mplayer.1,1.305,1.306

[Arpi]

Hi,

> I think he ment the slave commands. It's true almost all new are 
> missing... :(

'mplayer -input cmdlist' should help a little bit.
i'm volunteering to help finding what is the purpose the missing commands.

> There are some cfg opts missing too: bandwidth, immediatemode 
> (tv), fps (tv), vivo subs, dfbopts(?), bmovl!, eq2, (yvu9), 
> cuefile/vcd, sub-bg-*, lavc: vstrict, psnr, predia
> 
> ... and probably more :(

ok, let's see them.

1. bandwith: i can't find it in cfg-* files, actually nowhere in *.h,*.c

2. -tv immediatemode: it's a strange option.
   it defaulst to 1 in mplayer and to 0 in mencoder.
   actually 1 means video capture only, the audio is not handled by mplayer
   (so you hear teh sound through external loopback between tuner & soundcard)
   and 0 means audio&video capture with buffering, useful for encoding only.
   i don't think that anyone should change this option, maybe it's for
   testing only.

3. -tv fps - trivial, it sets the expected frames per second value.
   (should be 25 for pal, 30 for ntsc)
   i don't know what will happen if you underestimate (specify lower value
   then the actual number of frames per second).

4. vivo subopts. imho it's not needed to be documented, since they were for
   debugging (overriding parameters parsed from headers) only.

5. dfbopts - huh.
  ah. ok. na. :)
  it's for -vo directfb2 only. it's a string value, actually a parameter
  list passed as-is to the directfb driver. since it's parsed by directfb
  lib, it should be documented in directfb docs, and is common syntax in all
  directfb apps. so dfb users should know them :)

6. -vop bmovl. nice.
   it's actially a filter to allow any application to draw any OSD (even
   alphablended truecolor images) over the video played by mplayer.

   rtfs said:  vf_bmovl: Arguments are 'bool hidden:bool opaque:string fifo
   but it's confusing and imho outdated :)
   more rtfs said:
   scanf(args, "%d:%d:%s", &vf->priv->hidden, &vf->priv->opaque, filename) < 3)
   -> it requires all that 3 parameters, they are not optional
[Note: FIXME: using exit(5) in vf_*.c is VERY BAD IDEA !!!]
   param 1: 'hidden', it's boolean, and sets teh default value of hidden flag
   param 2: 'opaque', it's a flag switching between alphablended
            (transparent) & opaque (fast) mode
   param 3: 'filename', it's the path/filename of the 'uplink' FIFO, is the
            named pipe connecting mplayer -vop bmovl to the controlling application
rtfcomments said:
 * Arguments for the filter are hidden:opaque:fifo
 * For example 1:0:/tmp/myfifo.fifo will start the filter hidden, transparent
 * and use /tmp/myfifo.fifo as the fifo.

7. eq2:
  it's another video equalizer filter, just like 'eq', but done by a bit
  different programming tech (using lookup tables instead of mmx asm:))
 
  it has 3 optional float parameters:
    sscanf (args, "%lf:%lf:%lf", &eq2->gamma, &eq2->contrast, &eq2->bright);

they defaults to:
  eq2->gamma = 1.0;
  eq2->contrast = 1.0;
  eq2->bright = 0.0;

8. yvu9: forget it' it's useless and obsolete. should be removed.

9. cuefile stuff:
   mplayer -vcd <trackno> -cuefile movietitle.cue
   it's for playback (S)VCD from CDRwin's (bin/cue fileformat) disk images.
   actually mplayer can play the .bin files as-is, but somethimes there are
   several tracks and this -cuefile stuff allows user to switch tracks,
   and skip the 1st track which is usually iso9660 filesystem (iso gate).
   (so actually -cuefile somehow replace steh -cdrom-device option for the
   -vcd (vcd://) mode, it'll point to a .cue file describing teh disk
   structure (TOC) and the image files (raw sectors))

10. sub-bg-*
   it enables 'black bands' behind the subtitle characters (to make them
   more readable on light background), just like on cinemas / 4:3 tv films.

      {"sub-bg-color", &sub_bg_color, CONF_TYPE_INT, CONF_RANGE, 0, 255, NULL},
      {"sub-bg-alpha", &sub_bg_alpha, CONF_TYPE_INT, CONF_RANGE, 0, 255, NULL},

color:  0=black   128=grey  255=white
alpha:  1=opaque  128=transparent  255=invisible

just tried, color>0 is not a good idea (imho).

note: alpha=0 is equal to alpha=255.

11. lavc... ask Michael...

someone please do mail2man now before this mail lost :)


A'rpi / Astral & ESP-team

--
Developer of MPlayer, the Movie Player for Linux - http://www.MPlayerHQ.hu