ARKit/SceneKit尺子App开发：大尺寸SCNNode背景图引发崩溃

嘿，你遇到的这个Metal纹理尺寸限制导致的崩溃问题我之前也碰到过，给你几个比拆分图像更优雅的解决方案，能彻底解决问题还能提升性能：

你碰到的核心问题是Metal有最大纹理尺寸限制（这里是16384像素），当预先生成的尺子图像宽度超过这个值时，就会触发系统断言崩溃。除了拆分图像，还有几个更优的思路：

方案1：使用纹理平铺（最优解） #

尺子的刻度是高度重复的图案，完全没必要生成完整的长图像。你可以创建一个包含1厘米刻度单元的小纹理，然后通过设置SCNMaterial的纹理平铺参数，让它自动重复铺满整个SCNBox表面。这样不管尺子多长，纹理尺寸都极小，性能拉满。

具体实现步骤： #

1. 生成单个厘米刻度单元的图像（包含完整的1cm刻度和数字，确保边缘能无缝重复）
2. 配置SCNMaterial的diffuse.wrapS为.repeat，让纹理沿X轴自动重复
3. 根据SCNBox的实际宽度，计算纹理缩放因子，保证刻度和实际长度精准匹配

修改代码示例：

首先更新UIImage扩展，生成单个厘米单元的纹理：

extension UIImage {
    static let dashLineWidth: CGFloat = 2.0
    // 1厘米对应的像素宽度（和你原有的比例保持一致）
    static let cmPixelWidth: CGFloat = 163.0 / 25.4
    static let rulerFont: UIFont = .systemFont(ofSize: 15.0, weight: .regular)
    static let attributes: [NSAttributedStringKey: Any] = [
        NSAttributedStringKey.font: rulerFont,
        NSAttributedStringKey.foregroundColor: UIColor.black
    ]

    // 生成可无缝重复的1厘米尺子单元
    static func drawRulerUnit() -> UIImage? {
        let size = CGSize(width: cmPixelWidth, height: 50.0)
        UIGraphicsBeginImageContextWithOptions(size, false, 0.0)
        guard let context = UIGraphicsGetCurrentContext() else { return nil }

        // 绘制白色背景
        let background = UIBezierPath(rect: CGRect(origin: .zero, size: size))
        context.addPath(background.cgPath)
        context.setFillColor(UIColor.white.cgColor)
        context.fillPath()

        // 绘制1cm处的长刻度（左侧0刻度会和前一个单元的右侧对齐，这里只画右侧）
        let longDashHeight: CGFloat = size.height * 0.25
        UIColor.black.setFill()
        UIRectFill(CGRect(x: size.width - dashLineWidth/2, y: 0.0, width: dashLineWidth, height: longDashHeight))

        // 绘制5mm处的中刻度
        let midDashHeight: CGFloat = size.height * 0.15
        UIRectFill(CGRect(x: cmPixelWidth/2 - dashLineWidth/2, y: 0.0, width: dashLineWidth, height: midDashHeight))

        // 绘制1-9mm的短刻度（跳过5mm）
        for mm in 1..<10 {
            if mm == 5 { continue }
            let x = (CGFloat(mm)/10) * cmPixelWidth - dashLineWidth/2
            let shortDashHeight: CGFloat = size.height * 0.07
            UIRectFill(CGRect(x: x, y: 0.0, width: dashLineWidth, height: shortDashHeight))
        }

        // 绘制1cm的数字
        let value = "1"
        let valueSize = value.size(withAttributes: attributes)
        value.draw(at: CGPoint(x: size.width - valueSize.width/2, y: longDashHeight + 5.0), withAttributes: attributes)

        let image = UIGraphicsGetImageFromCurrentImageContext()
        UIGraphicsEndImageContext()
        return image
    }
}

然后修改updateRuler方法，使用平铺纹理：

var ruler: SCNNode = initRuler()
// 只需要生成一次单元纹理，复用即可
let rulerUnitImage = UIImage.drawRulerUnit()
let rulerUnitTexture = rulerUnitImage.flatMap { SKTexture(image: $0) }

func updateRuler() {
    guard let geometry = ruler.geometry as? SCNBox else { fatalError("Geometry is not SCNBox") }
    let width = geometry.width // 单位：米

    guard let texture = rulerUnitTexture else { return }
    let material = SCNMaterial()
    
    // 设置纹理沿X轴重复
    material.diffuse.wrapS = .repeat
    // 计算缩放因子：实际宽度（米）转厘米，每个单元对应1cm，所以重复width*100次
    material.diffuse.contentsTransform = SCNMatrix4MakeScale(width * 100, 1, 1)
    
    material.diffuse.contents = texture
    geometry.materials = [material]
}

这个方案的优势：

• 纹理尺寸极小，永远不会触发Metal的尺寸限制
• 仅需生成一次纹理，性能开销几乎为0
• 刻度和实际长度的匹配精度完全可控

方案2：动态生成对应宽度的纹理（简化版） #

如果不想用平铺纹理，可以每次直接生成当前尺子宽度对应的图像，而非预先生成大图再裁剪。这样生成的图像宽度刚好匹配需求，只要你的尺子最大长度不超过~2.57米（对应16384像素），就不会触发限制。

修改updateRuler方法： #

var ruler: SCNNode = initRuler()

func updateRuler() {
    guard let geometry = ruler.geometry as? SCNBox else { fatalError("Geometry is not SCNBox") }
    let width = geometry.width // 单位：米

    // 直接生成当前宽度对应的尺子图像，无需预先生成大图
    guard let rulerImage = UIImage.drawRuler(width: width) else { return }
    let texture = SKTexture(image: rulerImage)
    let material = SCNMaterial()
    material.diffuse.contents = texture
    geometry.materials = [material]
}

这个方案逻辑简单，不需要处理纹理平铺，适合需要自定义非重复刻度的场景。

方案3：拆分纹理拼接（备选） #

如果你的尺子长度需要超过2.57米，可以把尺子拆分成多个SCNBox节点，每个节点对应一段纹理。不过这个方案复杂度较高，一般前两个方案已经足够解决问题。

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