CommonAPI Unterstützung einbauen/nachrüsten

[h1]CommonAPI in ein Mod einbauen/nachrüsten[h1]

1 Ist CommonAPI geladen?

Beispiel:

if (commonapi ~= nil) then
-- Wird nur ausgeführt wenn die CommonAPI vorhanden ist
end


-- In der Regel müsst Ihr Unterfunktionen auch testen:
if (commonapi ~= nil and commonapi.uiparameter ~= nil) then


end

2 Gleisauswahl

Die CommonAPI bietet euch die Möglichkeit an, alle vom Nutzer aktivierten Gleise abzufragen und auch in eurer Konstruktion anzuzeigen.

Die einfachste Möglichkeit solltet ihr eine Liste mit trackTypes und eure ui parameter dafür definiert haben, diese durch commonapi.uiparameter.modifyTrackCatenary modifizieren zu lassen.

commonapi.uiparameter.modifyTrackCatenary(params, {
selectionlist = config.trackTypes
})

Der Aufruf dieser Funktion verursacht:

• Interne Erstellung eines TrackCatenarySelector mit den optionalen Parametern (grün)
• Die Modifikation der config.trackTypes (orange)
• Änderung der params (rot)

Solltet Ihr eure Oberleitung oder Gleisauswahl nicht trackType und catenary nennen, so könnt Ihr in den optionalen Parametern diese mit key = "trackType", catenary_key = "catenary", ggf. anpassen.

[info=warning]Bitte beachtet:
Eine Liste, die via selectionlist übergeben wird muss eindeutig sein und darf nicht von einem anderen Parameter mit genutzt werden.
Solltet Ihr mehr als ein trackType (Beispiel Überholgleis) in eurer Konstruktion unterstützen, so muss auch eine Referenz zur eine neuen Liste von Gleistypen angeben werden[/info]

commonapi.uiparameter.modifyTrackCatenary(params, {
	key = "trackType2",
	catenary_key = "catenary2",
	selectionlist = config.trackTypes2
})

3 Weiterführende Informationen

Eine komplette API Dokumentation findet Ihr im doc Ordner in der CommonAPI.