skin-file.html

MPlayer-mingw32-1.0rc2.zip 经典播放器源码

  different phases of the potmeter (for example, you can have a pot for volume
  control that turns from green to red while its value changes from the minimum
  to the maximum.). <code class="literal">hpotmeter</code> can have a button that can be
  dragged horizontally. The parameters are:
  </p><div class="itemizedlist"><ul type="disc"><li><p>
    <code class="literal">button</code> - the image to be used for the
    button (must have three parts below each other, like in case of
    <a class="link" href="skin-file.html#skin-button">button</a>)
  </p></li><li><p>
    <code class="literal">bwidth</code>, <code class="literal">bheight</code> - size
    of the button
  </p></li><li><p>
    <code class="literal">phases</code> - the image to be used for the
    different phases of the hpotmeter. A special value of <code class="literal">NULL</code>
    can be used if you want no such image. The image must be divided into
    <code class="literal">numphases</code> parts vertically like this:
    </p><div class="informalfigure"><pre class="screen">
+------------+
|  phase #1  |
+------------+
|  phase #2  |
+------------+
     ...
+------------+
|  phase #n  |
+------------+</pre></div><p>
  </p></li><li><p>
    <code class="literal">numphases</code> - number of phases stored in the
    <code class="literal">phases</code> image
  </p></li><li><p>
    <code class="literal">default</code> - default value for hpotmeter
    (in the range <code class="literal">0</code> to <code class="literal">100</code>)
  </p></li><li><p>
    <code class="literal">X</code>, <code class="literal">Y</code> - position for the hpotmeter
  </p></li><li><p>
    <code class="literal">width</code>, <code class="literal">height</code> - width and height
    of the <code class="literal">hpotmeter</code>
  </p></li><li><p>
    <code class="literal">message</code> - the message to be generated when the
    value of <code class="literal">hpotmeter</code> is changed
  </p></li></ul></div><p>
  </p></dd><dt><span class="term"><code class="literal">
  <a name="skin-potmeter"></a>potmeter = phases, numphases, default, X, Y, width, height, message
  </code></span></dt><dd><p>
  A <code class="literal">hpotmeter</code> without a button. (I guess it is meant to be
  turned around, but it reacts to horizontal dragging only.) For the description
  of the parameters see <a class="link" href="skin-file.html#skin-hpotmeter">hpotmeter</a>.
  <code class="literal">phases</code> can be <code class="literal">NULL</code>, but it is quite
  useless, since you cannot see where the <code class="literal">potmeter</code> is set.
  </p></dd><dt><span class="term"><code class="literal">
  <a name="skin-font"></a>font = fontfile, fontid
  </code></span></dt><dd><p>
  Defines a font. <code class="literal">fontfile</code> is the name of a font description
  file with a <tt class="filename">.fnt</tt> extension (do not specify the extension
  here).  <code class="literal">fontid</code> is used to refer to the font
  (see <a class="link" href="skin-file.html#skin-dlabel">dlabel</a>
  and <a class="link" href="skin-file.html#skin-slabel">slabel</a>). Up to 25 fonts can be defined.
  </p></dd><dt><span class="term"><code class="literal">
  <a name="skin-slabel"></a>slabel = X, Y, fontid, "text"
  </code></span></dt><dd><p>
  Place a static label at the position <code class="literal">X,Y</code>.
  <code class="literal">text</code> is displayed using the font identified by
  <code class="literal">fontid</code>. The text is just a raw string
  (<code class="literal">$x</code> variables do not work) that must be enclosed between
  double quotes (but the " character cannot be part of the text). The
  label is displayed using the font identified by <code class="literal">fontid</code>.
  </p></dd><dt><span class="term"><code class="literal">
  <a name="skin-dlabel"></a>dlabel = X, Y, length, align, fontid, "text"
  </code></span></dt><dd><p>
  Place a dynamic label at the position <code class="literal">X,Y</code>. The label is
  called dynamic because its text is refreshed periodically. The maximum length
  of the label is given by <code class="literal">length</code> (its height is the height
  of a character). If the text to be displayed is wider than that, it will be
  scrolled,
  otherwise it is aligned within the specified space by the value of the
  <code class="literal">align</code> parameter: <code class="literal">0</code> is for right,
  <code class="literal">1</code> is for center, <code class="literal">2</code> is for left.
  </p><p>
  The text to be displayed is given by <code class="literal">text</code>: It must be
  written between double quotes (but the " character cannot be part of the
  text). The label is displayed using the font identified by
  <code class="literal">fontid</code>. You can use the following variables in the text:
  </p><div class="informaltable"><table border="1"><colgroup><col><col></colgroup><thead><tr><th>Variable</th><th>Meaning</th></tr></thead><tbody><tr><td>$1</td><td>play time in <span class="emphasis"><em>hh:mm:ss</em></span> format</td></tr><tr><td>$2</td><td>play time in <span class="emphasis"><em>mmmm:ss</em></span> format</td></tr><tr><td>$3</td><td>play time in <span class="emphasis"><em>hh</em></span> format (hours)</td></tr><tr><td>$4</td><td>play time in <span class="emphasis"><em>mm</em></span> format (minutes)</td></tr><tr><td>$5</td><td>play time in <span class="emphasis"><em>ss</em></span> format (seconds)</td></tr><tr><td>$6</td><td>movie length in <span class="emphasis"><em>hh:mm:ss</em></span> format</td></tr><tr><td>$7</td><td>movie length in <span class="emphasis"><em>mmmm:ss</em></span> format</td></tr><tr><td>$8</td><td>play time in <span class="emphasis"><em>h:mm:ss</em></span> format</td></tr><tr><td>$v</td><td>volume in <span class="emphasis"><em>xxx.xx</em></span>% format</td></tr><tr><td>$V</td><td>volume in <span class="emphasis"><em>xxx.xx</em></span> format</td></tr><tr><td>$b</td><td>balance in <span class="emphasis"><em>xxx.xx</em></span>% format</td></tr><tr><td>$B</td><td>balance in <span class="emphasis"><em>xxx.xx</em></span> format</td></tr><tr><td>$$</td><td>the $ character</td></tr><tr><td>$a</td><td>a character according to the audio type (none: <code class="literal">n</code>,
	mono: <code class="literal">m</code>, stereo: <code class="literal">t</code>)</td></tr><tr><td>$t</td><td>track number (in playlist)</td></tr><tr><td>$o</td><td>filename</td></tr><tr><td>$f</td><td>filename in lower case</td></tr><tr><td>$F</td><td>filename in upper case</td></tr><tr><td>$T</td><td>
	a character according to the stream type (file: <code class="literal">f</code>,
	Video CD: <code class="literal">v</code>, DVD: <code class="literal">d</code>,
	URL: <code class="literal">u</code>)
	</td></tr><tr><td>$p</td><td>the <span class="keycap"><b>p</b></span> character (if a movie is playing and the font
    has the <span class="keycap"><b>p</b></span> character)</td></tr><tr><td>$s</td><td>the <span class="keycap"><b>s</b></span> character (if the movie is stopped and the
    font has the <span class="keycap"><b>s</b></span> character)</td></tr><tr><td>$e</td><td>the <span class="keycap"><b>e</b></span> character (if playback is paused and the font
    has the <span class="keycap"><b>e</b></span> character)</td></tr><tr><td>$x</td><td>movie width</td></tr><tr><td>$y</td><td>movie height</td></tr><tr><td>$C</td><td>name of the codec used</td></tr></tbody></table></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
  The <code class="literal">$a, $T, $p, $s</code> and <code class="literal">$e</code>
  variables all return characters that should be displayed as special symbols
  (for example, <span class="keycap"><b>e</b></span> is for the pause symbol that usually looks
  something like ||). You should have a font for normal characters and
  a different font for symbols. See the section about
  <a class="link" href="skin-fonts.html#skin-fonts-symbols" title="C.3.1.聽Symbols">symbols</a> for more information.
  </p></div></dd></dl></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="skin-file-subwindow"></a>C.2.2.聽Subwindow</h3></div></div></div><p>
The following entries can be used in the
'<code class="literal">window = sub</code>' . . . '<code class="literal">end</code>' block.
</p><div class="variablelist"><dl><dt><span class="term"><code class="literal">
  <a name="skin-sub-base"></a>base = image, X, Y, width, height
  </code></span></dt><dd><p>
  The image to be displayed in the window. The window will appear at the given
  <code class="literal">X,Y</code> position on the screen (<code class="literal">0,0</code> is the
  top left corner). You can specify <code class="literal">-1</code> for center and
  <code class="literal">-2</code> for right (<code class="literal">X</code>) and bottom
  (<code class="literal">Y</code>). The window will be as large as the image.
  <code class="literal">width</code> and <code class="literal">height</code>
  denote the size of the window; they are optional (if they are missing, the
  window is the same size as the image).
  </p></dd><dt><span class="term"><code class="literal">
  <a name="skin-background"></a>background = R, G, B
  </code></span></dt><dd><p>
  Lets you set the background color. It is useful if the image is smaller than
  the window. <code class="literal">R</code>, <code class="literal">G</code> and
  <code class="literal">B</code> specifies the red, green and blue component of the color
  (each of them is a decimal number from 0 to 255).
  </p></dd></dl></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="skin-file-menu"></a>C.2.3.聽Skin menu</h3></div></div></div><p>
As mentioned earlier, the menu is displayed using two images. Normal menu
entries are taken from the image specified by the <code class="literal">base</code> item,
while the currently selected entry is taken from the image specified by the
<code class="literal">selected</code> item. You must define the position and size of each
menu entry through the menu item.
</p><p>
The following entries can be used in the
'<code class="literal">window = menu</code>'. . .'<code class="literal">end</code>' block.
</p><div class="variablelist"><dl><dt><span class="term"><code class="literal">
  <a name="skin-menu-base"></a>base = image
  </code></span></dt><dd><p>
  The image for normal menu entries.
  </p></dd><dt><span class="term"><code class="literal">
  <a name="skin-selected"></a>selected = image
  </code></span></dt><dd><p>
  The image showing the menu with all entries selected.
  </p></dd><dt><span class="term"><code class="literal">
  <a name="skin-menu"></a>menu = X, Y, width, height, message
  </code></span></dt><dd><p>
  Defines the <code class="literal">X,Y</code> position and the size of a menu entry in
  the image. <code class="literal">message</code> is the message to be generated when the
  mouse button is released over the entry.
  </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="skin-overview.html">Prev</a>聽</td><td width="20%" align="center"><a accesskey="u" href="skin.html">Up</a></td><td width="40%" align="right">聽<a accesskey="n" href="skin-fonts.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">C.1.聽Overview聽</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">聽C.3.聽Fonts</td></tr></table></div></body></html>