Klasa/BinLine

Klasa jest bazą dla innych klas, zawiera definicję 4 punktów (o trzech współrzędnych XYZ) oraz podstawowe operacje geometryczne na odcinkach (np. wspólne dla BinTrack oraz BinPath).

Klasy dziedziczące:

• BinTrack
• BinPath
• BinSection
• BinStitch
• BinArcInfo
• BinPos

Zawartość rekordu

Nagłówek rekordu — pierwsze 20 bajtów

Start	0x00	0x01	0x02	0x04	0x08	0x0C	0x10
Rozmiar [B]	1	1	2	4	4	4	4
Nagłówek — wersje od 13 do 17	Len	Flags	Type	Path	Id	Prev	Next
Nagłówek — od wersji 18	Len	Flags	Type	Id	Path	Prev	Next
Nagłówek trójkąta (wersja 18)	Len	Flags	Type	Id	Tri[0..2]

Pole Len zwykle ma wartość 1. Wyjątkiem są obecnie rozjazdy (w tym szablony) oraz słupy podwójne, które zawierają liczbę 2. W przyszłości mogą pojawić się też inne agregaty. Zasadniczo złączenie obiektów jako agregat służy do przemieszczania ich razem w sposób bardziej trwały niż np. przyklejenie (zwisu do bramki).

Pole Flags zawiera blokadę dla wartości Id (współrzędnej T w układzie THV). Pozostałe bity są używane do umieszczenia obiektów w grupach podczas różnych operacji.

Pole Type zawiera liczbę z zakresu 0x4000..0xBFFF (zakres 0x0000..0x3FFF zawiera obiekty innego typu, natomiast przeznaczenie zakresu 0xC000..0xFFFF nie zostało jeszcze określone). Zakres ten jest następnie dzielony na 8 głównych warstwy: tory (0x4000..0x4FFF), drogi (0x5000..0x5FFF), rzeki (0x6000..0x6FFF), linie pomocnicze (0x7000..0x7FFF), sieci elektryczne (0x8000..0x8FFF), sygnalizacja 0x9000..0x9FFF, obiekty z obrysem (0xA000..0xAFFF) oraz pojazdy (0xB000..0xBFFF). Każda z 8 głównych warstw dzieli się następnie na 16 warstw. Dolny bajt pola Type zawiera flagi blokad o znaczeniu zależnym od warstwy.

Pole Id zawiera kilometraż na niwelecie (współrzędną T w układzie THV, wyrażoną w [mm]). Istotny jest znak tej liczby: dodatni oznacza, że np. — przy patrzeniu w stronę rosnącego kilometrażu — obiekt sygnalizacji będzie widoczny od bardziej istotnej strony, a słup będzie stał po prawej stronie. Dla odcinków nieujemna liczba oznacza ułożenie zgodne ze wzrostem kilometrażu.

Pole Path może być puste (0) albo zawierać wskaźnik na obiekt nadrzędny.

Pola Prev oraz Next są używane do łańcuchowania obiektów.

Współrzędne czterech punktów — 60 bajtów zaraz za nagłówkiem

Start	0x14	0x44	0x48	0x4C
Rozmiar [B]	48	4	4	4
Linia prosta	P[0..3]	BaseItem	BaseDist	Length
Łuk	P[0..3]	BaseItem	Radius	Length
Poprzeczka	P[0..3]	BaseItem	A0	Angle
Obiekt punktowy	P[0..3]	BaseItem	BaseDist	Angle

Dla odcinków istotne są punkty końców P[0] i P[3], natomiast w P[1] i P[2] są punkty kontrolne (albo punkty pomocnicze poprzeczek). Dla obiektów punktowych głównym punktem wstawienia jest P[1].

Pole BaseItem wskazuje obiekt pomocniczy, z którym obiekt jest powiązany. Typ powiązania zależy od warstw, w których są obiekty.

Pole BaseDist zawiera pomocniczy parametr (np. odległość od linii kierunkowej dla odcinków prostych). Ewentualnie dla łuków wpisany jest tu promień Radius, a dla poprzeczek dodatkowe parametry w A0.H i A0.V.

Pole Length zawiera długość odcinka, ewentualnie pole Angle zawiera kąt obrotu obiektu. Kąt jest wyrażony czterobajtową liczbą typu float, ale w przyszłych wersjach pliku RSF planowana jest zmiana mapująca __int32 na kąt pełny (2π), co ma zwiększyć dokładność zapisu kąta.

Pozostałe 48 bajtów jest wykorzystane na inne parametry, zależnie od warstwy wskazanej w polu Type. Ostatnie 20 bajtów zwykle jest używane na nazwę obiektu, ewentualnie pierwsze 4 z ostatnich 20 zawierają wskaźnik do nazwy w osobnym rekordzie (o kodzie 0x2020).

---