EN

PL

nfo

Układ Sprite Action2

Cecha	Wersja
Domy	0.6 2.5
Kafle Przemysłu	0.6 2.5
Obiekty	1.1 2.6
Kafle Lotniska	1.1

Ta Action2 definiuje spriteayout dla kafla. Dostępne są trzy formaty:

• Podstawowy format dla jednego 'sprite' naziemnego i jednego 'sprite' budowlanego.
• Rozszerzony format łączenia wielu 'sprites'.
• Zaawansowany format z przesunięciami rejestru (register offsets)

Bazowy format dla kafli z pojedynczym sprite budynku

 <Sprite-number> * <Length> 02 07/09/0F/11 <set-id> 00 <groundsprite> <buildingsprite> <xoffset> <yoffset> <xextent> <yextent> <zextent>

Na powyższym xofs, yofs, xextent, yextent i zextent definiują obwiednię 3D 'sprite' budynku, nie uwzględniając 'sprite' ziemi. Przesunięcie Z wynosi zawsze zero dla budynków (TTD nie obsługuje budynków pływających). Uwaga: pary xofs/xextent i yofs/yextent, które umieszczają obwiednię poza kaflem, nie są zalecane.

Rozszerzony format wykorzystujący wiele połączonych sprites

0.6 2.5 Ponieważ TTDPatch 2.0.1 alpha 55 vcs 3, domy, kafle przemysłowe (i obiektowe) obsługują również rozszerzoną składnię, która wygląda następująco:

<Sprite-number> * <Length> 02 07/09/0F/11 <set-id> <num-sprites> <groundsprite> [<buildingsprite> (<xoffset> <yoffset> <zoffset> <xextent> <yextent> <zextent>) | (<xpixeloffset> <ypixeloffset> 80)] ...

Element	Rozmiar	Opis
<Sprite-number>	dec	Kolejny numer 'sprite'
<length>	dec	Całkowita liczba bajtów użytych w tej akcji
02	B	Definiuje akcję 02
07/09/0F/11	B	cecha 7=budynki miejskie, 9=kafle przemysłu, 0F=obiekty lub 11=kafle lotnisk
<set-id>	B	ID tej definicji
<num-sprites>	B	Liczba kolejnych sprite'ów budujących (nie liczy się gruntu). Dozwolony zakres: od 1 do 63 (0x01 do 0x3F). 1.2  Dodanie 0x40 powoduje, że układ staje się zaawansowanym układem Spritelayout z modyfikatorami rejestru ( patrz poniżej ).
<groundsprite>	D	Duszek naziemny dla budynku (patrz format poniżej)
<buildingsprite>	D	Sprite do narysowania. W przeciwieństwie do podstawowego formatu, zero nie jest tutaj dozwolone.
-- dla 'sprites' definiujących nowe obwiednię --
<xofs>	B	'Przesunięcie'-x od północnego rogu kafla (jako 'signed' bajt)
<yofs>	B	Przesunięcie-y od północnego rogu kafla (jako 'signed' bajt)
<zofs>	B	Z-offset od ziemi
<xextent>	B	rozmiar sprite'a w kierunku x
<yextent>	B	rozmiar sprite'a w kierunku y
<zextent>	B	rozmiar sprite'a w kierunku z
-- dla 'sprites' dzielących obwiednię z poprzednim 'sprite' --
<xpixeloffset>	B	x 'odsunięcie' od lewego górnego rogu poprzedniego 'sprite'
<ypixeloffset>	B	y odsunięty od lewego górnego rogu poprzedniego 'sprite'
80	B	dosłowny bajt 80-godzinny do odróżnienia od definicji nowego pola ograniczającego

Note: ograniczenia dla 'sprites' dzielących ich obwiednię są takie same, jak wyjaśniono dla station tiles.

0.7 Od OpenTTD r18959 możesz narysować wiele 'sprite' ziemi na kafla, co jest przydatne, jeśli chcesz użyć zwykłego 'kafla gruntowego' z trawy/wody/betonu (grass/water/concrete) , ale nadal musisz dodać do niej funkcje bez korzystania z nowej ramki ograniczającej. Aby to zrobić, użyj składni ikonek współużytkujących poprzednią ramkę ograniczającą, ale użyj jej przed definicją pierwszej ramki ograniczającej. xpixeloffset i ypixeloffset odnoszą się do zwykłego miejsca 'kafli naziemnych'.

2.6 Ta sama funkcja jest również częściowo obsługiwana w TTDPatch, ponieważ TTDPatch 2.6 r2313: TTDPatch ignoruje pola xpixeloffset i ypixeloffset i zawsze używa (0,0) dla offsetu. Jeśli tworzysz GRF, który musi być zgodny zarówno z OpenTTD, jak i TTDPatch, zawsze powinieneś zachować zero xpixeloffset i ypixeloffset zero, aby uzyskać ten sam efekt w obu grach.

Advanced sprite layout using register offsets

<Sprite-number> * <Length> 02 07/09/0F/11 <set-id> <0x40 + num-sprites>
     <groundsprite> <flags> [<register/value>]...
     [ <buildingsprite> <flags>
         ( <xoffset> <yoffset> <zoffset> <xextent> <yextent> <zextent>
         | <xpixeloffset> <ypixeloffset> 80)
       [<register/value>]...
     ]...

1.2  Spritelayout definiuje stałe zestawy ikon do użycia z Akcji 1. Rejestry mogą być używane do indywidualnego wyboru 'sprites' z zestawów ikon, zamiast zawsze korzystania z etapu budowy. Rejestry są oceniane, a ich wartości są zapisywane podczas oceny układu ikonki Action 2. Inne wywołania zwrotne wywoływane podczas rysowania (jak CB 1E) nie mają wpływu na używane wartości rejestrów.

Opisy elementów

Numer-sprite'a

To tylko numer, na którym jesteś.

Długość

Policz liczbę bajtów w tej akcji.

Set-id

'Set-ID', który chcesz zdefiniować dla tego zestawu. Możesz wybrać dowolną wartość z przedziału od 00 do FF, i możesz użyć ich ponownie w pliku grf w późniejszym momencie (jeśli jest równy istniejącemu set-ID, istniejący jest zastępowany i używany jest nowy).

Definicja sprite'a dla sprite'ów naziemnych i budowlanych

Pola 'sprite' ziemi i budynku mają następujący format:

Bity	Wersja	'Content'
0-13	0.6 2.5	Numer sprite'a, dokładne znaczenie określone przez bit 31
14-15	0.6 2.5	0: rysuj sprite normalnie, 1: rysuj sprite'a w trybie przezroczystym, 2: zmieniaj kolor sprite
16-29	0.6 2.5	Numer specjalnego sprite'a translacji koloru, patrz poniżej
30	0.6 2.5	Jeśli jest ustawiona, sprite jest rysowany normalnie, nawet w trybie przezroczystych budynków (tylko dla budowania 'sprites')
31	0.6 2.5	Typ sprite'a, patrz poniżej

0.6 2.5 Od wersji TTDPatch 2.0.1 alpha 57 wartość dna może być zerowa, jeśli 'sprite' nie jest potrzebny (jest to przydatne, jeśli trzeba narysować niestandardowe fundamenty, patrz example). Naziemne 'sprite' są zawsze rysowane normalnie, więc bit 30 jest dla nich ignorowany. Bit 30 może mieć inne znaczenie dla naziemnych 'sprites' w późniejszej wersji TTDPatch, więc na razie pozostaw to zero. Nie dotyczy to dodatkowych usług naziemnych korzystających z "<xpixeloffset> <ypixeloffset> 80"-'składnia' (patrz wyżej); dla tych bitów 30 ma to samo znaczenie, co dla budowania 'sprites' .

Specjalny numer sprite w translacji koloru

Jest to używane tylko wtedy, gdy bity 14 lub 15 są niezerowe. Bity 16–29 muszą być liczbą zwykłego 'sprite' TTD zawierającego tabelę translacji kolorów (dostępne tabele tłumaczeń znajdują się poniżej). W trybie przezroczystym potrzebna jest odpowiednia tabela translacji, np. z 'sprite' TTD o numerze 802 (s.b.). Zobacz RecolorSprites, aby uzyskać więcej informacji na temat używania przezroczystych i zmieniających kolor 'sprites' .

W przypadku domów, jeśli nie podano sprite'a zmieniającego kolor, ale zmiana koloru jest włączona w bitach 14-15, istnieją dwie możliwości:

• Jeśli masz włączone callback 1E , jest ono wywoływane w celu określenia odwzorowania kolorów.
• Jeśli callback 1E jest wyłączone lub nie działa, jeden z kolorów określonych we właściwości 17 zostanie wybrany losowo.

Zobacz RecolorSprites, aby uzyskać listę dostępnych tłumaczeń kolorów.

W przypadku kafli branżowych, jeśli to pole jest równe zero, ale zmiana koloru jest włączona w bitach 14 lub 15, automatycznie zostanie zastosowany kolor branży zawierającej.

Zmielony 'sprite' powinien mieć dokładnie ten sam rozmiar i kształt co płaski kafel TTD. Ogólnie rzecz biorąc, nie powinien zawierać niczego, co ma wymiar Z, ponieważ zakryje go dowolny niemielony 'sprite' .

Przydatne wartości dla 'sprite' naziemnych:

Pamiętaj, że wszystkie 'sprites' naziemne stają się widoczne w trybie "przezroczystych budynków" , dlatego powinieneś rysować również części, które wydają się być ukryte.

Typ sprite'a

Jeśli bit 31 jest wyraźny, dolne 14 bitów zawiera regularną liczbę 'sprites' TTD.

Jeśli ustawiony jest bit 31, dolne 14 bitów zawiera pewną liczbę zestawów 'sprites' w najnowszej akcji 1, a o używanym 'sprite' decyduje się zgodnie z bieżącym stanem konstrukcyjnym i liczbą 'sprites' w zestawie:

• jeśli jest tylko jeden 'sprite' , jest używany zawsze
• jeśli są dwa 'sprites' , pierwszy jest używany podczas budowy (etapy 0-2), a drugi jest używany do ukończonego budynku (etap 3)
• jeśli są trzy 'sprites' , pierwszy zostanie użyty na początku budowy (etap 0), drugi będzie użyty podczas reszty budowy (etapy 1 i 2), a trzeci zostanie wykorzystany do ukończenia budowy (etap 3)
• jeśli są cztery lub więcej 'sprites' , pierwsze cztery zostaną wykorzystane do czterech etapów budowy. 'Sprites' po pierwszych czterech są zawsze ignorowane.

Flagi w zaawansowanych układach sprite'ów

<flags> jest zbiorem rozmiaru słowa o tych znaczeniach:

1. ↑ ^{1.0  1.1}  Ważne tylko dla stacji: Łańcuch Action 1/2/3 jest rozwiązywany wielokrotnie, 'sprites' mogą być częścią różnych Action 1: Związana z tym wartość w <register/value> jest wartością surową (nie rejestrem!), którą należy wpisać do zmiennej 10 podczas rozwiązywania 'sprites'.
   

tylko dozwolone wartości obecnie 0-7

wartość '2' jest stosowana przy rozwiązywaniu fundowania niestandardowego, (a więc nie należy z tym kolidować))

nawet jeśli sprite nie pochodzi z Action 1, wartość nadal określa, które łańcuchy Action2 definiują wartości dla rejestrów, do których się odwołują.

Rejestr dla "Dodaj offset do rekoloryzacji" jest określony przez działanie 1/2/3 łańcucha ze zmienną 10, jak określono dla 'spritu' odbarwionego.

Pozostałe rejestry są określone przez działanie 1/2/3 łańcucha ze zmienną 10, jak określono dla 'sprite'.

Jeżeli nie jest zdefiniowana zmienna 10 wartości, to właściwość stacji 13 bit 0 staje się skuteczna; tj. zmienna 10 jest ustawiona na 0 lub 1 w zależności od bitu i tego, czy 'rozwiązany' jest pierwszy 'spritenaziemny', czy też inny 'sprite'. Odnosi się to zarówno do 'groundsprite', jak i do palety 'groundsprite'.

Rejestr lub wartość w zaawansowanych układach sprite

Są to rejestry tymczasowego przechowywania, które można dodać do poszczególnych części. Wartości rejestru uważa się za podpisane. Kolejność rejestrów jest taka sama jak bitów w <flags>. Jeśli bit nie jest ustawiony, nie pojawiają się dla niego rejestry. Większość bitów wymaga jednego rejestru.

• <xoffset> i <yoffset> można włączyć tylko razem, używając dwóch rejestrów,
• rejestr "pomiń ramkę ograniczającą" - używa wartości 1, aby narysować 'sprite' , a 0, aby go pominąć,
• "recolorsprite z działania 1" - w ogóle nie używa rejestru,
• Wartości zmiennej 10 nie są ustawiane za pomocą rejestru, ale za pomocą stałej bajtowej.