|
Парсерная русскоязычная ИЛ-платформа.
Расшифровка названия: ТОМ - ''Текстовая Основа Миростроения.''
[[:Категория:Игры на платформе ТОМ|Игры на платформе ТОМ]] (пока одна игра).
Период разработки: 2008-2011гг.
Автор: [[Участник:ASBer|ASBer]]
Последняя версия: [[Медиа:Tom_094.rar|0.9.4.11 бета]], версии [[ТОМ 0.9 бета#Отказ от выпуска версии 1.0|1.0]] не будет.
[http://tom.userforum.ru/ Официальный форум] платформы.
Продолжение разработки: [[ТОМ 2]].
Расшифровка названия: ТОМ - ''Текстовая Основа Миростроения.''
[[:Категория:Игры на TOM|Игры на платформе ТОМ]].
Текущая версия: [[Медиа:ConTOM.rar|0.9.3.1 бета]] (консоль). В состав архива входит демо-игра про мышек.
Автор: [[Участник:ASBer|ASBer]]
Графический интерфейс: [[Медиа:TOMilena.rar|ТОМ+Милена]].
[http://tom.userforum.ru/ Официальный форум] платформы.
Есть набор простых [[Медиа:tom_sample.rar|примеров]] по программированию.
[[Парсер]] изначально ориентирован на русский язык, не имеет ограничений на количество слов в команде, команды описываются с помощью шаблонов. Парсинг управляется функциями-проверками к шаблонам.
===Модульный принцип построения платформы===
==Консольный интерфейс: constom.exe==
Платформа ТОМ строится по модульному принципу и состоит из нескольких частей:
1. Текстовый парсерный движок реализован в виде динамической библиотеки tom.dll
2. Интерфейсная оболочка (Front-end) служит для отображения текста и ввода команд игрока.
3. Начиная с версии 0.9.4.х используются плагины, расширяющие возможности языка ТОМ и обогащающие его мультимедийные возможности.
При желании авторы могут создавать и использовать свои собственные интерфейсы и плагины. API движка открыты.
===Поддержка HTML и прочих тегов===
ТОМ позволяет использовать как HTML разметку, так и любые другие теги. Текст, заключенный в < > прозрачен для ядра ТОМа и может быть обработан интерфейсом при разборе текста перед его выводом.
Вся тяжесть обработки HTML тегов и прочей разметки ложится на front-end.
Полнота поддержки HTML зависит от конкретного интерфейса.
==Версия 0.9.3.1==
[[Медиа:ConTOM.rar|скачать]]
===Консольный интерфейс: constom.exe===
[[Изображение:Constom.GIF]]
Constom поддерживает тег смены цвета шрифта и несколько служебных тегов.
====TOM API 0.9.3.1====
Приложение, основанное на ИФ-движке ТОМ, состоит из 2х частей:
1. Ядро - реализовано в виде динамической библиотеки tom.dll
2. Интерфейсная оболочка (Front-end)
Интерфейс между ядром версии 0.9.3.1 и оболочкой достаточно прост, построен на нескольких функциях ядра. Любой желающий может использовать ядро платформы в своих разработках.
**Возвращает текст, сгенерированный при выполненнии команды.
===ТОМилена===
==Графический интерфейс==
Первым удачным примером интеграции движка ТОМ является платформа [[Милена]].
%<music name="главная тема" event="stop">//Эта строка останавливает воспроизведение музыки с условным именем "главная тема"
==Версия 0.9.4.х==
===Поддержка HTML и прочих тегов===
[[Медиа:Tom_094.rar|скачать]]
Ядро ТОМа позволяет использовать как HTML разметку, так и любые другие теги. Текст, заключенный в < > прозрачен для ядра ТОМа и может быть обработан программой-интерфейсом при разборе текста перед его выводом.
Для версий 0.9.4.х декларируется обратная совместимость* с v.0.9.3.1, что гарантирует возможность проигрывания игр, сделанных для версии 0.9.3.1 и использование разработанных для неё библиотек.
Вся тяжесть обработки HTML тегов и прочей разметки ложится на front-end.
*''*совместимость не полная - возможности, которые никогда не были использованы, в v.0.9.4.х могут отсутствовать.''
Полнота поддержки HTML зависит от конкретного front-end-а.
==Библиотеки==
В [[Медиа:Libs4TOM.rar|пакет библиотек]] входят:
'''В плюсе:'''
'''Стандартная библиотека ТОМ:'''
*новый графический интерфейс и новый механизм взаимодействия движка с интерфейсом;
*модули стандартной библиотеки (каталог ''Libs4TOM\std.lib'');
*основной цикл игры убран внутрь dll и выполняется в отдельном потоке;
*демо для стандартной библиотеки (файл ''Libs4TOM\std_test.tom'');
*регистрация внешних функций, система плагинов;
*автоматизированные тесты модулей стандартной библиотеки (каталог ''Libs4TOM\tests'');
*поддержка музыки и речи вынесена из движка в отдельные плагины;
*портированные на стандартную библиотеку ТОМ игры рТАДС - [[Плащ Тьмы]] и [[Золотой череп]] (файлы ''Cloak_of_Darkness.tom'' и ''GOLDSKLR_std.tom'').
*вычисление выражений непосредственно в командной строке (удобно для отладки);
*тестировать можно на старых играх - мышках и спелеологисте.
===Интерфейс на основе HGE===
[[Изображение:TOMonHGE.JPG]]
Интерфейс реализован на основе полноценного графического движка [http://hge.relishgames.com/overview.html HGE], что в будущем позволяет нарастить графические возможности платформы и использовать различные спецэффекты.
===ТОМ API 0.9.4.х===
ТОМ API состоит из нескольких функций tom.dll:
*'''RegFunction()''' - регистрирует дополнительные внешние функции;
*'''Init()''' - запускает движок;
*'''RunText()''' - выполняет переданный текст, возвращает результат;
*'''Exit()''' - останавливает движок.
Еще есть альтернативные функции, на случай если ваш интерфейс или плагин не использует UNICODE:
*'''RegFunctionANSI()''' - работает аналогично RegFunction();
*'''RunTextANSI()''' - работает аналогично RunText();
====Внешние функции====
ТОМ позволяет подключать неограниченное количество внешних функций, расположенных в интерфейсе или в плагинах и расширяющих стандартный набор функций ТОМа.
После регистрации внешней функции её можно вызвать из командной строки '''>MyFunction Arg''' или из кода игры: '''MyFunction(Arg)'''.
'''Частично портированная библиотека rTADS:'''
*файлы библиотеки rTADS (каталог ''Libs4TOM\rTADS.lib'');
*портированная игра рТАДС - [[Золотой череп]] (файл ''GOLDSKLR_rTADS.tom'').
Консольный плеер '''Constom''' (каталог ''Libs4TOM\Bin'').
Существует 5 специальных внешних функций, необходимых для работы ТОМа:
Утилита для автоматического тестирования '''ТОster''' (каталог ''Libs4TOM\Bin'').
*'''print''' - выводит текст на экран;
*'''input''' - ввод из командной строки;
*'''error''' - выводит информацию об ошибке;
*'''debug''' - выводит отладочную информацию;
*'''speech''' - читает переданный текст голосом.
Обязательными являются только функции print и input.
Эти 5 функций также можно вызывать из командной строки и из кода игры, хотя особого смысла в этом нет - движок сам вызывает их когда это необходимо.
===Плагины===
Библиотека находится в состоянии разработки и периодически обновляется.
Плагины - это специализированные dll.
Имя файла плагина должно соответствовать маске *.plg.dll
Плагины грузятся при старте платформы из папки движка и из подпапки plugins\ в каталоге движка, а также при запуске игры из папки игры и из подпапки plugins\ в каталоге игры.
В момент загрузки плагины регистрируют свои собственные функции, которые расширяют набор стандартных функций ТОМа.
===Стандартная библиотека===
В комплект поставки включены два плагина:
*'''tommci.plg.dll''' обеспечивающий проигрывание музыки;
*'''speech.plg.dll''' обеспечивающий проговаривание выводимого текста.
==Общее для 0.9.x.x==
Совместимость версий делает возможным использование общих библиотек и инструментов.
''(Последние версии стандартной библиотеки могут некорректно работать на платформе v.0.9.3.1, рекомендуется использовать последнюю версию платформы 0.9.4.х)''
===Библиотеки===
В [[Медиа:Libs4TOM.rar|пакет библиотек]] входят:
'''Стандартная библиотека ТОМ:'''
*модули стандартной библиотеки (каталог ''Libs4TOM\std.lib'');
*демо для стандартной библиотеки (файл ''Libs4TOM\std_test.tom'');
*портированные на стандартную библиотеку ТОМ игры рТАДС - [[Плащ тьмы (RTADS)|Плащ Тьмы]] и [[Золотой череп]] (файлы ''Cloak_of_Darkness.tom'' и ''GOLDSKLR_std.tom'').
====Стандартная библиотека====
[[Медиа:Libs4TOM.rar|Стандартная библиотека]] строится по модульному принципу.
К каждому модулю разработан свой тест, демонстрирующий его работу.
*'''Light.tml'''
===Инструменты===
===Порт библиотеки rTADS===
====Генератор словоформ====
пока ограничивается портированием на ТОМ очень простой игры "Золотой череп".
==Инструменты==
===Генератор словоформ===
Удобный [[Медиа:tom_Gener.rar|генератор словоформ]] от Александра:
Текущая версия 0.8.2.158
==Отказ от выпуска версии 1.0==
==План развития платформы==
Текущее направлениеНаправление развития платформы0.9 признано неудачным. Выявленные в ходе бета-тестирования сложность разработки игр, недостаточный уровень поддержки русского языка, и отсутствие авторов, желающих писать на этой платформе, наглядно это подтверждаютподтвердили.
В настоящее время идёт разработка [[ТОМ 2]].
Разработка откатывается обратно в альфу. Принципы работы движка будут серьезно пересмотрены. Постараюсь вложить вВ новую версию вложен весь боевой опыт, приобретенный за время создания и использования платформы, а также новые накопленные идеи, внедрить которые в старую архитектуру первого ТОМа было уже невозможно.
==Changelog==
===Версия v.0.9.4.311 (багфикс)beta===
[[Медиа:Tom_094.rar|лежит здесь]]
Исправлена критическая ошибка. В остальном без изменений.
Новое в версии:
===Версия v.0.9.4.2 dev===
*загрузка/выгрузка плагинов перенесена из движка в интерфейс и доработана;
*плагин '''speech.plg.dll''' (чтение текста голосом) доработан и возвращен в архив;
*плагин '''tommsi.plg.dll''' (воспроизведение музыки и звуков) требует доработки и временно исключен из архива;
*исправлены пути для загрузки фоновых картинок - теперь пути берутся относительно каталога игры;
*в тэге '''<body>''' теперь работает параметр '''bgcolor=''' пример: '''<body background=bg.jpg bgcolor=red>'''
*можно задавать произвольные цвета текста и фона с помощью шестнадцатеричных чисел в формате RGB; пример: '''<body text=F94500>'''
*небольшое улучшение парсера: при неоднозначности между объектом и локацией предпочтение отдаётся объекту.
===Версия v.0.9.4.10 beta===
*ударение в лексемах более не влияет на парсер;
*в тэге <body> теперь работают стандартные параметры "text", "link", "topmargin", "bottommargin", "leftmargin", "rightmargin"
например:
%<body background=foto\bgStart.jpg text=aqua leftmargin=100 rightmargin=80 topmargin=50>
еще пока не сделано:
*не исправлена ошибка, возникающая при выгрузке плагинов.
*пути файлов в тегах берутся относительно папки движка, а не игры.
===Версия v.0.9.4.9 beta (багфикс)===
*исправлено сохранение игр;
*добавлен выбор значения свойств по локации (предмет_по_месту);
*интерфейс переписан с учётом потокобезопасности.
*речевой плагин временно убран из архива - не корректно завершает работу.
===Версия v.0.9.4.8 beta===
*финальная версия в этом направлении.
'''Версия v.0.9.4.7 альфа'''
*Сделана загрузка плагинов.
*Добавлена интерфейсная функция pause() / пауза(). Рекомендуется использовать вместо тэга <pause>.
*Доработана обработка ошибки с незакрытыми скобками в коде игры.
'''Версия v.0.9.4.6 альфа'''
*доделана нормализация знаков препинания;
*исправлены некоторые ошибки.
Версии присвоен статус "альфа". Всё основное, что планировалось в ветке 0.9.4.х, сделано.
Осталось доделать небольшие фичи, после чего эта версия перейдет в "бету" и будет рекомендована как основная официальная версия.
'''Версия v.0.9.4.5 (багфикс)'''
*Исправлен ряд ошибок, критичных и не очень. Спасибо '''Александру'''.
'''Версия v.0.9.4.4 dev'''
*Добавлена speech.dll для чтения текста.
'''Версия v.0.9.4.3 (багфикс)'''
*Исправлена критическая ошибка. В остальном без изменений.
'''Версия v.0.9.4.2 dev'''
*Доделана система ввода-вывода (за исключением голоса и коррекции знаков препинания)
*Исправлены старые ошибки
*Добавлены новые ошибки
===Версия v.0.9.4.1 dev===
'''Версия v.0.9.4.1 dev'''
*Исправлено несколько мелких ошибок.
*Воспроизведение музыки приведено к полной совместимости с версией 0.9.3.1
===Версия v.0.9.4.0 dev===
'''Версия v.0.9.4.0 dev'''
В плюсе:
[[ТОМ: Changelog|Архив по старым версиям]]
'''Версия v.0.9.3.0 бета'''
*Добавлено чтение текста игры через MS Speech API 5.1 (синтезированный голос).
*Добавлены новые команды для управления звуком на уровне платформы:
**включить звук/музыку/голос;
**выключить звук/музыку/голос.
( для включения/выключения музыки используется новый обработчик '''OnMusic()''').
*Исправлены найденные ошибки.
'''Версия v.0.9.2.11 бета'''
Основые изменения касаются работы с меню.
*строки меню теперь формируются динамически;
*меню может быть сформировано и вызвано для любого объекта (раньше было привязано к локации);
*добавлена сортировка строк меню (раньше было по алфавиту);
*добавлена автонумерация строк меню;
*выбор в меню возможен по номеру строки или по началу любого слова в меню.
'''Версия v.0.9.2.10 бета'''
*исправлены мелкие ошибки
'''Версия v.0.9.2.9 бета'''
*добавлены функции преобразования типов object(), string(), number(), bool();
*добавлены функции преобразования строк left(), right(), mid(), lower(), upper(), trim();
*исправлены найденные ошибки.
'''Версия v.0.9.2.8 бета'''
*добавлена возможность вставки в код игры команд на естественном языке.
*добавлена конструкция для описания предлогов.
*доработано сохранение игр.
*исправлены найденные ошибки.
'''Версия v.0.9.2.7 бета'''
*добавлены операторы ++; --; &&; и ||; (синтаксический сахар).
*исправлен парсинг составных команд для НПС.
'''Версия v.0.9.2.6 бета'''
*Добавлена функция для проигрывания звуков - media()
*В демоигру добавлено много новых звуков. Архив с игрой слегка распух.
*добавлено новое действие - смеяться :)
'''Версия v.0.9.2.5 бета'''
*исправление ошибок, доработка парсера.
'''Версия v.0.9.2.4 бета'''
*добавлено наследование объектов action от action, что позволяет создавать дейстия по подобию существующих.
*добавлена возможность вводить составные команды:
> войди в лифт и нажми 5 кнопку
Ты вошел в лифт.
Лифт
Самая обычная кабинка лифта.
Здесь есть кнопки. Ты находишься тут и лифтер находится тут.
Ты нажал кнопку 5.
Лифт поднял тебя на 5 этаж.
* исправлены мелкие ошибки
'''Версия v.0.9.2.3 бета и v.0.9.2.2 бета'''
*исправление ошибок, мелкие косметические улучшения.
'''Версия v.0.9.2.1 бета'''
*Изменен способ для первичного размещения объектов внутри друг-друга. Теперь при первом объявлении объекта в теле другого объекта, объявляемый объект автоматитески попадает внутрь этого объекта.
unique заяц
{ //... описание зайца
unique утка
{ //... описание утки
unique яйцо
{ //... описание яйца
// и т.д. до самой смерти Кощея
}
}
}
*Добавлен механизм уточнения команд:
''> возьми еду''
''Стручок на грядке или малину на кустах?''
''?> горох с грядки''
''Ты сорвал стручок с грядки.''
*В демоигру добавлены притяжательные местоимения. Сравните варианты ответов при игре за мышонка:
''> осмотри крота''
и при игре за крота:
''> мышонок, осмотри меня''
*исправлены некоторые мелкие ошибки в движке и демоигре.
'''Версия v.0.9.2.0 бета'''
*Изменен синтаксис языка. Изменен формат описания объектов и доступ к свойствам объектов. В целом язык приблизился к C++ и стал выглядеть еще более привычно для программистов. Очень надеюсь что до выхода версии 1.0 синтаксис меняться более не будет.
*Доведена до ума речевая модель. Определены речевые роли и их распределение в различных типах речевых актов. Реализация поддержки речевых ролей на уровне платформы позволяет автоматически определять лица и правильно подставлять/определять личные и возвратные местоимения при генерации/парсинге текста. Проверить это можно играя за различных персонажей - для мамы игра идет в 1 лице, для мышонка во 2м, и для крота в 3 лице. (О речевой модели в ТОМе обязательно напишу подробнее, т.к. тема интересна и требует дальнейшего развития)
*Проект полность перебран заново. Исправлена архитектура движка. Это позволило избавиться от детских болезней роста и исправить множество ошибок. Теперь ТОМ мне представляется логически цельным и завершенным (в рамках разумных ограничений версии 1.0)
'''Версия v.0.9.1.4 бета (bugfix)'''
*исправлены ошибки предыдущей версии
'''Версия v.0.9.1.3 бета'''
*убраны синонимы для объектов (будут реализованы позже и на других принципах)
*добавлен предопределенный метод CalcKey() для расчета переменной части морфологического ключа в зависимости от свойств объекта или других измечивых обстоятельств.
*добавлен предопределенный метод Redirect() для перенаправления действия с одного объекта на другой.
*исправлены найденные ошибки
'''Версия v.0.9.1.2 бета'''
*произведен рефакторинг движка;
*вызовы обработчиков событий и парсерных проверок приведены к стандарту Си;
*изменена логика для значения null;
*исправлены найденные ошибки.
'''Версия v.0.9.1.1 бета'''
*существенно упрощена работа с числительными - для любого объекта в команде можно указать его число. Проверки на согласование с числительными теперь выполняются парсером.
*для объектов, возвращаемых парсером, свойство .num теперь содержит число, указанное игроком;
*числовые переменные в парсерных шаблонах убраны за ненадобностью;
*для чисел стало возможным задавать строковые синонимы - "100"="сто";
*добавлены специальные константы для указания количества - "все", "несколько", "половина", "треть", "четверть".
'''Версия v.0.9.1.0 бета'''
*в дополнение к шаблонному парсеру добавлен подбор действий и фраз по ключевым словам и ключевым объектам с оценкой по весу (см. keyword);
*конструкция задания лексем для парсера .lex = "строка" признана устаревшей и впоследствии будет удалена;
*для объектов, возвращаемых парсером, свойство .lex теперь содержит лексему, названную игроком в команде;
*любое свойство объекта, содержащее строку в формате лексемы и имеющее в основе одно слово, теперь может быть использовано как имя объекта в команде (альтернатива .lex=)
*исправлены ошибки.
'''Версия v.0.9.0.2 бета'''
*добавлены глобальные переменные token и secret;
*добавлено сообщение парсера object_select;
*для объектов добавлены предопределенные свойства in_dialog и as_variant
*системные команды теперь могут использоваться в коде игры.
Например
global < "exit"
приводит к выходу из программы.
*исправлены найденные ошибки.
'''Версия v.0.9.0.1 бета'''
*для локаций добавлен обработчик события [[TOM: язык программирования#.OnEnter( ) / .НаВход( )|OnEnter()]]
*убран обработчик события onChangePers() за ненадобностью
*добавлен тег для очистки экрана <clear>
*исправлены найденные ошибки в движке и игре.
'''Версия v.0.9.0.0 бета'''
*дополнительная поддержка интерфейсов - добавлена константа [[TOM: язык программирования#frontend|frontend]];
*добавлена функция input();
*демоигра адаптирована под Милену, добавлены картинки;
*исправлены найденные баги.
'''Версия v.0.2.4.1 альфа'''
*добавлены средства для организации диалогов и событий;
*сообщений об ошибках в парсере вынесены в переменные и могут быть изменены;
*оптимизирован парсер;
*доработано сохранение игр;
*исправлены найденные баги.
'''Версия v.0.2.4.0 альфа'''
*добавлена возможность сохранения/восстановления игры;
*исправлены найденные баги;
'''Версия v.0.2.3.3 альфа'''
Доработки платформы:
*существенно доработан парсер;
*изменены [[TOM: язык программирования#Теги|управляющие теги]];
*исправлена масса ошибок.
Доработки демоигры:
*добавлены новые объекты (ягоды и грядки во дворе)
*добавлены шаблоны для действий с объектами упомянутыми ранее;
*добавлены действия с классовыми именами;
*вероятно еще что-то… эээ не помню :)
'''Версия v.0.2.3.2 альфа'''
Добавлены [[TOM: язык программирования#Относительные свойства объектов|относительные свойства]] объектов и ключевые слова actor и act.
Объектная модель платформы окончательно сформирована.
В демоигре восстановлена возможность игры любым персонажем.
'''Версия v.0.2.3.1 альфа'''
Исправлена работа конструкций языка if-else, for, while, switch-case. Фигурные скобки {} теперь необходимы только для объединения многострочных блоков. Все конструкции (за исключением switch-case) работают аналогично C. Принцип работы switch-case мною изменен, надеюсь, в лучшую сторону.
Также добавлены ключевые слова return, break, continue, работающие аналогично C.
Теперь язык платформы окончательно сформирован и позволяет разрабатывать алгоритмы любой сложности.
Документирование системы пока не начато, но начиная с этой версии в папке "Примеры" можно найти простые файлы с подробными комментариями, позволяющие освоить принципы работы платформы. Файлы, имеющие расширение .tom, открываются текстовым редактором.
'''Версия v.0.2.3.0 альфа'''
Изменения в интерпретаторе:
- добавлены конструкции циклов for и while;
- добавлена конструкция switch-case;
- изменена обработка событий, добавлены функции CheckMove, BefMove, AftMove;
- добавлена команда restart;
- формируется лог-файл, прошу присылать логи
Изменения в демоигре:
- добавлена система помощи, мышонок научился думать;
- добавлено ведение счета;
- возможность игры за разных персонажей временно убрана.
PS: оконный интерфейс пока крайне сырой...
[[Категория:ПлатформыПарсерные платформы]] [[Категория:ПарсерныеДокументация платформыТОМ]]
[[Категория:Заброшенные платформы]]
|