Инструменты пользователя

Инструменты сайта


lm2:ce:s_config

Главный конфигурационный файл

Файл с общими настройками платформы, путями к файлам, плагинам и пр. По умолчанию config.xml, если в качестве параметра при запуске не указан другой файл (этот функционал позволяет в одном проекте иметь разные уровни или занятия).

Структура файла

i_s_config.jpg

Описание атрибутов / свойств элементов

Условные обозначения префиксов в квадратных скобках можно посмотреть в статье «Условные обозначения при описании атрибутов / свойств».

root - корневой элемент, не имеет свойств

root/System - элемент, свойства которого являются общими настройками платформы. Описание свойств:

ПрефиксСвойствоОписание
[I STRING=«log.txt»]LogNameНазвание лог-файла
[I STRING]ImagesPathПуть до директории с рендерами
[I STRING]ConfigsPathПуть до директории с конфигурационными файлами и lua-скриптами
[I STRING=«licence.key» RPI]KeyFileИмя key-файла с лицензией
[I BOOL=«false» ]LogНеобходимость логирования
[I BOOL=«true»]LogLogicEventsНеобходимость логировать все события
[I BOOL=«true»]LogLuaExecНеобходимость логировать вызов обработчиков событий
[I STRING FILE]LanguageТекущий язык
[I INT=«60» EXP]FramerateLimitВерхний предел частоты кадров
(0 - не обрезать)
[I BOOL=«false» EXP]VSyncВключить/выключить вертикальную синхронизацию
[I BOOL=«false»]TrackMouseНеобходимость генерировать события при перемещении мыши
[I BOOL=«false»]ShowFPSНеобходимость показывать частоту и количество кадров
[I BOOL=«true»]TextureRenderНеобходимость отрисовки панелей в текстуру
[I BOOL=«true»]SmoothTexturesНеобходимость глаживать текстуры при масштабировании
[I BOOL=«false» WIN]CloseConsoleНеобходимость закрывать консольное окно при старте приложения
[I BOOL=«false»]ClearLogНеобходимость очищать лог-файл при старте

root/VM - логическая машина, родительский элемент для окон. Может быть несколько логических машин со своими окнами.Создание нескольких машин диктуется логикой задачи: различные по своей логике подзадачи можно разделить по логическим машинам. Разные логические машины могут использовать как одинаковые модули lua, так и разные. Работать на разных логических машинах можно независимо и одновременно. Описание свойств логической машины машины:

ПрефиксСвойствоОписание
[I STRING ID]IDУникальный идентификатор логической машины
[I STRING]VisualНазвание конфигурационного файла с описанием панелей
[I STRING]StartupLayoutНазвание конфигурационного файла с описанием окон
[I STRING]StartupLogicназвания первого файла с lua-кодом, который запустится при инициализации платформы

root/VM/Plugin - элемент, свойства которого подключают к платформе плагин. Плагины расширяют функционал, подробнее о плагинах см. статью «Плагины и их разработка». О встроенные плагинах см. «Встроенные плагины». Свойства:

ПрефиксСвойствоОписание
[I STRING ID]IDУникальный идентификатор плагина
[I STRING]TypeТип плагина
Type=«serial» - последовательный порт (COM)
[I STRING]PortCOM-порт
[I STRING]BaudrateСкорость соединения
[I STRING=«8N1»]FormatФормат данных
[I BOOL=«false»]LogНеобходимость логирования
Type=«udp» - UDP-клиент
[I STRING]PortПорт
Type=«tcpclient» - TCP-клиент
[I STRING=«127.0.0.1»]AddrIP-адрес
[I STRING]PortПорт
Type=«tcpserver» - TCP-сервер
[I STRING]PortПорт
Type=«library» - библиотека
[I STRING]NameНазвание файла с расширением

root/Font - элемент, свойства которого описывают подключаемый шрифт. Свойства:

ПрефиксСвойствоОписание
[I STRING ID]IDУникальный идентификатор шрифта
[I STRING]FileNameНазвание файла с расширением

root/Sound - элемент, свойства которого описывают подключаемый звуковой файл. Свойства:

ПрефиксСвойствоОписание
[I STRING ID]IDУникальный идентификатор звукового файла
[I STRING]FileNameНазвание файла с расширением

Пример главного конфигурационного файла:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<root>
  <System 
    Language="ru" 
    ImagesPath="images/" 
    ConfigsPath="configs/" 
    Log="true"/>
  <VM 
    ID="main" 
    Visual="panels.xml" 
    StartupLayout="viewports.xml" 
    StartupLogic="start.lua">
  </VM>
  <Font ID="Default" FileName="fonts/LiberationSerif-Regular.ttf" />
</root>
lm2/ce/s_config.txt · Последнее изменение: 2020/11/30 14:12 (внешнее изменение)