Format T3D

Plik T3D jest formatem tekstowym, przechowującym informacje o modelach trójwymiarowych. Składa się z dowolnej ilości submodeli określonego typu. Można dołączyć do modelu inne modele za pomoca komendy include.

Typy submodeli

• Mesh - submodel składający się z trójkątów, może być pokryty materiałem.
• FreeSpotLight - Obiekt świecący kierunkowo.
• Stars - zbiór punktów świecących, z czego każdy z nich może mieć inną barwę.
• Point
• Text

Typy Point oraz Text występują w kodzie źródłowym, ale w praktyce nie są spotykane w modelach.

Składnia wpisu submodelu

Wspólne właściwości dla wszystkich typów

Wspólne właściwości dla wszystkich typów submodeli

Nazwa właściwości	Znaczenie	Typ wartości	Uwagi
Parent	Przypisuje submodel nadrzędny (rodzica).	Nazwa submodelu
Type	Definiuje typ submodelu.	Jedno ze słów kluczowych: Mesh, FreeSpotLight, Stars
Name	Unikalna nazwa submodelu	Tekst	Pewne nazwy są zarezerwowane i służą do definiowania dodatkowych funkcjonalności w submodelu. Zobacz listę nazw specjalnych.
Anim	Typ animacji submodelu.	Tekst	Zobacz listę dostępnych typów animacji.
Selfillum	Określa sposób emisji światła przez obiekt	Jedno ze słów kluczowych: true false lub liczba z zakresu <0;1.25>	false - brak emisji światła. true - emisja światła zawsze, niezależnie od poziomu oświetlenia scenerii liczba - określa poziom oświetlenia scenerii, poniżej którego submodel ma emitować światło
MaxDistance	Określa największą odległość, z jakiej submodel jest widoczny.	Liczba [m]	Aby obiekt był widoczny zawsze, niezależnie od odległości, należy podać wartość -1
MinDistance	Określa minimalną odległość, z jakiej submodel jest widoczny	Liczba [m]
Transform	Macierz transformacji submodelu	Liczby

Właściwości specyficzne dla typu Mesh

Nazwa właściwości	Znaczenie	Typ wartości	Uwagi
Ambient	Określa jasność submodelu.	3 liczby RGB z zakresu <0-255>
Diffuse	Określa kolor świecenia submodelu.	3 liczby RGB z zakresu <0-255>
Specular	Określa poziom błyszczenia submodelu.	3 liczby RGB z zakresu <0-255>
Wire	Określa, czy zamiast bryły należy rysować siatkę krawędzi	Jedno ze słów kluczowych: true false	Nie działa (?)
WireSize	Określa grubość krawędzi	Liczba [cm]
Opacity	Określa sposób renderowania przezroczystości submodelu	Liczba	0 - renderowanie w fazie przezroczystych 1 - renderowanie w fazie nieprzezroczystych
Map	Materiał submodelu.	Ścieżka do materiału (bez rozszerzenia)	TO-DO: Coś o ścieżce i replacableskinach
NumVerts	Suma wszystkich wierzchołków w definicjach trójkątów	Liczba

Pod definicją właściwości NumVerts znajdują się definicje trójkątów (o ile obiekt nie jest tzw. bananem). Ich ilość musi być równa NumVerts / 3. Definicje trójkątów oddzielone są od siebie pustą linią.

Wzór definicji trójkąta:

    maska_wygładzania
    x y z u v             
    x y z u v
    x y z u v

Nazwa właściwości	Znaczenie	Typ wartości	Uwagi
maska_wygładzania	Zapisana dziesiętnie maska bitowa określająca wygładzenie trójkąta.	Liczba	Jeśli w jednym punkcie spotykają się wierzchołki wielu trójkątów, to jeśli mają ustawione wspólne bity w masce, to wektor normalny zostanie wyliczony jako średnia, co da efekt zaokrąglenia w tym wierzchołku.
x, y, z	Współrzędne wierzchołka w przestrzeni	3 liczby [m]	Symulator korzysta z prawoskrętnego układu współrzędnych!
u, v	Współrzędnie wierzchołka w układzie UV	2 liczby

Między współrzędnymi XYZ i UV mogą znajdować się współrzędne IJK wektora normalnego. Maska wygładzania przyjmuje wtedy wartość -1:

    -1
    x y z i j k u v             
    x y z i j k u v
    x y z i j k u v

Właściwości specyficzne dla typu FreeSpotLight

Nazwa właściwości	Znaczenie	Typ wartości	Uwagi
Diffuse	Definiuje kolor świecenia submodelu	3 liczby RGB z zakresu <0-255>
NearAttenStart		Liczba
NearAttenEnd		Liczba
UseNearAtten		Jedno ze słów kluczowych: false true
FarAttenDecayType	Typ zaniku natężenia światła	Liczba	0 - brak zaniku 1, 2 - potęga 1/R?
FarDecayRadius		Liczba
FalloffAngle	Określa kąt wygaszenia światła.	Liczba [deg]
HotspotAngle	Określa kąt pełnej jasności światła.	Liczba [deg]

Właściwości specyficzne dla typu Stars

Nazwa właściwości	Znaczenie	Typ wartości	Uwagi
Diffuse	?	3 liczby RGB z zakresu <0-255>	Parametr nieznaczący w kontekście tego submodelu
NumVerts	Określa ilość punktów świetlnych zawartych w tym submodelu	Liczba

Pod definicją właściwości NumVerts muszą znaleźć się definicje grup punktów świetlnych. W jednej grupie mogą znaleźć się maksymalnie 3 punkty świetlne.

    1
    x y z kolor 0
    x y z kolor 0
    x y z kolor 0

Nazwa właściwości	Znaczenie	Typ wartości	Uwagi
1, 0	Tokeny ignorowane.	Liczby	Zwyczajowo zawsze podaje się 1 i 0.
x, y, z	Współrzędne punktu w przestrzeni	3 liczby [m]
kolor	Kolor świecenia punktu	Liczba	Zapisana dziesiętnie liczba szesnastkowa opisująca kolor świecenia BGR.

Point

Obsługa tego submodelu nie została zaimplementowana.

Text

Obsługa tego submodelu nie została zaimplementowana.

Dostępne typy animacji

Wartość	Znaczenie	Uwagi
false	Brak animacji.
true	Możliwość animowania za pomocą eventów
sky	Animacja nocnego nieba
wind	Kołysanie się obiektu pod wpływem wiatru.
billboard	Obracanie się obiektu w kierunku kamery.
digiclk	Animacja zegara cyfrowego
seconds	Sekundy płynnie (60s/360°, pełny obrót w minutę)
seconds_jump	Sekundy z przeskokiem co 6°
minutes	Minuty płynnie (1h/360°, pełny obrót w godzinę)
minutes_jump	Minuty z przeskokiem co 6°
hours	Godziny płynnie (12h/360°)
hours_jump	Godziny z przeskokiem co 30°
hours24	Godziny płynnie (24h/360°)
hours24_jump	Godziny z przeskokiem co 15°
ik	IK: zadający
ik11	IK: kierunkowany
ik21	IK: kierunkowany
ik22	IK: kierunkowany