Continiously Create Free Text Annotations in Swift for iOS

1
//
2
//  Copyright © 2018-2025 PSPDFKit GmbH. All rights reserved.
3
//
4
//  The Nutrient sample applications are licensed with a modified BSD license.
5
//  Please see License for details. This notice may not be removed from this file.
6
//
7

8
import PSPDFKit
9
import PSPDFKitUI
10

11
class CreateAnnotationsFastModeExample: Example {
12

13
    override init() {
14
        super.init()
15
        title = "Create Free Text Annotations Continuously"
16
        contentDescription = "Shows a way to disable the automatic state ending after annotation creation"
17
        category = .annotations
18
        priority = 202
19
    }
20

21
    override func invoke(with delegate: ExampleRunnerDelegate) -> UIViewController {
22
        let document = AssetLoader.document(for: .welcome)
23
        let pdfController = PDFViewController(document: document) {
24
            $0.overrideClass(AnnotationToolbar.self, with: CustomAnnotationToolbar.self)
25
        }
26
        return pdfController
27
    }
28
}
29

30
private class CustomAnnotationToolbar: AnnotationToolbar {
31
    let continuousVariant = Annotation.Variant(rawValue: "continuous")
32

33
    override init(annotationStateManager: AnnotationStateManager) {
34
        super.init(annotationStateManager: annotationStateManager)
35

36
        typealias Item = AnnotationToolConfiguration.ToolItem
37
        typealias Group = AnnotationToolConfiguration.ToolGroup
38
        let freeText = Item(type: .freeText)
39
        let freeTextContinuous = Item(type: .freeText, variant: continuousVariant, configurationBlock: {_, _, _ in
40
            return SDK.imageNamed("freetext")!.withRenderingMode(.alwaysOriginal)
41
        })
42

43
        let compactGroups = [
44
            Group(items: [freeText, freeTextContinuous])
45
        ]
46
        let compactConfiguration = AnnotationToolConfiguration(annotationGroups: compactGroups)
47

48
        let regularGroups = [
49
            Group(items: [freeText]),
50
            Group(items: [freeTextContinuous]),
51
        ]
52
        let regularConfiguration = AnnotationToolConfiguration(annotationGroups: regularGroups)
53
        configurations = [compactConfiguration, regularConfiguration]
54
    }
55

56
    override func annotationStateManager(_ manager: AnnotationStateManager, didChangeState oldState: Annotation.Tool?, to newState: Annotation.Tool?, variant oldVariant: Annotation.Variant?, to newVariant: Annotation.Variant?) {
57
        // Re-enable the state only if we already were in the continuous creation mode.
58
        if newState == nil && oldState == .freeText && oldVariant == continuousVariant {
59
            manager.state = .freeText
60
            manager.variant = continuousVariant
61
        }
62

63
        super.annotationStateManager(manager, didChangeState: oldState, to: newState, variant: oldVariant, to: newVariant)
64
    }
65
}