- SLText, TextSelect, DataRecord, FileBrowser pixel-exact against the Intelligent simulator; ComboBox and Switch with approximate anti-aliased edges; media/file components draw nothing - fonts: header byte 3 = 0x0A + direction, glyphs in the direction's pixel order, Intelligent glyph data 4-byte aligned -- reproduces the Editor's own font conversion byte for byte - Intelligent 3D frames: left edge drawn over the bottom edge Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
201 lines
10 KiB
Python
201 lines
10 KiB
Python
"""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))
|
|
|
|
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()
|