苹果PDF Kit新手求助：签名添加为PDF注释时位移缩放异常

嘿，我来帮你搞定这个签名图像位移和缩放的坑！你遇到的问题其实挺常见的——PDF的坐标系统和UIKit完全不一样，再加上PDFView的缩放、滚动影响，直接用视图坐标转PDF坐标很容易出错。咱们一步步来修正：

问题根源 #

• UIKit坐标原点在左上角，Y轴向下；而PDF坐标原点在左下角，Y轴向上，这是最容易踩的坐标翻转坑。
• PDFView的缩放比例、滚动偏移会让你看到的页面位置和PDF原生页面尺寸不匹配，直接用imageView的frame会导致缩放异常。

修正后的代码实现 #

下面是调整后的touchesEnded方法，我加了详细的注释说明每一步的作用：

override func touchesEnded(_ touches: Set<UITouch>, with event: UIEvent?) {
    guard let signatureImage = tempImageView.image, 
          let currentPage = pdfView.currentPage,
          let pdfView = pdfView else { return }
    
    // 1. 获取临时签名视图在PDFView中的坐标和尺寸
    let imageViewFrame = tempImageView.frame
    let pdfViewBounds = pdfView.bounds
    let pageMediaBox = currentPage.bounds(for: .mediaBox)
    
    // 2. 处理PDFView的缩放和滚动偏移
    let scaleFactor = pdfView.scaleFactor
    let contentOffset = pdfView.contentOffset
    
    // 3. 把UIKit坐标转换为PDF原生坐标（关键步骤：翻转Y轴+还原缩放/偏移）
    // 先计算imageView在PDFView内容区域中的位置（去掉滚动偏移）
    let xInContent = imageViewFrame.origin.x - contentOffset.x
    let yInContent = pdfViewBounds.height - imageViewFrame.origin.y - imageViewFrame.height - contentOffset.y
    
    // 再转换为PDF页面的原生坐标（除以缩放比例）
    let pdfOrigin = CGPoint(
        x: xInContent / scaleFactor,
        y: yInContent / scaleFactor
    )
    let pdfSize = CGSize(
        width: imageViewFrame.width / scaleFactor,
        height: imageViewFrame.height / scaleFactor
    )
    let annotationBounds = CGRect(origin: pdfOrigin, size: pdfSize)
    
    // 4. 创建图像注释并添加到PDF页面
    let signatureAnnotation = PDFAnnotation(
        bounds: annotationBounds,
        forType: .stamp,
        withProperties: nil
    )
    // 给注释赋值图像
    signatureAnnotation.image = signatureImage
    if let imageData = signatureImage.pngData() {
        signatureAnnotation.contents = imageData.base64EncodedString()
    }
    
    currentPage.addAnnotation(signatureAnnotation)
    
    // 清理临时视图
    tempImageView.removeFromSuperview()
}

进阶优化：针对PDF表单签名域 #

如果你是要在PDF的签名表单域上签名，而不是随便加个图像注释，建议直接找到对应的表单域控件，这样更符合PDF表单规范：

// 在添加注释前，先查找当前页面的签名表单域
if let signatureField = currentPage.annotations.first(where: {
    guard let widget = $0 as? PDFAnnotationWidget else { return false }
    return widget.fieldType == .signature && widget.widgetFieldType == .signature
}) as? PDFAnnotationWidget {
    // 直接把签名图像赋值给表单域
    signatureField.image = signatureImage
} else {
    // 如果没有找到签名域，再用上面的方式添加独立注释
    let signatureAnnotation = PDFAnnotation(...)
    currentPage.addAnnotation(signatureAnnotation)
}

关键注意点 #

• 一定要用bounds(for: .mediaBox)获取PDF页面的原生尺寸，不要用其他边界类型。
• 转换坐标时必须考虑scaleFactor和contentOffset，否则缩放或滚动后签名位置会完全跑偏。
• 用.stamp类型的注释适合静态图像签名，如果需要可编辑的签名，也可以用.ink类型，但需要把签名路径转成PDF的ink注释路径。

内容的提问来源于stack exchange，提问作者Stephan Boner