Fastbar
Powrót do strony głównej
Trzymaj pliki na gmclan.org!
Game Maker w pytaniach i odpowiedziach!
Polska dokumentacja
Tabela wyników ligi 24
Pobierz GM
Akademia GMCLANu
Kategorie bazy artykułów
Artykuły -> Game Maker
Treść artykułu
Tworzenie DLLi w C++ i Object Pascal dla GM
autor: Tymon (9.01.07)
1. Do kogo skierowany jest artykuł?
     Oczywiście dla osób obecnie zainteresowanych czyli pragnących napisać własną bibliotekę (DLLa), oraz chcących wyciągnąć z Game Makera dużo więcej niż obecnie sam potrafi. Wszystko co tu opiszę nie jest to zbyt skomplikowane, jednak wymaga znajomości pewnych podstaw Game Maker Language (GML), C++ oraz Object Pascal - mam nadzieję że masz to już w małym paluszku! Postaram się opisać wszystko równie zrozumiale dla wszystkich, wykluczam tylko totalną niewiedzę. =]

2. Narzędzia
     Potrzebny będzie ci Game Maker w wersji 6.1 (choć wydaje mi się że w 5.x obsługa DLLi będzie wyglądać bardzo podobnie) z włączonym Advanced Mode (trybem zaawansowanym, można go włączyć w klikając menu 'File' -> 'Advanced Mode' - powinna pojawić się tam tzw. fajka) i do tego zarejestrowany. Jeszcze jakiś kompilator C++, najlepiej Dev C++ 4.9.9.2 (darmowym, wygodny system 'paczek', przyjazny edytor kodu) bo jego właśnie będę używał. No i Delphi - ja używam wersji 6. =) I tyle. Może się jeszcze przydać staromodna kartka i długopis. =P

3. Jak trawić biblioteki w Game Maker?
     Użycie biblioteki i odwołanie się do jej funkcji w Game Maker sprowadza się tylko i wyłącznie do użycia trzech funkcji! Są to external_define, external_call oraz external_free. Oczywiście każda z nich wymaga szczegółowego opisu, więc:

kod:
external_define( dll, funkcja, typ odwołania, typ zwracanej, liczba argumentów, typ argumentu 0, typ argumentu 1, ..., typ argumentu 11 )
Opis:
     Nie odwołuje się do funkcji z biblioteki! Definiuje tylko ją oraz jej typy argumentów i zwracanej dla Game Makera. Zwraca identyfikator za pomocą którego możemy się później odwołać do funkcji.
Argumenty:
     dll - nazwa pliku biblioteki.
     funkcja - nazwa funkcji znajdującej się w bibliotece.
     typ odwołania - typ odwołania do biblioteki - dll_cdecl albo      dll_stdcall.
     typ zwracanej - określa typ zwracanych danych. Tak jak funkcje Game Makera może być to real albo string - odpowiednio użyj ty_real dla real i      ty_string dla string.
     liczba argumentów - maksymalna liczba argumentów jakie może przyjąć funkcja, tylko liczby od 0 do 11.
     typ arguemntu 0 ... 11 - typ wartości przekazywanych dla funkcji, może być to real albo string - odpowiednio użyj ty_real dla real i ty_string dla string.

kod:
external_call( identyfikator, argument 0, argument 1, ..., argument 11 )
Opis:
     Odwołuje się do funkcji z biblioteki, zwraca dane przekazane przez funkcję o określonym wcześniej typie w funkcji external_define.
Argumenty:
     identyfikator - wcześniej otrzymany przez wykonanie funkcji external_define, niezbędny do odwołania się do funkcji.
     argument 0 ... 11 - argumenty do przekazania dla funkcji, pamiętaj o wcześniej zdefiniowanym typie w external_define!

kod:
external_free( dll )
Opis:
     Zwalnia określoną bibliotekę z pamięci. Podobno - wyłącznie podobno, Game Maker sam zwalnia biblioteki po zakończeniu działania, nie sprawdziłem tego, ale i tak nie dmuchał bym na zimne.
Argumenty:
     dll - nazwa biblioteki którą chcesz zwolnić.

Oprócz tych dwóch podstawowych jest jeszcze window_handle która zwraca identyfikator uchwytu okna (dosłownie tłumacząc =)

Tyle odnośnie funkcji Game Makera.

4. Pisanie biblioteki w C++
     Teraz trochę cierpienia. Jeśli nie masz Dev C++ to ściągnij, zainstaluj i wróć do czytania, następnie uruchom go i utwórz czysty projekt. Kliknij w tym celu menu 'Plik' -> 'Nowy' -> 'Projekt' i wybierz 'Empty Project'. Program poprosi cię o wskazanie miejsca gdzie mają być składowane pliki projektu - najlepiej utworzyć dla niego jakiś folder. Teraz ustawienia, wejdź w menu 'Projekt' -> 'Opcje projektu', następnie na zakładce 'Ogólne' poszukaj pola 'Typ' (dolny prawy róg) i zaznacz 'Win32 DLL'. Kliknij OK. Teraz wyjściowym wynikiem pracy kompilatora będzie biblioteka *.dll. Teraz plik źródłowy, czyli zakładka 'Plik' -> 'Nowy' -> 'Plik źródłowy', zada Ci głupie pytanie , oczywiście kliknij 'Yes'. Otworzył się edytor kodu, dobrze było by zapisać od razu plik źródłowy, więc menu 'Plik' -> 'Zapisz' i wklep nazwę pliku (np. dllmain). Przejdźmy teraz do przyjemniejszej części.

     Kodowanie odbywa się tak samo jak w przypadku każdej innej aplikacji - za wyjątkiem kilku wyjątków. Otóż, musimy pilnować typów naszych danych, jeśli coś jest typu real to ma być real, ale o tym jeszcze później. Oprócz tego musimy jeszcze pokazać palcem kompilatorowi które funkcje mają być eksportowane i jednocześnie dostępne dla Game Makera, aby to zrobić musisz dodać oto taką linijkę przed nazwą funkcji:
kod:
extern "C" __declspec(dllexport)
Więc konstrukcja funkcji będzie wyglądał tak:
kod:
extern "C" __declspec(dllexport) [zwracana] [funkcja] ( [argumenty] )
{
//Kod funkcji
}
Może to wprowadzić lekki bałagan w kodzie, a z racji że nie lubimy się męczyć, a tym bardziej ja sam, zdefiniujemy sobie coś takiego, powinno się to znaleźć przed resztą kodu:
kod:
#define export extern "C" __declspec(dllexport)
Dzięki temu uprościmy nieco konstrukcję, oraz nie będziemy musieli pamiętać tych wszystkich szlaczków bo pod słowo export zostały one "podpięte". Teraz konstrukcja funkcji wygląda tak:
kod:
export [zwracana] [funkcja] ( [argumenty] )
{
//Kod funkcji
}
Dużo lepiej. Taka prosta linijka daje do zrozumienia wszystkim że funkcja jest do wykorzystania przez Game Maker, nie jest to coś skomplikowanego jak widać.

Wracając jeszcze do typów zwracanej i argumentów. Z racji iż C++ to nie GML trzeba ustalić typy które będą odpowiednikami tych Game Maker, a są nimi char* dla string i double dla real. Możesz zdefiniować sobie coś podobnego jak zrobiliśmy to z export:
kod:
#define gmreal double
#define gmstring char*
Typ zwracanej musi być taki sam w C++ i Game Maker. Inaczej program wywali ci błąd. Więc lepiej nie używać tutaj typu integer zamiast double, mogą pojawić się po prostu różne komplikacje!

Jeszcze jedno, aby przekazać jakąś wartość przez funkcję musisz teraz użyć tylko return:
kod:
export [zwracana] [funkcja] ( [argumenty] )
{
     return [wartość];
}
Tak jak w GM, prawda? Tylko pamiętaj o typie zwracanej w Game Maker i C++ =)

     I to już wszystko odnośnie C++. Możesz już kompilować swój projekt, poprawić ewentualne błędy i załączyć bibliotekę do twojej gry. Nie takie straszne prawda? Jak widzisz możesz traktować bibliotekę jak zwykły program zachowują tylko kilka podstawowych zasad tyczących się relacji między Game Makerem a C++ i eksportowania funkcji.

5. Przykładowa biblioteka w C++
     Trudno przyjąć wiedzę bez przykładów.

Plik źródła biblioteki:
kod:
#include<windows.h>

#define export extern "C" __declspec(dllexport)

export double GMBeep( double a1, double a2 )
{
     Beep( a1, a2 );
}

export char* GMText( void )
{
     return "Jakis tekst przekazany przez funkcje biblioteki.";
}

export double GMAdd( double l1, double l2 )
{
return l1 + l2;
}
I w create jakiegoś obiektu w Game Maker:
kod:
GMBeep = external_define( 'dll.dll', 'GMBeep', dll_stdcall, ty_real, 2, ty_real, ty_real );
GMText = external_define( 'dll.dll', 'GMText', dll_stdcall, ty_string, 0 );
GMAdd = external_define( 'dll.dll', 'GMAdd', dll_stdcall, ty_real, 2, ty_real, ty_real );

show_message( external_call( GMText ) );
show_message( 'Suma 1111 i 7777 to ' + string( external_call( GMAdd, 1111, 7777 ) ) );

show_message( 'Beep!' );
external_call( GMBeep, 1000, 1000 );

external_free( 'dll.dll' );
Miłego testowania! =)

6. Pisanie biblioteki w Object Pascal (Delphi)
     Tutaj pisanie biblioteki jest dużo, ale to dużo prostsze. =) Nie musimy się bawić w takie ciągutki jak w C++. No, ale w sumie - Delphi jest dla leni =P

     Na początku musimy stworzyć nowy projekt. Więc klikasz po kolei menu 'File' -> 'New' -> 'Other...' i odszukaj tam komponentu 'DLL Wizard', znajduje się w zakładce 'New'. I to tyle, najlepiej od razu zapisz cały projekt! =)

     Kodowanie jest równie proste, wystarczy teraz że napiszesz jakąś funkcję i następnie użyjesz exports w celu jej wyeksportowania. Konstrukcja funkcji może wyglądać tak:
kod:
function [nazwa]( [argumenty] ) : [zwracana]; [odwołanie];
var
//Zmienne
begin
//Tu kod funkcji
end;
exports [nazwa];
Prawda że proste? Uwaga co do odwołania - może być tu albo stccall albo cdecl - tak jak w GM.

     Zwracana tak jak i argumenty mogą i muszą być, albo typu double który jest odpowiednikiem real, albo pchar który jest odpowiednikiem string.

     Zwracanie zmiennej odbywa się po przez przypisanie zmiennej Result jakiejś wartości, np.:
kod:
function [nazwa]( [argumenty] ) : [zwracana]; [odwołanie];
var
//Zmienne
begin
     Result := [wartosc]
end;
exports [nazwa];


7. Przykładowa biblioteka w Object Pascal
Kod bibloteki:
kod:
library TestDll;

function GMText():pchar; stdcall;
begin
Result := 'Jakis tekst przekazany przez funkcje biblioteki.';
end;

function GMAdd( l1, l2 :double ):double; stdcall;
begin
Result := l1 + l2;
end;

exports GMText, GMAdd;

begin
end.
I w create jakiegoś obiektu w Game Maker:
gml:
GMText = external_define( 'dll.dll', 'GMText', dll_stdcall, ty_string, 0 );

GMAdd = external_define( 'dll.dll', 'GMAdd', dll_stdcall, ty_real, 2, ty_real, ty_real );
show_message( external_call( GMText ) );
show_message( 'Suma 1111 i 7777 to ' + string( external_call( GMAdd, 1111, 7777 ) ) );

external_free( 'dll.dll' );
Miłego testowania! =)

8. Słowo od autora
     Wybaczcie mi ogólnie panujący nieład w sposobie opisu i definiowania niektórych terminów czy też funkcji - z natury jestem człowiekiem chaotycznym. Starałem się naprawdę napisać to prosto i zrozumiale. =) Gdybym coś pominął, albo coś jest jeszcze niejasne to proszę mnie poinformować. Liczę że dotarł do większej części czytających oraz oczywiście - że choć trochę pomógł w zrozumieniu mechanizmu rozszerzania możliwości Game Makera przez biblioteki.

          Pozdrawiam, Tymon =3
głosów: 23 | ocena: 8.74 oceń zasób | dodał: Tymon
Komentarze
stron: 21

2


av

kubasz (16:29, 15.11.2007)

Dużo informacji, kodu i innych !!!

av

Marmot (19:57, 9.07.2008)

Nie ma nic gorszego niż robienie DLLi do GM. Tylko dwa typy, których można używać - PChar (char* w C++) i Double. Idiotyzm. O ile PChar jest jeszcze sensownym, o tyle Double to idiotyzm w najczystszej postaci ;p . Normalnie pisząc DLLe, stosuje się typy rodzaju boolean (bool w C++), byte (o ile się nie mylę, coś pokroju unsigned char w c++) czy integer (int w c++) aby zaoszczędzić miejsce w pamięci, a tu zonk, nie można. Co jak co, ale jest różnica między 8 bajtowym Double, a 1 bajtowym byte, czy 2 bajtowym integer, czy nawet 1 bitowym boolean ;p . Trudno, trzeba przecierpieć to jakoś. Chciałbym, aby w GM8 była możliwość używania także innych typów zmiennych w DLLach, to by na prawdę był miły prezent od Yoyogamesu

av

Marmot (19:58, 9.07.2008)

A chodzi mi z tym o to, że np. ja chcę w DLLu zrobić, że wpisuje się w argumencie 1 lub 2, mógłbym to zrobić na byte, ew. integer, a na upartego nawet jako boolean (ale wtedy 0 i 1), ale pupa blada, muszę użyć typu skierowanego do liczb mających do 15 miejsc po przecinku ^^ .

av

Skovv (18:10, 5.01.2009)

Super Artykuł

av

47xxxxxxxx (21:56, 14.06.2009)

w miejscach dla Dephi są emotikonki ()

stron: 21

2



Dodaj komentarz:
Treść:
Menu
Panel użytkownika
Jesteś niezalogowany!

Nie masz konta? Zarejestruj się
Użytkownicy on-line
5 użytkownik(ów) aktywny(ch) przez ostatnie 15 minut:
gości: 4, userów: 1, ukrytych: 0
I am vader
Użytkownicy na czacie discord
I am vader (12:50, 18.08.18):
gratki
Penguin (11:29, 18.08.18):
Gratulacje
exp (22:07, 17.08.18):
gratuluję również, kariera z przyszłością
Chell (15:00, 17.08.18):
dzieki
Wojo (11:37, 17.08.18):
Gratulacje
Chell (7:00, 17.08.18):
jaką stawkę myślicie że mogę wołać ako junior php po miesiącu praktyk i 2 stażu?
Chell (6:59, 17.08.18):
gmclany, zaraz będę kończył staż i zaczynał pracę na pół etatu
gnysek (9:54, 16.08.18):
niewiele, ale jest szybsze.
MaxGaming (3:25, 16.08.18):
Skoro pliki o rozszerzeniu html(przy standardowej konfiguracji serwera) są po prostu wyświetlane, a te z rozszerzeniem php wykonywane to czy użycie pliku html o tym samym kodzie jest szybsze niż pliku php(jeśli w źródle pliku znajduje się oczywiście sam kod hrml)?
Wojo (17:12, 15.08.18):
Exp podglądaj sobie reportaże o chwilowkach i o tym jak ludzie mają problemy z wyjaśnieniem że nie brali żadnego kredytu
exp (15:16, 15.08.18):
max czemu nie mógł udowodnić, nie chcieli sprawdzić jego podpisu? numer dowodu się zgadzał?
exp (15:15, 15.08.18):
no to też może się przydać, bo typ na koncie google miał podane imię i nazwisko i w adresie prawdopodobnie miał datę urodzenia, więc jak ktoś mnie okradnie, to mam podejrzanego. ale wątpię, że prokuratura będzie zainteresowana tym
I am vader (12:27, 15.08.18):
Nie powinno też się mordować ale to nie powstrzymuje ludzi
Wojo (22:26, 14.08.18):
Ale z drugiej strony nie powinno się kogoś okradać mimo wszystko
Sutikku (21:57, 14.08.18):
exp w formie dowodu mógłby pokazać, że nieumyślnie wysłał komuś swoje dane?
MaxGaming (17:37, 14.08.18):
Mój znajomy własnie wpadł w taką chwilówkę i jako że nie potrafił udowdnić że to nie on wziął to musi to spłacać
exp (17:36, 14.08.18):
no jak czytałem o tym, to w takiej sytuacji musisz de facto udowodnić niewinność
Wojo (19:56, 13.08.18):
z tym są różne scenariusze ale i tak powinien ktoś to uregulować bo to jest nienormalne jak mozna czlowiekowi zniszczyc zycie przez bledy mlodosci
exp (19:46, 13.08.18):
zna mój adres zameldowania, a nie zamieszkania, więc wyjebongo. boję się tylko o chwilówki itd. podobno w razie przyjścia komornika łatwo zamknąć sprawę, ale i tak nie chciałbym takich nieprzyjemności
Sutikku (19:29, 13.08.18):
osobiście myślę, że nic Ci nie grozi, ewentualnie pizza co wieczór będzie przyjeżdżać
exp (15:33, 13.08.18):
przez głupią literówkę wysłałem skan pewnego papieru niewłaściwej osobie. robię to regularnie i zrobiłem się trochę nieostrożny
exp (15:31, 13.08.18):
myślicie, że grozi mi coś, jeśli obcy człowiek posiadł prawie wszystkie moje dane osobowe? (ale nie zna mojego numeru dowodu)
gnysek (10:20, 11.08.18):
Dobra zrestartowałem serwer.
gnysek (10:36, 10.08.18):
wynajem!
MaxGaming (0:23, 10.08.18):
chodiz mi bardziej o doświadczenie niż hajs bo pracować wolę na swoim za mniej niż na etacie za więcej ale jednak pierwsza praca po technikum informatycznym od razu w marketingu to fajna sprawa. Tylko jeździć ponad 100km w jedną stronę codziennie pociągiem?
MaxGaming (0:22, 10.08.18):
więc nie mam pojęcia co robić
MaxGaming (0:22, 10.08.18):
wgl to zaproponowano mi prace w dziale marketingu jednej z polskich firm dzięki temu co uczę się na własną rekę, sam dyrektor działu marketingu stwierdził że woli takie osoby niż te świeżo po studiach które na studiach nie nauczą się praktycznie nic co jest na prawdę potrzebne w tej pracy ale... w WWA a ja mam jednak daleko żeby codziennie tam dojedżać
MaxGaming (23:56, 9.08.18):
nie wytłumaczysz że na prawdę rząd nie może stworzyć tych pieniędzy na 500 plus
MaxGaming (23:55, 9.08.18):
Obsługi telefonu dziecko się samo potrafi nauczyć. Teraz spróbuj nauczyć tego moją babcię. Zrozumcie że ludzie są różni. Znam 20 latków których
I am Lord (23:13, 9.08.18):
I nie chodził na żadne dokształcające najęcia
I am Lord (23:13, 9.08.18):
Mój tata pojechał do Norwegii bez języka i się nauczył go w rok już tak że coś tam rozumiał w pracy a przez 3 latach już w miarę płynnie gada
I am Lord (23:11, 9.08.18):
Przebywanie w obcym środowisku dłuższy czas sam w sobie uczy człowieka jezyka
Sutikku (22:46, 9.08.18):
zgadzam się
MaxGaming (22:40, 9.08.18):
Ale język nie jest potrzebny żeby przetrwać widocznie. Odpuścice trochę. Każda rozsądna osoba by się uczyła języka ale nie jest to jakiś przymus. Myślę że to właśnie dzięki temu że takie osoby nie myślą "nie znasz języka, nie próbuj" to przynajmniej nie siedzą na zasiłkach w Polsce tylko na zmywaku w Anglii
Sutikku (22:36, 9.08.18):
o przepraszam za przekleństwa, wydawały się tak adekwatne do treści, ze nie zauważyłem.
Sutikku (22:34, 9.08.18):
a co to za robienie gierek jak wychodzą Ci chujowe i są rakiem gamingu, i co z Ciebie za żołnierz jak chujowo strzelasz? Grunt, że próbują, efekty słabe fakt. Nie uważam, że to dobre i mądre wyjście, nie miałbym strefy komfortu gdybym nie mógł komunikować się w czyimś kraju, ale potrafię takich ludzi zrozumieć. Dziwniejsze jest dla mnie, że będąc tak długo w danym kraju język sam się nie podłapie.
Wojo (21:20, 9.08.18):
najwyraźniej nie jesteś patustem skoro nie potrafisz pojąć tego jak można żyć na krawędzi i bez żadnych zmartwień
I am vader (20:11, 9.08.18):
Ale co to za życie jak się izolujesz i stajesz się rakiem narodu?
Sutikku (17:40, 9.08.18):
potrafią i próbują ;p
Sutikku (17:40, 9.08.18):
słabe porównania, bo za granicę przeważnie jedzie się zarobić i żyć, a skoro oni zarabiają i żyją, to więcej im do szczęścia nie trzeba
I am vader (17:20, 9.08.18):
Jak idziesz na wojnę uczysz się strzelać, bo inaczej zginiesz. Jak chcesz zrobić grę to uczysz się programowania, bo inaczej nie dasz rady. Jak idziesz do szkoły uczysz się tego co Ci każą, bo inaczej jesteś idiotą. Jak wyjeżdżasz za granicę, uczysz się jezyka i kultury, bo inaczej jesteś pasożytem. Proste. Nie potrafisz, nie próbuj.
Wojo (14:32, 9.08.18):
Zazwyczaj są to ludzie, którzy nie lubią gdy narzuca im się jakiekolwiek zasady
exp (13:44, 9.08.18):
max, jeżeli nauczenie się języka kraju, w którym mieszka się na stałe jest dla niektórych niemożliwe ze względu na "strefę komfortu" to już nie wiem, co mam powiedzieć xd
exp (13:43, 9.08.18):
też znam ukraińców, którzy mówią po polsku, niektórzy bardzo dobrze. tak samo, jak wielu polaków w anglii czy niemczech też dobrze zna język miejscowy. nigdzie nie mówiłem, że wszyscy są źli, ale wielu
Wojo (13:15, 9.08.18):
propaganda cały czas istnieje tylko jest bardziej lub mniej intensywna. Aktualnie nie ma żadnej szansy aby dziecko nie było skażone propagandą (no chyba, że mieszka w jaskini)
MaxGaming (12:14, 9.08.18):
nie słuchałem jak ktoś kiedyś na tym forum polecał w każdym nowym telefonie taśmą zaklejać ten czujnik zalania i teraz mam problem XD
MaxGaming (12:09, 9.08.18):
za dużo propagandy już poszło. Trzeba by czekać a nowe pokolenie które nie jest skażone propagandą A o zgrozo propaganda nie ustaje
MaxGaming (12:08, 9.08.18):
W sumie demokracja to jedna wielka pułapka. Co możemy niby zrobić? Chodzić po domach i tłumaczyć ludziom żeby głosować na inne partie? Nie da rady przekonać większości
MaxGaming (12:07, 9.08.18):
sądzą że są sprytni bo wolą PO albo PiS, a to jest jeden ciort
MaxGaming (12:07, 9.08.18):
Ale tak jest w obie strpny. "Wpjna" PO/PiS to pułapka w którą większośc ludzi się łapie
Ankieta
» Jakie kursy najchętniej widziałbyś na stronie ?
GM Studio
GM Studio 2
Godot
Construct

GMCLAN to serwis o programie Game Maker i nie tylko.
[ Polityka prywatności ]
Copyright © 2002-2018. GMCLAN.ORG
Wszelkie prawa zastrzeżone. Kopiowanie materiałów bez zgody redakcji zabronione!
© 2002-2017 Ranmus (ranmus.pl), © 2017-2018 {=|=} fable_inside();

[ Czas generowania strony: 0.02024 sekund ] [ Liczba zapytań MySQL: 13 ]