Files
openhmi-nx/tests/test_render.py
T

200 lines
10 KiB
Python
Raw Normal View History

"""Renderer rules, each one measured against Nextion Editor 1.68 (see docs/RENDER.md)."""
import unittest
from helpers import FIXTURE, HAVE_PIL
from nxhmi import components as C
from nxhmi.container import HMIFile, build
@unittest.skipUnless(HAVE_PIL, "needs Pillow")
class Render(unittest.TestCase):
def render(self, page):
from nxhmi.render import Renderer
return Renderer(build([("0.pa", page.pack())])).render(page.name)
def test_page_solid(self):
p = C.new_page("p", w=40, h=20, bco=0x001F)
self.assertEqual(self.render(p).getpixel((5, 5)), (0, 0, 255))
def test_progress_bar(self):
p = C.new_page("p", w=100, h=40)
C.add(p, "progress_bar", x=10, y=10, w=50, h=10, val=50, bco=0, pco=0xF800)
img = self.render(p)
self.assertEqual(img.getpixel((20, 15)), (255, 0, 0))
self.assertEqual(img.getpixel((50, 15)), (0, 0, 0))
def test_slider_auto_cursor_truncates(self):
p = C.new_page("p", w=240, h=40)
C.add(p, "slider", x=0, y=0, w=200, h=25, val=50, minval=0, maxval=100, pco=0x07E0, bco=0)
img = self.render(p)
# cursor is 25 px wide (auto = slider thickness), at int(0.5 * 175) = 87
self.assertEqual(img.getpixel((87, 10)), (0, 255, 0))
self.assertEqual(img.getpixel((86, 10)), (0, 0, 0))
self.assertEqual(img.getpixel((111, 10)), (0, 255, 0))
self.assertEqual(img.getpixel((112, 10)), (0, 0, 0))
def test_3d_border_colours(self):
p = C.new_page("p", w=60, h=40)
C.add(p, "button", x=0, y=0, w=50, h=30, style=4, sta=1, bco=0xBDF7, txt="")
img = self.render(p)
self.assertEqual(img.getpixel((10, 0)), (230, 226, 230))
self.assertEqual(img.getpixel((10, 29)), (65, 68, 65))
def test_picture_button_has_no_frame(self):
p = C.new_page("p", w=60, h=40)
b = C.add(p, "button", x=0, y=0, w=50, h=30, style=4, sta=1, bco=0x0000, txt="")
b.set("sta", 2) # picture skin, picture missing -> nothing drawn
img = self.render(p)
self.assertEqual(img.getpixel((10, 0)), (255, 255, 255))
def test_waveform_grid_from_bottom(self):
p = C.new_page("p", w=100, h=100)
C.add(p, "waveform", x=0, y=0, w=50, h=50, gdw=20, gdh=20, gdc=0x07E0, sta=1, bco=0)
img = self.render(p)
self.assertEqual(img.getpixel((5, 49)), (0, 255, 0)) # bottom row is a grid line
self.assertEqual(img.getpixel((5, 29)), (0, 255, 0))
self.assertEqual(img.getpixel((5, 0)), (0, 0, 0))
def test_checkbox(self):
p = C.new_page("p", w=100, h=100)
C.add(p, "checkbox", x=0, y=0, w=40, h=40, val=1, bco=0xFFFF, pco=0x001F, style=0)
img = self.render(p)
self.assertEqual(img.getpixel((10, 10)), (0, 0, 255))
self.assertEqual(img.getpixel((9, 9)), (255, 255, 255))
self.assertEqual(img.getpixel((29, 29)), (0, 0, 255))
self.assertEqual(img.getpixel((30, 30)), (255, 255, 255))
def test_dual_state_on_is_pressed(self):
p = C.new_page("p", w=60, h=40)
C.add(p, "dual_state_button", x=0, y=0, w=50, h=30, val=1, style=4, sta=1, txt="")
img = self.render(p)
self.assertEqual(img.getpixel((10, 0)), (65, 68, 65)) # dark top edge when on
def test_circle_routine(self):
from nxhmi.render import circle_octant, disc_rows
# measured from the Editor simulator (`cir 240,160,39,0`)
self.assertEqual(circle_octant(39), [(39, 0), (39, 1), (39, 2), (39, 3), (39, 4), (39, 5), (38, 6), (38, 7),
(38, 8), (38, 9), (37, 10), (37, 11), (37, 12), (36, 13), (36, 14), (36, 15),
(35, 16), (35, 17), (34, 18), (34, 19), (33, 20), (32, 21), (32, 22), (31, 23),
(30, 24), (29, 25), (28, 26), (27, 27)])
self.assertEqual(circle_octant(13)[-1], (9, 9)) # diagonal point kept
self.assertEqual(disc_rows(19)[19], 3)
def test_radio(self):
p = C.new_page("p", w=100, h=100)
C.add(p, "radio", x=0, y=0, w=80, h=80, val=1, bco=0xFFE0, pco=0x001F)
img = self.render(p)
self.assertEqual(img.getpixel((0, 39)), (65, 68, 65)) # ring, radius 39 around (39, 39)
self.assertEqual(img.getpixel((39, 39)), (0, 0, 255)) # dot radius 19
self.assertEqual(img.getpixel((39 + 19, 39)), (0, 0, 255))
self.assertEqual(img.getpixel((39 + 20, 39)), (255, 255, 0))
2026-11-15 16:05:41 +01:00
def test_gauge_needle(self):
from nxhmi.render import gauge_needle, qsin
# all measured in the Editor simulator
thin = gauge_needle(58, 58, 9, 1) # tip (2, 25), runs of 7 counted from the centre
self.assertEqual(len(thin), 28)
self.assertEqual({y for x, y in thin if 22 <= x <= 28}, {28})
self.assertEqual({y for x, y in thin if 2 <= x <= 7}, {25})
self.assertIn((29, 29), thin)
self.assertLess(qsin(30), 0.5) # reduced to 0..90 degrees, a hair under 0.5
self.assertIn((15, 14), gauge_needle(70, 50, 30, 1)) # tip: 24*sin(30) truncates to 11
self.assertIn((-4, 19), gauge_needle(50, 70, 30, 1)) # radius from height, leaves the box
self.assertEqual(len(gauge_needle(58, 58, 46, 5)), 174) # 5x5 squares along a shorter line
self.assertEqual(len(gauge_needle(58, 58, 69, 8)), 265)
self.assertEqual(gauge_needle(58, 58, 0, 2), {(x, y) for x in range(1, 30) for y in (28, 29)})
def test_intelligent_alpha_blend(self):
# measured in the Intelligent simulator: page blue, picture (255, 0, 41) with 7-bit alpha 97
import io
from PIL import Image
from nxhmi import project
from nxhmi.page import Page
from nxhmi.render import Renderer, rgb
self.assertEqual(rgb(0xC618, 3), (197, 194, 197))
h = project.new_project("NX4827P043_011")
im = Image.new("RGBA", (3, 1), (255, 0, 40, 195)) # 3 px: 1-2 px pictures stay format 0
im.putpixel((1, 0), (255, 0, 40, 255))
b = io.BytesIO(); im.save(b, "PNG")
pid = project.add_picture(h, b.getvalue())
p = Page.parse(h.read("0.pa"))
p.components[0].set("bco", 0x001F)
C.add(p, "picture", x=0, y=0, w=3, h=1, pic=pid)
h.write("0.pa", p.pack())
img = Renderer(h).render("page0")
self.assertEqual(img.getpixel((0, 0)), (194, 0, 92))
self.assertEqual(img.getpixel((1, 0)), (255, 0, 41))
def _intelligent(self, font_px=16):
from nxhmi import fonts, project
from nxhmi.page import Page
h = project.new_project("NX8048P050_011")
fid = project.add_font(h, fonts.from_ttf(None, font_px))
p = Page.parse(h.read("0.pa"))
p.components[0].set("bco", 0x001F)
return h, p, fid
def test_text_select(self):
# measured in the Intelligent simulator (see RENDER.md)
from nxhmi.render import Renderer
h, p, fid = self._intelligent()
C.add(p, "text_select", x=0, y=0, w=90, h=200, font=fid, hig=42, pco1=0x07E0)
C.add(p, "text_select", x=100, y=0, w=100, h=230, font=fid, hig=55, style=1, borderw=3)
h.write("0.pa", p.pack())
img = Renderer(h).render("page0")
self.assertEqual(img.getpixel((5, 79)), (0, 255, 0)) # lines at (h-hig)//2 ...
self.assertEqual(img.getpixel((5, 120)), (0, 255, 0)) # ... and mirrored at the bottom
self.assertEqual(img.getpixel((105, 87)), (0, 0, 255)) # inside the border, odd gap
self.assertEqual(img.getpixel((105, 142)), (0, 0, 255))
top_row = {img.getpixel((x, 12)) for x in range(90)} - {(255, 255, 255)}
self.assertEqual(top_row, {(182, 182, 182)}) # faded: alpha (127 // 42) * 12
def test_data_record_columns(self):
from nxhmi.render import Renderer
h, p, fid = self._intelligent()
C.add(p, "data_record", x=0, y=0, w=187, h=150, font=fid, dir="h0^h1", dez=4, hig=20, style=0)
h.write("0.pa", p.pack())
img = Renderer(h).render("page0")
grid = [x for x in range(187) if img.getpixel((x, 5)) == (197, 194, 197)]
self.assertEqual(grid, [0, 46, 92, 139, 186]) # last columns take the remainder
def test_switch_and_combobox_structure(self):
from nxhmi.render import Renderer
h, p, fid = self._intelligent()
C.add(p, "switch", x=0, y=0, w=120, h=40, val=1, dis=0, font=fid, txt="Off/On",
bco=0xF800, pco=0x07E0, bco2=0xFFE0, pco2=0xF81F, pco1=0)
C.add(p, "combobox", x=200, y=0, w=60, h=30, dis=5, font=fid)
h.write("0.pa", p.pack())
img = Renderer(h).render("page0")
self.assertEqual(img.getpixel((0, 0)), (255, 255, 0)) # on: bco2 track, square corners
self.assertEqual(img.getpixel((100, 19)), (255, 0, 255)) # knob on the right in pco2
ink = [x for x in range(80) if img.getpixel((x, 20)) == (0, 0, 0)]
self.assertEqual(min(ink), 32) # "On" centred in [0, w-h)
self.assertEqual(img.getpixel((200, 0)), (255, 255, 255)) # radius 30*5//200 < 3: square
def test_demo_pages_render(self):
from nxhmi.render import Renderer
r = Renderer(HMIFile.load(FIXTURE))
for name in ("home", "controls", "gallery"):
img = r.render(name)
self.assertEqual(img.size, (480, 320))
self.assertEqual(r.render("home").getpixel((0, 319)), r.pic(0).getpixel((0, 319)))
def test_text_clamped_inside_box(self):
from nxhmi import fonts, project
from nxhmi.render import Renderer
h = project.new_project()
fid = project.add_font(h, fonts.from_ttf(None, 32))
from nxhmi.page import Page
p = Page.parse(h.read("0.pa"))
C.add(p, "text", x=0, y=0, w=200, h=20, txt="Hg", font=fid, ycen=1, sta=1, bco=0xFFFF, pco=0)
h.write("0.pa", p.pack())
img = Renderer(h).render("page0")
ink_rows = [y for y in range(20) if any(img.getpixel((x, y)) == (0, 0, 0) for x in range(200))]
self.assertTrue(ink_rows and ink_rows[0] >= 0)
self.assertEqual(img.getpixel((10, 25)), (255, 255, 255)) # nothing drawn below the box
if __name__ == "__main__":
unittest.main()