22     """Pen states according to Microsoft reference:
23     https://docs.microsoft.com/en-us/windows-hardware/design/component-guidelines/windows-pen-states
140 class Pen(object):  class
179         print(f"\n  *** pen is moving to {state} ***")
237         """This is the first half of the Windows Pen Implementation state machine:
239 …   https://docs.microsoft.com/en-us/windows-hardware/design/component-guidelines/windows-pen-states
263         """This is the second half of the Windows Pen Implementation state machine:
266 …   https://docs.microsoft.com/en-us/windows-hardware/design/component-guidelines/windows-pen-states
301         """This is not adhering to the Windows Pen Implementation state machine
314         """This is the second half of the Windows Pen Implementation state machine:
317 …   https://docs.microsoft.com/en-us/windows-hardware/design/component-guidelines/windows-pen-states
331         For example, a pen that has the eraser button might wobble between
372         application="Pen",
391     def event(self, pen):  argument
393         r = self.create_report(application=self.cur_application, data=pen)
432         def post(self, uhdev, pen):  argument
433             r = uhdev.event(pen)
438         def validate_transitions(self, from_state, pen, evdev, events):  argument
440             pen.assert_expected_input_events(evdev)
461             to wobble a little the X,Y coordinates of the pen
468             p = Pen(50, 60)
493             [pytest.param(v, id=k) for k, v in Pen.legal_transitions().items()],
496             """This is the first half of the Windows Pen Implementation state machine:
498 …   https://docs.microsoft.com/en-us/windows-hardware/design/component-guidelines/windows-pen-states
505             [pytest.param(v, id=k) for k, v in Pen.tolerated_transitions().items()],
508             """This is not adhering to the Windows Pen Implementation state machine
522                 for k, v in Pen.legal_transitions_with_invert().items()
526             """This is the second half of the Windows Pen Implementation state machine:
529 …   https://docs.microsoft.com/en-us/windows-hardware/design/component-guidelines/windows-pen-states
542                 for k, v in Pen.tolerated_transitions_with_invert().items()
546             """This is the second half of the Windows Pen Implementation state machine:
549 …   https://docs.microsoft.com/en-us/windows-hardware/design/component-guidelines/windows-pen-states
560             [pytest.param(v, id=k) for k, v in Pen.broken_transitions().items()],
565             For example, a pen that has the eraser button might wobble between
576 …      Actual reporting from the device: hid=TIPSWITCH,BARRELSWITCH,INRANGE (code=TOUCH,STYLUS,PEN):
586             p = Pen(50, 60)
619 …      Actual reporting from the device: hid=TIPSWITCH,BARRELSWITCH,INRANGE (code=TOUCH,STYLUS,PEN):
631             p = Pen(50, 60)
667     def event(self, pen):  argument
671         internal_pen = copy.copy(pen)
673         # bug in the controller: when the pen touches the
675         # the pen moves in-range gets reverted to 0
676         if pen.tipswitch and self.prev_tip_state:
679         self.prev_tip_state = pen.tipswitch
681         # another bug in the controller: when the pen is
683         # the pen touches the surface, eraser is correctly
685         if pen.eraser:
852 # Windows 8 compatible devices with USI Pen