Комментарии

Синтаксис и организация сценария

Введение

В этой главе представлено введение в MAXScript и ряд наиболее часто применяемых инструментальных средств данного языка создания сценариев. Освоив эту главу, вы будете уметь писать простые сценарии и пользоваться приемником ко­манд MAXScript Listener, а также редактором сценариев MAXScript Editor.

Для выполнения упражнений в этой книге вам следует пользоваться 3dsMax в стандартной конфигурации с установленными базовыми единицами измерения (GenericUnits).

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

Очень важно сохранять ясность и удобочитаемость своих сценариев. Для созда­ния удобочитаемых сценариев пользуйтесь отступами с табуляцией и пробелами, чтобы выделить отдельные элементы или функции. В 3dsMax символы пробелов и табуляции игнорируются во время обработки сценариев. В примерах сценариев, приведенных в этой главе, демонстрируется один из способов организации содержимого сценариев с отступами. Отступами можно пользоваться и по-другому, но при этом всегда нужно быть последовательным.

Пользуйтесь комментариями, чтобы сделать свой сценарий более понятным для других. Комментарии представляют собой текстовые блоки в сценарии, написанные простым и понятным языком. Они поясняют или документируют назначение

Глава 1

сценария и порядок его выполнения. Старайтесь снабжать комментариями все свои сценарии. Это особенно важно для крупных и сложных сценариев.

Комментарии не относятся к выполняемым операторам сценария. Они выде­ляются в тексте сценария двойным дефисом (--), который ставится в начале ком­ментария. В таком случае любой текст, начинающийся с двойного дефиса, игно­рируется. Двойной дефис можно, если требуется, использовать в нескольких строках, например:

b = box()

b.length = 20.0

-- Это комментарий.

-- А это еще один комментарий, имеющий продолжение в

-- этой строке. Следующая строка уже относится к самому сценарию.

b.width = 30.0

В следующем примере показано, каким образом комментарий помещается в той же строке, что и оператор сценария:

b = box() -- Создать параллелепипед, комментарий игнорируется.

Комментарии могут занимать несколько строк, если они начинаются двумя символами /* и оканчиваются еще двумя символами */ (или признаком конца файла). Все, что находится между этими символами, считается комментарием. Комментарии, определенные подобным образом, называются блочными коммен­тариями, например:

s = sphere()

/* Здесь содержится большой комментарий, не требующий ограничителей в каждой строке, поскольку в данном случае используются блочные комментарии.*/

s.radius = 10.0

Такие комментарии можно поместить и в одной строке, внутри текста самого сценария:

s = sphere /*большой радиус*/ radius:100.0