Формат скинов MPlayerОбзор
На самом деле с форматом скинов уже нет необходимости что-либо делать, но вам
следует знать, что MPlayerне имеет встроенного скина, так что
как минимум один скин должен быть установлен, для
возможности использовать GUI.Каталоги
Скины ищутся в следующих каталогах (по порядку):
$(DATADIR)/skins/$(PREFIX)/share/mplayer/skins/~/.mplayer/skins/
Имейте в виду, что первый путь может меняться в соответствии с конфигурацией
MPlayer (смотрите аргументы скрипта
configure и ).
Каждый скин устанавливается в его собственный подкаталог, в одном из указанных выше
каталогов, например:
$(PREFIX)/share/mplayer/skins/default/Форматы изображенийИзображениями должны быть truecolor (24 или 32 бит/пиксел) PNG.
В главном окне и полосе воспроизведения (смотрите ниже) можно использовать
изображения с 'прозрачностью': Области, заполненные цветом #FF00FF (magenta) полностью
прозрачны при просмотре программой MPlayer. Это значит, что
если ваш X сервер поддерживает расширение XShape, вы сможете получить даже
окна произвольной формы.
Компоненты скина
Скины имеют достаточно свободный формат (в отличие,например, от скинов
Winamp/XMMS,
имеющих формат фиксированный), так что зависит исключительно от вас, выйдет ли
у вас что-то грандиозное.
В данный момент могут быть оформлены четыре окна:
главное окно,
вспомогательное окно,
полоса воспроизведения, and the
меню со скинами (активирующееся правым щелчком
мыши).
Главное окно и/или
полоса воспроизведения - те, через которые вы
управляете MPlayer. Фон окна - это изображение.
Различные элементы могут (и должны) размещаться в окне:
кнопки, ползунки и
надписи.
Для каждого элемента должен быть задан размер и положение.
Кнопка имеет три состояния (нажата, отпущена,
отключена), таким образом, ее изображение должно быть разделено вертикально на три части.
Смотрите элемент кнопка для подробностей.
Ползунок (в основном используется для полосы перемещения
и управления громкостью/балансом) может иметь любое количество положений, задаваемых делением
его изображения на различные части одна под другой. Смотрите
hpotmeter и
potmeter для подробностей.
Надписи чуть особеннее: Символы, необходимые для их
отрисовки, берутся из графического файла, и задаются
файлом описания шрифта.
Последний - это текстовый файл, указывающий x,y положения и размер каждого символа
в файле с изображением (файл изображения и файл описания шрифта
вместе формируют шрифт). Смотрите
dlabel
и slabel для подробностей.
Все изображения могут быть полностью прозрачными, как описано в разделе,
посвященном форматам изображений. Если X
сервер не поддерживает расширение XShape, части, помеченные как прозрачные, будут черными.
Если вам нравится использовать эту возможность, ширина фона главного окна должна
делиться на 8.
Вспомогательное окно - это то, где появляется фильм.
Оно может отображать указанную картинку, если никакого фильма не загружено (пустое окно
немного надоедает :-)) Замечание: прозрачность здесь
не допускается.
Меню со скинами - всего лишь способ управлять
MPlayer в понятиях элементов меню. Для меню требуются
два изображения: одно из них - основное, показывает меню в обычном режиме,
другое используется для отображения выбранных элементов. Когда появляется меню,
отображается первое. Если вы перемещаете мышь над элементами меню,
выбранный элемент копируется из второго изображения поверх элемента меню под указателем мыши
(второе изображение никогда не отображается целиком).
Элемент меню определяется его позицией и размером изображения (смотрите раздел,
посвященный меню со скинами для подробностей).
Важная вещь, не упомянутая выше: Чтобы работали кнопки, ползунки и элементы меню,
MPlayer должен знать, что делать, если на них
щелкнули мышью. Это делается при помощи сообщений
(событий). Для этих элементов вы должны определить сообщения, генерируемые, когда
на них щелкают мышью.
Файлы
Вам нужны следующие файлы для создания скина:
Файл конфигурации, называющийся skin говорит
MPlayer как совместить разные части скина воедино,
и что делать, если производится щелчок где-нибудь в окне.
Фоновое изображение главного окна.
Изображения элементов главного окна (включая один или более файлов описания шрифтов,
необходимых для отрисовки надписей.
Изображение, показываемое во вспомогательном окне (необязательно).
Два изображения для меню со скинами (нужны, только если вы хотите создавать меню).
Все файлы, за исключением skin, могут быть названы так, как вам захочется
(но заметьте, что файлы описания шрифтов должны иметь расширение
a .fnt).
Файл skin
Как описано выше, это файл конфигурации скина. он строчно-орентирован:
строки комментариев начинаются с символа ';' в начале
строки (только пробелы и табуляция допускается перед символом ';').
Файл создается из разделов. Каждый описывает скин для приложения и
имеет следующую форму:
section = название раздела
.
.
.
end
В данный момент приложение одно, так что вам потребуется только один раздел: его название
movieplayer.
В пределах раздела каждое окно описывается блоком следующей структуры:
window = название окна
.
.
.
end
где название окна может быть одной из этих строк:
main - главное окно
sub - вспомогательное окно
menu - меню со скинами
playbar - полоса воспроизведения
(Блоки sub и menu опциональные - необязательно создавать меню или оформлять вспомогательное
окно.)
В пределах блока window вы можете описать каждый элемент окна строкой в следующем формате:
item = parameter
Где item - это строка, определяющая тип элемента GUI,
parameter - числовое или текстовое значение (или список значений, разделенных
запятой).
Если собрать все вместе, файл целиком будет выглядеть примерно так:
section = movieplayer
window = main
; ... items for main window ...
end
window = sub
; ... items for subwindow ...
end
window = menu
; ... items for menu ...
end
window = playbar
; ... items for playbar ...
end
end
Название файла с изображением должно указываться без лидирующих каталогов -
изображения ищутся в каталоге skins.
Вы можете (но не обязаны) указать расширение файла. Если файл не существует,
MPlayer пытается загрузить файл
<filename>.<ext>, где png
и PNG пробуются вместо <ext>
(в этом порядке). Будет использоваться первый найденный файл.
Вот пример, чтобы было понятнее. Предположим вы имеете изображение, называющееся
main.png, которое используете для главного окна:
base = main, -1, -1MPlayer пытается загрузить файлы main,
main.png, main.PNG.
И наконец несколько слов о позиционировании. Главное и вспомогательное окна могут
быть размещены в разных углах экрана указанием X и
Y координат. 0 - это верхний и левый край,
-1 - центр и -2 - правый или нижний, как
указано на иллюстрации:
(0, 0)----(-1, 0)----(-2, 0)
| | |
| | |
(0,-1)----(-1,-1)----(-2,-1)
| | |
| | |
(0,-2)----(-1,-2)----(-2,-2)
Главное окно и полоса воспроизведения
Ниже - список элементов, которые можно указывать в
'window = main' ... 'end',
и 'window = playbar' ... 'end'
блоках.
base = image, X, Y
Позволяет вам указать фоновое изображение, используемое в главном окне.
Окно будет появляться в указанной X,Y позиции на экране и
иметь размер изображения.
Эти координаты пока не работают для окна отображения.
Прозрачные регионы в изображении (цвет #FF00FF) станут черными
на X сервере без расширения XShape. Ширина картинки должна делиться
на 8.button = image, X, Y, width, height, message
Размещает кнопку размера width * height на
позиции X,Y. Указанное сообщение message
генерируется при щелчке на кнопку. Изображение image,
должно иметь три части одна ниже другой (в соответствии с возможными состояниями
кнопки), как здесь:
+------------+
| нажата |
+------------+
| отпущена |
+------------+
| отключена |
+------------+decoration = enable|disable
Включает или выключает декорации главного окна, осуществляемые window manager . По-умолчанию
disable.
Это не работает для окна отображения, в этом нет надобности.
hpotmeter = button, bwidth, bheight, phases, numphases, default, X, Y, width, height, message
vpotmeter = button, bwidth, bheight, phases, numphases, default, X, Y, width, height, message
Размещает горизонтальный (hpotmeter) или вертикальный (vpotmeter) ползунок размера
width * height на позиции
X,Y. Изображение может быть разделено на разные части для
указания различных положений ползунка (например, вы можете иметь регулятор для
управления громкостью звука, изменяющийся с красного на зеленый при изменении его
уровня с минимального на максимальный.). hpotmeter может иметь
кнопку, которую можно таскать горизонтально. Параметры:
button - изображение, используемое для
кнопки (должно иметь три части одна под другой, как в случае
кнопки)
bwidth, bheight - размер кнопки
phases - изображение, используемое для
различных положений hpotmeter. Специальное значение NULL
может использоваться, если подобное изображение вам не нужно. Изображение
должно быть разделено вертикально на
numphases частей, как указано ниже:
+--------------+
| положение #1 |
+--------------+
| положение #2 |
+--------------+
...
+--------------+
| положение #n |
+--------------+numphases - количество положений в изображении
phasesdefault - положение hpotmeter по-умолчанию
(в диапазоне от 0 до 100)
X, Y - позиция hpotmeter
width, height - ширина и высота
hpotmetermessage - сообщение, генерируемое при изменении значения
hpotmeterpotmeter = phases, numphases, default, X, Y, width, height, message
hpotmeter без кнопки.
(Я предполагаю, что это означает повернутый вокруг,
но он реагирует только на перетаскивание по горизонтали.) Для описания параметров смотрите
hpotmeter.
phases может быть равен NULL, но это совершенно
бесполезно, поскольку вы не сможете определить в каком положении
находится potmeter.
font = fontfile, fontid
Определяет шрифт. fontfile - это название файла описания шрифта
с расширением .fnt (не указывайте расширение здесь).
fontid используется для ссылки на шрифт
(смотрите dlabel и
slabel). Может быть определено до 25 шрифтов.
slabel = X, Y, fontid, "text"
Размещает статическую метку на позиции X,Y. text
отображается, используя шрифт, определенный по fontid.
Текст - просто обычная строка ($x переменные не работают), которая должна
быть заключена в двойные кавычки (но символ " не может быть частью текста).
Метка отображается, используя шрифт определенный по fontid.
dlabel = X, Y, length, align, fontid, "text"
Размещает динамическую метку на позиции X,Y. Метка зовется
динамической, потому что ее текст периодически обновляется. Максимальная длина
метки задается параметром length (ее высота равна высоте символа).
Если отображаемый текст шире этого значения, он будет скроллироваться,
иначе он выравнивается в пределах указанного пространства в соответствии со
значением параметра
align: 0 - вправо,
1 - по центру, 2 - влево.
Отображаемый текст задается параметром text: Он должен быть
заключен в двойные кавычки (но символ " не может быть частью текста).
Метка отображается, используя шрифт, определяемый по fontid.
Вы можете использовать следующие переменные в тексте:
ПеременнаяЗначение$1время воспроизведения в формате чч:мм:сс$2время воспроизведения в формате мммм:сс$3время воспроизведения формате чч(часы)$4время воспроизведения в формате мм(минуты)$5время воспроизведения в формате сс(секунды)$6длительность фильма в формате чч:мм:сс$7длительность фильма в формате мммм:сс$8время воспроизведения формате ч:мм:сс$vкромкость в формате xxx.xx%$Vкромкость в формате xxx.xx$bбаланс в формате xxx.xx%$Bбаланс в формате xxx.xx$$символ $$aсимвол ,соответствующий типу звука (нет: n,
моно: m, стерео: t)$tномер дорожки (в плейлисте)$oимя файла$fимя файла в нижнем регистре$Fимя файла в верхнем регистре$T
символ, соответствующий типу потока (файл: f,
Video CD: v, DVD: d,
URL: u)
$p
символ p (если фильм воспроизводится и шрифт имеет
символ p)
$s
символ s (если фильм остановлен и шрифт имеет
символ s)
$e
символ e (если фильм на паузе и шрифт имеет
символ e)
$xширина фильма$yвысота фильма$Cназвание используемого кодека
Переменные $a, $T, $p, $s и $e все
возвращают символы, которые должны быть отображены в качестве специальных значков
(например, e - для значка паузы, который обычно выглядит как ||).
Вы должны иметь шрифт для обычных символов и отличающийся шрифт для значков.
Смотрите раздел о значках
для дополнительной информации.
Вспомогательное окно
Следующие элементы могут быть использованы в блоке
'window = sub' . . . 'end' .
base = image, X, Y, width, height
Изображение, отображаемое в окне. Окно будет появляться в указанной позиции
X,Y экрана (0,0 - верхний левый угол).
Вы можете указать -1 для центра и -2
для правого (X) и нижнего (Y) края.
Окно будет того же размера, что и изображение. width и
height означают размер окна; они необязательны
(если отсутствуют, окно будет иметь те же размеры, что и изображение).
background = R, G, B
Позволяет указать цвет фона. Это полезно, если изображение меньше окна.
R, G и B
указывают красную, зеленую и синюю составляющие цвета (каждое из них -
десятичное число от 0 до 255).
Меню со скинами
Как было описано выше, меню отображается при помощи двух картинок. Нормальные
элементы меню берутся из изображения, указанного элементом base,
в то время как выделенный в данный момент элемент берется из изображения,
указанного элементом selected. Вы должны определить позицию и
размер каждого элемента меню.
Следующие элементы можно использовать в блоке
'window = menu'. . .'end'.
base = image
Изображение для нормальных элементов меню.
selected = image
Изображение, показывающее меню со всеми выделенными элементами.
menu = X, Y, width, height, message
Определяет позицию X,Y и размер элемента меню в изображении.
message - это сообщение, генерируемое, когда кнопка мыши будет отпущена
над элементом меню.
Шрифты
Как описано в разделе, посвященному частям скина, шрифт определяется
изображением и файлом описания. Вы можете поместить символы в любое место изображения,
но будьте уверены, что их позиция и размер точно указаны в файле описания.
Файл описания шрифта (с расширением .fnt) может иметь комментарии,
начинающиеся с ';'. Файл должен иметь строку вида
image = image,
где image - это название
файла с изображением, используемым для шрифта (расширение указывать необязательно).
"char" = X, Y, width, height
Здесь X и Y указывают позицию символа
char в изображении (0,0 - верхний левый угол),
width и height - размеры символа в пикселах.
Этот пример определяет символы A, B, C, используя font.png.
; 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
Значки
Некоторые символы имеют специальное значение, когда возвращаются некоторыми переменными,
используемыми в dlabel. Подразумевается, что эти символы
должны отображаться в виде значков, так для DVD потока можно отображать значок
красивого логотипа DVD вместо символа 'd'.
Следующая таблица содержит список всех символов, которые могут использоваться для
отображения значков (и поэтому требуют другой шрифт).
СимволЗначокpвоспроизведениеsстопeпаузаnбез звукаmзвук моноtзвук стереоfфайлvVideo CDdDVDuURLGUI сообщения
Это сообщения, которые могут генерироваться кнопками, ползунками и элементами меню.
Управление воспроизведением:evNext
Переход к следующему элементу списка воспроизведения.
evPause
Вместе с evPlaySwitchToPause формирует переключатель паузы.
Может быть использовано для общей кнопки воспроизведение/пауза. Оба сообщения
должны быть назначены кнопкам, находящимся практически в одной точке окна.
Это сообщение ставит воспроизведение на паузу и показывает изображение кнопки с
назначенным сообщением evPlaySwitchToPause
(чтобы показать, что кнопка может быть нажата для продолжения воспроизведения).
evPlay
Старт воспроизведения.
evPlaySwitchToPause
Противоположность evPauseSwitchToPlay. Это сообщение
запускает воспроизведение и показывает изображение кнопки с
назначенным сообщением evPauseSwitchToPlay
(чтобы показать, что кнопка может быть нажата для включения паузы).
evPrev
Переход к предыдущему элементу списка воспроизведения.
evStop
Останавливает воспроизведение.
Перемещение:evBackward10sec
Перемещение назад на 10 секунд.
evBackward1min
Перемещение назад на 1 минуту.
evBackward10min
Перемещение назад на 10 минут.
evForward10sec
Перемещение вперед на 10 секунд.
evForward1min
Перемещение вперед на 1 минуту.
evForward10min
Перемещение вперед на 10 минут.
evSetMoviePosition
Перемещается к позиции (может использоваться ползунком;
используется относительное (0-100%) положение ползунка).
Управление видео:evHalfSize
Установить половинный размер окна.
evDoubleSize
Установить двойной размер окна.
evFullScreen
Включить/выключить полноэкранный режим.
evNormalSize
Установить нормальный размер окна.
Управление звуком:evDecAudioBufDelay
Уменьшить задержку буфера звука.
evDecBalance
Уменьшить баланс.
evDecVolume
Уменьшить громкость.
evIncAudioBufDelay
Увеличить задержку буфера звука.
evIncBalance
Увеличить баланс.
evIncVolume
Увеличить громкость.
evMute
Выключить/включить звук.
evSetBalance
Установить баланс (может использоваться ползунком;
используется относительное (0-100%) значение ползунка),
evSetVolume
Установить громкость (может использоваться ползунком;
используется относительное (0-100%) значение ползунка),
Разное:evAbout
Открыть окно 'О программе'.
evDropSubtitle
Отключает субтитры, использующиеся в данный момент.
evEqualizer
Включает/выключает эквалайзер.
evExit
Выход из программы.
evIconify
Сворачивает окно в иконку.
evLoad
Открывает файл (открывая окно навигации, в котором вы можете выбрать файл).
evLoadPlay
Делает то же, что и evLoad, но запускает вопроизведение файла
автоматически после его загрузки.
evLoadSubtitle
Загружает файл с субтитрами (с диалогом выбора файла).
evLoadAudioFile
Загружает звуковой файл (с диалогом выбора файла).
evNone
Пустое сообщение, не имеет действий (за исключением, возможно, Subversion версий :-)).
evPlaylist
Открывае/закрывает окно со списком воспроизведения.
evPlayDVD
Пытается открыть диск в указанном устройстве DVD-ROM.
evPlayVCD
Пытается открыть диск в указанном устройстве CD-ROM.
evPreferences
Открывает окно с настройками.
evSetAspect
Включает показ пропорций изображения.
evSetURL
Отображает диалог ввода URL.
evSkinBrowser
Открывает окно навигации по скинам.
Создание качественного скина
Итак, вы прочитали о создании скина для
MPlayer GUI, прекрасно нарисовали все в
Gimp и желаете отправить скин нам?
Прочтите некоторые руководства для избежания основных ошибок и
создания высококачественного скина.
Мы хотим, чтобы скины, добавляемые нами в репозиторий, удовлетворяли
некоторым стандартам качества. Есть также несколько вещей,
сделающих вашу жизнь проще.
В качестве примера можете посмотреть на скин Blue,
начиная с версии 1.5, он удовлетворяет всем критериям, указанным ниже.
Каждый скин должна идти с файлом
README, содержащим информацию о вас, авторе,
правах на копирование, лицензионным уведомлением и всем другим,
что вам захочется добавить. Если хотите иметь историю изменений, то
этот файл - хорошее место для нее.
Должен быть файл VERSION,
содержащий только номер версии скина в одной строке
(например 1.0).
Горизонтальные и вертикальные элементы управления
(такие как ползунки громкости или положения) должны иметь
кнопку-ползунок точно отцентрированную по центру самого ползунка.
Должно быть возможно двигать кнопку к обоим концам ползунка,
но не выходить за них.
Элементы скина должны иметь правильные размеры,
указанные в файле skin. Если это не так, вы сможете щелкнуть, например,
мимо кнопки и все равно она сработает, или наоборот кликнуть на нее,
не вызвав никакого действия.
Файл skin должен быть набран аккуратно
и не должен содержать символов табуляции. Аккуратно набран означает,
что числа должны выравниваться стройно в столбцы.