===== cpSetSlotSubScreen =====

==== Einleitung ====
\\
{{ :cockpit-xp:addon:befehlsreferenz:cpwiki-cpsetnr-rbs-eigenschaft.png?nolink&300|}} Cockpit-XP stellt für die Renndatenanzeige diverse interne Variablen bereit. Diese werden im Renndesigner einem Slot (Spur oder Regler-ID) oder nach der Platz (sortierte Ausgabe) zugeordnet. Für diese Slot bezogenen Variablen gibt es die Nummer ''nr="1-8"'' für bis zu 8 Spuren einer analogen Rennbahn oder 6 digitalen Fahrzeugen mit Ghost- und Pacecar.

Bei allgemeine Ausgabevariablen, z.B. ''<status>'' ist als Nummer der Wert ''0'' konfiguriert. Ein anderes Beispiel sind die Variablen zum Bahnrekord.

Arbeitet die Anzeige mit sortierter Ausgabe, steht ''nr="-1"'' für den Führenden oder Position 1.

''nr="-3"'' wird verwendet, wenn man einen Rennbildschirm entwirft, der nur Anzeigen für eine Spur oder Regler-ID enthält. Das ist z.B. bei den mitgelieferten Rennbildschirmen zum Qualifikation auf einer Spur implementiert. Wird die Qualifikation nur auf Spur 3 ausgetragen, zeigt der Rennbildschirm die Daten an, ohne dass man für jede Spur / jeden Regler einen eigenen Rennbildschirm mit der richtigen Nummer anlegen muss.

Kommen die Werte für die Anzeigeelemente aus einem AddOn, kann man ''nr="-2"'' im Rennbildschirm verwenden. Im AddOn muss dann mit diesem Befehl jedoch explizit die Nummer gesetzt werden, für die der Variableninhalt zu zeigen ist.

Der Befehl [[cockpit-xp:addon:befehlsreferenz:cpsetnr|cpSetNr]] hat die gleiche Funktion, ist allerdings ausschließlich für den Einsatz mit einem normalen Rennbildschirm verwendbar während [[cockpit-xp:addon:befehlsreferenz:cpsetslotsubscreen|cpSetSlotSubScreen]] nur für Subscreens genutzt werden kann.




==== Syntax ====

^  Befehl | //cpSetSlotSubScreen//(''slot:Integer'') |
^  Funktion| Setzt gezielt die Nummer für einen Slot zur Anzeige von Slot-/Platz bezogenen Daten aus dem AddOn auf einem Subscreen. |
^  Typ |  |
\\

==== Codebeispiel =====

 <Code:pascal linenums>{ Pascal Script Engine }
{ Event: StartZiel }
{ Parameter: Cockpit.Slot=<SlotPlatz> }

var
  slot : Integer;
  id : Integer;
  
begin

  // Slot speichern und einstellen
  slot := Cockpit.Slot;
  Cockpit.Slot := slot;
  
  // Spur/ID zu Slot holen
  id := Cockpit.SlotID;
  
  // Nummer für Ausgabe in RBS einstellen
  cpSlotSubScreen(id);
  
  // Schnellste Runde in Variable speichern
  cpSetIntegerVar('besteRunde', Cockpit.SchnellsteRunde);
  
end.</Code> 
\\
 Dieser Code zeigt die schnellste Runde für die aktuell über Start/Ziel gefahrene Spur/Regler-ID aus dem AddOn heraus auf einem Subscreen an. Nummer und Wert kommen aus dem AddOn. Der SubScreen muss vorher angezeigt werden. Siehe dazu [[cockpit-xp:addon:befehlsreferenz:cpshowsubscreen|cpShowSubScreen]]. \\

 
{{ :cockpit-xp:addon:befehlsreferenz:cpwiki-cpsetnr-rbs-einstellung.png?nolink |}}


----

[[cockpit-xp:start|Start]] - [[cockpit-xp:faq|FAQ]] - [[cockpit-xp:glossar|Glossar]] - [[cockpit-xp:sitemap|Sitemap]] - [[cockpit-xp:impressum|Impressum]]