mirror of
https://github.com/mpv-player/mpv
synced 2024-12-13 18:36:09 +00:00
65d1d8d948
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@7598 b3059339-0415-0410-9bf9-f77b7e298cf2
769 lines
21 KiB
HTML
769 lines
21 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<html>
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=gb_2312-80">
|
||
<title>制作Skin -- MPlayer -- Linux的电影播放器</title>
|
||
<link rel="stylesheet" type="text/css" href="default.css">
|
||
<style type="text/css">
|
||
em.note {color: green;
|
||
font-style: normal;}
|
||
em.warn {color: red;
|
||
font-style: normal;}
|
||
</style>
|
||
</head>
|
||
|
||
<body>
|
||
|
||
<h1 align="center">MPlayer的Skin的格式</h1>
|
||
|
||
<hr>
|
||
|
||
<h2>内容</h2>
|
||
|
||
<ul type=disc>
|
||
<li><a href="#intro">1 介绍</a></li>
|
||
<li><a href="#overview">2 综述</a>
|
||
<ul type=circle>
|
||
<li><a href="#dirs">2.1 目录</a></li>
|
||
<li><a href="#images">2.2 图象</a></li>
|
||
<li><a href="#components">2.3 Skin的组成部分</a></li>
|
||
<li><a href="#files">2.4 文件</a></li>
|
||
</ul>
|
||
</li>
|
||
<li><a href="#skin">3 <code>skin</code>文件</a>
|
||
<ul type=circle>
|
||
<li><a href="#mainwin">3.1 主窗口</a></li>
|
||
<li><a href="#subwindow">3.2 副窗口</a></li>
|
||
<li><a href="#skinmenu">3.3 Skin菜单</a></li>
|
||
</ul>
|
||
</li>
|
||
<li><a href="#fonts">4 字体</a>
|
||
<ul type=circle>
|
||
<li><a href="#symbols">4.1 符号</a></li>
|
||
</ul>
|
||
</li>
|
||
<li><a href="#guimsg">附录A：GUI消息</a></li>
|
||
</ul>
|
||
|
||
<hr>
|
||
|
||
<div align=center>
|
||
最后修改： 2002/05/24</div>
|
||
|
||
<hr>
|
||
|
||
<h2><a name="intro">1 介绍</a></h2>
|
||
|
||
本文件的目的是描述<b>MPlayer</b>的skin的格式。这里所包含的信息可能不对，因为
|
||
|
||
<ol type="a">
|
||
<li>GUI不是我写的</li>
|
||
<li>GUI还没有完成</li>
|
||
<li>我可能搞错了</li>
|
||
</ol>
|
||
|
||
因此如果某个功能与它在这里被描述的工作方式不一样，不用大惊小怪。
|
||
|
||
<p>
|
||
谢谢<em>Zolt醤 Ponekker</em>的帮助。
|
||
</p>
|
||
|
||
<p>
|
||
<em>Andr醩 Mohari <mayday@freemail.hu></em>
|
||
</p>
|
||
|
||
|
||
<h2><a name="overview">2 综述</a></h2>
|
||
|
||
这虽然与skin的格式扯不上什么关系，但是你应该了解<b>MPlayer</b>有<b>没有</b>内建的皮肤，
|
||
因此<b>为了能够使用GUI必须安装至少一种皮肤。</b>
|
||
|
||
<h3><a name="dirs">2.1 目录</a></h3>
|
||
|
||
skin的搜索目录(按顺序)是：
|
||
<pre>
|
||
$(DATADIR)/Skin/
|
||
$(PREFIX)/share/mplayer/Skin/
|
||
~/.mplayer/Skin/
|
||
</pre>
|
||
|
||
<p>
|
||
注意，第一个路径倚赖于<b>MPlayer</b>的安装配置(见<code>configure</code>脚本
|
||
的<code>--prefix</code>和<code>--datadir</code>的参数)。
|
||
</p>
|
||
|
||
所有的skin被安装到上面列出的一个目录下的自己的目录中，例如：
|
||
<pre>
|
||
$(PREFIX)/share/mplayer/Skin/default/
|
||
</pre>
|
||
|
||
|
||
<h3><a name="images">2.2 图象格式</a></h3>
|
||
|
||
图象必须是真彩的(24或者32bpp)可以是BMP，PNG或者非压缩TGA格式。最理想的格式是PNG因为它的压缩得很好。
|
||
|
||
<p>
|
||
在主窗口(见下面)中你能使用包含“透明色”的图象：用颜色#FF00FF(<font color="#FF00FF">深红</font>)
|
||
填充的区域在<b>MPlayer</b>看来是完全透明的。这意味着你甚至能改变窗口外形如果你的X服务器有XShape扩展。
|
||
</p>
|
||
|
||
|
||
<h3><a name="components">2.3 皮肤组成部分</a></h3>
|
||
|
||
Skin的格式是十分自由的(不是像Winamp/XMMS的那种固定格式的皮肤)，所以能不能做出些东西取决于你。
|
||
|
||
<p>
|
||
目前有三个要被修饰的窗口：<a href="#mainwin">主窗口</a>，<a href="#subwindow">副窗口</a>和
|
||
<a href="#skinmenu">Skin菜单</a>(右键单击弹出)。
|
||
</p>
|
||
|
||
<ul>
|
||
<li>
|
||
<b>主窗口</b>是你控制<b>MPlayer</b>的地方。窗口的背景是图象。各种项目可以(而且必须)被放置在这里：
|
||
<em>按钮</em>，<em>滑动条</em>和<em>标签</em>。对于每一个项目，你都必须指定其位置和大小。
|
||
|
||
<p>
|
||
一个<b>按钮</b>有三种状态(按下，释放，禁止)，所以按钮图象必须垂直地划分成三部分。
|
||
细节参见<a href="#main.button">按钮</a>项目。
|
||
</p>
|
||
|
||
<p>
|
||
<b>滑动条</b>(主要用于搜寻条和音量/平衡控制)可以有任意多的状态只要你把图像分成上下排列的足够多份。
|
||
细节参见<a href="#main.hpotmeter">hpotmeter</a>和<a href="#main.potmeter">potmeter</a>。
|
||
</p>
|
||
|
||
<p>
|
||
<b>标签</b>有一点特殊：字符需要从图象文件中绘制，而图象中的字符用<a href="#fonts">字体描述文件</a>
|
||
描述。后者一个纯文本文件规定图像中每一字符的x，y坐标和大小(图象文件和他的字体描述文件<em>共同</em>
|
||
组成一个字体)。细节参见<a href="#main.dlabel">dlabel</a>和<a href="#main.slabel">slabel</a>。
|
||
</p>
|
||
|
||
<p>
|
||
<em class=note>
|
||
<b>注意：</b>所有图象都能像<a href="#images">图象格式</a>一节中说明的使用透明色。
|
||
</em>
|
||
</p>
|
||
</li>
|
||
|
||
<li>
|
||
<b>subwindow</b>是电影显示的地方。如果没有载入电影它将显示一个指定的图象(空的窗口太无聊了:-))
|
||
<em class=note><b>注意：</b>在这里<b>不允许</b>使用透明色。</em>
|
||
</li>
|
||
|
||
<li>
|
||
<b>skin菜单</b>仅仅是提供一个通过菜单控制<b>MPlayer</b>的方法。菜单需要两个图象：一个是基础图象
|
||
用来显示菜单的正常状态，另一个用来显示被选择的项目。当菜单弹出时，显示第一个图象。如果你把鼠标在
|
||
菜单条目上移动，当前选择的项目从第二个图象中复制并覆盖到当前鼠标指针下面的菜单项目上。
|
||
(第二个图象从来不作为整体来显示)。
|
||
<p>
|
||
一个菜单选项用图象中的位置和大小定义(细节参见<a href="#skinmenu">skin菜单</a>)。
|
||
</p>
|
||
</li>
|
||
</ul>
|
||
|
||
<p>
|
||
还有一件重要的事情没有提到：为了使按钮，滑动条和菜单项工作，<b>MPlayer</b>必须知道如果他们被点击
|
||
的话应该做什么。这是利用<a href="#guimsg">消息</a>(事件)机制完成的。对于这些项目，你必须定义当
|
||
他们被点击时将会产生的消息。
|
||
</p>
|
||
|
||
<h3><a name="files">2.4 文件</a></h3>
|
||
|
||
你需要制作下列的文件构成一个skin：
|
||
<ul>
|
||
<li>
|
||
一个配置文件称为<a href="#skin">skin</a>，告诉<b>MPlayer</b>如何将skin的不同部分放在一起，
|
||
以及如果你在窗口中某处点击的话应该做什么。
|
||
</li>
|
||
<li>主窗口的背景图象。</li>
|
||
<li>主窗口上代表物件的图像(包括一个或更多字体描述文件用来显示标签)。</li>
|
||
<li>在副窗口中显示的图象(可选)。</li>
|
||
<li>skin菜单的两个图象(仅当你想要创建菜单时才需要他们)。</li>
|
||
</ul>
|
||
|
||
除了skin的配置文件之外，你能给其它文件起随便什么名字(但字体描述文件必须以<code>.fnt</code>为扩展名)。
|
||
|
||
|
||
<h2><a name="skin">3 <code>skin</code>文件</a></h2>
|
||
|
||
<p>
|
||
如上所述，这是skin的配置文件。
|
||
它是基于行的；注释行必须以'<code>;</code>'开头(只有空格和tab可以放在'<code>;</code>'之前)。
|
||
</p>
|
||
|
||
<p>
|
||
文件由section组成。每一段描述一个程序的skin，使用下列的形式：
|
||
</p>
|
||
|
||
<table border=1 width="100%"><tr bgcolor=silver><td><pre>
|
||
section = <i>section name</i>
|
||
.
|
||
.
|
||
.
|
||
end
|
||
</pre></td></tr></table>
|
||
|
||
<p>
|
||
目前只有一个程序，所以你只需要一个section：
|
||
它的名称是<b>movieplayer</b>。
|
||
</p>
|
||
|
||
<p>
|
||
这个段中每个窗口用下列形式的块描述：
|
||
</p>
|
||
|
||
<table border=1 width="100%"><tr bgcolor=silver><td><pre>
|
||
window = <i>window name</i>
|
||
.
|
||
.
|
||
.
|
||
end
|
||
</pre></td></tr></table>
|
||
|
||
<p>
|
||
其中<i>window name</i>可以是下面各字串中的一项：
|
||
</p>
|
||
|
||
<ul>
|
||
<li><b>main</b> -- 对于主窗口</li>
|
||
<li><b>sub</b> -- 对于副窗口</li>
|
||
<li><b>menu</b> -- 对于skin菜单</li>
|
||
</ul>
|
||
|
||
<p>
|
||
(副窗口和skin菜单块是可选的 -- 你不一定要建立菜单或者修饰副窗口 )。
|
||
</p>
|
||
|
||
<p>
|
||
在一个窗口的描述块内，你能用下列形式的一行定义窗口中的每一项目：
|
||
</p>
|
||
|
||
<dl>
|
||
<dt>
|
||
<b><code>item = parameter</code></b>
|
||
</dt>
|
||
<dd>
|
||
其中<code>item</code>是定义GUI项目的类型的字串，<code>parameter</code>是一个数字或者文字值
|
||
(或者一组用逗号分开的值的列表)。
|
||
</dd>
|
||
</dl>
|
||
|
||
<p>
|
||
把上述的放在一起，整个文件看起来就有点像这样：
|
||
</p>
|
||
|
||
<table border=1 width="100%"><tr bgcolor=silver><td><pre>
|
||
section = movieplayer
|
||
window = main
|
||
; ... items for main window ...
|
||
end
|
||
|
||
window = sub
|
||
; ... items for subwindow ...
|
||
end
|
||
|
||
window = menu
|
||
; ... items for skin menu ...
|
||
end
|
||
end
|
||
</pre></td></tr></table>
|
||
|
||
<p>
|
||
图象文件的名称必须不带目录名 -- 图象在<code>Skin</code>目录中被搜索。你能(但是并不需要)规定扩展名。
|
||
如果文件不存在，<b>MPlayer</b>将试图装载<code><filename>.<ext></code>文件，
|
||
<code><ext></code>可以是<code>tga</code>，<code>TGA</code>，<code>bmp</code>，<code>BMP</code>，
|
||
<code>png</code>或者<code>PNG</code>(按这个顺序尝试)。第一个匹配文件将被使用。
|
||
</p>
|
||
|
||
<p>
|
||
最后是一些用来定位的语句。主窗口和副窗口可以放置在屏幕的不同的角落，通过给定<code>X</code>和<code>Y</code>坐标。
|
||
<code>0</code>代表顶端或左端，<code>-1</code>代表中心然后<code>-2</code>代表右边或底部：
|
||
</p>
|
||
|
||
<pre>
|
||
|
||
(0, 0)----(-1, 0)----(-2, 0)
|
||
| | |
|
||
| | |
|
||
(0,-1)----(-1,-1)----(-2,-1)
|
||
| | |
|
||
| | |
|
||
(0,-2)----(-1,-2)----(-2,-2)
|
||
|
||
</pre>
|
||
|
||
<table border=1 cellpadding=5 width="100%"><tr bgcolor="#ffffcc"><td>
|
||
这里有个例子可以把这个搞清楚。假设你有个叫<code>main.png</code>的图像用来做主窗口：
|
||
<blockquote>
|
||
<pre>
|
||
base = main, -1, -1
|
||
</pre>
|
||
</blockquote>
|
||
|
||
<b>MPlayer</b>将尝试加载<code>main</code>，<code>main.tga</code>，<code>main.TGA</code>，
|
||
<code>main.bmp</code>等等，所以将找到<code>main.png</code>。
|
||
<br>
|
||
如果你(碰巧)写了
|
||
<blockquote>
|
||
<pre>
|
||
base = main.bmp, -1, -1
|
||
</pre>
|
||
</blockquote>
|
||
那么<code>main.bmp</code>，<code>main.bmp.tga</code>，<code>main.bmp.TGA</code>，
|
||
<code>main.bmp.bmp</code>将被搜索而且<b>MPlayer</b>将最终放弃搜索，因为当前目录中只有
|
||
<code>main.png</code>没有<code>main.bmp</code>。
|
||
</td></tr></table>
|
||
|
||
|
||
<h3><a name="mainwin">3.1 主窗口</a></h3>
|
||
|
||
下面是所有能用于'<code>window = main</code>' . . . '<code>end</code>'块中的项目的列表。
|
||
|
||
<dl>
|
||
<dt><a name="main.base">
|
||
<b><code>base = image, X, Y</code></b>
|
||
</a></dt>
|
||
<dd>
|
||
指定用于主窗口的背景图象。窗口将显示在屏幕上的<code>X，Y</code>位置，窗口的大小与图像相同。
|
||
<div>
|
||
<em class=warn>
|
||
<b>警告：</b>图象中的透明区域(彩色的#FF00FF )在没有XShape扩展的X服务器上是黑色的。
|
||
</em>
|
||
</div>
|
||
</dd>
|
||
|
||
<dt><a name="main.button">
|
||
<b><code>button = image, X, Y, width, height, message</code></b></a></dt>
|
||
<dd>
|
||
将一个大小为<code>width</code>*<code>height</code>的按钮放置在<code>X</code>，<code>Y</code>的位置。
|
||
指定的<code>message</code>将在按钮被点击时产生。被<code>image</code>制定的图象必须有从上到下三个部分
|
||
(根据按钮的可能状态)，像这样：
|
||
<pre>
|
||
+------------+
|
||
| pressed |
|
||
+------------+
|
||
| released |
|
||
+------------+
|
||
| disabled |
|
||
+------------+
|
||
</pre>
|
||
</dd>
|
||
|
||
<dt><a name="main.decoration">
|
||
<b><code>decoration = enable|disable</code></b>
|
||
</a></dt>
|
||
<dd>
|
||
允许或禁止window manager修饰主窗口。缺省设定是<b>禁止</b>。
|
||
</dd>
|
||
|
||
<dt>
|
||
<a name="main.hpotmeter">
|
||
<b>
|
||
<code>hpotmeter = button, bwidth, bheight, phases, numphases, default, X, Y, width, height, message</code>
|
||
</b>
|
||
</a>
|
||
</dt>
|
||
<dd>
|
||
在<code>X</code>，<code>Y</code>位置放置一个大小为<code>width</code>*<code>height</code>的水平滑动条。
|
||
所用的图象可以划分成不同的部分用来显示滑动条的不同状态(例如，你能做一个音量滑动条，当音量从最小变到最大时，
|
||
滑动条的颜色从绿色变成红色。)。<code>hpotmeter</code>可以有一个能被水平拖曳的按钮。
|
||
|
||
<div>参数是：</div>
|
||
|
||
<ul>
|
||
<li><code>button</code> -- 用于按钮的图像(必须有从上到下三部分，跟<a href="#main.button">button</a>中一样)</li>
|
||
<li><code>bwidth</code>，<code>bheight</code> -- 按钮的大小</li>
|
||
<li><code>phases</code> -- 用于hpotmeter的不同的状态的图象。如果你想不要这样的图象可以使用一个特殊的值<code>NULL</code>。
|
||
图象必须像这样被垂直划分成<code>numphases</code>个部分：
|
||
<pre>
|
||
+------------+
|
||
| phase #1 |
|
||
+------------+
|
||
| phase #2 |
|
||
+------------+
|
||
...
|
||
+------------+
|
||
| phase #n |
|
||
+------------+
|
||
</pre>
|
||
</li>
|
||
<li><code>numphases</code> -- <code>phase</code>图象中储存的状态的数量</li>
|
||
<li><code>default</code> -- hpotmeter的缺省值(范围0到100)</li>
|
||
<li><code>X</code>，<code>Y</code> -- hpotmeter的位置</li>
|
||
<li><code>width</code>，<code>height</code> -- <code>hpotmeter</code>的宽度和高度</li>
|
||
<li><code>message</code> -- 当<code>hpotmeter</code>的值改变时产生的消息</li>
|
||
</ul>
|
||
|
||
<em class=note><b>注意：</b>将来也会有一个<code>vpotmeter</code>项目，但是它目前还没有被实现。
|
||
</em>
|
||
</dd>
|
||
|
||
<dt><a name="main.potmeter">
|
||
<b><code>potmeter = phases, numphases, default, X, Y, width, height, message</code></b>
|
||
</a></dt>
|
||
<dd>
|
||
没有按钮的<code>hpotmeter</code>。(我猜它是用来旋转，但它只对水平拖拽作出反应)。
|
||
描述参数参见<a href="#main.hpotmeter">hpotmeter</a>。<code>phases</code>能设为<code>NULL</code>，
|
||
但这实在没什么用处，因为那样你就看不到<code>potmeter</code>在哪里了。
|
||
</dd>
|
||
|
||
<dt><a name="main.font">
|
||
<b><code>font = fontfile, fontid</code></b>
|
||
</a></dt>
|
||
<dd>
|
||
定义一个字体。<code>fontfile</code>是以<code>.fnt</code>为扩展名的字体描述文件的名字(<b>不要</b>加上扩展名)。
|
||
<code>fontid</code>用来代表这种字体(见<a href="#main.dlabel">dlabel</a>和<a href="#main.slabel">slabel</a>)。
|
||
可以定义25个字体。
|
||
</dd>
|
||
|
||
<dt><a name="main.slabel">
|
||
<b><code>slabel = X, Y, fontid, "text"</code></b>
|
||
</a></dt>
|
||
<dd>
|
||
在<code>X</code>，<code>Y</code>位置放置一个静态的标签。<code>text</code>将用<code>fontid</code>代表的字体显示。
|
||
text只能是无格式文本(<code>$x</code>之类的变量不起作用)而且必须封在一对双引号中(但是<code>"</code>字符不能是text的一部分)。
|
||
标签使用由<code>fontid</code>代表的字体显示。
|
||
</dd>
|
||
|
||
<dt><a name="main.dlabel">
|
||
<b><code>dlabel = X, Y, length, align, fontid, "text"</code></b>
|
||
</a></dt>
|
||
<dd>
|
||
在<code>X</code>，<code>Y</code>位置放置一个动态的标签。标签被称为动态的，因为它的text周期性地刷新。标签的最大限度长度由
|
||
<code>leghth</code>给定(它的高度是字符的高度)。如果将要显示的text比给定的宽度宽，它将滚动显示，否则它将在指定的空间之内按
|
||
<code>align</code>参数的值对齐显示：<code>0</code>表示靠右对齐，<code>1</code>表示居中对齐，<code>2 </code>表示靠左对齐。
|
||
<br>
|
||
要显示的文本由<code>text</code>给定：text必须封在一对双引号中(但是<code>"</code>字符不能是text的一部分)。标签使用由
|
||
<code>fontid</code>代表的字体显示。你能在文本中使用下列变量：
|
||
|
||
<table align="center" border="1">
|
||
<tr align=center><th>Variable</th><th align=left>Meaning</th></tr>
|
||
<tr><td align=center><kbd>$1</kbd></td>
|
||
<td><em>hh:mm:ss</em>格式的播放时间</td></tr>
|
||
<tr><td align=center><kbd>$2</kbd></td>
|
||
<td><em>mmmm:ss</em>格式的播放时间</td></tr>
|
||
<tr><td align=center><kbd>$3</kbd></td>
|
||
<td><em>hh</em>(小时)格式的播放时间</td></tr>
|
||
<tr><td align=center><kbd>$4</kbd></td>
|
||
<td><em>mm</em>(分)格式的播放时间</td></tr>
|
||
<tr><td align=center><kbd>$5</kbd></td>
|
||
<td><em>ss</em>(秒)格式的播放时间</td></tr>
|
||
<tr><td align=center><kbd>$6</kbd></td>
|
||
<td><em>hh:mm:ss</em>格式的电影长度</td></tr>
|
||
<tr><td align=center><kbd>$7</kbd></td>
|
||
<td><em>mmmm:ss</em>格式的电影长度</td></tr>
|
||
<tr><td align=center><kbd>$8</kbd></td>
|
||
<td><em>h:mm:ss</em>格式的电影长度</td></tr>
|
||
<tr><td align=center><kbd>$v</kbd></td>
|
||
<td><em>xxx.xx%</em>格式的音量</td></tr>
|
||
<tr><td align=center><kbd>$V</kbd></td>
|
||
<td><em>xxx.x</em>格式的音量</td></tr>
|
||
<tr><td align=center><kbd>$b</kbd></td>
|
||
<td><em>xxx.xx%</em>格式的声道平衡</td></tr>
|
||
<tr><td align=center><kbd>$B</kbd></td>
|
||
<td><em>xxx.x</em>格式的声道平衡</td></tr>
|
||
<tr><td align=center><kbd>$$</kbd></td>
|
||
<td><kbd>$</kbd>字符</td></tr>
|
||
<tr><td align=center><kbd>$a</kbd></td>
|
||
<td>一个代表音频格式的字母(none: <code>n</code>，mono: <code>m</code>，stereo: <code>t</code>)</td></tr>
|
||
<tr><td align=center><kbd>$t</kbd></td>
|
||
<td>track号(在播放列表中)</td></tr>
|
||
<tr><td align=center><kbd>$o</kbd></td>
|
||
<td>文件名</td></tr>
|
||
<tr><td align=center><kbd>$f </kbd></td>
|
||
<td>小写格式文件名</td></tr>
|
||
<tr><td align=center><kbd>$F </kbd></td>
|
||
<td>大写格式文件名</td></tr>
|
||
<tr><td align=center><kbd>$T</kbd></td>
|
||
<td>一个代表媒体流类型的字幕(文件: <code>f</code>，Video CD: <code>v</code>，DVD: <code>d</code>，URL: <code>u</code>)</td></tr>
|
||
<tr><td align=center><kbd>$p</kbd></td>
|
||
<td>"p"字符(如果电影正在播放并且字体中有"p"这个字符)</td></tr>
|
||
<tr><td align=center><kbd>$s </kbd></td>
|
||
<td>"s"字符(如果电影停止播放并且字体中有"s"这个字符)</td></tr>
|
||
<tr><td align=center><kbd>$e</kbd></td>
|
||
<td>"e"字符(如果playback被暂停并且字体中有"e"这个字符)</td></tr>
|
||
</table>
|
||
|
||
<em class="note">
|
||
<b>注意：</b><kbd>$a</kbd>，<kbd>$T</kbd>，<kbd>$p</kbd>，<kbd>$s</kbd>和<kbd>$e</kbd>变量都返回应该被显示作为特殊的符号
|
||
(例如，"e"通常代表像<code>||</code>这样的暂停符号)的字符。你应该有一个正常字符的字体以及另一个用于符号的不同的字体。
|
||
更多信息参见<a href="#symbols">符号</a>部分。
|
||
</em>
|
||
</dd>
|
||
</dl>
|
||
|
||
|
||
<h3><a name="subwindow">3.2 副窗口</a></h3>
|
||
|
||
下列的项目能用于'<code>window = sub</code>' . . . '<code>end</code>'块。
|
||
|
||
<dl>
|
||
<dt><a name="sub.base">
|
||
<b><code>base = image, X, Y, width, height</code></b>
|
||
</a></dt>
|
||
<dd>
|
||
在副窗口中将要显示的图象。窗口将在屏幕给定的<code>X</code>，<code>Y</code>位置出现(<code>0,0 </code>是左上角)。
|
||
你能用<code>-1</code>指定中心<code>-2</code>指定右边(<code>X</code>)和底部(<code>Y</code>)。窗口将和图象一样大。
|
||
<code>width</code>和<code>height</code>指定窗口的大小； 他们是可选的(如果没有他们，窗口是与图象同样的大小)。
|
||
</dd>
|
||
|
||
<dt><a name="sub.background">
|
||
<b><code>background = R, G, B</code></b>
|
||
</a></dt>
|
||
<dd>
|
||
让你设置背景颜色。它在图象小于窗口时有用。
|
||
<code>R</code>，<code>G</code>和<code>B</code>规定颜色的的红，绿和蓝色的组成部分(它们中每一个都是从0到255的十进制数字)。
|
||
</dd>
|
||
</dl>
|
||
|
||
|
||
<h3><a name="skinmenu">3.3 skin菜单</a></h3>
|
||
|
||
如前所述，菜单用两个图象显示。
|
||
正常的菜单条目从<code>base</code>项指定的图象中获得，当前选择的条目则从<code>selected</code>项指定的图象中获得。
|
||
你必须通过<code>menu</code>项定义每个菜单条目的位置和大小。
|
||
|
||
<p>
|
||
这些是能用于'<code>window = menu</code>'. . . '<code>end</code>'之间的项目。
|
||
</p>
|
||
|
||
<dl>
|
||
<dt><a name="menu.base">
|
||
<b><code>base = image</code></b>
|
||
</a></dt>
|
||
<dd>
|
||
正常的菜单条目的图象。
|
||
</dd>
|
||
|
||
<dt><a name="menu.selected">
|
||
<b><code>selected = image</code></b>
|
||
</a></dt>
|
||
<dd>
|
||
所有条目都被选择的菜单的图象。
|
||
</dd>
|
||
|
||
<dt><a name="menu.menu">
|
||
<b><code>menu = X, Y, width, height, message</code></b>
|
||
</a></dt>
|
||
<dd>
|
||
定义图像中一个菜单条目的<code>X，Y</code>位置和大小。当鼠标在该条目上被释放时产生<code>message</code>消息。
|
||
</dd>
|
||
</dl>
|
||
|
||
|
||
<h2><a name="fonts">4 字体</a></h2>
|
||
|
||
就象在关于skin的各部分的一节中论及的，字体由一个图象和一个描述文件定义。你能将字符放置在图象中的任何地方，
|
||
但是必须确保他们的位置和大小被精确的提交给描述文件。
|
||
|
||
<p>
|
||
字体描述文件随着(以<code>.fnt</code>为扩展名)能有以'<code>;</code>'开始的注释行。文件必须有像这样的行</p>
|
||
|
||
<dl>
|
||
<dt><a name="font.image">
|
||
<b><code>image = image</code></b>
|
||
</a></dt>
|
||
<dd>
|
||
其中<code>image</code>是用于字体的图象文件的名字(你不必制定扩展名)。
|
||
</dd>
|
||
|
||
<dt><a name="font.char">
|
||
<b><code>"char" = X, Y, width, height</code></b>
|
||
</a></dt>
|
||
<dd>
|
||
这里<code>X</code>和<code>Y</code>指定<code>char</code>字符在图象中的位置(<code>0,0</code>表示左上角)。
|
||
<code>width</code>和<code>height</code>是字符的尺寸，以象素为单位。
|
||
</dd>
|
||
</dl>
|
||
|
||
这个例子中用<code>font.png</code>定义A，B，C三个字符。
|
||
<table width="100%" border=1><tr bgcolor=silver><td><pre>
|
||
; Can be "font" instead of "font.png".
|
||
image = font.png
|
||
|
||
; Three characters are enough for demonstration purposes :-)
|
||
"A" = 0,0, 7,13
|
||
"B" = 7,0, 7,13
|
||
"C" = 14,0, 7,13
|
||
</pre></td></tr></table>
|
||
|
||
|
||
<h3><a name="symbols">4.1 符号</a></h3>
|
||
|
||
<a href="#main.dlabel">dlabel</a>中使用的一些变量返回的一些字符有特殊的意义。这些字符应该被显示为符号，
|
||
使得播放DVD时显示一个漂亮的DVD logo而不是字符‘d’。
|
||
|
||
<p>
|
||
下列的表格列出所有能被用来显示符号的字符(所以要求另一种字体)。
|
||
</p>
|
||
|
||
<table align="center" border="1">
|
||
<tr><th align=center>字符</th><th align=left>符号</th></tr>
|
||
<tr><td align=center><kbd>p</kbd></td>
|
||
<td align=left>播放</td></tr>
|
||
<tr><td align=center><kbd>s</kbd></td>
|
||
<td align=left>停止</td></tr>
|
||
<tr><td align=center><kbd>e</kbd></td>
|
||
<td align=left>暂停</td></tr>
|
||
<tr><td align=center><kbd>n</kbd></td>
|
||
<td align=left>无声</td></tr>
|
||
<tr><td align=center><kbd>m</kbd></td>
|
||
<td align=left>单声道</td></tr>
|
||
<tr><td align=center><kbd>t</kbd></td>
|
||
<td align=left>立体声</td></tr>
|
||
<tr><td align=center><kbd>f</kbd></td>
|
||
<td align=left>媒体流是文件</td></tr>
|
||
<tr><td align=center><kbd>v</kbd></td>
|
||
<td align=left>媒体流是Video CD</td></tr>
|
||
<tr><td align=center><kbd>d</kbd></td>
|
||
<td align=left>媒体流是DVD</td></tr>
|
||
<tr><td align=center><kbd>u</kbd></td>
|
||
<td align=left>媒体流是URL</td></tr>
|
||
</table>
|
||
|
||
<p>
|
||
<em class="note"><b>注意：</b>当前只有'p', 's', 'e', 'n', 'm'和't'能被使用。
|
||
</em></p>
|
||
|
||
<h2><a name="guimsg">附录A： GUI信息</a></h2>
|
||
|
||
这些是能被按钮，滑动条和菜单项产生的消息。
|
||
|
||
<p>
|
||
<em class=note><b>注意：</b>一些信息可能不像所预想的那样工作(或者根本不工作)。你也知道，GUI还在开发中。</em></p>
|
||
|
||
|
||
<h3>Playback控制：</h3>
|
||
<blockquote>
|
||
<dl>
|
||
<dt><b>evNext</b>
|
||
<dd>跳到播放列表中下一个track。
|
||
|
||
<dt><b>evPause</b>
|
||
<dd>暂停播放。
|
||
|
||
<dt><b>evPauseSwitchToPlay</b>
|
||
<dd>与<code>evPlaySwitchToPause</code>一起形成开关。他们能用来实现普通的播放/暂停按钮。两条信息应该被分配到
|
||
窗口中同一位置的两个按钮上。这条信息暂停播放并使<code>evPlaySwitchToPause</code>按钮的图象显示出来(表明点击按钮能继续播放)。
|
||
|
||
<dt><b>evPlay</b>
|
||
<dd>开始播放。
|
||
|
||
<dt><b>evPlaySwitchToPause</b>
|
||
<dd>与<code>evPauseSwitchToPlay</code>对应的消息。这条信息开始播放并使<code>evPauseSwitchToPlay</code>
|
||
按钮的图象显示出来(表明点击按钮能暂停播放)。
|
||
|
||
<dt><b>evPrev</b>
|
||
<dd>跳到播放列表中上一个track。
|
||
|
||
<dt><b>evStop</b>
|
||
<dd>停止播放。
|
||
</dl>
|
||
</blockquote>
|
||
|
||
|
||
<h3>搜索：</h3>
|
||
<blockquote>
|
||
<dl>
|
||
<dt><b>evBackward10sec </b>
|
||
<dt><b>evBackward1min </b>
|
||
<dt><b>evBackward10min </b>
|
||
<dd>向后搜索10秒/1分钟/10分钟。
|
||
|
||
<dt><b>evForward10sec</b>
|
||
<dt><b>evForward1min</b>
|
||
<dt><b>evForward10min</b>
|
||
<dd>向前搜索10秒/1分钟/10分钟。
|
||
|
||
<dt><b>evSetMoviePosition </b>
|
||
<dd>搜索到制定位置(能被滑动条使用；使用与滑动条相关的值( 0-100% ))。
|
||
</dl>
|
||
</blockquote>
|
||
|
||
|
||
<h3>视频控制：</h3>
|
||
<blockquote>
|
||
<dl>
|
||
<dt><b>evDoubleSize化</b>
|
||
<dd>把电影窗口置为双倍大小。
|
||
|
||
<dt><b>evFullScreen </b>
|
||
<dd>切换全屏方式。
|
||
|
||
<dt><b>evNormalSize化</b>
|
||
<dd>把电影窗口置为正常大小。
|
||
</dl>
|
||
</blockquote>
|
||
|
||
|
||
<h3>音频控制：</h3>
|
||
<blockquote>
|
||
<dl>
|
||
<dt><b>evDecAudioBufDelay</b>
|
||
<dd>减少音频缓冲延迟。
|
||
|
||
<dt><b>evDecBalance</b>
|
||
<dd>减少声道平衡。
|
||
|
||
<dt><b>evDecVolume</b>
|
||
<dd>减少音量。
|
||
|
||
<dt><b>evIncAudioBufDelay</b>
|
||
<dd>增加音频缓冲延迟。
|
||
|
||
<dt><b>evIncBalance</b>
|
||
<dd>增加声道平衡。
|
||
|
||
<dt><b>evIncVolume</b>
|
||
<dd>增加音量。
|
||
|
||
<dt><b>evMute</b>
|
||
<dd>禁音/取消禁音。
|
||
|
||
<dt><b>evSetBalance</b>
|
||
<dd>设置声道平衡(能被滑动条使用；使用与滑动条相关的值( 0-100% ))。
|
||
|
||
<dt><b>evSetVolume</b>
|
||
<dd>设置音量(能被滑动条使用；使用与滑动条相关的值( 0-100% ))。
|
||
</dl>
|
||
</blockquote>
|
||
|
||
|
||
<h3>其他：</h3>
|
||
<blockquote>
|
||
<dl>
|
||
<dt><b>evAbout</b>
|
||
<dd>打开关于窗口。
|
||
|
||
<dt><b>evEqualizer</b>
|
||
<dd>打开/关闭均衡器。
|
||
|
||
<dt><b>evExit</b>
|
||
<dd>退出程序。
|
||
|
||
<dt><b>evIconify</b>
|
||
<dd>窗口图标化。
|
||
|
||
<dt><b>evLoad</b>
|
||
<dd>装载文件(打开一个文件浏览窗口，你能在其中选择文件)。
|
||
|
||
<dt><b>evLoadPlay</b>
|
||
<dd>功能与<code>evLoad</code>一样，但是它在文件之后装载自动地开始播放。
|
||
|
||
<dt><b>evNone</b>
|
||
<dd>空信息，它没有效果(也许CVS版本除外:-))。
|
||
|
||
<dt><b>evPlayList</b>
|
||
<dd>打开/关闭播放列表窗口。
|
||
|
||
<dt><b>evPreferences</b>
|
||
<dd>打开选项设置窗口。
|
||
|
||
<dt><b>evSkinBrowser</b>
|
||
<dd>打开skin浏览器窗口。
|
||
</dl>
|
||
</blockquote>
|
||
|
||
</body>
|
||
</html>
|