umSlider 1.2
About:
Изначально 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