Wiremod Expression 2. Изучаем основы

Что такое Expression 2

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

Окно компилятора

Для начала рассмотрим наше окно компилятора. Чтобы открыть его, необходимо открыть Q-меню, справа сверху выбрать вкладку Wiremod (конечно же, надо скачать Wiremod, но раз вы читаете это руководство, я полагаю, что он у вас уже установлен), далее найти папку "Chips, Gates", нажать Expression 2 (далее Expression 2 я буду писать как E2) и потом слева в открывшемся окне нажать "New Expression".Итак, перед нами появилось вот такое окно:

Слева мы видим древовидную структуру папок и файлов с E2 чипами. Тут вы можете выбрать файл, который хотите отредактировать. Сами эти файлы на компьютере хранятся в папке SteamSteamAppscommonGarrysModgarrysmoddataexpression2. Небольшой совет: сортировать E2 файлы лучше именно через проводник Windows, потому что через встроенный проводник E2 это делается гораздо медленнее.Если вы создали чип, но слева он не появился, нажмите внизу слева кнопку Update. Это обновит меню, и вы увидите ваш недостающий чип.В самом верху этого меню есть строка поиска, с помощью которой можно найти чипы в вашей коллекции.Сверху расположено 5 кнопок (по порядку): Скрыть/открыть левое меню с файлами, сохранить текущий файл, создать новый файл, удалить текущий файл, обновить файл. Думаю, что комментарии излишни.Справа сверху также расположено 4 кнопки: Sound Browser - тут вы можете найти все звуки из игр Source, которые могут быть использованы при создании чипа, E2Helper - сборник всех функций E2 c их описанием на английском, Save as - сохранить файл под новым именем, Save & Exit - сохранить файл и выйти.Чуть ниже расположено поле, где показываются все открытые на данный момент E2 чипы.В самом низу есть строка, где у меня написано "Validation successful". При нажатии на эту строку компилятор проверяет ваш код на наличие ошибок и в зависимости от того, есть ли они или нет, меняет свой цвет на красный или зеленый, а также показывает место, где обнаружена ошибка.Важно: обнаруживается только первая встреченная ошибка, так как компилятор однопроходной. Также может выдаваться ошибка в тех местах, где на самом деле их нет, так что периодически вам придется просматривать весь код заново, порой по несколько раз.Основная зона компилятора - место, где вы будете писать свой код. Именно тому, что туда нужно писать, и будет посвящена оставшаяся часть руководства.

Директивы

Создадим новый чип. Перед нами появляются 5 строк, начинающихся с @ (они называются директивами), и комментарии (заключены между #[...]#):

Комментарии можете смело удалять. Тут разработчики пишут последние обновления языка.Рассмотрим теперь первые пять строк:@name - имя нашего чипа. По умолчанию при сохранении чип будет брать имя, указанное в этой строке, иначе будет имя "generic".@inputs - список переменных, которые будут подаваться на вход нашего чипа. Их нельзя менять непосредственно внутри чипа, а можно только считывать их текущие значения.@outputs - противоположность @inputs. Объявляет переменные, которые будут подаваться на выход чипа. Используется в тех случаях, когда вы хотите передать значение из чипа на другой элемент из Wiremod'a, например, Screen или другой чип. Также сюда можно занести переменные, за значениями которых вы хотите следить через инструмент Debugger.@persist - переменные, используемые внутри вашего чипа. Значения этих переменных нельзя вывести обычным путем, как, например, вы бы сделали с выходными переменными.@trigger - сюда мы пишем события, при которых будет срабатывать наш чип, например, можно настроить срабатывание чипа на изменение определенных входных переменных или вообще всех входных переменных.Также присутствует не указанная здесь директива @model. Она определяет модель нашего чипа. Вместо стандартной модели чипа можно использовать, например, бочку, череп, да что угодно!В последнем обновлении, как видно на скриншоте, добавлена директива @autoupdate. Если она присутствует в чипе, то при создании или дублировании чипа он будет искать последнюю версию этого чипа и запускать ее.

Операторы

Синтаксис	Пример	Описание
#	#This is a comment	Это однострочный комментарий. Все, что находится внутри него, не будет обрабатываться компилятором.
#[Comment]#		Это многострочный комментарий. Работает аналогично предыдущему за исключением того, что в него можно заключить как множество строк, так и часть одной строки.
if () {}	if(A){B=C}	Выполняет действия в фигурных скобках, если результат выполнения функции A - истина
else {}	else{A=B}	Этой конструкции должна предшествовать if(){} или elseif(){}. Выполняет действия в фигурных скобках, если не было выполнено условие предыдущей конструкции
elseif () {}	elseif (A) {B=C}	Смесь предыдущих двух конструкций. Этой конструкции также должна предшествовать if(){} или elseif(){}. Выполняет действия в фигурных скобках, если не было выполнено условие предыдущей конструкции и если было выполнено условие в круглых скобках
( ? : )	D = A ? B : C	Если A - истина, то D=B, иначе D=C
&	if (A & B) {C = 1}	Выдает значение истина, если были выполнены оба условия, связанных оператором &, иначе выдает значение ложь
\|	if (A \| B) {C = 1}	Выдает значение истина, если выполнено хотя бы одно из условий, связанных оператором \|, инача выдает значение ложь
==	if (A == B) {C = 1}	Оператор равенства (не путайте с оператором присваивания). Выдает значение истина, если значения по обе стороны от оператора равны
>=	if (A >= B) {C = 1}	Выдает значение истина, если значение слева больше или равно значению справа
<=	if (A <= B) {C = 1}	Выдает значение истина, если значение слева меньше или равно значению справа
>	if (A > B) {C = 1}	Выдает значение истина, если значение слева больше значения справа
<	if (A < B) {C = 1}	Выдает значение истина, если значение слева меньше значения справа
!=	if (A != B) {C = 1}	Выдает значение истина, если значение слева не равно значению справа
!	if (!A) {B = 1}	Необходимо наличие условия. Инвертирует результат выполнения условия
++	if (!A) {B++}	Инкремент. Прибавляет 1 к переменной. Эквивалентная конструкция B=B+1. Противоположная конструкция --. Вычитает 1 из переменной
~	if (~Button & Button) {DO stuff}	Выдает 1, если текущее срабатывание было вызвано изменением значения переменной
$	Opitch = Pitch + $Pitch * 3	Выдает разность значений переменной между текущим и предыдущим срабатыванием чипа.
->	->Input or ->Output	Если используется с входной переменной, то выдает 1, если этот вход соединен с чем-нибудь, если используется с выходной переменной, то показывает количество входов, к которым подключен данный выход
#ifdef	#ifdef entity:setAlpha(number)	Проверяет, доступна ли команда на сервере
#else	#else	Если функцию невозможно вызвать на сервере, то выполняется код после #else
#endif	#endif	Закрывает блок #ifdef

Циклы

Синтаксис	Пример	Описание
while () {}	while (A) {B++}	Действия, описанные в фигурных скобках будут повторяться до тех пор, пока выполняется условие в круглых скобках
for () {}	for (I = A, B[, C]) {}	Действия в фигурных скобках будут выполняться до тех пор, пока I, которая изначально имеет значение А, не будет равно B, причем при каждом выполнении I будет увеличиваться или уменьшаться на значение C. Если C нет, то переменная I увеличивается на 1 при каждой итерации
foreach () {}	foreach(K,V:type=Table) {}	Проходит по всем элементам типа type в массиве/таблице Table. К - это индекс переменной в Table, а V - это непосредственно сам элемент. Аналогично for(){} будет выполнять действия внутри фигурных скобок, пока не пройдет по всем элементам Table. Если во время прохождения данного цикла были созданы новые переменные в Table, цикл их проигнорирует
continue	if (A) {continue}	Может быть использована только внутри цикла. При наличии такой конструкции, цикл мгновенно перейдет на следующую итерацию, игнорируя последующие функции
break	if (A) {break}	Может быть использована только внутри цикла. При наличии такой конструкции цикл мгновенно завершится, и начнется выполнение последующих операций

Типы данных и переменные

Все переменные должны начинаться с большой буквы. Например:

@persist variable

работать не будет, а

@persist Variable

будет.Констант как отдельный тип в языке не существует. Если хотите использовать константу, просто не изменяйте ее в ходе выполнения кода.В языке присутствует 13 типов данных, некоторые из которых подразделяются еще на несколько подтипов:

Число (Number)
Вектор (Vector). Имеет двумерный, трехмерный и четырехмерный подтипы.
Угол (Angle)
Строка (String)
Сущность (Entity)
Массив (Array)
Таблица (Table)
Рэйнджер - измеритель расстояния (Ranger Data)
Кость (Bone)
Матрица (Matrix). Имеет подтипы 2х2, 3х3, 4х4.
Вайрлинк - сложная проводная связь (Wirelink)
Комплексное число (Complex Number)
Кватернион (Quaternion)

Переменные, которые не являются числом, должны быть объявлены с названием этого типа после двоеточия, как указано на скриншоте.Если у вас несколько переменных одного типа, то можно их объединить оператором [...], например, так:

[Vector1 Vector2 Vector3]:vector

Это позволить вам сэкономить место и время.Также есть особый тип данных: variable. Переменная этого типа может принимать значения любого типа, то есть, например, сейчас она число, а через две минуты она уже вектор.

Заключение

Буду рад вашим комментариям. Если появились вопросы, смело задавайте их здесь или пишите в личку.Пишите также, что хотели бы еще увидеть в этом руководстве (или в последующих). Указывайте на мои ошибки и недочеты, если они присутствуют.Удачного изучения Expression 2 :)