IFВики - Вклад [ru]

Помощь начинающему игроку в RTADS

2010-05-08T11:53:24Z

Feuerbart: "кричать" и т.д - неопределённая форма, а не повелительное наклонение

''Автор'': [[Flint]], на основе «[http://rtads.org/beghelp.php Помощи начинающему игроку]».

'''Примечание:''' некоторые советы и рекомендации из этой статьи могут быть применены и к играм на других платформах с текстовым вводом, однако они могут иметь иной формат команд и сокращений.

==Что нужно для запуска игр==
Игры, написанные на [[RTADS]], имеют расширение .gam. Для того чтобы запустить игру, вам понадобится специальная программа – [[интерпретатор]]. Скачать его можно по следующим адресам:

* для Windows:
:[http://www.rtads.org/htads_playkit_HT12_RUS.exe С русифицированным интерфейсом]
:[http://mirror.ifarchive.org/if-archive/programming/tads2/executables/htads_playkit_HT20.exe Английский проигрыватель] (зеркало)
:[http://www.ifarchive.org/if-archive/programming/tads2/executables/htads_playkit_HT20.exe Английский проигрыватель] (основной сайт)

* для Linux:
:С [http://mirror.ifarchive.org/if-archive/programming/tads2/executables/qtads-1.6c-qt-3.3.x.tar.gz зеркала] ifarchive
:С [http://www.ifarchive.org/if-archive/programming/tads2/executables/qtads-1.6c-qt-3.3.x.tar.gz ifarchive.org]
:(требуется библиотека Qt 3.3 или выше)

Версии для других операционных систем ищите в [http://www.ifarchive.org/if-archive/programming/tads2/executables/ каталоге]. Но качать файлы лучше не из каталога, а с [http://mirror.ifarchive.org/if-archive/programming/tads2/executables/ зеркала], из-за проблем со скоростью.

Иногда автор может выпустить игру в виде исполняемого exe-файла, тогда вам ничего не нужно устанавливать. Но обычно такое не практикуется, поскольку из-за этого игры неоправданно вырастают в размерах.

==Как играть==
В текстовом приключении вы играете путём набора команд, описывающих действия, которые должен выполнить персонаж. Каждый раз, когда вы видите значок ">" с мигающим за ним курсором, это значит, что игра ожидает от вас команды. Прочтите текст, вспомните, что происходит, какие предметы находятся в вашем распоряжении и действуйте! Не торопитесь, время в игре идет только после получения команды, пока вы раздумываете, ничего не происходит.

==Основные команды==
Самая важная и чаще всего используемая команда это «''осмотреть''». Так как всё содержимое игры является текстовым, то это единственный способ, которым вы можете получить информацию об игровом мире, поэтому старайтесь осматривать все предметы, попадающие в поле зрения, например «''осмотреть серый валун''». Для этой команды доступно сокращение «''о''», то есть можно набирать «''о серый валун''». Если вы просто введете «''о''», то получите описание места, в котором находитесь.

Следующие по важности команды - это команды перемещения. Исторически сложилось так, что в текстовых играх направление движения указывается сторонами света («На севере вы видите низкий темный проход. Галерея же продолжается дальше на восток»). Поэтому, чтобы попасть в темный проход, следует писать не «''идти в темный проход''», а «''идти на север''», или просто «''север''», или самый удобный вариант — сокращение «''с''». Соответственно, можно использовать и «''з''», «''в''», «''ю''», «''сз''» (северо запад), «''св''», «''юз''» и «''юв''». Перемещения в вертикальной плоскости осуществляются командами «''вниз''» (сокращенно «''вн''») и «''вверх''» (сокращенно «''вв''»). Также, в некоторых ситуациях можно куда-нибудь «''войти''» или «''выйти''». Когда вы посещаете какую-либо локацию в первый раз, выполняется её полный осмотр, а в дальнейшем при входе в неё будет выводиться лишь краткая информация. Если вы хотите снова получить полное описание, просто осмотритесь («''о''»). А если вам не нравится такое поведение игры, введите команду «''длинно''», тогда полное описание будет выводиться всегда. Отключается этот режим командой «''коротко''».

Посмотреть, что за скарб вы тащите с собой можно командой «''инвентарь''» (сокращенно «''и''»). Пропустить некоторый отрезок времени можно командой «''ждать''» (или просто «''ж''»).

А далее для прохождения игры вам придется, исходя из ситуации, формулировать собственные команды. Конечно, набор команд не бесконечен и задается автором во время создания игры. Поэтому, если, на ваш взгляд, игра не понимает совершенно очевидного, попробуйте переформулировать команду или заменить слово его синонимом. Если ничего не выходит, можете написать письмо автору игры с описанием вашего способа. В случае если способ логичен и не противоречит игровой логике, автор, скорее всего, добавит его в следующую версию программы. А вы пока испробуйте другой вариант.

Также возможна ситуация, когда предмет упомянут в описании, но любые попытки с ним взаимодействовать приводят к появлению сообщений типа «Я не знаю слова такого-то». Это значит, что этот объект не важен для прохождения игры и служит лишь для оживления игрового мира. Для важных объектов обычно задается множество синонимов, так что если игра не понимает слово и его синонимы, то, скорее всего, не следует больше обращать на него (и на соответствующий предмет) внимание.

==Советы по составлению команд==
К сожалению, игра это всего лишь программа и она может не понимать многое из того, что понимает человек. Поэтому позвольте дать вам несколько советов по составлению команд. Глагол в вашей команде всегда должен стоять на первом месте. Постарайтесь писать глаголы в неопределённой форме, например:

''кричать'' 
''спать'' 
''ждать'' 
и т.п. 

К глаголу может быть присоединен прямой объект, например:

''взять кусок арматуры'' 
''открыть коробку'' 
''бросить нитроглицерин'' 
''тянуть чеку'' 
''съесть мышьяк'' 
''отпереть дверь'' 
''лечь на кровать'' 
''нажать красную кнопку'' 
''сесть в машину'' 
''надеть майку'' 

Также могут добавляться и непрямые объекты. Составляйте команду так, чтобы сначала шел прямой объект, а за ним - непрямой, иначе игра может вас не понять. Например, «''привязать козла к забору''» - правильная команда, а «''привязать к забору козла''», хотя и грамматически верна, но может быть не распознана.
Еще примеры (правильных) команд:

''положить пирог на стол'' 
''отпереть дверь бронзовым ключом'' 
''дать мед Винни-Пуху'' 
''перевязать рану бинтом'' 
''повернуть рукоятку на 4 деления'' 
''ударить мертвеца лопатой'' 
''показать пропуск охраннику'' 
''набрать «привет» на клавиатуре'' 
''поджечь фитиль спичкой'' 

Если ваша команда содержит некоторую неоднозначность, игра попросит вас устранить её:

>открыть дверь
Какую дверь вы имеете в виду: дверь подъезда или дверь квартиры?

В этом случае необязательно заново набирать команду (''открыть дверь квартиры''), можно ответить одним словом:

>открыть дверь
Какую дверь вы имеете в виду: дверь подъезда или дверь квартиры?

>квартиры
Открыта.

В некоторых командах можно использовать сразу несколько предметов.

''взять серу, селитру и уголь'' 
''взять всё'' (эта команда поместит в ваш инвентарь все вещи в комнате, которые можно взять с собой) 
''взять всё из коробки'' 
''бросить всё, кроме мины'' 
''положить свиток телепортации и руку жреца в хардический куб'' 

==Взаимодействие с другими персонажами==
Для общения с другими персонажами существуют две команды: «''спросить''» и «''рассказать''». Например:

''спросить дьявола о сделке'' 
''спросить продавца о товаре'' 
''спросить Колю о Пете'' 
''спросить стражника о себе'' 
''рассказать милиционеру об ограблении'' 
''рассказать королю о заговоре'' 

Обратите внимание на формат команды. Обязательно используется предлог ''о'' или ''об'' и за ним следует существительное (или прилагательное + существительное). То есть нельзя «''спросить прохожего как пройти в библиотеку''», надо писать «''спросить прохожего о библиотеке''».

Также вы можете командовать другими персонажами (если они позволят, конечно) в формате «''имя персонажа, команда''». Например:

''Шарик, возьми палку'' 
''Петя, ударь Колю'' 
''Шериф, стреляй в Лимонадного Джо'' 
''Робот, иди на север. выключи реактор. иди на юг'' 

Набор возможных команд и их формат абсолютно ничем не отличается от вашего. Разница, как уже упоминалось, только в том, что в начале команды вы указываете имя персонажа, который должен её выполнить.

Еще один способ вызвать какую-то реакцию персонажа это «''показать''» или «''дать''» ему какой-то предмет. Например, «''дать деньги гаишнику''».

==Системные команды==
''сохранить'', ''восстановить'' - загрузить ранее
сохраненную игру 
''выход'' - чтобы выйти из игры 
''помощь'' - справка 
''отчет'' - запись хода игры (лога) в файл 
''остотчет'' - остановить ведение лога 
''счет'' - покажет прогресс в игровой ситуации 
''отмена'' - отменяет последнюю команду 
''версия'' - сообщает версию игры 
''заново'' - начать игру заново 
''коротко'' (''длинно'') - режимы отображения текста описания локаций. В "длинном" режиме при каждом входе в комнату будет выполняться ее осмотр. 
''ссылки'' - отключает или включает ссылки (если кому-то они не нравятся) 
''ой'' - позволяет исправить написание неправильно набранного слова в последней команде. Использовать ''ОЙ'' можно тогда, когда игра выведет следующее сообщение: «Я не знаю слова слово.» Сразу после этого сообщения можно набрать «''ОЙ исправленное слово''». 
''повтор'' (или просто ''п'') - повторяет последнюю команду 

Желаю приятной игры!

==Ссылки==
#[http://rtads.org/beghelp.php Справка для начинающего игрока] от авторов системы
#[http://rtads.org/commands.php Список всех стандартных глаголов], но не забывайте, что авторы могут добавлять и собственные команды

[[Категория:Статьи]][[Категория:Для начинающих]]

RInform

2010-05-03T18:23:12Z

Feuerbart: /* Ссылки */

'''RInform''' является русифицированной версией самого популярного языка разработки текстовых игр - [[Inform]]. Автор перевода - [[Гаев, Денис|Денис Гаев]].

==Разработка==
Перевод был осуществлен в 2003 году и дорабатывался более двух лет, пока Денис не пропал из сети (но в начале 2008 года вернулся, так что платформа жива!). Последняя версия датирована октябрем 2004 года и берёт за основу библиотеки [[Inform]] версии 6.30.

Система самостоятельно умеет генерировать падежные формы для имен объектов (достаточно выделить падежные окончания существительных и прилагательных, например «массивн/ая стальн/ая двер/ь», присвоив соответствующему объекту правильные род и число), и распознавать падежные формы в командах (и «открыть дверь ключом», и «открыть ключом дверь» понимаются правильно). Также распознается большое число дополнительных глагольных форм с приставками.

К сожалению, далеко не все [[Z-интерпретатор]]ы правильно поддерживают Unicode, необходимый для русскоязычных игр. Под Windows рекомендуется использовать Windows Frotz, под *nix и Mac OS — Zoom.

==Игры==
См. [[:Категория:Игры на RInform]]

== Ссылки ==
# [http://mirror.ifarchive.org/if-archive/infocom/compilers/inform6/library/translations/RInform075.zip Библиотеки версии 0.75]
# [http://rinform.stormway.ru Сайт RInform]

[[Категория:Платформы]] [[Категория:Парсерные платформы]]

RTADS FAQ

2010-04-20T15:53:34Z

Feuerbart: мелкие опечатки

'''''Часто Задаваемые Вопросы и Ответы о системе RTADS'''''

==Мультимедиа==

'''Вопрос от Zargo: Подскажите, пожалуйста, как можно подключить графику и звук в игру и можно ли вообще это сделать на RTADSе.'''

Можно, для интерпретаторов с поддержкой мультимедиа. Это проигрыватели для систем Windows, Macintosh и Linux.
Выглядит и реализуется как HTML верстка с некоторыми ограничениями. Графические/музыкальные ресурсы можно зашить в файл игры или распространять отдельными файлами. Графика: jpg, png, mng. Последний позволяет отображать анимированные изображения. Также можно воспроизводить анимацию из последовательности jpg, динамическим контентом или псевдографикой. Поддержка Gif не была реализована по причине ограничений лицензии.

'''Вопрос от [[ifn00b]]： Касательно мультимедийных возможностей - какие типы аудио-файлов можно подключить к RTADS? И каким образом происходит их проигрывание - интерпретатор вызывает внешнее приложение, которое зарегистрировано в системе для файлов данного типа?'''

Midi, wav, MP3 и Ogg Vorbis.
Для проигрывания используется DirectX.

Подробно обо всем этом можно узнать здесь (увы, на английском языке):
http://www.tela.bc.ca/tads-manual/tads-12.html

P.S. По мнению большей части сообщества, избыток графики и звука уводит от настоящего IF. Будьте очень осторожны и используйте эти возможности тогда, когда это оправдано.

==Сборка и компиляция==
'''Чем отличаются debug и release версии игры?'''

В debug версию включается дополнтельная информация, которая позволяет отлаживать игру в TADS Workbench. Из-за этого: во-первых, существенно увеличивается размер файла, во-вторых, весь текст записывается в открытом виде и может быть просмотрен любым редактором, в-третьих, старые версии интерпретаторов могут слетать на играх с длинными строками, скомпилированными в отладочном режиме.

Вывод: при выпуске игры в свет не забывайте компилировать и выкладывать release версию.

==Отладка==

'''Есть ли в ТАДС способы автоматического тестирования библиотек и игр?'''

В отладочных целях ещё в первых версиях ТАДС двадцатилетней давности были предусмотрены средства ввода команд из файла и вывода результата в другой файл. Таким образом, можно сверять файлы результатов с целью проверки корректности работы игры после последних изменений и её проходимость,
без необходимости внимательного "ручного" просмотра.

Подробно это описано в пока непереведенной главе мануала:
[http://teladesign.com/tads-manual/tads-b.html Параграф "Testing Your Game"]

Вкратце:
mygame.exe -o walkthru.in - записывает в файл команды по мере прохождения
mygame.exe -i walkthru.in -l walkthru.log - запускает игру и вводит список команд,
а выходящий текст записывает в файл.
Файл с выводом из предыдущей и новой версии можно сравнить с помощью специальных программ, типа [http://winmerge.org/ WinMerge].

==Синтаксис==
'''Почему индексация массивов и строк начинается с единицы?!'''

Конечно же, это риторический вопрос. Но довольно часто ошибки в игре вызываются тем, что автор «на автомате» впечатал уже отложившийся на подкорке кусочек кода, который сработал бы для массивов, начинающихся с 0. Поэтому если у вас появляются ошибки выхода за пределы массива или строки какие-то обрезанные выводятся – в первую очередь проверяйте код, работающий с индексами массивов.

'''Никак не могу привыкнуть к этому полупаскальному-полусишному синтаксису. Можно ли как-нибудь привести его к единой форме?'''

Да. Существует специальная директива <tt>#pragma C+</tt>. Она включает режим соответствия языку C для файла, в котором упомянута, поэтому вы сможете использовать привычные <tt>==</tt> для сравнения и <tt>=</tt> для присваивания. А директива <tt>#pragma C-</tt> возвращает все к стандартному виду.

Совет: если вы разрабатываете модуль, который затем может быть использован другими людьми, директивой <tt>#pragma</tt> явно указывайте стиль, используемый в файле, чтобы авторские настройки не повлияли на работу вашего модуля.

'''Как создать список (list) из одного элемента?'''

Если вы задали переменную "a" без указания какого либо типа, т.е.
local a;
то присвоить ей список из одного элемента
a := [b];
не удастся.

Нужно либо изначально указать что это список
local a=[];
либо поступить так:
a := [] + b;

'''При вызове метода foo() без аргументов возникает ошибка компиляции.'''

Если метод не принимает аргументов, то сотрите скобки при его вызове.
bar.foo(); //ошибка
bar.foo; //вызов метода

При объявлении метода скобки все-равно нужны!

==Неочевидные приемы==
'''Почему не наследуются лексические свойства (sdecs, noun и пр.)?'''

В стремлении упростить жизнь авторам игр, TADS не делает особых различий между классом и объектом (экземпляром класса). Однако отличия есть, хоть и небольшие. Во-первых, класс нематериален в игре — вы никак не сможете взаимодействовать с ним. Во-вторых (уже догадались?) ''лексические'' свойства (sdesc, ldesc, noun, adjective) наследуются только от классов, а от объектов нет.

Пример:
<pre>
coin : item
desc = 'золотая/1пж монета/1ж'
ldesc = "Золотая монета с изображением профиля Императора. "
isHer = true
;

coin1 : coin
location = treasury
;

coin2 : coin
location = chest
;

coin3 : coin
location = purse
;
</pre>
В таком виде пример работать не будет, потому что лексические свойства объекта coin не наследуются потомками. Соответственно, вы просто не найдете монет в игре, потому что к ним никак нельзя будет обратиться (свойство noun-то не заполнено!). Уже догадались, как исправить? Правильно, пишем в первой строке:
class coin : item
и все встает на свои места.

Примечание: на момент написания заметки библиотека находилась в состоянии активной разработки и desc, к примеру, стал наследоваться нормально, просто дублируя словоформы много раз. Несмотря на это, рекомендуется ВСЕГДА использовать классы, если требуется наследовать лексические свойства.

'''Как динамически изменить ldesc (и другие свойства с двойными кавычками)?'''

Двойные кавычки (") — удобная особенность языка TADS, однако принцип их работы может немного смутить новичков. Двойные кавычки служат для вывода текста на экран, то есть, как только в ходе выполнения программы интерпретатор встречает строку в двойных кавычках, он тут же отображает её. Если строка в двойных кавычках присвоена в качестве свойства какого-либо объекта, то она будет отображаться при каждом обращении к этому свойству. Смысл этого в том, чтобы облегчить автору работу с текстом — базовой единицей всей [[ИЛ]].
При этом следует понимать, что строка в двойных кавычках — это не переменная как таковая, а, фактически, завуалированный метод для вывода переданного текста на экран. Он ничего не возвращает, поэтому строками в двойных кавычках нельзя манипулировать так же, как обычными переменными. Например, следующий, на первый взгляд правильный код не будет работать:

<pre>
vase : item
gdesc = 'ваза/1ж'
ldesc = "Хрупкая фарфоровая ваза. "
...

doDrop(actor) =
{
"Ваза была так тонка, что разбилась при падении. ";
self.ldesc := "Теперь ваза представляет собой лишь груду черепков. ";
pass doDrop;
}
;
</pre>

Так как метод «двойные кавычки» ничего на самом деле не возвращает, <tt>ldesc</tt> в данном примере перепишется пустым значением и описание исчезнет вообще. Для решения этой проблемы следует переписать определение <tt>ldesc</tt> вот так:

<pre>
vase : item
gdesc = 'ваза/1ж'
ldesc =
{
if (not self.broken)
"Хрупкая фарфоровая ваза. ";
else
"Теперь ваза представляет собой лишь груду черепков. ";
}

broken = nil
...

doDrop(actor) =
{
"Ваза была так тонка, что разбилась при падении. ";
self.broken := true;
pass doDrop;
}
;
</pre>

Ещё один способ - вставить в строку с двойными кавычками вызов изменяемого свойства. Например:
<pre>
vase : item
gdesc = 'ваза/1ж'
ldesc =
{
if (not self.broken)
"Хрупкая фарфоровая ваза. ";
else
"Из-за <<negodyai>> ваза превратилась в груду черепков. ";
}

broken = nil
negodyai=''
...

doDrop(actor) =
{
"Ваза была так тонка, что разбилась при падении. ";
self.broken := true;
negoyai:=dToS(actor,rdesc);
// функция dToS перехватывает вывод на экран "двукавычного"
// свойства rdesc и присваивает переменной negoyai
pass doDrop;
}
;
</pre>

Здесь мы превратили свойство rdesc действующего актера из строки с двойными кавычками в строку с одинарными и записали в объекте. Это свойство мы можем менять по ходу всей игры, и это будет менять описание. В данном случае - виновника происшествия.

'''Как реализовать части тела или объекта?'''

Как пример сложной фразы часто приводят примеры из серии:
врезать/ударить/пнуть ногой/хвостом/ёжиком (по) лбу/ноге/ягодицам/сенсорам монстра/робота/тети Клавы
На самом деле, это реализуется довольно просто:
<pre>
class bodypart: fixeditem
dobjGen(actor, verb, indirectobj, preposition) =
{
self.location.dobjGen(actor, verb, indirectobj, preposition);
}
iobjGen(actor, verb, directobj, preposition) =
{
self.location.iobjGen(actor, verb, directobj, preposition);
}
;

zhvala : bodypart
location = megaant
desc = 'жвала/2'
adjective = 'муравья' 'муравья#r' 'муравью' 'муравью#r'
ldesc = "Большие страшные жвала. "
;
</pre>
Теперь "ударить муравья по жвалам палкой" будет равнозначно "ударить муравья палкой".
Если вы хотите сделать отличную от такой реакцию, то напишите исключение для конкретных значений параметра verb.

==Усложнение принимаемых фраз==
'''Как заставить понимать команду с тремя существительными, ввести наречия, сделать несколько проходов в одной стороне света и т.п.'''

Большинство таких нестандартных подходов не стоят затрачиваемых усилий для их реализации. Постарайтесь упростить те случаи для которых вы хотите их использовать.

Например, по порядку:
# привязать лошадь веревкой к забору = привязать веревку к забору и привязать веревку к лошади
# тихо открыть дверь = смазать петли салом и открыть дверь
# на юге вы видите три пещеры. Кровавый след тянется в ту, что западнее, а из восточной выползает вязкий белесый туман

[[Категория:Для разработчиков игр]]

RTADS FAQ

2010-04-20T15:49:29Z

Feuerbart: мелкие опечатки

'''''Часто Задаваемые Вопросы и Ответы о системе RTADS'''''

==Мультимедиа==

'''Вопрос от Zargo: Подскажите, пожалуйста, как можно подключить графику и звук в игру и можно ли вообще это сделать на RTADSе.'''

Можно, для интерпретаторов с поддержкой мультимедиа. Это проигрыватели для систем Windows, Macintosh и Linux.
Выглядит и реализуется как HTML верстка с некоторыми ограничениями. Графические/музыкальные ресурсы можно зашить в файл игры или распространять отдельными файлами. Графика: jpg, png, mng. Последний позволяет отображать анимированные изображения. Также можно воспроизводить анимацию из последовательности jpg, динамическим контентом или псевдографикой. Поддержка Gif не была реализована по причине ограничений лицензии.

'''Вопрос от [[ifn00b]]： Касательно мультимедийных возможностей - какие типы аудио-файлов можно подключить к RTADS? И каким образом происходит их проигрывание - интерпретатор вызывает внешнее приложение, которое зарегистрировано в системе для файлов данного типа?'''

Midi, wav, MP3 и Ogg Vorbis.
Для проигрывания используется DirectX.

Подробно обо всем этом можно узнать здесь (увы, на английском языке):
http://www.tela.bc.ca/tads-manual/tads-12.html

P.S. По мнению большей части сообщества, избыток графики и звука уводит от настоящего IF. Будьте очень осторожны и используйте эти возможности тогда, когда это оправдано.

==Сборка и компиляция==
'''Чем отличаются debug и release версии игры?'''

В debug версию включается дополнтельная информация, которая позволяет отлаживать игру в TADS Workbench. Из-за этого: во-первых, существенно увеличивается размер файла, во-вторых, весь текст записывается в открытом виде и может быть просмотрен любым редактором, в-третьих, старые версии интерпретаторов могут слетать на играх с длинными строками, скомпилированными в отладочном режиме.

Вывод: при выпуске игры в свет не забывайте компилировать и выкладывать release версию.

==Отладка==

'''Есть ли в ТАДС способы автоматического тестирования библиотек и игр?'''

В отладочных целях ещё в первых версиях ТАДС двадцатилетней давности были предусмотрены средства ввода команд из файла и вывода результата в другой файл. Таким образом, можно сверять файлы результатов с целью проверки корректности работы игры после последних изменений и её проходимость,
без необходимости внимательного "ручного" просмотра.

Подробно это описано в пока непереведенной главе мануала:
[http://teladesign.com/tads-manual/tads-b.html Параграф "Testing Your Game"]

Вкратце:
mygame.exe -o walkthru.in - записывает в файл команды по мере прохождения
mygame.exe -i walkthru.in -l walkthru.log - запускает игру и вводит список команд,
а выходящий текст записывает в файл.
Файл с выводом из предыдущей и новой версии можно сравнить с помощью специальных программ, типа [http://winmerge.org/ WinMerge].

==Синтаксис==
'''Почему индексация массивов и строк начинается с единицы?!'''

Конечно же, это риторический вопрос. Но довольно часто ошибки в игре вызываются тем, что автор «на автомате» впечатал уже отложившийся на подкорке кусочек кода, который сработал бы для массивов, начинающихся с 0. Поэтому если у вас появляются ошибки выхода за пределы массива или строки какие-то обрезанные выводятся – в первую очередь проверяйте код, работающий с индексами массивов.

'''Никак не могу привыкнуть к этому полупаскальному-полусишному синтаксису. Можно ли как-нибудь привести его к единой форме?'''

Да. Существует специальная директива <tt>#pragma C+</tt>. Она включает режим соответствия языку C для файла, в котором упомянута, поэтому вы сможете использовать привычные <tt>==</tt> для сравнения и <tt>=</tt> для присваивания. А директива <tt>#pragma C-</tt> возвращает все к стандартному виду.

Совет: если вы разрабатываете модуль, который затем может быть использован другими людьми, директивой <tt>#pragma</tt> явно указывайте стиль, используемый в файле, чтобы авторские настройки не повлияли на работу вашего модуля.

'''Как создать список (list) из одного элемента?'''

Если вы задали переменную "a" без указания какого либо типа, т.е.
local a;
то присвоить ей список из одного элемента
a := [b];
не удастся.

Нужно либо изначально указать что это список
local a=[];
либо поступить так:
a := [] + b;

'''При вызове метода foo() без аргументов возникает ошибка компиляции.'''

Если метод не принимает аргументов, то сотрите скобки при его вызове.
bar.foo(); //ошибка
bar.foo; //вызов метода

При объявлении метода скобки все-равно нужны!

==Неочевидные приемы==
'''Почему не наследуются лексические свойства (sdecs, noun и пр.)?'''

В стремлении упростить жизнь авторам игр, TADS не делает особых различий между классом и объектом (экземпляром класса). Однако отличия есть, хоть и небольшие. Во-первых, класс нематериален в игре — вы никак не сможете взаимодействовать с ним. Во-вторых (уже догадались?) ''лексические'' свойства (sdesc, ldesc, noun, adjective) наследуются только от классов, а от объектов нет.

Пример:
<pre>
coin : item
desc = 'золотая/1пж монета/1ж'
ldesc = "Золотая монета с изображением профиля Императора. "
isHer = true
;

coin1 : coin
location = treasury
;

coin2 : coin
location = chest
;

coin3 : coin
location = purse
;
</pre>
В таком виде пример работать не будет, потому что лексические свойства объекта coin не наследуются потомками. Соответственно, вы просто не найдете монет в игре, потому что к ним никак нельзя будет обратиться (свойство noun-то не заполнено!). Уже догадались, как исправить? Правильно, пишем в первой строке:
class coin : item
и все встает на свои места.

Примечание: на момент написания заметки библиотека находилась в состоянии активной разработки и desc, к примеру, стал наследоваться нормально, просто дублируя словоформы много раз. Несмотря на это, рекомендуется ВСЕГДА использовать классы, если требуется наследовать лексические свойства.

'''Как динамически изменить ldesc (и другие свойства с двойными кавычками)?'''

Двойные кавычки (") — удобная особенность языка TADS, однако принцип их работы может немного смутить новичков. Двойные кавычки служат для вывода текста на экран, то есть, как только в ходе выполнения программы интерпретатор встречает строку в двойных кавычках, он тут же отображает её. Если строка в двойных кавычках присвоена в качестве свойства какого-либо объекта, то она будет отображаться при каждом обращении к этому свойству. Смысл этого в том, чтобы облегчить автору работу с текстом — базовой единицей всей [[ИЛ]].
При этом следует понимать, что строка в двойных кавычках — это не переменная как таковая, а, фактически, завуалированный метод для вывода переданного текста на экран. Он ничего не возвращает, поэтому строками в двойных кавычках нельзя манипулировать так же, как обычными переменными. Например, следующий, на первый взгляд правильный код не будет работать:

<pre>
vase : item
gdesc = 'ваза/1ж'
ldesc = "Хрупкая фарфоровая ваза. "
...

doDrop(actor) =
{
"Ваза была так тонка, что разбилась при падении. ";
self.ldesc := "Теперь ваза представляет собой лишь груду черепков. ";
pass doDrop;
}
;
</pre>

Так как метод «двойные кавычки» ничего на самом деле не возвращает, <tt>ldesc</tt> в данном примере перепишется пустым значением и описание исчезнет вообще. Для решения этой проблемы следует переписать определение <tt>ldesc</tt> вот так:

<pre>
vase : item
gdesc = 'ваза/1ж'
ldesc =
{
if (not self.broken)
"Хрупкая фарфоровая ваза. ";
else
"Теперь ваза представляет собой лишь груду черепков. ";
}

broken = nil
...

doDrop(actor) =
{
"Ваза была так тонка, что разбилась при падении. ";
self.broken := true;
pass doDrop;
}
;
</pre>

Ещё один способ - вставить в строку с двойными кавычками вызов изменяемого свойства. Например:
<pre>
vase : item
gdesc = 'ваза/1ж'
ldesc =
{
if (not self.broken)
"Хрупкая фарфоровая ваза. ";
else
"Из-за <<negodyai>> ваза превратилась в груду черепков. ";
}

broken = nil
negodyai=''
...

doDrop(actor) =
{
"Ваза была так тонка, что разбилась при падении. ";
self.broken := true;
negoyai:=dToS(actor,rdesc);
// функция dToS перехватывает вывод на экран "двукавычного"
// свойства rdesc и присваивает переменной negoyai
pass doDrop;
}
;
</pre>

Здесь мы превратили свойство rdesc действующего актера из строки с двойными кавычками в строку с одинарными и записали в объекте. Это свойство мы можем менять по ходу всей игры, и это будет менять описание. В данном случае - виновника происшествия.

'''Как реализовать части тела или объекта?'''

Как пример сложной фразы часто приводят примеры из серии:
врезать/ударить/пнуть ногой/хвостом/ёжиком (по) лбу/ноге/ягодицам/сенсорам монстра/робота/тети Клавы
На самом деле, это реализуется довольно просто:
<pre>
class bodypart: fixeditem
dobjGen(actor, verb, indirectobj, preposition) =
{
self.location.dobjGen(actor, verb, indirectobj, preposition);
}
iobjGen(actor, verb, directobj, preposition) =
{
self.location.iobjGen(actor, verb, directobj, preposition);
}
;

zhvala : bodypart
location = megaant
desc = 'жвала/2'
adjective = 'муравья' 'муравья#r' 'муравью' 'муравью#r'
ldesc = "Большие страшные жвала. "
;
</pre>
Теперь "ударить муравья по жвалам палкой" будет равнозначно "ударить муравья палкой".
Если вы хотите сделать отличную от такой реакцию, то напишите исключние для конкретных значений параметра verb.

==Усложнение принимаемых фраз==
'''Как заставить понимать команду с тремя существительными, ввести наречия, сделать несколько проходов в одной стороне света и т.п.'''

Большинство таких нестандартных подходов не стоят затрачиваемых усилий для их реализации. Постарайтесь упростить те случаи для которых вы хотите их использовать.

Например, по порядку:
# привязать лошадь веревкой к забору = привязать веревку к забору и привязать веревку к лошади
# тихо открыть дверь = смазать петли салом и открыть дверь
# на юге вы видите три пещеры. Кровавый след тянется в ту, что западнее, а из восточной выползает вязкий белесый туман

[[Категория:Для разработчиков игр]]

RTADS FAQ

2010-04-20T15:47:40Z

Feuerbart: /* Мультимедиа */

'''''Часто Задаваемые Вопросы и Ответы о системе RTADS'''''

==Мультимедиа==

'''Вопрос от Zargo: Подскажите, пожалуйста, как можно подключить графику и звук в игру и можно ли вообще это сделать на RTADSе.'''

Можно, для интерпретаторов с поддержкой мультимедиа. Это проигрыватели для систем Windows, Macintosh и Linux.
Выглядит и реализуется как HTML верстка с некоторыми ограничениями. Графические/музыкальные ресурсы можно зашить в файл игры или распространять отдельными файлами. Графика: jpg, png, mng. Последний позволяет отображать анимированные изображения. Также можно воспроизводить анимацию из последовательности jpg, динамическим контентом или псевдографикой. Поддержка Gif не была реализована по причине ограничений лицензии.

'''Вопрос от [[ifn00b]]： Касательно мультимедийных возможностей - какие типы аудио-файлов можно подключить к RTADS? И каким образом происходит их проигрывание - интерпретатор вызывает внешнее приложение, которое зарегистрировано в системе для файлов данного типа?'''

Midi, wav, MP3 и Ogg Vorbis.
Для проигрывания используется DirectX.

Подробно обо всем этом можно узнать здесь (увы, на английском языке):
http://www.tela.bc.ca/tads-manual/tads-12.html

P.S. По мнению большей части сообщества, избыток графики и звука уводит от настоящего IF. Будьте очень осторожны и используйте эти возможности тогда, когда это оправдано.

==Сборка и компиляция==
'''Чем отличаются debug и release версии игры?'''

В debug версию включается дополнтельная информация, которая позволяет отлаживать игру в TADS Workbench. Из-за этого: во-первых, существенно увеличивается размер файла, во-вторых, весь текст записывается в открытом виде и может быть просмотрен любым редактором, в-третьих, старые версии интерпретаторов могут слетать на играх с длинными строками, скомпилированными в отладочном режиме.

Вывод: при выпуске игры в свет не забывайте компилировать и выкладывать release версию.

==Отладка==

'''Есть ли в ТАДС способы автоматического тестирования библиотек и игр?'''

В отладочных целях ещё в первых версиях ТАДС двадцетилетней давности были предусмотрены средства ввода команд из файла и вывода результата в другой файл. Таким образом можно сверять файлы результатов с целью проверки корректности работы игры после последних изменений и её проходимость,
без необходимости внимательного "ручного" просмотра.

Подробно это описано в пока непереведенной главе мануала:
[http://teladesign.com/tads-manual/tads-b.html Параграф "Testing Your Game"]

Вкратце:
mygame.exe -o walkthru.in - записывает в файл команды по мере прохождения
mygame.exe -i walkthru.in -l walkthru.log - запускает игру и вводит список команд,
а выходящий текст записывает в файл.
Файл с выводом из предыдущей и новой версии можно сравнить с помощью специальных программ, типа [http://winmerge.org/ WinMerge].

==Синтаксис==
'''Почему индексация массивов и строк начинается с единицы?!'''

Конечно же, это риторический вопрос. Но довольно часто ошибки в игре вызываются тем, что автор «на автомате» впечатал уже отложившийся на подкорке кусочек кода, который сработал бы для массивов, начинающихся с 0. Поэтому если у вас появляются ошибки выхода за пределы массива или строки какие-то обрезанные выводятся – в первую очередь проверяйте код, работающий с индексами массивов.

'''Никак не могу привыкнуть к этому полупаскальному-полусишному синтаксису. Можно ли как-нибудь привести его к единой форме?'''

Да. Существует специальная директива <tt>#pragma C+</tt>. Она включает режим соответствия языку C для файла, в котором упомянута, поэтому вы сможете использовать привычные <tt>==</tt> для сравнения и <tt>=</tt> для присваивания. А директива <tt>#pragma C-</tt> возвращает все к стандартному виду.

Совет: если вы разрабатываете модуль, который затем может быть использован другими людьми, директивой <tt>#pragma</tt> явно указывайте стиль, используемый в файле, чтобы авторские настройки не повлияли на работу вашего модуля.

'''Как создать список (list) из одного элемента?'''

Если вы задали переменную "a" без указания какого либо типа, т.е.
local a;
то присвоить ей список из одного элемента
a := [b];
не удастся.

Нужно либо изначально указать что это список
local a=[];
либо поступить так:
a := [] + b;

'''При вызове метода foo() без аргументов возникает ошибка компиляции.'''

Если метод не принимает аргументов, то сотрите скобки при его вызове.
bar.foo(); //ошибка
bar.foo; //вызов метода

При объявлении метода скобки все-равно нужны!

==Неочевидные приемы==
'''Почему не наследуются лексические свойства (sdecs, noun и пр.)?'''

В стремлении упростить жизнь авторам игр, TADS не делает особых различий между классом и объектом (экземпляром класса). Однако отличия есть, хоть и небольшие. Во-первых, класс нематериален в игре — вы никак не сможете взаимодействовать с ним. Во-вторых (уже догадались?) ''лексические'' свойства (sdesc, ldesc, noun, adjective) наследуются только от классов, а от объектов нет.

Пример:
<pre>
coin : item
desc = 'золотая/1пж монета/1ж'
ldesc = "Золотая монета с изображением профиля Императора. "
isHer = true
;

coin1 : coin
location = treasury
;

coin2 : coin
location = chest
;

coin3 : coin
location = purse
;
</pre>
В таком виде пример работать не будет, потому что лексические свойства объекта coin не наследуются потомками. Соответственно, вы просто не найдете монет в игре, потому что к ним никак нельзя будет обратиться (свойство noun-то не заполнено!). Уже догадались, как исправить? Правильно, пишем в первой строке:
class coin : item
и все встает на свои места.

Примечание: на момент написания заметки библиотека находилась в состоянии активной разработки и desc, к примеру, стал наследоваться нормально, просто дублируя словоформы много раз. Несмотря на это, рекомендуется ВСЕГДА использовать классы, если требуется наследовать лексические свойства.

'''Как динамически изменить ldesc (и другие свойства с двойными кавычками)?'''

Двойные кавычки (") — удобная особенность языка TADS, однако принцип их работы может немного смутить новичков. Двойные кавычки служат для вывода текста на экран, то есть, как только в ходе выполнения программы интерпретатор встречает строку в двойных кавычках, он тут же отображает её. Если строка в двойных кавычках присвоена в качестве свойства какого-либо объекта, то она будет отображаться при каждом обращении к этому свойству. Смысл этого в том, чтобы облегчить автору работу с текстом — базовой единицей всей [[ИЛ]].
При этом следует понимать, что строка в двойных кавычках — это не переменная как таковая, а, фактически, завуалированный метод для вывода переданного текста на экран. Он ничего не возвращает, поэтому строками в двойных кавычках нельзя манипулировать так же, как обычными переменными. Например, следующий, на первый взгляд правильный код не будет работать:

<pre>
vase : item
gdesc = 'ваза/1ж'
ldesc = "Хрупкая фарфоровая ваза. "
...

doDrop(actor) =
{
"Ваза была так тонка, что разбилась при падении. ";
self.ldesc := "Теперь ваза представляет собой лишь груду черепков. ";
pass doDrop;
}
;
</pre>

Так как метод «двойные кавычки» ничего на самом деле не возвращает, <tt>ldesc</tt> в данном примере перепишется пустым значением и описание исчезнет вообще. Для решения этой проблемы следует переписать определение <tt>ldesc</tt> вот так:

<pre>
vase : item
gdesc = 'ваза/1ж'
ldesc =
{
if (not self.broken)
"Хрупкая фарфоровая ваза. ";
else
"Теперь ваза представляет собой лишь груду черепков. ";
}

broken = nil
...

doDrop(actor) =
{
"Ваза была так тонка, что разбилась при падении. ";
self.broken := true;
pass doDrop;
}
;
</pre>

Ещё один способ - вставить в строку с двойными кавычками вызов изменяемого свойства. Например:
<pre>
vase : item
gdesc = 'ваза/1ж'
ldesc =
{
if (not self.broken)
"Хрупкая фарфоровая ваза. ";
else
"Из-за <<negodyai>> ваза превратилась в груду черепков. ";
}

broken = nil
negodyai=''
...

doDrop(actor) =
{
"Ваза была так тонка, что разбилась при падении. ";
self.broken := true;
negoyai:=dToS(actor,rdesc);
// функция dToS перехватывает вывод на экран "двукавычного"
// свойства rdesc и присваивает переменной negoyai
pass doDrop;
}
;
</pre>

Здесь мы превратили свойство rdesc действующего актера из строки с двойными кавычками в строку с одинарными и записали в объекте. Это свойство мы можем менять по ходу всей игры, и это будет менять описание. В данном случае - виновника происшествия.

'''Как реализовать части тела или объекта?'''

Как пример сложной фразы часто приводят примеры из серии:
врезать/ударить/пнуть ногой/хвостом/ёжиком (по) лбу/ноге/ягодицам/сенсорам монстра/робота/тети Клавы
На самом деле, это реализуется довольно просто:
<pre>
class bodypart: fixeditem
dobjGen(actor, verb, indirectobj, preposition) =
{
self.location.dobjGen(actor, verb, indirectobj, preposition);
}
iobjGen(actor, verb, directobj, preposition) =
{
self.location.iobjGen(actor, verb, directobj, preposition);
}
;

zhvala : bodypart
location = megaant
desc = 'жвала/2'
adjective = 'муравья' 'муравья#r' 'муравью' 'муравью#r'
ldesc = "Большие страшные жвала. "
;
</pre>
Теперь "ударить муравья по жвалам палкой" будет равнозначно "ударить муравья палкой".
Если вы хотите сделать отличную от такой реакцию, то напишите исключние для конкретных значений параметра verb.

==Усложнение принимаемых фраз==
'''Как заставить понимать команду с тремя существительными, ввести наречия, сделать несколько проходов в одной стороне света и т.п.'''

Большинство таких нестандартных подходов не стоят затрачиваемых усилий для их реализации. Постарайтесь упростить те случаи для которых вы хотите их использовать.

Например, по порядку:
# привязать лошадь веревкой к забору = привязать веревку к забору и привязать веревку к лошади
# тихо открыть дверь = смазать петли салом и открыть дверь
# на юге вы видите три пещеры. Кровавый след тянется в ту, что западнее, а из восточной выползает вязкий белесый туман

[[Категория:Для разработчиков игр]]