5.3 KiB
5.3 KiB
Page rendering vs. Nextion Editor
python -m nxhmi render project.HMI out/ draws every page the way Nextion Editor 1.68 shows it on
its canvas. Verified by capturing the Editor's canvas at 100 % zoom and comparing pixel by pixel
(ignoring the Editor's yellow name tags and its 2-px selection outline).
Results
The demo project (demo/demo.HMI, built by examples/make_demo.py):
| Page | Differing pixels | Notes |
|---|---|---|
| home | 25 | name-tag edges (checkbox, buttons) |
| controls | 5 | name-tag edges |
| gallery | 1 | name-tag edge |
A real 6-page user project (pictures, 32-px bitmap font, texts, 3D buttons, sliders): every page pixel-identical apart from 0-5 px at name-tag edges.
Per component (dedicated test pages):
| Component | Match | Notes |
|---|---|---|
| text (all xcen/ycen, solid / crop / image background, border, 3D up/down) | 100 % | |
| text with word wrap | 100 % | the text block is aligned as a whole, lines left-aligned in it |
| number (plain, fixed length, hex, currency, negative), xfloat | 100 % | |
| button, dual-state button (colour and picture skins, on/off) | 100 % | "on" with 3D style is drawn pressed (3D down) |
| scrolling text (static) | 100 % | |
| progress bar (horizontal, vertical, picture mode) | 100 % | |
| slider (horizontal, vertical, auto cursor, picture background and cursor) | 100 % | auto cursor = square as thick as the slider; position truncates |
| checkbox (3D down, border, flat) | 100 % | |
| picture, crop (also smaller than the component) | 100 % | only the picture's real area is drawn |
| waveform (frame + grid) | 100 % | horizontal grid lines count from the bottom |
| gauge (every angle, needle width 1-8, odd/even/non-square sizes) | 100 % | the needle routine, see below |
| radio (all sizes, also non-square) | 100 % | the display's own circle routine, see below |
| QR code (byte/alphanumeric/numeric text, versions 1-8, margins, colours, logo, Latin-1) | 100 % | own encoder (nxhmi.qr), see below |
| hotspot, touch cap, timer, variable | nothing drawn (same as the Editor) |
Rules learned from the Editor
- Colours: RGB565 is expanded differently per series. Basic replicates the top bits
(
r<<3 | r>>2); Intelligent scales (r*255//31,g*255//63), so0xC618shows as (198,195,198) on Basic and (197,194,197) on Intelligent. - Intelligent pictures with alpha (format 4, 7-bit alpha
a): 8-bit alpha is2*a(127 = 255), blended asbg + round((src - bg) * alpha / 255)per channel. Exact against the Intelligent simulator (342 samples). The Editor canvas blends slightly differently (up to 3 levels off at high alpha); the renderer follows the simulator, i.e. the display. - Text never starts above/left of its box: centring clamps at 0 (a 32-px font in a 30-px box starts at the top).
- Text is laid out inside the border: 1 px for 3D styles,
borderwfor style "border". - 3D colours are fixed: light (230,226,230), dark (65,68,65) -- top/left light for 3D up/auto, dark for 3D down.
- Buttons with a picture background (
stacrop or image) get no frame. - Pictures are pasted at their real size; a smaller picture leaves the rest untouched.
- Checkbox:
bcofill,styleframe, checked =pcosquare from w/4 to 3w/4. - Radio: circle sized by the component width (clipped to the box); ring radius
r = (w-1)//2around(r, r), colour (65,68,65), filled withbco; checked =pcodot of radiusr // 2. - Circles (radio, and the display's
cir/cirscommands): incremental midpoint routine -- start atx = r, y = 0; plot the 8 symmetric points;y += 1; ifx*x - x + y*y + 2*y > r*r + 1thenx -= 1; repeat whilex >= y. Filled circles are every pixel inside that ring. Verified for every radius 1..159 against the Editor's simulator. - Gauge needle (verified on 112 needles): centre
(w//2, h//2), lengthh//2 - wid(the height sets it, also for non-square gauges, so the needle can leave the box). Tip = centre +(int(-len*cos a), int(-len*sin a))withvalin degrees, 0 = left, 90 = up, where sin/cos are taken after reducing the angle to 0..90 degrees (sosin 30is a hair under 0.5 and24*sin 30truncates to 11). The line runs from the tip to the centre: step the major axis, minor offset(k*minor + minor - 1) // major. Width > 1: every line pixel is stamped with awidxwidsquare starting at-(wid//2). - QR code: the text's bytes (iso-8859-1) encoded in numeric mode if all digits, alphanumeric
if all in
0-9A-Z $%*+-./:, else byte mode; error correction L, mask 0 always, the smallest version that fits. Drawn into a square ofw - 2*dispx at(dis, dis)-- sized by the width only and not clipped toh; pixelpshows modulep*N//size. Dark runs are drawn column by column and the last one (last column, reaching the bottom) is one pixel narrower. Fewer pixels than modules or empty text: only thebcobackground.sta1: picturepicpasted centred in the box. Big codes can exceed a Basic display's RAM (the Editor refuses to compile), the canvas still draws them. - Slider: auto cursor (255) is a square as thick as the slider; position =
int(frac * free). - Waveform: vertical grid lines from the left edge, horizontal ones counted from the bottom.
Not covered yet: Intelligent-only components (need Intelligent picture format 4), anti-aliased fonts, pressed/runtime states.