Game Maker Language

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

var value = list[| 0]; // вместо ds_list_find_value(list, 0)
map[? "name"] = "Username"; // вместо ds_map_add(map, "name", "Username")
var value = map[? "name"]; // вместо ds_map_find_value(map, "name");

В GML поддерживаются следующие типы данных:

• string (строка) - последовательность символов, заключенных в одинарные или двойные кавычки (начиная с GMS2 следует использовать двойные кавычки).
• real (число) - целое или с плавающей запятой. Хотя все значения, созданные в GML, хранятся как числа с плавающей запятой двойной точности, для работы с расширениями можно использовать и другие типы
• array (массив) - переменная, использующая индексы для доступа к элементам. Могут содержать любые данные - числа, строки, другие массивы, дескрипторы других структур данных и т.п. Их также можно передать как параметр в функцию, и они могут быть возвращены функцией как результат.
• boolean - может принимать значения true или false. Имейте в виду, что в настоящее время GML не поддерживает «настоящие» булевы значения и на самом деле принимает как false любые числа меньше 0.5, а всё, что равно или больше - как true.
• pointer (указатель) - указатель на область памяти. Используется в некоторых специфических функциях вроде buffer_get_address() и др.
• enum (перечисление) - заданная пользователем коллекция констант, хранящихся в переменной.
• undefined (не задано) - специальное значение, возвращаемое в случаях, когда запрашиваемые данные не найдены.

Хотя GML и можно рассматривать как объектно-ориентированный язык, природа объектов и экземпляров объектов в Game Maker создает некоторые важные отличия в способе разграничения переменных. Существует два типа локальности: локальность в объекте и локальность в скрипте (или другом куске кода, содержащемся в отдельном контейнере). То, что переменная является локальной для экземпляра объекта, означает, что переменная привязана к конкретному экземпляру объекта и извне этого экземпляра может быть использована только с приставкой, определяющей этот экземпляр; то, что переменная является локальной для скрипта, означает, что эта переменная может быть использована только в этом скрипте (и уничтожается после окончания скрипта). Далее термин «локальный» будет означать локальность в объекте. По умолчанию, переменная локальна для объекта, но не локальна для скрипта, в котором она используется. Для того чтобы сделать переменную доступной всем экземплярам объектов, она может быть определена через глобальное пространство имен:

global.foo = "bar";

Также существует возможность объявлять глобальные переменные используя ключевое слово globalvar:

globalvar foo, bar;

Но такого способа следует избегать, так как это может легко привести к сложно выявляемым ошибкам, из-за пересечения областей видимости переменных (то же самое рекомендуют и непосредственно разработчики GMS; более того, возможно, что в будущем это ключевое слово будет полностью убрано из языка - в данный момент оно оставлено исключительно из соображений обратной совместимости). Для того, чтобы сделать переменную локальной для скрипта, её нужно определять так:

var foo, bar;

Областью видимости локальной переменной является скрипт, внутри которого она объявлена. Это подразумевает, что при переключении контекста (c использованием with) она по-прежнему будет доступна. Например:

var foo = "bar";

with other
{
    show_message(foo); // переменная foo доступна
}

Доступ к локальным переменным объекта можно получить, используя идентификатор экземпляра объекта как приставку

instance.varname

но, тем не менее, таким образом невозможно получить локальные переменные одного скрипта из другого, пока они не передаются как параметры функции. Текущее пространство имен объекта может быть изменено с помощью конструкции «with». Например, следующий скрипт, если его поместить в событие столкновения, уничтожит другой экземпляр объекта, вовлеченный в это событие (заметим, что в событии столкновения Game Maker автоматически устанавливает переменную other на второй экземпляр объекта, с которым произошло столкновение):

with other
{
    instance_destroy();
}

GML автоматически распределяет память под переменные на ходу, и использует динамические типы, поэтому присваивание переменным значения различных типов также возможно. Например, сначала можно создать целочисленную переменную, а потом изменить её на строковую:

  intNumber = 1;
  intNumber = "Эта переменная теперь содержит строку";

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

  data = [1, 2, 3, 4, 5]; // создали массив (такой синтаксис создания массивов доступен начиная с GMS2)
  data = 0; // уничтожили массив (теперь это просто переменная)

При уничтожении объекта также уничтожаются все переменные, локальные для него, а любые глобальные переменные существуют независимо от них. Поэтому предпочтение нужно отдавать локальным переменным, а глобальные переменные использовать только в случае реальной необходимости этого. Для хранения больших объёмов информации более эффективно, в Game Maker есть поддержка нескольких структур данных - таких, как стек, очередь, список, карта, приоритетная очередь и сетка. Эти структуры создаются, модифицируются и уничтожаются посредством встроенных функций. Также есть функции практически во всех структурах для сортировки данных в них. В некоторых случаях более удобным и более эффективным будет использование буферов, позволяющих хранить произвольные данные и являющимися, по сути, просто выделенными кусками памяти.

В основе работы Game Maker с ресурсами лежат уникальные идентификаторы, которые служат для определения конкретного ресурса или экземпляра объекта. Эти идентификаторы могут быть использованы скриптами или функциями для указания необходимого ресурса. Так как создание ресурсов непосредственно в Game Maker подразумевает указание имени, то это имя служит константой, содержащей идентификатор ресурса. Идентификатор конкретного экземпляра хранится в локальной переменной «id». При динамическом создании ресурсов, всегда возвращается идентификатор созданного ресурса, который может быть использован в дальнейшем.