Brückenkonfiguration

[h1]Brückenkonfiguration[/h1] Die Brückenkonfigurationen liegen im Ordner [tt]res/config/bridge[/tt]. Sie enthalten eine [tt]data()[/tt]-Funktion, die die folgenden Daten zurückgibt: [table] [tr] [td][b]Name[/b][/td] [td][b]Datentyp[/b][/td] [td][b]Beispielwert (iron.lua)[/b][/td] [td][b]Beschreibung[/b][/td] [/tr] [tr] [td]name[/td] [td]String[/td] [td]_("Iron bridge")[/td] [td]Der Name der Brücke, der als Tooltip im Brückenauswahlmenü gezeigt wird[/td] [/tr] [tr] [td]yearFrom[/td] [td]Integer[/td] [td]1910[/td] [td]Ab wann ist die Brücke verfügbar?[/td] [/tr] [tr] [td]yearTo[/td] [td]Integer[/td] [td]0[/td] [td]Bis wann ist die Brücke verfügbar?[/td] [/tr] [tr] [td]carriers[/td] [td]Liste aus "RAIL", "ROAD"[/td] [td]{ "RAIL" , "ROAD"}[/td] [td]Ist die Brücke als Straßen- und/oder Eisenbahnbrücke verfügbar?[/td] [/tr] [tr] [td]speedLimit[/td] [td]Double[/td] [td]180.0 / 3.6[/td] [td]Erlaubte Höchstgeschwindigkeit in m/s[/td] [/tr] [tr] [td]pillarLen[/td] [td]Integer[/td] [td]3[/td] [td](?) Länge eines Pfeilers in Brückenrichtung[/td] [/tr] [tr] [td]pillarMinDist[/td] [td]Double[/td] [td]18.0[/td] [td]minimaler Abstand zwischen 2 Pfeilern[/td] [/tr] [tr] [td]pillarMaxDist[/td] [td]Double[/td] [td]66.0[/td] [td]maximaler Abstand zwischen 2 Pfeilern[/td] [/tr] [tr] [td]pillarTargetDist[/td] [td]Double[/td] [td]36.0[/td] [td]optimaler Abstand zwischen 2 Pfeilern[/td] [/tr] [tr] [td]cost[/td] [td]Double[/td] [td]300.0[/td] [td]Kostenfaktor[/td] [/tr] [tr] [td]materialsToReplace[/td] [td]Liste (siehe unten)[/td] [td](siehe unten)[/td] [td]Tabelle zur Ersetzung von Texturen bei Straßen auf Brücken[/td] [/tr] [tr] [td]updateFn[/td] [td]Funktion (siehe unten)[/td] [td]bridgeutil.makeDefaultUpdateFn(config)[/td] [td]Funktion die zur Zusammensetzung der Brückenmodelle genutzt wird[/td] [/tr] [/table] [h1]materialsToReplace[/h1] Diese Tabelle wird genutzt, um bei Straßen Materialien auszustauschen, wenn sie auf Brücken gebaut werden. Möglich sind dabei alle Materialien, die auch bei Straßen angegeben werden: [list][*]streetPaving, streetBorder, streetLane, streetStripe, streetStripeMedian [*]streetTram, streetTramTrack, streetBus [*]crossingLane, crossingBus, crossingTram, crossingTramTrack, crossingCrosswalk, crossingStopline [*]sidewalkPaving, sidewalkLane, sidewalkBorderInner, sidewalkBorderOuter, sidewalkCurb, sidewalkWall [/list][size=12][b][h1]updateFn[/h1][/b][/size] Diese Funktion wird genutzt, um das Brückenmodell aus Einzelteilen zu konstruieren. In [tt]scripts/bridgeutil.lua[/tt] wird eine vorgefertigte Funktion angeboten, die auch von den Vanilla-Brücken genutzt wird. Diese bekommt eine config-Tabelle als Parameter übergeben. Die Inhalte dieser Tabelle werden im folgenden beschrieben: [h1]Pfeiler[/h1] Die Pfeiler bestehen aus drei Schichten, wovon die mittlere Schicht mehrfach wiederholt werden kann: [attach=141357,none,219][/attach] [b]pillarBase (lila)[/b] Dies ist eine Liste mit Modellen, die für den unteren Abschluss eines Pfeilers genutzt werden. Die Länge der Liste kann variieren, möglich sind: [table] [tr] [td]1 Modell[/td] [td][attach=141353,none,300][/attach][/td] [td]Dieses Modell wird mittig als Pfeiler gesetzt.[/td] [/tr] [tr] [td]2 Modelle[/td] [td][attach=141354,none,300][/attach][/td] [td]Das erste Modell wird für die Pfeilerränder genutzt (einmal entsprechend rotiert), das zweite Modell wird für die Mitte des Pfeiler solange nebeneinander gesetzt und leicht skaliert, bis es die erforderliche Breite ausfüllt.[/td] [/tr] [tr] [td]3 Modelle[/td] [td][attach=141356,none,300][/attach][/td] [td]Das erste Modell wird für den einen Pfeilerrand genutzt, das zweite Modell wird für die Mitte des Pfeiler solange nebeneinander gesetzt und leicht skaliert, bis es die erforderliche Breite ausfüllt und das dritte Modell wird für die andere Seite genutzt, dabei aber nicht rotiert.[/td] [/tr] [/table] [b]pillarRepeat (grün)[/b] Dies ist eine Liste mit Modellen, die für den höhenvariablen Teil des Pfeilers genutzt wird. Diese Modelle werden vertikal mehrfach aneinander gereiht und ggf. leicht skaliert, um auf die erforderliche Höhe zu kommen. Die Länge der Liste kann variieren, möglich sind die Kombinationen wie bei [b]pillarBase [/b]beschrieben. [b]pillarTop (gelb)[/b] Dies ist eine Liste mit Modellen, die für den oberen Abschluss des Pfeilers genutzt wird. Die Länge der Liste kann variieren, möglich sind die Kombinationen wie bei [b]pillarBase [/b]beschrieben. [h1]configurePillar[/h1] Wenn nicht die oben beschriebene Funktion zum Zusammensetzen der Pfeiler genutzt werden soll, sondern z.B. anhand der Höhe des Pfeilers ein anderer Pfeiler zusammengebaut werden, dann kann eine eigene Funktion dafür angegeben werden: [code=lua]configurePillar = function(modelData, params, i, height, width) [...] end,[/code] Diese hat folgende Parameter: [table] [tr] [td][b]Name[/b][/td] [td][b]Datentyp[/b][/td] [td][b]Beschreibung[/b][/td] [/tr] [tr] [td]modelData[/td] [td]komplexe Liste[/td] [td]Eine Liste mit Brückenelement-Modellen und ihren Eigenschaften. Weitere Informationen siehe unten[/td] [/tr] [tr] [td]params[/td] [td]komplexe Liste[/td] [td]Eine Liste mit den Parametern der gerade in Bau befindlichen Brückensektion (zumeist bis zu 3 Pfeiler lang). Weitere Informationen siehe unten[/td] [/tr] [tr] [td]i[/td] [td]Integer[/td] [td]Die Nummer des Pfeilers in der aktuell in Bau befindlichen Brückensektion[/td] [/tr] [tr] [td]height[/td] [td]Double[/td] [td]Die Höhe des zu bauenden Pfeilers in Metern[/td] [/tr] [tr] [td]width[/td] [td]Double[/td] [td]Die Breite des zu bauenden Pfeilers in Metern[/td] [/tr] [/table] [b]modelData[/b] Die standardmäßige configurePillar-Funktion übergibt eine Liste mit allen geladenen Brückenelement-Modellen (nicht nur die von dieser Brücke!). Als Schlüssel der Listeneinträge wird der Pfad zur mdl-Datei verwendet. Für jeden Eintrag wird die BoundingBox bereitgestellt: [code=lua]["bridge/iron/pillar_top_side.mdl"] = { ["min"] = { [1] = -1, [2] = -4.6595997810364, [3] = -3.5, } , ["max"] = { [1] = 1, [2] = 0, [3] = -2.0499999523163, } , } ,[/code] [b]params[/b] Zur Laufzeit wird beim Methodenaufruf eine Tabelle mit diversen Parametern mitgeliefert. Diese sind: [list][*][tt]pillarWidth[/tt]: Die Breite eines Pfeilers [*][tt]pillarHeights[/tt]: Eine Liste mit den Höhen der Pfeiler [*][tt]pillarLength[/tt]: Die Länge eines Pfeilers [*][tt]state.models[/tt]: Eine Liste mit allen geladenen Brückenmodellen (siehe oben) [*][tt]railingWidth[/tt]: Die Breite der Brücke [*][tt]railingIntervals[/tt]: Eine Liste mit den Brückenträgerabschnitten. Für jeden Abschnitt gibt es drei Informationen: [list][*][tt]hasPillar[/tt]: Eine Paar aus zwei Booleanwerten, die vermutlich sagen, ob am Anfang und Ende des Abschnitts ein Pfeiler platziert wird [*][tt]lanes[/tt]: ? [*][tt]length[/tt]: Die Länge des Abschnittsfwffw [/list][/list] [[h1]Brückenträger[/h1] Der Brückenträger besteht ebenfalls aus mehreren Reihen, die aneinandergesetzt werden: [attach=141363,none,402][/attach] [b]railingBegin[/b] Dies ist eine Liste mit Modellen, die für den Beginn eines Brückenträgersegments genutzt werden. Ein Brückensegment beginnt jeweils am Anfang einer Brücke und bei jedem Pfeiler. Es können entweder 5 oder 8 Modelle in der Liste enthalten sein. Leider ist bei einigen Elementen der Liste noch nicht ganz geklärt, welche Bedeutung sie haben. Wenn nur 5 Elemente enthalten sind, werden die Elemente 1-3 stellvertretend für 6-8 in rotierter Fassung verwendet: [table] [tr] [td]5 Modelle[/td] [td][attach=141360,none,761][/attach][/td] [td]Das erste Modell wird für die Außenseiten genutzt (einmal entsprechend rotiert), das vierte Modell wird für die Mitte der Zeile solange nebeneinander gesetzt und leicht skaliert, bis es die erforderliche Breite ausfüllt.[/td] [/tr] [tr] [td]8 Modelle[/td] [td][attach=141361,none,761][/attach][/td] [td]Das erste Modell wird für die eine Außenseite genutzt, das vierte Modell wird für die Mitte der Zeile solange nebeneinander gesetzt und leicht skaliert, bis es die erforderliche Breite ausfüllt und das sechste Modell wird für die andere Außenseite genutzt, dabei aber nicht rotiert.[/td] [/tr] [/table] [b]railingRepeat[/b] Dies ist eine Liste mit Modellen, die für die Mitte eines Brückenträgersegements genutzt werden. Diese Modelle werden horizontal mehrfach aneinander gereiht und ggf. leicht skaliert, um auf die erforderliche Höhe zu kommen. Die Länge der Liste kann variieren, möglich sind die Kombinationen wie bei [b]railingBegin [/b]beschrieben. [b]railingEnd[/b] Dies ist eine Liste mit Modellen, die für das Ende eines Brückenträgersegments genutzt werden. Die Länge der Liste kann variieren, möglich sind die Kombinationen wie bei [b]railingBegin [/b]beschrieben.