JSplitter v2.1.7.1 / v1.5.10.2 [26.09.2018]

Список разделов Аудиоплеер foobar2000 Плагины

Описание: Все о плагинах, компонентах, расширениях

Сообщение #1 LUR » 21.03.2018, 06:06

Плагин представляет собой панель, совмещающую функциональность сплиттера (контейнера для панелей других плагинов) и хоста скриптов JavaScript.

Особенности функционала:

1. Панели добавляются в сплиттер в произвольном порядке, где с ними можно работать как с обычными окнами Windows, а именно: перемещать, изменять их размер, сворачивать, разворачивать, закрывать. Т.е. при работе с плагином foobar2000 превращается в приложение с MDI интерфейсом (Multi Document Interface). Для точного позиционирования панелей предусмотрено отображение координат и их редактирование "на лету" в заголовке окна панели (полезно при дизайне интерфейса сборки). Также имеется возможность настраивать цвета и шрифт заголовка окон панелей.

1.PNG


2. Поддерживается управление размещением панелей в сплиттере через стандартный "размещатель" Columns UI.
3. В основе хоста скриптов лежат JScript Panel / WSH Panel Mod, соответственно имеет все возможности данных панелей + дополнительные расширения API, касающиеся сплиттера.
4. Поддерживается управление панелями в сплиттере из скриптов. Возможно программно перемещать, скрывать, изменять размер панелей.
5. Имеется специальное API для быстрого создания кнопок в корне панели.

Итог: по своей задумке функционала повторяет Mega Panel Splitter, но с приятными дополнениями в виде ручного управления перемещением панелей и простого API для создания кнопок. Ну а еще может кому-то просто понравится использовать foobar2000 в виде MDI приложения, кто знает.

Дисклеймер: Функциональность сплиттера работает ТОЛЬКО в COLUMNS UI. В DUI данный плагин превращается в обычный JScript Panel / WSH Panel Mod.

СКАЧАТЬ JSplitter v2.1.7.1 (Версия, основанная на JScript Panel v2.1.7.1)
АНГЛИЙСКАЯ ВЕРСИЯ
РУССКАЯ ВЕРСИЯ
ЗЕРКАЛО
АНГЛИЙСКАЯ ВЕРСИЯ
РУССКАЯ ВЕРСИЯ

СКАЧАТЬ JSplitter v1.5.10.2 (Версия, основанная на WSH Panel Mod v1.5.10)
АНГЛИЙСКАЯ ВЕРСИЯ
РУССКАЯ ВЕРСИЯ
ЗЕРКАЛО
АНГЛИЙСКАЯ ВЕРСИЯ
РУССКАЯ ВЕРСИЯ

Краткое руководство
Для добавления панелей в сплиттер можно воспользоваться 2-мя способами:

1. С помощью контекстного меню панели плагина:

2.PNG
2.PNG (7.04 КБ) Просмотров: 11126


2. С помощью стандартного размещателя Columns UI:

4.PNG


3. С помощью списка панелей, вызываемого из окна конфигурации скрипта. Список панелей можно также использовать для добавления, удаления, переупорядочивания панелей, а также изменения их положения и размеров вручную (двойной щелчок по соответствующему полю):

Снимок.PNG


Все добавляемые панели можно вручную перемещать, изменять их размер, сворачивать, разворачивать, закрывать. У каждого окна в заголовке имеется меню для настройки некоторых опций:

3.PNG


ВНИМАНИЕ! Порядок размещения панелей в сплиттере зависит от глубины их визуального расположения. Самое верхнее окно будет последним в списке. Если вы активируете мышкой какую-либо панель, она переместится в конец списка. Учитываете это при использовании функции GetPanelByIndex (см. ниже).

Show caption - включает/отключает отображение обрамления (бордюра) окна панели
Locked - заблокировать панель. С установленной галочкой окно не реагирует на попытки переместить/изменить/закрыть окно.
Show coords - отобразить координаты. В заголовке окна будут отображены координаты окна, которые будут обновляться по мере перемещения/изменения размера окна.
Support pseudo transparency - некоторым окнам необходима поддержка "прозрачности". С включенной опцией плагин будет заменять фон окна панели на содержимое корневого окна плагина. Т.е. например все, что нарисовано в скрипте с помощью on_paint(gr) будет скопировано в окно.

В режиме отображения координат можно вводить необходимые координаты вручную кликнув по нужной координате или изменить название панели:

7.PNG


Настройки внешнего вида окон панелей расположены здесь:

8.png


Show tools menu for panels' caption - включает/отключает меню для заголовка окон панелей.
Move panels with middle button - позволяет перемещать панели при помощи средней кнопки мыши. Полезно когда бордюр окна скрыт (меню Show caption).
Align panels to edges of each other when dragging - выравнивать панели по краям друг друга при перетаскивании окошек. Полезно при построении интерфейса сборки, где панели должны быть расположены плотно друг к другу.
Show scrollbars for out-of-view panels - экспериментальная функция показа полос прокрутки, если панели выходят из зоны видимости. Прокручиваются только панели, содержимое отрисованного окна не меняется и не скроллится.
Hide panels on close - скрывать окна вместо их закрытия. Полезно для временного скрытия панели с помощью кнопки закрытия окна. Вернуть обратно окна можно в размещателе Columns UI сняв галочку Hidden с панели:

6.PNG



Программный интерфейс
Так как API WSH Panel Mod 1.5.10 не менялся, то он доступен как обычно. Документация к плагину прилагается. Плюс к этому доступны следующие дополнения для объекта window:

window.GetPanel(caption) - получить объект для доступа к панели по тексту заголовка. Будет возвращена первая панель, совпавшая по тексту с аргументом. Текст панели указывается в заголовке. По умолчанию он имеет значение имени плагина панели, но его можно изменить как напрямую в заголовке окна (Show coords -> Click in caption text), так и в размещателе Columns UI (Use custom title)
window.GetPanelByIndex(index) - получить объект для доступа к панели по индексу. Вообще порядок изначально тот, в котором добавляются панели, но так же порядок можно увидеть в размещателе Columns UI, там же его и изменить.
window.CreateButton(x, y, images, hover_images) - создать кнопку в сплиттере. Кнопка будет создана в корне окна и будет размещена по координатам (x, y). Также функции передаются изображения для задания внешнего вида кнопки. Собственно от количества изображений images, переданных функции, будет зависеть количество состояний, которые может принимать кнопка. hover_images - изображения кнопки, отображающиеся при наведении курсора мыши. Функция достаточно гибкая для создания различного вида кнопок, например:
var path = fb.FoobarPath + "themes\\lur\\black\\bio.png";
var hpath = fb.FoobarPath + "themes\\lur\\black\\bio_on.png";
var a = window.CreateButton(0, 0, path, hpath); - создает обычную кнопку с картинкой bio.png, которая меняется на bio_on.png при наведении курсора мыши
var b = window.CreateButton(0, 0, [path, hpath], null); - создает чекбокс-кнопку. Обычное состояние - bio.png, нажатое (галочка установлена) - bio_on.png. Обратите внимание, что изображения для наведения курсора отсутствуют. Обычно чекбоксам они и не нужны, но можно их установить при желании.
var c = window.CreateButton(0, 0, [path1, path2, path3], [path1_on, path2_on, path3_on]); - можно создать кнопку с тремя (и более) состояниями. Они будут циклически переключаться при нажатии. Текущее состояние кнопки можно будет получить с помощью свойства кнопки State (см. ниже).
Также можно создать группу радио-кнопок (взаимоисключающих) с помощью следующей функции:
window.RadioButtons(buttons) - создает группу радио-кнопок. Принимает в качестве аргумента массив кнопок. Каждая кнопка должна иметь не менее двух состояний, иначе функция свалится. Пример:
var a = window.CreateButton(0, 0, [path, hpath], null);
var b = window.CreateButton(30, 0, [path, hpath], null);
window.RadioButtons([a, b]);
Теперь при нажатии на одну кнопку (состояние 1), другая будет "отключаться" (переходить в состояние 0) и наоборот.
window.GetButton(id) - получить кнопку по значению ее идентификатора (Button.ID)
window.RemoveButton(button) - удаляет кнопку
window.HandOnButtons - переключает курсор мыши для всех кнопок либо на руку, либо на стрелку. Данное свойство также действует на все создаваемые впоследствии кнопки. У каждой кнопки можно это свойство менять индивидуально (см. ниже).
Введены вспомогательные методы для управления главным окном плеера.
window.FoobarWindowX - возвращает и устанавливает положение главного окна foobar2000 по оси X.
window.FoobarWindowY - возвращает и устанавливает положение главного окна foobar2000 по оси Y.
window.FoobarWindowWidth - возвращает и устанавливает ширину главного окна foobar2000.
window.FoobarWindowHeight - возвращает и устанавливает высоту главного окна foobar2000.

Объекты, получаемые при помощи функций, указанных выше, имеют следующие свойства и методы:

ПАНЕЛИ (GetPanel, GetPanelByIndex)
Свойства:
(readonly) String Name;
(read, write) String Text;
(read, write) boolean Hidden;
(read, write) boolean Locked;
(read, write) boolean ShowCaption;
(read, write) boolean SupportPseudoTransparency;
(read, write) int X;
(read, write) int Y;
(read, write) int Width;
(read, write) int Height;
(read, write) boolean TopMost;
(read, write) boolean EraseBackground;
Методы:
void Show(show = true);
void Move(x, y, width, height, repaintParent = false);

КНОПКИ (CreateButton, GetButton)
Свойства:
(readonly) ushort ID;
(read, write) int X;
(read, write) int Y;
(read, write) int Width;
(read, write) int Height;
(read, write) boolean Hidden;
(read, write) boolean HandOnHover;
(writeonly) Function Click;
(read, write) uint State;
Методы:
void Show(show = true);
void Move(x, y);
void Resize(width, height);

Назначение свойств и методов объектов довольно прозрачно. При назначении ширины или высоты кнопки в ноль, ширина и высота автоматически высчитываются (как и просто при создании кнопки) из максимальной ширины и высоты изображений. Отдельного упоминания заслуживает обработка нажатий кнопок. Она осуществляется 2-мя
путями:

1. При помощи задания свойства Click объекта кнопки:
var a = window.CreateButton(0, 0, [path, hpath], null);
a.Click = function() { do_something(); }

2. При помощи специального callback'a, который вызывается при нажатии ВСЕХ кнопок, созданных с помощью window.CreateButton:
function on_button_click(id) - принимает идентификатор кнопки, который можно получить через свойство кнопки ID.
switch(id) {
case a.ID:
do_something();
break;
}


ПРИМЕЧАНИЕ: В отличие от панелей, существующих вне зависимости от скрипта, кнопки создаются только программно с помощью скрипта и всегда уничтожаются при выгрузке скрипта.


Пример конфигурации
Распаковать в папку с чистым портативным фубаром.
СКАЧАТЬ / ЗЕРКАЛО

Пример от zeremy

История версий
Версия 2.1.7.1 [26.09.2018]
● JScript Panel 2.1.7.1
● Введены вспомогательные методы для управления главным окном плеера.
window.FoobarWindowX - возвращает и устанавливает положение главного окна foobar2000 по оси X.
window.FoobarWindowY - возвращает и устанавливает положение главного окна foobar2000 по оси Y.
window.FoobarWindowWidth - возвращает и устанавливает ширину главного окна foobar2000.
window.FoobarWindowHeight - возвращает и устанавливает высоту главного окна foobar2000.

Версия 2.1.6.3 / 1.5.10.2 [25.08.2018]
● Улучшена производительность прорисовки панелей: устранено мерцание за счет отключения прорисовки фона панели операционной системой.
● API: добавлено свойство EraseBackground для панелей, указывающее позволять ли операционной системе отрисовывать фон панели. Предназначено для панелей, которые не могут отобразить свой фон самостоятельно. По умолчанию свойство равно false для всех панелей кроме следующих панелей Columns UI: Buttons, Filter Search, Menu, Seekbar, Volume.

Версия 2.1.6.2 [10.08.2018]
● Исправлена работоспособность конфигурации JSplitter в Columns UI Layout (кнопка Configure)
● Мелкие улучшения Panel list
● Убран раздел статистики JScript Panel из свойств трека

Версия 2.1.6.1 [03.08.2018]
● Порядок размещения панелей в сплиттере теперь привязан к глубине их расположения. Самое верхнее окно - последнее в списке.
● Добавлено свойство TopMost для объекта панели. Установка в true переносит панель на самый верх.
● Теперь изображения на кнопках масштабируются при изменении размера кнопок.
● Исправлено падение обработчика Click для кнопок
● Создано окно управления списком панелей для просмотра их размеров и редактирования всех данных на месте. Доступ: правая кнопка мыши на сплиттере -> Изменить скрипт... -> Панели.

Версия 2.1.6.0 [30.07.2018]
● Версия, основанная на JScrpt Panel 2.1.6

Версия 1.5.10.1 [24.05.2018]
● Слегка уменьшено мерцание при перерисовке панелей

Версия 2.1.4.1 [18.05.2018]
● Исправлена ошибка "Load Scintilla failed."

Версия 2.1.4 [17.05.2018]
● Версия, основанная на JScrpt Panel 2.1.4

Версия 1.0.4 [28.03.2018]
● Исправлено: в Windows XP свойства fb.FoobarPath, fb.ProfilePath возвращали пустую строку.
● Изменение API: теперь window.GetPanel принимает в качестве аргумента текст заголовка панели, window.GetPanelByIndex - индекс панели

Версия 1.0.3 [22.03.2018]
● Исправление ошибок функционала выравнивания панелей

Версия 1.0.2 [22.03.2018]
● Исправление ошибок функционала выравнивания панелей

Версия 1.0.1 [21.03.2018]
● Добавлено выравнивание/прилипание панелей по краям друг друга, а также к границам окна самого плагина при перетаскивании (есть опция в настройках)

Версия 1.0 [20.03.2018]
LUR M
Автор темы, Модератор
Аватара
Возраст: 36
Откуда: Минск
Репутация: 229
С нами: 5 лет 11 месяцев


Сообщение #181 LUR » 09.08.2018, 17:53

maniac736, поставил в виртуалку чистую Windows 7 домашнюю базовую SP1, ничего больше не ставил, распаковал ваш фубар, сделал такую же разметку, как на вашем скрине. Ничего не падает.
LUR M
Автор темы, Модератор
Аватара
Возраст: 36
Откуда: Минск
Репутация: 229
С нами: 5 лет 11 месяцев

Сообщение #182 maniac736 » 09.08.2018, 19:11

LUR, а разметку как делали? мышью и клавой прямо на Caption элемента или через Preferences->Layout->JSplitter->Configure->Panel list?
maniac736 M
Бывалый
Аватара
Возраст: 40
Откуда: Россия Иркутск
Репутация: 4
С нами: 1 год 1 месяц

Сообщение #183 LUR » 09.08.2018, 19:37

maniac736 писал(а):а разметку как делали?
Опа)

Добавлено спустя 1 минуту 39 секунд:
Теперь падает)
LUR M
Автор темы, Модератор
Аватара
Возраст: 36
Откуда: Минск
Репутация: 229
С нами: 5 лет 11 месяцев

Сообщение #184 maniac736 » 09.08.2018, 19:39

LUR, вопрос связан с тем что крэш плейера случался именно при разметке через Panel list.

P.S. А через Caption с мышью и клавой бывает в некоторых случаях весьма неудобно настраивать - например если объект слишком узкий и до поля H добраться для редактирования проблематично. Опять же при включенной опции Align panels to edges of each other when dragging через Caption поля координат вообще не желают редактироваться - возможно так и задумано, но мне показалось неудобным. При других включенных опциях расположенных в Preferences->Tools->JSplitter->Appearance я редактировать координаты объектов просто не пробовал но возможно и там есть такое.
Последний раз редактировалось maniac736 09.08.2018, 19:53, всего редактировалось 3 раз(а).
maniac736 M
Бывалый
Аватара
Возраст: 40
Откуда: Россия Иркутск
Репутация: 4
С нами: 1 год 1 месяц

Сообщение #185 LUR » 09.08.2018, 19:43

maniac736 писал(а):вопрос связан с тем что крэш плейера случался именно при разметке через Panel list
да понятно, просто я проверял всегда через контекстное меню а не через конфиг в колумнсах. и оказалось есть разница, хм, буду глядеть...
LUR M
Автор темы, Модератор
Аватара
Возраст: 36
Откуда: Минск
Репутация: 229
С нами: 5 лет 11 месяцев

Сообщение #186 LUR » 10.08.2018, 04:09

Короче нашел ошибку. Фишка в том, что при нажатии Configure в окне конфигурации Columns UI в памяти создается отдельный экземпляр плагина (в нашем случае JSplitter), туда загружаются его текущие настройки. Экземпляр этот просто с данными, без созданных панелей, поэтому когда пытаешься обратиться к несуществующим элементам, получаешь падение плеера. Ничего не поделаешь, таков интерфейс для всех плагинов при конфигурации из окна Columns UI.
Как итог:
1. Надо было это учитывать, теперь это учтено.
2. К сожалению такая схема не предполагает применения визуальных изменений в реальном времени. То есть если менять что-то в Panel list, вызванном из окна конфигурации Columns UI, изменения будут происходить в памяти, а применяться визуально только при закрытии окна конфигурации. Такие дела. Но по мне удобнее вызывать конфигурацию прямо из сплиттера, тогда и изменения видны сразу.

Завтра выкачу, спать пора.
LUR M
Автор темы, Модератор
Аватара
Возраст: 36
Откуда: Минск
Репутация: 229
С нами: 5 лет 11 месяцев

Сообщение #187 LUR » 10.08.2018, 19:29

Версия 2.1.6.2 [10.08.2018]

● Исправлена работоспособность конфигурации JSplitter в Columns UI Layout (кнопка Configure)
● Мелкие улучшения Panel list
● Убран раздел статистики JScript Panel из свойств трека
LUR M
Автор темы, Модератор
Аватара
Возраст: 36
Откуда: Минск
Репутация: 229
С нами: 5 лет 11 месяцев

Сообщение #188 maniac736 » 10.08.2018, 22:17

LUR,при двойном нажатии мышью на элемент происходит расширение элемента на весь экран - это так предусмотрено?
maniac736 M
Бывалый
Аватара
Возраст: 40
Откуда: Россия Иркутск
Репутация: 4
С нами: 1 год 1 месяц

Сообщение #189 LUR » 10.08.2018, 23:08

maniac736, да, как у обычных окон Windows
LUR M
Автор темы, Модератор
Аватара
Возраст: 36
Откуда: Минск
Репутация: 229
С нами: 5 лет 11 месяцев

Сообщение #190 zeremy » 24.08.2018, 11:17

FYI

public beta testing of new complete theme using JSplitter possibilities

https://www.reddit.com/r/foobar2000/comments/99mu5k/project2018_foobar2000_theme/
zeremy
Новичок
Репутация: 20
С нами: 2 года 11 месяцев

Сообщение #191 seriousstas » 24.08.2018, 14:32

zeremy
Отличная работа!
Если у LUR получится убрать эти "белые экраны" при смене панелей - будет идеальный сплиттер!
Напрягают немного эти мелькания .. Есть и при старте-закрытии.
В MPS таковые отсутствуют.
Последний раз редактировалось seriousstas 24.08.2018, 14:35, всего редактировалось 1 раз.
seriousstas
Мастер
Откуда: Украина , Ивано-Франковск
Репутация: 97
С нами: 3 года 9 месяцев

Сообщение #192 LUR » 24.08.2018, 14:34

seriousstas писал(а):Если у LUR получится убрать эти "белые экраны"
Думаю не получится. Это обусловлено архитектурой плагина. Все из-за того, что добавляемые панели не самостоятельные, а вложены в родителей, с помощью которых осуществляется и их перемещение и изменение размера и т.д. Приходила мысль сделать режим без родительских окон, но там столько надо переделывать, что за голову хватаешься. Фактически переделать на новый лад, не совместимый с текущим функционалом.

Добавлено спустя 1 минуту 59 секунд:
seriousstas писал(а):В MPS таковые отсутствуют.
Ну вот как раз там нет родительских окон. Но функционал соответствующий.
LUR M
Автор темы, Модератор
Аватара
Возраст: 36
Откуда: Минск
Репутация: 229
С нами: 5 лет 11 месяцев

Сообщение #193 MC Web » 24.08.2018, 14:49

seriousstas писал(а):Если у LUR получится убрать эти "белые экраны" при смене панелей - будет идеальный сплиттер!
LUR писал(а):Думаю не получится. Это обусловлено архитектурой плагина.
Из своего наблюдения по оптимизации работы сборки, заметил, что такое происходит и при работе и с другими компонентами. Помогает, иногда, избавиться от этого "моргания" включение прозрачности. Может и тут попробовать это использовать (совет дилетанта)...
MC Web
Мастер
Аватара
Репутация: 146
С нами: 5 лет 3 месяца

Сообщение #194 LUR » 24.08.2018, 15:09

MC Web писал(а):Из своего наблюдения по оптимизации работы сборки, заметил, что такое происходит и при работе и с другими компонентами
В смысле? То есть при отсутствии JSplitter? А какие плагины например, просто интересно?
LUR M
Автор темы, Модератор
Аватара
Возраст: 36
Откуда: Минск
Репутация: 229
С нами: 5 лет 11 месяцев

Сообщение #195 MC Web » 24.08.2018, 15:18

LUR писал(а):А какие плагины например, просто интересно?
У себя заметил такое наблюдается при переключении панелей и работающем foo_youtube (его окно встроено в панель обложек). Если в окне foo_youtube отключена прозрачность, то происходит "моргание".
MC Web
Мастер
Аватара
Репутация: 146
С нами: 5 лет 3 месяца

Сообщение #196 LUR » 24.08.2018, 15:21

MC Web писал(а):при переключении панелей
переключении где? в каком сплиттере?
LUR M
Автор темы, Модератор
Аватара
Возраст: 36
Откуда: Минск
Репутация: 229
С нами: 5 лет 11 месяцев

Сообщение #197 MC Web » 24.08.2018, 15:27

LUR, у меня все на foo_uie_panel_splitter и foo_uie_wsh_panel_mod, как в "стандартной" DarkOne v.3.0 и DarkOne v.4.0.
MC Web
Мастер
Аватара
Репутация: 146
С нами: 5 лет 3 месяца

Сообщение #198 zeremy » 24.08.2018, 15:46

Setting SupportPseudoTransparency to true reduces the flickering
zeremy
Новичок
Репутация: 20
С нами: 2 года 11 месяцев

Сообщение #199 macarych » 24.08.2018, 17:54

MC Web писал(а):У себя заметил такое наблюдается при переключении панелей и работающем foo_youtube (его окно встроено в панель обложек). Если в окне foo_youtube отключена прозрачность, то происходит "моргание".
Я извиняюсь, конечно PSS сюда никак не относится, но в нем такое наблюдается если основа "закрашена" в скрипте, а в соответствующем чекбоксе - кастом бэкграунд колор, в собственных настройках не отмечено. Может в эту сторону поглядеть? Ну чисто такое, ламерское предположение, еще раз извиняюсь)
macarych M
Гуру
Аватара
Репутация: 329
С нами: 9 лет 10 месяцев

Сообщение #200 LUR » 24.08.2018, 17:56

macarych писал(а):Ну чисто такое, ламерское предположение, еще раз извиняюсь)
Отнюдь не ламерское.

zeremy писал(а):Setting SupportPseudoTransparency to true reduces the flickering
Оно объяснимо, но как совет для избавления от эффекта мерцания плохой. Снижает общую производительность

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

Добавлено спустя 48 минут 42 секунды:
Эксперименты пока удачные, сейчас выкачу версию, будем тестировать.
LUR M
Автор темы, Модератор
Аватара
Возраст: 36
Откуда: Минск
Репутация: 229
С нами: 5 лет 11 месяцев

Пред.След.

Вернуться в Плагины

Кто сейчас на форуме (по активности за 10 минут)

Сейчас этот раздел просматривают: 1 гость