Q_ChangePolygonScale

---

Einleitung

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

Schnittstellenstruktur

Ereignis-Eingänge

• INIT: Initialisierungsanforderung (mit Polygon-Objekt-ID)
• REQ: Skalierungsanforderung (mit neuen Abmessungen)

Ereignis-Ausgänge

• INITO: Initialisierungsbestätigung
• CNF: Skalierungsbestätigung (mit Ergebnisdaten)

Daten-Eingänge

• u16ObjId (UINT): Polygon-Objekt-ID
• u16NewWidth (UINT): Neue Breite in Pixeln
• u16NewHeight (UINT): Neue Höhe in Pixeln

Daten-Ausgänge

• STATUS (STRING): Betriebsstatusmeldung
• u16OldWidth (UINT): Vorherige Breite
• u16OldHeight (UINT): Vorherige Höhe
• s16result (INT): ISO-konformer Ergebniscode

Funktionsweise

1. Initialisierung:
2. INIT mit Polygon-Objekt-ID

3. INITO bestätigt Betriebsbereitschaft

4. Skalierung:

5. REQ mit neuen Abmessungen auslösen
6. Proportionale Skalierung aller Polygonpunkte

7. CNF liefert Ergebnis und alte Werte

8. Fehlerbehandlung:

9. ISO-standardisierte Fehlercodes
10. Detaillierte Statusmeldungen

Technische Besonderheiten

✔ ISO 11783-6 konform (F.54) ✔ Proportionale Skalierung (Breite/Höhe) ✔ 16-bit Auflösung (0-65535 Pixel) ✔ Echtzeitfähige Verarbeitung

Skalierungsverhalten

Parameter	Wirkung
Breite	Horizontale Skalierung
Höhe	Vertikale Skalierung
0xFFFF	Ursprungsgröße beibehalten

Rückgabecodes (s16result)

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

Anwendungsszenarien

• Maschinendarstellung: Dynamische Größenanpassung
• Zoomfunktionen: Detailvergrößerungen
• Responsive Designs: Anpassung an Displaygrößen
• Animierte Übergänge: Fließende Größenänderungen

⚖️ Vergleich mit ähnlichen Bausteinen

Feature	Q_ChangePolygonScale	VtGeometryScaler	VtDynamicResize
ISO-Standard	✔	✖	✖
Skalierung	Proportional	Frei	Nur Breite
Auflösung	16-bit	8-bit	16-bit

Fazit

Der Q_ChangePolygonScale-Baustein bietet die Referenzimplementierung für Polygon-Skalierungen:

• Präzise: Pixelgenaue Größenkontrolle
• Proportional: Erhalt der Originalform
• Standardkonform: Volle ISO 11783-6 Kompatibilität

Idealer Einsatz bei: - Adaptiven Visualisierungen - Dynamischen Kartenansichten - Größenveränderbaren Bedienelementen