在 iOS 11 PDFKit 文档上实现墨迹注释

我想允许用户在 PDFView 中查看的 iOS 11 PDFKit 文档上绘图。绘图最终应嵌入到 PDF 中。

我通过向 PDFPage 添加“ink”类型的 PDFAnnotation 以及与用户绘图相对应的 UIBezierPath 来解决后者。

但是，我如何实际记录用户在 PDFView 上进行的触摸以创建这样的 UIBezierPath？

我尝试过在 PDFView 和 PDFPage 上覆盖 TouchBegan，但它从未被调用。我尝试添加 UIGestureRecognizer，但没有完成任何任务。

我假设我之后需要使用 PDFView 实例方法 Convert(_ point: CGPoint, to page: PDFPage) 将获得的坐标转换为适合注释的 PDF 坐标。

最后我通过创建一个扩展 UIViewController 和 UIGestureRecognizerDelegate 的 PDFViewController 类解决了这个问题。我添加了一个 PDFView 作为子视图，并将一个 UIBarButtonItem 添加到 navigationItem，用于切换注释模式。

我将触摸记录在名为signingPath 的UIBezierPath 中，并使用以下代码将当前注释保存在PDFAnnotation 类型的currentAnnotation 中：

 override func touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?) {
    if let touch = touches.first {
        let position = touch.location(in: pdfView)
        signingPath = UIBezierPath()
        signingPath.move(to: pdfView.convert(position, to: pdfView.page(for: position, nearest: true)!))
        annotationAdded = false
        UIGraphicsBeginImageContext(CGSize(width: 800, height: 600))
        lastPoint = pdfView.convert(position, to: pdfView.page(for: position, nearest: true)!)
    }
}

override func touchesMoved(_ touches: Set<UITouch>, with event: UIEvent?) {
    if let touch = touches.first {
        let position = touch.location(in: pdfView)
        let convertedPoint = pdfView.convert(position, to: pdfView.page(for: position, nearest: true)!)
        let page = pdfView.page(for: position, nearest: true)!
        signingPath.addLine(to: convertedPoint)
        let rect = signingPath.bounds

        if( annotationAdded ) {
            pdfView.document?.page(at: 0)?.removeAnnotation(currentAnnotation)
            currentAnnotation = PDFAnnotation(bounds: rect, forType: .ink, withProperties: nil)

            var signingPathCentered = UIBezierPath()
            signingPathCentered.cgPath = signingPath.cgPath
            signingPathCentered.moveCenter(to: rect.center)
            currentAnnotation.add(signingPathCentered)
            pdfView.document?.page(at: 0)?.addAnnotation(currentAnnotation)

        } else {
            lastPoint = pdfView.convert(position, to: pdfView.page(for: position, nearest: true)!)
            annotationAdded = true
            currentAnnotation = PDFAnnotation(bounds: rect, forType: .ink, withProperties: nil)
            currentAnnotation.add(signingPath)
            pdfView.document?.page(at: 0)?.addAnnotation(currentAnnotation)
        }
    }
}

override func touchesEnded(_ touches: Set<UITouch>, with event: UIEvent?) {
    if let touch = touches.first {
        let position = touch.location(in: pdfView)
        signingPath.addLine(to: pdfView.convert(position, to: pdfView.page(for: position, nearest: true)!))

        pdfView.document?.page(at: 0)?.removeAnnotation(currentAnnotation)

        let rect = signingPath.bounds
        let annotation = PDFAnnotation(bounds: rect, forType: .ink, withProperties: nil)
        annotation.color = UIColor(hex: 0x284283)
        signingPath.moveCenter(to: rect.center)
        annotation.add(signingPath)
        pdfView.document?.page(at: 0)?.addAnnotation(annotation)
    }
}

注释切换按钮刚刚运行：

pdfView.isUserInteractionEnabled = !pdfView.isUserInteractionEnabled

这确实是关键，因为这会禁用 PDF 上的滚动并使我能够接收触摸事件。

记录触摸事件并立即转换为 PDFAnnotation 的方式意味着注释在 PDF 上书写时可见，并且最终记录到 PDF 中的正确位置 - 无论滚动位置如何。

确保它最终出现在正确的页面上只需将页码的硬编码 0 更改为 pdfView.page(for:position,nearest:true) 值即可。