VCLua версия 1.0 для графического интерфейса (GUI) в QUIK

Страницы: 1
RSS
VCLua версия 1.0 для графического интерфейса (GUI) в QUIK
 
Сразу предупрежу, использовать GUI в QUIK через сторонние библиотеки -- это не для нубов  :wink:
Откуда качать, как устанавливать и примеры кода -- в следующих двух сообщениях.


VCLua - это название графической библиотеки для Lua.

У неё есть несколько версий и они все между собой не совместимы (то есть код на Lua, годящийся для создания GUI с использованием одной из версий VCLua типа 0.5, 0.6.2, 0.9.2 и 1.0, не будет работать с другой версией VCLua). Причины этого среди прочего в том, что разные версии VCLua используют внутри разные версии LCL - графической библиотеки для Free Pascal.

Я значительно расширил VCLua 0.9.2, почти полностью переписав, и зарелизил версию 1.0.0, использующую LCL 3.2. Общие принципы программирования остались те же.

Последние полгода она стабильно работает на QUIK 11 и 12 под Lua 5.4.

Я использую для рисования стаканов



и управления скриптом




Доступна очень подробная документация, но она на английском и про добавление GUI в отдельностоящий скрипт на Lua, про QUIK там ни слова.

Есть графическая утилита для рисования формы vt-form, которую потом можно сохранить в json и использовать (в т.ч. менять) в своих скриптах.

Здесь я попытаюсь дополнительно задокументировать на русском то, что важно для программирования GUI через VCLua 1.0 для QUIK.

  1. Библиотека основана на визуальных контролах LCL 3.2, поэтому всю документацию этих контролов следует искать в документации к LCL (для более новой версии, чем 3.2), а не в документации к VCLua. Однако то, какие из этих контролов доступны, и какие их поля и методы доступны, как их вызывать из Lua, следует искать в class reference (нажмите Download raw file) к VCLua. Как контролы выглядят и что делают их поля, можно вживую увидеть или в vt-form, или установив Lazarus, или почитав вики по free pascal
  2. LCL уже давно использует кодировку символов UTF8, в отличие от ранних версий VCLua и в отличие от QUIK, который до сих пор на 1251. Поэтому, чтобы видеть русские символы в VCLua, нужно конвертировать из квиковской 1251 в UTF8 с помощью функции VCL.UTF8. Обратно через VCL.WinCP, что нужно, например, для сохранения файлов, путь к которым получен из диалога VCLua.
  3. Если у вас несколько скриптов будут использовать VCLua, то лучше использовать разные файлы core.dll. В противном случае после закрытия одного из скриптов вы не сможете его запустить второй раз, пока не закроете все остальные скрипты (и тем самым не выгрузите библиотеку core.dll из памяти). Также при использовании одного файла core.dll есть ограничение на то, что главные формы разных скриптов должны иметь разные названия (у всех компонентов LCL есть внутренние названия).
  4. LCL является однопоточной библиотекой, а скрипты в квике как минимум двухпоточные. Поэтому, чтобы избежать падений VCLua, а вместе с ней и квика, следует обновлять GUI только из того же потока, где была запущена основная форма. Начиная с версии VCLua 1.0 стало возможным запускать GUI из потока квика main вместо главного потока. Я делаю только так, вариант со стартом в главном потоке квика не тестирую. В частности, я не пытался стартовать GUI из кода индикатора, но это возможно.
  5. Необдуманная установка обработчиков событий может привести к утечкам памяти и падениям скрипта, особенно если устанавливать их из разных потоков.
  6. В документации большой раздел посвящён тому, как обрабатывать ошибки при использовании библиотеки и почему для этого нельзя использовать GUI самой библиотеки. Для квика я во всех скриптах использую один и тот же код как в примере стакана ниже.
  7. Размер dll 6.7 мегабайт, все LCL dll большие. Даже если вы выкинете из библиотеки те контролы, которые вы не используете, и перекомпилируете, сильно меньше она не станет.
 
Скачивание

Я настоятельно не рекомендую пользоваться Lua 5.3 в квике для скриптов, которые используют много объектов, созданных в DLL, поэтому публично выкладываю пока что только версию для 5.4.
Качать её на данный момент можно тут (Download raw file) . На sourceforge пока что немного более старая версия, хоть и тоже 1.0.
Документация к библиотеке см. выше. Можно скачать class reference.
Скачать vt-form можно тут (Download raw file)

Установка VCLua 1.0

Рекомендуемый вариант -- установка для каждого скрипта отдельно.
  1. В папке со скриптом, откуда будет запускаться единственный использующий VCLua 1.0 скрипт, создайте иерархию папок 5.4/vcl и положите внутрь неё файл core.dll.
  2. В файле скрипта первой строкой добавьте
Код
package.cpath=getScriptPath()..'/'.._VERSION:sub(5)..'/?.dll;'..package.cpath
Пример использования в следующем сообщении.

Альтернативный вариант, годится, если у вас только один скрипт будет использовать VCLua 1.0, или все ваши гуи скрипты уже отлажены и не ломаются.
  1. Создайте скрипт со строкой "message(package.cpath, 1)" и запустите его в квике.
  2. В окне сообщений появится строка, по которой можно понять, куда можно положить vcl\core.dll: в любую папку, предшествующую знаку вопроса.
  3. Например, при строке "C:\BCS_Work\QUIK_BCS\?.dll;C:\BCS_Work\QUIK_BCS\. .\lib\lua\5.4\?.dll;C:\BCS_Work\QUIK_BCS\loadall.dll;.\?.dll" можно использовать папки C:\BCS_Work\QUIK_BCS, C:\BCS_Work\QUIK_BCS\. .\lib\lua\5.4 (я использую эту) и текущую папку скрипта (.).
  4. В выбранной папке создаёте папку vcl и кладёте туда core.dll.
Пример использования в следующем сообщении.

Установка vt-form (0.9.2).

  1. Распакуйте архив vt-form.zip в отдельную папку
  2. Сделайте доступным для этой папки core.dll одним из двух вариантов выше.
  3. Добавьте main.lua из той папки в квик и запустите в Lua 5.4.
Вообще говоря, это обычный Lua скрипт, не имеющий связи с квиком, поэтому запускать его можно отдельно, если стоит интерпретатор Lua, главное установить core.dll так, чтобы скрипт её видел.
После этого можно в командной строке сделать так (если архив распакован в f:\Work\Dev\vt-form\vt-form\src):
Код
f:\Work\Dev\vt-form\vt-form\src>c:\Work\Tools\qlua\bin\lua54.exe main.lua

Если нужно использовать в своих скриптах json, полученный из vt-form, нужно глобально установить в квик Файлы copy.lua, json.lua, и loader.lua:
  1. Создайте скрипт со строкой "message(package.path, 1)" и запустите его в квике.
  2. В окне сообщений появится строка, по которой можно понять, куда можно положить эти три файла: в любую папку, предшествующую знаку вопроса.
  3. Например, при строке "C:\BCS_Work\QUIK_BCS\lua\?.lua;C:\BCS_Work\QUIK_BCS\lua\?\init.lua;C:\BCS_Work\QUIK_BCS\?.lua;C:\BCS_Work\QUIK_BCS\?\init.lua;C:\BCS_Work\QUIK_BCS\. .\share\lua\5.4\?.lua;C:\BCS_Work\QUIK_BCS\. .\share\lua\5.4\?\init.lua;.\?.lua;.\?\init.lua" их можно положить в папки C:\BCS_Work\QUIK_BCS\lua, C:\BCS_Work\QUIK_BCS, C:\BCS_Work\QUIK_BCS\. .\share\lua\5.4 (у меня они тут) или в текущю папку скрипта (.).
Пример использования в следующем сообщении.
 
Мои скрипты имеют общую структуру:
Код
-- если VCLua установлена локально для скрипта!
package.cpath=getScriptPath()..'/'.._VERSION:sub(5)..'/?.dll;'..package.cpath
VCL = require "vcl.core"
local app = VCL.Application()
local ProcessMessages = app.ProcessMessages
-- необходимая магическая строка, без которой ничего работать не будет
app:Initialize()
-- если внутри VCLua или в ваших колбэках случится ошибка, вызовется эта функция
local function print_error(s)
  message(s,  3)
  PrintDbgStr(s..'\n'..debug.traceback(nil,2))
end
VCL.SetErrorReporter(print_error)

U = VCL.UTF8
W = VCL.WinCP

-- никакого обращения к VCLua не должно быть в колбэках QUIK, если сделали form:Show() в main
function OnStop()
  is_run = false
end

local function CreateFormStaticPart()
-- статическая часть формы, вручную или через json
end

local function CreateForm()
  CreateFormStaticPart()
  form.OnCl ose = function()
    OnStop()  -- можно убрать и тогда форма будет сворачиваться на закрытии
    return 'caMinimize'
  end
  -- динамическая часть формы, обработчики сообщений
  ...
  --
  form:Show()
end

local function CloseForm(form, method)
  -- в середине работы можно вызывать Hide вместо Free; после Hide можно сделать form:Show(), чтобы форма снова стала видимой
  form[method](form)
end

local function CloseAllForms()
  CloseForm(form_1, 'Free')
  ...
  CloseForm(form_n, 'Free')
end

function main()
  -- создаём форму в потоке main, а не в основном потоке квика
  CreateForm()
  while is_run do
    -- обновляем GUI, делаем свои дела
    ...
    -- отрисовываем обновление стакана и обрабатываем события
    ProcessMessages(app)
    -- для простоты спим, в реальном скрипте используются сообщения и MsgWaitForMultipleObjectsEx
    sleep(1)
  end

  CloseAllForms()
  -- обрабатываем события закрытия форм
  app:ProcessMessages()
end


Пример стакана с программированием формы вручную, без json
Скрытый текст

Пример стакана с загружаемой и обновляемой через json формой
json:
Скрытый текст
Скрипт
Скрытый текст

Файлы на диске расположены так:
Код
vcl-quotes\5.3\vcl\core.dll -- это мне для тестов, у вас нету
vcl-quotes\5.4\vcl\core.dll
vcl-quotes\CRM5.json -- эти два файла создаются при исполнении quote-example-json.lua, в зависимости от настроек внутри
vcl-quotes\MXM5.json
vcl-quotes\quote-example.json
vcl-quotes\quote-example.lua
vcl-quotes\quote-example-json.lua
Все эти json можно загрузить в vt-form и поковыряться.
Страницы: 1
Читают тему
Наверх