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.

Typy submodeli

• Mesh - submodel składający się z trójkątów, posiadający teksturę.
• FreeSpotLight - Punkt świetlny kierunkowy.
• 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

Składnia różnych typów submodeli różni się, ale istnieje kilka wspólnych właściwości. Znacząca jest kolejność, w jakiej one występują.

Wspólne właściwości

Przed właściwościami specyficznymi dla określonego typu występują 4 stałe własności:

• Parent - nazwa obiektu nadrzędnego w hierarchii rodzic-dziecko.
• Type - typ submodelu.
• Name - nazwa submodelu, potrzebna dla ustalenia hierarchii.
• Anim - wartość logiczna true/false. Jeśli ustawiona jest na true, submodel można animować za pomocą eventów. Można też przypisać w tym miejscu jedną z predefiniowanych animacji automatycznych.

A po nich kolejne 3:

• MaxDistance - maksymalna odległość z jakiej widoczny jest obiekt [m]
• MinDistance - minimalna odległość z jakiej widoczny jest obiekt [m]
• Transform - macierz transformacji. Każdy wiersz, zawierający po 4 liczby powinien znaleźć się w osobnej linii. Uwaga! Macierz przy eksporcie/imporcie modelu do programów do modelowania jest transponowana!

Właściwości specyficzne dla typów

Mesh

• Ambient
• Diffuse
• Specular
• SelfIllum - wartość logiczna true/false lub liczba. Określa, czy submodel ma emitować światło. Dla liczby z przedziału 0-1 określa naświetlenie sceny, poniżej którego obiekt zaczyna emitować światło.
• Wire
• WireSize
• Opacity - przezroczystość obiektu, wartość liczbowa <0;100>
• Map - ścieżka do tekstury (bez jej rozszerzenia), relatywna względem głównego folderu symulatora.

Oprócz tego, na samym końcu definicji submodelu należy umieścić właściwość z wartością liczbową równą ilości wierzchołków w submodelu:

    NumVerts: suma_wierzchołków_wszystkich_trójkątów

A pod spodem definicje trójkątów. Ich ilość musi być równa NumVerts / 3, a definicje zaleca się oddzielić 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

• maska_wygładzania - ?
• x, y, z - współrzędne wierzchołka w przestrzeni
• u, v - współrzędnie wierzchołka w układzie UV (odpowiadają za układ tekstury)