mplayer.hg: DOCS/skin.html annotate

annotate DOCS/skin.html @ 9057:99a3ab65891d

sync

author	gabucino
date	Tue, 21 Jan 2003 21:11:57 +0000
parents	7b6b7fb76965
children	b840039be057

rev	line source
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1982 b190d3e9427c init version pontscho parents: diff changeset	2 <html>
b190d3e9427c init version pontscho parents: diff changeset	3 <head>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	4 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
6882 f3f87f6bf5cf Added a uniform title: something - MPlayer - The Movie Player for Linux. diego parents: 6726 diff changeset	5 <title>Creating Skins - MPlayer - The Movie Player for Linux</title>
6395 9b218a01b74b use default.css diego parents: 6271 diff changeset	6 <link rel="stylesheet" type="text/css" href="default.css">
1982 b190d3e9427c init version pontscho parents: diff changeset	7 <style type="text/css">
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	8 em.note {color: green;
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	9 font-style: normal;}
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	10 em.warn {color: red;
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	11 font-style: normal;}
1982 b190d3e9427c init version pontscho parents: diff changeset	12 </style>
b190d3e9427c init version pontscho parents: diff changeset	13 </head>
b190d3e9427c init version pontscho parents: diff changeset	14
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	15 <body>
1982 b190d3e9427c init version pontscho parents: diff changeset	16
b190d3e9427c init version pontscho parents: diff changeset	17 <h1 align="center">MPlayer skin format</h1>
b190d3e9427c init version pontscho parents: diff changeset	18
b190d3e9427c init version pontscho parents: diff changeset	19 <hr>
b190d3e9427c init version pontscho parents: diff changeset	20
b190d3e9427c init version pontscho parents: diff changeset	21 <h2>Contents</h2>
b190d3e9427c init version pontscho parents: diff changeset	22
b190d3e9427c init version pontscho parents: diff changeset	23 <ul type=disc>
b190d3e9427c init version pontscho parents: diff changeset	24 <li><a href="#intro">1 Introduction</a></li>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	25 <li><a href="#overview">2 Overview</a>
1982 b190d3e9427c init version pontscho parents: diff changeset	26 <ul type=circle>
b190d3e9427c init version pontscho parents: diff changeset	27 <li><a href="#dirs">2.1 Directories</a></li>
b190d3e9427c init version pontscho parents: diff changeset	28 <li><a href="#images">2.2 Images</a></li>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	29 <li><a href="#components">2.3 Skin components</a></li>
1982 b190d3e9427c init version pontscho parents: diff changeset	30 <li><a href="#files">2.4 Files</a></li>
b190d3e9427c init version pontscho parents: diff changeset	31 </ul>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	32 </li>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	33 <li><a href="#skin">3 The <code>skin</code> file</a>
1982 b190d3e9427c init version pontscho parents: diff changeset	34 <ul type=circle>
b190d3e9427c init version pontscho parents: diff changeset	35 <li><a href="#mainwin">3.1 Main window</a></li>
b190d3e9427c init version pontscho parents: diff changeset	36 <li><a href="#subwindow">3.2 Subwindow</a></li>
b190d3e9427c init version pontscho parents: diff changeset	37 <li><a href="#skinmenu">3.3 Skin menu</a></li>
b190d3e9427c init version pontscho parents: diff changeset	38 </ul>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	39 </li>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	40 <li><a href="#fonts">4 Fonts</a>
1982 b190d3e9427c init version pontscho parents: diff changeset	41 <ul type=circle>
b190d3e9427c init version pontscho parents: diff changeset	42 <li><a href="#symbols">4.1 Symbols</a></li>
b190d3e9427c init version pontscho parents: diff changeset	43 </ul>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	44 </li>
1982 b190d3e9427c init version pontscho parents: diff changeset	45 <li><a href="#guimsg">Appendix A: GUI messages</a></li>
b190d3e9427c init version pontscho parents: diff changeset	46 </ul>
b190d3e9427c init version pontscho parents: diff changeset	47
b190d3e9427c init version pontscho parents: diff changeset	48 <hr>
b190d3e9427c init version pontscho parents: diff changeset	49
b190d3e9427c init version pontscho parents: diff changeset	50 <div align=center>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	51 Last modified: 2002/05/24
1982 b190d3e9427c init version pontscho parents: diff changeset	52 </div>
b190d3e9427c init version pontscho parents: diff changeset	53
b190d3e9427c init version pontscho parents: diff changeset	54 <hr>
b190d3e9427c init version pontscho parents: diff changeset	55
b190d3e9427c init version pontscho parents: diff changeset	56 <h2><a name="intro">1 Introduction</a></h2>
b190d3e9427c init version pontscho parents: diff changeset	57
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 6882 diff changeset	58 The purpose of this document is to describe the MPlayer skin format.
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	59 The information contained here might be wrong, for
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	60
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	61 <ol type="a">
8432 7b6b7fb76965 small updates diego parents: 8316 diff changeset	62 <li>It is not me who wrote the GUI.</li>
7b6b7fb76965 small updates diego parents: 8316 diff changeset	63 <li>The GUI is not finished.</li>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	64 <li>I might be wrong.</li>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	65 </ol>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	66
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	67 So do not be surprised if something does not work as described here.
1982 b190d3e9427c init version pontscho parents: diff changeset	68
b190d3e9427c init version pontscho parents: diff changeset	69 <p>
b190d3e9427c init version pontscho parents: diff changeset	70 Thanks to <em>Zolt�n Ponekker</em> for his help.
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	71 </p>
1982 b190d3e9427c init version pontscho parents: diff changeset	72
b190d3e9427c init version pontscho parents: diff changeset	73 <p>
b190d3e9427c init version pontscho parents: diff changeset	74 <em>Andr�s Mohari <mayday@freemail.hu></em>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	75 </p>
1982 b190d3e9427c init version pontscho parents: diff changeset	76
b190d3e9427c init version pontscho parents: diff changeset	77
b190d3e9427c init version pontscho parents: diff changeset	78 <h2><a name="overview">2 Overview</a></h2>
b190d3e9427c init version pontscho parents: diff changeset	79
b190d3e9427c init version pontscho parents: diff changeset	80 It does not really have anything to do with the skin format, but you should
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 6882 diff changeset	81 know that MPlayer has <b>no</b> builtin skin, so <b>at least one skin
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	82 must be installed in order to be able to use the GUI.</b>
1982 b190d3e9427c init version pontscho parents: diff changeset	83
b190d3e9427c init version pontscho parents: diff changeset	84
b190d3e9427c init version pontscho parents: diff changeset	85 <h3><a name="dirs">2.1 Directories</a></h3>
b190d3e9427c init version pontscho parents: diff changeset	86
b190d3e9427c init version pontscho parents: diff changeset	87 The directories searched for skins are (in order):
b190d3e9427c init version pontscho parents: diff changeset	88 <pre>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	89 $(DATADIR)/Skin/
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	90 $(PREFIX)/share/mplayer/Skin/
1982 b190d3e9427c init version pontscho parents: diff changeset	91 ~/.mplayer/Skin/
b190d3e9427c init version pontscho parents: diff changeset	92 </pre>
b190d3e9427c init version pontscho parents: diff changeset	93
b190d3e9427c init version pontscho parents: diff changeset	94 <p>
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 6882 diff changeset	95 Note that the first path may vary according to the way MPlayer was
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	96 configured (see the <code>--prefix</code> and <code>--datadir</code> arguments
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	97 of the <code>configure</code> script).
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	98 </p>
1982 b190d3e9427c init version pontscho parents: diff changeset	99
b190d3e9427c init version pontscho parents: diff changeset	100 Every skin is installed into its own directory under one of the directories
b190d3e9427c init version pontscho parents: diff changeset	101 listed above, for example:
b190d3e9427c init version pontscho parents: diff changeset	102 <pre>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	103 $(PREFIX)/share/mplayer/Skin/default/
1982 b190d3e9427c init version pontscho parents: diff changeset	104 </pre>
b190d3e9427c init version pontscho parents: diff changeset	105
b190d3e9427c init version pontscho parents: diff changeset	106
b190d3e9427c init version pontscho parents: diff changeset	107 <h3><a name="images">2.2 Image formats</a></h3>
b190d3e9427c init version pontscho parents: diff changeset	108
8432 7b6b7fb76965 small updates diego parents: 8316 diff changeset	109 Images must be truecolor (24 or 32 bpp) PNGs.
1982 b190d3e9427c init version pontscho parents: diff changeset	110
b190d3e9427c init version pontscho parents: diff changeset	111 <p>
9057 99a3ab65891d sync gabucino parents: 8432 diff changeset	112 In the main window and in the playbar (see below) you can use images with `transparency':
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	113 Regions filled with the color #FF00FF (<font color="#FF00FF">magenta</font>)
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 6882 diff changeset	114 are fully transparent when viewed by MPlayer. This means that you can even
1982 b190d3e9427c init version pontscho parents: diff changeset	115 have shaped windows if your X server has the XShape extension.
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	116 </p>
1982 b190d3e9427c init version pontscho parents: diff changeset	117
b190d3e9427c init version pontscho parents: diff changeset	118
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	119 <h3><a name="components">2.3 Skin components</a></h3>
1982 b190d3e9427c init version pontscho parents: diff changeset	120
b190d3e9427c init version pontscho parents: diff changeset	121 Skins are quite free-format (unlike the fixed-format skins of
b190d3e9427c init version pontscho parents: diff changeset	122 Winamp/XMMS, for example), so it is up to you to create something great.
b190d3e9427c init version pontscho parents: diff changeset	123
b190d3e9427c init version pontscho parents: diff changeset	124 <p>
b190d3e9427c init version pontscho parents: diff changeset	125 Currently there are three windows to be decorated: the
9057 99a3ab65891d sync gabucino parents: 8432 diff changeset	126 <a href="#mainwin">main window</a>, the <a href="#subwindow">subwindow</a>, the
99a3ab65891d sync gabucino parents: 8432 diff changeset	127 <a href="#mainwin">playbar</a>, and
1982 b190d3e9427c init version pontscho parents: diff changeset	128 the <a href="#skinmenu">skin menu</a> (which can be activated by a right
b190d3e9427c init version pontscho parents: diff changeset	129 click).
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	130 </p>
1982 b190d3e9427c init version pontscho parents: diff changeset	131
b190d3e9427c init version pontscho parents: diff changeset	132 <ul>
b190d3e9427c init version pontscho parents: diff changeset	133 <li>
9057 99a3ab65891d sync gabucino parents: 8432 diff changeset	134 The <b>main window</b> and/or the <b>playbar</b> is where you can control MPlayer. The background of
1982 b190d3e9427c init version pontscho parents: diff changeset	135 the window is an image. Various items can (and must) be
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	136 placed in the window: <em>buttons</em>, <em>potmeters</em> (sliders) and
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	137 <em>labels</em>. For every item, you must
1982 b190d3e9427c init version pontscho parents: diff changeset	138 specify its position and size.
b190d3e9427c init version pontscho parents: diff changeset	139
b190d3e9427c init version pontscho parents: diff changeset	140 <p>
b190d3e9427c init version pontscho parents: diff changeset	141 A <b>button</b> has three states (pressed, released,
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	142 disabled), thus its image must be divided into three parts vertically.
1982 b190d3e9427c init version pontscho parents: diff changeset	143 See the <a href="#main.button">button</a> item for details.
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	144 </p>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	145
1982 b190d3e9427c init version pontscho parents: diff changeset	146 <p>
b190d3e9427c init version pontscho parents: diff changeset	147 A <b>potmeter</b> (mainly used for the seek bar and volume/balance
b190d3e9427c init version pontscho parents: diff changeset	148 control) can have any number of phases by dividing its image into different
b190d3e9427c init version pontscho parents: diff changeset	149 parts below each other.
b190d3e9427c init version pontscho parents: diff changeset	150 See <a href="#main.hpotmeter">hpotmeter</a> and
b190d3e9427c init version pontscho parents: diff changeset	151 <a href="#main.potmeter">potmeter</a> for details.
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	152 </p>
1982 b190d3e9427c init version pontscho parents: diff changeset	153
b190d3e9427c init version pontscho parents: diff changeset	154 <p>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	155 <b>Labels</b> are a bit special: The characters needed to draw them are taken
1982 b190d3e9427c init version pontscho parents: diff changeset	156 from an image file, and the characters in the image are described
b190d3e9427c init version pontscho parents: diff changeset	157 by a <a href="#fonts">font description file</a>.
b190d3e9427c init version pontscho parents: diff changeset	158 The latter is a plain text file which specifies
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	159 the x,y position and size of each character in the image (the
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	160 image file and its font description file form a font <em>together</em>).
1982 b190d3e9427c init version pontscho parents: diff changeset	161 See <a href="#main.dlabel">dlabel</a> and <a href="#main.slabel">slabel</a>
b190d3e9427c init version pontscho parents: diff changeset	162 for details.
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	163 </p>
1982 b190d3e9427c init version pontscho parents: diff changeset	164
b190d3e9427c init version pontscho parents: diff changeset	165 <p>
b190d3e9427c init version pontscho parents: diff changeset	166 <em class=note>
b190d3e9427c init version pontscho parents: diff changeset	167 <b>Note:</b> all images can have full transparency as described in the
8316 6548f6a4216b sync gabucino parents: 7814 diff changeset	168 section about <a href="#images">image formats</a>. If the X Server doesn't
6548f6a4216b sync gabucino parents: 7814 diff changeset	169 support the XShape extension, the parts marked transparent will be black. If
6548f6a4216b sync gabucino parents: 7814 diff changeset	170 you'd like to use this feature, the width of the main window's background image
6548f6a4216b sync gabucino parents: 7814 diff changeset	171 must be dividable by 8.
1982 b190d3e9427c init version pontscho parents: diff changeset	172 </em>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	173 </p>
1982 b190d3e9427c init version pontscho parents: diff changeset	174 </li>
b190d3e9427c init version pontscho parents: diff changeset	175
b190d3e9427c init version pontscho parents: diff changeset	176 <li>
b190d3e9427c init version pontscho parents: diff changeset	177 The <b>subwindow</b> is where the movie appears. It can display a specified
b190d3e9427c init version pontscho parents: diff changeset	178 image if there is no movie loaded (it is quite boring to have an empty
b190d3e9427c init version pontscho parents: diff changeset	179 window :-))
b190d3e9427c init version pontscho parents: diff changeset	180 <em class=note><b>Note:</b> transparency
b190d3e9427c init version pontscho parents: diff changeset	181 is <b>not allowed</b> here.</em>
b190d3e9427c init version pontscho parents: diff changeset	182 </li>
b190d3e9427c init version pontscho parents: diff changeset	183
b190d3e9427c init version pontscho parents: diff changeset	184 <li>
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 6882 diff changeset	185 The <b>skin menu</b> is just a way to control MPlayer by means of
1982 b190d3e9427c init version pontscho parents: diff changeset	186 menu entries. Two images are required for the menu: one of them is the base
b190d3e9427c init version pontscho parents: diff changeset	187 image that shows the menu in its normal state, the other one is used to
b190d3e9427c init version pontscho parents: diff changeset	188 display the selected entries. When you pop up the menu, the first image is
b190d3e9427c init version pontscho parents: diff changeset	189 shown. If you move the mouse over the menu entries, the currently selected
b190d3e9427c init version pontscho parents: diff changeset	190 entry is copied from the second image over the menu entry below the mouse
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	191 pointer (the second image is never shown as a whole).
1982 b190d3e9427c init version pontscho parents: diff changeset	192 <p>
b190d3e9427c init version pontscho parents: diff changeset	193 A menu entry is defined by its position and size in the image (see the
b190d3e9427c init version pontscho parents: diff changeset	194 section about the <a href="#skinmenu">skin menu</a> for details).
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	195 </p>
1982 b190d3e9427c init version pontscho parents: diff changeset	196 </li>
b190d3e9427c init version pontscho parents: diff changeset	197 </ul>
b190d3e9427c init version pontscho parents: diff changeset	198
b190d3e9427c init version pontscho parents: diff changeset	199 <p>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	200 There is an important thing not mentioned yet: For buttons, potmeters and
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 6882 diff changeset	201 menu entries to work, MPlayer must know what to do if they are clicked.
1982 b190d3e9427c init version pontscho parents: diff changeset	202 This is done by <a href="#guimsg">messages</a> (events). For these items
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	203 you must define the messages to be generated when they are clicked.
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	204 </p>
1982 b190d3e9427c init version pontscho parents: diff changeset	205
b190d3e9427c init version pontscho parents: diff changeset	206 <h3><a name="files">2.4 Files</a></h3>
b190d3e9427c init version pontscho parents: diff changeset	207
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	208 You need the following files to build a skin:
1982 b190d3e9427c init version pontscho parents: diff changeset	209 <ul>
b190d3e9427c init version pontscho parents: diff changeset	210 <li>
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 6882 diff changeset	211 The configuration file named <a href="#skin">skin</a> tells MPlayer how
1982 b190d3e9427c init version pontscho parents: diff changeset	212 to put different parts of the skin together and what to do if you click
b190d3e9427c init version pontscho parents: diff changeset	213 somewhere in the window.
b190d3e9427c init version pontscho parents: diff changeset	214 </li>
b190d3e9427c init version pontscho parents: diff changeset	215 <li>The background image for the main window.</li>
b190d3e9427c init version pontscho parents: diff changeset	216 <li>Images for the items in the main window (including one or more font
b190d3e9427c init version pontscho parents: diff changeset	217 description files needed to draw labels).</li>
b190d3e9427c init version pontscho parents: diff changeset	218 <li>The image to be displayed in the subwindow (optional).</li>
b190d3e9427c init version pontscho parents: diff changeset	219 <li>Two images for the skin menu (they are needed only if you want to create
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	220 a menu).</li>
1982 b190d3e9427c init version pontscho parents: diff changeset	221 </ul>
b190d3e9427c init version pontscho parents: diff changeset	222
b190d3e9427c init version pontscho parents: diff changeset	223 With the exception of the skin configuration file, you can name the other
b190d3e9427c init version pontscho parents: diff changeset	224 files whatever you want (but note that font description files must have
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	225 a <code>.fnt</code> extension).
1982 b190d3e9427c init version pontscho parents: diff changeset	226
b190d3e9427c init version pontscho parents: diff changeset	227
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	228 <h2><a name="skin">3 The <code>skin</code> file</a></h2>
1982 b190d3e9427c init version pontscho parents: diff changeset	229
b190d3e9427c init version pontscho parents: diff changeset	230 <p>
b190d3e9427c init version pontscho parents: diff changeset	231 As mentioned above, this is the skin configuration file.
b190d3e9427c init version pontscho parents: diff changeset	232 It is line oriented; comment lines start with a '<code>;</code>' character
b190d3e9427c init version pontscho parents: diff changeset	233 at the beginning of the line (only spaces and tabs are allowed before the
b190d3e9427c init version pontscho parents: diff changeset	234 '<code>;</code>').
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	235 </p>
1982 b190d3e9427c init version pontscho parents: diff changeset	236
b190d3e9427c init version pontscho parents: diff changeset	237 <p>
b190d3e9427c init version pontscho parents: diff changeset	238 The file is made up of sections. Each section describes the skin for an
b190d3e9427c init version pontscho parents: diff changeset	239 application and has the following form:
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	240 </p>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	241
1982 b190d3e9427c init version pontscho parents: diff changeset	242 <table border=1 width="100%"><tr bgcolor=silver><td><pre>
b190d3e9427c init version pontscho parents: diff changeset	243 section = <i>section name</i>
b190d3e9427c init version pontscho parents: diff changeset	244 .
b190d3e9427c init version pontscho parents: diff changeset	245 .
b190d3e9427c init version pontscho parents: diff changeset	246 .
b190d3e9427c init version pontscho parents: diff changeset	247 end
b190d3e9427c init version pontscho parents: diff changeset	248 </pre></td></tr></table>
b190d3e9427c init version pontscho parents: diff changeset	249
b190d3e9427c init version pontscho parents: diff changeset	250 <p>
b190d3e9427c init version pontscho parents: diff changeset	251 Currently there is only one application, so you need only one section:
b190d3e9427c init version pontscho parents: diff changeset	252 its name is <b>movieplayer</b>.
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	253 </p>
1982 b190d3e9427c init version pontscho parents: diff changeset	254
b190d3e9427c init version pontscho parents: diff changeset	255 <p>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	256 Within this section each window is described by a block of the following form:
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	257 </p>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	258
1982 b190d3e9427c init version pontscho parents: diff changeset	259 <table border=1 width="100%"><tr bgcolor=silver><td><pre>
b190d3e9427c init version pontscho parents: diff changeset	260 window = <i>window name</i>
b190d3e9427c init version pontscho parents: diff changeset	261 .
b190d3e9427c init version pontscho parents: diff changeset	262 .
b190d3e9427c init version pontscho parents: diff changeset	263 .
b190d3e9427c init version pontscho parents: diff changeset	264 end
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	265 </pre></td></tr></table>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	266
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	267 <p>
1982 b190d3e9427c init version pontscho parents: diff changeset	268 where <i>window name</i> can be one of these strings:
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	269 </p>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	270
1982 b190d3e9427c init version pontscho parents: diff changeset	271 <ul>
b190d3e9427c init version pontscho parents: diff changeset	272 <li><b>main</b> - for the main window</li>
b190d3e9427c init version pontscho parents: diff changeset	273 <li><b>sub</b> - for the subwindow</li>
b190d3e9427c init version pontscho parents: diff changeset	274 <li><b>menu</b> - for the skin menu</li>
9057 99a3ab65891d sync gabucino parents: 8432 diff changeset	275 <li><b>playbar</b> - playbar</li>
1982 b190d3e9427c init version pontscho parents: diff changeset	276 </ul>
b190d3e9427c init version pontscho parents: diff changeset	277
b190d3e9427c init version pontscho parents: diff changeset	278 <p>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	279 (The sub and menu blocks are optional - you do not need to create a menu or
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	280 decorate the subwindow.)
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	281 </p>
1982 b190d3e9427c init version pontscho parents: diff changeset	282
b190d3e9427c init version pontscho parents: diff changeset	283 <p>
b190d3e9427c init version pontscho parents: diff changeset	284 Within a window block, you can define each item for the window
b190d3e9427c init version pontscho parents: diff changeset	285 by a line in this form:
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	286 </p>
1982 b190d3e9427c init version pontscho parents: diff changeset	287
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	288 <dl>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	289 <dt>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	290 <b><code>item = parameter</code></b>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	291 </dt>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	292 <dd>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	293 Where <code>item</code> is a string that identifies the type of the GUI item,
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	294 <code>parameter</code> is a numeric or textual value (or a list of values
1982 b190d3e9427c init version pontscho parents: diff changeset	295 separated by commas).
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	296 </dd>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	297 </dl>
1982 b190d3e9427c init version pontscho parents: diff changeset	298
b190d3e9427c init version pontscho parents: diff changeset	299 <p>
b190d3e9427c init version pontscho parents: diff changeset	300 Putting the above together, the whole file looks something like this:
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	301 </p>
1982 b190d3e9427c init version pontscho parents: diff changeset	302
b190d3e9427c init version pontscho parents: diff changeset	303 <table border=1 width="100%"><tr bgcolor=silver><td><pre>
b190d3e9427c init version pontscho parents: diff changeset	304 section = movieplayer
b190d3e9427c init version pontscho parents: diff changeset	305 window = main
b190d3e9427c init version pontscho parents: diff changeset	306 ; ... items for main window ...
b190d3e9427c init version pontscho parents: diff changeset	307 end
b190d3e9427c init version pontscho parents: diff changeset	308
b190d3e9427c init version pontscho parents: diff changeset	309 window = sub
b190d3e9427c init version pontscho parents: diff changeset	310 ; ... items for subwindow ...
b190d3e9427c init version pontscho parents: diff changeset	311 end
b190d3e9427c init version pontscho parents: diff changeset	312
b190d3e9427c init version pontscho parents: diff changeset	313 window = menu
8316 6548f6a4216b sync gabucino parents: 7814 diff changeset	314 ; ... items for menu ...
1982 b190d3e9427c init version pontscho parents: diff changeset	315 end
9057 99a3ab65891d sync gabucino parents: 8432 diff changeset	316
99a3ab65891d sync gabucino parents: 8432 diff changeset	317 window = playbar
99a3ab65891d sync gabucino parents: 8432 diff changeset	318 ; ... items for playbar ...
99a3ab65891d sync gabucino parents: 8432 diff changeset	319 end
1982 b190d3e9427c init version pontscho parents: diff changeset	320 end
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	321 </pre></td></tr></table>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	322
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	323 <p>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	324 The name of an image file must be given without leading directories - images are
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	325 searched for in the <code>Skin</code> directory. You may (but you need not)
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 6882 diff changeset	326 specify the extension of the file. If the file does not exist, MPlayer
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	327 tries to load the file <code><filename>.<ext></code>, where
8316 6548f6a4216b sync gabucino parents: 7814 diff changeset	328 <code>png</code> and <code>PNG</code> are tried for <code><ext></code>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	329 (in this order). The first matching file will be used.
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	330 </p>
1982 b190d3e9427c init version pontscho parents: diff changeset	331
b190d3e9427c init version pontscho parents: diff changeset	332 <p>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	333 Finally some words about positioning. The main window and the subwindow can be
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	334 placed in the different corners of the screen by giving <code>X</code> and
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	335 <code>Y</code> coordinates. <code>0</code> is top or left, <code>-1</code> is
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	336 center and <code>-2</code> is right or bottom, as shown in this illustration:
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	337 </p>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	338
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	339 <pre>
1982 b190d3e9427c init version pontscho parents: diff changeset	340
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	341 (0, 0)----(-1, 0)----(-2, 0)
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	342 \| \| \|
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	343 \| \| \|
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	344 (0,-1)----(-1,-1)----(-2,-1)
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	345 \| \| \|
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	346 \| \| \|
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	347 (0,-2)----(-1,-2)----(-2,-2)
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	348
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	349 </pre>
1982 b190d3e9427c init version pontscho parents: diff changeset	350
b190d3e9427c init version pontscho parents: diff changeset	351 <table border=1 cellpadding=5 width="100%"><tr bgcolor="#ffffcc"><td>
b190d3e9427c init version pontscho parents: diff changeset	352 Here is an example to make this clear. Suppose that you have an image called
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	353 <code>main.png</code> that you use for the main window:
1982 b190d3e9427c init version pontscho parents: diff changeset	354 <blockquote>
b190d3e9427c init version pontscho parents: diff changeset	355 <pre>
b190d3e9427c init version pontscho parents: diff changeset	356 base = main, -1, -1
b190d3e9427c init version pontscho parents: diff changeset	357 </pre>
b190d3e9427c init version pontscho parents: diff changeset	358 </blockquote>
b190d3e9427c init version pontscho parents: diff changeset	359
8316 6548f6a4216b sync gabucino parents: 7814 diff changeset	360 MPlayer tries to load <code>main</code>, <code>main.png</code>,
6548f6a4216b sync gabucino parents: 7814 diff changeset	361 <code>main.PNG</code> files.
1982 b190d3e9427c init version pontscho parents: diff changeset	362 <br>
b190d3e9427c init version pontscho parents: diff changeset	363 </td></tr></table>
b190d3e9427c init version pontscho parents: diff changeset	364
b190d3e9427c init version pontscho parents: diff changeset	365
9057 99a3ab65891d sync gabucino parents: 8432 diff changeset	366 <h3><a name="mainwin">3.1 Main window and playbar</a></h3>
1982 b190d3e9427c init version pontscho parents: diff changeset	367
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	368 Below is the list of entries that can be used in the
9057 99a3ab65891d sync gabucino parents: 8432 diff changeset	369 '<code>window = main</code>' . . . '<code>end</code>', and the
99a3ab65891d sync gabucino parents: 8432 diff changeset	370 '<code>window = playbar</code>'  . . '<code>end</code>' blocks.
1982 b190d3e9427c init version pontscho parents: diff changeset	371
b190d3e9427c init version pontscho parents: diff changeset	372 <dl>
b190d3e9427c init version pontscho parents: diff changeset	373 <dt><a name="main.base">
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	374 <b><code>base = image, X, Y</code></b>
1982 b190d3e9427c init version pontscho parents: diff changeset	375 </a></dt>
b190d3e9427c init version pontscho parents: diff changeset	376 <dd>
b190d3e9427c init version pontscho parents: diff changeset	377 Lets you specify the background image to be used for the main window.
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	378 The window will appear at the given <code>X,Y</code> position on the screen
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	379 The window will have the size of the image.
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	380 <div>
1982 b190d3e9427c init version pontscho parents: diff changeset	381 <em class=warn>
9057 99a3ab65891d sync gabucino parents: 8432 diff changeset	382 <b>Note:</b> this coordinating doesn't work for the display window currently.
99a3ab65891d sync gabucino parents: 8432 diff changeset	383 </em>
99a3ab65891d sync gabucino parents: 8432 diff changeset	384 <br>
99a3ab65891d sync gabucino parents: 8432 diff changeset	385 <em class=warn>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	386 <b>Warning:</b> Transparent regions in the image (colored #FF00FF) appear
8316 6548f6a4216b sync gabucino parents: 7814 diff changeset	387 black on X servers without the XShape extension. The image's width must be
6548f6a4216b sync gabucino parents: 7814 diff changeset	388 dividable by 8.
1982 b190d3e9427c init version pontscho parents: diff changeset	389 </em>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	390 </div>
1982 b190d3e9427c init version pontscho parents: diff changeset	391 </dd>
b190d3e9427c init version pontscho parents: diff changeset	392
b190d3e9427c init version pontscho parents: diff changeset	393 <dt><a name="main.button">
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	394 <b><code>button = image, X, Y, width, height, message</code></b></a></dt>
1982 b190d3e9427c init version pontscho parents: diff changeset	395 <dd>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	396 Place a button of <code>width</code> * <code>height</code> size at position
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	397 <code>X</code>,<code>Y</code>. The specified <code>message</code> is generated
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	398 when the button is clicked. The image given by <code>image</code> must have
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	399 three parts below each other (according to the possible states of the button),
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	400 like this:
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	401 <pre>
1982 b190d3e9427c init version pontscho parents: diff changeset	402 +------------+
b190d3e9427c init version pontscho parents: diff changeset	403 \| pressed \|
b190d3e9427c init version pontscho parents: diff changeset	404 +------------+
b190d3e9427c init version pontscho parents: diff changeset	405 \| released \|
b190d3e9427c init version pontscho parents: diff changeset	406 +------------+
b190d3e9427c init version pontscho parents: diff changeset	407 \| disabled \|
b190d3e9427c init version pontscho parents: diff changeset	408 +------------+
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	409 </pre>
1982 b190d3e9427c init version pontscho parents: diff changeset	410 </dd>
b190d3e9427c init version pontscho parents: diff changeset	411
b190d3e9427c init version pontscho parents: diff changeset	412 <dt><a name="main.decoration">
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	413 <b><code>decoration = enable\|disable</code></b>
1982 b190d3e9427c init version pontscho parents: diff changeset	414 </a></dt>
b190d3e9427c init version pontscho parents: diff changeset	415 <dd>
b190d3e9427c init version pontscho parents: diff changeset	416 Enable or disable window manager decoration of the main window. Default
b190d3e9427c init version pontscho parents: diff changeset	417 is <b>disable</b>.
9057 99a3ab65891d sync gabucino parents: 8432 diff changeset	418 <br>
99a3ab65891d sync gabucino parents: 8432 diff changeset	419 <br>
99a3ab65891d sync gabucino parents: 8432 diff changeset	420 <em class=warn>
99a3ab65891d sync gabucino parents: 8432 diff changeset	421 <b>Note:</b> This doesn't work for the display window, there is no need to.
99a3ab65891d sync gabucino parents: 8432 diff changeset	422 </em>
99a3ab65891d sync gabucino parents: 8432 diff changeset	423 <br>
1982 b190d3e9427c init version pontscho parents: diff changeset	424 </dd>
b190d3e9427c init version pontscho parents: diff changeset	425
b190d3e9427c init version pontscho parents: diff changeset	426 <dt>
b190d3e9427c init version pontscho parents: diff changeset	427 <a name="main.hpotmeter">
b190d3e9427c init version pontscho parents: diff changeset	428 <b>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	429 <code>hpotmeter = button, bwidth, bheight, phases, numphases, default, X, Y, width, height, message</code>
9057 99a3ab65891d sync gabucino parents: 8432 diff changeset	430 <br>
99a3ab65891d sync gabucino parents: 8432 diff changeset	431 <code>vpotmeter = button, bwidth, bheight, phases, numphases, default, X, Y, width, height, message</code>
1982 b190d3e9427c init version pontscho parents: diff changeset	432 </b>
b190d3e9427c init version pontscho parents: diff changeset	433 </a>
b190d3e9427c init version pontscho parents: diff changeset	434 </dt>
b190d3e9427c init version pontscho parents: diff changeset	435 <dd>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	436 Place a horizontal potmeter of <code>width</code> * <code>height</code> size
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	437 at position <code>X</code>,<code>Y</code>. The image can be divided into
1982 b190d3e9427c init version pontscho parents: diff changeset	438 different parts for the different phases of the potmeter (for example,
b190d3e9427c init version pontscho parents: diff changeset	439 you can have a pot for volume control that turns from green to red
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	440 while its value changes from the minimum to the maximum.).
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	441 <code>hpotmeter</code> can have a button that can be dragged horizontally.
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	442
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	443 <div>The parameters are:</div>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	444
1982 b190d3e9427c init version pontscho parents: diff changeset	445 <ul>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	446 <li><code>button</code> - the image to be used for the button
1982 b190d3e9427c init version pontscho parents: diff changeset	447 (must have three parts below each other, like in case of
b190d3e9427c init version pontscho parents: diff changeset	448 <a href="#main.button">button</a>)</li>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	449 <li><code>bwidth</code>, <code>bheight</code> - size of the button</li>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	450 <li><code>phases</code> - The image to be used for the different phases of the
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	451 hpotmeter. A special value of <code>NULL</code> can be used if you want
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	452 no such image. The image must be divided into <code>numphases</code> parts
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	453 vertically like this:
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	454 <pre>
1982 b190d3e9427c init version pontscho parents: diff changeset	455 +------------+
b190d3e9427c init version pontscho parents: diff changeset	456 \| phase #1 \|
b190d3e9427c init version pontscho parents: diff changeset	457 +------------+
b190d3e9427c init version pontscho parents: diff changeset	458 \| phase #2 \|
b190d3e9427c init version pontscho parents: diff changeset	459 +------------+
b190d3e9427c init version pontscho parents: diff changeset	460 ...
b190d3e9427c init version pontscho parents: diff changeset	461 +------------+
b190d3e9427c init version pontscho parents: diff changeset	462 \| phase #n \|
b190d3e9427c init version pontscho parents: diff changeset	463 +------------+
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	464 </pre>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	465 </li>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	466 <li><code>numphases</code> - number of phases stored in the <code>phases</code>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	467 image</li>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	468 <li><code>default</code> - default value for hpotmeter (in the range 0 to
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	469 100)</li>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	470 <li><code>X</code>, <code>Y</code> - position for the hpotmeter</li>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	471 <li><code>width</code>, <code>height</code> - width and height of the
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	472 <code>hpotmeter</code></li>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	473 <li><code>message</code> - the message to be generated when the value of
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	474 <code>hpotmeter</code> is changed</li>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	475 </ul>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	476
1982 b190d3e9427c init version pontscho parents: diff changeset	477 </dd>
b190d3e9427c init version pontscho parents: diff changeset	478
b190d3e9427c init version pontscho parents: diff changeset	479 <dt><a name="main.potmeter">
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	480 <b><code>potmeter = phases, numphases, default, X, Y, width, height, message</code></b>
1982 b190d3e9427c init version pontscho parents: diff changeset	481 </a></dt>
b190d3e9427c init version pontscho parents: diff changeset	482 <dd>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	483 A <code>hpotmeter</code> without a button. (I guess it is meant to be turned
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	484 around, but it reacts to horizontal dragging only.)
1982 b190d3e9427c init version pontscho parents: diff changeset	485 For the description of the parameters see
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	486 <a href="#main.hpotmeter">hpotmeter</a>. <code>phases</code> can be
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	487 <code>NULL</code>, but it is quite useless, since you cannot see where
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	488 the <code>potmeter</code> is set.
1982 b190d3e9427c init version pontscho parents: diff changeset	489 </dd>
b190d3e9427c init version pontscho parents: diff changeset	490
b190d3e9427c init version pontscho parents: diff changeset	491 <dt><a name="main.font">
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	492 <b><code>font = fontfile, fontid</code></b>
1982 b190d3e9427c init version pontscho parents: diff changeset	493 </a></dt>
b190d3e9427c init version pontscho parents: diff changeset	494 <dd>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	495 Defines a font. <code>fontfile</code> is the name of a font description file
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	496 with a <code>.fnt</code> extension (<b>do not</b> specify the extension here).
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	497 <code>fontid</code> is used to refer to the font
1982 b190d3e9427c init version pontscho parents: diff changeset	498 (see <a href="#main.dlabel">dlabel</a> and <a href="#main.slabel">slabel</a>).
b190d3e9427c init version pontscho parents: diff changeset	499 Up to 25 fonts can be defined.
b190d3e9427c init version pontscho parents: diff changeset	500 </dd>
b190d3e9427c init version pontscho parents: diff changeset	501
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	502 <dt><a name="main.slabel">
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	503 <b><code>slabel = X, Y, fontid, "text"</code></b>
1982 b190d3e9427c init version pontscho parents: diff changeset	504 </a></dt>
b190d3e9427c init version pontscho parents: diff changeset	505 <dd>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	506 Place a static label at the position <code>X</code>,<code>Y</code>.
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	507 <code>text</code> is displayed using the font identified by <code>fontid</code>.
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	508 The text is just a raw string (<code>$x</code> variables do not work) that must
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	509 be enclosed between double quotes (but the <code>"</code> character cannot be
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	510 part of the text). The label is displayed using the font identified by
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	511 <code>fontid</code>.
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	512 </dd>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	513
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	514 <dt><a name="main.dlabel">
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	515 <b><code>dlabel = X, Y, length, align, fontid, "text"</code></b>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	516 </a></dt>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	517 <dd>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	518 Place a dynamic label at the position <code>X</code>,<code>Y</code>. The label is
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	519 called dynamic because its text is refreshed periodically. The maximum length of
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	520 the label is given by <code>length</code> (its height is the height of a
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	521 character). If the text to be displayed is wider than that, it will be scrolled,
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	522 otherwise it is aligned within the specified space by the value of the
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	523 <code>align</code> parameter: <code>0</code> is for right, <code>1</code> is for
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	524 center, <code>2</code> is for left.
1982 b190d3e9427c init version pontscho parents: diff changeset	525 <br>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	526 The text to be displayed is given by <code>text</code>: It must be written
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	527 between double quotes (but the <code>"</code> character cannot be part of the
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	528 text). The label is displayed using the font identified by <code>fontid</code>.
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	529 You can use the following variables in the text:
1982 b190d3e9427c init version pontscho parents: diff changeset	530
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	531 <table align="center" border="1">
1982 b190d3e9427c init version pontscho parents: diff changeset	532 <tr align=center><th>Variable</th><th align=left>Meaning</th></tr>
b190d3e9427c init version pontscho parents: diff changeset	533 <tr><td align=center><kbd>$1</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	534 <td>play time in <em>hh:mm:ss</em> format</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	535 <tr><td align=center><kbd>$2</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	536 <td>play time in <em>mmmm:ss</em> format</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	537 <tr><td align=center><kbd>$3</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	538 <td>play time in <em>hh</em> format (hours)</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	539 <tr><td align=center><kbd>$4</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	540 <td>play time in <em>mm</em> format (minutes)</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	541 <tr><td align=center><kbd>$5</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	542 <td>play time in <em>ss</em> format (seconds)</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	543 <tr><td align=center><kbd>$6</kbd></td>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	544 <td>movie length in <em>hh:mm:ss</em> format</td></tr>
1982 b190d3e9427c init version pontscho parents: diff changeset	545 <tr><td align=center><kbd>$7</kbd></td>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	546 <td>movie length in <em>mmmm:ss</em> format</td></tr>
1982 b190d3e9427c init version pontscho parents: diff changeset	547 <tr><td align=center><kbd>$8</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	548 <td>play time in <em>h:mm:ss</em> format</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	549 <tr><td align=center><kbd>$v</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	550 <td>volume in <em>xxx.xx%</em> format</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	551 <tr><td align=center><kbd>$V</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	552 <td>volume in <em>xxx.x</em> format</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	553 <tr><td align=center><kbd>$b</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	554 <td>balance in <em>xxx.xx%</em> format</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	555 <tr><td align=center><kbd>$B</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	556 <td>balance in <em>xxx.x</em> format</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	557 <tr><td align=center><kbd>$$</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	558 <td>the <kbd>$</kbd> character</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	559 <tr><td align=center><kbd>$a</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	560 <td>a character according to the audio type (none: <code>n</code>,
b190d3e9427c init version pontscho parents: diff changeset	561 mono: <code>m</code>, stereo: <code>t</code>)</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	562 <tr><td align=center><kbd>$t</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	563 <td>track number (in playlist)</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	564 <tr><td align=center><kbd>$o</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	565 <td>filename</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	566 <tr><td align=center><kbd>$f</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	567 <td>filename in lower case</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	568 <tr><td align=center><kbd>$F</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	569 <td>filename in upper case</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	570 <tr><td align=center><kbd>$T</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	571 <td>a character according to the stream type (file: <code>f</code>,
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	572 Video CD: <code>v</code>, DVD: <code>d</code>, URL: <code>u</code>)
1982 b190d3e9427c init version pontscho parents: diff changeset	573 </td></tr>
b190d3e9427c init version pontscho parents: diff changeset	574 <tr><td align=center><kbd>$p</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	575 <td>the "p" character (if a movie is playing and the font has the "p"
b190d3e9427c init version pontscho parents: diff changeset	576 character)
b190d3e9427c init version pontscho parents: diff changeset	577 </td></tr>
b190d3e9427c init version pontscho parents: diff changeset	578 <tr><td align=center><kbd>$s</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	579 <td>the "s" character (if the movie is stopped and the font has the "s"
b190d3e9427c init version pontscho parents: diff changeset	580 character)
b190d3e9427c init version pontscho parents: diff changeset	581 </td></tr>
b190d3e9427c init version pontscho parents: diff changeset	582 <tr><td align=center><kbd>$e</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	583 <td>the "e" character (if playback is paused and the font has the "e"
b190d3e9427c init version pontscho parents: diff changeset	584 character)
b190d3e9427c init version pontscho parents: diff changeset	585 </td></tr>
8316 6548f6a4216b sync gabucino parents: 7814 diff changeset	586 <tr><td align=center><kbd>$x</kbd></td>
6548f6a4216b sync gabucino parents: 7814 diff changeset	587 <td>movie width
6548f6a4216b sync gabucino parents: 7814 diff changeset	588 </td></tr>
6548f6a4216b sync gabucino parents: 7814 diff changeset	589 <tr><td align=center><kbd>$y</kbd></td>
6548f6a4216b sync gabucino parents: 7814 diff changeset	590 <td>movie height
6548f6a4216b sync gabucino parents: 7814 diff changeset	591 </td></tr>
6548f6a4216b sync gabucino parents: 7814 diff changeset	592 <tr><td align=center><kbd>$C</kbd></td>
8432 7b6b7fb76965 small updates diego parents: 8316 diff changeset	593 <td>name of the codec used
8316 6548f6a4216b sync gabucino parents: 7814 diff changeset	594 </td></tr>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	595 </table>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	596
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	597 <em class="note">
1982 b190d3e9427c init version pontscho parents: diff changeset	598 <b>Note:</b> The <kbd>$a</kbd>, <kbd>$T</kbd>, <kbd>$p</kbd>, <kbd>$s</kbd>
b190d3e9427c init version pontscho parents: diff changeset	599 and <kbd>$e</kbd> variables all return characters that should be displayed
b190d3e9427c init version pontscho parents: diff changeset	600 as special symbols (for example, "e" is for the pause symbol that usually
b190d3e9427c init version pontscho parents: diff changeset	601 looks something like <code>\|\|</code>). You should have a font for normal
b190d3e9427c init version pontscho parents: diff changeset	602 characters and a different font for symbols.
b190d3e9427c init version pontscho parents: diff changeset	603 See the section about <a href="#symbols">symbols</a> for more information.
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	604 </em>
1982 b190d3e9427c init version pontscho parents: diff changeset	605 </dd>
b190d3e9427c init version pontscho parents: diff changeset	606 </dl>
b190d3e9427c init version pontscho parents: diff changeset	607
b190d3e9427c init version pontscho parents: diff changeset	608
b190d3e9427c init version pontscho parents: diff changeset	609 <h3><a name="subwindow">3.2 Subwindow</a></h3>
b190d3e9427c init version pontscho parents: diff changeset	610
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	611 The following entries can be used in the
1982 b190d3e9427c init version pontscho parents: diff changeset	612 '<code>window = sub</code>' . . . '<code>end</code>' block.
b190d3e9427c init version pontscho parents: diff changeset	613
b190d3e9427c init version pontscho parents: diff changeset	614 <dl>
b190d3e9427c init version pontscho parents: diff changeset	615 <dt><a name="sub.base">
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	616 <b><code>base = image, X, Y, width, height</code></b>
1982 b190d3e9427c init version pontscho parents: diff changeset	617 </a></dt>
b190d3e9427c init version pontscho parents: diff changeset	618 <dd>
b190d3e9427c init version pontscho parents: diff changeset	619 The image to be displayed in the window.
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	620 The window will appear at the given <code>X</code>,<code>Y</code> position
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	621 on the screen (<code>0,0</code> is the top left corner). You can specify
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	622 <code>-1</code> for center and <code>-2</code> for right (<code>X</code>) and
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	623 bottom (<code>Y</code>). The window will be as large as the image.
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	624 <code>width</code> and <code>height</code> denote the size of the window; they
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	625 are optional (if they are missing, the window is the same size as the image).
1982 b190d3e9427c init version pontscho parents: diff changeset	626 </dd>
b190d3e9427c init version pontscho parents: diff changeset	627
b190d3e9427c init version pontscho parents: diff changeset	628 <dt><a name="sub.background">
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	629 <b><code>background = R, G, B</code></b>
1982 b190d3e9427c init version pontscho parents: diff changeset	630 </a></dt>
b190d3e9427c init version pontscho parents: diff changeset	631 <dd>
b190d3e9427c init version pontscho parents: diff changeset	632 Lets you set the background color. It is useful if the image is smaller than
b190d3e9427c init version pontscho parents: diff changeset	633 the window.
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	634 <code>R</code>, <code>G</code> and <code>B</code> specifies the red, green and blue
1982 b190d3e9427c init version pontscho parents: diff changeset	635 component of the color (each of them is a decimal number from 0 to 255).
b190d3e9427c init version pontscho parents: diff changeset	636 </dd>
b190d3e9427c init version pontscho parents: diff changeset	637 </dl>
b190d3e9427c init version pontscho parents: diff changeset	638
b190d3e9427c init version pontscho parents: diff changeset	639
b190d3e9427c init version pontscho parents: diff changeset	640 <h3><a name="skinmenu">3.3 Skin menu</a></h3>
b190d3e9427c init version pontscho parents: diff changeset	641
b190d3e9427c init version pontscho parents: diff changeset	642 As mentioned earlier, the menu is displayed using two images.
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	643 Normal menu entries are taken from the image specified by the <code>base</code>
1982 b190d3e9427c init version pontscho parents: diff changeset	644 item, while the currently selected entry is taken from the image specified
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	645 by the <code>selected</code> item. You must define the position and size of each
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	646 menu entry through the <code>menu</code> item.
1982 b190d3e9427c init version pontscho parents: diff changeset	647
b190d3e9427c init version pontscho parents: diff changeset	648 <p>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	649 These are the entries that can be used in the '<code>window = menu</code>'
1982 b190d3e9427c init version pontscho parents: diff changeset	650 . . . '<code>end</code>' block.
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	651 </p>
1982 b190d3e9427c init version pontscho parents: diff changeset	652
b190d3e9427c init version pontscho parents: diff changeset	653 <dl>
b190d3e9427c init version pontscho parents: diff changeset	654 <dt><a name="menu.base">
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	655 <b><code>base = image</code></b>
1982 b190d3e9427c init version pontscho parents: diff changeset	656 </a></dt>
b190d3e9427c init version pontscho parents: diff changeset	657 <dd>
b190d3e9427c init version pontscho parents: diff changeset	658 The image for normal menu entries.
b190d3e9427c init version pontscho parents: diff changeset	659 </dd>
b190d3e9427c init version pontscho parents: diff changeset	660
b190d3e9427c init version pontscho parents: diff changeset	661 <dt><a name="menu.selected">
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	662 <b><code>selected = image</code></b>
1982 b190d3e9427c init version pontscho parents: diff changeset	663 </a></dt>
b190d3e9427c init version pontscho parents: diff changeset	664 <dd>
b190d3e9427c init version pontscho parents: diff changeset	665 The image showing the menu with all entries selected.
b190d3e9427c init version pontscho parents: diff changeset	666 </dd>
b190d3e9427c init version pontscho parents: diff changeset	667
b190d3e9427c init version pontscho parents: diff changeset	668 <dt><a name="menu.menu">
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	669 <b><code>menu = X, Y, width, height, message</code></b>
1982 b190d3e9427c init version pontscho parents: diff changeset	670 </a></dt>
b190d3e9427c init version pontscho parents: diff changeset	671 <dd>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	672 Defines the <code>X,Y</code> position and the size of a menu entry in
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	673 the image. <code>message</code> is the message to be generated when
1982 b190d3e9427c init version pontscho parents: diff changeset	674 the mouse button is released over the entry.
b190d3e9427c init version pontscho parents: diff changeset	675 </dd>
b190d3e9427c init version pontscho parents: diff changeset	676 </dl>
b190d3e9427c init version pontscho parents: diff changeset	677
b190d3e9427c init version pontscho parents: diff changeset	678
b190d3e9427c init version pontscho parents: diff changeset	679 <h2><a name="fonts">4 Fonts</a></h2>
b190d3e9427c init version pontscho parents: diff changeset	680
b190d3e9427c init version pontscho parents: diff changeset	681 As mentioned in the section about the parts of a skin, a font is defined
b190d3e9427c init version pontscho parents: diff changeset	682 by an image and a description
b190d3e9427c init version pontscho parents: diff changeset	683 file. You can place the characters anywhere in the image, but make sure that
b190d3e9427c init version pontscho parents: diff changeset	684 their position and size is given in the description file exactly.
b190d3e9427c init version pontscho parents: diff changeset	685
b190d3e9427c init version pontscho parents: diff changeset	686 <p>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	687 The font description file (with <code>.fnt</code> extension) can have comment
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	688 lines starting with '<code>;</code>'. The file must have a line in the form
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	689 </p>
1982 b190d3e9427c init version pontscho parents: diff changeset	690
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	691 <dl>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	692 <dt><a name="font.image">
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	693 <b><code>image = image</code></b>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	694 </a></dt>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	695 <dd>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	696 Where <code>image</code> is the name of the image file to be used for
1982 b190d3e9427c init version pontscho parents: diff changeset	697 the font (you do not have to specify the extension).
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	698 </dd>
1982 b190d3e9427c init version pontscho parents: diff changeset	699
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	700 <dt><a name="font.char">
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	701 <b><code>"char" = X, Y, width, height</code></b>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	702 </a></dt>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	703 <dd>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	704 Here <code>X</code> and <code>Y</code> specify the position of the
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	705 <code>char</code> character in the image (<code>0,0</code> is the upper left
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	706 corner). <code>width</code> and <code>height</code> are the dimensions of the
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	707 character in pixels.
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	708 </dd>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	709 </dl>
1982 b190d3e9427c init version pontscho parents: diff changeset	710
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	711 This example defines the A, B, C characters using <code>font.png</code>.
1982 b190d3e9427c init version pontscho parents: diff changeset	712 <table width="100%" border=1><tr bgcolor=silver><td><pre>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	713 ; Can be "font" instead of "font.png".
1982 b190d3e9427c init version pontscho parents: diff changeset	714 image = font.png
b190d3e9427c init version pontscho parents: diff changeset	715
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	716 ; Three characters are enough for demonstration purposes :-)
1982 b190d3e9427c init version pontscho parents: diff changeset	717 "A" = 0,0, 7,13
b190d3e9427c init version pontscho parents: diff changeset	718 "B" = 7,0, 7,13
b190d3e9427c init version pontscho parents: diff changeset	719 "C" = 14,0, 7,13
b190d3e9427c init version pontscho parents: diff changeset	720 </pre></td></tr></table>
b190d3e9427c init version pontscho parents: diff changeset	721
b190d3e9427c init version pontscho parents: diff changeset	722
b190d3e9427c init version pontscho parents: diff changeset	723 <h3><a name="symbols">4.1 Symbols</a></h3>
b190d3e9427c init version pontscho parents: diff changeset	724
b190d3e9427c init version pontscho parents: diff changeset	725 Some characters have special meanings when returned by some of the variables
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	726 used in <a href="#main.dlabel">dlabel</a>. These characters are meant to be
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	727 shown as symbols so that things like a nice DVD logo can be displayed instead
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	728 of the character 'd' for a DVD stream.
1982 b190d3e9427c init version pontscho parents: diff changeset	729
b190d3e9427c init version pontscho parents: diff changeset	730 <p>
b190d3e9427c init version pontscho parents: diff changeset	731 The following table lists all the characters that can be used to display
b190d3e9427c init version pontscho parents: diff changeset	732 symbols (and thus require a different font).
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	733 </p>
1982 b190d3e9427c init version pontscho parents: diff changeset	734
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	735 <table align="center" border="1">
1982 b190d3e9427c init version pontscho parents: diff changeset	736 <tr><th align=center>Character</th><th align=left>Symbol</th></tr>
b190d3e9427c init version pontscho parents: diff changeset	737 <tr><td align=center><kbd>p</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	738 <td align=left>play</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	739 <tr><td align=center><kbd>s</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	740 <td align=left>stop</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	741 <tr><td align=center><kbd>e</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	742 <td align=left>pause</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	743 <tr><td align=center><kbd>n</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	744 <td align=left>no sound</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	745 <tr><td align=center><kbd>m</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	746 <td align=left>mono sound</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	747 <tr><td align=center><kbd>t</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	748 <td align=left>stereo sound</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	749 <tr><td align=center><kbd>f</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	750 <td align=left>stream is a file</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	751 <tr><td align=center><kbd>v</kbd></td>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	752 <td align=left>stream is a Video CD</td></tr>
1982 b190d3e9427c init version pontscho parents: diff changeset	753 <tr><td align=center><kbd>d</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	754 <td align=left>stream is a DVD</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	755 <tr><td align=center><kbd>u</kbd></td>
b190d3e9427c init version pontscho parents: diff changeset	756 <td align=left>stream is a URL</td></tr>
b190d3e9427c init version pontscho parents: diff changeset	757 </table>
b190d3e9427c init version pontscho parents: diff changeset	758
b190d3e9427c init version pontscho parents: diff changeset	759
b190d3e9427c init version pontscho parents: diff changeset	760 <h2><a name="guimsg">Appendix A: GUI messages</a></h2>
b190d3e9427c init version pontscho parents: diff changeset	761
b190d3e9427c init version pontscho parents: diff changeset	762 These are the messages that can be generated by buttons, potmeters and
b190d3e9427c init version pontscho parents: diff changeset	763 menu entries.
b190d3e9427c init version pontscho parents: diff changeset	764
b190d3e9427c init version pontscho parents: diff changeset	765 <p>
b190d3e9427c init version pontscho parents: diff changeset	766 <em class=note>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	767 <b>Note:</b> Some of the messages might not work as expected (or not work at
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	768 all). As you know, the GUI is under development.</em>
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	769 </p>
1982 b190d3e9427c init version pontscho parents: diff changeset	770
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	771
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	772 <h3>Playback control:</h3>
1982 b190d3e9427c init version pontscho parents: diff changeset	773 <blockquote>
b190d3e9427c init version pontscho parents: diff changeset	774 <dl>
b190d3e9427c init version pontscho parents: diff changeset	775 <dt><b>evNext</b>
b190d3e9427c init version pontscho parents: diff changeset	776 <dd>Jump to next track in the playlist.
b190d3e9427c init version pontscho parents: diff changeset	777
b190d3e9427c init version pontscho parents: diff changeset	778 <dt><b>evPause</b>
b190d3e9427c init version pontscho parents: diff changeset	779 <dd>Pause playing.
b190d3e9427c init version pontscho parents: diff changeset	780
b190d3e9427c init version pontscho parents: diff changeset	781 <dt><b>evPauseSwitchToPlay</b>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	782 <dd>Forms a switch together with <code>evPlaySwitchToPause</code>. They can be
1982 b190d3e9427c init version pontscho parents: diff changeset	783 used to have a common play/pause button. Both messages should be assigned
b190d3e9427c init version pontscho parents: diff changeset	784 to buttons displayed at the very same position in the window. This
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	785 message pauses playing and the image for the <code>evPlaySwitchToPause</code> button
1982 b190d3e9427c init version pontscho parents: diff changeset	786 is displayed (to indicate that the button can be pressed to continue playing).
b190d3e9427c init version pontscho parents: diff changeset	787
b190d3e9427c init version pontscho parents: diff changeset	788 <dt><b>evPlay</b>
b190d3e9427c init version pontscho parents: diff changeset	789 <dd>Start playing.
b190d3e9427c init version pontscho parents: diff changeset	790
b190d3e9427c init version pontscho parents: diff changeset	791 <dt><b>evPlaySwitchToPause</b>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	792 <dd>The opposite of <code>evPauseSwitchToPlay</code>. This message starts playing
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	793 and the image for the <code>evPauseSwitchToPlay</code> button is displayed (to
1982 b190d3e9427c init version pontscho parents: diff changeset	794 indicate that the button can be pressed to pause playing).
b190d3e9427c init version pontscho parents: diff changeset	795
b190d3e9427c init version pontscho parents: diff changeset	796 <dt><b>evPrev</b>
b190d3e9427c init version pontscho parents: diff changeset	797 <dd>Jump to previous track in the playlist.
b190d3e9427c init version pontscho parents: diff changeset	798
b190d3e9427c init version pontscho parents: diff changeset	799 <dt><b>evStop</b>
b190d3e9427c init version pontscho parents: diff changeset	800 <dd>Stop playing.
b190d3e9427c init version pontscho parents: diff changeset	801 </dl>
b190d3e9427c init version pontscho parents: diff changeset	802 </blockquote>
b190d3e9427c init version pontscho parents: diff changeset	803
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	804
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	805 <h3>Seeking:</h3>
1982 b190d3e9427c init version pontscho parents: diff changeset	806 <blockquote>
b190d3e9427c init version pontscho parents: diff changeset	807 <dl>
b190d3e9427c init version pontscho parents: diff changeset	808 <dt><b>evBackward10sec</b>
b190d3e9427c init version pontscho parents: diff changeset	809 <dt><b>evBackward1min</b>
b190d3e9427c init version pontscho parents: diff changeset	810 <dt><b>evBackward10min</b>
b190d3e9427c init version pontscho parents: diff changeset	811 <dd>Seek backward 10 seconds / 1 minute / 10 minutes.
b190d3e9427c init version pontscho parents: diff changeset	812
b190d3e9427c init version pontscho parents: diff changeset	813 <dt><b>evForward10sec</b>
b190d3e9427c init version pontscho parents: diff changeset	814 <dt><b>evForward1min</b>
b190d3e9427c init version pontscho parents: diff changeset	815 <dt><b>evForward10min</b>
b190d3e9427c init version pontscho parents: diff changeset	816 <dd>Seek forward 10 seconds / 1 minute / 10 minutes.
b190d3e9427c init version pontscho parents: diff changeset	817
b190d3e9427c init version pontscho parents: diff changeset	818 <dt><b>evSetMoviePosition</b>
b190d3e9427c init version pontscho parents: diff changeset	819 <dd>Seek to position (can be used by a potmeter; the relative
b190d3e9427c init version pontscho parents: diff changeset	820 value (0-100%) of the potmeter is used).
b190d3e9427c init version pontscho parents: diff changeset	821 </dl>
b190d3e9427c init version pontscho parents: diff changeset	822 </blockquote>
b190d3e9427c init version pontscho parents: diff changeset	823
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	824
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	825 <h3>Video control:</h3>
1982 b190d3e9427c init version pontscho parents: diff changeset	826 <blockquote>
b190d3e9427c init version pontscho parents: diff changeset	827 <dl>
b190d3e9427c init version pontscho parents: diff changeset	828 <dt><b>evDoubleSize</b>
b190d3e9427c init version pontscho parents: diff changeset	829 <dd>Set the movie window to double size.
b190d3e9427c init version pontscho parents: diff changeset	830
b190d3e9427c init version pontscho parents: diff changeset	831 <dt><b>evFullScreen</b>
b190d3e9427c init version pontscho parents: diff changeset	832 <dd>Switch fullscreen mode on/off.
b190d3e9427c init version pontscho parents: diff changeset	833
b190d3e9427c init version pontscho parents: diff changeset	834 <dt><b>evNormalSize</b>
b190d3e9427c init version pontscho parents: diff changeset	835 <dd>Set the movie window to its normal size.
b190d3e9427c init version pontscho parents: diff changeset	836 </dl>
b190d3e9427c init version pontscho parents: diff changeset	837 </blockquote>
b190d3e9427c init version pontscho parents: diff changeset	838
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	839
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	840 <h3>Audio control:</h3>
1982 b190d3e9427c init version pontscho parents: diff changeset	841 <blockquote>
b190d3e9427c init version pontscho parents: diff changeset	842 <dl>
b190d3e9427c init version pontscho parents: diff changeset	843 <dt><b>evDecAudioBufDelay</b>
b190d3e9427c init version pontscho parents: diff changeset	844 <dd>Decrease audio buffer delay.
b190d3e9427c init version pontscho parents: diff changeset	845
b190d3e9427c init version pontscho parents: diff changeset	846 <dt><b>evDecBalance</b>
b190d3e9427c init version pontscho parents: diff changeset	847 <dd>Decrease balance.
b190d3e9427c init version pontscho parents: diff changeset	848
b190d3e9427c init version pontscho parents: diff changeset	849 <dt><b>evDecVolume</b>
b190d3e9427c init version pontscho parents: diff changeset	850 <dd>Decrease volume.
b190d3e9427c init version pontscho parents: diff changeset	851
b190d3e9427c init version pontscho parents: diff changeset	852 <dt><b>evIncAudioBufDelay</b>
b190d3e9427c init version pontscho parents: diff changeset	853 <dd>Increase audio buffer delay.
b190d3e9427c init version pontscho parents: diff changeset	854
b190d3e9427c init version pontscho parents: diff changeset	855 <dt><b>evIncBalance</b>
b190d3e9427c init version pontscho parents: diff changeset	856 <dd>Increase balance.
b190d3e9427c init version pontscho parents: diff changeset	857
b190d3e9427c init version pontscho parents: diff changeset	858 <dt><b>evIncVolume</b>
b190d3e9427c init version pontscho parents: diff changeset	859 <dd>Increase volume.
b190d3e9427c init version pontscho parents: diff changeset	860
b190d3e9427c init version pontscho parents: diff changeset	861 <dt><b>evMute</b>
b190d3e9427c init version pontscho parents: diff changeset	862 <dd>Mute/unmute the sound.
b190d3e9427c init version pontscho parents: diff changeset	863
b190d3e9427c init version pontscho parents: diff changeset	864 <dt><b>evSetBalance</b>
b190d3e9427c init version pontscho parents: diff changeset	865 <dd>Set balance (can be used by a potmeter; the relative
b190d3e9427c init version pontscho parents: diff changeset	866 value (0-100%) of the potmeter is used).
b190d3e9427c init version pontscho parents: diff changeset	867
b190d3e9427c init version pontscho parents: diff changeset	868 <dt><b>evSetVolume</b>
b190d3e9427c init version pontscho parents: diff changeset	869 <dd>Set volume (can be used by a potmeter; the relative
b190d3e9427c init version pontscho parents: diff changeset	870 value (0-100%) of the potmeter is used).
b190d3e9427c init version pontscho parents: diff changeset	871 </dl>
b190d3e9427c init version pontscho parents: diff changeset	872 </blockquote>
b190d3e9427c init version pontscho parents: diff changeset	873
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	874
b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	875 <h3>Miscellaneous:</h3>
1982 b190d3e9427c init version pontscho parents: diff changeset	876 <blockquote>
b190d3e9427c init version pontscho parents: diff changeset	877 <dl>
b190d3e9427c init version pontscho parents: diff changeset	878 <dt><b>evAbout</b>
b190d3e9427c init version pontscho parents: diff changeset	879 <dd>Open the about window.
b190d3e9427c init version pontscho parents: diff changeset	880
8316 6548f6a4216b sync gabucino parents: 7814 diff changeset	881 <dt><b>evDropSubtitle</b>
6548f6a4216b sync gabucino parents: 7814 diff changeset	882 <dd>Disables the currently used subtitle.
6548f6a4216b sync gabucino parents: 7814 diff changeset	883
6726 672baf93b96a This event now has correct spelling. diego parents: 6557 diff changeset	884 <dt><b>evEqualizer</b>
1982 b190d3e9427c init version pontscho parents: diff changeset	885 <dd>Turn the equalizer on/off.
b190d3e9427c init version pontscho parents: diff changeset	886
b190d3e9427c init version pontscho parents: diff changeset	887 <dt><b>evExit</b>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	888 <dd>Quit the program.
1982 b190d3e9427c init version pontscho parents: diff changeset	889
b190d3e9427c init version pontscho parents: diff changeset	890 <dt><b>evIconify</b>
b190d3e9427c init version pontscho parents: diff changeset	891 <dd>Iconify the window.
b190d3e9427c init version pontscho parents: diff changeset	892
b190d3e9427c init version pontscho parents: diff changeset	893 <dt><b>evLoad</b>
b190d3e9427c init version pontscho parents: diff changeset	894 <dd>Load a file (by opening a file browser window, where you can choose a
b190d3e9427c init version pontscho parents: diff changeset	895 file).
b190d3e9427c init version pontscho parents: diff changeset	896
b190d3e9427c init version pontscho parents: diff changeset	897 <dt><b>evLoadPlay</b>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	898 <dd>Does the same as <code>evLoad</code>, but it automatically starts
1982 b190d3e9427c init version pontscho parents: diff changeset	899 playing after the file is loaded.
b190d3e9427c init version pontscho parents: diff changeset	900
8316 6548f6a4216b sync gabucino parents: 7814 diff changeset	901 <dt><b>evLoadSubtitle</b>
6548f6a4216b sync gabucino parents: 7814 diff changeset	902 <dd>Loads a subtitle file (with the fileselector)
6548f6a4216b sync gabucino parents: 7814 diff changeset	903
6548f6a4216b sync gabucino parents: 7814 diff changeset	904 <dt><b>evLoadAudioFile</b>
6548f6a4216b sync gabucino parents: 7814 diff changeset	905 <dd>Loads an audio file (with the fileselector)
6548f6a4216b sync gabucino parents: 7814 diff changeset	906
1982 b190d3e9427c init version pontscho parents: diff changeset	907 <dt><b>evNone</b>
6271 b85d324d4503 Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diego parents: 1982 diff changeset	908 <dd>Empty message, it has no effect (except maybe in CVS versions :-)).
1982 b190d3e9427c init version pontscho parents: diff changeset	909
b190d3e9427c init version pontscho parents: diff changeset	910 <dt><b>evPlayList</b>
b190d3e9427c init version pontscho parents: diff changeset	911 <dd>Open/close the playlist window.
b190d3e9427c init version pontscho parents: diff changeset	912
8316 6548f6a4216b sync gabucino parents: 7814 diff changeset	913 <dt><b>evPlayDVD</b>
8432 7b6b7fb76965 small updates diego parents: 8316 diff changeset	914 <dd>Tries to open the disc in the given DVD-ROM drive.
8316 6548f6a4216b sync gabucino parents: 7814 diff changeset	915
6548f6a4216b sync gabucino parents: 7814 diff changeset	916 <dt><b>evPlayVCD</b>
8432 7b6b7fb76965 small updates diego parents: 8316 diff changeset	917 <dd>Tries to open the disc in the given CD-ROM drive.
8316 6548f6a4216b sync gabucino parents: 7814 diff changeset	918
1982 b190d3e9427c init version pontscho parents: diff changeset	919 <dt><b>evPreferences</b>
b190d3e9427c init version pontscho parents: diff changeset	920 <dd>Open the preferences window.
b190d3e9427c init version pontscho parents: diff changeset	921
8316 6548f6a4216b sync gabucino parents: 7814 diff changeset	922 <dt><b>evSetAspect</b>
6548f6a4216b sync gabucino parents: 7814 diff changeset	923 <dd>Sets displayed image aspect.
6548f6a4216b sync gabucino parents: 7814 diff changeset	924
6548f6a4216b sync gabucino parents: 7814 diff changeset	925 <dt><b>evSetURL</b>
6548f6a4216b sync gabucino parents: 7814 diff changeset	926 <dd>Displays the URL dialog window.
6548f6a4216b sync gabucino parents: 7814 diff changeset	927
1982 b190d3e9427c init version pontscho parents: diff changeset	928 <dt><b>evSkinBrowser</b>
b190d3e9427c init version pontscho parents: diff changeset	929 <dd>Open the skin browser window.
b190d3e9427c init version pontscho parents: diff changeset	930 </dl>
b190d3e9427c init version pontscho parents: diff changeset	931 </blockquote>
b190d3e9427c init version pontscho parents: diff changeset	932
b190d3e9427c init version pontscho parents: diff changeset	933 </body>
b190d3e9427c init version pontscho parents: diff changeset	934 </html>

Mercurial > mplayer.hg

annotate DOCS/skin.html @ 9057:99a3ab65891d