Это старая версия документа!
Оригинал: Single Column Playlist (foo uie single column playlist) (англ.)
Панель в версии БЕТА и тщательно не исследовалась, поэтому делайте бекапы своих конфигураций.
Single Column Playlist (или SCP) — это компонент, созданный пользователем Terrestrial на основе кода Track Info Panel Mod (foo_uie_trackinfo_mod). Данный компонент создает одноколоночный плейлист с заголовками, который полезен для создания узких и небольших конфигураций.
Примечание: теги форматирования, доступные в SCP, почти идентичны тегам Trackinfo mod panel.
Убедитесь, что сделан бекап вашей конфигурации перед установкой или обновлением версии. SCP требует .NET C++. Если у вас нет .NET C++, то вы получите ошибку при запуске плеера:
Failed to load DLL: foo_uie_single_column_playlist.dll Reason: This application has failed to start because the application configuration is incorrect. Reinstalling the application may fix this problem.
Вы можете скачать .NET framework, который установит нужные DLL с сайта http://www.windowsupdate.com, или в качестве альтернативного варианта, скачать C++ runtime components с сайта Microsoft.com.
Начальная настройка и конфигурирование SCP такие же, как и для большинства компонентов Columns UI. Чтобы начать использовать SCP, откройте настройки Foobar2000 и найдите группу Columns UI. На вкладке «Layout» кликните правой кнопкой по основе (сплиттеру) и выберите «Insert Panel → Playlist view → Single Column Playlist View. Таким образом вы вставите экземпляр SCP в раскладку Columns UI. Чтобы попасть в настройки экземпляра SCP, выберите его и нажмите кнопку конфигурирования — Configure.
<font color="red">ВНИМАНИЕ!</font>
Конфигурации SCP не хранятся в отдельных текстовых файлах. Удаление экземпляра SCP из раскладки Columns UI (layout) также удалит его конфигурацию, поэтому храните ваш код в безопасном месте.
Быстрый доступ к конфигурированию SCP возможен из окна основного плейлиста. Кликните правой кнопкой по окну основного плейлиста и выберите «Settings…» из контекстного меню.
Размещение заголовка над группой элементов, у которых есть общие характеристики определяемые пользователем. Заголовок отображает информацию, взятую из тега ПЕРВОГО элемента группы; теги других элементов НЕДОСТУПНЫ для заголовка. Группировка НЕ СОРТИРУЕТ. Другими словами, группировка не меняет порядок в котором элементы появляются в плейлисте. Сортировка возможна либо через отдельную команду SORT, которая будет описана ниже, либо через Columns UI.
Критерии для группировки определяются в секции «Group By» окна конфигурирования Single Column Playlist с помощью доступных функций (например, $if(,,) $replace(,,) %artist%
, и т.д.).
Следующий пример создает новую группу для каждого нового альбома или для каждого нового диска (если доступен альбом).
$if2(%disc%,%album%)
Код здесь затрагивает конкретные элементы в single column playlist. Можно использовать такие переменные, как title, track number, length, rating
и так далее.
Код здесь затрагивает заголовок ряда для групп элементов плейлиста. Artist, album, genre, bitrate, date, codec, album art
или любой критерий, выбранный вами для группировки.
Высота ряда. Установка размера каждого элемента плейлиста в пикселях. Если высота какого-то ряда будет будет больше, то все равно обрежется до указанного.
Это новая опция SCP, которая устанавливает количество рядов для заголовка группы. Значение по умолчанию равно 2 — означает, что в заголовке содержится два ряда информации. Кроме того, заголовок может иметь больший размер шрифта по сравнению с другими данными в рядах.
$align(H,V)
Параметр | Определение | Примечание |
---|---|---|
(H)orizontal | Горизонально. Может принимать значения left, center и right (слева, по центру или справа). |
|
(V)ertical | Вертикально. Может принимать значения top, middle и bottom (сверху, по середине или снизу). | top будет проверяться на перезапись. |
Если с помощью этой функции выравнять несколько раз подряд (например, $align(left,middle)
больше чем один раз), то выравнивание будет происходить с той же точки отсчета.
$alignset() - $alignrel(H,V)
Параметр | Определение | Примечание |
---|---|---|
(H)orizontal | Горизонтально. Может принимать значения left, center и right (слева, по центру или справа). |
|
(V)ertical | Вертикально. Может принимать значения top, middle и bottom (сверху, по середине и внизу). | top будет проверяться на перезапись. |
$alignset() | Устанавливает точку отсчета для $alignrel(H,V) . | Может применяться как замена функции $char(10) , работает для всех следующих $alignrel(H,V) . |
Например:
$alignrel(left,middle) //Линия1_слева// $alignrel(center,middle) //Линия1_по_центру// $alignset() $alignrel(right,middle) //Линия2_справа//
$alignabs(X,Y,w,h,H,V)
Параметр | Определение | Примечание |
---|---|---|
X & Y | Координаты позиции границ прямоугольника в котором будет происходить выравнивание | Значения могут быть отрицательными. |
(W)idth & (H)eight | Ширина и высота прямоугольника в котором будет происходить выравнивание текста. | |
H & V | см. таблицу выше |
Примечание: $alignabs(H,V) может быть использована для относительного выравнивания без проверки на перезапись.
$font(NAME,SIZE,OPTIONS,COLOR)
Параметр | Определение | Примечание |
---|---|---|
NAME | Название шрифта. | |
SIZE | Размер шрифта. | |
OPTIONS | Опции. Могут иметь значение bold, italic, underline, strikeout, nocleartype, glow- и shadow | Также, возможно совмещать значения, например, «bolditalicunderlineglow-» даст комбинацию этих эффектов. Значения по-умолчанию для glow — glowexpand-2 и glowblur-2. |
COLOR | Цвет. Цвет шрифта указывается в пространстве R-G-B. | Например, 255-0-0 даст красный цвет. |
Используйте SYSCOL-x для использования стандартных цветов из вашей темы Windows (msstyle). X — это номер цвета от 0 до ?.
Следующий пример создаст шрифт Arial, размером 10 пикселей, жирный, с синим эффектом glow и системным цевтом номер #15 (фон):
$font(Arial, 10, bold shadow glow-0-0-255,SYSCOL-15)
$puts(font,$font(Calibri,9,bold,100-100-100))
). Восстанавливать значения необходимо после использования функции $alignrel
, но не перед ней.$get
не оказывает никакого воздействия на $calcwidth/$calcheight
. Эти функции используют последнее реальное значение параметров $font
, даже если их задавали функцией $puts
.$alignabs
.Примеры:
$imageabs(X,Y,imageName,imageOptions)
Параметр | Определение | Примечание |
---|---|---|
X & Y | Абсолютная позиция изображения с отсчетом от верхнего левого угла. | |
imageName | Относительный путь к изображению из папки, где хранится конфигурация плеера. | Если отключена поддержка профилей, то папка конфигурации будет той же, куда установлен плеер. Однако, если включена поддержка профилей, то папка будет расположена в C:\Documents and Settings\ИМЯ ПОЛЬЗОВАТЕЛЯ\Application Data\foobar2000\ |
imageOptions | Может включать в себя другие параметры, влияющие на представление изображения. | Описание параметров ниже. |
Параметры imageOptions:
Пример:
$imageabs(0,0,%папка_конфигурации_foobar%\картинки\моя_картинка.png,flow alpha-150)