Zestien metertypen voor dashboards en HMI-panelen, van een radiale wijzerplaat tot een processtank, een pompsymbool en een annunciator, plus een draaiknop, een schuifregelaar, een schakelaar en een drukknop die de gebruiker bedient. Teken groene, oranje en rode banden, geef een alarm wanneer een waarde een grens overschrijdt, laat de naald soepel naar elke nieuwe meting glijden en render dezelfde meter naar PNG of SVG op een server.
Dertien mogelijkheden in vijf groepen, met de echte klasse- en eigenschapsnamen en een link naar elk helponderwerp. Functies met het label Geregistreerd zitten niet in de gratis .NET Community-build.
Zestien typen op één model, met bereiken, stijlen, skins en meerdere wijzers.
Instrumenten en schalen
Dashboards, HMI-panelen en testbanken hebben verschillende instrumenten nodig: een wijzerplaat voor snelheid, een balk voor niveau, een digitale uitlezing voor frequentie, een lampje voor een pomp, een tegelpaneel voor alarmen. sgcGauges levert zestien typen, twaalf weergaven en vier invoermeters, die één model delen, met dezelfde schalen, wijzers, bereiken, drempels en thema's. Leer één API en elk instrument gedraagt zich hetzelfde.
TsgcVCLRadialGauge, TsgcVCLLinearGauge, TsgcVCLDigitalGauge, TsgcVCLLEDGauge, TsgcVCLLEDBarGauge, TsgcVCLProgressRingGaugeTsgcVCLVUMeterGauge, TsgcVCLClockGauge, TsgcVCLCompassGauge, TsgcVCLAnnunciatorGaugeTsgcVCLTankGauge en TsgcVCLSymbolGauge voor processchermenTsgcRadialGauge, voor headless gebruikCommunity heeft de radiale, lineaire, digitale 7-segment-, LED-, LED-balk-, voortgangsring-, tank- en processymboolmeters. De VU-meter, klok, kompas en annunciator zijn geregistreerd.
Het helponderwerp lezen
Instrumenten en schalen
Een operator leest een meter in één oogopslag alleen als groen, oranje en rood aangeven waar de waarde hoort te zijn. Geef een schaal elk minimum en maximum, stel het hoofdinterval en de kleine streepjes in en voeg gekleurde bereiken toe voor de banden die ertoe doen. Bereiken hebben hun eigen dikte en bijschrift en de schaal kan omgekeerd lopen of zijn streepjes binnen of buiten plaatsen. Bereiken worden op de schaal zelf getekend, dus ze verschijnen ook in PNG- en SVG-uitvoer en in beide thema's zonder extra werk.
Scales[0].Ranges.Add met StartValue, EndValue, Color, Thickness en CaptionTsgcGaugeScale: Minimum, Maximum, MajorInterval, MinorCount, ReversedLabelFormat en ShowLabels voor de schaallabelsStartAngle en SweepAngle bepalen de boog van een radiale meter
Instrumenten en schalen
Niveaus, temperaturen en voortgang ten opzichte van een doel zijn van nature lineair. Eén lineaire meter tekent drie stijlen: een gewone balk, een thermometer met een bol en een bullet graph die de waarde vergelijkt met een doelmarkering. Zet hem horizontaal of verticaal om bij een tank, een zijbalk of een tabelrij te passen. Het bullet-doel is een eigenschap, geen extra wijzer, dus de bullet graph werkt ook in de gratis Community-editie. Een kleine meter past in een gridcel of een dashboardtegel.
LinearStyle: glsBar, glsThermometer of glsBulletTarget tekent de bullet-doelmarkering, in elke editieOrientation en BulbSize
Instrumenten en schalen Alleen geregistreerd
Sommige metingen hebben alleen naast elkaar betekenis: werkelijk tegenover doel, inlaat tegenover uitlaat, uren en minuten. Een meter kan meer dan één schaal en meer dan één wijzer hebben en elke wijzer kiest zijn schaal en stijl: een naald, een markering of een balk. Drempels kunnen elke wijzer bewaken. Een wijzerplaat met dubbele wijzer bespaart ruimte op drukke panelen en maakt het verschil tussen doel en werkelijk in één keer zichtbaar.
Pointers-collectie van TsgcGaugePointer met Kind, NeedleStyle, MarkerShape en ScaleIndexScales-collectie met Radius en Offset per schaalPointerIndex op drempels en feedkoppelingenCommunity tekent één schaal en één wijzer per meter; de geregistreerde editie tekent ze allemaal.
Het helponderwerp lezenInstrumenten en schalen
Een processcherm toont vaten en apparatuur, niet alleen wijzerplaten. De tankmeter tekent een vat met zijn niveau en de markeringen van de vier ISA-grenzen, HH, H, L en LL, en een hysterese houdt een grenstoestand vast tot het niveau er ruim vanaf is. De processymboolmeter tekent een klep, een pomp, een motor, een ventilator, een warmtewisselaar of een sensor in zijn toestand: uit, aan, storing, open, dicht of onderweg. Een draaiende pomp of ventilator draait mee, een storing knippert met een markering en een klep onderweg heeft een gestreepte rand, zodat de operator de toestand nooit alleen aan kleur afleest.
TsgcVCLTankGauge: Shape (staand, liggend, kegelbodem of bol), LimitHH, LimitH, LimitL, LimitLL, LimitHysteresis, LimitStateTsgcVCLSymbolGauge: Kind, State, Rotation, SpinPeriod, FlashIntervalValueMap voor installatiecodesDe tank en het processymbool zitten in elke editie, Community inbegrepen. Hun live feeds via de bridge zijn geregistreerd. Beide maken deel uit van het sgcUI HMI-pakket, samen met P&ID-symbolen, een ISA-18.2-alarmlijst en een aanraak-NumPad.
Het helponderwerp lezenMeters die reageren: drempels, animatie, industriële displays en live feeds.
Alarmen, beweging en live gegevens
Een druk die rond zijn grens schommelt, mag geen honderd alarmen per minuut afgeven. Een drempel heeft een waarde, een richting en een hysteresebandbreedte: hij wordt één keer geactiveerd wanneer de waarde de grens overschrijdt en wordt pas opnieuw gewapend nadat de waarde met de bandbreedte is teruggekeerd. OnThreshold draait altijd in de hoofdthread, welke thread de waarde ook schreef, dus je kunt rechtstreeks een LED laten branden of een bericht tonen. Elke drempel kan een andere wijzer bewaken, zodat één meter een hoog alarm op de werkelijke waarde en een laag alarm op een tweede meting kan geven.
Thresholds van TsgcGaugeThreshold met Value, Hysteresis en DirectiongtdRising, gtdFalling of gtdBothValueColor kleurt de waardetekst opnieuw zolang de drempel actief isAlarmen, beweging en live gegevens
Een naald die springt, ziet er kapot uit, een naald die glijdt ziet eruit als een instrument. Elke nieuwe waarde animeert vanaf de oude gedurende een duur die je kiest, met een van vijf versnellingscurves, zodat een plotselinge verandering makkelijk te volgen is en een live feed nooit flikkert. Zet animatie uit voor testbanken die de ruwe waarde meteen nodig hebben. OnChange meldt wanneer de waarde is veranderd, onafhankelijk van de animatie op het scherm.
Animation (TsgcGaugeAnimation) met Enabled en Duration, standaard 300 msEasing: geLinear, geQuadOut, geCubicOut, geCubicInOut, geBackOutIsAnimating geeft aan of een wijzer nog beweegt
Alarmen, beweging en live gegevens
Bedieningspanelen hebben hun eigen visuele taal. De digitale meter tekent cijfers in 7-segment, 14-segment of puntmatrix met optionele spooksegmenten en schuine stand. LED's knipperen, de LED-balk houdt zijn piek vast en de annunciator toont een paneel met alarmtegels die knipperen totdat een operator ze bevestigt. Elk van deze displays heeft dezelfde schalen, drempels en thema's als de andere meters, zodat alarmen overal hetzelfde werken.
TsgcVCLDigitalGauge: DisplayType, Digits, ShowGhost, SkewTsgcVCLLEDGauge met Blink en BlinkInterval; TsgcVCLLEDBarGauge met PeakHoldTsgcVCLAnnunciatorGauge: Tiles, FlashInterval, Acknowledge, AcknowledgeAllCommunity heeft 7-segmentcijfers, LED's en de LED-balk. De 14-segment- en puntmatrixdisplays en de annunciator zijn geregistreerd.
Het helponderwerp lezenAlarmen, beweging en live gegevens Alleen geregistreerd
In een IoT-console bestaat het grootste deel van de code uit loodgieterswerk: abonneren, parsen, de meter zoeken, de waarde instellen. De sgcGaugesWS-bridge neemt dat weg. Een feedbron hecht zich aan een sgcWebSockets-client en elke koppeling wijst een topic en een JSON-pad toe aan een meterwijzer. MQTT-topicfilters met + en # worden ondersteund en een filterpad kiest één apparaat uit een gedeelde stream. Meerdere koppelingen kunnen één bron delen, zodat één brokerverbinding een heel paneel aanstuurt.
TsgcGaugeFeedSource_MQTT, TsgcGaugeFeedSource_WebSocket, TsgcGaugeFeedSource_SSEBindings van TsgcGaugeFeedBinding: Gauge, PointerIndex, Topic, ValuePathFilterPath en FilterValue selecteren berichtenOnValue en OnError op de bronValueMap zet installatiecodes, zoals een PLC-bit of RUNNING, om in de toestanden van een processymboolDe bridge vereist sgcWebSockets. Stel in Community Value in vanuit je eigen code; dat is veilig vanuit een achtergrondthread.
Het helponderwerp lezenDezelfde meter op een server en in elk thema.
Uitvoer en uiterlijk
Meters zijn ook buiten het scherm nodig: in een ploegenrapport, een statusmail of een webpagina die je backend levert. Elk metermodel en elk besturingselement slaat zichzelf op als PNG of SVG zonder formulier, zodat een consoleprogramma, een Windows-service of een Linux64-server hetzelfde instrument kan renderen dat de operator ziet. Breedte, hoogte en schaal zijn parameters, dus één aanroep levert een miniatuur voor een lijst en een andere een scherpe 2x-afbeelding voor een rapport.
SaveToPNG en SaveToSVG op elk model en besturingselementTsgcRadialGauge en TsgcLinearGauge
Uitvoer en uiterlijk
Een controlekamer dimt 's nachts zijn schermen, een kantoor geeft de voorkeur aan een helder uiterlijk. Eén eigenschap schakelt een meter tussen het lichte en het donkere thema en de kleuren van wijzerplaat, schaal, labels en waarde volgen. Meters gebruiken hetzelfde thematype als elk sgcUI-product, dus ze schakelen samen met dashboards, grafieken en grids. Bereiken behouden in beide thema's hun eigen kleuren, zodat groen 's nachts nog steeds normaal betekent. De eigenschap FormatSettings legt het decimaalteken van de uitlezing vast, onafhankelijk van de landinstelling van de gebruiker.
Theme := utDark of utLightFaceColor, BackgroundColor en lettertypen kun je nog steeds per meter instellenTitle, Units en ValueFormat voor de uitlezingOnFormatValue om de waardetekst zelf te formatterenHet voorbeeld toont precies wat de printer en de PDF krijgen.
Afdrukken, voorbeeld en PDF
Een meter wordt op één pagina afgedrukt zoals op het scherm, met zijn schalen, bereiken, drempels, wijzers en teksten. Hij wordt afgedrukt met zijn eindwaarde, zodat een lopende animatie nooit halverwege op papier verschijnt, en op het scherm blijft zij doorlopen.
Print toont het afdrukdialoogvenster of drukt rechtstreeks af op de standaardprinter, en ShowPrintPreview opent een voorbeeld met paginanavigatie, zoom, pagina-instelling, afdrukken en PDF-exportPrintSettings bevat het papier, de afdrukstand, de marges, de schaal en de tekst van de kop- en voettekst, en de printer, het voorbeeld en de PDF gebruiken ze allemaalExportToPDF schrijft de meter als vectorafbeelding met echte tekst, standaard getagd PDF/UA, met een alternatieve tekst die het opschrift, de waarde met zijn eenheid en het bereik voorleestPDFALevel van TsgcUIPDFOptions voegt PDF/A-2a of PDF/A-3a toe voor archivering, alleen of samen met PDF/UAAfdrukken en het voorbeeld zitten in elke editie, ook in de gratis Community-editie, op VCL, FireMonkey, WinForms, WPF en Avalonia. In FireMonkey werkt afdrukken op Windows en macOS, en het voorbeeld en de PDF-export op elk platform. De PDF-export vereist de sgcUIPDF-bridge en een gelicentieerde sgcPDF (in .NET het NuGet-pakket esegece.sgcUICore.sgcPDF) en zit dus niet in de Community-editie.
UI Automation voor schermlezers en hoog contrast, zonder configuratie.
Toegankelijkheid
Elk metertype biedt zijn bijschrift, zijn waarde en zijn bereik aan Microsoft UI Automation aan, en de drempels worden als meldingen doorgegeven. De meter beschrijft zichzelf met hetzelfde tekstalternatief dat hij in een toegankelijke PDF schrijft.
TabStop op True wanneer toetsenbordgebruikers op een meter moeten kunnen landenToegankelijkheid staat standaard aan in elke editie, ook in de gratis Community-editie, op VCL in elke Delphi- en C++Builder-versie van Delphi 7 tot en met Delphi 13, op FireMonkey op Windows, en op WinForms, WPF en Avalonia. In Delphi en C++Builder stellen AccessibleName en AccessibleDescription de naam en de beschrijving in die aan UI Automation worden aangeboden, en in .NET doen de standaard toegankelijke naam en helptekst van elk framework hetzelfde. Zie de toegankelijkheidsrapporten.
sgcGauges in de sgcUI suite-demo's: complete applicaties die offline draaien met ingebouwde gesimuleerde gegevens.
Radiale, lineaire en LED-meters voor elke meetwaarde van één pomp.
Altamira Plant →
Snelheids-, kompas- en koeltemperatuurmeters van een vrachtwagen.
Altamira Fleet →
Een radiale VaR-meter, blootstellingsbalken, een voortgangsring en knipperende alarmtegels.
Altamira Markets →
Een radiale kwartaaldoelmeter en lineaire meters per regio.
Altamira ERP →
Een fabrieks-HMI toont twee tanks met niveaumeters, pomp-LED's, drukmeters met rode banden en een annunciatorpaneel voor alarmen. Drempels met hysterese geven elk alarm één keer af, de annunciator knippert totdat de operator hem bevestigt en de nachtploeg schakelt over op het donkere thema.
Een telemetrieconsole abonneert zich op een broker en toont zes live metingen van veldapparaten. Koppelingen wijzen elk topic en elk JSON-veld toe aan een wijzer, de naalden glijden naar elke nieuwe waarde en er wordt geen berichtafhandelingscode met de hand geschreven. Dezelfde meters renderen als PNG voor de dagelijkse statusmail.
Een managementdashboard zet meters in tegels naast KPI-kaarten en grafieken: bezetting als voortgangsring, levertijd als bullet graph tegenover het doel en serviceniveau als wijzerplaat met gekleurde banden. Alles volgt één themaeigenschap en de meters passen zich aan hun tegels aan.
Dezelfde API in Delphi, C++ Builder en C#: een radiale drukmeter met een rode band en een alarmdrempel, een bullet-niveaumeter en een knipperende alarm-LED.
Een radiale drukmeter met een rode band en een alarmdrempel, een bullet-niveaumeter en een knipperende alarm-LED op een VCL-formulier.
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;Hetzelfde paneel in C++ Builder met de gegenereerde headers.
#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;
}De WinForms-versie in C#, met dezelfde klassenamen als 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 en MQTTLive voor Delphi en C++ Builder. De .NET-demo's zijn Gallery (WinForms), GalleryWpf, GalleryAvalonia, ConsoleRender, HMIPanel en MQTTLive.
Tien meters met een themaschakelaar, animatie, een simulatiemodus, een drempel bij 200 km/u met een alarm-LED, annunciatorbevestiging en PNG-export op 2x, plus de draaiknop-, schuifregelaar-, schakelaar- en drukknopmeters voor invoer.
Twee tanks met pompen, niveaus, drukken en annunciatoralarmen, de indeling van een typisch processcherm.
Zes meters in sgcDashboard-tegels, die het dashboardthema volgen. Bouwt met de Community-editie.
Een consoleprogramma dat PNG en SVG schrijft op Win32, Win64 en Linux64.
De galerij op FireMonkey, voor Windows en Android.
Zes meters gevoed door MQTT via de sgcGaugesWS-bridge. Vereist sgcWebSockets en een broker.
Direct uitvoerbare programma's van elk sgcUI-product, zonder installatie.
sgcUI_bin.zip downloaden →Vijf QuickStart-demo's voor Delphi (VCL) staan in Demos\Gauges\Delphi\00.QuickStart. De PDF-gids (Engels) legt ze stap voor stap uit: een eerste radiale gauge, schalen en gekleurde bereiken, drempelalarmen, thema's en skins en een monitor voor een pompstation.
sgcGauges zit in de sgcUI Professional- en Enterprise-edities en wordt ook los verkocht. sgcGauges is ook opgenomen in de All-Access-bundel.
€199 / ontwikkelaar, volledige broncode, 1 jaar updates.
sgcGauges kopen → Prijzen bekijken →Standard plus sgcGauges, sgcCharts en sgcDashboard, vanaf €529.
Professional bekijken →De gratis Community-editie (esegece.sgcGauges.Community op NuGet) heeft radiale, lineaire, digitale 7-segment-, LED-, LED-balk- en voortgangsringmeters met bereiken, drempels, animatie, thema's en headless uitvoer. Er is geen VU-meter, klok, kompas of annunciator, geen extra schalen of wijzers en geen sgcGaugesWS-bridge.
| Functie | Community (gratis) | Geregistreerd |
|---|---|---|
| Radiaal, lineair, digitaal 7-segment, LED, LED-balk en voortgangsring | ✓ | ✓ |
| Bereiken, drempels, animatie en thema's | ✓ | ✓ |
| Headless PNG- en SVG-uitvoer | ✓ | ✓ |
| VU-meter, klok, kompas en annunciator | − | ✓ |
| Meerdere schalen en wijzers per meter | − | ✓ |
| 14-segment- en puntmatrixdisplays | − | ✓ |
| sgcGaugesWS-bridge (MQTT, WebSocket, SSE) | − | ✓ |
Elke meter heeft een frameworkneutraal model voor headless rendering, een VCL-besturingselement (ook te gebruiken vanuit C++ Builder), een FireMonkey-besturingselement en WinForms-, WPF- en Avalonia-besturingselementen.
| Meter | VCL en C++ Builder | FireMonkey | .NET |
|---|---|---|---|
| Radiaal | TsgcVCLRadialGauge | TsgcFMXRadialGauge | TsgcWinFormsRadialGauge |
| Lineair (balk, thermometer, bullet) | TsgcVCLLinearGauge | TsgcFMXLinearGauge | TsgcWpfLinearGauge |
| Digitaal (7-segment, 14-segment, puntmatrix) | TsgcVCLDigitalGauge | TsgcFMXDigitalGauge | TsgcWinFormsDigitalGauge |
| LED | TsgcVCLLEDGauge | TsgcFMXLEDGauge | TsgcWinFormsLEDGauge |
| LED-balk | TsgcVCLLEDBarGauge | TsgcFMXLEDBarGauge | TsgcWinFormsLEDBarGauge |
| Voortgangsring | TsgcVCLProgressRingGauge | TsgcFMXProgressRingGauge | TsgcWinFormsProgressRingGauge |
| Tank | TsgcVCLTankGauge | TsgcFMXTankGauge | TsgcWpfTankGauge |
| Processymbool | TsgcVCLSymbolGauge | TsgcFMXSymbolGauge | TsgcAvaloniaSymbolGauge |
| VU-meter | TsgcVCLVUMeterGauge | TsgcFMXVUMeterGauge | TsgcWinFormsVUMeterGauge |
| Klok | TsgcVCLClockGauge | TsgcFMXClockGauge | TsgcWinFormsClockGauge |
| Kompas | TsgcVCLCompassGauge | TsgcFMXCompassGauge | TsgcWpfCompassGauge |
| Annunciator | TsgcVCLAnnunciatorGauge | TsgcFMXAnnunciatorGauge | TsgcAvaloniaAnnunciatorGauge |
De .NET-kolom toont één voorbeeld per meter, elke meter bestaat als TsgcWinForms, TsgcWpf en TsgcAvalonia. Alle meters delen de basisklasse TsgcCustomGauge met de collecties Scales, Pointers, Thresholds en Ranges. De frameworkneutrale modellen (TsgcRadialGauge, TsgcLinearGauge enzovoort) renderen zonder venster.
| Doel | Component | Platformen |
|---|---|---|
| Delphi 7 tot 13, VCL | TsgcVCL-meters | Win32, en Win64 vanaf XE2 |
| Delphi XE6 tot 13, FireMonkey | TsgcFMX-meters | Windows, macOS, iOS en Android |
| C++ Builder 2007 tot 13 | TsgcVCL-meters | Gegenereerde .hpp-headers en statische bibliotheken |
| Delphi 10.2 tot 13, frameworkneutraal | Metermodellen en headless PNG- en SVG-uitvoer | Linux64 (geen Linux-besturingselementen) |
| .NET Framework 4.7.2, .NET 8, 9 en 10 | WinForms-, WPF- en Avalonia-meters | Windows-desktop, Avalonia-doelen, headless rendering |
Ja. Stel Value in vanuit de thread die de gegevens ontvangt. Drempels worden voor je geëvalueerd en OnThreshold wordt altijd in de hoofdthread aangeroepen, zodat een handler besturingselementen kan bijwerken zonder extra synchronisatie. De sgcGaugesWS-bridge doet hetzelfde wanneer hij wijzers voedt vanuit MQTT, WebSocket of SSE.
De radiale, lineaire, digitale 7-segment-, LED-, LED-balk-, voortgangsring-, tank- en processymboolmeters, met bereiken, drempels, animatie, thema's en headless uitvoer. De VU-meter, klok, kompas, annunciator, extra schalen en wijzers, 14-segment- en puntmatrixcijfers en de bridge zijn geregistreerd. Zie Edities.
Ja, met de geregistreerde editie en sgcWebSockets. Zet een TsgcGaugeFeedSource_MQTT neer, koppel je MQTT-client en voeg per meter een koppeling toe met het Topic en het JSON-ValuePath. Topicfilters met + en # werken en FilterPath kiest één apparaat uit een gedeeld topic.
De FireMonkey-besturingselementen werken vanaf Delphi XE6 en de GalleryFMX-demo draait op Windows en Android. Op Linux64 is sgcGauges alleen headless: de modellen compileren en renderen PNG en SVG vanaf Delphi 10.2, maar er zijn geen Linux-besturingselementen.
Ja. Elke schaal heeft zijn eigen Minimum, Maximum, MajorInterval en kleine streepjes, en een willekeurig aantal gekleurde bereiken met begin, einde, kleur, dikte en bijschrift. Bij een radiale meter kun je ook de start- en veeghoek van de boog kiezen.
Ja. SaveToPNG en SaveToSVG werken op elk besturingselement en elk model, zonder venster, zodat een service of een Linux64-server de actuele metingen in een PDF of een e-mail kan zetten. De Gallery-demo exporteert ook PNG op 2x.
De digitale meter bepaalt zijn grootte uit de schaal: met Digits op 0 reserveert hij zoveel cijfers als het schaalmaximum nodig heeft en de standaardschaal loopt van 0 tot 100. Stel Scales[0].Maximum in op de grootste waarde die je verwacht, of stel Digits expliciet in.
Introductie, Metertypen, Snelstart VCL, Drempels, Animatie, Bereiken, Radiale meter, sgcGaugesWS-bridge, Headless rendering, Edities.
Delphi, C++ Builder en .NET, voor elk sgcUI-product.
Zet meters in dashboardtegels naast KPI-kaarten; de DashboardGauges-demo laat zien hoe.
sgcDashboard ontdekken →
Laat operators limieten en instelpunten instellen met schuifregelaars en draaiknoppen.
sgcEditors ontdekken →Voed de meters vanuit MQTT, WebSocket of SSE met de sgcGaugesWS-bridge.
sgcWebSockets ontdekken →