cliu/ci-server-engineer
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
ci-server-engineer/examples/CI-Eng-Sample/displays/generator/README.md
cliu 266e9e3710 Sample: CIENG uses the factory OPERATOR group; correct arc and rounding notes 
- Group CIENG_OPERATOR dropped (08, 85, load.cmd, README): the live-data Start also works for a
  user in the factory group OPERATOR (tested 2026-10-06 as OPER), so EXECUTE_GENERAL_COMMANDS is
  not needed; 08b_user_df.qli gives CIENG the group OPERATOR
- remove.cmd / README: open CIENG session note reworded
- Generator README / cixml.py: arc angles run clockwise from 3 o'clock on desktop and web (fixed
  and connected; the earlier "mirrored on the desktop" note was wrong); rounding above 1 draws an
  ellipse on both clients
- Tested on CI Server R1.03.00 2026-10-06: CIENG logon (empty password) and Start with group
  OPERATOR; test display with static and connected arcs on both clients

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-06 11:16:58 +11:00

2.9 KiB
Raw Blame History

Display generator (CI-Eng-Sample operator HMI)

A small Python tool that writes the CI-Eng-Sample display files (..\CIENG_*.xml) instead of drawing them in the Edit Module. The XML is the same format the Edit Module saves (display definition 1.3.0.0, HTML display on), so the files run in the Operator Interface (desktop) and in the HTML display (web), and they can still be opened and changed in the Edit Module afterwards (but a later generator run overwrites such changes).

Built and tested with CI Server R1.03.00, Python 3.12 and Pillow, 2026-10-06.

Files

File Purpose
cixml.py Library: a Display class with one method per component (rectangle, text, number, number/text/date-time field, button, toggle, check box, slider, spinner, combo box, data bar, scales, arc / ring gauge, lamp, alarm overview, report, micro trend, trend), item connections, linear and threshold transformations, actions (open / close display, set item value, execute command) and the dark colour theme
build.py The eight sample displays: CIENG_Header, CIENG_Overview, CIENG_Control, CIENG_Trends, CIENG_Alarms, CIENG_System, CIENG_AlarmBanner (layout CIENG_Operator) and CIENG_TankFaceplate (layout CIENG_Popup)

Use

python build.py            (writes ..\CIENG_*.xml)
python build.py <folder>   (writes into another folder)

Then deploy with ..\deploy_displays.cmd. Requirements: Python 3, Pillow (pip install pillow; used to measure text widths with the Windows fonts Segoe UI and Consolas). Without Pillow it falls back to an estimate and left/right-aligned texts land slightly off.

How it works (rules learned on R1.03.00)

  • Positions are boxes (left, top, width, height); the file stores the centre plus half sizes.
  • Texts and numbers use keep original size: the HTML export draws them at their font size centred on the box (otherwise the text is stretched to the box). The box is therefore shrunk to the measured text width for left / right alignment.
  • Rectangle rounding is stored as a fraction (0..1) of the half size; values above 1 draw an ellipse (desktop and web).
  • The tab displays are designed 1880 x 680 and stretched to 1880 x 760 (design_h): panels, bars, lists and trends grow, texts / controls / round shapes keep their size and only move.
  • Arc angles (desktop and web alike, fixed or connected): degrees clockwise from 3 o'clock (screen y points down), negative values allowed - not the counter-clockwise maths convention. The ring gauges have the gap on the right and the value growing from 9 o'clock up and down.
  • The live-data button runs C:\Users\Public\CI-Eng-Sample\feed\cieng_feed_start.cmd on the server (FEED_START in build.py; installed by ..\..\feed\install_feed.ps1).
  • Trend: trend(..., web_spares=True) pads a trend to 50 pens so it also draws on the web; the sample trend uses web_spares=False (2 pens, clean desktop hairline, no line on the web).