Files
openhmi-nx/docs/RENDER.md
T
mangavalkandClaude Opus 5.5 f0bcc608b1 Render gauge needles pixel-exact
The needle is the display's own routine, measured on 112 needles in the
Editor simulator: tip from quadrant-reduced sin/cos, truncated; line from
tip to centre with a biased DDA; wider needles stamp wid x wid squares
along a line shortened by wid - 1. Length follows the height.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-15 16:05:41 +01:00

3.9 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 placeholder only
hotspot, touch cap, timer, variable nothing drawn (same as the Editor)

Rules learned from the Editor

  • 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, borderw for 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 (sta crop or image) get no frame.
  • Pictures are pasted at their real size; a smaller picture leaves the rest untouched.
  • Checkbox: bco fill, style frame, checked = pco square from w/4 to 3w/4.
  • Radio: circle sized by the component width (clipped to the box); ring radius r = (w-1)//2 around (r, r), colour (65,68,65), filled with bco; checked = pco dot of radius r // 2.
  • Circles (radio, and the display's cir/cirs commands): incremental midpoint routine -- start at x = r, y = 0; plot the 8 symmetric points; y += 1; if x*x - x + y*y + 2*y > r*r + 1 then x -= 1; repeat while x >= 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), length h//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)) with val in degrees, 0 = left, 90 = up, where sin/cos are taken after reducing the angle to 0..90 degrees (so sin 30 is a hair under 0.5 and 24*sin 30 truncates 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 a wid x wid square starting at -(wid//2).
  • 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: QR codes, Intelligent-only components (need Intelligent picture format 4), anti-aliased fonts, pressed/runtime states.