System-Makros: Unterschied zwischen den Versionen

Aus OMSIWiki
Wechseln zu:Navigation, Suche
(Script-Texturen (gültig für Szenerie- und Fahrzeugscripts, nur OMSI 2))
Zeile 13: Zeile 13:
 
| align="left" |''Output-Stackwerte''
 
| align="left" |''Output-Stackwerte''
 
| align="left" |''Beschreibung''
 
| align="left" |''Beschreibung''
| align="left" |''Beispiel''
+
|-
 +
| align="left" |STNewTex
 +
| align="left" |Stack0: Textur-Index, entspricht [scripttexture]-Reihenfolge in model.cfg
 +
| align="left" |-
 +
| align="left" |Scripttextur initialisieren
 +
|-
 +
| align="left" |STLock
 +
| align="left" |Stack0: Textur-Index
 +
| align="left" |-
 +
| align="left" |Scripttextur "locken", d.h. Lese- und Schreibzugriff erlauben
 +
|-
 +
| align="left" |STUnlock
 +
| align="left" |Stack0: Textur-Index
 +
| align="left" |-
 +
| align="left" |Scripttextur "unlocken", d.h. Lese- und Schreibzugriff zurücknehmen und zum Rendern freigeben
 +
|-
 +
| align="left" |STFilter
 +
| align="left" |Stack0: Textur-Index
 +
| align="left" |-
 +
| align="left" |Mipmaps erzeugen, d.h. Untervarianten in kleineren Auflösungen. Dies passiert üblicherweise nach dem Unlock, keinesfalls jedoch zwischen Lock und Unlock. Geschieht es nicht, kommt es zu Darstellungsfehlern in größeren Entfernungen ("überscharf", flimmern)
 +
|-
 +
| align="left" |STSetColor
 +
| align="left" |Stack4: Textur-Index
 +
 
 +
Stack3: Alpha
 +
 
 +
Stack2: Rot
 +
 
 +
Stack1: Grün
 +
 
 +
Stack0: Blau
 +
| align="left" |-
 +
| align="left" |Setzt die Farbe, mit dem weitere Operationen vorgenommen werden sollen
 +
|-
 +
| align="left" |STDrawPixel
 +
| align="left" |Stack2: Textur-Index
 +
 
 +
Stack1: X
 +
 
 +
Stack0: Y
 +
| align="left" |-
 +
| align="left" |Setzt die Farbe des mit X und Y angegebenen Pixels auf den vorgewählten Farbwert
 +
|-
 +
| align="left" |STDrawRect
 +
| align="left" |Stack4: Textur-Index
 +
 
 +
Stack3: X1
 +
 
 +
Stack2: Y1
 +
 
 +
Stack1: X2
 +
 
 +
Stack0: Y2
 +
| align="left" |-
 +
| align="left" |Zeichnet ein ausgefülltes Rechteck in der vorgewählten Farbe zwischen den angegebenen Koordinatenpaaren
 +
|-
 +
| align="left" |STTextOut
 +
| align="left" |Stack5: Textur-Index
 +
 
 +
Stack4: X1
 +
 
 +
Stack3: Y1
 +
 
 +
Stack2: Fontindex
 +
 
 +
Stack1: Vollfarbe (oder nicht?)
 +
 
 +
Stack0: [http://de.wikipedia.org/wiki/Sperrsatz Sperr-Pixel]
 +
 
 +
StringStack0: Zu schreibender Text
 +
| align="left" |-
 +
| align="left" |Schreibt einen Text auf die Textur. Der Font-Index kann mittels ''GetFontIndex'' geholt werden. Vollfarbe gibt an, dass der Text in der aktuell vorgewählten Farbe geschrieben werden soll, andernfalls werden die Symbole in der Farbe der Schriftart geschrieben.
 
|}
 
|}
  

Version vom 11. Februar 2014, 17:58 Uhr

Hinweis: Dieser Artikel wurde noch nicht ins Englische übersetzt!

System-Makros sind spezielle im Hauptprogramm hinterlegte Makros, welche vom Skript mit dem Befehl (M.V.makroname) aufgerufen werden. Sie bekleiden verschiedene Funktionen und haben verschiedene Ein- und Ausgabeparameter.

Script-Texturen (gültig für Szenerie- und Fahrzeugscripts, nur OMSI 2)

Siehe auch Datei program\callbacklist_scripttex.txt!

Makroname Input-Stackwerte Output-Stackwerte Beschreibung
STNewTex Stack0: Textur-Index, entspricht [scripttexture]-Reihenfolge in model.cfg - Scripttextur initialisieren
STLock Stack0: Textur-Index - Scripttextur "locken", d.h. Lese- und Schreibzugriff erlauben
STUnlock Stack0: Textur-Index - Scripttextur "unlocken", d.h. Lese- und Schreibzugriff zurücknehmen und zum Rendern freigeben
STFilter Stack0: Textur-Index - Mipmaps erzeugen, d.h. Untervarianten in kleineren Auflösungen. Dies passiert üblicherweise nach dem Unlock, keinesfalls jedoch zwischen Lock und Unlock. Geschieht es nicht, kommt es zu Darstellungsfehlern in größeren Entfernungen ("überscharf", flimmern)
STSetColor Stack4: Textur-Index

Stack3: Alpha

Stack2: Rot

Stack1: Grün

Stack0: Blau

- Setzt die Farbe, mit dem weitere Operationen vorgenommen werden sollen
STDrawPixel Stack2: Textur-Index

Stack1: X

Stack0: Y

- Setzt die Farbe des mit X und Y angegebenen Pixels auf den vorgewählten Farbwert
STDrawRect Stack4: Textur-Index

Stack3: X1

Stack2: Y1

Stack1: X2

Stack0: Y2

- Zeichnet ein ausgefülltes Rechteck in der vorgewählten Farbe zwischen den angegebenen Koordinatenpaaren
STTextOut Stack5: Textur-Index

Stack4: X1

Stack3: Y1

Stack2: Fontindex

Stack1: Vollfarbe (oder nicht?)

Stack0: Sperr-Pixel

StringStack0: Zu schreibender Text

- Schreibt einen Text auf die Textur. Der Font-Index kann mittels GetFontIndex geholt werden. Vollfarbe gibt an, dass der Text in der aktuell vorgewählten Farbe geschrieben werden soll, andernfalls werden die Symbole in der Farbe der Schriftart geschrieben.

Szenerieobjekte

Siehe auch Datei program\callbacklist_scenobj.txt!

Makroname Input-Stackwerte Output-Stackwerte Beschreibung Beispiel
GetArrBusLine Stack0: Index des ankommenden Busses Stringstack0: Liniennummer des ankommenden Busses Hierzu muss das Szenerieobjekt per "Parent to..."-Funktion mit einer Bushaltestelle verbunden sein. Dann schreibt diese Funktion in den Stringstack0 die Liniennummer des Busses, welcher in der Reihenfolge der Ankünfte an der durch Index angegebenen Stelle kommt (nullbasiert!) 0 (M.V.GetArrBusLine) liefert die Liniennummer des nächsten Busses, 1 (M.V.GetArrBusLine) die des übernächsten Busses.
GetArrBusTerminus Stack0: Index des ankommenden Busses Stringstack0: Ziel des ankommenden Busses Funktioniert wie GetArrBusLine und liefert die Endhaltestelle des Busses. 0 (M.V.GetArrBusTerminus) liefert die Endhaltestelle des nächsten Busses, 1 (M.V.GetArrBusTerminus) die des übernächsten Busses.
GetArrBusTimeDiff Stack0: Index des ankommenden Busses Stack0: Zeitdauer bis Bus an Haltestelle ankommt Funktioniert wie GetArrBusLine und liefert die Zeit (in Sekunden), bis der per Index gewählte Bus an der Haltestelle ankommt. 0 (M.V.GetArrBusTimeDiff) liefert die Ankunftszeitdauer des nächsten Busses, 1 (M.V.GetArrBusTimeDiff) die des übernächsten Busses.

Fahrzeuge

Siehe auch Datei program\callbacklist_roadvehicle.txt!

Makroname Input-Stackwerte Output-Stackwerte Beschreibung Beispiel
GetRouteIndex Stack0: Route-Code Stack0: Route-Index Sucht in der Hofdatei die zum gegebenen Route-Code gehörigen Route-Index. -
GetBusstopString Stack1: Haltestellen-Index, Stack0: String-Index Stringstack0: Haltestellen-Stringinhalt Liefert aus der Hofdatei den stack0'ten String der stack1'ten Haltestelle. Beide Indizes sind [nullbasiert]. 5 2 (M.V.GetBusstopString) liefert den Inhalt des Strings Nr. 2 der Haltestelle Nr. 5
GetTerminusString Stack1: Terminus-Index, Stack0: String-Index Stringstack0: Endhaltestellen-Stringinhalt Liefert aus der Hofdatei den stack0'ten String der stack1'ten Endhaltestelle (Terminus). Beide Indizes sind [nullbasiert]. 7 3 (M.V.GetBusstopString) liefert den Inhalt des Strings Nr. 3 der Endhaltestelle Nr. 7
GetRouteTerminusIndex Stack0: Route-Index (nullbasiert) Stack0: Terminus-Index (nullbasiert) Liefert den zur vorgegebenen Route zugehörigen Terminus/Endhaltestellen-Index. Über GetTerminusString kann dann wiederum der Name der Endhaltestelle geholt werden. -
GetTerminusIndex Stack0: Terminus-Code Stack0: Terminus-Index Sucht in der Hofdatei die zum gegebenen Terminus-Code gehörigen Terminus-Index. -
GetTerminusCode Stack0: Terminus-Index Stack0: Terminus-Code Gibt den in der Hofdatei zum gegebenen Terminus-Index gehörigen Terminus-Code zurück und ist somit die Umkehrfunktion von GetTerminusIndex. -
GetBusstopCount Stack0: Route-Index Stack0: Haltestellenanzahl Gibt die Anzahl der Haltestellen der per Index gewählten Route zurück. Da es sich hier um eine Anzahl handelt, ist diese auch nicht nullbasiert - hat die Route also zwei Haltestellen, ist auch das Ergebnis dieser Funktion "2". -
GiveChangeCoin Stack0: Münz-Index - Sorgt für das Auswerfen der Münze mit dem Index Stack0, z.B. beim Geldwechsler-Script. 2 (M.V.GiveChangeCoin) wirft die Münze mit dem Index 2 aus.
GetRouteBusstopIdent Stack1: Route-Index, Stack0: Route-Busstop-Index Stringstack0: Ident der Bushaltestelle Liefert den Ident der Stack0'ten Bushaltestelle in der Route Stack1. Wiederum nullbasierte Indizes. 3 6 (M.V.GetRouteBusstopIdent) liefert also den Index der 6. Bushaltestelle der 3. Route.
GetBusstopIndex Stringstack0: Ident der Bushaltestelle Stack0: Index der Bushaltestelle Sucht den Index der über den Ident bezeichneten Bushaltestelle. "Reimerweg" (M.V.GetBusstopIndex) liefert den Index der Haltestelle Reimerweg.
GetTTBusstopCount - Stack0: Anzahl der Haltestellen Liefert die Anzahl der Haltestellen des aktuellen Fahrplans -
GetTTBusstopIndex - Stack0: Index der aktuellen Haltestelle Liefert den Index der aktuellen Haltestelle des aktuellen Fahrplans -
GetTTTerminusIndex - Stack0: Index der Endhaltestelle Liefert den Index der Endhaltestelle des aktuellen Fahrplans -
GetTTLineString - Stringstack0: Liniennummer Liefert die Liniennummer des aktuellen Fahrplans -
GetTTDelay - Stack0: Verspätung in Sekunden Liefert die aktuelle Verspätung gemäß aktivem Fahrplan -
GetTTBusstopName Stack0: Index der Haltestelle im aktuellen Fahrplan Stringstack0: Name der Haltestelle Liefert den Namen der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet -
GetTTBusstopDep Stack0: Index der Haltestelle im aktuellen Fahrplan STack0: Abfahrtszeit in Sekunden Liefert die Abfahrtszeit an der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet -
GetTTBusstopArr Stack0: Index der Haltestelle im aktuellen Fahrplan STack0: Ankunftszeit in Sekunden Liefert die Ankunftszeit an der Haltestelle, die sich im aktuellen Fahrplan an stack0'ter Stelle befindet -
GetTicketName Stack0: Ticket-Index Stringstack0: Ticket-Name Liefert den Namen der über Index indizierten Fahrkartentype (nullbasiert) -
GetTicketValue Stack0: Ticket-Index Stack0: Ticket-Preis Liefert den Preis der über Index indizierten Fahrkartentype (nullbasiert) -