FS25_AgraGPS - Einbau des Cockpit-Displays in ein Fahrzeug
(c) Guner348. Alle Rechte vorbehalten.
======================================================================

1. GIANTS Editor
   - An den gewünschten Screen eine TransformGroup anlegen, z. B. "agraGPSScreen".

   - "FS25_AgraGPS" entpacken

   - Unter display/agraGPSScreen.i3d in die I3D eures Fahrzeug importieren (File > Import)
     und in diese TransformGroup legen. Die importierte I3D dient nur als Vorlage, damit man sieht,
     wo das Display sitzt und wie groß es ist.

   - Die TransformGroup verschieben, drehen und skalieren, bis das Display auf den
     Bildschirm im Modell passt. Nicht die importierte I3D!

   - Die Skalierung in die Fahrzeug-XML übertragen (siehe 2.):
       width  = Skalierung X
       height = Skalierung Y
     Beispiel: Skalierung 0.24 / 0.15 / 1  ->  width="0.24" height="0.15"

   - Das importierte Display (die Vorlage) aus der TransformGroup löschen.

   - Die Skalierung der TransformGroup wieder auf 1 / 1 / 1 setzen. Position und Drehung bleiben!

   - Index der TransformGroup kopieren und im I3D Mapping der XML anpassen (siehe 2.).

   -Den entpackten "FS25_AgraGPS" Ordner löschen

2. FAHRZEUG-XML
   - i3dMapping mit id="agraGPSScreen" und dem kopierten Index eintragen.

   - Unter DOC/agraGPSDisplay_vehicle.xml den Funktionseintrag in die XML kopieren.

   - Alle Werte aus Schritt 1. einfügen.

   - Name des Displays vergeben, bzw bei mehreren mehrere Namen vergeben.

   - Option zum einschalten des Displays wählen

   - Option zum schalten des "Dunkelmodus" wählen

   - Optional: <agraGPSSteering fixedSteeringWheel="true" /> direkt in <vehicle>.
     Dann bleibt das Lenkrad bei aktiver Spurführung stehen und nur die Räder
     lenken, wie bei Schleppern mit Spurführung ab Werk. Mit "false" oder ohne
     den Eintrag dreht sich das Lenkrad mit (nachgerüstetes Lenksystem).
     (Geht auch ohne Cockpit-Display).

3. DASHBOARDLIVE (OHNE EINBAU)
   - Ist der Mod DashboardLive (DBL) aktiv, ersetzen AgraGPS und AgraMonitor automatisch die
     DBL-Minimap in jedem Fahrzeug, das eine hat. Kein Eintrag in der Fahrzeug-XML nötig.

   - Umschalten mit den DBL-Seitentasten (Alt rechts + Pfeil rechts / links, im Steuerungsmenü änderbar):
     Auf der Seite mit der Karte wechselt "Seite vor" erst von AgraGPS zu AgraMonitor,
     dann auf die nächste DBL-Seite. "Seite zurück" umgekehrt.
     Hat das Fahrzeug nur eine DBL-Seite, wechseln die Tasten im Kreis.

   - Ist nur einer der beiden Mods aktiv, zeigt die Fläche immer diesen.

   - Größe und Lage stimmen genau: Die Kartenflächen aller Terminals aus DashboardLive_VanillaVehicles
     (Fendt One, VarioTronic, John Deere G4/G5, CLAAS, Case/New Holland, Deutz, Valtra, MF, Oxbo,
     isoBUS, Volvo, Skoda) und die DBL-Standardkarte sind im Mod hinterlegt. Bei anderen Flächen
     wird gemessen, sonst geschätzt (Seitenverhältnis 1.5).
     Oft liegen Teile des Terminals über der DBL-Karte, dann ist sie größer als der sichtbare
     Kartenbereich. Zuschneiden bzw. anpassen im Fahrzeug in der Konsole (~):
       agraDBLScreen height 0.6       Höhe auf 60 % der DBL-Kartenfläche
       agraDBLScreen width 0.9        Breite auf 90 %
       agraDBLScreen aspect 1.6       Seitenverhältnis Breite/Höhe (nur beim Schätzen)
       agraDBLScreen scale 0.95       etwas kleiner (1.05 = größer)
       agraDBLScreen move 0.5 -1      verschieben in cm (rechts, oben)
       agraDBLScreen flip             umdrehen, falls von hinten zu sehen
       agraDBLScreen size 0.21 0.13   feste Größe in Metern
       agraDBLScreen reset            zurücksetzen
       agraDBLScreen off 2            auf Platz 2 die DBL-Karte lassen (on 2 = wieder ersetzen)
     Gilt für das Terminal, also für alle Fahrzeuge mit diesem Terminal, und wird in
     modSettings/AgraDBLScreens.xml gespeichert.
     Hat ein Fahrzeug mehrere DBL-Karten, kommt die Platznummer als letzter Wert dazu.
     "agraDBLDebug" zeigt die Plätze mit Lage im Fahrzeug und die ermittelten Werte.

BEDIENUNG
   Terminal mit allen Einstellungen: Alt links + G (im Steuerungsmenü änderbar).


======================================================================
FS25_AgraGPS - Installing the cockpit display in a vehicle (English)
(c) Guner348. All rights reserved.
======================================================================

1. GIANTS Editor
   - Create a TransformGroup on the desired screen, e.g. "agraGPSScreen".

   - Unpack "FS25_AgraGPS"

   - Import display/agraGPSScreen.i3d into your vehicle's I3D (File > Import)
     and place it in this TransformGroup. The imported I3D only serves as a template,
     so you can see where the display sits and how large it is.

   - Move, rotate and scale the TransformGroup until the display fits the
     screen in the model. Not the imported I3D!

   - Transfer the scale to the vehicle XML (see 2.):
       width  = scale X
       height = scale Y
     Example: scale 0.24 / 0.15 / 1  ->  width="0.24" height="0.15"

   - Delete the imported display (the template) from the TransformGroup.

   - Set the scale of the TransformGroup back to 1 / 1 / 1. Position and rotation stay!

   - Copy the index of the TransformGroup and update it in the i3dMapping of the XML (see 2.).

   - Delete the unpacked "FS25_AgraGPS" folder

2. VEHICLE XML
   - Add an i3dMapping with id="agraGPSScreen" and the copied index.

   - Copy the entry from DOC/agraGPSDisplay_vehicle.xml into the XML.

   - Insert all values from step 1.

   - Give the display a name, or one name each if there are several displays.

   - Choose the option for switching the display on

   - Choose the option for switching the "dark mode"

   - Optional: <agraGPSSteering fixedSteeringWheel="true" /> directly in <vehicle>.
     The steering wheel then stays still while the steering assistant is active
     and only the wheels steer, as on tractors with factory-fitted guidance.
     With "false" or without the entry the steering wheel turns along
     (retrofitted steering system). (Also works without a cockpit display).

3. DASHBOARDLIVE (NO INSTALLATION)
   - If the DashboardLive (DBL) mod is active, AgraGPS and AgraMonitor automatically replace the
     DBL minimap in every vehicle that has one. No entry in the vehicle XML is needed.

   - Switch with the DBL page keys (Right Alt + right / left arrow, can be changed in the controls menu):
     On the page with the map, "page up" first switches from AgraGPS to AgraMonitor,
     then to the next DBL page. "Page down" works the other way round.
     If the vehicle has only one DBL page, the keys cycle.

   - If only one of the two mods is active, the screen always shows that one.

   - Size and position are exact: the map surfaces of all terminals from DashboardLive_VanillaVehicles
     (Fendt One, VarioTronic, John Deere G4/G5, CLAAS, Case/New Holland, Deutz, Valtra, MF, Oxbo,
     isoBUS, Volvo, Skoda) and the DBL standard map are stored in the mod. Other surfaces are
     measured, otherwise estimated (aspect ratio 1.5).
     Parts of the terminal often lie on top of the DBL map, then it is larger than the visible
     map area. Crop or adjust in the console (~) while sitting in the vehicle:
       agraDBLScreen height 0.6       height = 60 % of the DBL map surface
       agraDBLScreen width 0.9        width = 90 %
       agraDBLScreen aspect 1.6       aspect ratio width/height (only when estimated)
       agraDBLScreen scale 0.95       a bit smaller (1.05 = bigger)
       agraDBLScreen move 0.5 -1      move in cm (right, up)
       agraDBLScreen flip             turn around if seen from behind
       agraDBLScreen size 0.21 0.13   fixed size in metres
       agraDBLScreen reset            reset
       agraDBLScreen off 2            keep the DBL map on slot 2 (on 2 = replace again)
     Applies to the terminal, i.e. to all vehicles with this terminal, and is saved in
     modSettings/AgraDBLScreens.xml.
     If a vehicle has several DBL maps, add the slot number as the last value.
     "agraDBLDebug" shows the slots with their position in the vehicle and the detected values.

CONTROLS
   Terminal with all settings: Left Alt + G (can be changed in the controls menu).
