Это старая версия документа!
Платформа Lamda-Mu 2 позволяет использовать системный таймер. Для запуска таймера используется функция sys.StartTimer() (подробнее см. статью «Библиотека функций»)
Пример:
запуск таймера
sys.StartTimer('refresh')
обработчик события остановки таймера
function H_refresh(ev) -- some code end AddEventHandler('timer.refresh.finished.', 'H_refresh')
Остановка таймера (событие остановки не наступает)
sys.StopTimer('refresh')
Создадим проект, который будет работать с системным таймером. Исполняемые модули находятся в репозитарии lm2.engine.ce. Файлы для проекта находятся в репозитарии lm2.examples. Необходимый минимум доступен по ссылкам:
Создайте папку empty_project. Это корень проекта. Скопируйте в корень исполняемый модуль (исполняемый файл .exe и динамические библиотеки .dll необходимые для старта платформы в случае Windows или скомпилированный бинарный файл в случаях систем на основе ядра Linux).
Создайте в корне папку images. Это каталог для хранения рендеров. Далее мы укажем к нему путь в главном конфигурационном файле. Скопируйте в этот каталог файлы .png.
Создайте в корне папку configs. Это каталог для хранения конфигурационных файлов (кроме главного конфигурационного файла, он должен быть в корне проекта).
Создайте в корне папку fonts. Это каталог для используемых шрифтов. Далее мы подключим шрифты в главном конфигурационном файле. Скопируйте в этот каталог файл LiberationSerif-Regular.ttf.
Главный конфигурационный файл
Основная статья «Главный конфигурационный файл». Создайте в корне проекта файл config.xml. Платформа по умолчанию к нему обратиться. Никаких дополнительных действий не требуется. Файл должен содержать следующий код:
<!-- объявление xml --> <?xml version="1.0" encoding="utf-8" standalone="yes"?> <!-- корневой элемент --> <root> <!-- элемент общих настроек, задаются следующие: язык, путь к рендерам, путь к конфигурационным файлам, флаг логирования --> <System Language="ru" ImagesPath="images/" ConfigsPath="configs/" Log="true"/> <!-- элемент логической машины, задаются следующие свойства: уникальный идентификатор, файл описание панелей, файл конфигурации окон, первый файл c lua-кодом для запуска --> <VM ID="main" Visual="panels.xml" StartupLayout="viewports.xml" StartupLogic="start.lua"> </VM> <!-- элемент шрифта, задаются следующие свойства: уникальный идентификатор, полный путь к файлу --> <Font ID="Default" FileName="fonts/LiberationSerif-Regular.ttf" /> </root>
Файл конфигурации окон
Основная статья «Конфигурация окон». В папку configs создайте viewports.xml. Название файла должно совпадать с названием, указанным в главном конфигурационном файле. Определите окно на первом мониторе (если у вас несколько мониторов) с разрешением 800×480. Файл должен содержать следующий код:
<!-- объявление xml --> <?xml version="1.0" encoding="utf-8" standalone="yes"?> <!-- корневой элемент, задается следующее свойство: разрешение --> <root MonitorWidth="800" MonitorHeight="480"> <!-- элемент вьюпорт, задаются следующие свойства: положение на мониторе, уникальный идентификатор --> <ViewPort Monitor="0,0" ID="main_viewport" /> </root>
Файл описания панелей
Основная статья «Описание панелей». Создайте в папке configs файл panels.xml. Название файла должно совпадать с названием, указанным в главном конфигурационном файле. Необходимо подключить библиотеку элементов, файл со строковыми данными, описать панель с фоном, двумя кнопками, логотипом и двумя элементами содержащими спрайтшиты лампы и цифр таймера. Файл должен содержать следующий код:
<!-- объявление xml --> <?xml version="1.0" encoding="utf-8" standalone="yes"?> <!-- корневой элемент --> <root> <!-- элемент подключающий строковые данные --> <Text FileName="text.xml"/> <!-- элемент подключающий библиотеку элементов --> <Library FileName="templates.xml"/> <!-- элемент родитель панелей --> <GUI> <!-- элемент описывающий панель, задается следующее свойство: размеры вьюпорта, на который будет выводиться панель --> <Panel ID="main" VPWidth="800" VPHeight="480"> <!-- элемент на панели, задается следующее свойство: уникальный идентификатор--> <Entry ID="bg" TypeID="bg"/> <!-- элемент на панели, задается следующее свойство: уникальный идентификатор, положение на панели--> <Entry ID="btExit" TypeID="button" Top="300" Left="300"/> <!-- элемент на панели, задается следующее свойство: уникальный идентификатор, положение на панели--> <Entry ID="btStartStop" TypeID="button" Top="300" Left="520"> <!-- меняется свойство, описанное в библиотеке элементов (она уже загружена) --> <PropertySet Property="text.Text" ValueTID="txtStart"/> </Entry> <!-- элемент на панели, задаются следующие свойства: уникальный идентификатор, положение на панели --> <Entry ID="Logo" TypeID="logo" Top="60" Left="60"/> <!-- элемент на панели, задаются следующие свойства: уникальный идентификатор, положение на панели --> <Entry ID="Clock" TypeID="clock" Top="60" Left="220" /> <!-- элемент на панели, задаются следующие свойства: уникальный идентификатор, положение на панели --> <Entry ID="Lamp" TypeID="lamp" Top="60" Left="555" /> </Panel> </GUI> </root>
Функции для работы с таймером находятся в файле timer.lua:
-- в Clock хранится текущее время в виде секунд - seconds и минут - minutes, а также интервал таймера в миллисекундах - interval и статус таймера - on = false|true Clock = {seconds = 0; -- секунды minutes = 0; -- минуты interval = 1000; -- интервал обновления on = false; -- статус таймера } -- При нажатии на кнопку Старт - включается таймеры tick и lamp и текст кнопки становится Стоп -- При нажатии на кнопку Стоп - таймер tick выключается и текст кнопки становится Старт function H_startstoptimer(ev) if Clock.on == false then Clock.on = true SetText('main.btStartStop.text.Text', 'txtStop') -- Включаем таймер на Clock.interval с цикличным срабатыванием (once = false) sys.StartTimer("tick", Clock.interval, false) -- Включаем лампу и одноразовый таймер на 5с Set('main.Lamp.state.', 'on') sys.StartTimer("lamp", 5000) else Clock.on = false SetText('main.btStartStop.text.Text', 'txtStart') -- Останавливаем цикличный таймер sys.StopTimer("tick") end end AddEventHandler('main.btStartStop.Mouse.LeftPress', 'H_startstoptimer') -- По таймеру tick обновляются часы function H_refresh(ev) Clock.seconds = Clock.seconds + Clock.interval/1000 if Clock.seconds > 60 then Clock.minutes = Clock.minutes + 1 Clock.seconds = Clock.seconds - 60 end if Clock.minutes > 60 then Clock.minutes = Clock.minutes - 60 end -- Устанавливаем значение цифровых часов Set("main.Clock.value.", string.format("%02d%02d", Clock.minutes, math.floor(Clock.seconds))) end AddEventHandler('timer.tick.finished.', 'H_refresh') -- По таймеру lamp выключается лампа function H_lamp(ev) Set('main.Lamp.state.', 'off') end AddEventHandler('timer.lamp.finished.', 'H_lamp')