sgcGauges Feature-Matrix
Alles, was sgcGauges kann, nach Aufgabe gruppiert, mit einem Link zum Hilfethema jeder Funktion. Jedes Instrument hat ein Headless-Modell, ein VCL-Steuerelement, ein FireMonkey-Steuerelement und drei .NET-Steuerelemente.
Alles, was sgcGauges kann, nach Aufgabe gruppiert, mit einem Link zum Hilfethema jeder Funktion. Jedes Instrument hat ein Headless-Modell, ein VCL-Steuerelement, ein FireMonkey-Steuerelement und drei .NET-Steuerelemente.
11 Funktionen
4 Funktionen
7 Funktionen
3 Funktionen
7 NuGet-Pakete
Online-Hilfe und PDF-Handbücher
Registered kennzeichnet die Features, die in den Editionen Registered und Testversion enthalten sind, aber nicht in der kostenlosen Community Edition. ~ kennzeichnet ein Feature, das Community nur teilweise enthält, mit dem Unterschied darunter.
Jede Zeile verlinkt auf ihr Hilfethema. Die Spalte Community zeigt, was die kostenlose .NET Community Edition enthält; alles ist in Registered und in der Testversion enthalten.
| Funktion | Details | Community | Hilfe |
|---|---|---|---|
| Rund | Rundinstrument mit Skalen, Bereichen und Zeigern. | Hilfe | |
| Linear | Balken, Thermometer und Bullet-Graph in einem Instrument: LinearStyle glsBar, glsThermometer, glsBullet, plus Target. | Hilfe | |
| Digital | Anzeige mit 7 Segmenten. 14 Segmente und Punktmatrix mit Geistersegmenten und Neigung sind in der registrierten Edition enthalten. | Hilfe | |
| LED und LED-Balken | Blinkende LEDs und ein LED-Balken mit Spitzenwerthaltung. | Hilfe | |
| Fortschrittsring | Kreisförmige Fortschrittsanzeige. | Hilfe | |
| Tank und Behälter | TsgcVCLTankGauge (TsgcFMXTankGauge in FireMonkey und dieselben Namen in WinForms, WPF und Avalonia) zeigt den Füllstand eines Behälters für Prozessbilder. Shape zeichnet einen stehenden Zylinder, eine liegende Kapsel, einen Kegelboden oder eine Kugel. LimitHH, LimitH, LimitL und LimitLL markieren die ISA-Grenzwerte am Behälter, LimitHysteresis hält einen Grenzwertzustand, bis sich der Füllstand klar davon entfernt, und LimitState meldet ihn, während der Tank ein Abzeichen HH, H, L oder LL zeichnet, sodass der Zustand nie allein von der Farbe abhängt. | Hilfe | |
| Prozesssymbol | TsgcVCLSymbolGauge (TsgcFMXSymbolGauge in FireMonkey und dieselben Namen in WinForms, WPF und Avalonia) zeichnet ein Ventil, eine Pumpe, einen Motor, einen Lüfter, einen Wärmetauscher oder einen Sensor (Kind) in seinem Prozesszustand: aus, ein, Störung, offen, geschlossen oder in Bewegung (State). Eine laufende Pumpe oder ein laufender Lüfter dreht sich, eine Störung blinkt mit einer Markierung, und ein Ventil in Bewegung hat eine gestrichelte Kontur. Rotation dreht das Symbol, und der Anlagentag wird darunter gezeichnet. | Hilfe | |
| VU-Meter | Pegelanzeige für Audio. | Registriert | Hilfe |
| Uhr und Kompass | Analoguhr und Kompass. | Registriert | Hilfe |
| Annunciator | Alarmkacheln, die bis zur Quittierung blinken (Acknowledge, OnTileClick). | Registriert | Hilfe |
| Eingabe-Gauges | TsgcVCLKnobGauge, TsgcVCLSliderGauge, TsgcVCLToggleSwitchGauge und TsgcVCLPushButtonGauge (TsgcFMX unter FireMonkey, und dieselben Namen in WinForms, WPF und Avalonia) lassen den Benutzer einen Wert festlegen: den Drehregler drehen, den Schieberegler ziehen, den Schalter umlegen oder den Taster drücken, mit Maus, Touch, Mausrad oder Tastatur. Step rastet den Wert ein, ReadOnly sperrt ihn, der Taster arbeitet momentan oder einrastend (Mode), und OnUserChange wird nur bei Änderungen des Benutzers ausgelöst. Sie werden in Rechts-nach-links-Layouts gespiegelt, und Screenreader sehen sie als Schieberegler, Kippschalter und Schaltfläche. | Hilfe |
| Funktion | Details | Community | Hilfe |
|---|---|---|---|
| Bereiche | Grüne, gelbe und rote Bänder von beliebigem Minimum bis Maximum (Ranges.Add, StartValue, EndValue, Color). | Hilfe | |
| Skalen | Skala mit MajorInterval. Mehrere Skalen pro Instrument sind in der registrierten Edition enthalten. | Hilfe | |
| Zeiger | Nadel- und Markerzeiger. Mehrere Zeiger pro Instrument sind in der registrierten Edition enthalten. | ~Community zeichnet eine Skala und einen Zeiger pro Gauge; die registrierte Edition zeichnet alle. | Hilfe |
| Schwellenwerte mit Hysterese | OnThreshold löst bei jedem Überschreiten aus (gtdRising, gtdFalling, gtdBoth), im Hauptthread, egal welcher Thread den Wert geschrieben hat. | Hilfe |
| Funktion | Details | Community | Hilfe |
|---|---|---|---|
| Animation | Die Nadel läuft animiert zu jedem neuen Wert, standardmäßig 300 ms, mit fünf Easing-Kurven: geLinear, geQuadOut, geCubicOut, geCubicInOut, geBackOut. | Hilfe | |
| Themes | Helle und dunkle Themes mit einer Eigenschaft: Theme := utDark. | Hilfe | |
| Skins | Skin wählt einen registrierten Skin nach Namen: Classic (das Standardaussehen), Modern, Industrial, ISA101 und Dark. SkinData legt eigene Farben für ein Gauge fest: Zifferblatt, Lünette, Spur, Teilstriche, Beschriftungen, Nadel, LEDs, Alarmstufen und die Teile der Eingabe-Gauges, dazu die Stile von Zifferblatt, Lünette und Nadel und die Stärke von Beschriftung und Wert. sgcGaugesRegisterSkin fügt einen eigenen Skin hinzu, und sgcGaugesSetDefaultSkin wendet einen auf jedes Gauge an. Eine am Gauge gesetzte Farbe hat Vorrang vor dem Skin, der Skin vor dem Theme, und ein Windows-Theme mit hohem Kontrast gewinnt immer. Skins werden als JSON gespeichert und geladen. | Hilfe | |
| Headless-Rendering | SaveToPNG und SaveToSVG an jedem Steuerelement und Modell, auch unter Linux64 und in der .NET-Demo ConsoleRender. | Hilfe | |
| Rechts nach links (Arabisch und Hebräisch) | Die Platzierung von Beschriftung und Einheitentext folgt der Richtung. Zifferblätter, Uhren, Kompass, VU-Meter sowie lineare und ringförmige Fortschrittsanzeigen behalten ihre Ausrichtung. | Hilfe | |
| Drucken und Druckvorschau | Print und ShowPrintPreview drucken das Instrument auf einer Seite wie auf dem Bildschirm, mit seinem Endwert, auch wenn eine Animation läuft. PrintSettings legt Papier, Ausrichtung, Ränder, Skalierung, Kopf- und Fußzeile einmal für Drucker, Vorschau und PDF fest. In jeder Edition, unter VCL, FireMonkey, WinForms, WPF und Avalonia (FireMonkey druckt unter Windows und macOS). | Hilfe | |
| Barrierefreier PDF-Export, PDF/UA und PDF/A (mit sgcPDF) | ExportToPDF schreibt das Instrument als Vektorgrafik mit echtem Text und einem Alternativtext mit Beschriftung, Wert, Einheit und Bereich. Die Datei ist standardmäßig ein getaggtes PDF/UA-Dokument, und PDFALevel ergänzt PDF/A-2a oder PDF/A-3a. Erfordert die sgcUIPDF-Brücke und ein lizenziertes sgcPDF (esegece.sgcUICore.sgcPDF in .NET). | Registriert | Hilfe |
| Barrierefreiheit | Jede Instrumentenart stellt ihre Beschriftung, ihren Wert und ihren Bereich über UI Automation bereit, und die Schwellenwerte werden als Ansagen ausgelöst. Instrumente sind standardmäßig keine Tabstopps, weil sie nur Werte zeigen, und TabStop nimmt sie in die Tabulatorreihenfolge auf. Der hohe Kontrast von Windows wird berücksichtigt. Standardmäßig aktiv unter VCL (Delphi 7 bis 13), in FireMonkey unter Windows, WinForms, WPF und Avalonia. | Hilfe |
| Funktion | Details | Community | Hilfe |
|---|---|---|---|
| Datenbindung | TsgcGaugeDataLink zeigt den Wert eines Dataset-Feldes auf jedem VCL- oder FireMonkey-Gauge an (DataSource, DataField, Gauge) und folgt dem aktuellen Datensatz, seinen Änderungen und seinem Speichern. Unter .NET bindet es eine DataTable- oder DataView-Spalte, und TsgcWinFormsGaugeDataLink folgt dem CurrencyManager eines WinForms-Formulars. Eine Änderung des Benutzers an einem Eingabe-Gauge wird in das Feld zurückgeschrieben, mit OnBeforeWriteBack, OnWriteBack und OnWriteBackError; ein abgelehntes oder fehlgeschlagenes Schreiben setzt das Gauge auf den Feldwert zurück. In WPF und Avalonia werden die Eigenschaften Value und Checked der Eingabe-Gauges in beide Richtungen an ein View Model gebunden. | ~Das Lesen des Feldes ist in jeder Edition enthalten. Das Zurückschreiben ist Registered. | Hilfe |
| Bindung von MQTT, WebSocket und SSE | sgcGaugesWS bindet MQTT-Topics (mit den Filtern + und #) und JSON-Felder von WebSocket- und SSE-Nachrichten über ValuePath, FilterPath und FilterValue an Instrumentenzeiger. Erfordert sgcWebSockets. | Registriert | Hilfe |
| Tank- und Prozesssymbol-Feeds | Die MQTT-, WebSocket- und SSE-Bindungen von sgcGaugesWS steuern den Füllstand eines Tanks und den Zustand eines Prozesssymbols. Ein Symbol übernimmt auch seine Zustandsnamen, etwa "open" oder "on", und ValueMap übersetzt die Codes, die eine Anlage sendet, etwa ein SPS-Bit oder einen Statustext wie RUNNING, in Symbolzustände. Benötigt sgcWebSockets. | Registered | Hilfe |
Die .NET-Instrumente sind ein C#-Port mit denselben Klassennamen, für WinForms, WPF und Avalonia, mit der Brücke für Live-Daten als eigenem Paket.
| Paket | Edition | Inhalt |
|---|---|---|
esegece.sgcGauges.Community | Community (kostenlos) | Kernbibliothek |
esegece.sgcGauges.WinForms.Community | Community (kostenlos) | Windows-Forms-Steuerelemente |
esegece.sgcGauges.Wpf.Community | Community (kostenlos) | WPF-Steuerelemente |
esegece.sgcGauges.Avalonia.Community | Community (kostenlos) | Avalonia-Steuerelemente |
esegece.sgcGauges.Rendering.Community | Community (kostenlos) | Headless-Rendering |
esegece.sgcGauges | Registered | Kernbibliothek |
esegece.sgcGauges.WinForms | Registered | Windows-Forms-Steuerelemente |
esegece.sgcGauges.Wpf | Registered | WPF-Steuerelemente |
esegece.sgcGauges.Avalonia | Registered | Avalonia-Steuerelemente |
esegece.sgcGauges.Rendering | Registered | Headless-Rendering |
esegece.sgcGauges.sgcWebSockets | Nur Registered | sgcWebSockets-Brücke |
Jede Funktion von sgcGauges ist in der sgcUI-Hilfe dokumentiert, mit je einer Ausgabe für jede Entwicklungsumgebung.
Beginne mit der Einführung zu sgcGauges, und folge dann der Schnellstartanleitung und den Funktionsthemen.
Delphi →Die komplette sgcUI-Hilfe als PDF-Datei, zum Offline-Lesen oder Ausdrucken.
Delphi (PDF) →