mplayer.hg: DOCS/skin.html annotate

annotate DOCS/skin.html @ 6271:b85d324d4503

Grammar, spellchecking and HTML fixups as usual, as well as an explanatory diagram. Review by Nilmoni Deb.

author	diego
date	Sun, 02 Jun 2002 19:03:03 +0000
parents	b190d3e9427c
children	9b218a01b74b

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

Mercurial > mplayer.hg

annotate DOCS/skin.html @ 6271:b85d324d4503