PDF Magazine Reader using Swift for iOS

1
//
2
//  Copyright © 2017-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
/// This example uses the following Nutrient features:
12
/// - Viewer
13
///
14
/// See https://www.nutrient.io/sdk/ios for the complete list of Nutrient iOS SDK’s features.
15

16
class MagazineExample: IndustryExample {
17

18
    var pdfController: PDFViewController!
19

20
    override init() {
21
        super.init()
22

23
        title = "Magazine"
24
        contentDescription = "Shows how to configure Nutrient to display a magazine."
25
        category = .industryExamples
26
        targetDevice = [.vision, .phone, .pad]
27
        priority = 3
28
        extendedDescription = """
29
        This example shows how to configure document viewing options, like the curl page transition, for reading a magazine.
30

31
        It also shows how to disable editing and annotating a document to allow a read-only experience.
32

33
        And finally, this example shows how to restrict text extraction to prevent readers from redistributing paid content.
34
        """
35
        url = URL(string: "https://www.nutrient.io/blog/industry-solution-magazine-ios/")!
36
        image = UIImage(systemName: "newspaper")
37
    }
38

39
    override func invoke(with delegate: ExampleRunnerDelegate) -> UIViewController? {
40
        return MagazinePDFViewController(with: self)
41
    }
42
}
43

44
private class MagazinePDFViewController: PDFViewController, PDFViewControllerDelegate {
45

46
    /// Used for showing the more info alert.
47
    private var moreInfo: MoreInfoCoordinator!
48

49
    init(with example: IndustryExample) {
50
        let document = AssetLoader.writableDocument(for: .magazine, overrideIfExists: false)
51
        document.uid = "Magazine" // Set custom UID so it doesn't interfere with other examples.
52
        document.title = "BORA" // Override document title.
53

54
        let configuration = PDFConfiguration {
55
            // Configure the document presentation options.
56
            // See https://www.nutrient.io/guides/ios/customizing-the-interface/document-presentation-options/ for more details.
57
            $0.pageTransition = .curl
58
            $0.pageMode = .automatic
59
            $0.scrollDirection = .horizontal
60
            $0.isFirstPageAlwaysSingle = true
61

62
            // Disable selecting images but leave selecting text enabled.
63
            $0.isImageSelectionEnabled = false
64

65
            // Disable the modification of all annotation types.
66
            // See https://www.nutrient.io/guides/ios/features/controlling-pdf-editing/#disabling-the-modification-of-all-annotation-types for more details.
67
            $0.editableAnnotationTypes = .none
68

69
            // Miscellaneous configuration options.
70
            $0.userInterfaceViewAnimation = .slide
71
            $0.thumbnailBarMode = .scrollable
72
        }
73

74
        super.init(document: document, configuration: configuration)
75

76
        // Only show the outlines in the document info.
77
        // See https://www.nutrient.io/guides/ios/customizing-the-interface/customizing-the-available-document-information/ for more details.
78
        pdfController.documentInfoCoordinator.availableControllerOptions = [.outline]
79

80
        // Customize the toolbar.
81
        // See https://www.nutrient.io/guides/ios/customizing-the-interface/customizing-the-toolbar/ for more details.
82
        moreInfo = MoreInfoCoordinator(with: example, presentationContext: self)
83

84
        #if os(visionOS)
85
        setMainToolbarOrnamentItems([backOrnamentItem, moreInfo.barOrnamentItem, titleOrnamentItem, OrnamentItem(kind: .divider), settingsOrnamentItem, bookmarkOrnamentItem, outlineOrnamentItem, searchOrnamentItem], for: .document)
86
        #else
87
        navigationItem.leftBarButtonItems = [moreInfo.barButton, pdfController.brightnessButtonItem]
88
        navigationItem.rightBarButtonItems = [bookmarkButtonItem, outlineButtonItem, searchButtonItem]
89
        navigationItem.leftItemsSupplementBackButton = true
90
        #endif
91

92
        userInterfaceView.pageLabel.showThumbnailGridButton = true
93

94
        // Hide specific option on thumbnail filter bar
95
        thumbnailController.filterOptions = [.showAll, .bookmarks]
96

97
        // We need this to customize the menus.
98
        delegate = self
99
    }
100

101
    required init?(coder: NSCoder) {
102
        fatalError("init(coder:) has not been implemented")
103
    }
104

105
    override func viewDidAppear(_ animated: Bool) {
106
        super.viewDidAppear(animated)
107
        moreInfo.showAlertIfNeeded()
108
    }
109

110
    func pdfViewController(_ sender: PDFViewController, menuForText glyphs: GlyphSequence, onPageView pageView: PDFPageView, appearance: EditMenuAppearance, suggestedMenu: UIMenu) -> UIMenu {
111
        // Keep the entire Look Up and Speech menus.
112
        suggestedMenu
113
            .keep(menus: [.lookup, .speech], actions: [])
114
    }
115

116
}