Различия

Здесь показаны различия между двумя версиями данной страницы.

--- foobar2000:plugins_for_0.9.x:single_column_playlist_foo_uie_single_column_playlist [2007/03/01 08:03]
Spike
+++ foobar2000:plugins_for_0.9.x:single_column_playlist_foo_uie_single_column_playlist [2007/03/15 08:15] (текущий)
Spike
@@ Строка 1: / Строка 1: @@
 ====== Single Column Playlist Viewer (foo_uie_single_column_playlist) ======
-Показывает плейлист в одну колонку с заголовками. Панель полезна для создания узких и маленьких конфигураций/раскладок Columns UI.
+===== Внимание! =====
+**SINGLE COLUMN PLAYLIST VIEWER ТЕПЕРЬ НАЗЫВАЕТСЯ SINGLE COLUMN PLAYLIST И ЯВЛЯЕТСЯ ЧАСТЬЮ [[foobar2000:plugins_for_0.9.x:foo_ui_panels_foo_ui_panels]], И ОТДЕЛЬНО БОЛЬШЕ НЕ ПОДДЕРЖИВАЕТСЯ.**
+===== Аннотация =====
+Оригинал: [[http://wiki.hydrogenaudio.org/index.php?title=Foobar2000:Components_0.9/Single_Column_Playlist_%28foo_uie_single_column_playlist%29|Single Column Playlist (foo uie single column playlist)]] (англ.)
 ===== Требования =====
   * [[http://download.microsoft.com/download/d/3/4/d342efa6-3266-4157-a2ec-5174867be706/vcredist_x86.exe|C++ 2005 Redistr (2,56Mb)]]
-===== Наши статьи =====
-  * [[foobar2000:plugins:uie:singlecolumnplaylist]]
+===== Общее =====
+Показывает плейлист в одну колонку с заголовками. Панель полезна для создания узких и маленьких конфигураций/раскладок Columns UI.
+{{foobar2000:plugins:uie:minifooim0.png?150|Single Column Playlist}}
+Панель в версии **БЕТА** и тщательно не исследовалась, поэтому делайте бекапы своих конфигураций.
+[[http://wiki.foobar2000.ru/foobar2000:plugins_for_0.9.x:single_column_playlist_foo_uie_single_column_playlist|Single Column Playlist]] (или SCP) — это компонент, созданный пользователем [[http://www.hydrogenaudio.org/forums/index.php?showuser=33259|Terrestrial]] на основе кода [[foobar2000:plugins_for_0.9.x:track_info_panel_mod_foo_uie_trackinfo_mod]]. Данный компонент создает одноколоночный плейлист с //заголовками//, который полезен для создания узких и небольших конфигураций.
+//Примечание: теги форматирования, доступные в SCP, почти идентичны тегам [[foobar2000:plugins_for_0.9.x:track_info_panel_mod_foo_uie_trackinfo_mod]].//
+=====Установка=====
+Убедитесь, что сделан бекап вашей конфигурации перед установкой или обновлением версии. 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 с сайта [[http://www.microsoft.com/downloads/details.aspx?familyid=32BC1BEE-A3F9-4C13-9C99-220B62A191EE&displaylang=en|Microsoft.com]].
+=====Окно конфигурации=====
+{{foobar2000:plugins:uie:scp_config1.png|Окно конфигурации}}
+**Начальная настройка и конфигурирование SCP такие же, как и для большинства компонентов Columns UI.** Чтобы начать использовать SCP, откройте настройки Foobar2000 и найдите группу Columns UI. На вкладке "Layout" кликните правой кнопкой по основе (сплиттеру) и выберите "Insert Panel -> Playlist view -> Single Column Playlist View. Таким образом вы вставите экземпляр SCP в раскладку Columns UI. Чтобы попасть в настройки экземпляра SCP, выберите его и нажмите кнопку конфигурирования — <key>Configure</key>.
+<html><font color="red">ВНИМАНИЕ!</font></html> Конфигурации SCP не хранятся в отдельных текстовых файлах. Удаление экземпляра SCP из раскладки Columns UI (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)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)
+  * Вы можете сохранять и восстанавливать значения переменных шрифта используя функции $put/$puts/$get (например, ''$puts(font,$font(Calibri,9,bold,100-100-100))''). Восстанавливать значения необходимо после использования функции  ''$alignrel'', но не перед ней.
+  * Также, изменение настроек шрифта с помощью ''$get'' не оказывает никакого воздействия на ''$calcwidth/$calcheight''. Эти функции используют последнее реальное значение параметров ''$font'', даже если их задавали функцией ''$puts''.
+  * При использовании продвинутых эффектов отключается сглаживание (антиалиасинг) шрифтов (даже для alpha blending). Также, следующий текст влияет на предыдущий, так что, возможно, вам придется добавлять пробелы либо использовать функцию ''$alignabs''.
+**Примеры шрифтов и код:**
+{{foobar2000:plugins:uie:trackinfo-font-example.png|Примеры шрифтов Single Columns Playlist}}
+====Изображения====
+===$imageabs===
+  $imageabs(X,Y,imageName,imageOptions)
+^Параметр ^Определение ^Примечание^
+|**X & Y**|Абсолютная позиция изображения с отсчетом от верхнего левого угла.||
+|**imageName**|Относительный путь к изображению из папки, где хранится конфигурация плеера.|Если отключена поддержка профилей, то папка конфигурации будет той же, куда установлен плеер. Однако, если включена поддержка профилей, то папка будет расположена в **C:\Documents and Settings\ИМЯ ПОЛЬЗОВАТЕЛЯ\Application Data\foobar2000\**|
+|**imageOptions**|Может включать в себя другие параметры, влияющие на представление изображения.|Описание параметров ниже.|
+Параметры **imageOptions**:
+  * //ALPHA-x//. Прозрачность изображения; указывается целым числом от 0 (полностью прозрачно) до 255 (непрозрачно).
+  * //FLOW//. Обтекание текста вокруг текста.
+Пример:
+  $imageabs(0,0,%папка_конфигурации_foobar%\картинки\моя_картинка.png,flow alpha-150)
+===$imageabs2===
+**$imageabs2(areaWidth,areaHeight,imageLeft,imageTop,imageWidth,imageHeight,areaLeft,areaTop,imagePath,imageOptions)**
+^Параметр ^Определение ^Примечание^
+|areaWidth & areaHeight|Параметры, управляющие размером изображения. Позволяют только уменьшать изображение.||
+|imageLeft & imageTop|Указывают на позицию уменьшенного изображения от левого верхнего угла.|**imageLeft** — горизонтальная позиция **уменьшенного** изображения, **imageTop** — вертикальная позиция **не уменьшенного** изображения. Если у вас есть изображение в формате JPEG размером 300x300 пикселей, и с помощью функций **areaWidth** и **areaHeight** оно уменьшено до размера 150x150 пикселей (**imageLeft** = 75 and **imageTop** = 150), то точка в верхнем левом углу финального изображения будет центром оригинального изображения 300x300.|
+|imageWidth & imageHeight|Обрезание ширины и высоты, соответственно обрезание **сжатого** изображения.|Значения, которые больше, чем расстояние от обрезанного угла до границ уменьшенного изображения будут игнорироваться (обрезание как таковое будет пропущено). При значениях равных или больших, чем 32768, изображение вовсе не будет показано.|
+|areaLeft & areaTop|Расстояние, соответственно, влево и вниз, от верхнего левого угла панели до верхнего левого угла финального уменьшенного и обрезанного изображения.||
+|imagePath|Абсолютный или относительный путь к папке с изображениями.|Для относительных путей нужно поставить слеш ('/') в начале пути. (например, "/путь\до\изображение.jpg"). Когда будете использовать относительные пути, учтите, что корневая папка — это инсталляционная папка foobar2000.|
+|imageOptions|Опции изображения.|Описание параметров ниже.|
+Параметры **imageOptions**:
+  * //ALPHA-x//. Прозрачность изображения; указывается целым числом от 0 (полностью прозрачно) до 255 (непрозрачно).
+  * //NOKEEPASPECT//. При изменении размера игнорировать пропорции изображения (aspect ratio).
+  * //VALIGN-T (vertical align-TOP), VALIGN-B, HALIGN-L, HALIGN-R//. Опции выравнивания.
+Более просто:
+  $imageabs2(Размеры сжатия,Положение угла обрезания,Размеры обрезания,Расположение панели,Путь,Опции изображения)
+Пример:
+  $imageabs2(48,48,0,0,48,48,20,20,C:\Program Files\foobar2000 v0.9\icons\$replace(%filename_ext%,%filename%'.',)_48x48.png,alpha-192)
+Уменьшить изображение до 24x24 (изначальный размер 48х48) без обрезания:
+  $imageabs2(**24**,**24**,0,0,**24**,**24**,20,20,/icons\$replace(%filename_ext%,%filename%'.',)_48x48.png,alpha-192)
+====Отрисовка прямоугольника====
+**$drawrect(X,Y,W,H,brushColor-R-G-B penColor-R-G-B OPTIONS)**
+|X & Y|Позиция прямоугольника относительно верхнего левого угла.|Если эти параметры пропустить или выставить на ноль, то они заменятся минимальными значениями относительно ''$pad''.|
+|W & H|Определяет ширину и высоту прямоугольника.|Если эти параметры пропустить или выставить на ноль, то они заменятся минимальными значениями относительно ''$pad''.|
+|brushColor & penColor|Цвета фона и границы в пространстве R-G-B.|Например, 255-0-0 даст красный цвет. Параметры могут быть отключены с помощью -null (например, brushColor-null). Используйте //SYSCOL-x// для использования стандартных цветов из вашей темы Windows (msstyle). X — это номер цвета от 0 до ?.|
+|OPTIONS|Опции прямоугольника.|Описание параметров ниже.|
+**Параметры OPTIONS:**
+При использовании сложных эффектов, таких как alpha blending или blurring, прямоугольник рисуется только используя цвет границы. Если вы укажите цвет фона, то возьмется цвет границы.
+  * //ALPHA// — интервал  0-255.
+  * //EXPAND// — расширить прямоугольник на столько-то пикселей.
+  * //BLUR// — размазать (заблёрить) изображение с таким-то значением.
+  * //WIDTH// — ширина границы (рисуется цветом границы). Значение по умолчанию — 1, если не отключено при помощи pencolor-null. Установка значения в 0 не отключает границу (значение остается 1).
+Пример:
+   $drawrect(,,,,pencolor-0-0-255 brushcolor-null width-2 alpha-100 blur-2)
+====Другие функции====
+===Вычисление размеров===
+Следующие функции возвращают размеры (в пикселях) элемента плейлиста или группы, в зависимости используете ли вы эти функции в **item display** или **group display** окна настроек Single Column Playlist:
+  %_height%
+  %_width%
+Следующие функции возвращают индекс (номер) элемента ((Под элементом подразумевается трек в плейлисте)) в группе и количество элементов в группе:
+  %_itemindex%
+  %_itemcount%
+Подобным же образом, следующие функции возвращают индекс (номер) элемента ((Под элементом подразумевается трек в плейлисте)) в плейлисте и количество элементов плейлиста:
+  %list_index%
+  %list_total%
+Следующие функции возвращают ширину и высоту текста:
+  $calcwidth(//Text1//)
+  $calcheight(//Text1//)
+  $calcwidth(%artist%) не возвращает не длину //%artist%//, а скорее ширину текста, хранимого в теге artist.
+===Проверка на выбор файла===
+Если курсор в плейлисте стоит на элементе (треке).
+  %_selected%
+Пример:
+  $if(%_selected%,$drawrect(2,1,$sub(%_width%,4),16,brushcolor-233-243-247 pencolor-203-233-246))
+===Проверка на существование файла===
+  $fileexists(//Путь к файлу//)
+Следующий пример ищет //folder.*// где расположены музыкальные файлы:
+  $if($fileexists($replace(%path%,%filename_ext%,folder.*),
+  Yes
+  ,
+  No
+  )
+===Перемещение треков или групп в плейлисте===
+Нажмите <key>Alt</key> и перетащите мышкой, либо нажмите <key>Alt-вверх/вниз</key>
+===Получение глобальных переменных Columns UI===
+  $get_global(//переменная//)
+Синтакс такой же, как и в Columns UI.
+//Примечание: для отображения глобальных переменных, возможно, потребуется перезапуск плеера.//
+===Запрет заголовка===
+  !noheader!
+Пример:
+  //В секции 'Group by'//
+  $if(%tracknumber%,%artist%,!noheader!)
+=====Советы и секреты=====
+===Как растянуть изображение на несколько рядов===
+растянуть изображение на несколько рядов можно при помощи ''%tracknumber%'' или ''%list_index%'', чтобы генерировать вертикальное смещение каждый раз при прорисовке изображения на каждом ряду. Код ниже поместите item display.
+**Пример Tracknumber:**
+Этот пример использует %tracknumber% для определения расположения путем умножения высоты ряда на tracknumber:
+  $imageabs(X OFFSET,$add(STARTING Y OFFSET,$mul(-ROW HEIGHT,%tracknumber%)),IMAGE DIRECTORY/IMAGE.png,)
+Например, при высоте ряда 26 пикселей и горизонтальной (x) позицией 0 и начальный вертикальным смещением  25:
+   $imageabs(0,$add(25,$mul(-26,%tracknumber%)),images/test.png,)
+**Пример List Index:**
+Другой алгоритм использует ''%list_index%''. Этот пример рисует левую и правую границу single playlist column. Изображение шире, чем ширина ряда, поэтому нужно пользоваться техникой смещения.
+  * Сначала определим ширину и высоту изображения:
+  $puts(art.width,30)
+  $puts(art.height,60)
+  * Расчитаем число рядов, необходимое для отображения изображения:
+  $puts(art.num,$add($div($mul(%list_index%,%_height%),$get(art.height)),1))
+  * Используем высоту и количество изображений для генерации смещения для каждого элемента:
+  $puts(art.offset,-$sub($sub($mul(%list_index%,%_height%),$mul($sub($get(art.num),1),$get(art.height))),%_height%))
+  * Используем смещение:
+  $imageabs(0,$get(art.offset),images\column.left.png,)
+  * Используем ширину для смещения по горизонтали для самой правой границы:
+  $imageabs($sub(%_width%,$get(art.width)),$get(art.offset),images\column.right.png,)
+===Группа, основанная на имени плейлиста===
+Используем компонент [[foobar2000:plugins_for_0.9.x:cwbowron_s_title_formating_foo_cwb_hooks]]:
+  $if($strstr(%cwb_activelist%,'TERM'), SORT BY IF MATCH, ELSE SORT BY THIS)
+Например,
+  $if($strstr(%cwb_activelist%,'-s-'), %rating%, %album%)
+Этот код группирует альбом для всех плейлистов, если в плейлисте нет '-s-'. Если -s- есть, то элементы сгруппируются по рейтингу. (Strstr сравнивает две строки чтобы проверить наличие -s- в cwb_activeplaylist)
+=====Примеры=====
+====Толкование настройки по умолчанию====
+===Group By===
+  * Группировка элементов по альбому:
+  %album%
+===Item Display===
+  * Рисует заполненный прямоугольник стандартным системным цветом "SYSCOL-13":
+  $if(%_selected%,$drawrect(0,0,0,0,brushcolor-SYSCOL-13 pencolor-null))
+  * Рисует границу вокруг выбранного элемента цветом границы (системным цветом "SYSCOL-6"):
+  $if(%_focused%,$drawrect(0,0,0,0,brushcolor-null pencolor-SYSCOL-6))
+  * Меняет текст выбранного элемента, используя разный цвет:
+  $if(%_selected%,$textcolor(SYSCOL-9),$textcolor(SYSCOL-8))
+  * Устанавливает pagging рядов (horizontal, vertical):
+  $padding(4,0)
+  * Основной текст в каждом ряду выравнивается top left и right:
+  $align(left,top)%list_index%
+  $align(right,top)%title%
+===Group Display===
+  * Рисует прямоугольник заголовка группы
+  $drawrect(0,0,0,0,brushcolor-130-130-255 pencolor-null)
+  * Устанавливает pagging заголовка:
+  $padding(4,0)
+  * Добавляет информацию альбома, дату и данные композитора:
+  $align(left,top)$font(,,bold,64-0-0)%album% '['%date%']'
+  $align(right,top)$font(,,bold,0-64-0)%composer%
+(Values displayed are always those of the first item, without regard to the values of other items in the group.)
+{{foobar2000:plugins:uie:single_column_playlist-3.png|}}
+====Mazy's Design====
+Указанный ниже код и скриншот создан пользователем [[http://www.hydrogenaudio.org/forums/index.php?showuser=7705|Mazy]].
+===Item Display===
+  $if($strcmp($mod(%_playlist_number%,2),1),
+  $drawrect(,,,,brushcolor-245-245-245 pencolor-null))
+  $padding(2,0)
+  $font(calibri bold,9,$if(%isplaying%,underline,),170-170-170)
+  $replace(%title%,'(',$font(,,bold italic,204-204-204)'(')
+  $alignabs(6,13,%_width%,%_height%,,)
+  $font(CubicFive10,6,nocleartype,190-190-190)
+  [%length% | ]
+  [%bitrate% kbps]
+  $alignabs(0,-1,$sub(%_width%,2),%_height%,right,)
+  $font(CubicFive10,6,nocleartype,190-190-190)
+  [%play_count%x]
+  $if(%cwb_queueindex%, '['%cwb_queueindexes%/%cwb_queuelength%']')
+  $alignabs(0,10,$sub(%_width%,2),%_height%,right,)
+  $font(Wingdings,9,glow-190-190-190 glowexpand-1,250-250-250)
+  $repeat(«,%rating%)
+===Group Display===
+  $padding(1,0)
+  $drawrect(,,,,brushcolor-119-213-249 pencolor-51-191-238)$padding(4,1)
+  $align(left,center)$font(calibri bold,9,,255-255-255)
+  $font(,,bold glow-18-173-224 glowexpand-1,)
+  %album%
+  $align(right,center)$font(,,bold,255-255-255)
+  %artist%
+  $puts(ar_w,$calcwidth(%artist%))
+  $drawrect($sub(%_width%,$get(ar_w),18),-1,3,%_height%,brushcolor-51-191-238 pencolor-null)
+  $drawrect($sub(%_width%,$get(ar_w),17),-1,1,%_height%,brushcolor-250-250-250 pencolor-null)
+  $alignabs(6,13,%_width%,%_height%,,)
+  $font(CubicFive12,6,nocleartype,18-173-224)
+  [%date% | ][%genre%]
+  $alignabs(0,10,$sub(%_width%,$get(ar_w),13),%_height%,right,)
+  $font(Wingdings,10,,)
+  $repeat(«,$rand(5))
+  $imageabs($sub(%_width%,$get(ar_w),98),0,data\misc images\playlist-refl.png,)
+  $imageabs($sub(%_width%,87),0,data\misc images\playlist-refl.png,)
 ===== Ссылки =====

foobar2000

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

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

Различия

Инструменты страницы