kopia lustrzana https://github.com/peterhinch/micropython-micro-gui
103 wiersze
3.8 KiB
Python
103 wiersze
3.8 KiB
Python
# region.py Extension to nanogui providing the Region class
|
|
|
|
# Released under the MIT License (MIT). See LICENSE.
|
|
# Copyright (c) 2021 Peter Hinch
|
|
|
|
# Usage:
|
|
# from gui.widgets.tstat import Tstat
|
|
|
|
from gui.core.ugui import display
|
|
from gui.core.colors import *
|
|
from gui.widgets.meter import Meter
|
|
|
|
class Region:
|
|
# Callback reasons
|
|
EX_WB_IA = 1 # Exit region. Was below. Is above.
|
|
EX_WB_IB = 2 # Exit, was below, is below
|
|
EX_WA_IA = 4 # Exit, was above, is above.
|
|
EX_WA_IB = 8 # Exit, was above, is below
|
|
T_IA = 16 # Transit, is above
|
|
T_IB = 32 # Transit, is below
|
|
EN_WA = 64 # Entry, was above
|
|
EN_WB = 128 # Entry, was below
|
|
|
|
def __init__(self, tstat, vlo, vhi, color, callback, args=()):
|
|
tstat.regions.add(self)
|
|
tstat.draw = True
|
|
self.tstat = tstat
|
|
if vlo >= vhi:
|
|
raise ValueError('TStat Region: vlo must be < vhi')
|
|
self.vlo = vlo
|
|
self.vhi = vhi
|
|
self.color = color
|
|
self.cb = callback
|
|
self.args = args
|
|
v = self.tstat.value() # Get current value
|
|
self.is_in = vlo <= v <= vhi # Is initial value in region
|
|
# .wa: was above. Value prior to any entry to region.
|
|
self.wa = None # None indicates unknown
|
|
|
|
# Where prior state is unknown because instantiation occurred with a value
|
|
# in the region (.wa is None) we make the assumption that, on exit, it is
|
|
# leaving from the opposite side from purported entry.
|
|
def do_check(self, v):
|
|
cb = self.cb
|
|
args = self.args
|
|
if v < self.vlo:
|
|
if not self.is_in:
|
|
if self.wa is None or self.wa: # Low going transit
|
|
cb(self, self.T_IB, *args)
|
|
return # Was and is outside: no action.
|
|
# Was in the region, find direction of exit
|
|
reason = self.EX_WA_IB if (self.wa is None or self.wa) else self.EX_WB_IB
|
|
cb(self, reason, *args)
|
|
elif v > self.vhi:
|
|
if not self.is_in:
|
|
if self.wa is None or not self.wa:
|
|
cb(self, self.T_IA, *args)
|
|
return
|
|
# Was already in region
|
|
reason = self.EX_WB_IA if (self.wa is None or not self.wa) else self.EX_WA_IA
|
|
cb(self, reason, *args)
|
|
else: # v is in range
|
|
if self.is_in:
|
|
return # Nothing to do
|
|
if self.wa is None or self.wa:
|
|
cb(self, self.EN_WA, *args)
|
|
else:
|
|
cb(self, self.EN_WB, *args)
|
|
|
|
def check(self, v):
|
|
self.do_check(v)
|
|
self.is_in = self.vlo <= v <= self.vhi
|
|
if not self.is_in: # Current value is outside
|
|
self.wa = v > self.vhi # Save state for next check
|
|
|
|
def adjust(self, vlo, vhi):
|
|
if vlo >= vhi:
|
|
raise ValueError('TStat Region: vlo must be < vhi')
|
|
old_vlo = self.vlo
|
|
old_vhi = self.vhi
|
|
self.vlo = vlo
|
|
self.vhi = vhi
|
|
v = self.tstat.value()
|
|
self.tstat.draw = True
|
|
# Despatch cases where there is nothing to do.
|
|
# Outside both regions on same side
|
|
if v < vlo and v < old_vlo:
|
|
return
|
|
if v > vhi and v > old_vhi:
|
|
return
|
|
is_in = vlo <= v <= vhi # Currently inside
|
|
if is_in and self.is_in: # Regions overlapped
|
|
return # Still inside so no action
|
|
|
|
if is_in: # Inside new region but not in old
|
|
self.check(v) # Treat as if entering new region from previous value
|
|
else: # Outside new region
|
|
if not self.is_in: # Also outside old region. Hence it lay
|
|
# between old and new regions. Force a traverse of new.
|
|
self.wa = v < vlo
|
|
# If it was in old region treat as if leaving it
|
|
self.check(v)
|