Skip to content

Latest commit

 

History

History
57 lines (40 loc) · 3.17 KB

surface-slim-pen2-haptics-dev-notes.md

File metadata and controls

57 lines (40 loc) · 3.17 KB
title description ms.service ms.localizationpriority author ms.author ms.topic ms.date ms.reviewer manager appliesto
Surface Slim Pen (2nd Edition) haptics developer notes
Guidance for developers on implementing haptics in Windows 11 Ink apps with customizable inking and interaction feedback features.
windows-11
medium
coveminer
chauncel
how-to
10/30/2024
gusing
frankbu
Windows 11

Surface Slim Pen (2nd Edition) haptics developer notes

This page provides implementation notes for developers building apps that extend the Windows 11 Ink capabilities of the Surface Slim Pen (2nd Edition) for Business. Customizable haptics features include:

  • Inking feedback: Simulates the feel of different tools, such as pens, pencils, and brushes, during writing or drawing.
  • Interaction feedback: Provides tactile responses to user actions, such as hovering over buttons, clicking, or completing tasks with the pen.

If you are customizing haptics for the Slim Pen (2nd Edition), begin by consulting the Windows Ink guidelines in Pen interactions and haptic feedback, and then review the implementation notes below.

Implementation notes

Surface Slim Pen (2nd Edition) aligns with the Windows Ink guidelines, with the following considerations and exceptions:

Interaction waveforms and interruptions

As explained in the Send and stop interaction feedback section, interaction waveforms temporarily interrupt inking waveforms. However, in the Slim Pen (2nd Edition), the inking waveform might not automatically resume after an interaction feedback completes.

  • Recommendation: If continuous inking feedback is needed, re-enable the inking waveform immediately after the interaction feedback stops. There is no need to wait for the interaction feedback to finish before reactivating the inking waveform.

Unsupported haptic feedback features

The following optional haptic features, described in the Haptic feedback customizations section, are not supported on the Slim Pen (2nd Edition):

  • Play Count: The number of times a haptic effect plays.
  • Replay Pause Interval: The delay between replays of a haptic effect.
  • Play Duration: The total length of time the effect is active.

Although these features appear in the descriptor, the following functions will return incorrect values:

  • IsPlayCountSupported
  • IsPlayDurationSupported
  • IsReplayPauseIntervalSupported

Developers should avoid relying on these functions when building apps with Slim Pen (2nd Edition) haptics.

Learn more