ok (obj, textIfIsThem, textIfIsHim, textIfIsNeuter, textIfIsHer) : универсальная функция вывода окончаний на основании свойства объекта obj. Выводимые окончания определяются остальными четырьмя параметрами (которые должны быть строками, заключенными в двойные кавычки): textIfIsThem выводится, если объект имеет множественное число (его свойство isThem имеет значение true), textIfIsHim - если для объекта определено равным true свойство isHim (признак мужского рода), textIfIsHer - если для объекта определено равным true свойство isHer (признак женского рода), textIfIsNeuter - если объект имеет средний род (он признается таковым, если оба "родовых" свойства isHim и isHer имеют одинаковое значение (неважно, true или nil).

oyay: function(obj): формирует и выводит окончания прилагательных в первом лице в соответствии с правилами русского языка (типа "ие", "ая", "ой", "ое"). Для выбора нужного окончания используются свойства объекта obj: isThem - определяет число (если оно равно true, то число множественное, если nil - единственное); isHer и isHim, также принимающие значения true или nil - определяют соответственно женский и мужской род. Если оба последних свойства имеют одинаковое значение (неважно, какое), то функция считает, что объект obj - среднего рода.

Данная функция является предопределенной и служит для модификации работы синтаксического анализатора. Подробно ее работа будет рассмотрена в соответствующем разделе.

Данная функция является предопределенной и служит для модификации работы синтаксического анализатора. Подробно ее работа будет рассмотрена в соответствующем разделе.

Данная функция является предопределенной и служит для модификации работы синтаксического анализатора. Подробно ее работа будет рассмотрена в соответствующем разделе.

saas: function(obj): формирует и выводит окончания возвратных глаголов в прошедшем времени аналогично функции glsok, однако для анализа вместо передаваемых аргументов используются свойства объекта obj: isHer и isHim интерпретируются аналогично аргументам grod и mrod, а isThem - аналогично аргументу chislo. Значение признака типа глагола (аргумент ca функции glsok) здесь не используется; функция работает так, как если бы этот аргумент был равен 1. См. также функции ella, iao.

yao: function(obj): функция работает аналогично функции kpstok, однако для анализа вместо передаваемых аргументов используются свойства объекта obj: свойство isHim соответствует аргументу mrod функции kpstok, свойство isHer - аргументу grod, а isThem - аргументу chislo.

ZA: function(str): преобразует первую букву строкового аргумента str (который представляет собой строку, заключенную в одинарные кавычки) в заглавную (это происходит только в том случае, если первый символ str - это строчная буква русского алфавита; для всех остальных символов, в т. ч. для букв латинского алфавита, ничего не происходит), а затем выводит получившуюся строку на экран. Необходимость в данной функции возникает в связи с тем, что встроенная функция caps() не работает с кириллицей. См. также функцию ZAG.

ZAG: function(obj, prop): аналог встроенной функции TADS caps() для кириллицы. Меняет первую букву свойства prop объекта obj, которое должно быть строкой, заключенной в двойные кавычки, на заглавную (работает только для строчных букв кириллицы; если первый символ prop иной, то он не меняется), после чего результирующая строка выводится на экран. См. также функцию ZA.

Actor: fixeditem, movableActor. Персонаж в игре. Свойство maxweight определяет максимальный вес (сумму свойств weight всех объектов в инвентаре), а свойство maxbulk - максимальный объем (соответственно, сумму свойств weight), который этот персонаж (или актер) может носить с собой. Метод actorAction(verb, directObject, preposition, indirectObject) определяет реакцию персонажа на команду игрока (по умолчанию персонаж игнорирует команду, при этом выводится соответствующее сообщение). При этом следует учесть, что если при обработке этого метода программа-интерпретатор не встретит инструкцию exit, то, выполнив все указанные в методе действия, команда далее будет обрабатываться как ни в чем не бывало (что, как правило, нежелательно) (см. также описание данного метода для класса thing). Метод isCarrying(object) возвращает true, если предмет object находится в инвентаре персонажа (даже в случае, если персонаж несет контейнер, в котором (с любым уровнем вложений) находится предмет). Метод actorDesc служит для отображения сообщения, что персонаж находится в комнате; это сообщение выводится при отображении описания комнаты. Метод verGrab(object) вызывается при попытке взять какой-либо предмет из инвентаря персонажа; по умолчанию персонажи не отдают то, что у них в руках. См. также определение данного метода для класса thing).

Если требуется, чтобы игрок мог следовать за персонажем (команда "следовать за..."), следует создать объект-"тень" класса follower и установить свойство myfollower персонажа равным данному объекту. При этом объект-"тень" автоматически будет перемещаться за персонажем, отставая от него на один ход, чтобы игрок мог следовать за ним.

basicMe: Actor, floatingItem. Реализация по умолчанию для объекта, соответствующего игроку (этот объект, как правило, носит название Me). В файле advr.t определен класс basicMe, а не объект Me, чтобы автор игры мог заменить часть определений по умолчанию, сохранив большую их часть, и не модифицироваь при этом файл advr.t непосредственно. Чтобы использовать класс basicMe в качестве главного персонажа вашей игры без изменений, влючите в код вашей игры следующую инструкцию: "Me: basicMe;".

В классе basicMe определяются все те же методы и атрибуты, что и для прочих персонажей, с указанием соответствующих значений для главного персонажа. Для него определено лексическое свойство noun c указаним различных форм местоимения "я". Свойство sdesc выводит "ты"; соответствующим образом определены также свойства, отвечающие за отображение краткого описания в различных падежах, а также форматные строки. Кроме того, переопределены методы actorAction (чтобы главному персонажу можно было давать команды), travelTo, moveInto и ряд других.

basicNumObj: object. Данный класс является реализацией по умолчанию для так называемого нумерованного объекта (или объекта-числа) numObj (такой объект используется, например, в качестве значений для объектов класса dialItem в командах вида "установить переключатель на 8"). Атрибут value соответствует текущему числу (в рассмотренной выше команде он будет равен восьми). Чтобы использовать данный класс без изменений, включите в Вашу игру следующее определение: "numObj: basicNumObj;".

basicStrObj: object. Данный класс является реализацией по умолчанию для так называемого строкового объекта (или объекта-строки) strObj (такой объект используется для представления в вводимых игроком командах строк в двойных кавычках, например, "напечатать "привет" на клавиатуре"). Атрибут value соответствует текущей строке (в рассмотренной выше команде он будет равен "привет"). Чтобы использовать данный класс без изменений, включите в Вашу игру следующее определение: "strObj: basicStrObj;".

beditem: chairitem. Объект-кровать. В целом аналогичен объекту-стулу (chairitem); единственное отличие состоит в том, что игрок описывается лежащим на объекте, а не сидящим.

behindHider: hider. Этот класс аналогичен классу underHider, только предметы скрываются не под, а за "объектом-укрытием". Для спрятанных за объектом данного класса предметов свойство behindLoc должно ссылаться на "объект-укрытие". См. также searchHider.

Объекты, скрываемые посредством объекта класса behindHider, должны принадлежать классу hiddenItem.

buttonitem: fixeditem. Объект-кнопка (нажимаемая). Для объектов этого класса автор игры должен определить собственный метод doPush(actor), обрабатывающий команду "нажать на..." и выполняющий все требуемые действия. Обратите внимание, что для всех кнопок определено лексическое свойство-существительное "кнопка" (его тоже можно переопределить).

chairitem: fixeditem, nestedroom, surface. Объект-стул, на котором игрок и другие персонажи могут сидеть. Сидя на стуле, персонаж не может никуда переместиться, пока не встанет, и может манипулировать только объектами, включенными в список, определяемый свойством reachable стула. Обратите внимание, что между стульями и кроватями в стандартном варианте нет сколь-либо значительных различий, и как на стульях, так и на кроватях можно и сидеть, и лежать; единственная разница состоит в выводимом при этом сообщении. См. также beditem.

clothingItem: item. Предмет одежды. По умолчанию, когда игрок одевает на себя одежду, не происходит ничего, кроме того, что атрибут isworn устанавливается равным true. Для реализации каких-либо других эффектов требуется переопределить метод doWear(actor) для данного класса. Кроме того, обратите внимание, что, когда предмет этого класса одет на игрока (или - в общем случае - на другого персонажа), выполнение определенных действий автоматически приведет к тому, что данный персонаж снимет этот предмет одежды (например, если дать команду "бросить предмет"). Чтобы добиться иного порядка обработки таких команд, переопределите метод checkDrop; если вы хотите запретить такие действия над предметом, когда предмет одет на персонажа, включите в метод checkDrop инструкцию exit.

container: item. Объект-контейнер, в который можно класть другие предметы. Атрибут-флаг iscontainer установлен равным true. Свойство ldesc для данного класса по умолчанию выводит список предметов, находящихся в нем (если таковые имеются). Атрибут maxbulk определяет максимальный объем предметов (определеяемый как сумма атрибутов bulk всех предметов - см. также класс thing), который можно поместить в контейнер (по умолчанию этот атрибут равен 10). Свойство isopen, определяющее, открыт ли контейнер, здесь установлено равным true (т. е. контейнер не закрывается). См. также класс surface.

darkroom: room. Темная комната. Чтобы перемещаться по ней, а также выполнять большую часть других действий, игроку необходимо принести в нее источник света (объект класса lightsource). Обратите внимание, что освещение в комнате можно также включить, установив его свойство lightsOn равным true. Лучше включать освещение именно таким образом, а не установкой свойства islit, поскольку последнее является методом, проверяющим наличие источника света в комнате.

darkVerb: deepverb. Глагол, который "работает" в темном помещении (класса darkroom). К таковым относятся все глаголы перемещения (класс travelVerb), а также системные глаголы (типа "сохранить", "восстановить", "отчет"). Кроме того, к этому классу относится еще ряд глаголов:например, в темноте игрок может бросить что-либо из своего инвентаря, или включить фонарь, который он держит в руках. Атрибут-флаг isDarkVerb, равный для данного класса true, служит дополнительным признаком, что тот или иной объект-глагол принадлежит данному классу.

decoration: fixeditem. Объект-декорация, не имеющий никакой функции в игре. Соответствующие предметы нельзя взять, подвинуть либо взаимодействовать с ними каким-либо другим образом; их можно только осмотреть. Использование таких объектов способно повысить "играбельность", поскольку позволяет без значительных трудозатрат обеспечить распознавание синтаксическим анализатором всех слов, которые используются в описании комнаты.

deepverb: object. "Объект-глагол", к которому обращается синтаксический анализатор, когда игрок введет глагол, соответствующий лексическим свойствам этого объекта, в своей команде. Каждый объект данного класса содержит как список глаголов, ему соответствующих, так и описание допустимого синтаксиса команды. Свойство verb содержит перечисление всех глаголов, при употреблении которых в команде произойдет обращение к данному объекту. Можно использовать как одиночные слова (как, например, 'пройти', так и пару слов (например, 'пройти сквозь'). В последнем случае второе слово может быть перемещено в конец команды (примечание переводчика: это очень актуально для английского языка и менее актуально для русского. Однако и в русском можно придумать команды, для которых это свойство будет проявляться; например, если определить глагол "поднять" и указать в его свойстве verb словосочетание 'поднять наверх', то игра будет понимать как команду "поднять наверх корзину", так и "поднять корзину наверх"). Метод action(actor) определяет реакцию игры, если глагол употреблен самостоятельно (например, игрок ввел команду "осмотреться" или "север"); если данный метод не определен, то глагол не может быть употреблен таким образом. (Аргумент actor - это персонаж, который должен выполнить команду (по умолчанию это главный персонаж, но, например, в команде вида "Бобик, прыгай" в качестве аргумента actor будет передан объект, соответствующий персонажу (Бобику)). Атрибут doAction определяет общий корень названия методов (должен быть заключен в одинарные кавычки), которые будут обрабатывать команду, состоящую из глагола и "прямого" объекта (команды вида "взять камень" или "прыгнуть через забор"). Например, если для некоторого глагола указано определение doAction='Jump', то обработку команды, состоящей из глагола и "прямого" объекта, будут выполнять методы verDoJump и doJump этого "прямого" объекта. Аналогично, атрибут ioAction(preposition) определяет семейство методов-обработчиков для команды вида "глагол-прямой объект-предлог-косвенный объект" (например, "положи тетрадь на стол"). Аргумент preposition - это предлог, употребляемый с данным глаголом. Для одного глагола можно определять несколько атрибутов ioAction, по одному для каждого предлога. Подробнее о роли и порядке работы методов-обработчиков команд см. в разделе Создание собственных глаголов главы седьмой.

Метод validDo(actor, object, seqno) возвращает true, если указанный объект object допустим в качестве "прямого" объекта для персонажа actor. Аналогичным образом метод validIo(actor, object, seqno) возвращает true, если указанный объект можно использовать в качестве "косвенного". Аргумент seqno в обоих случаях - это номер объекта по порядку (начиная с 1-го) (в командах, где требуется обработка сразу нескольких объектов (например, "взять все"). Как правило, этот параметр игнорируется, но теоретически могут возникнуть случаи, когда может потребоваться его анализ. Например, объект askVerb (соответствующий глаголу "спросить") не делает различий между объектами, соответствующими одному и тому же набору лексических свойств, и поэтому обрабатывает только первый объект из общего списка "подходящих" объектов. Как правило, автору игры эти методы (validDo и validIo) менять не требуется; в общем случае они возвращают true, если объект доступен персонажу для манипуляций.

Методы doDefault(actor, prep, indirectObject) и ioDefault(actor, prep) возвращают список, соответственно, "прямых" и "косвенных" объектов по умолчанию. Эти списки используются для определения того, какие объекты имеются в виду, если в команде используется слово "все", а также подбирают подходящие объекты, если игрок вообще не упомянул в своей команде объектов (например, дал команду "отпереть" вместо "отпереть дверь"). Как правило, эти методы возвращают список всех объектов, для которых применима данная команда (т. е. тех, чьи обработчики-верификаторы, соответствующие данной команде, не выдают сообщений; подробнее об этом см. главу 4).

Методы validDoList(actor, prep, indirectObject) и validIoList(actor, prep, directObject) возвращают список список всех объектов, для которых имеет смысл выполнять, соответственно, validDo или validIo. В принципе без этих методов можно обойтись; их единственная цель - произвести грубую предварительную проверку объектов, чтобы сократить число вызовов validDo и validIo и таким образом повысить производительность (скорость работы) игры - каждое выполнение validDo или validIo требует довольно значительных затрат времени.

Атрибут type определяет тип глагола для определения окончания глагола (см. функцию glok). Свойство vopr указывает, какое местоимение будет выводить игра, если игрок пропустит объект в своей команде (например, если игрок даст команду "лечь"). Свойство vopr определяет, какой вопрос будет задавать игра, если игрок пропустил в своей команде объект. Например, если будет дана команда "отпереть", игра задаст вопрос "Что вы хотите отпереть?" (для этого глагола vopr = "Что "), а если ввести "сойти", игра спросит "Откуда вы хотите сойти?" (vopr = "Откуда ").

dialItem: fixeditem. Данный класс используется для создания "циферблатов", т. е. переключателей, которые можно установить на определенное значение (например, таких, как регулятор интенсивности нагрева конфорок бытовой плиты). При реализации объекта этого класса автору необходимо указать значения свойств minsetting и maxsetting, определяющих, соответственно, минимальное и максимальное число, на которое можно установить данный объект (например, для вышеупомянутого регулятора плиты эти значения могут составлять: minsetting = 0 (конфорка выключена), maxsetting = 3 (максимальная степень нагрева - считаем, что регулятор у нас трехступенчатый). По умолчанию эти значения составляют 1 и 10. Свойство setting определяет текущую установку переключателя - она может изменяться игроком посредством команд вида "повернуть переключатель на 3". Метод ldesc для данного класса по умолчанию выводит текущую установку объекта.

distantItem: fixeditem. Определяет предметы, которые находятся слишком далеко, чтобы ими можно было манипулировать, но при этом видны. Реакцией на любые команды, кроме "осмотреть", будет "Предмет слишком далеко." Для объектов-наследников данного класса должны быть определены все обычные свойства предметов: sdesc, ldesc, location, а также лексические свойства.

doorway: fixeditem, obstacle. Объект-дверь, который представляет собой препятствие (obstacle), которое препятствует перемещению в заданном направлении до тех пор, пока его не откроют (этому состоянию двери соответствует значение true, возвращаемое свойством isopen). Если дверь открыта, то игрок (или другой персонаж) при движении в соответствующем направлении попадает в комнату, определяемую свойством doordest. Поскольку дверь является препятствием, то для правильной ее реализации следует присвоить свойству-направлению значение, равное объекту-двери. Если атрибут noAutoOpen не равен true, дверь будет автоматически открываться при попытке игрока перемещаться в соответствующем направлении, если только эта дверь не заперта (свойство islocked не возвращает true). Если дверь заперта, ее можно открыть вводом команды "отпереть дверь", если свойство mykey не установлено равным какому-либо объекту, который в этом случае выполняет роль ключа (при этом дверь можно отпереть, только введя команду "отпереть дверь ключом", при этом для объекта-ключа должны быть определены соответствующие методы (verIoUnlockWith, ioUnlockWith), и, кроме того, он должен иметься в распоряжении игрока. Обратите внимание, что дверь может быть вновь заперта игроком только при соблюдении условий, при которых обеспечивается отпирание двери, а также при выполнении дополнительного условия: свойство islockable должно быть равным true. По умолчанию объект-дверь закрыт; если необходимо, чтобы в начале игры дверь была открыта, установите свойство isopen равным true (при этом необходимо, чтобы и другая сторона двери была открыта - см. далее).

Свойство otherside определяет другую сторону двери (если она есть), расположенную в комнате, куда ведет данная дверь (определяемой свойством doordest). Необходимость данного свойства обуславливается тем, что в реальности дверь существует как бы в двух комнатах сразу. Свойство otherside для двери должно ссылаться на объект того же класса doorway (исключение составляют случаи, когда необходимо добиться некоторых спецэффектов, однако при этом автор игры должен весьма четко представлять, чего именно он хочет добиться - рекомендации здесь давать практически невозможно); при взаимной ссылке свойств otherside двух объектов-дверей друг на друга их состояния (двери закрыты-открыты и заперты-отперты - определяются свойствами isopen и islocked соответственно) будут автоматически синхронизироваться.

Прочие свойства: isdoor - атрибут-флаг, маркирующий данный объект как объект-дверь (равен true); setIsopen и setIslocked - служебные методы, которые "отвечают" соответственно за открытие-закрытие и отпирание-запирание двери и, в частности, обеспечивают синхронизацию состояния двери с другой ее стороной, определяемой свойством otherside.

fixeditem: thing. Объект, который невозможно взять или сдвинуть с места каким-либо другим образом. Обратите внимание, что объекты этого класса могут оказаться частью перемещаемого объекта; это делается, например, для того, чтобы не допустить разделения объектов, когда один объект является неотъемлемой частью другого (например, чайник и носик чайника). По умолчанию, функции, отвечающие за отображение списка объектов в помещении, не включают в этот список объекты класса fixeditem (поскольку их свойство isListed установлено равным nil); это сделано потому, что такие объекты обычно включаются автором игры в подробное описание (свойство ldesc) комнаты. В качестве дополнительной индикации того, что объект является неподвижным, для данного класса определено свойство isfixed, равное true.

floatingItem: object. Этот класс служит исключительно для того, чтобы пометить объект-наследник как присутствующий во всех помещениях игры (это полезно, например, при реализации пола или стен - вместо того, чтобы создавать соответствующие объекты для каждой комнаты, достаточно определить их один раз как наследников данного класса). Необходимость определять такие объекты как принадлежащие данному классу связана с тем, что при инициализации игры объекты этого класса заносятся в список global.floatingList, который анализируется на этапе валидации команды игрока методами validDoList и validIoList (описание этих методов см. в классе deepverb).

follower: Actor. Объект-"тень", повторяющий перемещения персонажа из помещения в помещение. Назначение этого класса - позволить игроку следовать за персонажем, который покинул комнату, введя команду "следовать за". Для каждого персонажа, за которым игрок может следовать, должен быть определен отдельный объект класса follower. Объект-"тень" должен иметь идентичные с соответствующим ему персонажем лексические свойства (noun и adjective). Для этого объекта также необходимо определить свойство myactor так, чтобы оно ссылалось на персонажа, за которым будет следовать игрок при помощи данного объекта-"тени". Атрибут isfollower, равный true, дополнительно помечает объект как объект-"тень". "Тень" всегда отстает от персонажа на одну комнату; к ней неприменимы никакие команды, кроме "следовать за".

fooditem: item. Объект, который можно съесть. При съедании объект удаляется из игры, а значение свойства global.lastMealTime (время последнего приема пищи) уменьшается на величину свойства foodvalue объекта. По умолчанию значение foodvalue равно global.eatTime (этот параметр определяет максимальное количество ходов, которое игрок (точнее, главный персонаж в игре) может обходиться без еды). Таким образом, стандартного съедобного предмета хватит, чтобы поддержать силы игрока в течение стандартного интервала времени. См. также eatDaemon.

hiddenItem: object. Принадлежность предмета к данному классу указывает на то, что он спрятан при помощи объекта, принадлежащего одному из классов hider. Класс hiddenItem не определяет никаких собственных свойств, а используется исключительно для того, чтобы функция инициализации initSearch могла определить и зарегистрировать такие объекты.

hider: item. Это базовый класс для реализации предметов, служащих для скрытия других предметов различными способами. Напрямую он не используется, вместо него используются его дочерние классы - underHider, behindHider и searchHider. Класс определяет метод searchObj(actor, list), которому передается через аргумент list список предметов, скрытых посредством данного объекта (для объекта класса underHider, к примеру, для этого используется свойство underCont); этот метод позволяет игроку "найти" скрытые предметы при подаче соответствующей команды. Некоторые особенности работы этого метода определяются парой дополнительных свойств, определенных для класса hider. Свойство serialSearch определяет, будут ли найдены сразу все скрытые предметы (в случае, если данный объект используется для скрытия более одного предмета); если оно имеет значение nil (значение по умолчанию), то игрок найдет сразу все предметы, если же оно равно true, игроку придется подать команду поиска несколько раз - по числу скрытых предметов, чтобы найти их все. Свойство autoTake определяет, перемещаются ли найденные предметы в инвентарь игрока автоматически: если оно равно true, то игрок автоматически берет найденные предметы, если же nil, то потребуется в явном виде дать команду, чтобы взять предмет. Метод searchObj удаляет из переданного ему списка list найденные предметы. Вызвавшая этот метод процедура (или метод) должна записать его значение в соответствующую переменную (например, для объекта класса underHider это будет свойство underCont), иначе игрок будет получать сообщение о найденном предмете всякий раз, когда будет обыскивать скрывающий объект.

Обратите внимание, что, поскольку объекты класса hider используются для скрытия других объектов, то в нем переопределен метод verDoSearch, "отвечающий" за верификацию команды "обыскать": здесь он выдает сообщение типа "Тебе нужно более детально описать как ты хочешь обыскать данный предмет". Это сделано потому, что сообщение стандартного метода verDoSearch ("Ты не нашел ничего интересного") вводит игрока в заблуждение, создавая у него впечатление, что предмет уже достаточно тщательно обыскан. С другой стороны, для большинства объектов класса hider ситуация, когда общая команда "обыскать" сразу дает нужный результат, также нежелательна (например, требуется "заглянуть под" некий предмет). Поэтому мы просто выдаем сообщение, что простого обыскивания оказалось недостаточно, но не говорим игроку, что конкретно ему надо сделать.

Объекты, скрываемые посредством объекта класса hider, должны принадлежать классу hiddenItem.

item: thing. Обычный предмет, который игрок может взять и носить с собой. Он ничего не весит (свойство weight имеет значение 0) и занимает минимальный объем (свойство bulk равно 1). Свойству bulk можно присвоить большее, чем единица, значение для громоздких предметов, а для мелких предметов, которые не сказываются на способности игрока нести другие предметы (не занимают руки игрока), типа листа бумаги, это свойтво можно установить равным нулю.

keyedLockable: lockable. Данный класс-наследник класса lockable позволяет создать объект-контейнер, который можно отпереть или запереть только при помощи ключа. Ключом будет объект, на который будет ссылаться свойство mykey (при этом сам объект-ключ должен быть наследником класса keyItem).

keyItem: item. Объект, который можно использовать в качестве ключа для объектов класса keyedLockable и lockableDoorway (т. е. отпирать и запирать их). Во всем остальном его поведение соответствует классу item.

lightsource: item. Переносной фонарь, свеча, спичка или другой источник света. Включать и выключать источник света можно при помощи свойства islit. Если это свойство возвращает true, то источник включен (освещает помещение), если же нет, то этот источник совершенно идентичен обычному объекту. Обратите внимание, что стандартное определение класса lightsource определяет метод doTurnon для обработки глагола "включить", обеспечивающий загорание объекта, однако НЕ определяет верификационного метода для этого глагола verDoTurnon. Вследствие этого, если вы определите в вашей игре источник света просто как наследник класса lightsource, его нельзя будет включать и выключать. Чтобы корректно реализовать включение и выключение источника света, сделайте его наследником сразу двух классов - lightsource и switchItem (при этом перечислите классы в определении объекта именно в том порядке, какой здесь указан - в противном случае метод doTurnon класса switchItem "затрет" соответствующий метод класса lightsource). Свойство islamp используется при инициализации игры, в процессе которой, в частности, функцией initSearch регистрируются и заносятся в специальный список все объекты, которые могут служить источниками света (признаком для занесения в список является то, что их свойство islamp равно true). Этот список затем используется в игре для определения, освещена ли та или иная комната (грубо говоря, если в ней присутствует объект из этого списка и он включен, то она освещена, в противном случае выводится описание для темной комнаты). Из сказанного очевидно, что модифицировать это свойство не следует.

lockable: openable. Объект-контейнер, который можно отпирать и запирать; запертое состояние определяется атрибутом islocked (если он равен true, контейнер заперт, и его вначале надо отпереть, чтобы открыть). При этом для отпирания и запирания контейнеров данного класса не требуется ключ; если вы хотите сделать так, чтобы контейнер отпирался и запирался ключом, используйте класс keyedLockable.

lockableDoorway: doorway. Запираемая дверь. Данный класс ничем не отличается от обычной двери (см. doorway), за исключением того, что его атрибуты islockable и islocked установлены равными true. Остальные свойства (в первую очередь otherside и doordest) определяются, как обычно. Если дверь отпирается/запирается при помощи ключа, то свойство mykey следует определить так, чтобы оно ссылалось на объект, который соответствует этому ключу.

movableActor: qcontainer. Этот класс подобен классу Actor, но, в отличие от последнего, игрок может взять персонажа класса movableActor в руки и носить с собой. Данный класс удобно использовать при реализации, например, мелких животных.

Многие атрибуты и методы, определенные в movableActor, описаны при рассмотрении класса Actor. Ниже рассмотрены прочие свойства класса movableActor.

askWord(word, lst) - функция, используемая при реализации команды "спросить персонажа о чем-либо". Здесь word - это то самое "что-либо", о котором спрашивают, а lst - полный список слов в команде (скорее всего, вам не потребуется его анализировать). В настоящее время команды такого вида реализуются не так, как это описано в главе седьмой настоящего Руководства (при выборе ответа анализируется не объект, о котором спрашивается, а слово, которое этому объекту соответствует). Если у вас в игре имеется, скажем, штук 8 объектов, к каждому из которых будет применимо слово "колесо", вы наверняка оцените преимущество такого способа реализации диалога. Если метод askWord возвращает true, дальнейшая обработка слова прекращается, поскольку считается, что персонаж уже ответил. В противном случае вызывается метод disavow. По умолчанию askWord просто возвращает nil, и для реализации осмысленного диалога с персонажем вам обязательно потребуется ее переопределить.

disavow - метод, выводящий ответ персонажа на команду вида "спросить клоуна о цирке" в случае, если персонаж не смог дать осмысленного ответа на поставленный вопрос (см. метод askWord). По умолчанию выводится ответ "Об этом я ничего не знаю."

fmtMe, fmtYou, fmtYour, fmtYoum, fmtYouve - определяют "форматные" строки, позволяющие отображать универсальную реакцию предметов на применяемые к ним команды (этот вопрос рассматривается в другом разделе Руководства по TADS; если коротко, то за счет использования "форматных" строк можно добиться, чтобы при попытке манипулировать предметом (например, командой "взять мяч") выдавалось бы сообщение типа "Ты не можешь взять мяч", если действие пытается выполнить сам игрок, либо, например, "Он не может взять мяч", если игрок дал команду на выполнение действия какому-либо другому персонажу (скажем, "мальчик, возьми мяч").

isactor - специальный флаг, который для персонажей установлен равным true. Служит в качестве дополнительной проверки, является ли тот или иной объект персонажем или просто предметом.

preferredActor - служит для маркировки предпочтительного персонажа при двусмысленной команде (т. е. команде, которая может относиться сразу к двум или более персонажам); персонажам, для которых этот атрибут равен true, будет оказываться предпочтение перед теми, для которых он равен nil.

sayLeaving, sayArriving - методы, выводящие сообщение о том, что персонаж, соответственно, вышел из помещения или вошел в него.

talkdesc - выдает строку, которая выводится на экран, когда игрок пытается поговорить с персонажем, дав команду "поговорить с". По умолчанию выводится "Обычно рассказывают о чём-то или спрашивают о чём-то"; тем самым игроку дают понять, что для организации диалога лучше воспользоваться командами "спросить" или "рассказать".

travelTo(room) - перемещает персонажа в комнату room, в случае необходимости уведомляя игрока, что персонаж вышел из той комнаты, где находится игрок, или, наоборот, вошел в нее.

Блок свойств-указателей на свойства-направления комнаты (см. также объект room): northProp, southProp, eastProp, westProp, neProp, nwProp, seProp, swProp, inProp, outProp, upProp, downProp. Эти свойства определяют, какое свойство-направление комнаты, в которой находится персонаж, будет вызываться при попытке персонажа двигаться в том или ином направлении (перечисленные свойства соответствуют (в порядке перечисления) северу, югу, востоку, западу, северо-востоку, северо-западу, юго-востоку, юго-западу, входу, выходу, верху и низу). Этот механизм позволяет определять разные выходы из помещения для игрока и других персонажей (например, закрывать для игрока некоторые из направлений, доступных персонажам).

nestedroom: room. "Вложенная" комната - особый тип комнаты, которая расположена внутри другой комнаты; в эту категорию попадают, например, стулья, а также некоторые виды транспортных средств (надувные лодки, велосипеды...). Обратите внимание, что одну комнату можно поместить в другую, даже если она не относится к классу nestedroom; для этого достаточно просто приравнять "внешней" комнате ее свойство location. Коренное отличие nestedroom от обычной локации состоит в том, что эта комната "открыта"; когда игрок находится внутри нее, то игра при выводе описаний указывает, что он находится во "внешней" (или основной) локации (например, выводится описание типа "Лаборатория, на стуле"). Кроме того, объекту nestedroom соответствует предмет в мире игры, который игрок видит и с которым он может взаимодействовать; например, стул, помимо того, что является локацией, также представляет собой предмет в основной комнате. Свойство statusPrep указывает предлог, который используется в описании, когда игрок находится внутри "вложенной" комнаты ("Гостиная, на диване") По умолчанию используется предлог "в", но некоторые дочерние классы (и объекты) его переопределяют. Свойство outOfPrep определяет предлог, который используется при выводе соощбения, когда игрок покидает "вложенную" комнату; это могут быть предлоги "из" или "с(о)" - в зависимости от объекта. См. также beditem, chairitem, vehicle.

numberedObject: object. Этот класс можно использовать для того, чтобы принадлежащий этому классу объект мог использоваться в качестве нумерованного предмета, к которому игрок может в процессе игры обращаться по его номеру. Например, можно создать объект-"кнопку", к которому игрок сможет обращаться при помощи совосочетаний, например, "кнопка 100", "кнопка 1000". Если вы хотите ограничить интервал допустимых номеров, измените метод num_is_valid таким образом, чтобы он отображал соответствующее сообщение об ошибке и возвращал nil при вводе неправильного номера. Если вам необходим отдельный объект для обработки обращений к кнопкам во множественном числе ("посмотреть на кнопки"), измените метод newNumberedPlural так, чтобы он возвращал тот объект, который должен обрабатывать такие обращения; по умолчанию они обрабатываются тем же нумерованным объектом.

obstacle: object. Объект-препятствие, который указывается в свойствах-направлениях комнаты (класс room) вместо ссылки на другую комнату. При этом свойство destination должно возвращать ссылку на комнату, куда должен попасть игрок (или другой персонаж), когда успешно преодолеет препятствие (например, отопрет дверь). Если преодолеть препятствие не удастся, свойство destination должно выводить соответствующее сообщение и возвращать nil. Атрибут isobstacle - флаг, помечающий объект-препятствие как принадлежащий классу obstacle (по умолчанию определен равным true для данного класса).

openable: container. Объект-контейнер, который можно открывать и закрывать. Атрибут isopenable, определяющий принадлежность объекта данному классу, установлен равным true. Свойство ldesc по умолчанию выводит список предметов, содержащихся в контейнере, если он открыт, или сообщение о том, что контейнер закрыт, в противном случае. Атрибут isopen, определяющий, открыт контейнер или нет, по умолчанию установлен равным true (т. е. контейнер открыт); его значение изменяется соответствующим образом при обработке команд вида "открыть контейнер" и "закрыть контейнер". Если в начале игры требуется, чтобы контейнер был закрыт, следует при описании объекта присвоить данному атрибуту свойство nil.

Prep: object. Объект-предлог. Лексическое свойство.