Skip to content

TouchCalibration

Class

Source: TouchAdapter.h

Description

Calibration parameters for coordinate transformation

Supports:

  • Scale factors for X/Y axes
  • Offset adjustments
  • Display rotation transformation
  • Factory presets for common displays

Properties

NameTypeDescription
scaleXfloatX axis scale factor
scaleYfloatY axis scale factor
offsetXint16_tX axis offset
offsetYint16_tY axis offset
displayWidthint16_tDisplay width for clamping
displayHeightint16_tDisplay height for clamping

Methods

static TouchCalibration fromPreset(DisplayPreset preset)

Description:

Create calibration from preset

Parameters:

  • preset: Display preset

Returns: TouchCalibration instance

static TouchCalibration forResolution(int16_t width, int16_t height)

Description:

Create calibration for custom resolution

Parameters:

  • width: Display width
  • height: Display height

Returns: TouchCalibration instance

TouchPoint transform(int16_t rawX, int16_t rawY, bool pressed, uint8_t id, uint32_t ts) const

Description:

Transform raw coordinates to screen space

Parameters:

  • rawX: Raw X coordinate
  • rawY: Raw Y coordinate
  • pressed: Touch pressed state
  • id: Touch ID
  • ts: Timestamp

Returns: Transformed TouchPoint

void setRotation(TouchRotation rot)

Description:

Set rotation mode

void applyRotation(int16_t x, int16_t y, int16_t& outX, int16_t& outY) const

Description:

Apply rotation transformation to coordinates

Parameters:

  • x: Input X coordinate
  • y: Input Y coordinate
  • outX: Output X coordinate
  • outY: Output Y coordinate

TouchRotation inverted() const

Description:

Invert rotation (for opposite rotation)

Released under the MIT License.