captouch
module
- class captouch.CaptouchPetalState(*args, **kwargs)
- property bottom: bool
True if this is a bottom petal.
- property position: Tuple[int, int]
Coordinates of touch on petal in the form of a (distance, angle) tuple. The units are arbitrary, but centered around (0, 0).
These are approximately cartesian, but the axes are rotated to align with the radial and angular components of the petal position relative to the center of the badge, meaning:
An increase in distance means the touch is further away from the centre of the badge.
An increase in angle means the touch is more clockwise.
The hardware only provides angular positional data for the top petals, the bottom petals always return an angle of 0.
- property pressed: bool
True if the petal is being touched.
- property top: bool
True if this is a top petal.
- class captouch.CaptouchState(*args, **kwargs)
State of captouch sensors, captured at some time.
- property petals: List[CaptouchPetalState]
State of individual petals.
Contains 10 elements, with the zeroth element being the petal closest to the USB port. Then, every other petal in a clockwise direction.
Petals 0, 2, 4, 6, 8 are Top petals.
Petals 1, 3, 5, 7, 9 are Bottom petals.
- captouch.calibration_active() bool
Returns true if the captouch system is current recalibrating.
- captouch.calibration_request() None
Attempts to start calibration of captouch controllers. No-op if a calibration is already active.
- captouch.read() CaptouchState
Reads current captouch state from hardware and returns a snapshot in time.