openhmi-nx: decode, encode, render Nextion HMI projects; .tft research
Black-box reverse-engineered .HMI format (container, three checksums, pages, all 31 component types, pictures, fonts), readable JSON, page renderer matching Nextion Editor, demo project built from code and a test suite (66 tests). See docs/COVERAGE.md for status. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
commit
69e22cfb06
70 files changed
+25058
No files matched your search
@@ -0,0 +1,98 @@
|
||||
"""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_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()
|
||||
Reference in new issue
Block a user