This functionality is only available in the Pro Edition of Game Maker.
Please note that since version 7 there is a new extension mechanism in Game Maker. You are strongly encouraged to use that extension mechanism, rather than the functions described in this section. See http://www.yoyogames.com/extensions for details. These functions are mainly left in for compatibility with the past.

In those cases were the functionality of GML is not enough for your wishes, you can actually extend the possibilities by using plug-ins. A plug-in comes in the form of a DLL file (a Dynamic Link Library). In such a DLL file you can define functions. Such functions can be programmed in any programming language that supports the creation of DLL's (e.g. Delphi, C, C++, etc.) You will though need to have some programming skill to do this. Plug-in functions must have a specific format. They can have between 0 and 16 arguments, each of which can either be a real number (double in C) or a null-terminated string. (For more than 4 arguments, only real arguments are supported at the moment.) They must return either a real or a null-terminated string.

In Delphi you create a DLL by first choosing New from the File menu and then choosing DLL. Here is an example of a DLL you can use with Game Maker written in Delphi. (Note that this is Delphi code, not GML code!)

library MyDLL;

uses SysUtils, Classes;

function MyMin(x,y:double):double; cdecl;
begin
if x<y then Result := x else Result := y;
end;

var res : array[0..1024] of char;

function DoubleString(str:PChar):PChar; cdecl;
begin
StrCopy(res,str);
StrCat(res,str);
Result := res;
end;

exports MyMin, DoubleString;

begin
end.

This DLL defines two functions: MyMin that takes two real arguments and returns the minimum of the two, and DoubleString that doubles the string. Note that you have to be careful with memory management. That is why I declared the resulting string global. Also notice the use of the cdecl calling convention. You can either use cdecl or stdcall calling conventions. Once you build the DLL in Delphi you will get a file MyDLL.DLL. This file must be placed in the running directory of your game. (Or any other place where Windows can find it.)

To use this DLL in Game Maker you first need to specify the external functions you want to use and what type of arguments they take. For this there is the following function in GML:

external_define(dll,name,calltype,restype,argnumb,arg1type,arg2type, ...) Defines an external function. dll is the name of the dll file. name is the name of the functions. calltype is the calling convention used. For this use either dll_cdecl or dll_stdcall. restype is the type of the result. For this use either ty_real or ty_string. argnumb is the number of arguments (0-16). Next, for each argument you must specify its type. For this again use either ty_real or ty_string. When there are more than 4 arguments all of them must be of type ty_real.

This function returns the id of the external function that must be used for calling it. So in the above example, at the start of the game you would use the following GML code:

{
global.mmm = external_define('MyDLL.DLL','MyMin',dll_cdecl,
ty_real,2,ty_real,ty_real);
global.ddd = external_define('MyDLL.DLL','DoubleString',dll_cdecl,
ty_string,1,ty_string);
}

Now whenever you need to call the functions, you use the following function:

external_call(id,arg1,arg2,...) Calls the external function with the given id, and the given arguments. You need to provide the correct number of arguments of the correct type (real or string). The function returns the result of the external function.

So, for example, you would write:

{
aaa = external_call(global.mmm,x,y);
sss = external_call(global.ddd,'Hello');
}

If you don't need to use the DLL anymore you had better free it.

external_free(dll) Frees the DLL with the given name. This is in particular necessary if the game should remove the DLL. As long as the DLL is not freed it cannot be removed. Best do this e.g. in an end of game event.

You might wonder how to make a function in a DLL that does something in the game. For example, you might want to create a DLL that adds instances of objects to your game. The easiest way is to let your DLL function return a string that contains a piece of GML code. This string that contains the piece of GML can be executed using the GML function

execute_string(str,arg0,arg1,...) Execute the piece of code in the string str with the indicated arguments.

Alternatively you can let the DLL create a file with a script that can be executed (this function can also be used to later modify the behavior of a game).

execute_file(fname) Execute the piece of code in the file.

Now you can call an external function and then execute the resulting string, e.g. as follows:

{
ccc = external_call(global.ddd,x,y);
execute_string(ccc);
}

In some rare cases your DLL might need to know the handle of the main graphics window for the game. This can be obtained with the following function and can then be passed to the DLL:

window_handle() Returns the window handle for the main window.

Note that DLLs cannot be used in secure mode.

Using external DLLs is an extremely powerful mechanism. But please only use it if you know what you are doing.

Это функциональное назначение доступно только в Pro издании Game Maker.
Пожалуйста, обратите внимание, что начиная с версии 7 есть новый механизм расширения в Game Maker. Строго рекомендуется использовать этот механизм расширения, а не функции, описанные в этом разделе. За подробностями обращайтесь на http://www.yoyogames.com/extensions. Эти функции оставлены для совместимости с пришлыми версиями.

В тех случаях, когда функциональных возможностей GML для Ваших грандиозных планов не хватает - Вы можете реально расширить возможности, используя плагины. Плагины должны быть в форме DLL файла (динамически загружаемых библиотек). В таком DLL файле Вы можете определить функции. Такие функции могут быть написаны на любом языке программирования, которые поддерживают создание DLL (например, Delphi, Visual C++, Visual Basic и т.д.). Для этого Вам необходимо как минимум знать один из таких языков и иметь опыт программирования. Плагины с функциями должны иметь специфический формат. Они могут содержать между 0 и 16 аргументов, каждый из которых может быть вещественным числом (double in C) или строкой с нулевым символом в конце. (Для плагинов содержащих более четырёх аргументов, только реальные аргументы поддерживаются на данный момент). Они должны возвращать либо вещественную строку, либо строку с нулевым символом в конце.

В Delphi для создания DLL библиотеки Вы выбираете пункт New из меню File и выбираете DLL. Далее приводится пример DLL, который Вы можете использовать в Game Maker написанный в Delphi. (Обратите внимание, что это - Delphi код - не GML код!)

library MyDLL;

uses SysUtils, Classes;

function MyMin(x,y:double):double; cdecl;
begin
if x<y then Result := x else Result := y;
end;

var res : array[0..1024] of char;

function DoubleString(str:PChar):PChar; cdecl;
begin
StrCopy(res,str);
StrCat(res,str);
Result := res;
end;

exports MyMin, DoubleString;

begin
end.

Эта DLL определяет две функции: MyMin, которая берёт два реальных параметра и возвращает минимальный из этих двух, и DoubleString, которая удваивает строку. Обратите внимание, что нужно быть внимательным с использованием памяти. Именно поэтому объявлена результирующей глобальная строковая. Также обратите внимание на использование cdecl - соглашений о вызовах. Это важно. Как только Вы создали DLL в Delphi, у Вас получится файл MyDLL.DLL. Этот файл должен быть помещён в каталог с Вашей игрой. (Или иное место, где Windows может найти его).

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

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

{
global.mmm = external_define('MyDLL.DLL','MyMin',dll_cdecl,
ty_real,2,ty_real,ty_real);
global.ddd = external_define('MyDLL.DLL','DoubleString',dll_cdecl,
ty_string,1,ty_string);
}

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

external_call(id,arg1,arg2,...) Вызывает внешнюю функцию с заданным идентификатором и заданными аргументами. Вам нужно обеспечить правильное количество аргументов правильного типа (real или string). Эта функция возвращает результаты внешней функции.

Итак, например, Вы можете написать:

{
aaa = external_call(global.mmm,x,y);
sss = external_call(global.ddd,'Hello');
}

Если Вам больше не нужно использовать DLL, то лучше её выгрузить.

external_free(dll) Выгружает DLL с заданным именем. Её действительно важно выгружать из игры. Также DLL долго выгружается и не может быть удалена. Лучше всего выгружайте её в событии завершения игры.

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

execute_string(str,arg0,arg1,...) Выполняет фрагмент кода в строке str с заданными параметрами.

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

execute_file(fname) Выполняет фрагмент кода в файле.

Теперь Вы можете вызывать внешнюю функцию и затем выполнить результирующую строку, например, следующим образом:

{
ccc = external_call(global.ddd,x,y);
execute_string(ccc);
}

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

window_handle() Возвращает настройки окна для основного экрана.

Обратите внимание, что DLL не могут использоваться в безопасном режиме.

Использование внешних DLL - чрезвычайно мощная функция. Используйте их только в том случае, если действительно уверены в том, что делаете.