自定义CIFilter中转CGImage转换返回全黑像素问题排查

这个问题我之前也碰到过，核心原因是你在自定义CIFilter的outputImage属性中直接调用CIContext.createCGImage()进行渲染，违背了Core Image的延迟计算设计原则，最终导致渲染出全黑的CGImage。

为什么会出现全黑？ #

Core Image的滤镜系统是基于延迟计算的：CIFilter的outputImage应该返回一个描述图像处理流程的CIImage对象，而不是立即执行渲染操作。当你在outputImage的getter里强制调用createCGImage()时：

• 此时可能还没有合适的渲染上下文（比如SpriteKit的渲染管线还未完全准备好）；
• 提前渲染会打破Core Image的数据流依赖，导致inputImage没有被正确传入渲染流程；
• 自定义的CIContext和SpriteKit内部使用的CIContext参数不匹配，也会导致渲染结果异常。

而系统内置滤镜能正常工作，是因为它们严格遵循了延迟计算的设计，返回的是经过处理的CIImage，而非提前渲染的CGImage；直接返回inputImage也正常，因为没有触发不必要的提前渲染。

解决方案 #

根据你的需求，有两种可行的修改方式：

方案一：保持CIFilter的延迟计算特性（推荐）

如果你的滤镜逻辑可以通过Core Image的内置API实现（比如组合现有滤镜、CIImage变换等），直接在outputImage中返回处理后的CIImage即可，完全不需要手动渲染CGImage：

class MyFilter: CIFilter {
    var inputImage: CIImage?
    
    public override init() {
        super.init()
    }
    
    required public init?(coder aDecoder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    override open var outputImage: CIImage? {
        guard let inputImage = self.inputImage else { return nil }
        // 这里替换成你的图像处理逻辑，比如用内置滤镜组合
        // 示例：添加棕褐色滤镜
        return inputImage.applyingFilter("CISepiaTone", parameters: ["inputIntensity": 0.8])
    }
}

方案二：在Filter外部处理CGImage像素

如果你确实需要直接操作CGImage的像素数据，把渲染逻辑从CIFilter内部移到使用滤镜的场景中，确保在合适的时机（比如视图加载完成后）进行渲染：

// 先修改自定义Filter，只负责传递或预处理CIImage
class MyFilter: CIFilter {
    var inputImage: CIImage?
    
    public override init() {
        super.init()
    }
    
    required public init?(coder aDecoder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }
    
    override open var outputImage: CIImage? {
        guard let inputImage = self.inputImage else { return nil }
        // 这里可以做一些CIImage级别的预处理，不需要渲染
        return inputImage
    }
}

// 在视图加载代码中处理CGImage
let skView = SKView()
let scene = SKScene()

override func viewDidLoad() {
    super.viewDidLoad()
    
    self.scene.scaleMode = .resizeFill
    self.skView.presentScene(self.scene)
    self.scene.backgroundColor = UIColor.black
    self.view.addSubview(skView)
    self.scene.shouldEnableEffects = true
    
    // 加载原始图片
    guard let originalImage = UIImage(named: "NAME_THAT_PIC") else { return }
    
    // 应用滤镜并处理CGImage
    guard let inputCIImage = CIImage(image: originalImage) else { return }
    let filter = MyFilter()
    filter.inputImage = inputCIImage
    guard let filteredCIImage = filter.outputImage else { return }
    
    // 在这里创建CIContext并渲染（此时渲染上下文已准备就绪）
    let context = CIContext(options: nil)
    guard let cgImage = context.createCGImage(filteredCIImage, from: filteredCIImage.extent) else { return }
    
    // 处理CGImage像素数据...
    // ... DO SOMETHING WITH CGIMAGE DATA ...
    
    // 将处理后的CGImage转为SpriteKit纹理，创建新节点
    let processedTexture = SKTexture(cgImage: cgImage)
    let processedSprite = SKSpriteNode(texture: processedTexture)
    processedSprite.position = CGPoint(x: 300, y: 400)
    
    let effectNode = SKEffectNode()
    effectNode.addChild(processedSprite)
    scene.addChild(effectNode)
}

额外注意点 #

• 尽量复用同一个CIContext对象，频繁创建会影响性能；
• 如果必须在Filter内部处理像素，可以考虑添加一个专门的方法（比如processPixelData()）来执行渲染，而不是在outputImage中处理；
• 检查CGImage的颜色空间是否和SpriteKit要求的一致，避免因颜色空间不匹配导致的显示异常。

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