umSlider 1.2
Copyright © 2004-2006 Seg@, Brian, thegeek. Распространяется под лицензей GNU GPL2.
Изначально umSlider.dll был копией модуля LSSlider от blkhawk, переписанного на Visual C++ для того, чтобы
исправить ошибку с возрастающей нагрузкой на процессор в WinXP.
Для тех, кто не знает, LSSlider позволяет управлять Winamp'ом или звуковой картой с помощью настраиваемых ползунков.
Последняя версия umSlider поддерживает библиотеку xPaintClass от Andymon'а, в связи с чем потеряв
совместимость с LSSlider и, тем самым, превратившись в отдельный модуль.
Скопируйте из архива файл umSlider-1.2.dll в папку по Вашему выбору, например
C:\LiteStep\modules\,
а затем добавьте следующую строчку в step.rc
LoadModule "C:\LiteStep\modules\umSlider-1.2.dll"
Если вы пользуетесь OTS2-совместимым дистрибутивом, таким как LiteStep Installer от Omar'а,
EZ2Install от AngelKnight или Dist.ru от Joshhh, следует использовать псевдооператор *NetLoadModule:
*NetLoadModule umSlider-1.2
umSlider может управлять несколькими ползунками, поэтому первым шагом вы должны определить имена этих ползунков.
Ползунки будут настраиваться и управляться с помощью !команд именно по именам.
Вот так добавляется новый ползунок:
*umSlider [имя-ползунка]
а настройки ползунков имеют вид:
[имя-ползунка][параметр] [значение-параметра]
Например:
*umSlider Track
TrackX 100
Примеры файлов лежат в папке 'Sample Config' архива модуля
*NetLoadModule umSlider-1.2
*umSlider Track
TrackMode ampvolume
TrackX 100
TrackY 200
TrackWidth 100
TrackHeight 10
TrackVisible true
TrackAlwaysOnTop false
TrackHandleOffset 0
TrackInverted true
TrackDirection horizontal
TrackTip "Amp"
TrackPaintingMode .image
TrackTrueTransparency false
TrackAlphaTransparency 0
TrackImage slider_amp_pos.png
TrackImageMode stretch
TrackHandlePaintingMode .image
TrackHandleTrueTransparency false
TrackHandleImage slider.png
TrackHandleImageMode stretch
TrackHandleWidth 5
TrackHandleHeight 10
Обратите внимание, что параметры начинаются с имени ползунка, указанном в строчке
*umSlider(имя-ползунка)Tip [string]
Всплывающая подсказка.
(имя-ползунка)X [coordinate]
Горизонтальная координата левого верхнего угла ползунка.
Отрицательное значение отсчитывается от правого края экрана.
Если после числа стоит значок 'c' (centred) - отсчет идет от центра экрана.
(имя-ползунка)Y [coordinate]
Вертикальная координата левого верхнего угла ползунка.
Отрицательное значение отсчитывается от нижнего края экрана.
Если после числа стоит значок 'c' (centred) - отсчет идет от центра экрана.
(имя-ползунка)Width [integer]
Ширина ползунка.
(имя-ползунка)Height [integer]
Высота ползунка.
(имя-ползунка)HandleWidth [integer]
Ширина бегунка (ручки).
(имя-ползунка)HandleHeight [integer]
Высота бегунка (ручки).
(имя-ползунка)Offset [integer]
Смещение бегунка (ручки) от края ползунка.
(имя-ползунка)Texture
Текстура, рисуемая в качестве подложки. Порядок настройки текстуры описан в xPaintClass Wiki.
Префикс (prefix) текстуры - (имя-ползунка)
(имя-ползунка)HandleTexture
Текстура бегунка (ручки). Порядок настройки текстуры описан в xPaintClass Wiki.
Префикс (prefix) текстуры - (имя-ползунка)Handle
(имя-ползунка)Direction [string]
Направление движения бегунка: 'vertical' или 'horizontal'.
(имя-ползунка)AlwaysOnTop [false/true]
Установить ползунок поверх всех других окон
(имя-ползунка)Inverted [false/true]
Развернуть направление движения бегунка право<->лево или верх<->вниз
(имя-ползунка)Visible [false/true]
Видимость ползунка
(имя-ползунка)Mode [string]
Режим ползунка: 'volume' - громкость, 'balance' - баланс, 'track' - дорожка, и 'ampvolume' - громкость WinAMP'а.
(имя-ползунка)Channel [integer]
Число от 0 (обычно - общая громкость) до числа каналов, поддерживаемых Вашей звуковой картой.
(имя-ползунка)MixerID [integer]
Номер звуковой карты (по умолчанию 0 - главный микшер).
Обратите внимание, что первый параметр каждой указанной ниже !команды - это имя полузнка.
Пример:
!SliderShow MySlider
!umSliderCreate [string]
Creates a slider with the specified name.
!umSliderDestroy [string]
Destroys a slider with the specified name.
!umSliderHook [string]
!Команда, использующаяся в строке *ModuleHook модуля LsBox и подобных ему.
Параметр - это название ползунка.
Как пользоваться !командой читайте в документации соответствующих модулей, вызывать самому ее бессмысленно.
!umSliderShow [string]
Показать ползунок.
!umSliderHideGroup [string]
Скрыть ползунок.
!umSliderToggle [string]
Если ползунок скрыт - показать, если показан - скрыть.
!umSliderMove [string] [coordinate] [coordinate]
Переместить ползунок в указанную точку.
!umSliderMoveBy [string] [integer] [integer]
Сдвинуть ползунок на указанное число пикселей по горизонтали и по вертикали.
!umSliderResize [string] [integer] [integer]
Новые размеры ползунка (ширина и высота).
!umSliderResizeBy [string] [integer] [integer]
Изменить ширину и высоту ползунка на указанное число пикселей.
!umSliderReposition [string] [coordinate] [coordinate] [integer] [integer]
Новое положение ползунка (X и Y) и новые размеры (ширина и высота)
!umSliderRepositionBy [string] [integer] [integer] [integer] [integer]
Изменить положение ползунка и его размеры на указанное число пикселей
Указанные ниже !команды используются для управления звуком (честно скоммунизжены из V_Bang.dll).
Первый параметр каждой !команды - номер микшера (0 - главный микшер), второй - номер звукового канала (0 - обычно общий канал).
umSliderVolumeStep [integer]
Знание по умолчанию для !команд управления громкостью !umSliderVolumeUp и !umSliderVolumeDown
umSliderBalanceStep [integer]
Значение по умолчанию для !команд управления балансом !umSliderBalanceLeft и !umSliderBalanceRight
!umSliderVolumeUp [integer] [integer] [integer]
Увеличить громкость микшера (первый параметр) канала (второй параметр) на указанный процент (третий параметр).
Если второй параметр пропущен, используется значение umSliderVolumeStep.
!umSliderVolumeDown [integer] [integer] [integer]
Уменьшить громкость микшера (первый параметр) канала (второй параметр) на указанный процент (третий параметр).
Если второй параметр пропущен, используется значение umSliderVolumeStep.
!umSliderMute [integer] [integer]
Заглушить/включить канал.
!umSliderBalanceLeft [integer] [integer] [integer]
Изменить баланс микшера (первый параметр) канала (второй параметр) на указанный процент (третий параметр).
Если второй параметр пропущен, используется значение umSliderBalanceStep.
!umSliderBalanceRight [integer] [integer] [integer]
Изменить баланс микшера (первый параметр) канала (второй параметр) на указанный процент (третий параметр).
Если второй параметр пропущен, используется значение umSliderBalanceStep.
!umSliderSetVolume [integer] [integer] [integer]
Установить значение громкости микшера (первый параметр) канала (второй параметр) в процентах от 0 до 100 (третий параметр)
!umSliderSetBalance [integer] [integer] [integer]
Установить значение баланса микшера (первый параметр) канала (второй параметр) в процентах от -100 to 100 (третий параметр)
Версия 1.2, 2007-05-13 (alexV)
ДОБАВЛЕНО: Свойство (slider)MixerID - позволяет контролировать указанный микшер при наличии нескольких звуковых карт
ИЗМЕНЕНО: Банг-команды для управления громкостью, теперь первый параметр - номер микшера
Версия 1.1, 2007-02-23 (thegeek)
ДОБАВЛЕНО: Support for "proper" painting of handle (Handle is now painted directly onto slider, this allows for _all_ xpaintclass effects, such as alpha)
ДОБАВЛЕНО:
!umSliderCreate, !umSliderDestroyMoveBy
ИЗМЕНЕНО: Slider behaviour is now more like lssliderfoo, you can now click anywhere on the slider and then directly continue to drag the handle. Much more intuitive this way.
ИЗМЕНЕНО: HandleOffset works properly now (equal offset on both sides of the list)
ИЗМЕНЕНО: Fixed volume/balance bug where balance would "stray"
ИЗМЕНЕНО: Fixed volume divide by zero bug
ИЗМЕНЕНО: Fixed "disappear on recycle"-bug
Версия 1.0, 2006-12-25 (Seg@)
Обратите внимание, что umSlider нужны библиотеки VC++ 2005 RTL ( есть в .NET Framework 2.0
или доступны отдельно для скачивания по адресу http://miranda.or.at/files/vcredist_x86.exe, околок 2,8 Мб )
ДОБАВЛЕНО: поддержка xPaintClass v1.0
ИЗМЕНЕНО: Версия не является обратно совместимой, поэтому префикс настройки изменен на "umSlider"
ДОБАВЛЕНО:
!umSliderMove, !umSliderMoveBy,
!umSliderResize, !umSliderResizeBy,
!umSliderReposition, !umSliderRepositionBy
ДОБАВЛЕНО: umSliderVolumeStep, umSliderBalanceStep и параметры шага для команд регулировки громкости и баланса
Версия 0.3, 2006-08-16 (Brian)
ИСПРАВЛЕНО: the muting code (was bustigated)
ИЗМЕНЕНО: the volume stepsize from 10 to 1 (not an adjustable step setting yet).
Версия 0.2, 2004-11-13 (Seg@)
I don't think there will be future releases, so it is a first and alone umSlider version.
Имя:
Сергей Гагарин a.k.a.
Seg@
E-Mail :
inform-sega_AT_freemail.ru
ICQ: 162261148
Имя:
Brian Wolven
E-Mail :
bcwolven_AT_hotmail.com
Имя:
Øystein E. Krog a.k.a. thegeek
E-Mail :
okrog_AT_online.no