Вы находитесь на странице: 1из 1

Главная 3D 2D Engines Web Stereo Sound

Официальный сайт Script


Справка программы

Airfoil

AllObjects

AnimationControls

Ball
С этим объектом Вы можете манипулировать внутренними параметрами всех связанных с
Buoy
ним объектов, используя скрипт.
Cam1StPerson
В Вашем скрипте Вы также сможете исполнять функции на связанных объектах,
CamChase например, для их скрытия / отображения, или запуска / остановки их активности, и так
далее.
Car
Синтаксис скриптового языка является Си-подобным. Скриптовый движок - это
CarAI AngelScript, от Andreas Jonsson.
Character Пожалуйста, смотрите документ справки объекта скрипта для подробностей обо всех
доступных в настоящий момент скриптовых функциях.
ConfigureControls

Counter Урок 1

EventOnContact Запустите 3D Rad, нажмите [Ctrl]+[O] и дважды щелкните на проекте TutScript1 для его
открытия.
EventOnInput

EventOnLocation

EventOnObjectID

EventOnProximity

EventOnValue

EventTimer Проект состоит из скрипта и объекта спрайта, связанных вместе.


ExitFade
Связывание объекта со скриптом делает его доступным для кода скрипта.
Fog
Дважды щелкните на элементе скрипта в списке объектов для открытия его диалогового
Force окна свойств.

ForceFreedback

G-Force

Group

GUIWindow

Compiler

Highway

Imposter

Joint

Particles

Path

PathFinder

PCar

PointLight

Projectiles

RaceTracker

RigidBody Дескрипторы объектов


Rock Это окно перечисляет все "десткрипторы" объектов, которые могут быть доступны
Scanner скрипту.

Script Эти дескрипторы могут проходить как параметры для функций манипулирования
объектами (смотрите приведенный ниже Урок 2).
Script Ref
Ввод
SkinMesh
Это окно перечисляет внутренние параметры связанных объектов, которые могут быть
SkyBox прочитаны скриптом.
SoundEffect Вывод
SoundSource Это окно перечисляет внутренние параметры связанных объектов, которые могут быть
записаны (установлены) скриптом.
Spring

Sprite Скрипт

SunLight Это редактируемый код скрипта. Обратите внимание на то, что функция Main() всегда
должна присутствовать в Вашем скрипте.
Switch
В этом примере, фактический код - это строка между фигурными скобками. Что она
Terrain делает - это устанавливает переменную OUT_0 (непрозрачность спрайта) в случайное
значение между 0 и 1.
TextPrint
Поэтому, когда проект запускается, скрипт выполняется 75 раз в секунду, что Вы видите
Trail на Вашем экране - это мерцающий спрайт.
Transform
Выйдите из диалогового окна свойств и нажмите пробел для того, чтобы увидеть этот
Tree маленький скрипт в действии.

ValueLabel Примечание: что угодно в скрипте является чувствительным к регистру. Это значит, что
все имена функций и переменные должны быть введены так, как они перечислены в
ValueLabelBar справке.
ValuePrint Урок 2
Velocity Нажмите [Ctrl]+[O] и дважды щелкните на проекте TutScript2 для его открытия. Затем
дважды щелкните на элементе скрипта в списке объектов для открытия его диалогового
Waypoint
окна свойств.
Wheel

Wind

Этот скрипт определяет новую переменную, называемую count типа int (целое число). Ее
начальное значение будет нулевым, когда проект запустится.

Определение находится за пределами функции Main(), что значит, что переменная count
будет сохранять свое значение после каждого выполнения кода скрипта.

В функции Main() мы увеличиваем переменную count на один при каждом выполнении


(count++;). Это значит, что, когда проект запускается, после 1 секунды она будет равна 75,
после двух секунд - 150 и так далее.

В строке if (count == 200) iObjectHide(OBJ_0); скрипт проверяет, равна ли переменная


count 200 и, если это так, он вызывает функцию iObjectHide() для объекта спрайта.

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

Урок 3

Третий скрипт (проект TutScript3) демонстрирует немного более сложный скрипт. Теперь у
нас есть дополнительный объект (SoundEffect), связанный со скриптом.

Это создает больше переменных среды, доступных для нашего скрита. Они перечислены
в верхних трех окнах, в диалоговом окне свойств объекта скрипта.

В этом случае, в нашем скрипте, мы только устанавливаем непрозрачность спрайта до


тех пор, пока переменная count не достигнет 200 (if (count < 200) OUT_0 =
iFloatRand(0,1);).

Мы также скрываем спрайт и запускаем звуковой эффект, когда переменная count равна
300.

Результат заключается в том, что спрайт будет какое-то время мигать, затем застынет на
некотором уровне непрозрачности, и затем исчезнет приблизительно через одну секунду.

Дополнительная информация

3D Rad использует AngelScript в качестве скриптового интерпретатора. Для более


подробной информации об AngelScript, пожалуйста, смотрите документацию по языку и
документацию по типам данных.

Урок по кодированию, написанный членом сообщества (IronF) также доступен здесь.

Функции редактора скриптов

Проверить скрипт

Используйте эту кнопку для проверки синтаксиса Вашего скрипта. Если в коде Вашего
скрипта обнаруживается любая проблема, отображается окно сообщения, дающее Вам
ключ к тому, как исправить ее.

Найти выделенный текст

Вы можете найти все вхождения выделенного в настоящий момент текста, нажимая эту
кнопку несколько раз.

Для поиска и замены периодически повторяющегося текста чем-то еще, выделите


замещающий текст, нажмите Ctrl+C, выделите текст для замены, нажмите кнопку Найти
выделенный текст, нажмите Ctrl+V, нажмите кнопку еще раз, нажмите Ctrl+V, и так далее.

Работать при старте

Если эта опция не установлена, скрипт не будет исполняться. Он будет исполняться


только после того, как он будет запущен другим объектом, подобным, например, событию
по вводу, или другому объекту скрипта.

Отображать номера строк

Если эта опция установлена, номера строк отображаются в окне редактора скрипта. Эта
настройка является глобальной для всех объектов скрипта, и она сохраняется, когда 3D
Rad закрывается.

Внутренние параметры

Объект скрипта, подобно многим другим объектам, имеет внутренние параметры, к


которым Вы можете обращаться / манипулировать с использованием других объектов,
подобных событию по вводу или другому скрипту. Внутренние параметры скрипта
определяются как Script's VAL_1 до Script's VAL_9.

9 Внутренних параметров объекта скрипта могут быть доступны для своего собственного
кода скрипта как переменные, называемые VAL_1 до VAL_9.

Замечания

3D Rad был разработан для работы с минимально возможным скриптингом. Но он


прекрасно работает, даже если Вы заполните Ваш проект скриптами.

Все еще, пожалуйста, помните, что Вы должны разрабатывать Ваши скрипты (каждый
объект скрипта) как "независимые" для получения максимального преимущества от
объектно-ориентированной природы 3D Rad.

Там, где это возможно, каждый скрипт должен заботится об определенной "задаче" в
Вашем проекте. Если Вы успешны в этом, Ваши скрипты будут намного проще, меньше,
легче для обновления и портирования.

Автоматическая перенумерация переменных

При портировании скрипта из одного проекта в другой, или из одного объекта скрипта к
другому, имена переменных в коде могут больше не совмещаться с переменными
окружения, определенными в новом объекте скрипта.

Вы можете автоматически перенумеровать все экземпляры переменной в коде, выделив


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

Окно редактора скрипта механизировано Scintilla/SciTE, бриллиантовым бесплатным


компонентом редактирования исходного кода.

Лицензировано для Scintilla и SciTE.

Авторские права 1998-2003 от Neil Hodgson neilh@scintilla.org

Все права защищены.

Олег Широколава, e-mail: shyrokolava@mail.ru

Вам также может понравиться