Zehn Gauge-Typen für Dashboards und HMI-Panels, vom Rundinstrument bis zum Annunciator. Zeichne grüne, gelbe und rote Bänder, löse einen Alarm aus, wenn ein Wert eine Grenze überschreitet, lass die Nadel zu jedem neuen Messwert gleiten und rendere dasselbe Gauge auf einem Server nach PNG oder SVG.
Elf Funktionen in vier Gruppen, mit den echten Klassen- und Eigenschaftsnamen und einem Link zu jedem Hilfethema. Als Registered markierte Funktionen sind nicht im kostenlosen .NET-Community-Build enthalten.
Zehn Typen auf einem Modell, mit Bereichen, Stilen und mehreren Zeigern.
Instrumente und Skalen
Dashboards, HMI-Panels und Prüfstände brauchen verschiedene Instrumente: ein Rundinstrument für die Geschwindigkeit, einen Balken für den Füllstand, eine Digitalanzeige für die Frequenz, eine Lampe für eine Pumpe, ein Kachelpanel für Alarme. sgcGauges liefert zehn Typen, die ein Modell teilen, dieselben Skalen, Zeiger, Bereiche, Schwellenwerte und Themes. Lerne eine API, und jedes Instrument verhält sich gleich.
TsgcVCLRadialGauge, TsgcVCLLinearGauge, TsgcVCLDigitalGauge, TsgcVCLLEDGauge, TsgcVCLLEDBarGauge, TsgcVCLProgressRingGaugeTsgcVCLVUMeterGauge, TsgcVCLClockGauge, TsgcVCLCompassGauge, TsgcVCLAnnunciatorGaugeTsgcRadialGauge, für den Headless-EinsatzCommunity hat die Gauges radial, linear, digital mit 7 Segmenten, LED, LED-Balken und Fortschrittsring. VU-Meter, Uhr, Kompass und Annunciator sind Registered.
Hilfethema lesen
Instrumente und Skalen
Ein Bediener liest ein Gauge nur dann auf einen Blick, wenn Grün, Gelb und Rot zeigen, wo der Wert liegen soll. Gib einer Skala ein beliebiges Minimum und Maximum, lege das Hauptintervall und die Nebenstriche fest und füge farbige Bereiche für die wichtigen Bänder hinzu. Bereiche haben eigene Dicke und Beschriftung, und die Skala kann rückwärts laufen oder ihre Striche innen oder außen setzen. Bereiche werden auf der Skala selbst gezeichnet, sodass sie ohne Zusatzaufwand auch in der PNG- und SVG-Ausgabe und in beiden Themes erscheinen.
Scales[0].Ranges.Add mit StartValue, EndValue, Color, Thickness und CaptionTsgcGaugeScale: Minimum, Maximum, MajorInterval, MinorCount, ReversedLabelFormat und ShowLabels für die SkalenbeschriftungStartAngle und SweepAngle formen den Bogen eines radialen Gauges
Instrumente und Skalen
Füllstände, Temperaturen und der Fortschritt gegen ein Ziel sind von Natur aus linear. Ein lineares Gauge zeichnet drei Stile: einen einfachen Balken, ein Thermometer mit Kolben und einen Bullet-Graph, der den Wert mit einer Zielmarke vergleicht. Stelle es horizontal oder vertikal ein, passend zu einem Tank, einer Seitenleiste oder einer Tabellenzeile. Das Bullet-Ziel ist eine Eigenschaft und kein zusätzlicher Zeiger, sodass der Bullet-Graph auch in der kostenlosen Community Edition funktioniert. Ein kleines Gauge passt in eine Grid-Zelle oder eine Dashboard-Kachel.
LinearStyle: glsBar, glsThermometer oder glsBulletTarget zeichnet die Zielmarke des Bullet-Graphen, in jeder EditionOrientation und BulbSize
Instrumente und Skalen Nur Registered
Manche Messwerte ergeben nur nebeneinander Sinn: Ist gegen Soll, Eingang gegen Ausgang, Stunden und Minuten. Ein Gauge kann mehr als eine Skala und mehr als einen Zeiger tragen, und jeder Zeiger wählt seine Skala und seinen Stil: eine Nadel, eine Marke oder einen Balken. Schwellenwerte können jeden Zeiger überwachen. Ein Rundinstrument mit zwei Zeigern spart Platz auf vollen Panels und macht die Lücke zwischen Soll und Ist sofort sichtbar.
Pointers aus TsgcGaugePointer mit Kind, NeedleStyle, MarkerShape und ScaleIndexScales mit Radius und Offset pro SkalaPointerIndex an Schwellenwerten und Feed-BindungenCommunity zeichnet eine Skala und einen Zeiger pro Gauge; die registrierte Edition zeichnet alle.
Hilfethema lesenGauges, die reagieren: Schwellenwerte, Animation, Industrieanzeigen und Live-Feeds.
Alarme, Bewegung und Live-Daten
Ein Druck, der um seine Grenze pendelt, darf nicht hundert Alarme pro Minute auslösen. Ein Schwellenwert hat einen Wert, eine Richtung und ein Hysteresband: Er löst einmal aus, wenn der Wert die Grenze überschreitet, und scharf wird er erst wieder, nachdem der Wert um das Band zurückgegangen ist. OnThreshold läuft immer im Hauptthread, egal welcher Thread den Wert geschrieben hat, sodass du direkt eine LED einschalten oder eine Meldung zeigen kannst. Jeder Schwellenwert kann einen anderen Zeiger überwachen, sodass ein Gauge einen Hochalarm auf den Ist-Wert und einen Tiefalarm auf einen zweiten Messwert auslösen kann.
Thresholds aus TsgcGaugeThreshold mit Value, Hysteresis und DirectiongtdRising, gtdFalling oder gtdBothValueColor färbt den Werttext um, solange der Schwellenwert aktiv istAlarme, Bewegung und Live-Daten
Eine Nadel, die springt, wirkt kaputt, eine, die gleitet, wirkt wie ein Instrument. Jeder neue Wert wird über eine von dir gewählte Dauer vom alten aus animiert, mit einer von fünf Easing-Kurven, sodass eine plötzliche Änderung leicht zu verfolgen ist und ein Live-Feed nie flackert. Schalte die Animation für Prüfstände ab, die den Rohwert sofort brauchen. OnChange meldet dir, wann sich der Wert geändert hat, unabhängig von der Animation auf dem Bildschirm.
Animation (TsgcGaugeAnimation) mit Enabled und Duration, standardmäßig 300 msEasing: geLinear, geQuadOut, geCubicOut, geCubicInOut, geBackOutIsAnimating verrät, ob sich ein Zeiger noch bewegt
Alarme, Bewegung und Live-Daten
Schaltpulte sprechen ihre eigene visuelle Sprache. Das digitale Gauge zeichnet Ziffern mit 7 Segmenten, 14 Segmenten oder als Punktmatrix, wahlweise mit Geistersegmenten und Neigung. LEDs blinken, der LED-Balken hält seinen Spitzenwert, und der Annunciator zeigt ein Panel aus Alarmkacheln, die blinken, bis ein Bediener sie quittiert. Jede dieser Anzeigen hat dieselben Skalen, Schwellenwerte und Themes wie die anderen Gauges, sodass Alarme überall gleich funktionieren.
TsgcVCLDigitalGauge: DisplayType, Digits, ShowGhost, SkewTsgcVCLLEDGauge mit Blink und BlinkInterval; TsgcVCLLEDBarGauge mit PeakHoldTsgcVCLAnnunciatorGauge: Tiles, FlashInterval, Acknowledge, AcknowledgeAllCommunity hat Ziffern mit 7 Segmenten, LEDs und den LED-Balken. Die Anzeigen mit 14 Segmenten und als Punktmatrix sowie der Annunciator sind Registered.
Hilfethema lesenAlarme, Bewegung und Live-Daten Nur Registered
In einer IoT-Konsole ist der meiste Code Rohrleitung: abonnieren, parsen, das Gauge finden, den Wert setzen. Die Brücke sgcGaugesWS beseitigt sie. Eine Feed-Quelle hängt sich an einen sgcWebSockets-Client, und jede Bindung ordnet ein Topic und einen JSON-Pfad einem Gauge-Zeiger zu. MQTT-Topic-Filter mit + und # werden unterstützt, und ein Filterpfad wählt ein Gerät aus einem gemeinsamen Strom. Mehrere Bindungen können sich eine Quelle teilen, sodass eine einzige Broker-Verbindung ein ganzes Panel antreibt.
TsgcGaugeFeedSource_MQTT, TsgcGaugeFeedSource_WebSocket, TsgcGaugeFeedSource_SSEBindings aus TsgcGaugeFeedBinding: Gauge, PointerIndex, Topic, ValuePathFilterPath und FilterValue wählen Nachrichten ausOnValue und OnError an der QuelleDie Brücke braucht sgcWebSockets. In Community setzt du Value aus deinem eigenen Code; das ist aus einem Hintergrundthread sicher.
Hilfethema lesenDasselbe Gauge auf einem Server und in jedem Theme.
Ausgabe und Aussehen
Gauges werden auch außerhalb des Bildschirms gebraucht: in einem Schichtbericht, einer Status-E-Mail oder einer Webseite, die dein Backend ausliefert. Jedes Gauge-Modell und jedes Steuerelement speichert sich ohne Formular als PNG oder SVG, sodass ein Konsolenprogramm, ein Windows-Dienst oder ein Linux64-Server dasselbe Instrument rendern kann, das der Bediener sieht. Breite, Höhe und Skalierung sind Parameter, sodass ein Aufruf eine Miniatur für eine Liste und ein anderer ein scharfes 2x-Bild für einen Bericht erzeugt.
SaveToPNG und SaveToSVG an jedem Modell und SteuerelementTsgcRadialGauge und TsgcLinearGauge
Ausgabe und Aussehen
Ein Leitstand dimmt seine Bildschirme nachts, ein Büro bevorzugt einen hellen Look. Eine Eigenschaft schaltet ein Gauge zwischen dem hellen und dem dunklen Theme um, und die Farben von Zifferblatt, Skala, Beschriftung und Wert folgen. Gauges verwenden denselben Theme-Typ wie jedes sgcUI-Produkt, sodass sie gemeinsam mit Dashboards, Diagrammen und Grids umschalten. Bereiche behalten in beiden Themes ihre eigenen Farben, sodass Grün auch nachts normal bedeutet. Die Eigenschaft FormatSettings legt das Dezimaltrennzeichen der Anzeige unabhängig von der Locale des Benutzers fest.
Theme := utDark oder utLightFaceColor, BackgroundColor und Schriften lassen sich weiterhin pro Gauge setzenTitle, Units und ValueFormat für die AnzeigeOnFormatValue, um den Werttext selbst zu formatierenDie Vorschau zeigt genau das, was Drucker und PDF erhalten.
Drucken, Vorschau und PDF
Ein Instrument wird auf einer Seite gedruckt wie auf dem Bildschirm, mit seinen Skalen, Bereichen, Schwellenwerten, Zeigern und Texten. Es wird mit seinem Endwert gedruckt, sodass eine laufende Animation nie halb fertig auf dem Papier erscheint, und auf dem Bildschirm läuft sie weiter.
Print zeigt den Druckdialog oder druckt direkt auf dem Standarddrucker, und ShowPrintPreview öffnet eine Vorschau mit Seitennavigation, Zoom, Seiteneinrichtung, Drucken und PDF-ExportPrintSettings enthält Papier, Ausrichtung, Ränder, Skalierung sowie Kopf- und Fußzeilentext, und Drucker, Vorschau und PDF verwenden alle dieselben EinstellungenExportToPDF schreibt das Instrument als Vektorgrafik mit echtem Text, standardmäßig als getaggtes PDF/UA, mit einem Alternativtext, der die Beschriftung, den Wert mit seiner Einheit und den Bereich vorliestPDFALevel von TsgcUIPDFOptions ergänzt PDF/A-2a oder PDF/A-3a für die Archivierung, allein oder zusammen mit PDF/UADrucken und die Vorschau sind in jeder Edition enthalten, auch in der kostenlosen Community-Edition, unter VCL, FireMonkey, WinForms, WPF und Avalonia. In FireMonkey funktioniert das Drucken unter Windows und macOS, die Vorschau und der PDF-Export auf jeder Plattform. Der PDF-Export erfordert die sgcUIPDF-Brücke und ein lizenziertes sgcPDF (unter .NET das NuGet-Paket esegece.sgcUICore.sgcPDF) und ist daher nicht in der Community-Edition enthalten.
UI Automation für Screenreader und hohen Kontrast, ohne Einrichtung.
Barrierefreiheit
Jede Instrumentenart stellt ihre Beschriftung, ihren Wert und ihren Bereich über Microsoft UI Automation bereit, und die Schwellenwerte werden als Ansagen ausgelöst. Das Instrument beschreibt sich mit derselben Textalternative, die es in ein barrierefreies PDF schreibt.
TabStop auf True, wenn Tastaturnutzer auf einem Instrument landen sollenBarrierefreiheit ist in jeder Edition standardmäßig aktiv, auch in der kostenlosen Community-Edition, unter VCL in jeder Delphi- und C++Builder-Version von Delphi 7 bis Delphi 13, in FireMonkey unter Windows sowie unter WinForms, WPF und Avalonia. In Delphi und C++Builder legen AccessibleName und AccessibleDescription den Namen und die Beschreibung fest, die über UI Automation bereitgestellt werden, und unter .NET leisten der Standardname und der Standard-Hilfetext des jeweiligen Frameworks dasselbe. Siehe die Konformitätsberichte zur Barrierefreiheit.
sgcGauges in den sgcUI-Suite-Demos: vollständige Anwendungen, die offline mit integrierten Simulationsdaten laufen.
Radial-, Linear- und LED-Instrumente für jeden Messwert einer Pumpe.
Altamira Plant →
Geschwindigkeits-, Kompass- und Kühltemperatur-Instrumente eines Lkw.
Altamira Fleet →
Ein radiales VaR-Instrument, Exposure-Balken, ein Fortschrittsring und blinkende Alarmkacheln.
Altamira Markets →
Ein radiales Instrument für das Quartalsziel und lineare Instrumente pro Region.
Altamira ERP →
Eine Werks-HMI zeigt zwei Tanks mit Füllstand-Gauges, Pumpen-LEDs, Druckanzeigen mit roten Bändern und ein Annunciator-Panel für Alarme. Schwellenwerte mit Hysterese lösen jeden Alarm einmal aus, der Annunciator blinkt, bis der Bediener quittiert, und die Nachtschicht schaltet auf das dunkle Theme.
Eine Telemetriekonsole abonniert einen Broker und zeigt sechs Live-Messwerte von Feldgeräten. Bindungen ordnen jedes Topic und jedes JSON-Feld einem Zeiger zu, die Nadeln gleiten zu jedem neuen Wert, und es wird kein Code zur Nachrichtenverarbeitung von Hand geschrieben. Dieselben Gauges werden für die tägliche Status-Mail als PNG gerendert.
Ein Management-Dashboard setzt Gauges in Kacheln neben KPI-Karten und Diagramme: die Auslastung als Fortschrittsring, die Lieferzeit als Bullet-Graph gegen ihr Ziel und das Service-Level als Rundinstrument mit farbigen Bändern. Alles folgt einer Theme-Eigenschaft, und die Gauges passen sich der Größe ihrer Kacheln an.
Dieselbe API in Delphi, C++ Builder und C#: ein radiales Druck-Gauge mit rotem Band und einem Alarmschwellenwert, ein Bullet-Füllstand-Gauge und eine blinkende Alarm-LED.
Ein radiales Druck-Gauge mit rotem Band und einem Alarmschwellenwert, ein Bullet-Füllstand-Gauge und eine blinkende Alarm-LED auf einem VCL-Formular.
uses
SysUtils, Classes, Controls, Forms, sgcUICore_Theme,
sgcGauges_Types, sgcGauges_Model, sgcGauges_VCL;
type
TTankPanel = class(TComponent)
public
Pressure: TsgcVCLRadialGauge;
Level: TsgcVCLLinearGauge;
Alarm: TsgcVCLLEDGauge;
procedure PressureThreshold(Sender: TObject; aThreshold: TsgcGaugeThreshold;
aValue: Double; aRising: Boolean);
end;
procedure TTankPanel.PressureThreshold(Sender: TObject;
aThreshold: TsgcGaugeThreshold; aValue: Double; aRising: Boolean);
begin
// runs in the main thread, whatever thread wrote the value
Alarm.Active := aRising;
end;
function CreateTankPanel(aForm: TForm): TTankPanel;
begin
Result := TTankPanel.Create(aForm);
Result.Pressure := TsgcVCLRadialGauge.Create(aForm);
Result.Pressure.Parent := aForm;
Result.Pressure.SetBounds(16, 16, 240, 240);
Result.Pressure.Title := 'Pressure';
Result.Pressure.Units := 'bar';
Result.Pressure.Theme := utDark;
Result.Pressure.Scales[0].Maximum := 10;
Result.Pressure.Scales[0].MajorInterval := 2;
with Result.Pressure.Scales[0].Ranges.Add do
begin
StartValue := 8;
EndValue := 10;
Color := $FFE34948;
end;
with Result.Pressure.Thresholds.Add do
begin
Value := 8;
Hysteresis := 0.5;
Direction := gtdBoth;
end;
Result.Pressure.Animation.Easing := geCubicOut;
Result.Pressure.OnThreshold := Result.PressureThreshold;
Result.Level := TsgcVCLLinearGauge.Create(aForm);
Result.Level.Parent := aForm;
Result.Level.SetBounds(272, 16, 320, 110);
Result.Level.Title := 'Tank level';
Result.Level.Units := '%';
Result.Level.LinearStyle := glsBullet;
Result.Level.Target := 80;
Result.Alarm := TsgcVCLLEDGauge.Create(aForm);
Result.Alarm.Parent := aForm;
Result.Alarm.SetBounds(272, 140, 64, 64);
Result.Alarm.OnColor := $FFE34948;
Result.Alarm.Blink := True;
Result.Level.Value := 62;
Result.Pressure.Value := 6.5;
// the same drawing code exports the gauge to PNG at twice its size
Result.Pressure.SaveToPNG(ExtractFilePath(ParamStr(0)) + 'pressure.png', 2);
end;Dasselbe Panel in C++ Builder mit den generierten Headern.
#include <vcl.h>
#include "sgcUICore_Theme.hpp"
#include "sgcGauges_Types.hpp"
#include "sgcGauges_Model.hpp"
#include "sgcGauges_VCL.hpp"
class TTankPanel : public TObject
{
public:
TsgcVCLRadialGauge *Pressure;
TsgcVCLLinearGauge *Level;
TsgcVCLLEDGauge *Alarm;
void __fastcall PressureThreshold(TObject *Sender,
TsgcGaugeThreshold *aThreshold, double aValue, bool aRising);
};
void __fastcall TTankPanel::PressureThreshold(TObject *Sender,
TsgcGaugeThreshold *aThreshold, double aValue, bool aRising)
{
// runs in the main thread, whatever thread wrote the value
Alarm->Active = aRising;
}
TTankPanel * __fastcall CreateTankPanel(TForm *Form)
{
TTankPanel *P = new TTankPanel();
P->Pressure = new TsgcVCLRadialGauge(Form);
P->Pressure->Parent = Form;
P->Pressure->SetBounds(16, 16, 240, 240);
P->Pressure->Title = "Pressure";
P->Pressure->Units = "bar";
P->Pressure->Theme = utDark;
P->Pressure->Scales->Items[0]->Maximum = 10;
P->Pressure->Scales->Items[0]->MajorInterval = 2;
TsgcGaugeRange *R = P->Pressure->Scales->Items[0]->Ranges->Add();
R->StartValue = 8;
R->EndValue = 10;
R->Color = 0xFFE34948;
TsgcGaugeThreshold *T = P->Pressure->Thresholds->Add();
T->Value = 8;
T->Hysteresis = 0.5;
T->Direction = gtdBoth;
P->Pressure->Animation->Easing = geCubicOut;
P->Pressure->OnThreshold = P->PressureThreshold;
P->Level = new TsgcVCLLinearGauge(Form);
P->Level->Parent = Form;
P->Level->SetBounds(272, 16, 320, 110);
P->Level->Title = "Tank level";
P->Level->Units = "%";
P->Level->LinearStyle = glsBullet;
P->Level->Target = 80;
P->Alarm = new TsgcVCLLEDGauge(Form);
P->Alarm->Parent = Form;
P->Alarm->SetBounds(272, 140, 64, 64);
P->Alarm->OnColor = 0xFFE34948;
P->Alarm->Blink = true;
P->Level->Value = 62;
P->Pressure->Value = 6.5;
// the same drawing code exports the gauge to PNG at twice its size
P->Pressure->SaveToPNG(ExtractFilePath(ParamStr(0)) + "pressure.png", 2);
return P;
}Die WinForms-Version in C#, mit denselben Klassennamen wie in Delphi.
using System;
using System.Drawing;
using System.Windows.Forms;
using esegece.sgcGauges;
using esegece.sgcUICore;
public class TankForm : Form
{
private readonly TsgcWinFormsRadialGauge pressure;
private readonly TsgcWinFormsLinearGauge level;
private readonly TsgcWinFormsLEDGauge alarm;
public TankForm()
{
ClientSize = new Size(610, 270);
pressure = new TsgcWinFormsRadialGauge { Bounds = new Rectangle(10, 10, 240, 240) };
pressure.Title = "Pressure";
pressure.Units = "bar";
pressure.Theme = TsgcUITheme.utDark;
pressure.Scales[0].Maximum = 10;
pressure.Scales[0].MajorInterval = 2;
TsgcGaugeRange red = pressure.Scales[0].Ranges.Add();
red.StartValue = 8;
red.EndValue = 10;
red.Color = 0xFFE34948;
TsgcGaugeThreshold limit = pressure.Thresholds.Add();
limit.Value = 8;
limit.Hysteresis = 0.5;
limit.Direction = TsgcGaugeThresholdDirection.gtdBoth;
pressure.Animation.Easing = TsgcGaugeEasing.geCubicOut;
level = new TsgcWinFormsLinearGauge { Bounds = new Rectangle(260, 10, 340, 110) };
level.Title = "Tank level";
level.Units = "%";
level.LinearStyle = TsgcGaugeLinearStyle.glsBullet;
level.Target = 80;
alarm = new TsgcWinFormsLEDGauge { Bounds = new Rectangle(260, 130, 64, 64) };
alarm.OnColor = 0xFFE34948;
alarm.Blink = true;
// OnThreshold runs in the UI thread, whatever thread wrote the value
pressure.OnThreshold = (sender, threshold, value, rising) => alarm.Active = rising;
Controls.AddRange(new Control[] { pressure, level, alarm });
level.Value = 62;
pressure.Value = 6.5;
}
}dotnet add package esegece.sgcGauges.WinFormsGallery, GalleryFMX, Headless, HMIPanel, DashboardGauges und MQTTLive für Delphi und C++ Builder. Die .NET-Demos sind Gallery (WinForms), GalleryWpf, GalleryAvalonia, ConsoleRender, HMIPanel und MQTTLive.
Zehn Gauges mit Theme-Wechsel, Animation, einem Simulationsmodus, einem Schwellenwert bei 200 km/h mit Alarm-LED, Annunciator-Quittierung und PNG-Export in 2x.
Zwei Tanks mit Pumpen, Füllständen, Drücken und Annunciator-Alarmen, das Layout eines typischen Prozessbildschirms.
Sechs Gauges in sgcDashboard-Kacheln, die dem Dashboard-Theme folgen. Baut mit der Community Edition.
Ein Konsolenprogramm, das PNG und SVG unter Win32, Win64 und Linux64 schreibt.
Die Galerie unter FireMonkey, für Windows und Android.
Sechs Gauges, über die Brücke sgcGaugesWS per MQTT gespeist. Braucht sgcWebSockets und einen Broker.
Sofort lauffähige Programme jedes sgcUI-Produkts, nichts zu installieren.
sgcUI_bin.zip herunterladen →sgcGauges ist in den Editionen sgcUI Professional und Enterprise enthalten und wird auch einzeln verkauft. sgcGauges ist außerdem im All-Access-Paket enthalten.
€199 / Entwickler, voller Quellcode, 1 Jahr Updates.
sgcGauges kaufen → Preise ansehen →Standard plus sgcGauges, sgcCharts und sgcDashboard, ab €529.
Professional ansehen →Die kostenlose Community Edition (esegece.sgcGauges.Community auf NuGet) hat die Gauges radial, linear, digital mit 7 Segmenten, LED, LED-Balken und Fortschrittsring, mit Bereichen, Schwellenwerten, Animation, Themes und Headless-Ausgabe. Sie hat kein VU-Meter, keine Uhr, keinen Kompass und keinen Annunciator, keine zusätzlichen Skalen oder Zeiger und keine Brücke sgcGaugesWS.
| Funktion | Community (kostenlos) | Registered |
|---|---|---|
| Radial, linear, digital mit 7 Segmenten, LED, LED-Balken und Fortschrittsring | ✓ | ✓ |
| Bereiche, Schwellenwerte, Animation und Themes | ✓ | ✓ |
| Headless-Ausgabe als PNG und SVG | ✓ | ✓ |
| VU-Meter, Uhr, Kompass und Annunciator | − | ✓ |
| Mehrere Skalen und Zeiger pro Gauge | − | ✓ |
| Anzeigen mit 14 Segmenten und als Punktmatrix | − | ✓ |
| Brücke sgcGaugesWS (MQTT, WebSocket, SSE) | − | ✓ |
Jedes Gauge hat ein frameworkneutrales Modell für das Headless-Rendering, ein VCL-Steuerelement (auch aus C++ Builder nutzbar), ein FireMonkey-Steuerelement sowie Steuerelemente für WinForms, WPF und Avalonia.
| Gauge | VCL und C++ Builder | FireMonkey | .NET |
|---|---|---|---|
| Radial | TsgcVCLRadialGauge | TsgcFMXRadialGauge | TsgcWinFormsRadialGauge |
| Linear (Balken, Thermometer, Bullet) | TsgcVCLLinearGauge | TsgcFMXLinearGauge | TsgcWpfLinearGauge |
| Digital (7 Segmente, 14 Segmente, Punktmatrix) | TsgcVCLDigitalGauge | TsgcFMXDigitalGauge | TsgcWinFormsDigitalGauge |
| LED | TsgcVCLLEDGauge | TsgcFMXLEDGauge | TsgcWinFormsLEDGauge |
| LED-Balken | TsgcVCLLEDBarGauge | TsgcFMXLEDBarGauge | TsgcWinFormsLEDBarGauge |
| Fortschrittsring | TsgcVCLProgressRingGauge | TsgcFMXProgressRingGauge | TsgcWinFormsProgressRingGauge |
| VU-Meter | TsgcVCLVUMeterGauge | TsgcFMXVUMeterGauge | TsgcWinFormsVUMeterGauge |
| Uhr | TsgcVCLClockGauge | TsgcFMXClockGauge | TsgcWinFormsClockGauge |
| Kompass | TsgcVCLCompassGauge | TsgcFMXCompassGauge | TsgcWpfCompassGauge |
| Annunciator | TsgcVCLAnnunciatorGauge | TsgcFMXAnnunciatorGauge | TsgcAvaloniaAnnunciatorGauge |
Die .NET-Spalte zeigt ein Beispiel pro Gauge, jedes Gauge gibt es als TsgcWinForms, TsgcWpf und TsgcAvalonia. Alle Gauges teilen die Basisklasse TsgcCustomGauge mit den Sammlungen Scales, Pointers, Thresholds und Ranges. Die frameworkneutralen Modelle (TsgcRadialGauge, TsgcLinearGauge und so weiter) rendern ohne Fenster.
| Ziel | Komponente | Plattformen |
|---|---|---|
| Delphi 7 bis 13, VCL | TsgcVCL-Gauges | Win32 und Win64 ab XE2 |
| Delphi XE6 bis 13, FireMonkey | TsgcFMX-Gauges | Windows, macOS, iOS und Android |
| C++ Builder 2007 bis 13 | TsgcVCL-Gauges | Generierte .hpp-Header und statische Bibliotheken |
| Delphi 10.2 bis 13, frameworkneutral | Gauge-Modelle und Headless-Ausgabe als PNG und SVG | Linux64 (keine Linux-Steuerelemente) |
| .NET Framework 4.7.2, .NET 8, 9 und 10 | Gauges für WinForms, WPF und Avalonia | Windows-Desktop, Avalonia-Ziele, Headless-Rendering |
Ja. Setze Value aus dem Thread, der die Daten empfängt. Schwellenwerte werden für dich ausgewertet, und OnThreshold wird immer im Hauptthread ausgelöst, sodass ein Handler Steuerelemente ohne zusätzliche Synchronisierung aktualisieren kann. Die Brücke sgcGaugesWS tut dasselbe, wenn sie Zeiger aus MQTT, WebSocket oder SSE speist.
Die Gauges radial, linear, digital mit 7 Segmenten, LED, LED-Balken und Fortschrittsring, mit Bereichen, Schwellenwerten, Animation, Themes und Headless-Ausgabe. VU-Meter, Uhr, Kompass, Annunciator, zusätzliche Skalen und Zeiger, Ziffern mit 14 Segmenten und als Punktmatrix sowie die Brücke sind Registered. Siehe Editionen.
Ja, mit der registrierten Edition und sgcWebSockets. Lege eine TsgcGaugeFeedSource_MQTT auf das Formular, verknüpfe deinen MQTT-Client und füge pro Gauge eine Bindung mit dem Topic und dem JSON-ValuePath hinzu. Topic-Filter mit + und # funktionieren, und FilterPath wählt ein Gerät aus einem gemeinsamen Topic.
Die FireMonkey-Steuerelemente funktionieren ab Delphi XE6, und die Demo GalleryFMX läuft auf Windows und Android. Unter Linux64 ist sgcGauges nur headless: Die Modelle kompilieren und rendern ab Delphi 10.2 PNG und SVG, aber es gibt keine Linux-Steuerelemente.
Ja. Jede Skala hat ihr eigenes Minimum, Maximum, MajorInterval und ihre Nebenstriche sowie beliebig viele farbige Bereiche mit Anfang, Ende, Farbe, Dicke und Beschriftung. Bei einem radialen Gauge kannst du außerdem Start- und Öffnungswinkel des Bogens wählen.
Ja. SaveToPNG und SaveToSVG funktionieren bei jedem Steuerelement und jedem Modell ohne Fenster, sodass ein Dienst oder ein Linux64-Server die aktuellen Messwerte in ein PDF oder eine E-Mail setzen kann. Die Gallery-Demo exportiert PNG auch in 2x.
Das digitale Gauge richtet seine Größe nach der Skala: Mit Digits auf 0 reserviert es so viele Ziffern, wie das Skalenmaximum braucht, und die Standardskala läuft von 0 bis 100. Setze Scales[0].Maximum auf den größten erwarteten Wert oder setze Digits ausdrücklich.
Einführung, Gauge-Typen, Schnellstart VCL, Schwellenwerte, Animation, Bereiche, Radiales Gauge, Brücke sgcGaugesWS, Headless-Rendering, Editionen.
Delphi, C++ Builder und .NET, mit allen sgcUI-Produkten.
Setze Gauges in Dashboard-Kacheln neben KPI-Karten; die Demo DashboardGauges zeigt, wie.
sgcDashboard entdecken →
Zeige den Trend hinter jedem Messwert mit einem Live-Diagramm neben dem Gauge.
sgcCharts entdecken →
Lass Bediener Grenzwerte und Sollwerte mit Schiebereglern und Spin-Edits einstellen.
sgcEditors entdecken →Speise die Gauges mit der Brücke sgcGaugesWS aus MQTT, WebSocket oder SSE.
sgcWebSockets entdecken →