Dieciséis tipos de indicador para cuadros de mando y paneles HMI, del dial radial a un depósito de proceso, un símbolo de bomba y un anunciador, además de un mando giratorio, un deslizador, un interruptor y un botón que acciona el usuario. Dibuja bandas verdes, ámbar y rojas, lanza una alarma cuando un valor cruza un límite, deja que la aguja se deslice hasta cada nueva lectura y renderiza el mismo indicador a PNG o SVG en un servidor.
Trece capacidades en cinco grupos, con los nombres reales de clases y propiedades y un enlace a cada tema de ayuda. Las funciones marcadas como registradas no están en la compilación .NET Community gratuita.
Dieciséis tipos sobre un mismo modelo, con rangos, estilos, aspectos y varios punteros.
Instrumentos y escalas
Los cuadros de mando, los paneles HMI y los bancos de pruebas necesitan instrumentos distintos: un dial para la velocidad, una barra para el nivel, una lectura digital para la frecuencia, una lámpara para una bomba, un panel de mosaicos para las alarmas. sgcGauges incluye dieciséis tipos, doce pantallas y cuatro indicadores de entrada, que comparten un mismo modelo, con las mismas escalas, punteros, rangos, umbrales y temas. Aprende una API y todos los instrumentos se comportan igual.
TsgcVCLRadialGauge, TsgcVCLLinearGauge, TsgcVCLDigitalGauge, TsgcVCLLEDGauge, TsgcVCLLEDBarGauge, TsgcVCLProgressRingGaugeTsgcVCLVUMeterGauge, TsgcVCLClockGauge, TsgcVCLCompassGauge, TsgcVCLAnnunciatorGaugeTsgcVCLTankGauge y TsgcVCLSymbolGauge para pantallas de procesoTsgcRadialGauge, para uso sin ventanaCommunity incluye los indicadores radial, lineal, digital de 7 segmentos, LED, barra de LED, anillo de progreso, depósito y símbolo de proceso. El medidor VU, el reloj, la brújula y el anunciador son de la edición registrada.
Leer el tema de la ayuda
Instrumentos y escalas
Un operario lee un indicador de un vistazo solo cuando el verde, el ámbar y el rojo dicen dónde debería estar el valor. Da a una escala cualquier mínimo y máximo, define el intervalo principal y las marcas secundarias, y añade rangos de colores para las bandas que importan. Los rangos tienen su propio grosor y título, y la escala puede ir invertida o colocar sus marcas por dentro o por fuera. Los rangos se dibujan en la propia escala, así que también aparecen en la salida PNG y SVG y en ambos temas sin trabajo adicional.
Scales[0].Ranges.Add con StartValue, EndValue, Color, Thickness y CaptionTsgcGaugeScale: Minimum, Maximum, MajorInterval, MinorCount, ReversedLabelFormat y ShowLabels para las etiquetas de la escalaStartAngle y SweepAngle dan forma al arco de un indicador radial
Instrumentos y escalas
Los niveles, las temperaturas y el progreso frente a un objetivo son lineales por naturaleza. Un indicador lineal dibuja tres estilos: una barra simple, un termómetro con bulbo y un gráfico de bala que compara el valor con una marca de objetivo. Ponlo en horizontal o en vertical para encajarlo en un depósito, una barra lateral o una fila de tabla. El objetivo de la bala es una propiedad, no un puntero adicional, por lo que el gráfico de bala funciona también en la edición Community gratuita. Un indicador pequeño cabe en una celda de cuadrícula o en un mosaico de cuadro de mando.
LinearStyle: glsBar, glsThermometer o glsBulletTarget dibuja la marca de objetivo de la bala, en todas las edicionesOrientation y BulbSize
Instrumentos y escalas Solo registrada
Algunas lecturas solo tienen sentido una junto a otra: real frente a objetivo, entrada frente a salida, horas y minutos. Un indicador puede llevar más de una escala y más de un puntero, y cada puntero elige su escala y su estilo: una aguja, una marca o una barra. Los umbrales pueden vigilar cualquier puntero. Un dial de doble puntero ahorra espacio en paneles saturados y hace visible de inmediato la diferencia entre objetivo y valor real.
Pointers de TsgcGaugePointer con Kind, NeedleStyle, MarkerShape y ScaleIndexScales con Radius y Offset por escalaPointerIndex en los umbrales y en los enlaces de datosCommunity dibuja una escala y un puntero por indicador; la edición registrada los dibuja todos.
Leer el tema de la ayudaInstrumentos y escalas
Una pantalla de proceso muestra recipientes y equipos, no solo diales. El indicador de depósito dibuja un recipiente con su nivel y las marcas de los cuatro límites ISA, HH, H, L y LL, y una histéresis mantiene el estado de un límite hasta que el nivel se aleja de él. El indicador de símbolo de proceso dibuja una válvula, una bomba, un motor, un ventilador, un intercambiador de calor o un sensor en su estado: off, on, fault, open, closed o transit. Una bomba o un ventilador en marcha gira, un fallo parpadea con una marca y una válvula en tránsito tiene un contorno discontinuo, de modo que el operador nunca lee el estado solo por el color.
TsgcVCLTankGauge: Shape (vertical, horizontal, fondo cónico o esfera), LimitHH, LimitH, LimitL, LimitLL, LimitHysteresis, LimitStateTsgcVCLSymbolGauge: Kind, State, Rotation, SpinPeriod, FlashIntervalValueMap para los códigos de plantaEl depósito y el símbolo de proceso están en todas las ediciones, también en Community. Sus fuentes en vivo mediante el puente son de la edición registrada. Ambos forman parte del paquete HMI de sgcUI, junto con símbolos P&ID, una lista de alarmas ISA-18.2 y un NumPad táctil.
Leer el tema de la ayudaIndicadores que reaccionan: umbrales, animación, pantallas industriales y fuentes en vivo.
Alarmas, movimiento y datos en vivo
Una presión que oscila alrededor de su límite no debe disparar cien alarmas por minuto. Un umbral tiene un valor, una dirección y una banda de histéresis: se dispara una vez cuando el valor lo cruza y solo se rearma cuando el valor ha retrocedido esa banda. OnThreshold se ejecuta siempre en el hilo principal, sea cual sea el hilo que escribió el valor, así que puedes encender un LED o mostrar un mensaje directamente. Cada umbral puede vigilar un puntero distinto, de modo que un indicador puede lanzar una alarma alta sobre el valor real y una alarma baja sobre una segunda lectura.
Thresholds de TsgcGaugeThreshold con Value, Hysteresis y DirectiongtdRising, gtdFalling o gtdBothValueColor cambia el color del texto del valor mientras el umbral está activoAlarmas, movimiento y datos en vivo
Una aguja que salta parece rota, una que se desliza parece un instrumento. Cada nuevo valor se anima desde el anterior durante la duración que elijas, con una de cinco curvas de suavizado, de modo que un cambio brusco es fácil de seguir y una fuente en vivo nunca parpadea. Desactiva la animación en los bancos de pruebas que necesitan el valor en bruto al instante. OnChange te avisa de cuándo cambió el valor, con independencia de la animación en pantalla.
Animation (TsgcGaugeAnimation) con Enabled y Duration, 300 ms por defectoEasing: geLinear, geQuadOut, geCubicOut, geCubicInOut, geBackOutIsAnimating indica si un puntero sigue moviéndose
Alarmas, movimiento y datos en vivo
Los paneles de control tienen su propio lenguaje visual. El indicador digital dibuja dígitos de 7 segmentos, 14 segmentos o matriz de puntos, con segmentos fantasma e inclinación opcionales. Los LED parpadean, la barra de LED mantiene su pico y el anunciador muestra un panel de mosaicos de alarma que parpadean hasta que un operario los reconoce. Todas estas pantallas tienen las mismas escalas, umbrales y temas que los demás indicadores, así que las alarmas funcionan igual en todas partes.
TsgcVCLDigitalGauge: DisplayType, Digits, ShowGhost, SkewTsgcVCLLEDGauge con Blink y BlinkInterval; TsgcVCLLEDBarGauge con PeakHoldTsgcVCLAnnunciatorGauge: Tiles, FlashInterval, Acknowledge, AcknowledgeAllCommunity incluye dígitos de 7 segmentos, LED y la barra de LED. Las pantallas de 14 segmentos y de matriz de puntos y el anunciador son de la edición registrada.
Leer el tema de la ayudaAlarmas, movimiento y datos en vivo Solo registrada
En una consola IoT la mayor parte del código es fontanería: suscribirse, analizar, encontrar el indicador, asignar el valor. El puente sgcGaugesWS la elimina. Una fuente de datos se conecta a un cliente de sgcWebSockets y cada enlace asocia un tema y una ruta JSON a un puntero del indicador. Se admiten filtros de tema MQTT con + y #, y una ruta de filtro elige un dispositivo concreto dentro de un flujo compartido. Varios enlaces pueden compartir una fuente, de modo que una sola conexión con el broker maneja un panel completo.
TsgcGaugeFeedSource_MQTT, TsgcGaugeFeedSource_WebSocket, TsgcGaugeFeedSource_SSEBindings de TsgcGaugeFeedBinding: Gauge, PointerIndex, Topic, ValuePathFilterPath y FilterValue seleccionan mensajesOnValue y OnError en la fuenteValueMap convierte los códigos de planta, como un bit de PLC o RUNNING, en los estados de un símbolo de procesoEl puente necesita sgcWebSockets. En Community, asigna Value desde tu propio código; es seguro hacerlo desde un hilo en segundo plano.
Leer el tema de la ayudaEl mismo indicador en un servidor y en cualquier tema.
Salida y aspecto
Los indicadores también se necesitan fuera de la pantalla: en un informe de turno, en un correo de estado o en una página web servida por tu backend. Cada modelo y cada control de indicador se guarda como PNG o SVG sin formulario, de modo que un programa de consola, un servicio de Windows o un servidor Linux64 pueden renderizar el mismo instrumento que ve el operario. El ancho, el alto y la escala son parámetros, así que una llamada produce una miniatura para una lista y otra una imagen nítida a 2x para un informe.
SaveToPNG y SaveToSVG en cada modelo y controlTsgcRadialGauge y TsgcLinearGauge
Salida y aspecto
Una sala de control atenúa sus pantallas por la noche, una oficina prefiere un aspecto claro. Una propiedad cambia un indicador entre el tema claro y el oscuro, y los colores de la esfera, la escala, las etiquetas y el valor la siguen. Los indicadores usan el mismo tipo de tema que todos los productos sgcUI, así que cambian a la vez que los cuadros de mando, los gráficos y las cuadrículas. Los rangos conservan sus propios colores en ambos temas, así que el verde sigue significando normal por la noche. La propiedad FormatSettings fija el separador decimal de la lectura con independencia de la configuración regional del usuario.
Theme := utDark o utLightFaceColor, BackgroundColor y las fuentes se pueden seguir definiendo por indicadorTitle, Units y ValueFormat para la lecturaOnFormatValue para dar formato tú mismo al texto del valorLa vista previa muestra exactamente lo que reciben la impresora y el PDF.
Imprime, previsualiza y exporta a PDF
Un indicador se imprime en una página como en pantalla, con sus escalas, rangos, umbrales, punteros y textos. Se imprime con su valor final, de modo que una animación en curso nunca aparece a medias en el papel, y sigue ejecutándose en pantalla.
Print muestra el cuadro de diálogo de impresión o imprime directamente en la impresora predeterminada, y ShowPrintPreview abre una vista previa con navegación por páginas, zoom, configuración de página, impresión y exportación a PDFPrintSettings contiene el papel, la orientación, los márgenes, la escala y el texto del encabezado y del pie de página, y la impresora, la vista previa y el PDF lo usan todosExportToPDF escribe el indicador como gráficos vectoriales con texto real, PDF/UA etiquetado por defecto, con un texto alternativo que lee el título, el valor con su unidad y el rangoPDFALevel de TsgcUIPDFOptions añade PDF/A-2a o PDF/A-3a para archivo, solo o junto con PDF/UALa impresión y la vista previa están en todas las ediciones, también en la edición Community gratuita, en VCL, FireMonkey, WinForms, WPF y Avalonia. En FireMonkey, la impresión funciona en Windows y macOS, y la vista previa y la exportación a PDF en todas las plataformas. La exportación a PDF necesita el puente sgcUIPDF y un sgcPDF con licencia (el paquete NuGet esegece.sgcUICore.sgcPDF en .NET), por lo que no está en la edición Community.
UI Automation para lectores de pantalla y alto contraste, sin configuración.
Accesibilidad
Todos los tipos de indicador exponen su título, su valor y su rango a Microsoft UI Automation, y los umbrales se emiten como anuncios. El indicador se describe a sí mismo con la misma alternativa de texto que escribe en un PDF accesible.
TabStop a True cuando los usuarios de teclado deban llegar a un indicadorLa accesibilidad está activada por defecto en todas las ediciones, también en la edición Community gratuita, en VCL en todas las versiones de Delphi y C++Builder desde Delphi 7 hasta Delphi 13, en FireMonkey en Windows, y en WinForms, WPF y Avalonia. En Delphi y C++Builder, AccessibleName y AccessibleDescription establecen el nombre y la descripción expuestos a UI Automation, y en .NET lo hacen el nombre accesible y el texto de ayuda estándar de cada framework. Consulta los informes de conformidad de accesibilidad (en inglés).
sgcGauges dentro de las demos de la suite sgcUI: aplicaciones completas que funcionan sin conexión con datos simulados integrados.
Indicadores radiales, lineales y LED para cada lectura de una bomba.
Altamira Plant →
Indicadores de velocidad, brújula y temperatura del frigorífico de un camión.
Altamira Fleet →
Un indicador radial de VaR, barras de exposición, un anillo de progreso y mosaicos de alarma parpadeantes.
Altamira Markets →
Un indicador radial del objetivo trimestral e indicadores lineales por región.
Altamira ERP →
Un HMI de planta muestra dos depósitos con indicadores de nivel, LED de bombas, diales de presión con bandas rojas y un panel anunciador para las alarmas. Los umbrales con histéresis lanzan cada alarma una sola vez, el anunciador parpadea hasta que el operario la reconoce y el turno de noche cambia al tema oscuro.
Una consola de telemetría se suscribe a un broker y muestra seis lecturas en vivo de dispositivos de campo. Los enlaces asocian cada tema y campo JSON a un puntero, las agujas se deslizan hasta cada nuevo valor y no se escribe a mano ningún código de gestión de mensajes. Los mismos indicadores se renderizan como PNG para el correo de estado diario.
Un cuadro de mando de dirección coloca indicadores en mosaicos junto a tarjetas KPI y gráficos: la utilización como anillo de progreso, el plazo de entrega como gráfico de bala frente a su objetivo y el nivel de servicio como un dial con bandas de colores. Todo sigue una única propiedad de tema y los indicadores se ajustan a sus mosaicos.
La misma API en Delphi, C++ Builder y C#: un indicador radial de presión con una banda roja y un umbral de alarma, un indicador de nivel de tipo bala y un LED de alarma parpadeante.
Un indicador radial de presión con una banda roja y un umbral de alarma, un indicador de nivel de tipo bala y un LED de alarma parpadeante en un formulario VCL.
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;El mismo panel en C++ Builder con las cabeceras generadas.
#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;
}La versión WinForms en C#, con los mismos nombres de clase que en 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 y MQTTLive para Delphi y C++ Builder. Las demos .NET son Gallery (WinForms), GalleryWpf, GalleryAvalonia, ConsoleRender, HMIPanel y MQTTLive.
Diez indicadores con cambio de tema, animación, un modo de simulación, un umbral a 200 km/h con un LED de alarma, reconocimiento del anunciador y exportación PNG a 2x, además de los indicadores de entrada de mando giratorio, deslizador, interruptor y botón.
Dos depósitos con bombas, niveles, presiones y alarmas de anunciador, la disposición de una pantalla de proceso típica.
Seis indicadores en mosaicos de sgcDashboard, que siguen el tema del cuadro de mando. Se compila con la edición Community.
Un programa de consola que escribe PNG y SVG en Win32, Win64 y Linux64.
La galería en FireMonkey, para Windows y Android.
Seis indicadores alimentados por MQTT mediante el puente sgcGaugesWS. Necesita sgcWebSockets y un broker.
Ejecutables listos para usar de cada producto sgcUI, sin nada que instalar.
Descargar sgcUI_bin.zip →Cinco demos QuickStart para Delphi (VCL) se incluyen en Demos\Gauges\Delphi\00.QuickStart. La guía en PDF las recorre paso a paso: un primer indicador radial, escalas y rangos de colores, alarmas de umbral, temas y skins, y un monitor de estación de bombeo.
sgcGauges está en las ediciones sgcUI Professional y Enterprise, y también se vende por separado. sgcGauges se incluye además en el paquete All-Access.
€199 / desarrollador, código fuente completo, 1 año de actualizaciones.
Comprar sgcGauges → Ver precios →La edición Community gratuita (esegece.sgcGauges.Community en NuGet) incluye los indicadores radial, lineal, digital de 7 segmentos, LED, barra de LED y anillo de progreso con rangos, umbrales, animación, temas y salida sin ventana. No incluye el medidor VU, el reloj, la brújula ni el anunciador, ni escalas o punteros adicionales, ni el puente sgcGaugesWS.
| Función | Community (gratuita) | Registrada |
|---|---|---|
| Radial, lineal, digital de 7 segmentos, LED, barra de LED y anillo de progreso | ✓ | ✓ |
| Rangos, umbrales, animación y temas | ✓ | ✓ |
| Salida PNG y SVG sin ventana | ✓ | ✓ |
| Medidor VU, reloj, brújula y anunciador | − | ✓ |
| Varias escalas y punteros por indicador | − | ✓ |
| Pantallas de 14 segmentos y de matriz de puntos | − | ✓ |
| Puente sgcGaugesWS (MQTT, WebSocket, SSE) | − | ✓ |
Cada indicador tiene un modelo independiente del framework para renderizar sin ventana, un control VCL (que también se usa desde C++ Builder), un control FireMonkey y controles WinForms, WPF y Avalonia.
| Indicador | VCL y C++ Builder | FireMonkey | .NET |
|---|---|---|---|
| Radial | TsgcVCLRadialGauge | TsgcFMXRadialGauge | TsgcWinFormsRadialGauge |
| Lineal (barra, termómetro, bala) | TsgcVCLLinearGauge | TsgcFMXLinearGauge | TsgcWpfLinearGauge |
| Digital (7 segmentos, 14 segmentos, matriz de puntos) | TsgcVCLDigitalGauge | TsgcFMXDigitalGauge | TsgcWinFormsDigitalGauge |
| LED | TsgcVCLLEDGauge | TsgcFMXLEDGauge | TsgcWinFormsLEDGauge |
| Barra de LED | TsgcVCLLEDBarGauge | TsgcFMXLEDBarGauge | TsgcWinFormsLEDBarGauge |
| Anillo de progreso | TsgcVCLProgressRingGauge | TsgcFMXProgressRingGauge | TsgcWinFormsProgressRingGauge |
| Depósito | TsgcVCLTankGauge | TsgcFMXTankGauge | TsgcWpfTankGauge |
| Símbolo de proceso | TsgcVCLSymbolGauge | TsgcFMXSymbolGauge | TsgcAvaloniaSymbolGauge |
| Medidor VU | TsgcVCLVUMeterGauge | TsgcFMXVUMeterGauge | TsgcWinFormsVUMeterGauge |
| Reloj | TsgcVCLClockGauge | TsgcFMXClockGauge | TsgcWinFormsClockGauge |
| Brújula | TsgcVCLCompassGauge | TsgcFMXCompassGauge | TsgcWpfCompassGauge |
| Anunciador | TsgcVCLAnnunciatorGauge | TsgcFMXAnnunciatorGauge | TsgcAvaloniaAnnunciatorGauge |
La columna .NET muestra un ejemplo por indicador, cada indicador existe como TsgcWinForms, TsgcWpf y TsgcAvalonia. Todos los indicadores comparten la clase base TsgcCustomGauge con las colecciones Scales, Pointers, Thresholds y Ranges. Los modelos independientes del framework (TsgcRadialGauge, TsgcLinearGauge y otros) se renderizan sin ventana.
| Destino | Componente | Plataformas |
|---|---|---|
| Delphi 7 a 13, VCL | Indicadores TsgcVCL | Win32, y Win64 desde XE2 |
| Delphi XE6 a 13, FireMonkey | Indicadores TsgcFMX | Windows, macOS, iOS y Android |
| C++ Builder 2007 a 13 | Indicadores TsgcVCL | Cabeceras .hpp generadas y bibliotecas estáticas |
| Delphi 10.2 a 13, independiente del framework | Modelos de indicador y salida PNG y SVG sin ventana | Linux64 (sin controles para Linux) |
| .NET Framework 4.7.2, .NET 8, 9 y 10 | Indicadores WinForms, WPF y Avalonia | Escritorio Windows, destinos Avalonia, renderizado sin ventana |
Sí. Asigna Value desde el hilo que recibe los datos. Los umbrales se evalúan por ti y OnThreshold se dispara siempre en el hilo principal, de modo que un manejador puede actualizar controles sin sincronización adicional. El puente sgcGaugesWS hace lo mismo cuando alimenta punteros desde MQTT, WebSocket o SSE.
Los indicadores radial, lineal, digital de 7 segmentos, LED, barra de LED, anillo de progreso, depósito y símbolo de proceso, con rangos, umbrales, animación, temas y salida sin ventana. El medidor VU, el reloj, la brújula, el anunciador, las escalas y punteros adicionales, los dígitos de 14 segmentos y de matriz de puntos y el puente son de la edición registrada. Consulta Ediciones.
Sí, con la edición registrada y sgcWebSockets. Coloca un TsgcGaugeFeedSource_MQTT, enlaza tu cliente MQTT y añade un enlace por indicador con el Topic y el ValuePath JSON. Los filtros de tema con + y # funcionan, y FilterPath elige un dispositivo de un tema compartido.
Los controles FireMonkey funcionan desde Delphi XE6, y la demo GalleryFMX se ejecuta en Windows y Android. En Linux64 sgcGauges es solo sin ventana: los modelos se compilan y renderizan PNG y SVG desde Delphi 10.2, pero no hay controles para Linux.
Sí. Cada escala tiene sus propios Minimum, Maximum, MajorInterval y marcas secundarias, y cualquier número de rangos de colores con inicio, fin, color, grosor y título. Un indicador radial también permite elegir el ángulo inicial y el barrido del arco.
Sí. SaveToPNG y SaveToSVG funcionan en cada control y cada modelo, sin ventana, así que un servicio o un servidor Linux64 pueden volcar las lecturas actuales en un PDF o en un correo. La demo Gallery también exporta PNG a 2x.
El indicador digital se dimensiona a partir de la escala: con Digits en 0 reserva tantos dígitos como necesita el máximo de la escala, y la escala por defecto va de 0 a 100. Asigna a Scales[0].Maximum el mayor valor que esperas, o define Digits de forma explícita.
Introducción, Tipos de indicador, Inicio rápido VCL, Umbrales, Animación, Rangos, Indicador radial, Puente sgcGaugesWS, Renderizado sin ventana, Ediciones.
Delphi, C++ Builder y .NET, que cubren todos los productos sgcUI.
Coloca indicadores en mosaicos de cuadro de mando junto a tarjetas KPI; la demo DashboardGauges muestra cómo.
Explorar sgcDashboard →
Muestra la tendencia detrás de cada lectura con un gráfico en vivo junto al indicador.
Explorar sgcCharts →
Deja que los operarios definan límites y valores de consigna con deslizadores y controles numéricos.
Explorar sgcEditors →Alimenta los indicadores desde MQTT, WebSocket o SSE con el puente sgcGaugesWS.
Explorar sgcWebSockets →