Image 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 AnnotateImagesExample: Example {
12

13
    override init() {
14
        super.init()
15

16
        title = "Annotate an Image"
17
        contentDescription = "Annotate an image using PSPDFImageDocument."
18
        category = .annotations
19
        priority = 100
20
    }
21

22
    override func invoke(with delegate: ExampleRunnerDelegate) -> UIViewController? {
23
        let sourceURL = AssetLoader.assetURL(for: "Image Playground.jpg")
24
        let writeableImageURL = sourceURL.copyToDocumentDirectory()
25

26
        // `PSPDFImageDocument` uses `flattenAndEmbed` as the default save mode. This allows the annotations added to the image to remain editable when it is reopened.
27
        let document = ImageDocument(imageURL: writeableImageURL)
28

29
        // We apply a special configuration that configures the PDF controller with settings that
30
        // work well for displaying images.
31
        let controller = PDFViewController(document: document, configuration: PDFConfiguration.image)
32

33
        // Not all stock button items make sense for images, so be sure to customize the UI.
34
        let rightItems = [controller.annotationButtonItem, controller.activityButtonItem, controller.searchButtonItem]
35
        let leftItems = [controller.outlineButtonItem, controller.brightnessButtonItem]
36
        controller.navigationItem.setRightBarButtonItems(rightItems, for: .document, animated: false)
37
        controller.navigationItem.setLeftBarButtonItems(leftItems, for: .document, animated: false)
38

39
        controller.navigationItem.leftItemsSupplementBackButton = true
40

41
        return controller
42
    }
43
}