Написание плагина. Настройка проекта

[DK]

В этой статье я опишу создание плагина для GTA. Основное внимание уделю созданию и настройке проекта.
Я использую Visual Studio 2017. В открытом доступе есть Community версия этого продукта. Впрочем, найти Pro или Enterprise версию тоже не сложно.
Ах, да... Что требуется от вас:
-Наличие игры
-Умение писать код (если вы до этого не занимались скриптингом - возможно, лучше стоит начать с него)
-Базовые знания C/C++ (хотя, можно и без этого, как я в своё время  )
-Желание познавать и... время.

Напомню, что ASI-плагин - это динамическая библиотека с расширением .asi, которая подгружается (ASI-Loader'ом) и прикрепляется к процессу игры.
Итак, поехали.

Инструкция

[Shagg_E]

Класс! Скорее всего, как будет возможность - перейду с VS 2010 на 2015, ибо первый у меня глючит.

Хотелось бы туториал по вызову перед стартом игры окна с выбором одного из 3х пунктов.

[DK]

Shaggy, для этого нужно использовать кастомный ASI-Loader (он загружает библиотеки при загрузке приложения).

[Shagg_E]

Это уже есть, и я даже реализовал(спс Sector-у и xanser-у) то, что мне нужно(подмена имен загружаемых файлов и пара мелочей), всё работает, однако через ini, а хотелось бы научиться создавать окно с выбором пункта, ибо в ini у меня всего лишь один пункт настройки(глупо создавать ini ради одной, пускай и самой важной настройки) и вообще - по многим причинам нужно именно окно, а не ini.
Нужно окно по типу такого.

[DK]

Shaggy, ты имеешь ввиду окно Windows или настройку как пункт в меню?

[Shagg_E]

Окно Windows

[xanser]

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

DK можно уточнить? Раньше плагин подключался в виде функции в такой конструкции:

Код: C++

1. BOOL APIENTRY DllMain(HMODULE hModule, DWORD  ul_reason_for_call, LPVOID lpReserved)
2. {
3.         switch (ul_reason_for_call)
4.         {
5.         case DLL_PROCESS_ATTACH:
6.                 LoadViceCityPlugin();
7.                 break;
8.         case DLL_PROCESS_DETACH:
9.                 break;
10.         }
11.         return TRUE;
12. }

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

[DK]

Shaggy, конкретно по этому не планировал делать туториал. Но можно глянуть, как это сделано в примерах RenderWare. Наверняка там MFC используется.
xanser, да. Так тоже можно. А если надо что-то сделать при детаче - нужно писать это в деструктор.

Код: C++

1. class MyPlugin{
2. public:
3.     MyPlugin(){
4.         // on attach
5.     }
6.  
7.     ~MyPlugin(){
8.         // on detach
9.     }
10. };
11.  
12. MyPlugin myPlugin; // создали экземпляр класса в глобальном пространстве (глобальный обьект)

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

Т.е. обьект будет создан при аттаче dll (будет вызван конструктор), а разрушен - при детаче (будет вызван деструктор).

[Sektor]

xanser, да потому-что объект будет создан, так сказать компилятором и уничтожен тоже, иначе говоря компилятор позаботиться обо всем сам, в данном случае.

[DK]

Вынесено в шапку.

[DK]

Создал шаблон для Vice City.
Правда, там идёт привязка к несуществующему plugin_vc.
https://github.com/DK22Pac/plugin-sdk/tree/master/extra/VS%20templates

[Shagg_E]

Круто! Жаль, у меня 2010, но я постараюсь за лето на 2015 пересесть)

[DK]

Я уже пишу плагины для VC c новым sdk 

Код: C++

1. #include <plugin_vc.h>
2. #include <d3dx8.h>
3. #include <game_vc\RenderWare.h>
4.  
5. using namespace plugin;
6.  
7. class DXFont {
8. public:
9.     static ID3DXFont *m_pD3DXFont;
10.  
11.     static void InitFont() {
12.         HFONT hFont = CreateFont(48, 0, 0, 0, FW_NORMAL, FALSE, FALSE, 0, ANSI_CHARSET, OUT_DEFAULT_PRECIS,
13.             CLIP_DEFAULT_PRECIS, DEFAULT_QUALITY, DEFAULT_PITCH|FF_SWISS, "arial");
14.         if (FAILED(D3DXCreateFont(_RwD3DDevice, hFont, &m_pD3DXFont)))
15.             Error("Failed to create D3DX font!");
16.     }
17.  
18.     static void DestroyFont() {
19.         if (m_pD3DXFont) {
20.             m_pD3DXFont->Release();
21.             m_pD3DXFont = NULL;
22.         }
23.     }
24.  
25.     static void Draw() {
26.         if (m_pD3DXFont) {
27.             RECT rect;
28.             rect.left = 0;
29.             rect.top = 0;
30.             rect.bottom = RsGlobal.maximumHeight;
31.             rect.right = RsGlobal.maximumWidth;
32.             m_pD3DXFont->DrawTextA("D3DXFont example for GTA Vice City", -1, &rect, DT_CENTER|DT_VCENTER,
33.                 D3DCOLOR_RGBA(255, 255, 0, 255));
34.         }
35.     }
36.  
37.     DXFont() {
38.         m_pD3DXFont = NULL;
39.         Events::drawingEvent += Draw;
40.         Events::initRwEvent += InitFont;
41.         Events::shutdownRwEvent += DestroyFont;
42.         Events::d3dLostEvent += DestroyFont;
43.         Events::d3dResetEvent += InitFont;
44.     }
45. } dxFont;
46.  
47. ID3DXFont *DXFont::m_pD3DXFont;

[Shagg_E]

Шикарно! Таким макаром, наверное можно и стандартные тексты выдавать windows-шрифтами!
Жаль правда, что с rwd3d9 конфликтует: при активированном в global.ini UseD3D8to9=1 иногда на пару секунд происходит нечто:


Закономерностей не заметил - просто изредка на секунду-другую весь GUI слетает и творится ад. Небо же начинает сохранять "следы" динамических объектов(видно на скринах). Если выставить UseD3D8to9=0 - такого не наблюдается. Очевидно, идет какой-то конфликт из-за того, что оба плагина(Ultimate asi loader с rwd3d9 и этот плагин с текстом) юзают какие-то функции dxd8

[DK]

Наверное, для d3d8tod3d9 стоит использовать DX9 sdk.