===== cpSetCuOffsetBremsWert() =====

==== Einleitung====
Setzt einen positiven oder negativen Offset relativ zum aktuellen Bremswert für ein Fahrzeug. Der „Grundwert“ bleibt dabei erhalten. Beispiel: Bremse ist 10. Offset -3 ergibt dann ja 7. Ein erneuter Offset von -2 ergibt mit diesem Befehl 8 und nicht 5 da der Basiswert 10 erhalten bleibt von dem aus der Offset beaufschlagt wird. Möchte man auch den Basiswert verändern, so muss man den Befehl cpAddCUOffsetBremsWert() verwenden. Die Übertragung folgt wahlweise bei Start/Ziel oder sofort.\\
 
==== Syntax ====

^  Befehl | cpSetCuOffsetBremsWert(ID:Integer, Value:Integer, Fast:Boolean) |
^  ID | Fahrzeug-Regeler-ID aus dem StartCenter | Integer |
^  Value | Wert für die Offset (-15 bis +15) | Integer |
^  Fast | True = Setzen sofort, false = Setzen erst bei Überfahrt StartZiel | Boolean |

==== Codebeispiel ====

<Code:pascal linenums|Beispiel 1 - cpSetCuOffsetBremsWert>var
  Slot    : Integer;
  ID      : Integer;
  Offset  : Integer;
  Fast    : Boolean;

begin
  ...
  Slot           := Cockpit.Slot;
  Cockpit.Slot   := Slot;
  ID             := Cockpit.SlotID;
  Offset         := -5;
  Fast           := True;
  ...
  cpSetCuOffsetBremsWert(ID, Offset, Fast);
  ...
end.
</Code> 
\\
Obiger Code setzt für die Fahrzeug-ID einen neuen Bremswert (vorheriger Wert -5) und zwar sofort (Fast = True).\\

Man muss übrigens nicht mit Variablen arbeiten, man kann auch "hart" programmieren:\\
<Code:pascal linenums|Beispiel 2 - cpSetCuOffsetBremsWert>
begin
  ...
  cpSetCuOffsetBremsWert(Cockpit.SlotID,-5,True);
  ...
end.
</Code> 
\\

Der Befehl fängt ein unterschreiten (<0) und ein Überschreiten (>15) intern ab.

==== Hinweise ====
Durch Verwendug des Offsetsbefehls können aktivierte Geschwindigkeits- und Bremsprofile weiterhin verwendet werden, sie laufen mit diesem neuen Offset einfach weiter.\\

----

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