sgcGauges 기능 표
sgcGauges의 모든 기능을 작업별로 정리했으며, 각 기능의 도움말 항목으로 연결됩니다. 각 게이지에는 헤드리스 모델, VCL 컨트롤, FireMonkey 컨트롤, .NET 컨트롤 3개가 있습니다.
sgcGauges의 모든 기능을 작업별로 정리했으며, 각 기능의 도움말 항목으로 연결됩니다. 각 게이지에는 헤드리스 모델, VCL 컨트롤, FireMonkey 컨트롤, .NET 컨트롤 3개가 있습니다.
Registered 에디션은 Registered 에디션과 체험판 에디션에 포함되지만 무료 Community 에디션에는 없는 기능을 나타냅니다. ~는 Community에 일부만 포함된 기능이며, 차이점은 아래에 설명되어 있습니다.
모든 행은 해당 도움말 항목으로 연결됩니다. Community 열은 무료 .NET Community 에디션에 포함된 기능을 보여 주며, 모든 기능은 Registered 에디션과 체험판에 포함됩니다.
| 기능 | 세부 정보 | Community | 도움말 |
|---|---|---|---|
| 방사형 | 눈금, 범위, 포인터를 갖춘 다이얼 게이지. | 도움말 | |
| 선형 | 막대, 온도계, 불릿 그래프를 하나의 게이지로: LinearStyle의 glsBar, glsThermometer, glsBullet과 Target. | 도움말 | |
| 디지털 | 7세그먼트 디스플레이. 고스트 세그먼트와 기울임을 갖춘 14세그먼트와 도트 매트릭스는 Registered 에디션에 있습니다. | 도움말 | |
| LED 및 LED 막대 | 깜박이는 LED와 피크 홀드를 갖춘 LED 막대. | 도움말 | |
| 진행 링 | 원형 진행 표시기. | 도움말 | |
| 탱크와 용기 | TsgcVCLTankGauge(FireMonkey에서는 TsgcFMXTankGauge, WinForms, WPF, Avalonia에서도 같은 이름)는 프로세스 화면을 위해 용기의 수위를 표시합니다. Shape는 수직 원통, 수평 캡슐, 원뿔형 바닥, 구형 중에서 고릅니다. LimitHH, LimitH, LimitL, LimitLL은 용기에 ISA 한계를 표시하고, LimitHysteresis는 수위가 충분히 벗어나기 전까지 한계 상태를 유지하며, LimitState가 이를 알려 주는 동안 탱크는 HH, H, L, LL 배지를 그리므로 상태가 색상에만 의존하지 않습니다. | 도움말 | |
| 프로세스 심볼 | TsgcVCLSymbolGauge(FireMonkey에서는 TsgcFMXSymbolGauge, WinForms, WPF, Avalonia에서도 같은 이름)는 밸브, 펌프, 모터, 팬, 열교환기, 센서(Kind)를 꺼짐, 켜짐, 고장, 열림, 닫힘, 전환 중(State) 가운데 해당하는 프로세스 상태로 그립니다. 가동 중인 펌프나 팬은 회전하고, 고장은 표시와 함께 깜박이며, 전환 중인 밸브는 점선 윤곽을 가집니다. Rotation은 심볼을 회전시키고 설비 태그는 심볼 아래에 그려집니다. | 도움말 | |
| VU 미터 | 오디오 레벨 미터. | Registered 에디션 | 도움말 |
| 시계와 나침반 | 아날로그 시계와 나침반 게이지. | Registered 에디션 | 도움말 |
| 알림 패널 | 확인할 때까지 깜박이는 경보 타일(Acknowledge, OnTileClick). | Registered 에디션 | 도움말 |
| 입력 게이지 | TsgcVCLKnobGauge, TsgcVCLSliderGauge, TsgcVCLToggleSwitchGauge, TsgcVCLPushButtonGauge(FireMonkey에서는 TsgcFMX, WinForms, WPF, Avalonia에서는 같은 이름)는 사용자가 값을 설정하게 합니다. 마우스, 터치, 휠, 키보드로 노브를 돌리고, 슬라이더를 끌고, 스위치를 넘기고, 버튼을 누릅니다. Step은 값을 눈금에 맞추고, ReadOnly는 값을 잠그며, 푸시 버튼은 순간형 또는 래치형(Mode)이고, OnUserChange는 사용자가 한 변경에서만 발생합니다. 오른쪽에서 왼쪽 레이아웃에서는 좌우가 반전되며, 화면 읽기 프로그램은 이를 슬라이더, 토글 스위치, 버튼으로 인식합니다. | 도움말 |
| 기능 | 세부 정보 | Community | 도움말 |
|---|---|---|---|
| 범위 | 임의의 최솟값부터 최댓값까지 녹색, 황색, 적색 띠(Ranges.Add, StartValue, EndValue, Color). | 도움말 | |
| 눈금 | MajorInterval을 갖춘 눈금. 게이지당 여러 눈금은 Registered 에디션에 있습니다. | 도움말 | |
| 포인터 | 바늘과 마커 포인터. 게이지당 여러 포인터는 Registered 에디션에 있습니다. | ~Community는 게이지당 스케일 하나와 포인터 하나를 그리며, Registered 에디션은 모두 그립니다. | 도움말 |
| 히스테리시스를 갖춘 임계값 | OnThreshold는 값이 임계값을 넘을 때마다(gtdRising, gtdFalling, gtdBoth) 발생하며, 어느 스레드가 값을 썼든 메인 스레드에서 실행됩니다. | 도움말 |
| 기능 | 세부 정보 | Community | 도움말 |
|---|---|---|---|
| 애니메이션 | 바늘이 새 값마다 기본 300ms 동안 움직이며, 다섯 가지 이징 곡선을 지원합니다: geLinear, geQuadOut, geCubicOut, geCubicInOut, geBackOut. | 도움말 | |
| 테마 | 속성 하나로 라이트 및 다크 테마를 전환합니다: Theme := utDark. | 도움말 | |
| 스킨 | Skin은 등록된 스킨을 이름으로 고릅니다. Classic(기본 모양), Modern, Industrial, ISA101, Dark입니다. SkinData는 게이지 하나에 자신만의 색을 지정합니다. 문자판, 베젤, 트랙, 눈금, 레이블, 바늘, LED, 경보 수준, 입력 게이지의 각 부분과 함께 문자판, 베젤, 바늘 스타일, 레이블과 값의 굵기도 설정합니다. sgcGaugesRegisterSkin은 자신만의 스킨을 추가하고 sgcGaugesSetDefaultSkin은 모든 게이지에 스킨 하나를 적용합니다. 게이지에 직접 지정한 색이 스킨보다 우선하고, 스킨은 테마보다 우선하며, Windows 고대비 테마는 항상 우선합니다. 스킨은 JSON으로 저장하고 불러옵니다. | 도움말 | |
| 헤드리스 렌더링 | 모든 컨트롤과 모델의 SaveToPNG와 SaveToSVG이며 Linux64와 .NET ConsoleRender 데모에서도 동작합니다. | 도움말 | |
| 오른쪽에서 왼쪽 (아랍어와 히브리어) | 캡션과 단위 텍스트의 위치가 방향을 따릅니다. 다이얼, 시계, 나침반, VU 미터, 선형 및 링 진행 표시는 방향을 유지합니다. | 도움말 | |
| 인쇄 및 인쇄 미리 보기 | Print와 ShowPrintPreview는 게이지를 화면과 같이 한 페이지에, 애니메이션이 실행 중이어도 최종 값으로 인쇄합니다. PrintSettings는 용지, 방향, 여백, 배율, 머리글과 바닥글을 한 번 설정하면 프린터, 미리 보기, PDF에 모두 적용됩니다. 모든 에디션에서 VCL, FireMonkey, WinForms, WPF, Avalonia에서 사용할 수 있습니다(FireMonkey 인쇄는 Windows와 macOS에서 동작합니다). | 도움말 | |
| 접근 가능한 PDF 내보내기, PDF/UA 및 PDF/A(sgcPDF 사용) | ExportToPDF는 게이지를 실제 텍스트가 있는 벡터 그래픽으로 기록하며, 캡션, 값, 단위, 범위를 담은 대체 텍스트를 붙입니다. 파일은 기본적으로 태그가 지정된 PDF/UA 문서이며, PDFALevel로 PDF/A-2a 또는 PDF/A-3a를 추가할 수 있습니다. sgcUIPDF 브리지와 라이선스가 있는 sgcPDF가 필요합니다(.NET에서는 esegece.sgcUICore.sgcPDF). | Registered 에디션 | 도움말 |
| 접근성 | 모든 게이지 유형이 캡션, 값, 범위를 UI Automation에 노출하며, 임계값은 알림으로 전달됩니다. 게이지는 값만 표시하므로 기본적으로 탭 정지 지점이 아니며, TabStop을 설정하면 탭 순서에 포함됩니다. Windows 고대비를 따릅니다. Delphi 7~13의 VCL, Windows의 FireMonkey, WinForms, WPF, Avalonia에서 기본으로 켜져 있습니다. | 도움말 |
| 기능 | 세부 정보 | Community | 도움말 |
|---|---|---|---|
| 데이터셋 바인딩 | TsgcGaugeDataLink는 모든 VCL 또는 FireMonkey 게이지(DataSource, DataField, Gauge)에 데이터셋 필드의 값을 표시하고 현재 레코드, 편집, 게시를 따라갑니다. .NET에서는 DataTable 또는 DataView 열에 바인딩하며, TsgcWinFormsGaugeDataLink는 WinForms 폼의 CurrencyManager를 따릅니다. 입력 게이지에서 사용자가 한 변경은 OnBeforeWriteBack, OnWriteBack, OnWriteBackError와 함께 필드에 다시 기록되며, 거부되었거나 실패한 쓰기는 게이지를 필드 값으로 되돌립니다. WPF와 Avalonia에서는 입력 게이지의 Value와 Checked 속성이 뷰 모델에 양방향으로 바인딩됩니다. | ~필드 읽기는 모든 에디션에 있습니다. 쓰기 반영은 Registered 에디션입니다. | 도움말 |
| MQTT, WebSocket, SSE 바인딩 | sgcGaugesWS는 MQTT 토픽(+ 및 # 필터 지원)과 WebSocket 및 SSE 메시지의 JSON 필드를 ValuePath, FilterPath, FilterValue로 게이지 포인터에 바인딩합니다. sgcWebSockets가 필요합니다. | Registered 에디션 | 도움말 |
| 탱크와 프로세스 심볼 피드 | sgcGaugesWS의 MQTT, WebSocket, SSE 바인딩은 탱크의 수위와 프로세스 심볼의 상태를 구동합니다. 심볼은 "open"이나 "on" 같은 상태 이름도 받으며, ValueMap은 PLC 비트나 RUNNING 같은 상태 텍스트처럼 플랜트가 보내는 코드를 심볼 상태로 변환합니다. sgcWebSockets가 필요합니다. | Registered 에디션 | 도움말 |
.NET 게이지는 동일한 클래스 이름을 가진 C# 포트이며 WinForms, WPF, Avalonia를 지원하고 실시간 데이터 브리지는 별도 패키지로 제공됩니다.
| 패키지 | 에디션 | 내용 |
|---|---|---|
esegece.sgcGauges.Community | Community (무료) | 코어 라이브러리 |
esegece.sgcGauges.WinForms.Community | Community (무료) | Windows Forms 컨트롤 |
esegece.sgcGauges.Wpf.Community | Community (무료) | WPF 컨트롤 |
esegece.sgcGauges.Avalonia.Community | Community (무료) | Avalonia 컨트롤 |
esegece.sgcGauges.Rendering.Community | Community (무료) | 헤드리스 렌더링 |
esegece.sgcGauges | Registered 에디션 | 코어 라이브러리 |
esegece.sgcGauges.WinForms | Registered 에디션 | Windows Forms 컨트롤 |
esegece.sgcGauges.Wpf | Registered 에디션 | WPF 컨트롤 |
esegece.sgcGauges.Avalonia | Registered 에디션 | Avalonia 컨트롤 |
esegece.sgcGauges.Rendering | Registered 에디션 | 헤드리스 렌더링 |
esegece.sgcGauges.sgcWebSockets | Registered 에디션 전용 | sgcWebSockets 브리지 |
sgcGauges의 모든 기능은 sgcUI 도움말에 문서화되어 있으며, 개발 환경별로 별도의 도움말이 제공됩니다.
sgcUI 전체 도움말을 PDF 파일로 제공하며, 오프라인으로 읽거나 인쇄할 수 있습니다.
Delphi (PDF) →