HaishinKit.swift/HaishinKit/Sources/Screen/VideoEffect.swift

import AVFoundation
import CoreImage
import Foundation

/// An object that apply a video effect.
/// - seealso:[Processing an Image Using Built-in Filters](https://developer.apple.com/documentation/coreimage/processing_an_image_using_built-in_filters)
///
/// ## Example code:
/// ```swift
/// final class MonochromeEffect: VideoEffect {
///     let filter: CIFilter? = CIFilter(name: "CIColorMonochrome")
///
///     func execute(_ image: CIImage) -> CIImage {
///         guard let filter: CIFilter = filter else {
///             return image
///         }
///         filter.setValue(image, forKey: "inputImage")
///         filter.setValue(CIColor(red: 0.75, green: 0.75, blue: 0.75), forKey: "inputColor")
///         filter.setValue(1.0, forKey: "inputIntensity")
///         return filter.outputImage ?? image
///     }
/// }
/// ```
public protocol VideoEffect: AnyObject {
    /// Executes to apply a video effect.
    func execute(_ image: CIImage) -> CIImage
}