Apple Pencil

Overview

Apryse's iOS SDK has full support for the Apple Pencil. This guide describes the various settings and how to change them.

Annotating without an annotation tool selected

When the user does not have an annotation tool selected (ie the active tool is the pan tool), the pencil can either draw an ink annotation (default behavior), or act as a finger touch. This behavior can be changed using the applePencilDrawsInk.

Annotating with only the pencil

When the user has an Apple Pencil paired with the device, it is possible to restrict annotation creation to only pencil touches. This allows the user to conveniently scroll with a single finger. It is also useful in preventing a user's palm from inadvertently creating an annotation.

The PTToolsSettingsManager's pencilInteractionMode controls how touches are interpreted when an Apple Pencil is paired:

Mode	Description
PTPencilInteractionModeFingerAndPencil	Finger touches will annotate (default on iOS 13)
PTPencilInteractionModePencilOnly	Finger touches will not annotate. Single finger can be used to scroll.
PTPencilInteractionModeSystem	Follows the system setting (default on iOS 14+)