Materiały - Pliki .mat: Różnice pomiędzy wersjami
(→Nowy sposób) |
(→Nowy sposób) |
||
| (Nie pokazano 4 pośrednich wersji utworzonych przez tego samego użytkownika) | |||
| Linia 363: | Linia 363: | ||
Symbole mogą występować w dowolnej kolejności i ilości. | Symbole mogą występować w dowolnej kolejności i ilości. | ||
| − | + | W zależności od kolejności występowania odwołań do tekstur w plikach, użycie cech może dać różne rezultaty. | |
| + | |||
| + | Rozpatrzmy następujący przykład: | ||
| + | Odwołanie 1: ''sciezka/tekstury:s'' | ||
| + | Odwołanie 2: ''sciezka/tekstury:t'' (będzie interpretowane jako ''sciezka/tekstury:s'') | ||
| + | Odwołanie 3: ''sciezka/tekstury:st'' (będzie interpretowane jako ''sciezka/tekstury:s'') | ||
| + | Odwołanie 4: ''sciezka/tekstury'' (będzie interpretowane jako ''sciezka/tekstury:s'') | ||
| + | |||
| + | Jak widać, każde kolejne odwołanie do tekstury automatycznie dziedziczy cechy z pierwszego znalezionego wywołania. Wyjątkiem od powyższej reguły jest następująca sytuacja: | ||
| + | Odwołanie 1: ''sciezka/tekstury'' | ||
| + | Odwołanie 2: ''sciezka/tekstury:s'' (będzie interpretowane jako ''sciezka/tekstury:s'') | ||
| + | Odwołanie 3: ''sciezka/tekstury:st'' (będzie interpretowane jako ''sciezka/tekstury:s'') | ||
| + | Odwołanie 4: ''sciezka/tekstury'' (będzie interpretowane jako ''sciezka/tekstury'') | ||
| + | |||
| + | W odróżnieniu od pierwszego przypadku, późniejsze odwołanie do tekstury bez cech nie spowoduje dziedziczenia, o ile pierwszym użytym odwołaniem będzie odwołanie bez cech. | ||
==== Stary sposób ==== | ==== Stary sposób ==== | ||
Aktualna wersja na dzień 20:18, 16 paź 2024
Plik .mat jest plikiem tekstowym z definicją materiału, czyli shadera oraz przypiętych do niego tekstur i parametrów. Posiada prostą składnię klucz: wartość oraz warunkowe bloki wybierane w zależności od ustawień symulacji.
Spis treści
Opis kluczy podstawowych
| Nazwa | Wartości | Opis | Uwagi | |
|---|---|---|---|---|
| shader | Ścieżka do pliku shadera (relatywna względem folderu shaders, nazwa bez przedrostka mat_ i rozszerzenia). | Ustawia shader używany do renderowania obiektu. | Parametr jest obowiązkowy, jeżeli jednak nie jest podany zostanie to ustawiony zostanie shader default_0, default_1, default_2 (w zależności od ilości podanych tekstur). Nie działa wtedy ustawianie tekstur poprzez alias. | |
| textureX | Ścieżka do tekstury lub zestaw ścieżek losowych. | Przypina podaną teksturę pod jednostkę wyrażoną numerem X, numerując od 1. | ||
| texture_X | Ścieżka do tekstury lub zestaw ścieżek losowych. | Przypina podaną teksturę pod alias X jednostki zdefiniowany przez shader | ||
| paramX | Od jednej do czterech wartości liczbowych. | Ustawia parametr X numerując od 1. | ||
| param_X | Od jednej do czterech wartości liczbowych. | Ustawia parametr pod alias X zdefiniowany przez shader | ||
| opacity | Wartość liczbowa 0-1 | Próg przezroczystości |
Wartości domyślne:
Zobacz też opis działania przezroczystości | |
| selfillum | Od jednej do czterech wartości liczbowych. | Nadpisuje wartość SelfIllum w submodelach używających tego materiału. | ||
| size | Dwie wartości liczbowe | Nadpisuje wartość rozmiaru tekstury [m] we wpisie node::track. | Wpisanie -1 spowoduje zignorowanie wybranego parametru. | |
| shadow_rank | Wartość liczbowa 1-3 | Określa "wagę/skomplikowanie" cieni rzucanych przez obiekt pokryty danym materiałem. | Cienie z wagą wyższą niż wartość zdefiniowana wpisem gfx.shadow.rank.cutoff w pliku eu07.ini będą pomijane przy rysowaniu. |
Materiał domyślny
Jeśli w podanej ścieżce nie istnieje plik .mat, ale istnieje tekstura o tej samej nazwie, to wówczas tekstura ta interpretowana jest jak materiał o definicji:
shader: default_1 texture_diffuse: sciezka_do_tekstury
Dzięki temu nie jest konieczne tworzenie plików .mat dla prostych materiałów (używających tylko jednej tekstury).
Dostępne shadery
Mapy obsługiwane przez dane shadery. Przy braku część tekstur można ustawić jednorodnie dla materiału przy pomocy parametru.
| Nazwa | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
|---|---|---|---|---|---|---|---|---|---|
| default | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
| default_detail | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
| default_specgloss | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
| normalmap | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
| normalmap_specgloss | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
| detail_normalmap | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
| detail_normalmap_specgloss | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
| parallax | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
| parallax_specgloss | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
| detail_parallax | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
| detail_parallax_specgloss | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
| reflmap | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
| reflmap_specgloss | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
| shadowlessnormalmap | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
| shadowlessnormalmap_specgloss | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
| sunlessnormalmap | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
| sunlessnormalmap_specgloss | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
| water | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
| water_specgloss | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
| colored | Diffuse | Alfa | Normal | Depth | Reflection | Specular | Glossiness | Metalic | Detail |
Opis kluczy warunkowych
Bloki warunkowe zawierają definicje własności materiału, które mają być aktywne w warunkach zależnych od ustawień symulacji. Wartościami dla tych kluczy jest dowolna ilość kluczy podstawowych i ich wartości, ograniczona za pomocą nawiasów klamrowych. Przykład użycia:
// Pamiętaj o odstępach między klamrami a resztą kodu! texture1: example/tex winter: { texture1: winter/tex }
Powyższy kod oznacza, że w przypadku ustawienia warunków zimowych w miejsce texture1 ma zostać wczytana tekstura winter/tex zamiast domyślnej example/tex.
Bloki warunkowe moga byc dodatkowo zagniezdzane, np. blok warunkow pogodowych moze wystapic wewnatrz bloku pory roku:
autumn: { rain: { texture1: autumn/rain // jesien + deszcz } texture1: autumn/tex // jesien } rain: { texture1: default/rain // deszcz } texture1: default/tex
W takiej sytuacji ostatecznie uzywana jest tekstura spelniajaca najlepiej podane warunki, w kolejnosci:
- tekstura dla danej pogody i pory roku - tekstura dla danej pogody - tekstura dla danej pory roku - tekstura podstawowa
Tekstury losowe
Oprócz indywidualnych nazw tekstur można podać równieź ich zestaw. W takiej sytuacji wybrana zostanie losowo jedna z podanych tekstur. Przykład:
texture1: [ tekstura_a tekstura_b tekstura_c ]
Cechy tekstury
Nowy sposób
Przy ścieżkach do tekstur po dwukropku mogą być podane opcjonalne cechy tekstury.
texture/path:<traits>
gdzie <traits> jest zbiorem symboli cech.
| Symbol cechy | Opis |
|---|---|
| s | Wyłącza zawijanie tekstury w poziomie |
| t | Wyłącza zawijanie tekstury w pionie |
| # | Wyostrzanie tekstury (działa tylko na starym rendererze) |
Symbole mogą występować w dowolnej kolejności i ilości.
W zależności od kolejności występowania odwołań do tekstur w plikach, użycie cech może dać różne rezultaty.
Rozpatrzmy następujący przykład:
Odwołanie 1: sciezka/tekstury:s Odwołanie 2: sciezka/tekstury:t (będzie interpretowane jako sciezka/tekstury:s) Odwołanie 3: sciezka/tekstury:st (będzie interpretowane jako sciezka/tekstury:s) Odwołanie 4: sciezka/tekstury (będzie interpretowane jako sciezka/tekstury:s)
Jak widać, każde kolejne odwołanie do tekstury automatycznie dziedziczy cechy z pierwszego znalezionego wywołania. Wyjątkiem od powyższej reguły jest następująca sytuacja:
Odwołanie 1: sciezka/tekstury Odwołanie 2: sciezka/tekstury:s (będzie interpretowane jako sciezka/tekstury:s) Odwołanie 3: sciezka/tekstury:st (będzie interpretowane jako sciezka/tekstury:s) Odwołanie 4: sciezka/tekstury (będzie interpretowane jako sciezka/tekstury)
W odróżnieniu od pierwszego przypadku, późniejsze odwołanie do tekstury bez cech nie spowoduje dziedziczenia, o ile pierwszym użytym odwołaniem będzie odwołanie bez cech.
Stary sposób
Przed wprowadzeniem nowego sposobu definiowania cech stosowano metodę polegającą na wpisaniu symbolu cechy bezpośrednio w nazwę pliku tekstury wg. wzoru:
<trait>nazwa_tekstury
gdzie <trait> jest jednym z symboli cechy:
| Symbol cechy | Opis |
|---|---|
| # | Wyostrzanie tekstury (działa tylko na starym rendererze) |
| @ | Włącza alfa blending dla tekstur terenu. Ta cecha znana jest także pod nazwą problend. |
Tekstury generowane
Zamiast ścieżek do tekstur można umieszczać wywołania skryptu Pythona który powinien wygenerować teksturę, na zasadach podobnych co skrypty wyswietlaczy w lokomotywach. Składnia wywołania wygląda następujaco:
make:sciezka/skrypt?parametr=wartosc¶metr=wartosc¶metr=wartosc // etc
Wpis taki spowoduje (jednorazowe) wywołanie skryptu skrypt.py zlokalizowanego w katalogu ścieżka. Przy uruchomieniu skrypt otrzyma dictionary ze zbiorem zdefiniowanych w wywołaniu par parametr-wartosc.
