chimp

type Button uint32

type Capabilities struct {
	PositionDevices []PositionDevice
	Buttons         []Button
}

type Coord2D struct {
	X, Y float32
}

type Device interface {
	// Properties returns properties of device.
	Properties() Properties

	// Capabilities returns capabilities of device.
	Capabilities() *Capabilities

	// Read event from device.
	// TODO: Define how to handle errors, reopening device?
	Read() (Event, error)

	// Close device.
	Close()
}

type DeviceInfo struct {
	Name string                 // Name of device.
	Type DeviceType             // Device type.
	Open func() (Device, error) // Function that opens the device.
}

type DeviceType int

type Event interface {
	// Time is the time when the event was generated.
	Time() time.Time

	// String returns a textual representation of the event.
	String() string
}

type EventButton struct {
	Timestamp time.Time // Time when event was generated.
	Button    Button    // Button code.
	Pressure  float32   // Pressure on button in range [0, 1], 0 or 1 for digital buttons.
}

type EventPositionFinger struct {
	Timestamp time.Time // Time when event was generated.
	Coord     Coord2D   // Finger position, axis are in range [0, 1], origo in upper left corner
}

type EventPositionPen struct {
	Timestamp time.Time // Time when event was generated.
	Coord     Coord2D   // Pen position on tablet, axis are in range [0, 1], origo in upper left corner.
	Distance  float32   // Distance of for example pen to tablet in range [0, 1], 0 is on tablet.
}

type PositionDevice uint32

type Properties map[Property]PropertyValue

type Property string

type PropertyValue interface {
	// Type returns the property value type as a string, e.g. "string" or "number".
	Type() string

	// String returns the property value as a string.
	// All types can be converted to a string.
	String() string

	// Number returns the property value as a float.
	// Zero is returned when this is not applicable.
	Number() float64
}

type PropertyValueNumber float64

type PropertyValueString string