ТОМ 0.9 бета: различия между версиями

← Предыдущая правка

Содержимое удалено Содержимое добавлено

ВизуальныйВики-текст

Версия от 09:52, 29 марта 2009 просмотреть исходный код ASBer (обсуждение \| вклад) 1379 правок м →План развития платформы ← Предыдущая правка		Текущая версия от 13:16, 2 июня 2018 просмотреть исходный код Nikita (обсуждение \| вклад) Администраторы 5450 правок Пожалуй, можно считать платформу заброшенной ввиду перехода автора к разработке ТОМ 2
(не показаны 242 промежуточные версии 4 участников)
Строка 3: ==Общая информация== Парсерная русскоязычная ИЛ-платформа. ~~ТОМ - Текстовая Основа Миростроения.~~ Расшифровка названия: ТОМ - ''Текстовая Основа Миростроения.'' ~~Парсерная русскоязычная ИЛ-платформа с консольным интерфейссом:~~ ~~[[Изображение:Constom.GIF]]~~ Период разработки: 2008-2011гг. ~~Платформа имеет [[TOM: язык программирования\|язык программирования]], напоминающий С++.~~ Последняя версия: [[Медиа:Tom_094.rar\|0.9.4.11 бета]], версии [[ТОМ 0.9 бета#Отказ от выпуска версии 1.0\|1.0]] не будет. Парсер изначально ориентирован на русский язык, не имеет ограничений на количество слов в команде, команды описываются с помощью шаблонов. Парсинг управляется функциями-проверками к шаблонам. Продолжение разработки: [[ТОМ 2]]. Объектная модель поддерживает линейное наследование. Есть возможность обработки событий и фоновых действий. [[:Категория:Игры на TOM\|Игры на платформе ТОМ]]. Консольный интерфейс не поддерживает HTML (за исключение тегов для смены цвета шрифта), но ядро ТОМа позволяет использовать как HTML разметку, так и любые другие теги. Текст, заключенный в < > прозрачен для ядра ТОМа и может быть обработан программой-интерфейсом при выводе текста. Автор: [[Участник:ASBer\|ASBer]] ~~==Текущее состояние разработки==~~ ~~Доступна [[Медиа:ConTOM.rar\|версия 0.9.1.2 бета]].~~ ~~К платформе прилагается короткая демо-игра, адаптированная для проигрывания в Милене.~~ [http://tom.userforum.ru/ Официальный форум] платформы. ~~Также можно скачать [[Медиа:tom_sample.rar\|набор файлов-примеров по программированию]].~~ Есть набор простых [[Медиа:tom_sample.rar\|примеров]] по программированию. Для углубленного изучения посетите [[:Категория:Документация ТОМ\|раздел документации]]. ~~Идет бета-тестирование и разработка документации.~~ Если у Вас есть вопросы по платформе - посмотрите [http://forum.ifiction.ru/viewtopic.php?id=1258 FAQ]. ~~==Интеграция с другими программами==~~ ~~Платформа состоит из 2х частей:~~ ~~1. Ядро - реализовано в виде динамической библиотеки .dll~~ ===Язык программирования=== ~~2. Интерфейсная оболочка (Front-end)~~ ТОМ имеет [[wikipedia:Скриптовый язык\|скриптовый]] [[TOM: язык программирования\|язык программирования]] [[wikipedia:Высокоуровневый язык программирования\|высокого уровня]], по синтаксису близкий к [[wikipedia:С++\|С++]], а по идеологии напоминающий [[wikipedia:Ruby\|Ruby]]. Язык поддерживает [[wikipedia:объектно-ориентированное программирование\|объектно-ориентированное программирование]] с линейным наследованием и [[wikipedia:динамическая типизация\|динамической типизацией]]. Интерфейс между ядром и оболочкой достаточно прост, построен на нескольких функциях ядра. Любой желающий может использовать ядро платформы в своих разработках. Есть возможность обработки событий и фоновых действий. ~~Код ядра в настоящий момент закрыт.~~ ===Парсер команд на русском языке=== ~~Исходник консольного интерфейса [[Медиа:ConTOM_s.rar\|constom.exe]] на языке C доступен для [[Медиа:ConTOM_s.rar\|скачивания]].~~ [[Парсер]] изначально ориентирован на русский язык, не имеет ограничений на количество слов в команде, команды описываются с помощью шаблонов. Парсинг управляется функциями-проверками к шаблонам. ===Модульный принцип построения платформы=== ~~===Милена===~~ Платформа ТОМ строится по модульному принципу и состоит из нескольких частей: 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]] Консольный интерфейс является простым примером для разработки front-end приложений к ТОМу версии 0.9.3.1. Исходный модуль консольного интерфейса [[Медиа:ConTOM_s.rar\|constom.cpp]] на языке C доступен для свободного [[Медиа:ConTOM_s.rar\|скачивания]]. Constom поддерживает тег смены цвета шрифта и несколько служебных тегов. ===TOM API 0.9.3.1=== Интерфейс между ядром версии 0.9.3.1 и оболочкой достаточно прост, построен на нескольких функциях ядра. Любой желающий может использовать ядро платформы в своих разработках. Назначение функций: char RunFile(charFileName) Выполняет скрипт из указанного файла. Возвращает текст, сгенерированный при выполненнии скрипта. char* RunText(charStatement) Вычисляет выражение или выполняет скрипт переданный в строке. Возвращает результат вычисления. Текст сгенерированный при выполненнии скрипта пишется в лог. char* Command(charInput) Выполняет команды на русском языке. Возвращает текст, сгенерированный при выполненнии команды. ===ТОМилена=== Первым удачным примером интеграции движка ТОМ является платформа [[Милена]]. ~~[[Изображение:TOM_Milena.JPG]]~~ [[Изображение:TOM_Milena.JPG]] Милена может выступать как полноценный оконный интерфейс ТОМа с поддержкой HTML разметки. ~~(поддерживаются теги <nowiki><b></b>, <i></i>, <u></u>, <img></img>, <center></center>, <h1..9></h1..9>, <font></font></nowiki>)~~ Поддерживаются html-тэги: <nowiki><i>, <b>, <u>, <center>, <h1>..<h9>, <font>, <img></nowiki>, а также специальные тэги: <pause>(задержка до нажатия клавиши или временная задержка), <clear>(очистка экрана) и <music>(воспроизведение музыки). ~~==План развития платформы==~~ ~~бета-тестирование:~~ ~~~ разработка [[TOM: язык программирования\|документации]];~~ '''Подробнее о тэге''' <pause>. ~~~ разработка примеров по программированию;~~ Тэг имеет специальный атрибут interval, задающий время паузы в миллисекундах. Если он не определён, интерпретатор ждет нажатия кнопки. ~~~ портирование стандартной библиотеки [[RTADS]]~~ Пример: %<pause interval="500">//Задержка на 500 миллисекунд ~~~ обкатка отладочного режима;~~ '''Подробнее о тэге''' <music>. ~~~ бета тестирование;~~ Тэг имеет несколько атрибутов: name(имя загруженного файла в системе(чисто условное)), src(путь к файлу), loop(если атрибут присутствует, звук зацикливается), event(принимает одно из 3 значений: "play", "pause" и "stop", если атрибут отсутствует его значение принимается за "play"). Значения атрибутов должны содержаться в двойных или одинарных кавычках. Пример: %<music name="главная тема" src="1.mp3" loop="">//Эта строка загружает и начинает воспроизведение музыки %Нажмите любую клавишу, чтобы остановить воспроизведение<pause> %<music name="главная тема" event="stop">//Эта строка останавливает воспроизведение музыки с условным именем "главная тема" ==Версия 0.9.4.х== ~~v.1.0 - релиз базовой версии.~~ [[Медиа:Tom_094.rar\|скачать]] Для версий 0.9.4.х декларируется обратная совместимость с v.0.9.3.1, что гарантирует возможность проигрывания игр, сделанных для версии 0.9.3.1 и использование разработанных для неё библиотек. ''совместимость не полная - возможности, которые никогда не были использованы, в v.0.9.4.х могут отсутствовать.'' ~~v.1.x.x.x - развитие базовой версии.~~ '''В плюсе:''' ~~+ использование "относительных" наименований в команде - ''он, она, это'' и т.п.;~~ новый графический интерфейс и новый механизм взаимодействия движка с интерфейсом; основной цикл игры убран внутрь dll и выполняется в отдельном потоке; регистрация внешних функций, система плагинов; поддержка музыки и речи вынесена из движка в отдельные плагины; вычисление выражений непосредственно в командной строке (удобно для отладки); тестировать можно на старых играх - мышках и спелеологисте. ~~+ новая категория объектов для лексем~~ ===Интерфейс на основе HGE=== ~~+ транскрипция для записи лексем~~ [[Изображение:TOMonHGE.JPG]] Интерфейс реализован на основе полноценного графического движка [http://hge.relishgames.com/overview.html HGE], что в будущем позволяет нарастить графические возможности платформы и использовать различные спецэффекты. ~~+ типизация аргументов методов и перегрузка (overload) методов объектов~~ ===ТОМ API 0.9.4.х=== ТОМ API состоит из нескольких функций tom.dll: '''RegFunction()''' - регистрирует дополнительные внешние функции; '''Init()''' - запускает движок; '''RunText()''' - выполняет переданный текст, возвращает результат; '''Exit()''' - останавливает движок. Еще есть альтернативные функции, на случай если ваш интерфейс или плагин не использует UNICODE: ~~v.2.0 - вторая версия - парсер с динамическими шаблонами.~~ '''RegFunctionANSI()''' - работает аналогично RegFunction(); '''RunTextANSI()''' - работает аналогично RunText(); ====Внешние функции==== ТОМ позволяет подключать неограниченное количество внешних функций, расположенных в интерфейсе или в плагинах и расширяющих стандартный набор функций ТОМа. После регистрации внешней функции её можно вызвать из командной строки '''>MyFunction Arg''' или из кода игры: '''MyFunction(Arg)'''. Существует 5 специальных внешних функций, необходимых для работы ТОМа: '''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\|Стандартная библиотека]] строится по модульному принципу. К каждому модулю разработан свой тест, демонстрирующий его работу. Автор сам решает, какие модули необходимы в его игре, а какие можно выкинуть. Смотрите также [[ТОМ: Стандартная библиотека\|подробное описание библиотеки]] и [[ТОМ: Уроки\|пошаговые уроки создания игры на основе стандартной библиотеки]]. ''Модули стандартной библиотеки:'' '''UnusVerb.tml''' Содержит список неиспользуемых глаголов, генерит осмысленные сообщения для комманд с глаголами из списка. '''Main.tml''' Содержит минимально-необходимый набор функциональности - классы для ''локаций, предметов, персонажей'' и ''декораций'', действия ''осмотреться, осмотреть, взять, дать, положить, идти, войти, выйти, сказать'', '''Physics.tml''' '''Map.tml''' Позволяет размещать локации на карте, поддерживает перемещения по компасным направлениям - [[сзюв]] '''Containers.tml''' '''Light.tml''' ===Инструменты=== ====Генератор словоформ==== Удобный [[Медиа:tom_Gener.rar\|генератор словоформ]] от Александра: [[Изображение:tom_g.PNG]] Текущая версия 0.8.2.158 ==Отказ от выпуска версии 1.0== Направление развития 0.9 признано неудачным. Выявленные в ходе бета-тестирования сложность разработки игр, недостаточный уровень поддержки русского языка, и отсутствие авторов, желающих писать на этой платформе, наглядно это подтвердили. В настоящее время идёт разработка [[ТОМ 2]]. Принципы работы движка серьезно пересмотрены. В новую версию вложен весь боевой опыт, приобретенный за время создания и использования платформы, а также новые идеи, внедрить которые в архитектуру первого ТОМа было уже невозможно. ==Changelog== ===Версия v.0.9.14.~~2 бета~~11 beta=== [[Медиа:Tom_094.rar\|лежит здесь]] произведен рефакторинг движка; вызовы обработчиков событий и парсерных проверок приведены к стандарту Си; Новое в версии: изменена логика для значения null; загрузка/выгрузка плагинов перенесена из движка в интерфейс и доработана; исправлены найденные ошибки. плагин '''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.1.1 бета~~ добавлен выбор значения свойств по локации (предмет_по_месту); существенно упрощена работа с числительными - для любого объекта в команде можно указать его число. Проверки на согласование с числительными теперь выполняются парсером. интерфейс переписан с учётом потокобезопасности. для объектов, возвращаемых парсером, свойство .num теперь содержит число, указанное игроком; речевой плагин временно убран из архива - не корректно завершает работу. числовые переменные в парсерных шаблонах убраны за ненадобностью; для чисел стало возможным задавать строковые синонимы - "100"="сто"; добавлены специальные константы для указания количества - "все", "несколько", "половина", "треть", "четверть". ===Версия v.0.9.4.8 beta=== ~~----~~ финальная версия в этом направлении. ~~Версия 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.4.7 альфа''' ~~----~~ Сделана загрузка плагинов. ~~Версия v.0.9.0.1 бета~~ Добавлена интерфейсная функция pause() / пауза(). Рекомендуется использовать вместо тэга <pause>. для локаций добавлен обработчик события [[TOM: язык программирования#.OnEnter( ) / .НаВход( )\|OnEnter()]] Доработана обработка ошибки с незакрытыми скобками в коде игры. убран обработчик события onChangePers() за ненадобностью добавлен тег для очистки экрана <clear> исправлены найденные ошибки в движке и игре. ~~----~~ ~~Версия v.0.9.0.0 бета~~ дополнительная поддержка интерфейсов - добавлена константа [[TOM: язык программирования#frontend\|frontend]]; добавлена функция input(); демоигра адаптирована под Милену, добавлены картинки; исправлены найденные баги. '''Версия v.0.9.4.6 альфа''' ~~----~~ доделана нормализация знаков препинания; ~~Версия v.0.2.4.1 альфа~~ исправлены некоторые ошибки. добавлены средства для организации диалогов и событий; Версии присвоен статус "альфа". Всё основное, что планировалось в ветке 0.9.4.х, сделано. сообщений об ошибках в парсере вынесены в переменные и могут быть изменены; Осталось доделать небольшие фичи, после чего эта версия перейдет в "бету" и будет рекомендована как основная официальная версия. оптимизирован парсер; доработано сохранение игр; исправлены найденные баги. ~~----~~ ~~Версия v.0.2.4.0 альфа~~ добавлена возможность сохранения/восстановления игры; исправлены найденные баги; '''Версия v.0.9.4.5 (багфикс)''' ~~----~~ Исправлен ряд ошибок, критичных и не очень. Спасибо '''Александру'''. ~~Версия v.0.2.3.3 альфа~~ ~~Доработки платформы:~~ существенно доработан парсер; изменены [[TOM: язык программирования#Теги\|управляющие теги]]; исправлена масса ошибок. '''Версия v.0.9.4.4 dev''' ~~Доработки демоигры:~~ Добавлена speech.dll для чтения текста. добавлены новые объекты (ягоды и грядки во дворе) добавлены шаблоны для действий с объектами упомянутыми ранее; добавлены действия с классовыми именами; вероятно еще что-то… эээ не помню :) ~~----~~ ~~Версия v.0.2.3.2 альфа~~ '''Версия v.0.9.4.3 (багфикс)''' Добавлены [[TOM: язык программирования#Относительные свойства объектов\|относительные свойства]] объектов и ключевые слова actor и act. Исправлена критическая ошибка. В остальном без изменений. ~~Объектная модель платформы окончательно сформирована.~~ '''Версия v.0.9.4.2 dev''' ~~В демоигре восстановлена возможность игры любым персонажем.~~ Доделана система ввода-вывода (за исключением голоса и коррекции знаков препинания) Исправлены старые ошибки Добавлены новые ошибки ~~----~~ ~~Версия v.0.2.3.1 альфа~~ '''Версия v.0.9.4.1 dev''' Исправлена работа конструкций языка if-else, for, while, switch-case. Фигурные скобки {} теперь необходимы только для объединения многострочных блоков. Все конструкции (за исключением switch-case) работают аналогично C. Принцип работы switch-case мною изменен, надеюсь, в лучшую сторону. Исправлено несколько мелких ошибок. ~~Также добавлены ключевые слова return, break, continue, работающие аналогично C.~~ Воспроизведение музыки приведено к полной совместимости с версией 0.9.3.1 ~~Теперь язык платформы окончательно сформирован и позволяет разрабатывать алгоритмы любой сложности.~~ '''Версия v.0.9.4.0 dev''' В плюсе: Документирование системы пока не начато, но начиная с этой версии в папке "Примеры" можно найти простые файлы с подробными комментариями, позволяющие освоить принципы работы платформы. Файлы, имеющие расширение .tom, открываются текстовым редактором. + новый графический интерфейс и новый механизм взаимодействия движка с интерфейсом. ~~----~~ ~~Версия v.0.2.3.0 альфа~~ + основной цикл убран внутрь dll и выполняется в отдельном потоке. ~~Изменения в интерпретаторе:~~ + система регистрации внешних функций. ~~- добавлены конструкции циклов for и while;~~ + вычисление выражений непосредственно в командной строке (удобно для отладки) ~~- добавлена конструкция switch-case;~~ + проигрывание музыки реализовано в отдельной dll, независимой от текстового движка. ~~- изменена обработка событий, добавлены функции CheckMove, BefMove, AftMove;~~ + тестить можно на старых играх - мышках и спелеологисте. ~~- добавлена команда restart;~~ ~~- формируется лог-файл, прошу присылать логи~~ В минусе: - синтез речи - будет реализован отдельно от текстового движка. ~~Изменения в демоигре:~~ - пост-обработка текста пока отсутствует, будет переделываться. ~~- добавлена система помощи, мышонок научился думать;~~ ===Версия v.0.9.3.1 бета=== ~~- добавлено ведение счета;~~ [[Медиа:ConTOM.rar\|лежит здесь]] Изменен принцип подстановки произношения - оно теперь подставляется непосредственно в тексте в квадратных скобках: ~~- возможность игры за разных персонажей временно убрана.~~ слово[правильное произношение слова] добавлена команда "повторить", которая повторяет последний произнесенный текст (работает только если в системе установлен голос) усовершенствован механизм подстановки альтенативных форм предлогов ("с"->"со", "из"->"изо" и т.д.). [[ТОМ: Changelog\|Архив по старым версиям]] ~~PS: оконный интерфейс пока крайне сырой...~~ [[Категория:~~Платформы~~Парсерные платформы]] [[Категория:~~Парсерные~~Документация ~~платформы~~ТОМ]] [[Категория:Заброшенные платформы]]