1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=KOI8-R"><title>D.1. Overview</title><link rel="stylesheet" href="default.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="MPlayer - The Movie Player"><link rel="up" href="skin.html" title="���������� D. MPlayer skin format"><link rel="prev" href="skin.html" title="���������� D. MPlayer skin format"><link rel="next" href="skin-file.html" title="D.2. The skin file"><link rel="preface" href="howtoread.html" title="��� ������ ��� ������������"><link rel="chapter" href="intro.html" title="����� 1. ��������"><link rel="chapter" href="usage.html" title="����� 2. �������������"><link rel="chapter" href="cd-dvd.html" title="����� 3. ������������� CD/DVD"><link rel="chapter" href="faq.html" title="����� 4. Frequently Asked Questions"><link rel="chapter" href="features.html" title="����� 5. �����������"><link rel="chapter" href="video.html" title="����� 6. Video output devices"><link rel="chapter" href="audio.html" title="����� 7. Audio output devices"><link rel="chapter" href="ports.html" title="����� 8. �������"><link rel="chapter" href="mencoder.html" title="����� 9. Basic usage of MEncoder"><link rel="chapter" href="encoding-guide.html" title="����� 10. Encoding with MEncoder"><link rel="appendix" href="mailinglists.html" title="���������� A. �������� ��������"><link rel="appendix" href="bugreports.html" title="���������� B. ��� �������� �� �������"><link rel="appendix" href="bugs.html" title="���������� C. ��������� ��������"><link rel="appendix" href="skin.html" title="���������� D. MPlayer skin format"><link rel="appendix" href="users-vs-dev.html" title="���������� E. ���� �������������"><link rel="subsection" href="skin-overview.html#skin-overview-directories" title="D.1.1. Directories"><link rel="subsection" href="skin-overview.html#skin-overview-formats" title="D.1.2. Image formats"><link rel="subsection" href="skin-overview.html#skin-overview-components" title="D.1.3. Skin components"><link rel="subsection" href="skin-overview.html#skin-files" title="D.1.4. Files"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">D.1. Overview</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="skin.html">����.</a>�</td><th width="60%" align="center">���������� D. <span class="application">MPlayer</span> skin format</th><td width="20%" align="right">�<a accesskey="n" href="skin-file.html">����.</a></td></tr></table><hr></div><div class="sect1" lang="ru"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="skin-overview"></a>D.1. Overview</h2></div></div></div><p>
2
It does not really have anything to do with the skin format, but you should
3
know that <span class="application">MPlayer</span> has <span class="bold"><strong>no</strong></span>
4
builtin skin, so <span class="bold"><strong>at least one skin must be installed
5
in order to be able to use the GUI.</strong></span>
6
</p><div class="sect2" lang="ru"><div class="titlepage"><div><div><h3 class="title"><a name="skin-overview-directories"></a>D.1.1. Directories</h3></div></div></div><p>
7
The directories searched for skins are (in order):
8
</p><div class="orderedlist"><ol type="1"><li><p>
9
<tt class="filename">$(DATADIR)/Skin/</tt>
11
<tt class="filename">$(PREFIX)/share/mplayer/Skin/</tt>
13
<tt class="filename">~/.mplayer/Skin/</tt>
14
</p></li></ol></div><p>
16
Note that the first path may vary according to the way <span class="application">MPlayer</span>
17
was configured (see the <tt class="option">--prefix</tt> and <tt class="option">--datadir</tt>
18
arguments of the <span><strong class="command">configure</strong></span> script).
20
Every skin is installed into its own directory under one of the directories
21
listed above, for example:
22
</p><pre class="screen">$(PREFIX)/share/mplayer/Skin/default/</pre><p>
23
</p></div><div class="sect2" lang="ru"><div class="titlepage"><div><div><h3 class="title"><a name="skin-overview-formats"></a>D.1.2. Image formats</h3></div></div></div><p>Images must be truecolor (24 or 32 bpp) PNGs.</p><p>
24
In the main window and in the playbar (see below) you can use images with
25
`transparency': Regions filled with the color #FF00FF (magenta) are fully
26
transparent when viewed by <span class="application">MPlayer</span>. This means
27
that you can even have shaped windows if your X server has the XShape extension.
28
</p></div><div class="sect2" lang="ru"><div class="titlepage"><div><div><h3 class="title"><a name="skin-overview-components"></a>D.1.3. Skin components</h3></div></div></div><p>
29
Skins are quite free-format (unlike the fixed-format skins of
30
<span class="application">Winamp</span>/<span class="application">XMMS</span>,
31
for example), so it is up to you to create something great.
33
Currently there are four windows to be decorated: the
34
<a href="skin-file.html#skin-file-main" title="D.2.1. Main window and playbar">main window</a>, the
35
<a href="skin-file.html#skin-file-subwindow" title="D.2.2. Subwindow">subwindow</a>, the
36
<a href="skin-file.html#skin-file-main" title="D.2.1. Main window and playbar">playbar</a>, and the
37
<a href="skin-file.html#skin-file-menu" title="D.2.3. Skin menu">skin menu</a> (which can be activated
40
</p><div class="itemizedlist"><ul type="disc"><li><p>
41
The <span class="bold"><strong>main window</strong></span> and/or the
42
<span class="bold"><strong>playbar</strong></span> is where you can control
43
<span class="application">MPlayer</span>. The background of the window is an image.
44
Various items can (and must) be placed in the window: <span class="emphasis"><em>buttons</em></span>,
45
<span class="emphasis"><em>potmeters</em></span> (sliders) and <span class="emphasis"><em>labels</em></span>.
46
For every item, you must specify its position and size.
48
A <span class="bold"><strong>button</strong></span> has three states (pressed, released,
49
disabled), thus its image must be divided into three parts vertically. See the
50
<a href="skin-file.html#skin-button">button</a> item for details.
52
A <span class="bold"><strong>potmeter</strong></span> (mainly used for the seek bar and
53
volume/balance control) can have any number of phases by dividing its image
54
into different parts below each other. See
55
<a href="skin-file.html#skin-hpotmeter">hpotmeter</a> and
56
<a href="skin-file.html#skin-potmeter">potmeter</a> for details.
58
<span class="bold"><strong>Labels</strong></span> are a bit special: The characters
59
needed to draw them are taken from an image file, and the characters in the
60
image are described by a <a href="skin-fonts.html" title="D.3. Fonts">font description file</a>.
61
The latter is a plain text file which specifies the x,y position and size of
62
each character in the image (the image file and its font description file
63
form a font <span class="emphasis"><em>together</em></span>). See <a href="skin-file.html#skin-dlabel">dlabel</a>
64
and <a href="skin-file.html#skin-slabel">slabel</a> for details.
65
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">���������</h3><p>All images can have full transparency as described in the section about
66
<a href="skin-overview.html#skin-overview-formats" title="D.1.2. Image formats">image formats</a>. If the X server
67
doesn't support the XShape extension, the parts marked transparent will be
68
black. If you'd like to use this feature, the width of the main window's
69
background image must be dividable by 8.
70
</p></div></li><li><p>
71
The <span class="bold"><strong>subwindow</strong></span> is where the movie appears. It
72
can display a specified image if there is no movie loaded (it is quite boring
73
to have an empty window :-)) <span class="bold"><strong>Note:</strong></span> transparency
74
is <span class="bold"><strong>not allowed</strong></span> here.
76
The <span class="bold"><strong>skin menu</strong></span> is just a way to control
77
<span class="application">MPlayer</span> by means of menu entries. Two images
78
are required for the menu: one of them is the base image that shows the
79
menu in its normal state, the other one is used to display the selected
80
entries. When you pop up the menu, the first image is shown. If you move
81
the mouse over the menu entries, the currently selected entry is copied
82
from the second image over the menu entry below the mouse pointer
83
(the second image is never shown as a whole).
85
A menu entry is defined by its position and size in the image (see the
86
section about the <a href="skin-file.html#skin-file-menu" title="D.2.3. Skin menu">skin menu</a> for details).
87
</p></li></ul></div><p>
89
There is an important thing not mentioned yet: For buttons, potmeters and
90
menu entries to work, <span class="application">MPlayer</span> must know what to
91
do if they are clicked. This is done by <a href="skin-gui.html" title="D.4. GUI messages">messages</a>
92
(events). For these items you must define the messages to be generated when
94
</p></div><div class="sect2" lang="ru"><div class="titlepage"><div><div><h3 class="title"><a name="skin-files"></a>D.1.4. Files</h3></div></div></div><p>
95
You need the following files to build a skin:
96
</p><div class="itemizedlist"><ul type="disc"><li><p>
97
The configuration file named <a href="skin-file.html" title="D.2. The skin file">skin</a> tells
98
<span class="application">MPlayer</span> how to put different parts of the skin
99
together and what to do if you click somewhere in the window.
101
The background image for the main window.
103
Images for the items in the main window (including one or more font
104
description files needed to draw labels).
106
The image to be displayed in the subwindow (optional).
108
Two images for the skin menu (they are needed only if you want to create
110
</p></li></ul></div><p>
111
With the exception of the skin configuration file, you can name the other
112
files whatever you want (but note that font description files must have
113
a <tt class="filename">.fnt</tt> extension).
114
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="skin.html">����.</a>�</td><td width="20%" align="center"><a accesskey="u" href="skin.html">������� ����</a></td><td width="40%" align="right">�<a accesskey="n" href="skin-file.html">����.</a></td></tr><tr><td width="40%" align="left" valign="top">���������� D. <span class="application">MPlayer</span> skin format�</td><td width="20%" align="center"><a accesskey="h" href="index.html">������</a></td><td width="40%" align="right" valign="top">�D.2. The skin file</td></tr></table></div></body></html>