Q_ChangeObjectLabel

---

Einleitung

Der Q_ChangeObjectLabel ist ein standardkonformer Funktionsbaustein zur Änderung von Objektbeschriftungen in Virtual Terminals, entwickelt unter EPL-2.0 Lizenz. Die Version 1.0 implementiert die ISO 11783-6 (Teil 6 - F.50) Spezifikation für landwirtschaftliche Steuersysteme.

Schnittstellenstruktur

Ereignis-Eingänge

• INIT: Initialisierungsanforderung (mit Objekt-ID)
• REQ: Beschriftungsänderungs-Anforderung (mit Text/Grafik-Parametern)

Ereignis-Ausgänge

• INITO: Initialisierungsbestätigung
• CNF: Änderungsbestätigung (mit Ergebnisdaten)

Daten-Eingänge

• u16ObjId (UINT): Zielobjekt-Kennung
• u16ObIdStringVar (UINT): Textvariablen-Objekt-ID (max. 32 Zeichen)
• u8FontType (USINT): Schriftart (bei Textbeschriftung)
• u16ObIdGrafic (UINT): Grafikobjekt-ID (für Symbolbeschriftung)

Daten-Ausgänge

• STATUS (STRING): Betriebsstatusmeldung
• u16OldObIdStringVar (UINT): Vorherige Textvariablen-ID
• u8OldFontType (USINT): Vorherige Schriftart
• u16OldObIdGrafic (UINT): Vorherige Grafikobjekt-ID
• s16result (INT): ISO-konformer Ergebniscode

Funktionsweise

1. Initialisierung:
2. INIT mit Zielobjekt-ID

3. INITO bestätigt Betriebsbereitschaft

4. Beschriftungsänderung:

5. REQ mit neuen Beschriftungsparametern
6. Unterstützt Text (mit Schriftart) oder Grafiksymbole

7. CNF liefert Ergebnis und alte Werte

8. Fehlerbehandlung:

9. ISO-standardisierte Fehlercodes
10. Detaillierte Statusmeldungen

Technische Besonderheiten

✔ ISO 11783-6 konform (F.50) ✔ Flexible Beschriftung: Text oder Grafik ✔ Schriftart-Steuerung (8-bit) ✔ 32-Zeichen Limit für Textbeschriftungen

Standardparameter

Parameter	NULL-Wert	Beschreibung
u16ObIdStringVar	0xFFFF	Kein Text
u16ObIdGrafic	0xFFFF	Keine Grafik

Rückgabecodes (s16result)

Code	Konstante	Bedeutung
0	VT_E_NO_ERR	Erfolgreich
-6	VT_E_OVERFLOW	Pufferüberlauf (Text zu lang)
-128	VT_E_HANDLE_INVALID	Ungültige Objekt-ID

Anwendungsszenarien

• Maschinensteuerung: Dynamische Schaltflächenbeschriftung
• Sprachumschaltung: Mehrsprachige Oberflächen
• Statusanzeigen: Symbolwechsel bei Alarmen
• Personalisierung: Benutzerdefinierte Labels

⚖️ Vergleich mit ähnlichen Bausteinen

Feature	Q_ChangeObjectLabel	VtDynamicLabel	VtTextManager
ISO-Standard	✔	✖	✖
Beschriftung	Text + Grafik	Nur Text	Nur Text
Schriftart	Steuerbar	Fest	Teilweise

Fazit

Der Q_ChangeObjectLabel-Baustein bietet die Referenzimplementierung für ISOBUS-Beschriftungen:

• Vielseitig: Kombination von Text und Grafiken
• Standardkonform: Volle ISO 11783-6 Kompatibilität
• Praxisbewährt: Eingesetzt in modernen Agrarmaschinen

Unverzichtbar für: - Adaptive Benutzeroberflächen - Mehrsprachige Systeme - Symbolgesteuerte Bedienkonzepte