Q_EndPoint

---

Einleitung

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

Schnittstellenstruktur

Ereignis-Eingänge

• INIT: Initialisierungsanforderung (mit Objekt-ID)
• REQ: Endpunktänderungs-Anforderung (mit Position/Richtung)

Ereignis-Ausgänge

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

Daten-Eingänge

• u16ObjId (UINT): Linienobjekt-ID
• u16Width (UINT): Neue X-Endposition (0-65535 Pixel)
• u16Height (UINT): Neue Y-Endposition (0-65535 Pixel)
• u8LineDirection (USINT): Linienrichtung (ISO 11783-6 B.27)

Daten-Ausgänge

• STATUS (STRING): Betriebsstatusmeldung
• u16OldWidth (UINT): Vorherige X-Endposition
• u16OldHeight (UINT): Vorherige Y-Endposition
• u8OldLineDirection (USINT): Vorherige Linienrichtung
• s16result (INT): ISO-konformer Ergebniscode

Funktionsweise

1. Initialisierung:
2. INIT mit Linienobjekt-ID

3. INITO bestätigt Betriebsbereitschaft

4. Endpunktänderung:

5. REQ mit neuen Positions- und Richtungsparametern
6. Ändert Endpunkt und Ausrichtung der Linie

7. CNF liefert Ergebnis und alte Werte

8. Fehlerbehandlung:

9. ISO-standardisierte Fehlercodes
10. Detaillierte Statusmeldungen

Technische Besonderheiten

✔ ISO 11783-6 konform (F.26 + B.27) ✔ 16-bit Positionsauflösung (0-65535 Pixel) ✔ Vollständige Liniensteuerung (Position + Richtung) ✔ Echtzeitfähige Verarbeitung

Linienrichtungen (B.27)

Wert	Richtung	Beschreibung
0	Horizontal	Von links nach rechts
1	Vertikal	Von oben nach unten
2	Diagonal rechts	Links oben → rechts unten
3	Diagonal links	Rechts oben → links unten

Rückgabecodes (s16result)

Code	Konstante	Bedeutung
0	VT_E_NO_ERR	Erfolgreich
-6	VT_E_OVERFLOW	Ungültige Positionswerte
-128	VT_E_HANDLE_INVALID	Ungültige Linienobjekt-ID
-129	VT_E_ISO_INSTANCE_INVALID	Ungültige Instanz

Anwendungsszenarien

• Maschinenvisualisierung: Dynamische Verbindungslinien
• Diagramme: Anpassbare Datenanzeigen
• Technische Zeichnungen: Konfigurierbare Hilfslinien
• UI-Design: Adaptive Trennlinien

⚖️ Vergleich mit ähnlichen Bausteinen

Feature	Q_EndPoint	VtLineEditor	VtDynamicLine
ISO-Standard	✔	✖	✖
Steuerung	Endpunkt	Vollständig	Nur Position
Richtungen	4 Optionen	8 Optionen	Keine

Fazit

Der Q_EndPoint-Baustein bietet die Referenzimplementierung für Linienendpunkt-Steuerung:

• Präzise: Pixelgenaue Positionierung
• Flexibel: Kombinierte Positions- und Richtungssteuerung
• Standardkonform: Volle ISO 11783-6 Kompatibilität

Idealer Einsatz bei: - Dynamischen technischen Zeichnungen - Adaptiven Diagrammanzeigen - Konfigurierbaren Benutzeroberflächen