MPlayer skin format

1. The system info what we always want: · a)

    ./configure
+    make
+    make install
    mkdir ~/.mplayer/font
+    cd ~/.mplayer/font
+    unzip mp-arial-iso-8859-1.zip
  mplayer -vo x11 /mnt/Films/Contact/contact2.mpg
+  mplayer -vcd 2 /dev/cdrom
+  mplayer -afm 3 /mnt/DVDtrailers/alien4.vob
+  mplayer -dvd 1 /dev/dvd
+  mplayer -abs 65536 -delay -0.4 -nobps ~/movies/test.avi
  begin
+   remote = CU-SX070
+   prog = mplayer_lirc
+   button = Tape_Play
+   repeat = 1
+   config = FFWD
+  end
+
+  begin
+   remote = CU-SX070
+   prog = mplayer_lirc
+   button = Tape_Stop
+   config = QUIT
+  end
    cd main
+    fakeroot debian/rules binary
    dpkg -i ../mplayer_0.18-1_i386.deb as root.
	eyck@incubus:/src/main$ sudo dpkg -i ../mplayer_0.18-1_i386.deb
+	Password:
+	(Reading database ... 26946 files and directories currently installed.)
+	Preparing to replace mplayer 0.17a-1 (using ../mplayer_0.18-1_i386.deb)
+	Unpacking replacement mplayer ...
+	Setting up mplayer (0.18-1) ...
   % /usr/ccs/bin/make
+   make: Fatal error in reader: Makefile, line 25: Unexpected end of line seen
   % configure
+   ...
+   Checking assembler (/usr/ccs/bin/as) ... , failed
+   Please upgrade(downgrade) binutils to 2.10.1...
   % gmake
+   ...
+   gcc -c -Iloader -Ilibvo -O4 -march=i686 -mcpu=i686 -pipe -ffast-math
+	-fomit-frame-pointer  -I/usr/local/include   -o mplayer.o mplayer.c
+   Assembler: mplayer.c
+   "(stdin)", line 3567 : Illegal mnemonic
+   "(stdin)", line 3567 : Syntax error
+   ... more "Illegal mnemonic" and "Syntax error" errors ...
  ./configure --target=arm-linux --disable-css --with-x11libdir=/usr/arm/lib
+	      --with-x11incdir=/usr/arm/lib --disable-gcc-checking
+In file included from /usr/include/g++-v3/bits/std_cwchar.h:42,
+                 from /usr/include/g++-v3/bits/fpos.h:40,
+                 from /usr/include/g++-v3/bits/char_traits.h:40,
+                 from /usr/include/g++-v3/bits/std_string.h:41,
+                 from /usr/include/g++-v3/string:31,
+                 from libwin32.h:36,
+                 from DS_AudioDecoder.h:4,
+                 from DS_AudioDec.cpp:5:
+/usr/include/wchar.h: In function Long long int wcstoq(const wchar_t*,
+   wchar_t**, int)':
+/usr/include/wchar.h:514: cannot convert `const wchar_t* __restrict' to
+`const
+
Gtk-WARNING **: This process is currently running setuid or setgid.
+This is not a supported use of GTK+. You must create a helper
+program instead. For further details, see...
+    /usr/local/share/mplayer/Skin/
+    ~/.mplayer/Skin/
+
+    /usr/local/share/mplayer/Skin/default/
+
+section = section name
+.
+.
+.
+end
+
+window = window name
+.
+.
+.
+end
+
+item = parameter
+
+section = movieplayer
+  window = main
+  ; ... items for main window ...
+  end
+  
+  window = sub
+  ; ... items for subwindow ...
+  end
+  
+  window = menu
+  ; ... items for skin menu ...
+  end
+end
+
+    base = main, -1, -1
+
+    base = main.bmp, -1, -1
+

++------------+
+|  pressed   |
++------------+
+|  released  |
++------------+
+|  disabled  |
++------------+
+

++------------+
+|  phase #1  |
++------------+
+|  phase #2  |
++------------+
+     ...
++------------+
+|  phase #n  |
++------------+
+
+image = image
+
+"char" = x, y, w, h
+
+; can be "font" instead of "font.png"
+image = font.png
+
+; Three characters are enough for demonstration only. :-)
+"A" =  0,0, 7,13
+"B" =  7,0, 7,13
+"C" = 14,0, 7,13
+
+	X-Video Extension version 2.2
+	screen #0
+	  Adaptor #0: "Savage Streams Engine"
+	    number of ports: 1
+	    port base: 43
+	    operations supported: PutImage
+	    supported visuals:
+	      depth 16, visualID 0x22
+	      depth 16, visualID 0x23
+	    number of attributes: 5
+	(...)
+	    Number of image formats: 7
+	      id: 0x32595559 (YUY2)
+	        guid: 59555932-0000-0010-8000-00aa00389b71
+	        bits per pixel: 16
+	        number of planes: 1
+	        type: YUV (packed)
+	      id: 0x32315659 (YV12)
+	        guid: 59563132-0000-0010-8000-00aa00389b71
+	        bits per pixel: 12
+	        number of planes: 3
+	        type: YUV (planar)
+	(...etc...)
+
+  Section "Modes"
+    Identifier    "Modes[0]"
+    Modeline	"800x600"  40     800 840 968 1056  600 601 605 628
+    Modeline	"712x600"  35.0   712 740 850 900   400 410 412 425
+    Modeline	"640x480"  25.175 640 664 760 800   480 491 493 525
+    Modeline 	"400x300"  20     400 416 480 528   300 301 303 314 Doublescan
+    Modeline	"352x288"  25.10  352 368 416 432   288 296 290 310
+    Modeline	"352x240"  15.750 352 368 416 432   240 244 246 262 Doublescan
+    Modeline	"320x240"  12.588 320 336 384 400   240 245 246 262 Doublescan
+  EndSection
+

-dvd <title_id>	Enables DVD support and selects title.
-chapter <chapter_id>	Selects DVD chapter (default: play from chapter 1)
-dvdangle <angle_id>	Selects camera angle (default: 1)
-sid <subtitle_id>	Turns DVD subtitle displaying (of the given subtitle_id or language) on (default: no) + For the list of available languages, use `-sid 1 -v` options and + browse the output.

	Q:	+Playing a DVD, I encountered this error : +`mplayer: ifo_read.c:1143: ifoRead_C_ADT_internal: Assertion nfo_length / +sizeof(cell_adr_t) >= c_adt->nr_of_vobs' failed.` +
	A:	+This is a known libdvdread 0.9.1 bug, it should be already fixed in 0.9.2. +

	Q:	+Can I compile libdvdread and libdvdcss for example on my sweet Sparc/Solaris? +
	A:	+Who knows ... Please test it and send feedback. But it's said that it +should work. Please refer documentation of libdvdread and its homepage +as well. We're not authors of libdvdread. +

	Q:	+What about subtitles? Can MPlayer display them? +
	A:	+Yes! See above in the DVD chapter. +

	Q:	+I've got no sound / bad sound (Spanish audio and other ugly things). +
	A:	+MPlayer currently does not use all of information of IFO blocks from DVD. +You can adjust the right DVD audio stream with: '-aid 128' command line +option, where 128 is the stream id of requested audio stream. You can +experience with numbers of 128,129,... and so on. Of course this problem +will be solved in the future. +

	Q:	+There is some strange effect (interlace like thing) especially when fast +moving objects are shown in the movie. +
	A:	+Known problem, we try to fix it later (when we switch to libvo2). +

	Q:	+How can I set the region code of my DVD-Drive ? I don't have windows! +
	A:	+Use the 'regionset' tool: +http://www.linuxtv.org/download/dvd/dvd_disc_20000215.tar.gz +

	Q:	+So MPlayer can play DVDs? Then it must use DeCSS! You are under arrest +under the XYZ#$ paragraph of the-- +
	A:	+Get back asshole, there is no DeCSS code in MPlayer. MPlayer uses libdvdread +by linking against it, and libdvdread uses libdvdcss by dynamic loading it. +UPDATE : DeCSS is free. +

	Q:	+Do I need to be (setuid) root/setuid fibmap_mplayer to be able to play DVD? +
	A:	+No, you don't. This is the past :) However of course you must have got +the proper rights to the DVD device driver entry (in /dev). +

	Q:	+How can I ... (insert some expectable DVD player feature here)? +
	A:	+The current implementation is the first implementation of some real DVD +player functionality. First, we would like to target existing bugs and +basic features before implementing new features. +

	Q:	+Where can I get libdvdread and libdvdcss packages from? +
	A:	+From the site of Ogle: +http://www.dtek.chalmers.se/groups/dvd. +

	-vc odivx		u�ycie kodeka divx4 jako +nowej wersji OpenDivX. W tym przypadku produkuje on we w�asnym buforze obrazy +YV12 oraz MPlayer (libvo) dokonuje konwersji przestrzeni kolor�w. +(REKOMENDOWANE!)
	-vc divx4		u�ycie konwersji +przestrzeni kolor�w z kodeka divx4. W tym trybie mo�na u�y� r�wnie� +YUY2/UYVY.

	0		bez postproc
	10 .. 20		postprocessing, normalny (jak na poziomie 2 z divxd)
	30 .. 60		mocny prostprocessing, obci��a mocno CPU (podobnie jak poziom 4 z divxd

	on		use TV + input
	driver		+ dummy - NULL TV input :) Used for testing only, generates dummy + input. + v4l - captures images from standard V4L interface (default + `/dev/video0`)
	device		specify other + device than the default `/dev/video0`
	input		give from which + input of the TV tuner you which to grab from (e.g. television, + s-video, composite, ...) + Prints the available ones during init.
	freq		specify the + frequency to set the tuner (e.g. 511.250)
	outfmt		in which output + format to display images (rgb32, rgb24, yv12, + uyvy) + The following option must have the same setting !
	width		+ the width of the output window, in pixels
	height		+ the height of the output window, in pixels
	norm		+ available: PAL, SECAM, NTSC
	channel		+ set the tuner to the given channel
	chanlist		+ available: `us-bcast, us-cable, europe-west, europe-east, etc`

MPlayer skin format

Contents

1 Introduction

2 Overview

2.1 Directories

2.2 Image formats

2.3 Parts of a skin

2.4 Files

3 The `skin` file

3.1 Main window

3.2 Subwindow

3.3 Skin menu

4 Fonts

4.1 Symbols

Appendix A: GUI messages

	h or l		select previous/next channel
	n		change norm
	b		change channel list

	file		`mplayer [options] [path/]filename`
	VCD		`mplayer [options] -vcd trackno /dev/cdrom`
	DVD		`mplayer [options] -dvd titleno [/dev/dvd]`
	net		`mplayer [options] http://site.com/file.[mpg\|avi]`

	<- or ->	seek backward/forward 10 seconds
	up or down	seek backward/forward 1 minute
	pgup/pgdown	seek backward/forward 10 minutes
	< or >	seek backward/forward in playlist
	p or SPACE	pause movie (press any key)
	q or ESC	stop playing and quit program
	+ or -	adjust audio delay by +/- 0.1 second
	/ or *	decrease/increase volume
	o	toggle OSD: none / seek / seek+timer
	m	toggle using master/pcm volume
	z or x	adjust subtitle delay by +/- 0.1 second
(the following keys are valid only when using DirectShow DivX codec or DivX4 codec with -vc divx4)
	1 or 2	adjust contrast
	3 or 4	adjust brightness
	5 or 6	adjust hue
	7 or 8	adjust saturation
(the following keys are valid only with TV input support
	h or l	select previous/next channel
	n	change norm
	b	change channel list

	, and .		previous / next file
	gray - or +		decrease / increase volume
	enter		start playing
	space		pause
	s		stop
	a		about
	l		load file
	b		skin browser
	e		toggle equalizer
	p		toggle playlist
	f		toggle fullscreen
	m		toggle mute

	PAUSE		pause playing. Any other keystroke will continue replay.
	QUIT		exit MPlayer
	RWND		10 secs back
	FRWND		60 secs back
	FWD		skip 10 secs
	FFWD		skip 60 secs
	INCVOL		increase volume one percent
	DECVOL		decrease volume one percent
	MASTER		use master mixer channel
	PCM		use pcm mixer channel

	+ -o filename		+ specify output filename +
	+ -x width in pixels		+ rescale output video to given pixels width +
	+ -y height in pixels		+ rescale output video to given pixels height +
	+ -sws 0-2		+ type of scaling method + 0 - fast bilinear + 1 - bilinear + 2 - bicubic (best quality) +
	+ -ovc codecname		+ Encode with the given codec (codec names are from codecs.conf). Examples: + help - get list of available codecs + copy - no encoding, just copy the stream (only from AVI/ASF now) + divx4 - encode to DivX4 +
	+ -oac codecname		+ Encode with the given codec (codec names are from codecs.conf). Examples: + help - get list of available codecs + copy - no encoding, just copy the stream (only from AVI/ASF now) + pcm - encode to uncompressed PCM + mp3lame - encode to MP3 (using Lame) +
	+ -divx4opts		+ If encoding to DivX4, you can specify its parameters here, like: + `-divx4opts br=1800:deinterlace:key=250` + Common options: (for full list, check the manpage!) + help - get help + br=XXX - specify bitrate in kbit <4-16000> or bit <16001-24000000> + q=XXXX - quality (1-fastest, 5-best - default 5) +
	+ -lameopts		+ If encoding to MP3 with libmp3lame, you can specify its parameters here, like: + `-lameopts q=3` + `-lameopts br=192:cbr` + Common options: (for full list, check the manpage!) + help - get help + cbr - select CBR MP3 (default is VBR) + br=XXX - specify bitrate in kbit <0-1024> (this is for CBR only!) + q=XXXX - quality (0-highest, 9-fastest - default 0) (this is for VBR only!) +

Variable	Meaning
`$1`	play time in hh:mm:ss format
`$2`	play time in mmmm:ss format
`$3`	play time in hh format (hours)
`$4`	play time in mm format (minutes)
`$5`	play time in ss format (seconds)
`$6`	movie's length in hh:mm:ss format
`$7`	movie's length in mmmm:ss format
`$8`	play time in h:mm:ss format
`$v`	volume in xxx.xx% format
`$V`	volume in xxx.x format
`$b`	balance in xxx.xx% format
`$B`	balance in xxx.x format
`$$`	the `$` character
`$a`	a character according to the audio type (none: `n`, + mono: `m`, stereo: `t`)
`$t`	track number (in playlist)
`$o`	filename
`$f`	filename in lower case
`$F`	filename in upper case
`$T`	a character according to the stream type (file: `f`, + video CD: `v`, DVD: `d`, URL: `u`) +
`$p`	the "p" character (if a movie is playing and the font has the "p" + character) +
`$s`	the "s" character (if the movie is stopped and the font has the "s" + character) +
`$e`	the "e" character (if playback is paused and the font has the "e" + character) +

Character	Symbol
`p`	play
`s`	stop
`e`	pause
`n`	no sound
`m`	mono sound
`t`	stereo sound
`f`	stream is a file
`v`	stream is a video CD
`d`	stream is a DVD
`u`	stream is a URL

General:
	oss	OSS (ioctl) driver
	sdl	SDL driver (supports up/downsampling, ESD, ARTS etc)
	nas	NAS (Network Audio System) driver
	alsa5	native ALSA 0.5 driver
	alsa9	native ALSA 0.9 driver (works, but has problems -> use OSS)
	sun	SUN audio driver (/dev/audio) for BSD and Solaris8 users

VIA onboard chipset (via82cxxx) 48Khz only
	Driver:	from here
Aureal Vortex 2
	OSS:	no driver
	OSS/Pro:	OK
	ALSA:	no driver
	Max kHz:	48
	Driver:	aureal.sourceforge.net
	Driver2:	from here +(buffer size increased to 32k)
GUS PnP
	OSS:	no driver
	OSS/Pro:	OK
	ALSA:	OK
	Max kHz:	48
SB Live!
	OSS:	OK
	ALSA:	(?)
	Max kHz:	48
SB AWE 64
	OSS:	max 44kHz
	ALSA:	48kHz sounds shit
	Max kHz:	48
Gravis UltraSound ACE
	OSS:	max 44Khz. not OK
	ALSA:	OK
	Max kHz:	48
Gravis UltraSound MAX
	OSS:	OK
	ALSA:	OK (?)
	Max kHz:	48
ESS 688
	OSS:	OK
	ALSA:	OK (?)
	Max kHz:	48
C-Media cards (which ones?)
	OSS:	not OK (hissing) (?)
	ALSA:	OK (?)
	Max kHz:	?
*Yamaha cards (ymf)*
	OSS:	not OK (?) (maybe -ao sdl)
	ALSA:	OK only with ALSA 0.5 with OSS emulation AND -ao sdl (!) (?)
	Max kHz:	?
Cards with envy24 chips (like Terratec EWS88MT)
	OSS:	?
	OSS/Pro:	OK
	ALSA:	?
	Max kHz:	?
PC Speaker or DAC
	OSS:	OK (use the SDL driver : -ao sdl)
	ALSA:	no driver
	Max kHz:	the driver emulates 44.1 maybe more
	Driver:	ftp://ftp.infradead.org/pub/pcsp

General:
	x11	X11 with optional SHM + extension
	xv	X11 using overlays with the Xvideo extension + (hardware YUV & scaling)
	gl	OpenGL renderer, so far works only with: + all cards with Utah-GLX + Matrox cards with X/DRI >=4.0.3 + Radeon with X/DRI CVS
	dga	X11 DGA extension
	fbdev	Output to general framebuffers
	svga	Output to SVGAlib
	sdl	+ `1.1.7:` supports software scaling + `1.1.8:` supports Xvideo (hardware scaling/fullscreen) + `1.2.0:` supports AAlib (-vo aa is very recommended, see below!)
	ggi	similar to SDL
	aa	textmode rendering with AAlib
	vesa	Output to VESA BIOS.
Card specific:
	mga	Matrox G200/G400 hardware + YUV overlay via the mga_vid device
	xmga	Matrox G200/G400 overlay (mga_vid) in X11 + window +(Xv emulation on X 3.3.x!)
	syncfb	Matrox G400 YUV support on framebuffer (obsoleted, use + mga/xmga)
	3dfx	Voodoo3/Banshee hardware YUV (/dev/3dfx) support (not yet tested, maybe + broken)
	tdfxfb	Voodoo3/Banshee hardware YUV support on tdfx + framebuffer (works!)
Special:
	png	PNG files output (use -z switch to set + compression)
	pgm	PGM files output (for testing purposes or ffmpeg encoding)
	md5	MD5sum output (for MPEG conformance tests)
	null	Null output (for speed tests/benchmarking)

	1 MB		0x100000
	2 MB		0x200000
	4 MB		0x400000
	8 MB		0x800000
	16 MB		0x1000000
	32 MB		0x2000000

There are several commandline switches for SDL:
	-vo sdl:name	+specifies sdl video driver to use (ie. aalib, dga, x11)
	-ao sdl:name	specifies sdl audio driver to use (ie. dsp, +esd, arts)
	-noxv	disables Xvideo hardware acceleration
	-forcexv	tries to force Xvideo acceleration
SDL Keys:
	F	toggles fullscreen/windowed mode
	C	cycles available fullscreen modes
	W/S	mappings for * and / (mixer control)

	-fb		+specify the framebuffer device to use (/dev/fd0)
	-fbmode		mode name to use (according to /etc/fb.modes)
	-fbmodeconfig		config file of modes (default /etc/fb.modes)
	-monitor_hfreq		IMPORTANT values, see example.conf
	-monitor_vfreq
	-monitor_dotclock

You can use some keys in the AA Window to change rendering options:
	1	decrease contrast
	2	increase contrast
	3	decrease brightness
	4	increase brightness
	5	switch fast rendering on/off
	6	set dithering mode (none, error distribution, floyd steinberg)
	7	invert image
	a	toggles between aa and mplayer control)
The following command line options can be used:
	-aaosdcolor=V	change osd color
	-aasubcolor=V	change subtitle color
		where V can be: (0/normal, 1/dark, 2/bold, 3/boldfont, 4/reverse, 5/special)
AAlib itselves provides a large sum of options. +Here are some important:
	-aadriver	set recommended aa driver (X11, curses, linux)
	-aaextended	use all 256 characters
	-aaeight	use eight bit ascii
	-aahelp	prints out all aalib options

These switches of command line currently are available for VESA:
	-vo vesa:opts	currently recognized: dga to force dga mode and nodga to disable dga mode. Note: you may omit these parameters to enable autodetect of dga mode. (In the future also will specify mode parameters such as refresh rate, interlacing, doublescan and so on. Samples: i43, 85, d100)
	-screenw, -screenh, -bpp	force userdefined mode
	-x, -y	set userdefined prescaling
	-zoom	enables userdefined prescaling
	-fs	scales image to fullscreen
	-fs -zoom	scales userdefined prescaling to fullscreen
	-double	enables double buffering mode. (Available only in DGA mode). Should be slower of single buffering, but has no flickering effects.