Dezesseis tipos de gauge para dashboards e painéis HMI, de um mostrador radial a um tanque de processo, um símbolo de bomba e um anunciador, mais um botão giratório, um controle deslizante, um interruptor e um botão de pressão que o usuário opera. Desenhe faixas verde, âmbar e vermelha, dispare um alarme quando um valor cruzar um limite, deixe o ponteiro deslizar até cada nova leitura e renderize o mesmo gauge em PNG ou SVG em um servidor.
Treze recursos em cinco grupos, com os nomes reais de classes e propriedades e um link para cada tópico de ajuda. Os recursos marcados como Registrada não estão na edição .NET Community gratuita.
Dezesseis tipos em um só modelo, com faixas, estilos, skins e vários ponteiros.
Instrumentos e escalas
Dashboards, painéis HMI e bancadas de teste precisam de instrumentos diferentes: um mostrador para velocidade, uma barra para nível, um display digital para frequência, uma lâmpada para uma bomba, um painel de tiles para alarmes. O sgcGauges traz dezesseis tipos, doze displays e quatro indicadores de entrada, que compartilham um só modelo, com as mesmas escalas, ponteiros, faixas, limites e temas. Aprenda uma API e todos os instrumentos se comportam da mesma forma.
TsgcVCLRadialGauge, TsgcVCLLinearGauge, TsgcVCLDigitalGauge, TsgcVCLLEDGauge, TsgcVCLLEDBarGauge, TsgcVCLProgressRingGaugeTsgcVCLVUMeterGauge, TsgcVCLClockGauge, TsgcVCLCompassGauge, TsgcVCLAnnunciatorGaugeTsgcVCLTankGauge e TsgcVCLSymbolGauge para telas de processoTsgcRadialGauge, para uso headlessA Community tem os gauges radial, linear, digital de 7 segmentos, LED, barra LED, anel de progresso, tanque e símbolo de processo. O VU meter, o relógio, a bússola e o anunciador são da edição Registrada.
Ler o tópico da ajuda
Instrumentos e escalas
Um operador lê um gauge de relance apenas quando verde, âmbar e vermelho indicam onde o valor deveria estar. Dê à escala qualquer mínimo e máximo, defina o intervalo principal e as marcas secundárias e adicione faixas coloridas para as zonas que importam. As faixas têm espessura e legenda próprias, e a escala pode ser invertida ou colocar suas marcas por dentro ou por fora. As faixas são desenhadas na própria escala, então também aparecem na saída PNG e SVG e nos dois temas sem trabalho extra.
Scales[0].Ranges.Add com StartValue, EndValue, Color, Thickness e CaptionTsgcGaugeScale: Minimum, Maximum, MajorInterval, MinorCount, ReversedLabelFormat e ShowLabels para os rótulos da escalaStartAngle e SweepAngle definem o arco de um gauge radial
Instrumentos e escalas
Níveis, temperaturas e progresso em relação a uma meta são lineares por natureza. Um gauge linear desenha três estilos: uma barra simples, um termômetro com bulbo e um bullet graph que compara o valor com um marcador de meta. Coloque-o na horizontal ou na vertical para caber em um tanque, em uma barra lateral ou na linha de uma tabela. A meta do bullet é uma propriedade, não um ponteiro extra, então o bullet graph funciona também na edição Community gratuita. Um gauge pequeno cabe em uma célula de grade ou em um tile de dashboard.
LinearStyle: glsBar, glsThermometer ou glsBulletTarget desenha o marcador de meta do bullet, em todas as ediçõesOrientation e BulbSize
Instrumentos e escalas Somente Registrada
Algumas leituras só fazem sentido lado a lado: real contra meta, entrada contra saída, horas e minutos. Um gauge pode ter mais de uma escala e mais de um ponteiro, e cada ponteiro escolhe sua escala e seu estilo: uma agulha, um marcador ou uma barra. Os limites podem acompanhar qualquer ponteiro. Um mostrador de ponteiro duplo economiza espaço em painéis cheios e deixa a diferença entre meta e valor real visível de uma vez.
Pointers de TsgcGaugePointer com Kind, NeedleStyle, MarkerShape e ScaleIndexScales com Radius e Offset por escalaPointerIndex nos limites e nas ligações de feedA Community desenha uma escala e um ponteiro por gauge; a edição Registrada desenha todos.
Ler o tópico da ajudaInstrumentos e escalas
Uma tela de processo mostra vasos e equipamentos, não apenas mostradores. O gauge de tanque desenha um vaso com o seu nível e as marcas dos quatro limites ISA, HH, H, L e LL, e uma histerese mantém um estado de limite até o nível se afastar dele. O gauge de símbolo de processo desenha uma válvula, uma bomba, um motor, um ventilador, um trocador de calor ou um sensor no seu estado: desligado, ligado, falha, aberto, fechado ou em trânsito. Uma bomba ou ventilador em funcionamento gira, uma falha pisca com uma marca e uma válvula em trânsito tem contorno tracejado, de modo que o operador nunca lê o estado só pela cor.
TsgcVCLTankGauge: Shape (vertical, horizontal, fundo cônico ou esfera), LimitHH, LimitH, LimitL, LimitLL, LimitHysteresis, LimitStateTsgcVCLSymbolGauge: Kind, State, Rotation, SpinPeriod, FlashIntervalValueMap para os códigos da plantaO tanque e o símbolo de processo estão em todas as edições, inclusive a Community. Seus feeds em tempo real pela ponte são da edição Registrada. Ambos fazem parte do Pacote HMI do sgcUI, junto com símbolos P&ID, uma lista de alarmes ISA-18.2 e um NumPad touch.
Ler o tópico da ajudaGauges que reagem: limites, animação, displays industriais e feeds em tempo real.
Alarmes, movimento e dados em tempo real
Uma pressão que oscila em torno do limite não deve disparar cem alarmes por minuto. Um limite tem um valor, uma direção e uma faixa de histerese: ele dispara uma vez quando o valor o cruza e só rearma depois que o valor recuar o equivalente à faixa. O OnThreshold sempre roda na thread principal, qualquer que seja a thread que gravou o valor, então você pode acender um LED ou mostrar uma mensagem diretamente. Cada limite pode acompanhar um ponteiro diferente, de modo que um gauge pode disparar um alarme de máxima sobre o valor real e um de mínima sobre uma segunda leitura.
Thresholds de TsgcGaugeThreshold com Value, Hysteresis e DirectiongtdRising, gtdFalling ou gtdBothValueColor muda a cor do texto do valor enquanto o limite está ativoAlarmes, movimento e dados em tempo real
Um ponteiro que pula parece quebrado, um que desliza parece um instrumento. Cada novo valor é animado a partir do anterior durante uma duração à sua escolha, com uma de cinco curvas de easing, então uma mudança brusca é fácil de acompanhar e um feed em tempo real nunca pisca. Desative a animação em bancadas de teste que precisam do valor bruto na hora. O OnChange avisa quando o valor mudou, independente da animação na tela.
Animation (TsgcGaugeAnimation) com Enabled e Duration, 300 ms por padrãoEasing: geLinear, geQuadOut, geCubicOut, geCubicInOut, geBackOutIsAnimating informa se um ponteiro ainda está se movendo
Alarmes, movimento e dados em tempo real
Painéis de controle têm sua própria linguagem visual. O gauge digital desenha dígitos de 7 segmentos, 14 segmentos ou matriz de pontos, com segmentos fantasma e inclinação opcionais. Os LEDs piscam, a barra LED retém seu pico e o anunciador mostra um painel de tiles de alarme que piscam até um operador reconhecê-los. Todos esses displays têm as mesmas escalas, limites e temas dos outros gauges, então os alarmes funcionam da mesma forma em todo lugar.
TsgcVCLDigitalGauge: DisplayType, Digits, ShowGhost, SkewTsgcVCLLEDGauge com Blink e BlinkInterval; TsgcVCLLEDBarGauge com PeakHoldTsgcVCLAnnunciatorGauge: Tiles, FlashInterval, Acknowledge, AcknowledgeAllA Community tem dígitos de 7 segmentos, LEDs e a barra LED. Os displays de 14 segmentos e de matriz de pontos e o anunciador são da edição Registrada.
Ler o tópico da ajudaAlarmes, movimento e dados em tempo real Somente Registrada
Em um console de IoT, a maior parte do código é infraestrutura: assinar, interpretar, achar o gauge, definir o valor. A ponte sgcGaugesWS elimina isso. Uma fonte de feed se conecta a um cliente sgcWebSockets, e cada vínculo associa um tópico e um caminho JSON a um ponteiro de gauge. Os filtros de tópico MQTT com + e # são suportados, e um caminho de filtro escolhe um dispositivo em um stream compartilhado. Vários vínculos podem compartilhar uma fonte, então uma única conexão com o broker aciona um painel inteiro.
TsgcGaugeFeedSource_MQTT, TsgcGaugeFeedSource_WebSocket, TsgcGaugeFeedSource_SSEBindings de TsgcGaugeFeedBinding: Gauge, PointerIndex, Topic, ValuePathFilterPath e FilterValue selecionam as mensagensOnValue e OnError na fonteValueMap transforma códigos da planta, como um bit de CLP ou RUNNING, nos estados de um símbolo de processoA ponte exige o sgcWebSockets. Na edição Community, defina Value pelo seu próprio código; é seguro a partir de uma thread em segundo plano.
Ler o tópico da ajudaO mesmo gauge em um servidor e em qualquer tema.
Saída e aparência
Os gauges também são necessários fora da tela: em um relatório de turno, um e-mail de status ou uma página web servida pelo seu back-end. Todo modelo de gauge e todo controle se salva como PNG ou SVG sem formulário, então um programa de console, um serviço do Windows ou um servidor Linux64 pode renderizar o mesmo instrumento que o operador vê. Largura, altura e escala são parâmetros, então uma chamada gera uma miniatura para uma lista e outra uma imagem nítida 2x para um relatório.
SaveToPNG e SaveToSVG em todo modelo e controleTsgcRadialGauge e TsgcLinearGauge
Saída e aparência
Uma sala de controle reduz o brilho das telas à noite, um escritório prefere um visual claro. Uma propriedade alterna um gauge entre o tema claro e o escuro, e as cores do mostrador, da escala, dos rótulos e do valor acompanham. Os gauges usam o mesmo tipo de tema de todo produto sgcUI, então mudam junto com dashboards, gráficos e grades. As faixas mantêm suas próprias cores nos dois temas, então o verde continua significando normal à noite. A propriedade FormatSettings fixa o separador decimal do display, independente da localidade do usuário.
Theme := utDark ou utLightFaceColor, BackgroundColor e as fontes ainda podem ser definidos por gaugeTitle, Units e ValueFormat para o displayOnFormatValue para formatar você mesmo o texto do valorA pré-visualização mostra exatamente o que a impressora e o PDF recebem.
Imprima, pré-visualize e exporte para PDF
Um gauge é impresso em uma página como na tela, com suas escalas, faixas, limites, ponteiros e textos. Ele é impresso com o seu valor final, de modo que uma animação em execução nunca aparece pela metade no papel, e continua rodando na tela.
Print mostra a caixa de diálogo de impressão ou imprime direto na impressora padrão, e ShowPrintPreview abre uma pré-visualização com navegação por páginas, zoom, configuração de página, impressão e exportação para PDFPrintSettings guarda o papel, a orientação, as margens, a escala e o texto do cabeçalho e do rodapé, e a impressora, a pré-visualização e o PDF usam todos o mesmo conjuntoExportToPDF grava o gauge como gráficos vetoriais com texto real, PDF/UA com tags por padrão, com um texto alternativo que lê a legenda, o valor com a sua unidade e o intervaloPDFALevel de TsgcUIPDFOptions adiciona PDF/A-2a ou PDF/A-3a para arquivamento, sozinho ou junto com o PDF/UAA impressão e a pré-visualização estão em todas as edições, inclusive na edição Community gratuita, em VCL, FireMonkey, WinForms, WPF e Avalonia. No FireMonkey, a impressão funciona no Windows e no macOS, e a pré-visualização e a exportação para PDF em todas as plataformas. A exportação para PDF exige a ponte sgcUIPDF e um sgcPDF licenciado (o pacote NuGet esegece.sgcUICore.sgcPDF no .NET), por isso não está na edição Community.
UI Automation para leitores de tela e o alto contraste, sem nenhuma configuração.
Acessibilidade
Cada tipo de indicador expõe sua legenda, seu valor e sua faixa ao Microsoft UI Automation, e os limites são emitidos como anúncios. O indicador se descreve com a mesma alternativa em texto que grava em um PDF acessível.
TabStop como True quando os usuários de teclado devem chegar a um indicadorA acessibilidade vem ativada por padrão em todas as edições, inclusive a edição Community gratuita, no VCL em todas as versões do Delphi e do C++Builder do Delphi 7 ao Delphi 13, no FireMonkey no Windows e no WinForms, WPF e Avalonia. No Delphi e no C++Builder, AccessibleName e AccessibleDescription definem o nome e a descrição expostos ao UI Automation, e no .NET o nome acessível e o texto de ajuda padrão de cada framework fazem o mesmo. Veja os relatórios de conformidade de acessibilidade.
sgcGauges dentro das demos da suíte sgcUI: aplicações completas que rodam offline com dados simulados integrados.
Medidores radiais, lineares e de LED para cada leitura de uma bomba.
Altamira Plant →
Medidores de velocidade, bússola e temperatura do refrigerado de um caminhão.
Altamira Fleet →
Um medidor radial de VaR, barras de exposição, um anel de progresso e blocos de alarme piscantes.
Altamira Markets →
Um medidor radial da meta do trimestre e medidores lineares por região.
Altamira ERP →
Uma HMI de fábrica mostra dois tanques com gauges de nível, LEDs de bombas, mostradores de pressão com faixas vermelhas e um painel anunciador de alarmes. Limites com histerese disparam cada alarme uma vez, o anunciador pisca até o operador reconhecê-lo e o turno da noite muda para o tema escuro.
Um console de telemetria assina um broker e mostra seis leituras em tempo real de dispositivos de campo. Os vínculos associam cada tópico e campo JSON a um ponteiro, as agulhas deslizam até cada novo valor e nenhum código de tratamento de mensagens é escrito à mão. Os mesmos gauges são renderizados em PNG para o e-mail diário de status.
Um dashboard gerencial coloca gauges em tiles ao lado de cartões de KPI e gráficos: a utilização como anel de progresso, o prazo de entrega como bullet graph contra a meta e o nível de serviço como um mostrador com faixas coloridas. Tudo segue uma única propriedade de tema e os gauges se ajustam ao tamanho dos seus tiles.
The same API in Delphi, C++ Builder and C#: a radial pressure gauge with a red band and an alarm threshold, a bullet level gauge and a blinking alarm LED.
A radial pressure gauge with a red band and an alarm threshold, a bullet level gauge and a blinking alarm LED on a VCL form.
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;The same panel in C++ Builder with the generated 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;
}The WinForms version in C#, with the same class names as 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 e MQTTLive para Delphi e C++ Builder. Os demos .NET são Gallery (WinForms), GalleryWpf, GalleryAvalonia, ConsoleRender, HMIPanel e MQTTLive.
Dez gauges com troca de tema, animação, modo de simulação, um limite a 200 km/h com um LED de alarme, reconhecimento do anunciador e exportação para PNG em 2x, além dos indicadores de entrada de botão giratório, controle deslizante, interruptor e botão de pressão.
Dois tanques com bombas, níveis, pressões e alarmes de anunciador, o layout de uma tela de processo típica.
Seis gauges em tiles do sgcDashboard, seguindo o tema do dashboard. Compila com a edição Community.
Um programa de console que grava PNG e SVG no Win32, Win64 e Linux64.
A galeria no FireMonkey, para Windows e Android.
Seis gauges alimentados por MQTT pela ponte sgcGaugesWS. Requer o sgcWebSockets e um broker.
Executáveis prontos para rodar de todos os produtos sgcUI, sem nada para instalar.
Baixar sgcUI_bin.zip →Cinco demos QuickStart para Delphi (VCL) acompanham o produto em Demos\Gauges\Delphi\00.QuickStart. O guia em PDF as explica passo a passo: um primeiro medidor radial, escalas e faixas coloridas, alarmes de limite, temas e skins, e um monitor de estação de bombeamento.
O sgcGauges está nas edições sgcUI Professional e Enterprise e também é vendido separadamente. O sgcGauges também está incluído no pacote All-Access.
€199 / desenvolvedor, código-fonte completo, 1 ano de atualizações.
Comprar o sgcGauges → Ver preços →Standard mais sgcGauges, sgcCharts e sgcDashboard, a partir de €529.
Ver Professional →A edição Community gratuita (esegece.sgcGauges.Community no NuGet) tem os gauges radial, linear, digital de 7 segmentos, LED, barra LED e anel de progresso, com faixas, limites, animação, temas e saída headless. Ela não tem VU meter, relógio, bússola nem anunciador, nem escalas ou ponteiros extras, nem a ponte sgcGaugesWS.
| Recurso | Community (gratuita) | Registrada |
|---|---|---|
| Radial, linear, digital de 7 segmentos, LED, barra LED e anel de progresso | ✓ | ✓ |
| Faixas, limites, animação e temas | ✓ | ✓ |
| Saída headless em PNG e SVG | ✓ | ✓ |
| VU meter, relógio, bússola e anunciador | − | ✓ |
| Várias escalas e ponteiros por gauge | − | ✓ |
| Displays de 14 segmentos e de matriz de pontos | − | ✓ |
| Ponte sgcGaugesWS (MQTT, WebSocket, SSE) | − | ✓ |
Cada gauge tem um modelo neutro quanto ao framework para renderização headless, um controle VCL (também usado no C++ Builder), um controle FireMonkey e controles WinForms, WPF e Avalonia.
| Gauge | VCL e C++ Builder | FireMonkey | .NET |
|---|---|---|---|
| Radial | TsgcVCLRadialGauge | TsgcFMXRadialGauge | TsgcWinFormsRadialGauge |
| Linear (barra, termômetro, bullet) | TsgcVCLLinearGauge | TsgcFMXLinearGauge | TsgcWpfLinearGauge |
| Digital (7 segmentos, 14 segmentos, matriz de pontos) | TsgcVCLDigitalGauge | TsgcFMXDigitalGauge | TsgcWinFormsDigitalGauge |
| LED | TsgcVCLLEDGauge | TsgcFMXLEDGauge | TsgcWinFormsLEDGauge |
| Barra LED | TsgcVCLLEDBarGauge | TsgcFMXLEDBarGauge | TsgcWinFormsLEDBarGauge |
| Anel de progresso | TsgcVCLProgressRingGauge | TsgcFMXProgressRingGauge | TsgcWinFormsProgressRingGauge |
| Tanque | TsgcVCLTankGauge | TsgcFMXTankGauge | TsgcWpfTankGauge |
| Símbolo de processo | TsgcVCLSymbolGauge | TsgcFMXSymbolGauge | TsgcAvaloniaSymbolGauge |
| VU meter | TsgcVCLVUMeterGauge | TsgcFMXVUMeterGauge | TsgcWinFormsVUMeterGauge |
| Relógio | TsgcVCLClockGauge | TsgcFMXClockGauge | TsgcWinFormsClockGauge |
| Bússola | TsgcVCLCompassGauge | TsgcFMXCompassGauge | TsgcWpfCompassGauge |
| Anunciador | TsgcVCLAnnunciatorGauge | TsgcFMXAnnunciatorGauge | TsgcAvaloniaAnnunciatorGauge |
A coluna .NET mostra um exemplo por gauge; todo gauge existe como TsgcWinForms, TsgcWpf e TsgcAvalonia. Todos os gauges compartilham a classe base TsgcCustomGauge com as coleções Scales, Pointers, Thresholds e Ranges. Os modelos neutros quanto ao framework (TsgcRadialGauge, TsgcLinearGauge e assim por diante) renderizam sem janela.
| Destino | Componente | Plataformas |
|---|---|---|
| Delphi 7 a 13, VCL | Gauges TsgcVCL | Win32, e Win64 a partir do XE2 |
| Delphi XE6 a 13, FireMonkey | Gauges TsgcFMX | Windows, macOS, iOS e Android |
| C++ Builder 2007 a 13 | Gauges TsgcVCL | Cabeçalhos .hpp gerados e bibliotecas estáticas |
| Delphi 10.2 a 13, neutro quanto ao framework | Modelos de gauge e saída headless em PNG e SVG | Linux64 (sem controles para Linux) |
| .NET Framework 4.7.2, .NET 8, 9 e 10 | Gauges WinForms, WPF e Avalonia | Desktop Windows, destinos Avalonia, renderização headless |
Sim. Defina Value a partir da thread que recebe os dados. Os limites são avaliados para você e o OnThreshold sempre dispara na thread principal, então um manipulador pode atualizar controles sem sincronização extra. A ponte sgcGaugesWS faz o mesmo quando alimenta os ponteiros por MQTT, WebSocket ou SSE.
Os gauges radial, linear, digital de 7 segmentos, LED, barra LED, anel de progresso, tanque e símbolo de processo, com faixas, limites, animação, temas e saída headless. O VU meter, o relógio, a bússola, o anunciador, as escalas e ponteiros extras, os dígitos de 14 segmentos e de matriz de pontos e a ponte são da edição Registrada. Veja Editions.
Sim, com a edição Registrada e o sgcWebSockets. Solte um TsgcGaugeFeedSource_MQTT, vincule seu cliente MQTT e adicione um vínculo por gauge com o Topic e o ValuePath JSON. Os filtros de tópico com + e # funcionam, e o FilterPath escolhe um dispositivo em um tópico compartilhado.
Os controles FireMonkey funcionam a partir do Delphi XE6, e o demo GalleryFMX roda no Windows e no Android. No Linux64, o sgcGauges é apenas headless: os modelos compilam e renderizam PNG e SVG a partir do Delphi 10.2, mas não há controles para Linux.
Sim. Cada escala tem seus próprios Minimum, Maximum, MajorInterval e marcas secundárias, e qualquer número de faixas coloridas com início, fim, cor, espessura e legenda. Um gauge radial também permite escolher o ângulo inicial e a abertura do arco.
Sim. SaveToPNG e SaveToSVG funcionam em todo controle e todo modelo, sem janela, então um serviço ou um servidor Linux64 pode colocar as leituras atuais em um PDF ou em um e-mail. O demo Gallery também exporta PNG em 2x.
O gauge digital se dimensiona a partir da escala: com Digits em 0, ele reserva quantos dígitos o máximo da escala exigir, e a escala padrão vai de 0 a 100. Defina Scales[0].Maximum com o maior valor esperado ou defina Digits explicitamente.
Introdução, Tipos de gauge, Início rápido VCL, Limites, Animação, Faixas, Gauge radial, Ponte sgcGaugesWS, Renderização headless, Editions.
Delphi, C++ Builder e .NET, cobrindo todos os produtos sgcUI.
Coloque gauges em tiles de dashboard ao lado de cartões de KPI; o demo DashboardGauges mostra como.
Conhecer o sgcDashboard →
Mostre a tendência por trás de cada leitura com um gráfico em tempo real ao lado do gauge.
Conhecer o sgcCharts →
Deixe os operadores definirem limites e valores de referência com sliders e spin edits.
Conhecer o sgcEditors →Alimente os gauges com MQTT, WebSocket ou SSE usando a ponte sgcGaugesWS.
Conhecer o sgcWebSockets →