Akcesory - listy, mapy, gridy, structy, tablice

Wtorek, 08 Listopada 2022, 15:24
Czas czytania 4 minuty, 36 sekund
Zgodne z GM: gms2
Sposób na znacznie łatwiejszy - a także bezpieczniejszy - odczyt danych z list, map, gridów, struktur i tablic.
GameMaker posiada kilka nietypowych elementów składniowych umożliwiających dostęp do list, map, gridów, struktur i tablic, które nie tylko ułatwiają ich odczyt dzięki krótszemu zapisowi, ale też pozwalają na uniknięcie wyświetlenia ekranu błędu.

Wskazówka:
Przed wydaniem 2.3 GameMaker Studio, wiele funkcji ds_ powodowało błąd krytyczny, jeśli dany wpis nie istniał w strukturze. Obecnie jednak zwracają one typ undefined gdy wartości brak, co mocno ułatwia pracę

Mapy - [# key]ds_map to nic innego jak tablica haszy, gdzie kluczami mogą być nie tylko liczby, ale też tekst.
Odpowiedniki składni za pomocą akcesorów to:

ds_map_set(map, key, value) zapisujemy jako map[? key] = value

ds_map_find_value(map, key) zapisujemy jako map[? key]


key może być "tekstem" lub liczbą całkowitą.

Listy - [| index]Listy są bardzo podobne do tablic, ale posiadają opcję znajdywania pozycji na której jest dana wartość, czy pomieszania elementów.
Odpowiedniki składni za pomocą akcesorów to:

ds_map_set(map, key, value) zapisujemy jako map[? key] = value

ds_map_find_value(map, key) zapisujemy jako map[? key]


index jest zawsze liczbą całkowitą.

Wskazówka:
Od wersji 2022.11 GameMakera, tablice posiadają nowe funkcje (znajdywanie elementu, sortowanie) które pozwalają zbliżyć je do list, jeśli nie potrzebujemy losowania warto korzystać z tablic, ponieważ są zbierane przez garbage collector

Gridy - [# x, y]Gridy są bardzo podobne do tablic 2D, ale posiadają opcję ustawiania/zbierania danych z obszarów (prostokąt, koło).
Odpowiedniki składni za pomocą akcesorów to:
ds_grid_add(index, x, y, val) zapisujemy jako grid[# x,y] = value

ds_grid_get(index, x, y) zapisujemy jako grid[# x,y]

x, y są zawsze liczbami całkowitymi.

Wskazówka:
Jeśli wyjdziemy poza rozmiar grida, w konsoli "Ouput" GMa zobaczymy komunikat Grid 0, index out of bounds writing [1,1] - size is [1,1]

Struct - [$ property]Struktury są "lekkimi obiektami", konterem pozwalającym przetrzymywać dane. Poza notacją struct.property, możemy też odczytywać dane za pomocą akcesorów:

struct.property = value oraz variable_struct_set(struct, "property", value) zapisujemy jako struct[$ "property"] = value

Pobieranie struct.property oraz variable_struct_get(struct, "property") zapisujemy jako struct[$ property]



Jak już wspomniałem, struktury są lekkimi obiektami - dlatego też, powyższa składnia działa także dla instancji obiektów:

instance.property = value oraz variable_instance_set(instance, property, value) zapisujemy jako instance[$ property] = value

Pobieranie instance.property oraz variable_instance_get(instance, property) zapisujemy jako instance[$ property]


property powinno być albo "tekstem", albo zmienną która przetrzymuje tekst.

Wskazówka:
Dzięki temu, że [$ ] pozwala na ustawienie dowolnego tekstu, możliwe jest tworzenie zmiennych ze spacjami możliwych do odczytania tylko przez akcesory i funkcje "variable_".

Tablice - [@ index]Wskazówka:
Dotyczy wszystkich wersji GameMakera przed 2022.1, a nowszych jedynie, jeśli w opcjach projektu zaznaczymy checkbox "Copy on write"
Grafika: /upload/ajax/20221108_73f27b239fdf5dc04803fa3674f96df9.png

W przypadku mechanizmu "copy on write" GameMaker nie modyfikuje tablic przekazanych do funkcji, a tworzy ich kopie i zmienia dane w nich, np.

kodfunction change_array(array) {
array[0] = 1; // tworzy kopię tablicy array jako ukrytą "tymczasową" zmienną i to jej ustawia wartość 1
return array;
}

var b = change_array([0]);

show_debug_message(a); // zwraca [0]
show_debug_message(b); // zwraca [1]

Aby w tym przypadku zmodyfikować oryginalną tabloicę, należałoby napisać:

kodarray[@ 0] = 1;
Warto zaznaczyć, że jeśli nie zmieniamy tablicy w funkcji, to return zwróci nam oryginalną tablicę. Trzeba więc uważać, bo kod taki jak:

kodfunction change_array(array) {
if (irandom(1) == 0) {
array[0] = array[0];
}
return array;
}
Losowo zwróci nam raz referencję do tej samej tablicy, a raz jej kopię. Stąd też w nowszych wersjach zrezygnowano z tego mechanizmu, gdyż stawia on pułapki dla nieświadomych początkujących programistów, a wprowadzono funkcję array_copy().

Łańcuchowe kojarzenie akcesorów (GM 2.3+)Nic nie stoi na przeszkodzie, aby jeden typ danych wstawiać w inny, a potem odczytywać go "łańcuchowo":

koda[? "key"][| 5][# 10, 12][$ "prop"][? "level"]
---

Jak łatwo zapamiętać akcesory?
Jest na to prosty sposób - należy wykorzystać wyobraźnię.

Listy powinny się kojarzyć z czymś wypisanym z góry na dół, z numeracją w jednej linii, stąd znak pionowej lini - |
Mapy powinny się skojarzyć z mapą skarbu, gdzie znakiem zapytania oznaczono poszukiwaną skrzynię - ?
Gridy powinny się skojarzyć z tablicą w której szukamy konkretnej komórki - stąd krzyżyk - #
Structy powinny się kojarzyć z pierwszą literą - "s", którą jednak zapisujemy jako podobny znak specjalny - $
Tablice tak samo jak structy, skojarzmy z pierwszą literą słowa "array" i też zapiszmy jako znak specjalny podobny do "a" - @

Grafika: /upload/ajax/akcesory.png
Komentarze (łącznie 0):
Nie ma jeszcze żadnego komentarza. Czas to zmienić

Najnowsze wersje GameMakera:

LTS
2026.0.0.16 • 2022.0.3.99
wydana 162 dni temu
Beta
2026.100.0.1199 •
2026.100.0.1133
•
 GMRT beta 0.22.4

wydana  wczoraj
= IDE, = Runtime, = GMRT
Użytkownicy online
1 użytkownik aktywny:
gości: 1,
(~ostatnie 15 minut)
Discord
49 użytkowników online na discordzie:
Miłosz, 🧁Cupcake🧁, MorDan, Nikas, Alice, LeD, Nitro Slav, 21Lancz, Carl-bot, pABLO, h..., Fox, GibkiKaktus, s..., Cosplyfanka, Wielki Druid, GMRussell, Tidżi, fervi, Soplyash, r..., Threef, Uzjel, Pako, Murrri, Kandif, yazaa, HappyOrange, Deusald, szmalu, Korodzik, sgames, tomqz, Grela, sutikku, OdrzuconyKrakers, Ulti, Dyno, Danieo, bagno, Arrekin, MrTesterr, Robert, l..., moeglich, g..., Add92, Krzysiek1250, Shockah
Shoutbox
gnysek (23:36, 02.11.26)
Zniknęła, stara wersja nie powinna byc dostepna. Chociaz widziałem, ze został przełącznik na górze w zębatce obok avatara, moje przeoczenie :D
Borek (20:47, 02.11.26)
Gdzie jest opcja, żeby wstąpić do bety GMCLAN? bo nigdzie nie widzę.
gnysek (11:10, 01.11.26)
teraz też wyróżnia nowe wpisy od ostatniej wizyty ;)
Borek (18:45, 31.10.26)
No, już jest lepiej :) Dalej retro, ale użyteczne :D To mi się podoba :)
gnysek (12:36, 31.10.26)
Ok, teraz jak wpiszesz więcej tekstu, to się po prostu automatycznie powiększa ;) I poprawiłem CSS dla tips/warns w artykułach i newsach na ciemnym motywie, tak porządnie. I teraz zapamiętuje "przeczytane" komentarze między przeglądarkami.
Adriann (15:31, 29.10.26)
Tak, rozumiem używanie ai jako narzędzia ale nie w ten sposób że nie widać w tym pracy człowieka :o
Borek (15:13, 26.10.26)
Nie narzekam na ruch (sam napisałem, że przynajmniej jakiś ruch jest), ale martwi mnie jakość "gier", które nagle zaczynają się pojawiać z dupy. "Catch the clown" przynajmniej był stworzony przez człowieka, tak samo jak opis na forum :)
Wojo (11:49, 26.10.26)
Nie ma ruchu - narzekacie, jest ruch - narzekacie. Nie są to gry z najwyższej półki, ale każdy robi tak jak potrafi. Za starych gmclanowych czasów było wiele produkcji amatorskiej jakości, ale dzięki temu forum tętniło życiem.
Borek (16:08, 25.10.26)
Chodzi mi o ten INPUT, jedna linia, ciężko się tutaj pizse :) Ja wiem, że retro, ale trochę QoL nie zaszkodzi :D
gnysek (16:00, 25.10.26)
A co jest nienormalnego? :D Jest takie jak zawsze było, pełne retro ;) Zerknę, w następny weekend planuję lekki update strony. 3 wpisy to nie tragedia, ale jak będzie wiecej AI slopu to pewnie zacznę kasować.
Starsze wpisy znajdziesz w Archiwum.
Ankieta
Czy udostępnienie źródła GMRT dla każdego i brak opłat za licencje jest dobrym krokiem?