Article

✏️ Apple Pencilの複数筆を一括確定する設計:草稿・世代検証・Undo

swift, swiftui, ios, architecture

個人開発しているもの

日々の開発で得た知識を発信しながら、「あったら便利」「作ってみたい」と思ったアイデアを形にしています。

これまでに、グループ旅行アプリ Trip Supporter、スコア管理サービス PointPia、リアルタイム共有サービス JustNow などを開発しました。

さらに、刺繍やオリジナルキャラクターを中心としたアパレルブランド MAD TOMMY WITH... も運営しています。

開発したサービスや技術記事は chicchi.work で紹介しています。

iPadの作図アプリで、Apple Pencilの線を1本描き終わるたびに「編集モード」へ移ってしまうと、次の線を描き足せません。一方、描画の途中から文書の正式データを何度も更新すると、取消やUndo(元に戻す)で中途半端な形が残ることがあります。

この記事では、複数の筆跡を草稿として保持し、確定時にまとめて文書へ反映する設計を説明します。個人開発中の刺しゅう図案アプリ「Stitch Atelier」で直面した問題を題材にしています。コード例は仕組みを伝えるために簡略化した説明用のサンプルで、実際のアプリのソースをそのまま転載したものではありません。

1. 「画面に描けた」と「文書に確定した」は別

最初に次の3種類の状態を分けます。

状態 内容 取消時
入力中の一筆 Pencilから集めている点や筆圧 破棄
複数筆の草稿 まだ採用していない線の集合 文書を変えずに保持または破棄
編集文書の正本 保存・書き出しの基礎になる確定済み図案 Undoで戻す

正本とは、ほかの表示や書き出しの基準になるデータです。画面に見える線を即座に正本へ書くのではなく、未確定の線を草稿に置いておきます。

一筆ごとにベジェ曲線(制御点で滑らかな曲がり方を定義する曲線)や筆圧、閉じた図形かどうかを保持します。単純に複数の点列を1本へ連結すると、離れた線同士に意図しない接続線が生まれます。刺しゅうではその接続線が余分な縫い経路に見えることもあるため、筆の境界を消さないことが重要です。

2. 草稿と確定済みオブジェクトを別の型にする

以下はUIKitを使うiPadアプリを想定した最小例です。実際にはサンプリング済みの筆圧やベジェ制御点などを Stroke に追加します。

import Foundation
import CoreGraphics

struct Stroke {
    let id: UUID
    let points: [CGPoint]
    let isClosed: Bool
}

struct Shape {
    let id: UUID
    let stroke: Stroke
}

struct DrawingDocument {
    let id: UUID
    var shapes: [Shape]
}

struct DraftBatch {
    let documentID: UUID
    let baseGeneration: UUID
    var strokes: [Stroke]
}

DraftBatchには描画開始時の文書IDと世代トークンを記録します。世代トークンは、文書が編集されるたびに新しく発行する識別子です。数値の更新回数だけに頼らず、Undoで以前の内容に戻っても別の変更として識別できるようにします。

草稿と確定オブジェクトを別にすると、入力途中の線を正式な出力や保存へ誤って混ぜることを防げます。

3. Undoは「一筆ごと」ではなく「一度の確定」に対応させる

例えば3本の線を描いて1回の確定ボタンで採用したなら、Undoも1回で3本まとめて戻せる方が操作の意味に合います。

次の例では、確定前に次の文書をメモリー上に組み立ててから一度だけ反映します。これは永続化やディスクへの原子的書き込みを保証するコードではありません。

@MainActor
final class DocumentStore {
    private(set) var document: DrawingDocument
    private(set) var generation = UUID()

    init(document: DrawingDocument) {
        self.document = document
    }

    private func replace(
        with next: DrawingDocument,
        undoManager: UndoManager
    ) {
        let previous = document

        // Undo時には元の文書へ戻す。
        // restoreの呼び出しで逆操作が登録され、Redoにも対応する。
        undoManager.registerUndo(withTarget: self) { target in
            target.replace(with: previous, undoManager: undoManager)
        }

        document = next
        // Undo/Redoで過去の内容に戻っても新しい世代とする。
        generation = UUID()
    }

    func commit(
        _ draft: DraftBatch,
        undoManager: UndoManager
    ) -> Bool {
        guard draft.documentID == document.id,
              draft.baseGeneration == generation,
              !draft.strokes.isEmpty else {
            return false
        }

        // まず全筆を変換し、まだ正本へは書き込まない。
        let shapes = draft.strokes.map {
            Shape(id: UUID(), stroke: $0)
        }

        var next = document
        next.shapes.append(contentsOf: shapes)

        // 正本の更新とUndo登録は確定時の一度だけ。
        replace(with: next, undoManager: undoManager)
        return true
    }
}

ここではShapeへの変換が失敗しない例にしました。実際の針列生成や複雑な輪郭生成でエラーが起こり得る場合は、すべての変換と検証が成功するまでreplaceを呼ばない構成にします。一部だけ採用してから残りの失敗を通知する実装は避けます。

AppleのUndoManagerは逆操作を登録する仕組みです。複数の独立した操作を明示的にまとめたい場合はbeginUndoGrouping()とendUndoGrouping()も利用できます。ただしグループの開始・終了は対応させる必要があり、自動グループ化と重ねて使う際も挙動をテストします。今回の例は、1回の確定を1つのスナップショット復元操作として登録する方式です。

4. 非同期生成が遅れて戻ってきたときの事故

ベジェ輪郭の解析や縫い目生成を非同期で行うと、結果が返るまでにユーザーが別の文書を開いたり、Undoしたり、草稿を描き直したりすることがあります。

非同期とは、時間のかかる処理の終了を待つ間も、ほかの操作を進められる実行方法です。開始時の結果を無条件に採用すると、古い操作で現在の文書を上書きしてしまいます。

生成を始める際に以下を保存し、結果の適用直前に再照合します。

  • 文書ID:別の作品へ切り替わっていないか
  • 文書世代:生成開始後に編集・Undo・Redoが起きていないか
  • 草稿セッションID:ユーザーが取消して別の草稿を開始していないか

例えば生成要求と最新状態を比較する考え方は次のとおりです。

struct GenerationTicket {
    let documentID: UUID
    let documentGeneration: UUID
    let draftSessionID: UUID
}

// 非同期処理が完了した後、MainActor上で適用前に確認する。
func mayApply(
    _ ticket: GenerationTicket,
    documentID: UUID,
    generation: UUID,
    draftSessionID: UUID?
) -> Bool {
    ticket.documentID == documentID &&
    ticket.documentGeneration == generation &&
    ticket.draftSessionID == draftSessionID
}

mayApplyがfalseなら結果は採用せず、草稿を勝手に消さないようにします。さらに確定処理側で再度世代を検証し、「事前チェックが通った直後に状態が変わった」という競合を防ぎます。生成の取消だけに依存するのは危険です。既に完了した結果や取消できない処理も考慮する必要があります。

5. Pencilの描画と文字認識は画面の境界で扱う

もう1つの落とし穴は、設定フォームに近い場所でApple Pencilを動かすと、近くの文字欄の**Scribble(手書き文字認識)**が描画・スクロールの入力を拾うことです。

AppleはUIScribbleInteractionとUIScribbleInteractionDelegateを公開しており、テキスト入力ビューでのScribbleを領域ごとに制御できます。例えばデリゲートのscribbleInteraction(_:shouldBeginAt:)でfalseを返すと、その位置での手書き入力を抑止できます。

ただし、アプリ全体のPencil入力を無効にするのではありません。設定フォームの文字入力と、描画キャンバスで必要な筆入力を分けて考えることが大切です。UIKitのテキストビューへ適切なインタラクションを設定する必要があり、SwiftUIのすべてのTextFieldへ同じコードをそのまま適用できるわけではありません。

既存のスクロールやキーボード入力まで壊していないかを確認します。特にallowedTouchTypesのような配列の順序を過度に前提とせず、対象外のビューが変更前と同じ状態を保つこともテストします。

6. 正常系よりも、取消・失敗・Undoを重点的にテストする

最低限、次のケースを確認します。

ケース 期待する動作
3筆を描いて確定 3筆それぞれを独立した図案として追加
3筆の確定後にUndo 3筆まとめて戻る
Undo後にRedo 3筆まとめて復元
生成途中で取消 正本は変わらず、未確定データの扱いが一貫
2筆目の生成だけ失敗 1筆目も正本に部分反映しない
処理中に文書を切替 古い文書向けの結果を採用しない
処理中にUndo 世代不一致を検知し古い結果を採用しない
Pencilで設定欄付近をスクロール 必要なスクロールと文字入力を維持

「正しく線が見えるか」だけでなく、どの時点で正本が変わり、その操作を何回のUndoで戻せるかを検証します。非同期生成の成功画面が出たことと、正しい世代に結果が採用されたことも別に確認します。

7. 自作アプリでの学びと現在の公開状況

この問題は、開発中のiPad向け刺しゅう図案アプリ Stitch Atelier で遭遇しました。一筆で描画モードから調整モードへ移ってしまい、続けて描き足せないことが出発点です。

2026年11月7日の開発記録では、複数筆の草稿の保持、まとめて確定する処理、確定後の輪郭編集、フォーム側のScribble調整などを実装・レビューしました。記録上の検証結果はCoreテスト1306件と関連Appテスト50件が成功です。ただし、これはアプリ全機能の実機検証を意味しません。

アプリは未リリースです。 物理Apple Pencilによる操作、最低対応iPadOS、ミシン実機での試縫い、配布は未確認です。Simulatorでの検証結果を、実機の描き心地や縫製品質の保証として扱わないようにしています。

今回の設計は刺しゅう以外にも、ホワイトボードの複数描画、画像編集の一括適用、フォームの複数変更、非同期プレビューを持つエディターへ応用できます。草稿と正本を分ける、確定を1操作にまとめる、古い世代の結果を捨てるという3点が中心です。

参考資料