stationFunctions
|
|
| EN | PL |
- Wprowadzenie
- Definicja układu kafli
- Funkcje wydajności stacji
- Funkcje pomocnicze
W m4nfo stacje wykorzystują cztery rodzaje funkcji:
- funkcje do definiowania układu kafli z sprites, współrzędnych i informacji 3D,
- funkcje do uzyskiwania informacji o bieżących (lub sąsiednich) właściwościach kafla, takich jak liczba lub długość platform, typ terenu, nachylenie terenu itp., A także funkcje uzyskujące dostęp do zmiennych wewnętrznych gry, takich jak bieżąca data, klimat itp. Zobacz funkcje wydajności stacji,
- funkcje pomocnicze, które są wykorzystywane przez te dwa pierwsze rodzaje funkcji,
- Funkcje globalne, które są ważne nie tylko dla stacji, ale dla wszystkich funkcji.
W przypadku kafli stacji układ kafli określa, jakie sprites powinny być wyświetlane, gdzie mają być wyświetlane i w jakiej kolejności.
Ponieważ w TTD układ kafli dla stacji jest nieco inny niż dla budynków i obiektów, musi to być również odzwierciedlone przez m4nfo. Głównym powodem tej różnicy jest to, że dla stacji układ kafli jest oddzielony od prawdziwych sprite'ów zdefiniowanych w spriteblock() i dostępnych za pomocą funkcji spriteset(), a w ten sposób układ może łatwo obsługiwać różne zestawy sprites o tej samej strukturze układu.
layout(<ID>,
{<tile>(
[label,] <groundsprite> {<buildingsprite>(<xoffset, yoffset, zoffset> <xextent, yextent, zextent>) |
<buildingsprite>(<xpixeloffset, ypixeloffset>)}
}
)
|
W przypadku kafli stacji istnieją dwa rodzaje sprites . Pierwszy typ ustanawia nową obwiednię 3D do użycia przez sorter kształtów. Drugi typ współdzieli obwiednię 3D poprzedniego sprite. Nie może być większy od sprite, który ustanowił obwiednię, ani też żadna jego część nie może znajdować się poza tym polem. Dla uproszczenia może mieć dokładnie takie same wymiary jak ikonka, z którą dzieli obwiednię.
Obwiednia 3D jest używana przez sorter sprite'ów TTD do określenia kolejności rysowania sprites, a także do poinformowania go, które sprites mają zostać narysowane, ponieważ te, których obwiednia znajduje się poza aktualnie zaktualizowanym prostokątem ekranu, nie zostaną narysowane. Upewnij się, że obwiednia 3D jest wystarczająco duża, aby pomieścić całego sprite, ale nie tak duża, aby sorter kształtów nie mógł określić, które sprites powinny znajdować się z przodu.
Oznacza to, że kolejność, w jakiej sprites są określone, nie ma znaczenia. Sprite'y zawsze będą losowane od tyłu do przodu, w kolejności, którą sorter sprites uzna za poprawną, z ich obwiedni. Istnieją jednak dwa wyjątki:
- Sprite'y dzielące tę samą obwiednię będą zawsze rysowane w podanej kolejności.
- Okno budowy stacji nie korzysta z sortera kształtów. Kafle, które mogą być wyświetlane w tym oknie, muszą być określone w odpowiedniej kolejności rysowania, od tyłu do przodu.
Podobnie jak w przypadku domów, kafli przemysłowych i obiektów, m4nfo zapewnia te same funkcje pomocnicze, które mają być używane w definicjach układu kafli, ale z nieco inną składnią niż dla wyżej wymienionych funkcji:
| Termin układu | funkcja m4nfo |
| <tile> | tile() | xtile() |
| <groundsprite> | ground() | NOSPRITE |
| <buildingsprite> | regular() | notransparency() | glass() | recolour() | NOSPRITE |
| <xoffset, yoffset, zoffset> | xyz() |
| <xoffset, yoffset> | xy() |
| <xextent, yextent, zextent> | dxdydz() |
| <xpixeloffset, ypixeloffset> | xyoff() |
Ta funkcja konfiguruje układ kafli dla określonego identyfikatora stacji. Potrzebuje co najmniej dwóch wywołań funkcji tile() (lub jednego z xtile()): jednego dla kafla w x- i drugiego dla kierunku y. Wywołania tile()/xtile() są kolejno numerowane wewnętrznie, tzn. pierwszy kafel stacji otrzymuje numery 0/1 (kierunek x/y), drugi otrzymuje 2/3 i tak dalej. Są to numery kafli, do których odwołuje się CB_LAYOUT wywołania zwrotnego z funkcji makestation() podczas rysowania wszystkich kafli stacji we właściwy sposób. (Oczywiście możliwe jest użycie "etykiet" zamiast liczb podanych pośrednio, patrz następny akapit.)
Struktury układu mogą być używane wielokrotnie, odwołując się do różnych zestawów sprite'ów graficznych.
Ta funkcja pobiera blok definicji sprite'ów, zarówno dla sprites naziemnych, jak i sprites budynków, patrz poniżej. Kafel może być oznaczony etykietą, aby odwołać się do niego później, np. w łańcuchu CB_LAYOUT:
layout(_ROOFS, ... tile(__roofs, ground(1011) regular(21, xyz(0,0,0), dxdydz(5,16,12)) regular(24, xyz(0,0,0), dxdydz(16,16,35)) ) ... )... def(3) plt_num( self( reftile(__roofs) if(4) reftile(__roofs+1) if(3) reftile(__roofs+2) if(2) reftile(__roofs+3) if(1) reftile(0) else ) )
Funkcja xtile() może być używana do automatycznego generowania definicji ikonek dla kafla w kierunku y, pochodzących z kafla w x-direction. Użycie tej metody wymaga wielu dodatkowych wymagań i jest bardziej ograniczone niż użycie tile(): sprites budowlane muszą być uporządkowane w taki sposób, aby ich numery sprite'ów wynosiły +1 dla kafla w kierunku y, a dla sprite'ów naziemnych różnica musi wynosić -1 dla oryginalnych sprite'ów TTD i +1 dla niestandardowych sprites gruntowych. Współrzędne 3D zostaną odpowiednio zamienione. Sprite'y graficzne skojarzone z kierunkami x i y układu xtile() muszą być symetryczne, aby zapewnić poprawne obwiedni, a nie można użyć funkcji xyoff(), ponieważ współrzędne kształtów graficznych są całkowicie nieznane w układach kafli.
Ta funkcja definiuje sprites ziemi, który ma być użyty dla danego kafla. W bloku kafla może istnieć tylko jeden sprite ziemi zdefiniowany przez metodę ground(). W przypadku wielu (ułożonych) płytek gruntowych muszą one być dostarczone za pomocą funkcji regular() przed zdefiniowaniem jakiejkolwiek obwiedni.
Można zdefiniować oryginalne sprites terenu TTD lub niestandardowe sprites gruntu zdefiniowane w spriteblock(). W takim przypadku potrzebny będzie drugi parametr ustawiony na CUSTOM.
Jeśli nie jest potrzebny sprite, należy użyć makro NOSPRITE zamiast wywoływania funkcji ground(). Może to być przydatne do wyświetlania grafiki ikon lub podczas rysowania niestandardowych fundamentów.
Ta funkcja definiuje "normalnego" sprite budynku (lub dodatkowego sprite gruntowego). Pierwszy parametr to indeks do spriteblock powiązany z bieżącym układem, pozostałe parametry są albo przesunięte od północnego rogu kafla i rozmiaru sprite'a, albo przesunięcia względem poprzedniego sprite'a (patrz zdjęcia poniżej). W tym drugim przypadku ten sprite będzie dzielił swoją obwiednię z bieżącą obwiednią. Ustawienie opcjonalnego parametru "TTD" umożliwia dostęp do oryginalnych sprites TTD.
Ta funkcja działa tak samo jak regular(), tylko gdy jej sprite jest wyświetlany normalnie nawet w trybie "przezroczystych budynków".
Ponownie to samo zachowanie co w przypadku regular(), ale tym razem przy użyciu domyślnej translacji kolorów firmy.
Znowu to samo zachowanie co regular(), ale tym razem z translacją kolorów zdefiniowaną przez tabelę recolor podaną przez ostatni parametr.
To samo zachowanie co w przypadku metody regular(), ale sprite jest rysowany w trybie 'transparent', albo przy użyciu domyślnego trybu 'glass', albo przy użyciu niestandardowego przezroczystego kolorowania, gdy podano dodatkowy parametr. Ten parametr musi być adresem mapy ponownego kolorowania, która ma być użyta do uzyskania efektu szkła.
Ta funkcja definiuje przesunięcia x/y/z bieżącego sprite z północnego rogu kafla. Zwróć uwagę, że współrzędne są współrzędnymi 3D, gdzie x biegnie od prawego górnego rogu do lewego dolnego rogu i y biegnie od lewego górnego do prawego dolnego rogu (patrz rysunek poniżej), przy czym wymiary kafli wynoszą 16x16 px dla x i y oraz 8 px dla jednego poziomu wysokości. Oznacza to, że wartości x i y powinny zawsze mieścić się w granicach 0 .. 15.
Ta funkcja definiuje rozmiar bieżącego sprite w kierunku x/y/z. Podane współrzędne są równe powyższym współrzędnym.
Ta funkcja definiuje przesunięcia x/y sprite podrzędnego w stosunku do poprzedniego ustawienia kształtu obwiedni. Współrzędne odnoszą się do lewego górnego rogu poprzedniego sprite'a, tj. nie jest to współrzędna 3D.
W nowszych wersjach OpenTTD obsługiwany jest tak zwany "zaawansowany format układu sprites" (ASL), który umożliwia "dynamiczne" modyfikacje układu za pomocą rejestrów.
Formalna specyfikacja M4NFO dla tego formatu jest jak wyżej, z wyjątkiem dwóch dodatkowych parametrów w funkcjach M4NFO ground(), regular(), recolour() i glass(), a mianowicie <flags> (ustawiane przez funkcję aslflags()) i <registers> (ustawiane przez rejestry funkcji()). Np. ground(<sprite> [,CUSTOM]) otrzymuje ground(<sprite> [,CUSTOM], <flags>, <registers>) lub regular(<tile-id>, (<xyz()>, <dxdydz()>) | <xyoff()> [,TTD]) otrzymuje regular(<tile-id>, (<xyz()>, <dxdydz()>) | (<xyoff()> [,TTD]), <flagi>, <rejestr>.)
Funkcja aslflags() przyjmuje jako parametr cytowaną listę następujących flag:
| Flagi w zaawansowanych układach kształtów | ||||
| Wartość | Etykieta | sprite macierzysty | sprite naziemny/podrzędny | rejestr(-y) |
| 1 | SKIP | Pomiń obwiednię w tym sprites podrzędne | Pomiń sprite | 1 |
| 2 | OFFSET_SPRITE | Dodaj przesunięcie do numeru sprite, wyłącz domyślne użycie etapu budowy lub przesunięcia typu szyny | 1 | |
| 4 | OFFSET_RCSPRITE | Dodaj przesunięcie, aby ponownie pokolorować liczbę ikonek | ||
| 8 | CUSTOM_RCSPRITE | Recolor sprite pochodzi z niestandardowego spriteblocka OFFSET_SPRITE może być również użyty | n/a | |
| 16 | OFFSET_XY | Dodaj przesunięcie 3D w <x> i <y> | 2 | |
| 32 | OFFSET_Z | Dodaj przesunięcie 3D w <z> | 1 | |
| 48 | PIXOFFSET_XY | Dodaj przesunięcie pikseli w <x> i <y> | 2 | |
| 64 | RESOLVE_SPRITE | Rozpoznawanie sprite'a za pomocą metody spritetype() o określonej wartości | 1 | |
| 128 | RESOLVE_RCSPRITE | Rozpoznawanie recolor sprite za pomocą spritetype() o określonej wartości | 1 | |
Potrzebne rejestry są ustawiane przez funkcję registers(), również jako listę cytatów. Kolejność rejestrów musi być taka sama jak w przypadku podanych flag (patrz przykłady). W przypadku flag nieużywanych nie określono rejestru. Ponieważ przesunięcia dla <x> i <y> mogą być włączone tylko razem, potrzebne są dwa rejestry. Rejestr dla SKIP używa wartości "1" do narysowania sprite i "0" do pominięcia go. Flaga CUSTOM_RCSPRITE nie używa żadnego rejestru.
Dwie ostatnie flagi (RESOLVE_SPRITE, RESOLVE_RCSPRITE) są ważne tylko dla stacji. W przypadku stacji łańcuch sterowania jest rozwiązywany wiele razy, a sprite'y mogą być częścią różnych bloków sprites (sprites naziemne (0), sprite'y budynku (1), niestandardowe sprite'y fundamentowe (2)) już bez użycia formatu zaawansowanego układu sprite'ów.
W przeciwieństwie do pierwszych 6 flag, oba parametry flagi stacji w rejestrach funkcyjnych () nie są rejestrami, ale reprezentują wartość z zakresu 0 .. 7, do którego dostęp uzyskuje funkcja spritetype() podczas przetwarzania łańcucha sterowania i rozpoznawania odpowiednich sprites.
Pamiętaj, że niektóre wartości mogą być już używane, np. "2" do rozwiązywania niestandardowych sprites fundamentowych. Nawet jeśli sprite nie pochodzi z bloku spriteblock, ale z oryginalnego sprite TTD, wartość nadal określa, który łańcuch kontroli definiuje wartości odniesienia dla funkcji registers().
Aby uzyskać więcej informacji, zobacz przykład 4 poniżej.
W TTD "normalne" kafle stacji (mogą istnieć egzotyczne kafle składające się tylko z sprite naziemnego lub dodatkowego sprite z pojedynczej platformy) są zwykle składane z trzech sprites: podstawy toru (ground sprite), sprite "background" i "pierwszego planu". Te sprites są ułożone tak, aby zbudować kafel stacji w taki sposób, że pociągi biegną po tle, a sprites naziemne, podczas gdy sprite pierwszego planu pokrywa wszystko. Zobacz zdjęcie poniżej.
W przypadku dodatkowego dachu stacji lub wiaduktu, te sprites zostaną dodane jako ostatnie lub mogą zostać zintegrowane z sprite na pierwszym planie.
Ponadto kafle stacji zawsze muszą być zdefiniowane dwukrotnie (nawet dla ikon menu budynku), tj. w kierunku x i y.
layout(_ROOFS,
tile(
ground(1012) // track x
regular(1, xyz(0,0,0),dxdydz(16,5,8))
regular(3, xyz(0,11,0),dxdydz(16,5,8))
)
tile(
ground(1011) // track y
regular(2, xyz(0,0,0),dxdydz(5,16,8))
regular(4, xyz(11,0,0),dxdydz(5,16,8))
)
...
)
W m4nfo można uniknąć konieczności definiowania zarówno x-, jak i y-tile poprzez wymianę funkcji tile() z funkcją xtile(), która automatycznie wygeneruje kafle dla kierunku y, w przypadku, gdy kafle są lustrzanym odbiciem siebie nawzajem, pod względem graficznym.
Oznacza to, że w powyższym przykładzie należy podać tylko pierwszy kafel , a za pomocą xtile() automatycznie zostanie dodany drugi kafel ze sprite'em #1011 i normalnymi sprite'ami #2 i #4, wraz z odpowiednią zamianą ich współrzędnych.
layout(_GLASS,
// modern glass 'tinted green'
tile(
ground(1012)
compcol(502, xyz(0,0,0),dxdydz(16,5,11))
glass(538, xyoff(0,0), GREEN)
compcol(504, xyz(0,11,0),dxdydz(16,5,11))
glass(540, xyoff(0,0), GREEN)
)
tile(
ground(1011)
compcol(503, xyz(0,0,0),dxdydz(5,16,11))
glass(539, xyoff(0,0), GREEN)
compcol(505, xyz(11,0,0),dxdydz(5,16,11))
glass(541, xyoff(0,0), GREEN)
)
...
)
Przykład 2 pokazuje układ kafli platformy "nowoczesnego szkła" z NewStations. Składa się z pięciu sprites: sprite ziemnego, dwóch sprites platformowych rysowanych w "kolorze firmy", każdy z przezroczystym sprite "szklanym", które są zdefiniowane jako "sprites potomne", tj. sprites dzielące swoje pole ograniczające z poprzednimi sprites za pomocą obwiedni (sprites platformowe).
Detale, które mają być przedstawione w jednym z 8 dostępnych kolorów firmowych, muszą być narysowane specjalnym kolorem, spójrz na palety TTD.
Jednak obszary reprezentujące efekt przezroczystego szkła mogą być narysowane w dowolnym kolorze (w tym przykładzie czerwonym). W tym przykładzie pokazano również, jak użyć "efektu szkła niestandardowego" (przyciemniane zielone szkło).
Wymaga to skonfigurowania niestandardowej tabeli kolorów, aby uzyskać pożądany efekt.
Przykład 3 pokazuje, jak używać wielu sprite'ów ziemi dla kafla. Jest to przydatne, jeśli chcesz użyć zwykłego sprite z szyny/trawy/betonu, ale nadal musisz dodać do niego funkcje bez użycia nowej obwiedni. W tym celu używana jest składnia sprites współużytkujących poprzednią obwiednię, ale przed zdefiniowaniem pierwszej definicji obwiedni.
Przykład definiuje dwa typy punktów trasy, pierwszy składa się wyłącznie z sprites naziemnych, a drugi z dodaną sprite budynku.
layout(_WAYP2,
// w/o building
tile(
ground(1012) // track
regular(0, xyoff(0,0)) // overlay
)
tile(
ground(1011) // track
regular(1, xyoff(0,0)) // overlay
)
// w building
tile(
ground(1012) // track
regular(0, xyoff(0,0)) // overlay
regular(2, xyz(0,0,0),dxdydz(16,5,10)) // building
)
tile(
ground(1011) // track
regular(1, xyoff(0,0)) // overlay
regular(3, xyz(0,0,0),dxdydz(5,16,10)) // building
)
)
Zauważ, że <xpixeloffset> i <ypixeloffset> w OpenTTD odnoszą się do zwykłego miejsca podłoży, ale są ignorowane w TTDPatch i ustawione na zero. Tak więc, w przypadku opracowywania nowego GRF, który musi być kompatybilny z obydwoma programami, należy zawsze zachować <xpixeloffset> i <ypixeloffset> zero, aby uzyskać ten sam efekt w obu.
Zauważ jednak, że ze względu na złą specyfikację w zwykłym nfo, obie implementacje nie uwzględniają ustawienia GROUNDSPRITES w flagach funkcji właściwości (), stąd te "wielokrotne sprite'y gruntowe" muszą być zawsze częścią zestawu sprite'ów budowlanych i nie mogą być częścią innego zestawu sprite'ów dla sprite'ów gruntowych. W związku z tym nie można sprawdzić wielu sprite'ów gruntu za pomocą funkcji spritetype().
W przeciwieństwie do niestandardowych fundamentów domów, płytek przemysłowych i obiektów, fundamenty dla stacji nie wymagają specjalnej obsługi wewnątrz definicji układu płytek.
Zamiast tego potrzebne sprite'y są definiowane w specjalnym sprriteblock i dostępne wewnątrz łańcucha graficznego za pomocą funkcji spritetype(). Należy pamiętać, że musi to ustawić flagę NOFOUNDATION w property function flags().
Przykład 4 pokazuje, jak skorzystać z "zaawansowanego układu sprites" w przypadku powtarzających się układów stacji. Dobrym przykładem może być układ stacji z koniecznością powtarzania się, tylko dla różnych sprites ładunku, co można przedstawić poprzez ponowne zabarwienie przykładowego sprite'a ładunku. Zaawansowany układ sprite'ów dla stacji daje możliwość po prostu włączenia recolor sprite'ów do ich własnego bloku sprites i łatwego dostępu do nich za pomocą funkcji układu.
asl_on()layout(ADVTEST, tile( ground(1012) recolour(0, xyz(8,8,0), dxdydz(8,8,8), 0, aslflags({OFFSET_RCSPRITE, CUSTOM_RCSPRITE, RESOLVE_RCSPRITE}), registers({11,4})) ) tile( ... ) )
// building sprites spriteblock( set( sprite(advtest.pcx 10 10 09 22 32 -14 -16) ) )
def(0) spriteset(little(0))
// recolour sprites - orange and blue spriteblock( set( colourtable(DOSMAP, 62 .. 67, C0 .. C5, ) colourtable(DOSMAP, 62 .. 67, 92 .. 97, ) ) )
def(1) spriteset(little(0))
def(2) spritetype( ref(1) if(4) // recolour sprites ref(0) else // building sprites )
def(3) setregisters(11,1,ref(2)) // 2nd recolour entry: blue
def(4) callback( cbr(0) if(CB_LAYOUT) ref(3) else // graphics )
makestation(ADVTEST, default(ref(4)) )
Należy pamiętać, że rejestry używane w zaawansowanym układzie kształtów muszą być ustawione wewnątrz łańcucha grafiki, a nie w łańcuchu wywołania zwrotnego. Odbywa się to w def(3), gdzie funkcja setregisters() ustawia rejestr '11' na wartość '1', tj. drugi wpis recolor sprrite. W def(2) łańcuch grafiki jest podzielony na łańcuch dla sprites budynku, def(0), i dodatkowy łańcuch dla sprites rekolorowych, def(1).
W układzie sprite jest definiowany do ponownego kolorowania za pomocą funkcji recolour(), przy czym pierwszy parametr ustawia sprite budynku, a 4. parametr ustawia sprite recolor, oba w tym przypadku "0". Parametr 5 określa flagi OFFSET_RCSPRITE, CUSTOM_RCSPRITE i RESOLVE_RCSPRITE, a parametr 6 określa rejestr, który ma być użyty do zdefiniowania przesunięcia sprite recolor oraz łańcuch grafiki do rozpoznawania sprite'ów recolor (4).
Funkcja ta umożliwia skopiowanie definicji układu kafli. Pierwszy argument to identyfikator stacji, dla którego zdefiniowano układ kafli, pozostałe argumenty to identyfikatory stacji, do których należy skopiować układ kafli. Te identyfikatory muszą być zakresem kolejnych identyfikatorów stacji.
Tak samo jak powyżej, ale ta funkcja umożliwia skopiowanie niestandardowej definicji układu kafla TTD. Pierwszy argument to identyfikator stacji, dla którego zdefiniowano niestandardowy układ kafli TTD, pozostałe argumenty to identyfikatory stacji, do których należy skopiować niestandardowy układ kafli. Tak jak poprzednio, identyfikatory te muszą być zakresem następujących po sobie identyfikatorów stacji.
Ta funkcja może być używana do modyfikowania dużych układów w odniesieniu do ponownego kolorowania. Odnosi się do górnych 2 bajtów numeru sprite, który zawiera jego translację recolor, patrz przykłady. W ten sposób można zastosować różne niestandardowe zmiany koloryzacji, w zależności od dostarczonego parametru. Ponadto możliwe byłoby przekształcenie sprite używającego koloru firmowego w sprite, który zostanie ponownie pokolorowany przez niestandardowe ponowne kolorowanie lub odwrotnie.
Pierwszy parametr musi być parametrem grf definiującym liczbę sprites recolor, która ma być użyta, z liczbą płytek do przetworzenia podaną przez parametr 2 i liczbą sprites budynków na kafel podaną przez parametr 3. Funkcja patchlayout() musi bezpośrednio poprzedzać skojarzoną z nią funkcję layout().
define(_COLOUR,4)setparameter(_COLOUR, 0x314) // TTD recolour sprite ... skipif(1, getowngrfparameter(0), BITSET, _COLOUR) patchlayout(_COLOUR, 90, 1)
layout(LOW_BLOCK, // 0 // F4 03 00 00 00 00 00 10 10 18 45 84 <00 00> 80 tile( ground(1012) compcol(24, xyz(0,0,0), dxdydz(16,16,24)) ) ... // 89 // F3 03 00 00 00 00 00 10 10 18 51 84 <00 00> 80 tile( ground(1011) compcol(36, xyz(0,0,0), dxdydz(16,16,24)) ) )
Spowoduje to ustawienie numeru sprite recolor z parametru 4 dla 90 płytek tego układu.
define(_COLOUR,4)setparameter(_COLOUR, 0x314) // TTD recolour sprite ... skipif(1, getowngrfparameter(0), BITSET, _COLOUR) patchlayout(_COLOUR, 2, 2)
layout(OPASS_LOW, // F4 03 00 00 00 00 00 05 05 08 2D 84 <00 00> // 00 00 00 10 10 18 2E 84 <00 00> 80 // F3 03 00 00 00 00 00 05 05 08 2F 84 <00 00> // 00 00 00 10 10 18 30 84 <00 00> 80 tile( ground(1012) compcol(0, xyz(0,0,0), dxdydz(5,5,8)) compcol(1, xyz(0,0,0), dxdydz(16,16,24)) ) tile( ground(1011) compcol(2, xyz(0,0,0), dxdydz(5,5,8)) compcol(3, xyz(0,0,0), dxdydz(16,16,24)) ) )
Spowoduje to ustawienie numeru sprite recolor z parametru 4 dla 2 płytek tego układu z 2 sprites budynku każda.
Zauważ, że nie jest możliwe przekolorowanie ani sprites naziemnych, ani sprites "potomnych" (tj. tych, które dzielą obwiednię z poprzedzającym ją sprite z własną obwiednią). Zobacz opis funkcji regular(), compcol() i recolour().
Funkcje te służą do oceny zmiennych wewnętrznych gry i udostępniania ich funkcji aktywacji stacji. Typowa aplikacja wykorzystuje wiele tych funkcji połączonych ze sobą w "łańcuch", łącząc sprite'y graficzne stacji z jej funkcją aktywacji. Zobacz tutaj przykład.
Ta funkcja zwraca rzeczywistą wartość licznika animacji bieżącego kafla, aby zdecydować, która klatka ma być wyświetlana. Wartość zwracana mieści się w przedziale od zera do liczby klatek animacji określonej we właściwości anim_info()) definicji stacji.
Jeśli podany jest dodatkowy parametr współrzędnych, zwracana jest rzeczywista wartość licznika animacji danego kafla. Należy pamiętać, że współrzędne muszą być podane przez funkcję pomocniczą pos(<x>, <y>,). W przypadku REGISTER jako pierwszego parametru, współrzędna nie jest wyraźnie podana, ale przyjmuje się jako wynik poprzedniego obliczenia.
Ta funkcja zwraca bieżący wyzwalacz animacji podczas wywołania zwrotnego CB_ACONTROL.
def(8) anim_trigger( animcontrol(0, SND_HORN) if(BUILT) // start animation on construction ref(6) if(NEWCARGO) // probably start of animation when cargo arrives animcontrol(A_NOP) else // do nothing )def(9)callback( ref(8) if(CB_ACONTROL) // animation control ref(7) if(CB_AFRAME) // animation frames ref(1) else // graphics )
Ta funkcja sprawdza występowanie wywołania zwrotnego, a jeśli tak, zwraca typ wywołania zwrotnego. Zobacz przykład powyżej.
Ta funkcja zwraca 4-bitową wartość o historii danego typu ładunku, który został zaakceptowany na stacji w przeszłości:
| Bit | Wartość | Opis |
| N/a | 0 | Ładunek nigdy nie był przyjmowany na tej stacji |
| 0 | 1 | Ładunek był kiedykolwiek przyjmowany na tej stacji |
| 1 | 2 | ładunek został przyjęty w zeszłym miesiącu |
| 2 | 4 | ładunek został przyjęty w tym miesiącu |
| 3 | 8 | ładunek został przyjęty od ostatniego okresowego przetwarzania (co 250 tyknięć) |
Ta funkcja zwraca typ ładunku dla wyzwalaczy animacji NEWCARGO lub NOCARGO w ustawieniu.
Jeśli newGRF zainstalował tabelę przeliczenia ładunku, typ ładunku będzie indeksem do tej tabeli lub "255" (0xFF), jeśli ładunek nie jest uwzględniony w tabeli. Jeśli nie ma tabeli przeliczenia ładunku, typ ładunku będzie po prostu rodzajem ładunku zależnym od klimatu.
Ta funkcja zwraca liczbę miesięcy, w których wyłączne prawa transportowe, które zostały zakupione w okolicy, będą nadal obowiązywać. Jeśli jest różny od zera, stacja nie otrzyma żadnego ładunku.
Sygnalizacja oparta na trasie (PBS) to funkcja, która umożliwia wielu pociągom współdzielenie bloku sygnałowego, o ile ich trasy nie kolidują. To znacznie poprawia wejścia i wyjścia ze stacji, a także skrzyżowań.
Gdy pociąg zbliża się do skrzyżowania opartego na trasie, zarezerwuje przez nie trasę. Jeśli pożądana trasa innego pociągu przecina trasę tego pociągu, czeka on na sygnał, aby zarezerwować trasę przed wjazdem na skrzyżowanie.
Ta funkcja zwraca następującą wartość:
| Wartość | Etykieta | Opis | |
| 7 | 111 | PBSRESERVED | Utwór zarezerwowany |
| 4 | 100 | PBSUNRESERVED | Utwór bez rezerwacji |
| 2 | 010 | PBSNONE | brak PBS |
Bity są zdefiniowane w ten sposób, aby umożliwić łatwy powrót do przypadków innych niż PBS. Jeśli potrzebujesz grafiki do pokazania stanu "bez rezerwacji" w przypadkach innych niż PBS, użyj bitu 0, ale jeśli potrzebujesz stanu "zarezerwowany" w przypadkach innych niż PBS, użyj bitu 1. Aby jawnie sprawdzić, czy Usługa książek telefonicznych jest aktywna, użyj bitu 2.
Wszystkie inne bity są zarezerwowane i nie wolno ich używać.
W tej chwili włączanie / wyłączanie PBS odnosi się do ustawienia przełącznika, w przyszłej wersji alfa będzie faktycznie odnosić się do tego, czy przełącznik jest włączony, a bieżący blok faktycznie używa PBS.
Ten zestaw funkcji zwraca informacje o bieżącym kafelku, platformie, na której się znajduje i jak daleko na platformie. Współrzędne są zdefiniowane tak, jak pokazano na poniższym rysunku:
- Funkcja plt_axis() zwraca kierunek bieżącego kafla platformy ("0" dla kafla w kierunku x lub "1" dla kierunku y
- plt_edges() sprawdza położenie bieżącego kafla wewnątrz stacji w odniesieniu do krawędzi stacji, patrz poniżej.
- plt_even_length() zwraca wartość "0" przy parzystej długości platformy
- plt_even_num() zwraca wartość "0" na parzystych numerach platform
-
Funkcja plt_even_numrev()
zwraca wartość "0" na parzystych numerach peronów, zaczynając od najbardziej wysuniętej na południe krawędzi stacji - plt_even_pos() zwraca wartość "0" na parzystej pozycji na platformie
- Funkcja plt_even_posrev() zwraca wartość "0" w pozycji parzystej na peronie, zaczynając od najbardziej wysuniętej na południe krawędzi stacji
- plt_index() zwraca indeks (pozycja na peronie, numer peronu) do stacji, licząc od północnego narożnika (patrz lewy obrazek). Aby uzyskać dostęp do zwracanej wartości, należy użyć funkcji pomocniczej nibble(x,y)
- Funkcja plt_indexrev() zwraca wartość indeksu zliczanego od południowego rogu (patrz prawy obrazek)
- Funkcja plt_length() zwraca długość peronu (rozpoczyna liczenie od północy — patrz lewy obrazek)
- Funkcja plt_midnum() zwraca liczbę aktualnie wylosowanych platform, zaczynając od środkowej
- Funkcja plt_midpos() zwraca pozycję wzdłuż tej platformy, zaczynając od środka
- Funkcja plt_num() zwraca aktualnie wylosowaną liczbę platform (patrz lewy obrazek)
- Funkcja plt_numrev() zwraca liczbę aktualnie wylosowanych peronów, zaczynając od najbardziej wysuniętej na południe krawędzi stacji (patrz prawy rysunek)
- Funkcja plt_pos() zwraca pozycję wzdłuż tej platformy (patrz lewy obrazek)
- Funkcja plt_posrev() zwraca pozycję wzdłuż tego peronu, zaczynając od najbardziej wysuniętej na południe krawędzi stacji (patrz prawy rysunek)
- Funkcja plt_size() zwraca rozmiar (numer peronu i długość peronu) całej stacji lub sekcji
- plt_tiletype() zwraca typ kafla TTD bieżącego kafla platformy
- Funkcja plt_total() zwraca łączną liczbę platform
W zależności od rodzaju stacji, powyższe funkcje uwzględniają różne sekcje danej stacji. W przypadku stacji regularnych oceniana jest cała stacja; a dla stacji nieregularnych liczona jest cała długość i wszystkie przyległe perony.
Termin "liczenie" odnosi się tutaj do rozpoczęcia od danego kafla i liczenia płytek we wszystkich czterech kierunkach. Dwa kierunki wyrównane z kierunkiem stacji będą długością stacji, a pozostałe dwa kierunki podają liczbę peronów, patrz rysunek. Dla wszystkich powyższych funkcji liczenie zatrzymuje się na krawędzi stacji, tj. pierwszym kafelku niestacji.
Jak pokazano na powyższym rysunku, funkcje liczą się albo od najbardziej wysuniętej na północ krawędzi stacji, albo od jej najbardziej wysuniętej na południe krawędzi (plt_numrev(), plt_posrev()). Dla funkcji plt_midpos() i plt_midnum() ich format zwracany to pozycje liczone od środka, tj. środkowy kafel ma "numer platformy" = 0 i "pozycja wzdłuż platformy" = 0. Dla parzystych długości i liczby peronów środkowa kafel znajduje się w pozycji długość/2 lub liczba peronów/2, np. dla długości = 6, jest to kafel 3 (tj. czwarta kafel ). Liczenie preferuje dodatkową liczbę ujemną dla liczby parzystej (ponieważ dostępnych jest 8 liczb ujemnych, ale tylko 7 dodatnich):
| Hrabia | Liczby |
| 1 | 0 |
| 2 | -1 0 |
| 3 | -1 0 1 |
| 4 | -2 -1 0 1 |
| 5 | -2 -1 0 1 2 |
| 6 | -3 -2 -1 0 1 2 |
Dostęp do liczb ujemnych uzyskuje się za pomocą funkcji aux signed() w funkcji if(). Zobacz przykład.
Aby odróżnić liczbę peronów od pozycji na peronach na całej stacji, lub tylko o odcinku kafli stacji budowanych w połączeniu z bieżącym kaflem, m4nfo używa funkcji nawiasu self(). Zobacz przykład poniżej.
Niektóre z powyższych funkcji umożliwiają użycie funkcji shiftmask(). Ponieważ liczba i długość peronów stacji jest ograniczona do 15, parametr przesunięcia jest ograniczony do zakresu 0 .. 3, a parametr mask do zakresu 1 .. 15 (0x0F).
// single or multi tile? def(6) plt_total( ref(24) if(1) // single ref(5) else // not single )// position at platform def(7) plt_pos( ref(6) if(0) // edge back ref(3) else // edge front or middle )
// index of station tiles def(8) plt_index( self( cbr(2) if(nibble(0,0)) // x=0, y=0 cbr(4) if(nibble(0,1)) cbr(6) if(nibble(0,2)) cbr(8) if(nibble(1,0)) cbr(10) if(nibble(1,1)) cbr(12) else ) )
def(9) plt_midpos( self( ref(0x76) if(signed(-2)) ref(0xB0) if(signed(-1)) ref(0xB1) if(0) ref(0x7A) if(1) ref(0x79) else ) )
plt_edges() sprawdza położenie bieżącego kafla wewnątrz stacji w odniesieniu do krawędzi stacji. Funkcja zwraca nibble z bitami ustawionymi dla każdej krawędzi stacji skojarzonej z bieżącym kaflem. Zliczanie bitów odbywa się zgodnie z ruchem wskazówek zegara, zaczynając od północno-wschodniej krawędzi, patrz rysunek:
def(2) plt_edges( cbr(0) if(0) cbr(2) if(1) cbr(4) if(2) cbr(6) if(3) cbr(8) if(4) cbr(10) if(5) cbr(12) if(6) cbr(14) if(7) cbr(16) if(8) cbr(18) if(9) cbr(20) if(10) cbr(22) if(11) cbr(24) if(12) cbr(26) if(13) cbr(28) if(14) cbr(30) else )
Ta funkcja zwraca typ(y) pojazdów, które odwiedziły tę stację w przeszłości, POCIĄG, AUTOBUS, CIĘŻARÓWKA, SAMOLOT, STATEK lub dowolna kombinacja:
def(5) servicedbytype( ref(4) if(BUS + TRUCK) // service by rvs ref(3) else )
Ta funkcja zwraca informacje o bieżącym typie sprite, tj. czy jest to sprite gruntu (GROUNDSPRITE), niestandardowy sprite fundamentu (FOUNDATION) czy sprite budynku (BUILDING). Aby to zadziałało, odpowiednie flagi muszą być ustawione w funkcji właściwości flags() stacji.
// ground sprite, foundation or building? def(8) spritetype( ref(__groundsprites) if(GROUNDSPRITE) // ground sprite overlays ref(__foundations) if(FOUNDATION) // custom foundations ref(__buildingsprites) else // building sprites )def(9) callback( ref(7) if(CB_LAYOUT) ref(8) else )
Podczas korzystania z funkcji Advanced Sprite Layer oprogramowania OpenTTD dozwolony zakres wartości wynosi 0. 7.
Ta funkcja zwraca wiek stacji w latach od 1920 roku. Wynik jest zwracany jako WORD:
def(14) stationage( ref(2) if(<40) ref(4) if(41 .. 59) ref(6) if(60 .. 79) ref(10) else )
test_pos(<blok>), test_posrev(<blok>), test_num(<blok>), test_numrev(<blok>), test_length(<blok>), test_total(<blok>), test_axis(<blok>), test_position(<blok>), test_size(<blok>), test_tiletype([<maska-przesunięcia>,] <blok>)
Funkcje te zwracają informacje o poszczególnych budowanych sekcjach stacji podczas wywołania zwrotnego CB_TILETYPE. Ten sam format co funkcje plt_* powyżej, ale ponieważ funkcje te dotyczą tylko sekcji stacji, która nie została jeszcze zbudowana, nie byłoby potrzebne wywołanie self() dla "indywidualnie budowanych sekcji".
- test_pos/posrev() zwraca położenie kafli stacji do zbudowania, albo z kierunku NE na SW, albo odwrotnie
- Funkcja test_num/liczba.rev() zwraca numer peronu kafli stacji do zbudowania, z kierunku NW na SE lub odwrotnie
- Funkcja test_length() zwraca długość peronów, które mają zostać zbudowane.
- Funkcja test_total() zwraca łączną liczbę platform do zbudowania
- Funkcja test_axis() zwraca kierunek kafli platformy do zbudowania ("0" dla kierunku x lub "1" dla kierunku y
- test_position() ocenia położenie kafla, która ma zostać zbudowana (numer platformy i pozycja na platformie)
- Funkcja test_size() zwraca rozmiar (numer platformy i długość peronu) sekcji przeznaczonej do budowy
- test_tiletype([<shiftmask>]) zwraca typ kafla do zbudowania
Funkcje test_position() i test_size() wymagają funkcji pomocniczej nibble() w celu wyodrębnienia pojedynczych wartości zwracanych.
definestation( ... nontrack(TTD_ROOFBOTH) // TTD tile types 4/5 and 6/7 )...
def(3) test_position( cbr(4) if(nibble(0,0)) // make tile x=0/y=0 non-track cbfail() else )
// menu def(13) callback( cbr(18) if(CB_LAYOUT) ref(3) if(CB_TILETYPE) ref(ALL_ICON) else )
Funkcje te umożliwiają dostęp do informacji o peronie podczas wywołania zwrotnego w CB_SLOPE, tj. przed zbudowaniem kafla stacji. Wszystkie funkcje liczą numery peronów i długości od najbardziej wysuniętego na północ rogu stacji, jak pokazano tutaj.
- test_pltlength() całkowita długość budowanej stacji
- test_pltnum() aktualny numer platformy
- test_pltpos() przesunięcie bieżącego kafla na platformie
- test_plttotal() całkowita liczba budowanych peronów
Tak jak powyżej, ale ta funkcja ocenia nachylenie kafla, która ma zostać zbudowana, w połączeniu z wywołaniem zwrotnym "kontroli nachylenia terenu" (CB_SLOPE). Zwrócone wartości nachylenia są takie same jak w tinfo_slope().
def(45) test_slope( ref(44) if(NORTH+WEST, NORTH+EAST) // in x: back + front ref(44) if(SOUTH+WEST, SOUTH+EAST) // in y: back + front DISALLOW else )
Ta funkcja zwraca wartość "32", jeśli kafel podany przez <współrzędne> jest kaflem płaskim/pełnym wody, w przeciwnym razie wartość nachylenia dla tego kafla jest zwracana w dolnych 5 bitach.
Parametr współrzędnych określa przesunięcie względem bieżącego kafla. Oba skubnięcia są uważane za podpisane. Przesunięcia ujemne przesuwają się odpowiednio na północ/zachód, dodatnie na południe/wschód. Parametr współrzędnych musi być określony przez funkcję pomocniczą pos(<x>, <y>,).
W przypadku REGISTER jako pierwszego parametru, współrzędne nie są jawnie podawane, ale brane jako wynik poprzedniego obliczenia, patrz calculate(). Oba wymagania wstępne dotyczą również funkcji tinfo_lclass(), tinfo_slope(), tinfo_statid(), tinfo_terrain(), tinfo_water() i tinfo_waterclass().
Ta funkcja zwraca identyfikator grf kafla stacji podany przez <współrzędne> lub "0", jeśli stacja kafla jest stacją domyślną, lub "0xFFFFFFFF", jeśli wybrany kafel nie jest kaflem stacji.
Należy zauważyć, że wynik należy sprawdzić za pomocą funkcji pomocniczej label() w funkcji if(). Zobacz przykład.
Ta funkcja zwraca wysokość najniższego rogu kafla na danej współrzędnej. Jeśli parametr współrzędnych zostanie pominięty, zostanie przyjęty kafel curent.
Ta funkcja zwraca klasę poziomą kafla na podanej współrzędnej (s.a.):
| Wartość | Etykieta | Opis |
| 0 | LC_TERRAIN | goła ziemia, trawa, skały, pola |
| 1 | LC_RAIL | tor kolejowy, z sygnalizacją i bez sygnalizacji, ogrodzenia |
| 2 | LC_ROAD | drogi, przejazdy kolejowe, zajezdnie |
| 3 | LC_HOUSE | budynki miejskie |
| 4 | LC_TREES | drzewa zależne od klimatu |
| 5 | LC_STATIONTILE | dworzec kolejowy, lotnisko, dworzec samochodowy i autobusowy, dok dla statków |
| 6 | LC_WATER | woda, wybrzeże, brzeg rzeki, magazyn statków |
| 7 | LC_VOID | Niewidoczne obramowanie u dolnych krawędzi mapy |
| 8 | LC_INDUSTRYTILE | Typy płytek branżowych |
| 9 | LC_TUNNELBRIDGE | tunel kolejowy lub drogowy, most |
| 10 | LC_OBJECT | nadajnik, latarnia morska, posąg, teren należący do firmy, siedziba główna |
Ta funkcja zwraca informacje o nachyleniu wypełnionym bajtami dla kafla danej stacji. Podana informacja jest w odniesieniu do najniższego rogu kafla, tj. ZACHÓD oznacza, że zachodni narożnik znajduje się powyżej najniższego rogu itp.
Ten rysunek ilustruje, jaki rodzaj nachylenia należy do których podniesionych narożników:
Równie dobrze możesz sprawdzić tak zwane "strome zbocza" (tj. narożnik przeciwny do najniższego jest o dwie jednostki wyższy), używając wartości STEEP wraz z dowolnymi trzema innymi narożnikami, ale pamiętaj, że stacje nie mogą być umieszczone na stromym zboczu.
Dodatkowy parametr <shift-mask> może zostać zastosowany w celu dalszego udoskonalenia wyniku funkcji. Aby to zadziałało, pierwszy parametr funkcji shiftmask() (parametr <shift>) musi być ustawiony na zero (0), tj. w ogóle nie ma przesunięcia. Parametr <mask> powinien być ustawiony na rozsądną wartość, w zależności od celu, jaki ma zostać osiągnięty za pomocą maskowania wyników.
def(11) tinfo_slope(pos(0,0), shiftmask(0, NORTH+WEST+SOUTH+EAST), cbr(10) if(0) // flat: ticket machine left cbr(12) if(NORTH+WEST, NORTH+WEST+EAST, NORTH+WEST+SOUTH) // ticket machine left cbr(10) if(SOUTH+EAST, SOUTH+EAST+WEST, SOUTH+EAST+NORTH) // fence left cbr(40) else // fence left and right )
W tym przykładzie zbocza do sprawdzenia są ograniczone do dowolnej kombinacji PÓŁNOC, ZACHÓD, POŁUDNIE i WSCHÓD, tj. STROME zbocza zostaną automatycznie wykluczone z gałęzi "inne".
Ta funkcja zwraca identyfikator stacji na danej współrzędnej kafla w stosunku do bieżącego kafla stacji w jej dolnym Bajtie. Ponadto zwraca dodatkowe informacje w swoim wysokim Byte (s.a.):
| Bit | Wartość | Znaczenie | |
| 0 .. 1 | 0x100 / 0x200 | _THISGRF / _OTHERGRF | Członkostwo w kaflach (0: oryginalny TTD, 1: zdefiniowany w bieżącym newGRF, 2: zdefiniowany w obcym newGRF) |
| 2 | 0x400 | _THISSTAT | Kafel należy do bieżącej stacji, jeśli jest ustawiony bit |
| 3 | 0x800 | _PROSTOPADŁY | Kafel jest równoległy (bit clear) lub prostopadły (bit set) do bieżącego |
| 4 .. 5 | 0x1000 / 0x2000 / 0x3000 | _TILETYPE2 / _TILETYPE4 / _TILETYPE6 | Informacje o peronie typu TTD (0: platforma gładka; 1: platforma z budynkiem; 2: platforma z dachem, lewa strona; 3: platforma z dachem, prawa strona) |
| 6 .. 7 | Zarezerwowane, nie używaj | ||
Należy użyć pomocniczej funkcji shiftmask(), aby uzyskać dostęp do potrzebnych bitów. Np. sprawdzając ID kafla, należy zawsze sprawdzić, czy został on zdefiniowany w bieżącym newGRF, stąd trzeba by sprawdzić nie tylko sam identyfikator, ale także wartość _THISGRF + ID. Jeśli chcesz sprawdzić zagraniczny nowy GRF, powinieneś użyć _OTHERGRF + ID.
Jeśli kafel w ogóle nie jest kaflem stacji, zwracana wartość będzie 0xFFFF, tj. wszystkie bity ustawione.
Należy pamiętać, że pierwszy parametr tej funkcji musi być określony przez funkcję pomocniczą pos(<x>, <y>)
define(ROOFS,0x0E)def(1) tinfo_statid(pos(0,-1), shiftmask(0,_THISGRF+ROOFS), cbr(1) if(_THISGRF+ROOFS) // station-ID is 0x0E cbr(2) if(0xFFFF) // not station cbr(0) else // other station-ID )
Czasami konieczne jest również sprawdzenie "typu kafla" kafla stacji (ponieważ identyfikatory mogą być takie same). Można to również zrobić:
define(_THISGRF_TT, 0x3100) // mask "tiletype" and "defined in this GRF"def(17) tinfo_statid(pos(1,0), shiftmask(0,_THISGRF_TT+0xFF), cbr(2) if(0x2100+PTRACK_OPASS) // tiletype for overpass is "4" (2) cbr(6) if(0x3100+PTRACK_OPASS) // tiletype for overpass is "6" (3) cbfail() else )
Ta funkcja zwraca typ terenu dla bieżącego kafla stacji (s.a.). Zwracane wartości to NORMAL, DESERT, RAINFOREST i SNOW (na lub powyżej linii śniegu).
Jeśli podany jest dodatkowy parametr współrzędnych, zwracany jest typ terenu danego kafla. Należy pamiętać, że współrzędne muszą być podane przez funkcję pomocniczą pos(<x>, <y>,)
Ta funkcja zwraca informacje kodowane bitowo, czy tory kolejowe są kontynuowane na ośmiu kaflach sąsiadujących z kaflem stacji.
| Bit | Wartość | Ustaw, jeśli szyna biegnie dalej w kierunku: |
| 0 | 0x01 | +Długość |
| 1 | 0x02 | -Długość |
| 2 | 0x04 | +Platformy |
| 3 | 0x08 | -Platformy |
| 4 | 0x10 | +Długość, +Platformy |
| 5 | 0x20 | -Długość, +Platformy |
| 6 | 0x40 | +Długość, -Platformy |
| 7 | 0x80 | -Długość, -Platformy |
Na poniższej ilustracji pokazano, które bity reprezentują kafel dla dwóch możliwych orientacji stacji:
Bity od 0 do 3 są ustawiane, jeśli na danym kafelku znajduje się ścieżka i ma ona połączenie z kaflem stacji. Dla bitów 2, 3 stacja oczywiście nie ma połączenia z tymi kaflami, ale nie ma to znaczenia dla tej zmiennej. Bity od 4 do 7 sprawdzają połączenia z sąsiednim kaflem platformy, tj. bity 4 i 5 lub 6 i 7 wskazują połączenie z tego kafla z kaflem 2 lub 3.
Dodatkowy parametr <shift-mask> może zostać zastosowany w celu dalszego udoskonalenia bitów wynikowych funkcji. Aby to zadziałało, pierwszy parametr funkcji shiftmask() (parametr <shift>) musi być ustawiony na zero (0), tj. w ogóle nie ma przesunięcia. Parametr <mask> powinien być ustawiony na rozsądną wartość, w zależności od celu, jaki ma zostać osiągnięty za pomocą maskowania bitów.
def(24) tinfo_trackconnect( ref(21) if(1) // top ref(22) if(2) // bottom ref(25) if(4,8) // sideways - only on (false) slope ref(23) else // double buffer )
Ta funkcja zwraca bitowo zakodowaną informację, czy na kafelku znajdują się tory szynowe, i pomija to, czy tor jest podłączony do stacji, czy nie całkowicie. Wyniki kodowane bitowo są obsługiwane w taki sam sposób, jak w przypadku tinfo_trackconnect().
Ta funkcja zwraca typ toru kolejowego, gdzie 0 = szyna regularna, 1 = szyna zelektryfikowana, 2 = szyna jednoszynowa, 3 = maglev i każda dodatkowa szyna zgodnie z numerem szczeliny.
Ta funkcja zwraca wartość "1", jeśli kafel podany przez <współrzędna> jest kaflem pełnej wody lub wybrzeża, w przeciwnym razie zwracana jest wartość "0". Ponownie, parametr współrzędnych musi być określony przez funkcję pomocniczą pos(<x>, <y>,)
def(47) tinfo_water(pos(-1,0), // back ref(2) if(1) // is water ref(46) else )
Ta funkcja zwraca "klasę wody" kafla podaną przez <współrzędne>. Wartości klasy wody są następujące:
| Wartość | Znaczenie | |
| 0 | WC_LAND | Nieokreślony / ląd |
| 1 | WC_SEA | Morze, ocean |
| 2 | WC_CANAL | Kanał |
| 3 | WC_RIVER | Rzeka |
W przeciwieństwie do klasy krajobrazu "woda", "klasa wodna" nie zmienia się, gdy dachówka wodna jest zabudowana, np. przez obiekt przedstawiający statek. Użycie tinfo_waterclass() może się w tym przypadku przydać.
Ponownie, parametr współrzędnych musi być określony przez funkcję pomocniczą pos(<x>, <y>)
Ta funkcja zwraca rok budowy stacji. Rokiem bazowym jest 1920.
def(4) yearbuilt( cbr(2) if(<1940) cbr(4) if(1940 .. 1959) cbr(6) if(1960 .. 1979) cbr(8) if(1980 .. 1999) cbr(10) else )
W przeciwieństwie do powyższych funkcji wydajnościowych, których wyniki są zawsze określane przez przewidywalną decyzję, można również użyć funkcji losowych, aby wybrać jeden z kilku zestawów graficznych lub wyników wywołania zwrotnego.
| Spust | Znaczenie |
| ZBUDOWANY | po skonstruowaniu (bez wyzwalacza) |
| NEWCARGO | nowy ładunek czeka |
| NOCARGO | Koniec z ładunkiem |
| PRZYBYĆ | przyjeżdża pociąg (rozpoczyna rozładunek/załadunek) |
| OPUSZCZAĆ | odjazdy pociągów (rozładunek i załadunek) |
| ŁADOWANIA | pociąg ładuje lub rozładowuje ładunek |
| Rezerwa PBSP | peron rezerw pociągów (przy użyciu PBS) |
| WSZYSTKIE WYZWALACZE | Ponownie randomizuj tylko wtedy, gdy wystąpiły wszystkie wyzwalacze |
Należy również zauważyć, że żaden z powyższych wyzwalaczy nie zostanie faktycznie wywołany, chyba że funkcja właściwości setcargotriggers() ma co najmniej jeden zestaw wyzwalaczy. NEWCARGO zostanie uruchomiony dla dowolnego typu ładunku ustawionego w setcargotriggers(), ale NOCARGO zostanie uruchomiony tylko wtedy, gdy wszystkie te typy ładunków nie będą już oczekiwać. Wyzwalacze ARRIVE, LEAVE i PBSRESERVE są uruchamiane bez względu na rodzaj ładunku przewożonego przez pociąg, o ile ustawiono co najmniej jeden wyzwalacz.
Wyzwalacze ARRIVE, LEAVE, LOADING i PBSRESERVE wpływają tylko na peron, na którym występują, a także na losowe bity stacji, ale nie na inne perony.
Ponieważ już zaistniałe wyzwalacze są przechowywane tylko raz na stację (bez rozróżniania płytek lub typów ładunków), dodawanie ALLTRIGGERS do losowych wyzwalaczy nie ma większego sensu dla stacji.
Stacje mają 16 losowych bitów (bity 0 .. 15) wspólnych dla całej stacji i 4 losowe bity (bity 16 .. 19) na kafel stacji. TTDPatch faktycznie implementuje tylko 8 współdzielonych losowych bitów, tj. bity 8 .. 15 to zawsze zero.
Ustawienie randombit określa pierwszy bit do ponownego losowania, a także opiera losową grafikę. Tylko te bity, które faktycznie zostaną uruchomione, zostaną ponownie losowe. Umożliwi to posiadanie niezależnych zestawów bitów dla niezależnych wyzwalaczy. Całkowita liczba użytych bitów jest 2-logarytmem liczby użytych odwołań, np. dla 16 odwołań używane są 4 bity.
Aby uzyskać losowość opartą na kaflach, należy użyć randombit = 16 i liczby odwołań nie większej niż 16 (ponieważ tylko 4 losowe bity są dostępne na kafel).
Liczba zbiorów do wyboru musi wynosić 2, tj. 2, 4, 8, 16 itd.
def(13) random(ARRIVE,16,ref(1),ref(2),ref(2),ref(3))def(13) random({ARRIVE, LEAVE},16,ref(1),ref(2),ref(2),ref(3))
Należy pamiętać, że ponowna randomizacja, zarówno w TTDPatch, jak i w OpenTTD, odbywa się tylko w łańcuchu graficznym, ale nie w przypadku wywołań zwrotnych. Oznacza to, że jeśli losowa akcja jest używana wewnątrz łańcucha wywołań zwrotnych i powinna ponownie randomizować bity wyzwalające, należy również dodać "fikcyjną" losową akcję do łańcucha graficznego, wyłącznie w celu ponownego losowania bitów.
Dlatego też, aby używać funkcji losowych w łańcuchach wywołań zwrotnych, m4nfo dostarcza dwie specjalne funkcje:
Ta funkcja jest używana w łańcuchach wywołań zwrotnych, podobnie jak normalna funkcja random() jest używana w łańcuchu graficznym, z tym wyjątkiem, że nigdy nie losowo losuje określonych wyzwalaczy. Zamiast tego odbywa się to za pomocą funkcji
który musi być umieszczony w łańcuchu graficznym. Określając różne etykiety, można równolegle stosować różne randomizacje. Zobacz przykład.
// top platform def(6) randomcb(_TOP, ARRIVE, 16, ref(1), ref(2), ref(2), ref(3))// bottom platform def(7) randomcb(_BOTTOM, {ARRIVE, NOCARGO}, 16, ref(1), ref(2))
def(8) plt_num( self( ref(6) if(0) // top platform ref(7) else // bottom ) )
[...]
def(9) rerandom(_TOP, ref(0) // graphics )
def(10) rerandom(_BOTTOM, ref(0) // graphics )
def(11) plt_num( self( ref(9) if(0) // top platform ref(10) else // bottom ) )
// check callbacks def(12) callback( ref(8) if(CB_LAYOUT) // callback ref(11) else // graphics/re-randomisation )
Funkcje pomocnicze są używane w kontekście niektórych z powyższych funkcji. W związku z tym nie otrzymują def() ani ref() niczego innego. Są one używane głównie do oceny specjalnych parametrów funkcji wydajności.
Ta funkcja dostosowuje wynik funkcji wydajności do bardziej użytecznego zakresu. Pierwszy parametr definiuje wartość, którą należy dodać do wyniku, a drugi parametr określa modulo (pozostałą część dzielenia przez) na sumie wyniku funkcji wydajności i pierwszego parametru.
def(10) plt_midnum(addmodulo(1,2),
self(
ref(5) if(1)
ref(6) else
)
)
Ta funkcja służy do sprawdzania zwróconej wartości współrzędnych wypełnionych bajtami w zwykłej postaci (<x>, <y>). Zakres parametrów wynosi [-8 ... +7], zarówno dla przesunięć x, jak i y. Przykład można znaleźć tutaj.
Ta funkcja dostarcza podane współrzędne w postaci wypełnionej bajtami do innej funkcji. Zakres parametrów wynosi [-8 ... +7], zarówno dla współrzędnych x, jak i y. Należy pamiętać, że współrzędna (0,0) odnosi się do bieżącego kafla. Przykład znajduje się poniżej.
Ta funkcja definiuje poziom hierarchii. Zamiast całej stacji, tylko sekcja kafli stacji budowanych w powiązaniu z bieżącym kaflem jest adresowana przez odpowiednią funkcję wydajności, patrz tutaj dla przykładów.
Ta funkcja dostosowuje wynik funkcji wydajności do bardziej użytecznego zakresu. Pierwszy parametr definiuje wartość do przesunięcia w prawo wyniku, a drugi parametr podaje wartość, z którą AND wynik po przesunięciu.
Należy pamiętać, że parametr <maska> może mieć rozmiar WORD w danym kontekście.
// (middle) def(8) tinfo_slope(pos(0,0),shiftmask(0,NORTH+SOUTH), ref(5) if(NORTH) ref(6) if(SOUTH) ref(7) else )