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 КБ) Просмотров: 9111


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
Автор темы, Модератор
Аватара
Возраст: 35
Откуда: Минск
Репутация: 229
С нами: 5 лет 10 месяцев

Сообщение #2 MC Web » 21.03.2018, 12:28

LUR, СПАСИБО ЗА РАБОТУ и новый компонент на основе foo_uie_wsh_panel_mod. :clap: :clap: :clap:

Надеюсь "кастрации", как в похожем компоненте не будет, только добавления? :wink:

Что заметил и пожелания:
1. В режиме редактирования в контекстном меню есть дублирование.
Картинки
Изображение
Изображение
2. Если будет возможность и желание - добавить ШАБЛОНЫ со скриптами различных вариантов построения панелей, кнопок и т.п.

Может и kgena_ua что то напишет для этого компонента...
MC Web
Мастер
Аватара
Репутация: 144
С нами: 5 лет 1 месяц

Сообщение #3 maniac736 » 21.03.2018, 14:18

LUR, это типа смеси Panel Stack Splitter + WSH Panel Mod ?
maniac736 M
Бывалый
Аватара
Возраст: 40
Откуда: Россия Иркутск
Репутация: 4
С нами: 1 год

Сообщение #4 LUR » 21.03.2018, 14:28

maniac736 писал(а):это типа смеси Panel Stack Splitter + WSH Panel Mod ?
по смыслу да, только скрипты наконец-то "на одном языке"

Добавлено спустя 2 минуты 31 секунду:
MC Web писал(а):Надеюсь "кастрации", как в похожем компоненте не будет, только добавления?
Кастрации не планируется. Задача была только расширить хост способностью управлять панелями. Вообще была мысль взять за основу JScript Panel (и я уже пробовал его в этом качестве, в последней версии, вроде все работает), но вижу много недовольных им. Может быть потом.
MC Web писал(а):В режиме редактирования в контекстном меню есть дублирование.
Это не дублирование. Если присмотритесь, то там команды "Добавить панель" для разных сплиттеров.
LUR M
Автор темы, Модератор
Аватара
Возраст: 35
Откуда: Минск
Репутация: 229
С нами: 5 лет 10 месяцев

Сообщение #5 AHAPXICT » 21.03.2018, 15:22

LUR, приветствую. Ещё не протестировал, надеюсь завтра. Если не сложно закиньте файл конфигурации с готовым интерфейсом (любым для примера), это будет лучшей инструкцией.
Media Library it's bad - explorer it's good!
AHAPXICT M
Мастер
Аватара
Возраст: 47
Откуда: Киев
Репутация: 164
С нами: 4 года 11 месяцев

Сообщение #6 LUR » 21.03.2018, 16:15

AHAPXICT писал(а):Если не сложно закиньте файл конфигурации с готовым интерфейсом
Может позже. Сейчас переношу свою сборку на этот плагин, заодно тестирую удобство использования. Но в моей сборке все позиции просчитаны и известны, а тут я хотел набросать тестовый пример и заметил, что если делать сборку с нуля, то было бы удобно, если бы окна могли "прилипать" к краям и друг к другу, сегодня выкачу обновление наверное.
LUR M
Автор темы, Модератор
Аватара
Возраст: 35
Откуда: Минск
Репутация: 229
С нами: 5 лет 10 месяцев

Сообщение #7 MC Web » 21.03.2018, 16:29

LUR писал(а):если бы окна могли "прилипать" к краям и друг к другу
Как в foo_dockable_panels, тогда может будет возможность размещать / добавлять панели и снаружи окна.
Тогда будет замена и этому компоненту.
MC Web
Мастер
Аватара
Репутация: 144
С нами: 5 лет 1 месяц

Сообщение #8 LUR » 21.03.2018, 16:36

MC Web писал(а):Как в foo_dockable_panels, тогда может будет возможность размещать / добавлять панели и снаружи окна.
Тогда будет замена и этому компоненту.
Прикольно, не знал о существовании этого плагина. Нет, внешних окон пока не планируется, может в будущем посмотрю, возможно ли это в рамках проекта.
LUR M
Автор темы, Модератор
Аватара
Возраст: 35
Откуда: Минск
Репутация: 229
С нами: 5 лет 10 месяцев

Сообщение #9 maniac736 » 21.03.2018, 16:59

LUR,
Если не сложно закиньте файл конфигурации с готовым интерфейсом (любым для примера), это будет лучшей инструкцией.

+1 Вообще чем больше документации тем лучше. Без опыта подобные вещи даются сильно тяжело
maniac736 M
Бывалый
Аватара
Возраст: 40
Откуда: Россия Иркутск
Репутация: 4
С нами: 1 год

Сообщение #10 Aliado_71 » 21.03.2018, 17:44

Друзья :hi: Приветствую! Есть у кого нибудь набор (коллекция) скриптов под WSH (плейлисты, браузеры, кнопки и тд) а то есть желания поработать с панелью и нет времени на поиски. Если есть поделитесь, а то у меня все под JSPanel. Все не нужно, разобрался, сплиттер работает со всеми панелями.
Aliado_71 M
Мастер
Аватара
Откуда: DON.UA
Репутация: 113
С нами: 3 года 7 месяцев

Сообщение #11 LUR » 21.03.2018, 20:10

Версия 1.0.1 [21.03.2018]
● Добавлено выравнивание/прилипание панелей по краям друг друга, а также к границам окна самого плагина при перетаскивании (есть опция в настройках)
LUR M
Автор темы, Модератор
Аватара
Возраст: 35
Откуда: Минск
Репутация: 229
С нами: 5 лет 10 месяцев

Сообщение #12 zeremy » 21.03.2018, 21:57

Very promising !!! I will try it out, redesign my MPS to this.
Thanks for sharing.
zeremy
Новичок
Репутация: 20
С нами: 2 года 10 месяцев

Сообщение #13 MC Web » 21.03.2018, 22:47

LUR, возник такой вопрос, правда долго не разбирался.
Создаю в окне допустим несколько панелей, пристыковываю их друг к другу и подгоняю их размеры под окно панели JSplitter, т.е. все поле окна JSplitter заполнено добавленными панелями.
А как сделать размеры панелей не фиксированными, а подгоняемыми под размеры JSplitter, например при разворачивании окна плеера?
MC Web
Мастер
Аватара
Репутация: 144
С нами: 5 лет 1 месяц

Сообщение #14 LUR » 21.03.2018, 22:49

MC Web писал(а):как сделать размеры панелей не фиксированными, а подгоняемыми под размеры JSplitter, например при разворачивании окна плеера?
Только программно. Как раз это будет в тестовом примере. Надо просто получить ссылки на панели и в функции on_size вычислить и установить нужные размеры и положение панелей. Понятно, что такой подход "сложнее", чем в том же PSS, но ничего не поделаешь.
LUR M
Автор темы, Модератор
Аватара
Возраст: 35
Откуда: Минск
Репутация: 229
С нами: 5 лет 10 месяцев

Сообщение #15 MC Web » 21.03.2018, 22:57

LUR, жалко...
Было бы замечательно: добавил нужные панели, состыковал их, прилепил к краям окна JSplitter и всё. Размеры меняются автоматически.
MC Web
Мастер
Аватара
Репутация: 144
С нами: 5 лет 1 месяц

Сообщение #16 LUR » 21.03.2018, 23:02

MC Web писал(а):Было бы замечательно
Может быть и было бы, но задача была поставлена сделать гибкий механизм управления панелями. Программной части хватает для любого сценария. То, что вы предлагаете, можно реализовать по-разному и всегда найдется тот, кто посчитает, что панели прилепляются/стыкуются автоматом не так "как хотелось бы". Я вот пока не вижу в голове универсального алгоритма "стыковки", может приведете пример, если у вас есть видение этого?
LUR M
Автор темы, Модератор
Аватара
Возраст: 35
Откуда: Минск
Репутация: 229
С нами: 5 лет 10 месяцев

Сообщение #17 MC Web » 21.03.2018, 23:19

LUR писал(а):если у вас есть видение этого?
Вкратце постарался описать выше. По логике если есть прилипание панелей друг к другу и к границам окна самого плагина, то напрашивается и растягиваемость самих вставленных панелей.
LUR писал(а):всегда найдется тот, кто посчитает, что панели прилепляются/стыкуются автоматом не так "как хотелось бы"
Сделать отключаемой или выбор W и H - авто.
MC Web
Мастер
Аватара
Репутация: 144
С нами: 5 лет 1 месяц

Сообщение #18 LUR » 21.03.2018, 23:23

MC Web писал(а):По логике если есть прилипание панелей друг к другу и к границам окна самого плагина
Вы неверно трактуете логику, по которой эта функциональность была добавлена. Это просто для удобства выравнивания панелей вручную. Они не прилипают в прямом смысле, и никакого автоматического размещения панелей на данный момент нет. Для автоматического размещения панелей существуют другие сплиттеры, если на то пошло.
MC Web писал(а):Вкратце постарался описать выше
Это не описание. Приведите конкретный пример, вот прямо ваш, со скриншотом.
LUR M
Автор темы, Модератор
Аватара
Возраст: 35
Откуда: Минск
Репутация: 229
С нами: 5 лет 10 месяцев

Сообщение #19 MC Web » 21.03.2018, 23:34

LUR писал(а):Приведите конкретный пример, вот прямо ваш, со скриншотом.
Подогнал панели для заполнения окна JSplitter
Изображение
И результат разворачивания окна
Изображение
MC Web
Мастер
Аватара
Репутация: 144
С нами: 5 лет 1 месяц

Сообщение #20 LUR » 21.03.2018, 23:37

MC Web, понятно, а как растягивать панели по ширине? Пропорционально? А если надо чтобы одна из панелей не меняла свою ширину?

Добавлено спустя 1 минуту:
Кстати функционал по выравниванию сейчас кривой при изменении размеров панелей, а точнее не работает, я это сейчас допиливаю.
LUR M
Автор темы, Модератор
Аватара
Возраст: 35
Откуда: Минск
Репутация: 229
С нами: 5 лет 10 месяцев

След.

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