00097. Написания DLL библиотек и использование их с скриптах
Напис ания DLL библиотек и использование их с скриптах|Всем привет! После 2-х месяцев застоя я продолжаю вести уроки по скриптингу. Сегодняшний урок будет посвящен DLL-библиотекам. Мы будем учится подключать, написанные нами, файлы.|wmysterio|wmysterio||||Библиотека - это набор функций, написанных на любом языке программирования. В этом уроке мы напишем простейшую библиотеку на С++ и используем её в Cleo-скрипте. Этот урок будет приквел в написании ASI-скриптов.
Начнем с написания. Для примера, я взял Visual Studio 2008, с помощью которой мы создадим библиотеку. Для этого, откроем новый проект и укажем тип проекта:
Указываем шаблон "Консольное приложение Win32", тип проекта - "Win32". Вводим имя проекта и нажимает "ОК". После чего в нас появиться диалоговое окно такого типа:
Выбираем "DLL", и ставим галочку на пустой проект, после чего нажимаем кнопку "Готово". Программа создала нам 3 папки: "Заголовочные файлы", "Файлы исходного кода" и "Фа йлы ресурсов". Выбираем папку "Файлы исходного кода", нажимаем правую кнопку мыши и выбираем опцию "Добавить->Создать элемент":
В появившемся окне выбираем "Код->Файл CPP". В поле "Имя" мы даём название нашему исходному файлу:
Когда данные заполнены, нажимаем "Добавить". Перед нами пустой проект. Здесь мы будем писать код библиотеки. Все функции должны быть экспортными, поэтому перед каждой из них мы должны написать код:
cpp
extern "C" __declspec(dllexport)
Используя язык C++, мы напишем простенькую функцию, которая будет возвращать нам сумму 3-х целых чисел. Мой код такой:
cpp
int plus(int a, int b, int c){
return a+b+c;
}
Всё, что остаётся - дописать код эксторта и подключить стандартную библитеку "iostream":
cpp
#include <iostream>
extern "C" __declspec(dllexport) int plus(int a, int b, int c){
return a+b+c;
}
Теперь скомпилируем код, нажав на конку 
или клавишу F5
. Если у нас всплывает окно с сообщением о том, что нужно указать исполняющий файл, то нажимаем "Отмена". От нас требуют запустить какую-то программу, что бы проверить работоспособность. В нашем случае нет нужды что-то указывать, по этому нажимает отрицательный вариант. Что бы не выскакивало это окно, то пользуемся клавишей <kbd>F7.Нам осталось скопировать нашу DLL в папку с игрой. Я, например, кину её в папку "Cleo":
Теперь берём в руки наш любимый Sanny Builder и будем писать код :) Для начала, рассмотрим опкоды, которые работают DLL-библиотекой. Следующий опкод загружает библиотеку в п амять
0AA2: 0@ = load_library "CLEO\wmysterio.dll" // IF and SET
Здесь:
0@ - имя загруженной библиотеки
"CLEO\wmysterio.dll" - путь с самой DLL-ке.
0AA3: free_library 0@
Опкод выгружает ранее загруженную библиотеку из памяти.
Здесь:
0@ - имя загруженной библиотеки× **ВАЖНО:** Библиотеку нужно в сегда выгружать из памяти после использования
Получить адрес функции библиотеки можно с помощью опкода:
0AA4: 1@ = get_proc_address "plus" library 0@ // IF and SET
Здесь:
0@ - хэндл загруженной библиотеки
"plus" - имя фунции в библиотеке
1@ - в переменную заносится адрес функции
0AA7: call_function 1@ num_params 3 pop 3 _c=10 _b= 5 _a= 3 store_to 2@
Опкод выполняет функцию по адресу.
Здесь:
1@ - адрес функции
num_params 3 - количество параметров, передаваемых в функцию. Так, как наша библиотека принимает 3 параметра, то число будет тоже 3. Следует учесть, что это "плавающий" параметр и количество зависит от самих функций. Обратите внимание, передача параметров осуществляется в обратном порядке! pop 3 - количество параметров, которых нужно очистить после использования функции. Этот параметр обычно совпадает с к-вом передаваемых параметров.
_c=10 _b= 5 _a= 3 - перечисление параметров, которые будут переданы в функцию. К-во должно строго совпадать с к-вом параметров в нашей dll-ке. В нашем случаи мы передадим числа 10, 5 и 3.
2@ - переменная, в которую будет возвращено значение. В нашем случае эта переменная необходимая, но если функция ничего не возвращает, то поле остаётся пустым.
Следует обратить внимание, что этот опкод выполняет функции не только DLL-библиотек, но и GTA-шные функции. О них я расскажу в следующих уроках.
{$CLEO}
0000:
:MyDLL
thread 'MyDLL'
wait 5000
if
0AA2: 0@ = load_library "CLEO\wmysterio.dll" // IF and SET
jf @MyDLL_END_1
if
0AA4: 1@ = get_proc_address "plus" library 0@ // IF and SET
jf @MyDLL_END_2
$PARAM_1 = 3
$PARAM_2 = 5
0AA7: call_function 1@ num_params 3 pop 3 10 $PARAM_2 $PARAM_1 result_to $RES
0ACE: show_formatted_text_box "Summ: %d" $RES
0AA3: free_library 0@
jump @MyDLL_END
:MyDLL_END_1
wait 0
0ACE: show_formatted_text_box "FILE NOT FOUND"
jump @MyDLL_END
:MyDLL_END_2
wait 0
0ACE: show_formatted_text_box "ADDRESS NOT FOUND"
:MyDLL_END
wait 0
0A93: end_custom_thread
Проверяем наш скрипт:
Нам вывело число 18, то есть, наша функция работает без проблем!
Это самый простой пример, дальше я постепенно буду умерено усложнять библиотеки. Обычно их используют как для написания новых опкодов, так и целых ASI-скриптов, но их принцип написания существенно отличается. На этом урок окончен! Надеюсь эти навыки пригодятся Вам ;)|3226|1|0|76954486
png794531400267``\|68724190png756428400226\|40297185`png`483`234`400`193|58734607png793504400254``\|18035124png447328400293\|12473224`png`600`337`400`224|19665781png23`22`\||napisanija_dll_bibliotek_i_ispolzovanie_ikh_s_skriptakh|1504461926