Инструменты пользователя

Инструменты сайта


foobar2000:plugins:uie:singlecolumnplaylist

Это старая версия документа!


Single Column Playlist

Аннотация

Общее

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 из раскладки (layout) также удалит его конфигурацию, поэтому храните ваш код в безопасном месте.

Быстрый доступ к конфигурированию SCP возможен из окна основного плейлиста. Кликните правой кнопкой по окну основного плейлиста и выберите Settings… из контекстного меню.

Группировка

Размещение заголовка над группой элементов, у которых есть общие характеристики определяемые пользователем. Заголовок отображает информацию, взятую из тега ПЕРВОГО элемента группы; теги других элементов НЕДОСТУПНЫ для заголовка. Группировка НЕ СОРТИРУЕТ, другими словами, группировка не меняет порядок в котором элементы появляются в плейлисте. Сортировка возможна либо через отдельную команду SORT, которая будет описана ниже, либо через Columns UI.

Критерии для группировки определяются в секции «Group By» окна конфигурирования Single Column Playlist с помощью доступных функций (например, $if(,,) $replace(,,) %artist%, и т.д.).

Следующий пример создает новую группу для каждого нового альбома или для каждого нового диска (если доступен альбом).

$if2(%disc%,%album%)

Item display

Здесь код затрагивает конкретные элементы в single column playlist. Можно использовать такие переменные, как title, track number, length, rating и так далее.

Group display

Здесь код затрагивает заголовок ряда для групп элементов плейлиста. Artist, album, genre, bitrate, date, codec, album art или любой критерий, выбранный вами для группировки.

Row height

Высота ряда. Установка размера каждого элемента плейлиста в пикселях. Если что-то будет больше, то обрежется.

Group row

Это новая опция SCP, которая устанавливает число рядов, занятое каждым рядом заголовка. Значение по-умолчанию 2, означает, что заголовок содержит два ряда информации. Кроме того, информация заголовка может показываться большим шрифтом по сравнению с другими данными в рядах.

Функции

Выравнивание текста

Чтобы выравнять текст

$align(H,V)
Название Определение Примечание
(H) горизонтальноМожет принимать значения left, center и right (слева, по центру или справа).
(V) вертикальноМожет принимать значения top, middle и bottom (сверху, по середине или снизу).«top» будет проверяться на перезапись.

Если выравнивать несколько раз для одной и той же позиции (например, $align(left,middle) больше чем один раз), выравнивание начнется с той же точки.

Чтобы выравнять текст относительно

$alignset() - $alignrel(H,V)
Название Определение Примечание
(H) горизонтальноМожет принимать значения left, center и right (слева, по центру или справа).
(V) вертикальноМожет принимать значения 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)
  • Вы можете сохранять и восстанавливать значения переменных шрифта используя функции $put/$puts/$get (например, «$puts(font,$font(Calibri,9,bold,100-100-100))»). Восстанавливать значения необходимо после использования функции $alignrel, но не перед ней.
  • Также, функции $calcwidth/$calcheight aren't affected by font settings set by using $get. Эти функции используют последнее реальное значение параметров $font, даже если их задавали функцией $puts.
  • При использовании продвинутых эффектов отключается сглаживание (антиалиасинг) шрифтов (даже для alpha blending). Также, следующий текст влияет на предыдущий, так что, возможно, вам придется добавлять пробелы либо использовать функцию $alignabs.

Примеры:

Trackinfo-font-example.png

Изображения

$imageabs

$imageabs(X,Y,imageName,imageOptions)
Название Определение Примечание
X & YАбсолютная позиция изображения с отсчетом от верхнего левого углаAbsolutely position the image .
imageNameОтносительный путь к изображению из папки, где хранится конфигурация плеера.Если отключена поддержка профилей, то папка конфигурации будет той же, куда установлен плеер. Однако, если включена поддержка профилей, то папка будет расположена в C:\Documents and Settings\ИМЯ ПОЛЬЗОВАТЕЛЯ\Application Data\foobar2000\
imageOptionsМожет включать в себя другие параметры, влияющие на представление изображения.Описание параметров ниже.

Параметры imageOptions:

  • ALPHA-x Прозрачность изображения; указывается целым числом от 0 (полностью прозрачно) до 255 (непрозрачно).
  • FLOW Обтекание текста вокруг текста.

Пример:

$imageabs(0,0,%папка_конфигурации_foobar%\картинки\моя_картинка.png,flow alpha-150)
foobar2000/plugins/uie/singlecolumnplaylist.1172815072.txt.gz · Последние изменения: 2007/03/02 08:57 — Spike