GHIElectronics.Endpoint.Devices.Touch 0.5.3__py3-none-any.whl

GHIElectronics/Endpoint/Devices/Touch/__init__.py

@@ -0,0 +1,150 @@
+"""Touchscreens on Endpoint.
+
+Touch is abstract: subclass it for your panel's chip (I2C, SPI, custom).
+Interrupt-driven drivers are first class - open a GPIO line via
+GHIElectronics.Endpoint.Devices.Gpio and attach to its ValueChanged event.
+
+The library ships one concrete subclass, InputTouch, that wraps a kernel
+/dev/input/eventN. USB HID touchscreens show up this way automatically.
+
+    from GHIElectronics.Endpoint.Devices.Touch import Touch
+
+    class MyFt5x06(Touch):
+        # ... open I2C, pulse reset, attach to interrupt GPIO ...
+        @property
+        def Width(self): return 800
+        @property
+        def Height(self): return 480
+        @property
+        def Connected(self): return True
+        def Dispose(self): ...
+
+    t = MyFt5x06(i2c_bus=6, address=0x38, reset_pin=\"PF2\", int_pin=\"PF12\")
+    t.OnChangedEvent += lambda s, e: print(e.Points)
+"""
+
+import abc
+import ctypes
+import sys
+from enum import IntEnum
+
+from GHIElectronics.Endpoint.Core._event import _EventProperty
+from GHIElectronics.Endpoint.Core._native import TouchCallback, native
+
+
+class TouchEventType(IntEnum):
+    """How the Points changed between frames."""
+    Pressed = 0
+    Released = 1
+    Moved = 2
+
+
+class TouchPoint:
+    """One finger on the touchscreen."""
+    __slots__ = ("Id", "X", "Y")
+
+    def __init__(self, id_, x, y):
+        self.Id = id_
+        self.X = x
+        self.Y = y
+
+    def __repr__(self):
+        return f"TouchPoint(Id={self.Id}, X={self.X}, Y={self.Y})"
+
+
+class TouchEventArgs:
+    def __init__(self, eventType, points):
+        self.EventType = eventType
+        self.Points = points
+
+
+class Touch(abc.ABC):
+    """A touchscreen on the board. Abstract: subclass for custom chips, use
+    GetDefault() for a kernel /dev/input/eventN device (USB touchscreens)."""
+
+    OnChangedEvent = _EventProperty("OnChangedEvent")
+
+    @property
+    @abc.abstractmethod
+    def Width(self):
+        """Visible width of the touchscreen area, in pixels."""
+
+    @property
+    @abc.abstractmethod
+    def Height(self):
+        """Visible height of the touchscreen area, in pixels."""
+
+    @property
+    @abc.abstractmethod
+    def Connected(self):
+        """True while the touchscreen is physically present and responding."""
+
+    @abc.abstractmethod
+    def Dispose(self):
+        """Release the touchscreen's resources (I2C handle, GPIO, etc.)."""
+
+    def _RaiseChanged(self, args):
+        """Subclasses call this to emit a touch event. Exceptions in handlers
+        are printed, never raised back out of the device thread."""
+        try:
+            handler = self.OnChangedEvent
+            if handler is not None:
+                handler(self, args)
+        except Exception as e:
+            print(f"Unhandled exception in a Touch event: {e}", file=sys.stderr)
+
+    @staticmethod
+    def GetDefault():
+        """The first kernel-exposed touchscreen the library can find at
+        /dev/input/eventN, or None if none is present. For USB HID
+        touchscreens; the on-board panel's custom chip is the customer's
+        own subclass and does not come through here."""
+        return InputTouch._find_default()
+
+
+class InputTouch(Touch):
+    """Touchscreen backed by a kernel input device at /dev/input/eventN."""
+
+    def __init__(self, deviceName):
+        self.DeviceName = deviceName
+        self._handle = native.out_handle()
+        self._callback = TouchCallback(self._OnChanged)
+        native.touch_open(deviceName.encode(), self._callback, None, native.ref(self._handle))
+        v, p, c, w, h = (native.out_int() for _ in range(5))
+        native.touch_info(self._handle, native.ref(v), native.ref(p), native.ref(c),
+                          native.ref(w), native.ref(h))
+        self.VendorId = v.value
+        self.ProductId = p.value
+        self._connected = c.value != 0
+        self._width = w.value
+        self._height = h.value
+        native.keep_alive(self)
+
+    @property
+    def Width(self):
+        return self._width
+
+    @property
+    def Height(self):
+        return self._height
+
+    @property
+    def Connected(self):
+        return self._connected
+
+    @classmethod
+    def _find_default(cls):
+        buffer = ctypes.create_string_buffer(64)
+        native.touch_find_default(buffer, len(buffer))
+        path = buffer.value.decode("ascii")
+        return cls(path) if path else None
+
+    def Dispose(self):
+        if self._handle:
+            native.touch_close(self._handle)
+            self._handle = None
+            native.let_go(self)
+
+    def _OnChanged(self, _context, eventType, pointCount, ids, xs, ys):
+        points = [TouchPoint(ids[i], xs[i], ys[i]) for i in range(pointCount)]
+        self._RaiseChanged(TouchEventArgs(TouchEventType(eventType), points))

ghielectronics_endpoint_devices_touch-0.5.3.dist-info/METADATA

@@ -0,0 +1,20 @@
+Metadata-Version: 2.4
+Name: GHIElectronics.Endpoint.Devices.Touch
+Version: 0.5.3
+Summary: Touchscreen support for Endpoint. The Touch class is abstract: subclass it for your panel's chip. Ships one concrete subclass, InputTouch, that wraps a kernel /dev/input/eventN (used for USB touchscreens).
+Author-email: "GHI Electronics, LLC" <support@ghielectronics.com>
+License-Expression: MIT
+Project-URL: Homepage, https://www.ghielectronics.com/
+Project-URL: Repository, https://github.com/ghi-electronics/Endpoint-Libraries
+Project-URL: Issues, https://github.com/ghi-electronics/Endpoint-Libraries/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: POSIX :: Linux
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: GHIElectronics.Endpoint.Core<0.6,>=0.5.3
+
+# GHIElectronics.Endpoint.Devices.Touch
+
+Touchscreen support for Endpoint. The Touch class is abstract: subclass it for your panel's chip. Ships one concrete subclass, InputTouch, that wraps a kernel /dev/input/eventN (used for USB touchscreens).
+
+Part of the [GHI Electronics Endpoint](https://github.com/ghi-electronics/Endpoint-Libraries) libraries. See the repository README for the full package list and getting-started guide.

ghielectronics_endpoint_devices_touch-0.5.3.dist-info/RECORD

@@ -0,0 +1,5 @@
+GHIElectronics/Endpoint/Devices/Touch/__init__.py,sha256=PQJSIiPvVHXG-orl7mDcyN5zOujsANdDfIrVgjkaMpE,4734
+ghielectronics_endpoint_devices_touch-0.5.3.dist-info/METADATA,sha256=IQSlLa5RhijehpfU4q08BQ_w_7AM87zwr9a35K933E4,1269
+ghielectronics_endpoint_devices_touch-0.5.3.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+ghielectronics_endpoint_devices_touch-0.5.3.dist-info/top_level.txt,sha256=NpOZNgd0iquwrRPrTOhUDxc2V9TtNFLv5Z_Dx3YZtIU,15
+ghielectronics_endpoint_devices_touch-0.5.3.dist-info/RECORD,,

ghielectronics_endpoint_devices_touch-0.5.3.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ghielectronics_endpoint_devices_touch-0.5.3.dist-info/top_level.txt

@@ -0,0 +1 @@
+GHIElectronics