如何避免SpriteKit Metal渲染器超出纹理尺寸限制？

在SpriteKit中通过SKEffectNode为用户添加的任意尺寸精灵应用Core Image滤镜时，部分滤镜会改变渲染后的精灵尺寸。当最终尺寸超出Metal允许的最大纹理尺寸时，应用会崩溃并抛出如下错误：

-[MTLTextureDescriptorInternal validateWithDevice:]:1357: failed assertion `Texture Descriptor Validation
MTLTextureDescriptor has width (9050) greater than the maximum allowed size of 8192.
MTLTextureDescriptor has height (9050) greater than the maximum allowed size of 8192.

以下是当前的SpriteKit代码：

var mySprite: SKSpriteNode!
var myEffectNode: SKEffectNode!
var sliderInput: Double = 0

override func didMove(to view: SKView) {    
    // 用户选择的任意尺寸图片生成精灵
    mySprite = SKSpriteNode(imageNamed: "myImage")
    mySprite.name = "mySprite"
        
    myEffectNode = SKEffectNode()
    myEffectNode.addChild(mySprite)
    
    addChild(myEffectNode)
}

// 由SwiftUI触发，实时动态更新滤镜
func updateEffects() {
    myEffectNode.filter = CIFilter(name: "CIZoomBlur", parameters: [
        "inputAmount": sliderInput
    ])
}

期望实现类似如下逻辑的安全更新方法：

func carefullyUpdateEffects() {
    // 计算图像处理后的预期尺寸
    // 获取当前设备的纹理尺寸限制
    // 检查处理后的输出是否超出限制
        // 未超出则正常渲染
        // 超出则进行容错处理
}

实现步骤 #

1. 获取设备的最大纹理尺寸
   通过当前SKView关联的Metal设备，动态获取该设备支持的最大纹理尺寸：

guard let metalDevice = view?.device else { return }
let maxTextureSize = metalDevice.maxTextureSize

2. 预估滤镜应用后的输出尺寸
   不同Core Image滤镜的输出尺寸逻辑有差异：

• 基础色彩滤镜（如CIColorMonochrome）输出尺寸与输入一致
• 模糊类滤镜（如CIZoomBlur、CIGaussianBlur）会因模糊半径扩展边缘，输出尺寸 = 输入尺寸 + 2 * 模糊半径对应的像素扩展量

以CIZoomBlur为例，可通过滤镜的outputImage属性直接获取预期尺寸：

// 创建滤镜并绑定输入图片
let filter = CIFilter(name: "CIZoomBlur", parameters: [
    "inputAmount": sliderInput,
    "inputImage": CIImage(image: mySprite.texture!.image!)!
])!

// 获取输出图像的尺寸
let outputSize = filter.outputImage!.extent.size

3. 尺寸校验与容错处理
   如果预估的输出尺寸超出设备限制，可选择以下几种处理方式：

• 缩小原始精灵纹理，确保滤镜应用后不超过限制
• 禁用当前滤镜，切换为无效果或低影响滤镜
• 提示用户图片尺寸过大，无法应用该滤镜

完整实现代码 #

func carefullyUpdateEffects() {
    guard let metalDevice = view?.device,
          let spriteTexture = mySprite.texture,
          let inputImage = CIImage(image: spriteTexture.image!) else {
        // 资源获取失败，清空滤镜
        myEffectNode.filter = nil
        return
    }
    
    let maxTextureSize = CGFloat(metalDevice.maxTextureSize)
    let inputSize = spriteTexture.size()
    
    // 创建滤镜并设置参数
    let filter = CIFilter(name: "CIZoomBlur", parameters: [
        "inputAmount": sliderInput,
        "inputImage": inputImage
    ])!
    
    // 获取滤镜输出的预期尺寸
    let outputSize = filter.outputImage!.extent.size
    
    // 检查是否超出尺寸限制
    if outputSize.width <= maxTextureSize && outputSize.height <= maxTextureSize {
        // 未超出限制，正常应用滤镜
        myEffectNode.filter = filter
    } else {
        // 超出限制：缩小原始纹理后再应用滤镜
        let scaleFactor = min(maxTextureSize / outputSize.width, maxTextureSize / outputSize.height)
        let scaledSize = CGSize(width: inputSize.width * scaleFactor, height: inputSize.height * scaleFactor)
        
        // 生成缩小后的纹理
        let scaledTexture = SKTexture(image: spriteTexture.image()!.resized(to: scaledSize))
        mySprite.texture = scaledTexture
        mySprite.size = scaledSize
        
        // 重新创建滤镜并应用
        let scaledInputImage = CIImage(image: scaledTexture.image!)!
        let scaledFilter = CIFilter(name: "CIZoomBlur", parameters: [
            "inputAmount": sliderInput,
            "inputImage": scaledInputImage
        ])!
        myEffectNode.filter = scaledFilter
        
        // 也可选择直接禁用滤镜：
        // myEffectNode.filter = nil
    }
}

// UIImage缩小扩展
extension UIImage {
    func resized(to size: CGSize) -> UIImage {
        let renderer = UIGraphicsImageRenderer(size: size)
        return renderer.image { context in
            draw(in: CGRect(origin: .zero, size: size))
        }
    }
}

注意事项 #

• 几何变换类滤镜（如CIPerspectiveTransform）需要根据变换矩阵单独计算输出尺寸
• 实时更新时建议缓存缩放后的纹理，避免重复缩放导致性能损耗
• 不同设备的maxTextureSize可能不同（旧设备可能为4096，新设备为8192或更高），必须动态获取而非硬编码

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