Files
openhmi-nx/src/nxhmi/render.py
T

362 lines
15 KiB
Python
Raw Normal View History

"""Render pages to images, the way Nextion Editor draws them on its canvas (needs Pillow).
Usage::
from nxhmi.render import Renderer
r = Renderer(HMIFile.load("project.HMI"))
r.render("main").save("main.png")
Covered: page background (colour / picture), picture, crop, text, scrolling text (static), number,
xfloat, button, dual-state button, slider, progress bar, checkbox, radio, gauge, waveform (frame +
grid), QR code (placeholder pattern). Invisible components (timer, variable, hotspot, touch cap)
draw nothing. See docs/RENDER.md for how close each one is to the Editor.
"""
from __future__ import annotations
import math
from .container import HMIFile
from .fonts import Font
from .page import Component, Page
from . import pictures
def rgb(v: int):
r, g, b = v >> 11, (v >> 5) & 63, v & 31
return (r << 3 | r >> 2, g << 2 | g >> 4, b << 3 | b >> 2)
class Renderer:
def __init__(self, hmi: HMIFile):
from PIL import Image # noqa: F401 (fail early if Pillow is missing)
self.h = hmi
self._pics = {}
self._fonts = {}
self.pages = {}
for e in hmi.live():
if e.name.endswith(".pa"):
p = Page.parse(hmi.read(e.name))
self.pages[p.name] = p
self.pages[int(e.name[:-3])] = p
# ------------------------------------------------------------------ resources
def pic(self, n: int):
if n not in self._pics:
try:
self._pics[n] = pictures.to_image(self.h.read("%d.i" % n))
except (KeyError, NotImplementedError):
self._pics[n] = None
return self._pics[n]
def font(self, n: int):
if n not in self._fonts:
try:
self._fonts[n] = Font.parse(self.h.read("%d.zi" % n))
except (KeyError, ValueError):
self._fonts[n] = None
return self._fonts[n]
# ------------------------------------------------------------------ page
def render(self, page) -> "Image":
from PIL import Image
p = self.pages[page]
pc = p.components[0]
w, h = pc.get("w") or 480, pc.get("h") or 320
img = Image.new("RGB", (w, h), (255, 255, 255))
sta = pc.get("sta")
if sta == 1:
img.paste(rgb(pc.get("bco")), (0, 0, w, h))
elif sta == 2:
pic = self.pic(pc.get("pic"))
if pic:
self._paste(img, pic, 0, 0, w, h, 0, 0)
for c in p.components[1:]:
self.draw(img, c)
return img
# ------------------------------------------------------------------ components
def draw(self, img, c: Component):
t = c.get("type")
fn = {116: self.text, 55: self.text, 98: self.text, 53: self.dual, 54: self.number, 59: self.xfloat,
112: self.picture, 113: self.crop, 1: self.slider, 106: self.progress, 56: self.checkbox,
57: self.radio, 122: self.gauge, 0: self.waveform, 58: self.qrcode}.get(t)
if fn:
fn(img, c)
@staticmethod
def _paste(img, src, sx, sy, w, h, dx, dy):
"""Paste src[sx:sx+w, sy:sy+h] at (dx, dy), clipped to src's real size (no black padding)."""
w = min(w, src.width - sx)
h = min(h, src.height - sy)
if w > 0 and h > 0:
img.paste(src.crop((sx, sy, sx + w, sy + h)), (dx, dy))
def _box(self, c):
x, y, w, h = c.get("x"), c.get("y"), c.get("w"), c.get("h")
return x, y, w, h
def _background(self, img, c, x, y, w, h):
sta = c.get("sta")
if sta == 0: # crop image: same area of picture picc
src = self.pic(c.get("picc"))
if src:
self._paste(img, src, x, y, w, h, x, y)
elif sta == 1:
img.paste(rgb(c.get("bco")), (x, y, x + w, y + h))
elif sta == 2:
src = self.pic(c.get("pic"))
if src:
self._paste(img, src, 0, 0, w, h, x, y)
def _border(self, img, c, x, y, w, h, override=None):
from PIL import ImageDraw
d = ImageDraw.Draw(img)
style = c.get("style") if override is None else override
if c.get("sta") in (0, 2) and c.get("type") in (98, 53):
return # picture-skinned buttons have no frame
if style == 1: # border
bw, bc = c.get("borderw") or 0, rgb(c.get("borderc") or 0)
for i in range(bw):
d.rectangle((x + i, y + i, x + w - 1 - i, y + h - 1 - i), outline=bc)
elif style in (2, 3, 4): # 3D down / up / auto(=up when released)
light, dark = (230, 226, 230), (65, 68, 65) # measured in Editor 1.68
if style == 2:
light, dark = dark, light
d.line((x, y, x + w - 1, y), fill=light); d.line((x, y, x, y + h - 1), fill=light)
d.line((x, y + h - 1, x + w - 1, y + h - 1), fill=dark); d.line((x + w - 1, y, x + w - 1, y + h - 1), fill=dark)
def _text(self, img, c, s, x, y, w, h, color):
font = self.font(c.get("font") or 0)
if font is None or not s:
return
spax, spay = c.get("spax") or 0, c.get("spay") or 0
xcen, ycen = c.get("xcen"), c.get("ycen")
wrap = c.get("isbr")
glyphs = {g.code: g for g in font.glyphs}
def gw(ch):
g = glyphs.get(ord(ch))
return (g.width if g else font.width) + spax
lines = []
for para in s.replace("\r\n", "\n").split("\n"):
cur = ""
for ch in para:
if wrap and cur and sum(gw(k) for k in cur + ch) - spax > w:
lines.append(cur); cur = ""
cur += ch
lines.append(cur)
line_h = font.height + spay
total_h = len(lines) * line_h - spay
if ycen == 1:
ty = y + max(0, (h - total_h) // 2) # never starts above the box
elif ycen == 2:
ty = y + max(0, h - total_h)
else:
ty = y
px = img.load()
W, H = img.size
# the Editor aligns the text *block* (widest line); lines are left-aligned inside it
block_w = max((sum(gw(k) for k in ln) - (spax if ln else 0)) for ln in lines)
for ln in lines:
lw = block_w
if xcen == 1:
tx = x + max(0, (w - lw) // 2)
elif xcen == 2:
tx = x + max(0, w - lw)
else:
tx = x
for ch in ln:
g = glyphs.get(ord(ch))
if g:
for gy, row in enumerate(g.pixels):
yy = ty + gy
if yy < y or yy >= y + h or yy >= H:
continue
for gx, v in enumerate(row):
xx = tx + gx
if v and x <= xx < x + w and 0 <= xx < W and yy >= 0:
px[xx, yy] = color
tx += gw(ch)
ty += line_h
def dual(self, img, c):
"""Dual-state button: val=1 shows the second skin (bco2 / pic2 / picc2) and pco2."""
x, y, w, h = self._box(c)
on = bool(c.get("val"))
sta = c.get("sta")
if sta == 1:
img.paste(rgb((c.get("bco2") if on else c.get("bco")) or 0), (x, y, x + w, y + h))
elif sta == 2:
src = self.pic(c.get("pic2") if on else c.get("pic"))
if src:
self._paste(img, src, 0, 0, w, h, x, y)
elif sta == 0:
src = self.pic(c.get("picc2") if on else c.get("picc"))
if src:
self._paste(img, src, x, y, w, h, x, y)
if on and c.get("style") == 4 and sta == 1:
self._border(img, c, x, y, w, h, override=2) # "on" looks pressed: 3D down
else:
self._border(img, c, x, y, w, h)
self._text(img, c, c.get("txt") or "", *self._inner(c, x, y, w, h),
rgb((c.get("pco2") if on else c.get("pco")) or 0))
def _inner(self, c, x, y, w, h):
"""Text area inside the border."""
style = c.get("style")
b = (c.get("borderw") or 0) if style == 1 else (1 if style in (2, 3, 4) else 0)
return x + b, y + b, w - 2 * b, h - 2 * b
def text(self, img, c):
x, y, w, h = self._box(c)
self._background(img, c, x, y, w, h)
self._border(img, c, x, y, w, h)
self._text(img, c, c.get("txt") or "", *self._inner(c, x, y, w, h), rgb(c.get("pco") or 0))
def number(self, img, c):
v = c.get("val") or 0
if v >= 0x80000000:
v -= 1 << 32
fmt, length = c.get("format"), c.get("lenth") or 0
s = ("%X" % (v & 0xFFFFFFFF)) if fmt == 2 else ("{:,}".format(v) if fmt == 1 else str(v))
if length and fmt != 1:
s = s.zfill(length)[-length:]
x, y, w, h = self._box(c)
self._background(img, c, x, y, w, h)
self._border(img, c, x, y, w, h)
self._text(img, c, s, *self._inner(c, x, y, w, h), rgb(c.get("pco") or 0))
def xfloat(self, img, c):
v = c.get("val") or 0
if v >= 0x80000000:
v -= 1 << 32
ints, decs = c.get("vvs0") or 0, c.get("vvs1") or 0
s = str(abs(v)).zfill(decs + 1)
s = (s[:-decs] + "." + s[-decs:]) if decs else s
if ints:
ip, _, dp = s.partition(".")
s = ip.zfill(ints)[-ints:] + ("." + dp if dp else "")
s = ("-" if v < 0 else "") + s
x, y, w, h = self._box(c)
self._background(img, c, x, y, w, h)
self._border(img, c, x, y, w, h)
self._text(img, c, s, *self._inner(c, x, y, w, h), rgb(c.get("pco") or 0))
def picture(self, img, c):
src = self.pic(c.get("pic"))
if src:
x, y, w, h = self._box(c)
self._paste(img, src, 0, 0, w, h, x, y)
def crop(self, img, c):
src = self.pic(c.get("picc"))
if src:
x, y, w, h = self._box(c)
self._paste(img, src, x, y, w, h, x, y)
def slider(self, img, c):
from PIL import ImageDraw
x, y, w, h = self._box(c)
self._background(img, c, x, y, w, h)
d = ImageDraw.Draw(img)
vmin, vmax, val = c.get("minval") or 0, c.get("maxval") or 100, c.get("val") or 0
frac = 0 if vmax == vmin else (val - vmin) / (vmax - vmin)
vertical = c.get("mode") == 1
cw = c.get("wid"); ch = c.get("hig")
if c.get("psta") == 1: # picture cursor (pic2) at its own size
knob = self.pic(c.get("pic2"))
if knob:
kw, kh = knob.size
if vertical:
ky = y + h - kh - int(frac * (h - kh))
img.paste(knob, (x + (w - kw) // 2, ky))
else:
kx = x + int(frac * (w - kw))
img.paste(knob, (kx, y + (h - kh) // 2))
return
# "auto" (255) cursor = a square as thick as the slider
if vertical:
cw = w if cw in (None, 255) else cw
ch = w if ch in (None, 255) else ch
cy = y + h - ch - int(frac * (h - ch)) # truncates, like the Editor
d.rectangle((x + (w - cw) // 2, cy, x + (w - cw) // 2 + cw - 1, cy + ch - 1), fill=rgb(c.get("pco") or 0))
else:
ch = h if ch in (None, 255) else ch
cw = h if cw in (None, 255) else cw
cx = x + int(frac * (w - cw)) # truncates, like the Editor
d.rectangle((cx, y + (h - ch) // 2, cx + cw - 1, y + (h - ch) // 2 + ch - 1), fill=rgb(c.get("pco") or 0))
def progress(self, img, c):
from PIL import ImageDraw
x, y, w, h = self._box(c)
d = ImageDraw.Draw(img)
val = max(0, min(100, c.get("val") or 0))
if c.get("sta") == 1: # picture mode: bpic background, ppic foreground
bg, fg = self.pic(c.get("bpic")), self.pic(c.get("ppic"))
if bg:
self._paste(img, bg, 0, 0, w, h, x, y)
if fg:
if c.get("dez") == 1:
fh = h * val // 100
if fh:
self._paste(img, fg, 0, h - fh, w, fh, x, y + h - fh)
else:
fw = w * val // 100
if fw:
self._paste(img, fg, 0, 0, fw, h, x, y)
return
d.rectangle((x, y, x + w - 1, y + h - 1), fill=rgb(c.get("bco") or 0))
if c.get("dez") == 1:
fh = h * val // 100
if fh:
d.rectangle((x, y + h - fh, x + w - 1, y + h - 1), fill=rgb(c.get("pco") or 0))
else:
fw = w * val // 100
if fw:
d.rectangle((x, y, x + fw - 1, y + h - 1), fill=rgb(c.get("pco") or 0))
def checkbox(self, img, c):
from PIL import ImageDraw
x, y, w, h = self._box(c)
d = ImageDraw.Draw(img)
d.rectangle((x, y, x + w - 1, y + h - 1), fill=rgb(c.get("bco") or 0))
self._border(img, c, x, y, w, h)
if c.get("val"): # filled square, half the size, centred
d.rectangle((x + w // 4, y + h // 4, x + 3 * w // 4 - 1, y + 3 * h // 4 - 1), fill=rgb(c.get("pco") or 0))
def radio(self, img, c):
from PIL import ImageDraw
x, y, w, h = self._box(c)
d = ImageDraw.Draw(img)
d.ellipse((x, y, x + w - 2, y + h - 2), fill=rgb(c.get("bco") or 0), outline=(65, 68, 65))
if c.get("val"):
d.ellipse((x + w // 4, y + h // 4, x + 3 * w // 4 - 2, y + 3 * h // 4 - 2), fill=rgb(c.get("pco") or 0))
def gauge(self, img, c):
from PIL import ImageDraw
x, y, w, h = self._box(c)
self._background(img, c, x, y, w, h)
d = ImageDraw.Draw(img)
r = min(w, h) // 2 - 1
cx, cy = x + w // 2, y + h // 2
a = math.radians(c.get("val") or 0)
d.line((cx, cy, cx - int(r * math.cos(a)), cy - int(r * math.sin(a))), fill=rgb(c.get("pco") or 0),
width=max(1, c.get("wid") or 1))
def waveform(self, img, c):
from PIL import ImageDraw
x, y, w, h = self._box(c)
self._background(img, c, x, y, w, h)
d = ImageDraw.Draw(img)
gw, gh, gc = c.get("gdw") or 0, c.get("gdh") or 0, rgb(c.get("gdc") or 0)
if gw:
for xx in range(x, x + w, gw):
d.line((xx, y, xx, y + h - 1), fill=gc)
if gh: # horizontal lines count from the bottom
for yy in range(y + h - 1, y - 1, -gh):
d.line((x, yy, x + w - 1, yy), fill=gc)
def qrcode(self, img, c):
x, y, w, h = self._box(c)
img.paste(rgb(c.get("bco") or 0xFFFF), (x, y, x + w, y + h))