Maintain annotation aspect ratio in Swift

1
//
2
//  Copyright © 2016-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 AspectRatioConservingResizingExample: Example {
12

13
    override init() {
14
        super.init()
15
        title = "Aspect Ratio Conserving Example"
16
        contentDescription = "Shows how to implement resizing that always preserves the annotation aspect ratio."
17
        category = .viewCustomization
18
    }
19

20
    override func invoke(with delegate: ExampleRunnerDelegate) -> UIViewController {
21
        let document = AssetLoader.document(for: .annualReport)
22

23
        // Add free text
24
        let freeText = FreeTextAnnotation()
25
        freeText.fontSize = 30
26
        freeText.contents = "Example text. Drag me!"
27
        freeText.boundingBox = CGRect(x: 50, y: 50, width: 300, height: 300)
28
        freeText.sizeToFit()
29
        freeText.color = UIColor.blue
30
        freeText.absolutePageIndex = 0
31
        document.add(annotations: [freeText])
32

33
        let pdfController = PDFViewController(document: document, delegate: self) {
34
            $0.overrideClass(ResizableView.self, with: AspectResizableView.self)
35
        }
36
        return pdfController
37
    }
38

39
    // MARK: Resizable view customization
40

41
    private class AspectResizableView: ResizableView {
42

43
        // MARK: Lifecycle
44

45
        override init(frame: CGRect) {
46
            super.init(frame: frame)
47
            customize()
48
        }
49

50
        required init?(coder aDecoder: NSCoder) {
51
            super.init(coder: aDecoder)
52
            customize()
53
        }
54

55
        // MARK: Knob customization
56

57
        private func customize() {
58
            // Always snap to guide.
59
            guideSnapAllowance = PSPDFGuideSnapAllowanceAlways
60
            // Remove all knobs but the bottom right one.
61
            let range = ResizableView.OuterKnob.topLeft.rawValue...ResizableView.OuterKnob.bottomRight.rawValue
62
            let knobTypes = range.compactMap { ResizableView.OuterKnob(rawValue: $0) }
63
            for knobType in knobTypes {
64
                outerKnob(ofType: knobType)?.removeFromSuperview()
65
            }
66
        }
67
    }
68
}
69

70
// MARK: PDFViewControllerDelegate
71

72
extension AspectRatioConservingResizingExample: PDFViewControllerDelegate {
73

74
    internal func pdfViewController(_ pdfController: PDFViewController, didConfigurePageView pageView: PDFPageView, forPageAt pageIndex: Int) {
75
        if pageView.pageIndex == 0 {
76
            pageView.selectedAnnotations = pdfController.document?.annotations(at: 0, type: FreeTextAnnotation.self)
77
        }
78
    }
79
}