Skip to content

Latest commit

 

History

History
178 lines (135 loc) · 6.98 KB

README_CN.md

File metadata and controls

178 lines (135 loc) · 6.98 KB
Raw

Harbeth

x

Carthage compatible CocoaPods Compatible CocoaPods Compatible Platform

Harbeth 是基于GPU快速实现图片or视频注入滤镜特效，代码零侵入实现图像显示and视频导出功能，支持iOS系统和macOS系统。👒👒👒

中文详细介绍

功能清单

  • 支持macOS和iOS平台系统，也支持SwiftUI使用；
  • 高性能在如下数据源快速添加过滤器效果：
    UIImage, NSImage, CIImage, CGImage, CMSampleBuffer, CVPixelBuffer
  • 支持两种查找滤镜 LUTs 和 Cube 来定制专属滤镜；
  • 支持相机采集特效和视频播放加入滤镜效果；
  • Metal滤镜部分大致分为以下几个模块：
    Blend, Blur, Pixel, Coordinate, Lookup, Matrix, Shape, Generator.
  • 支持使用 Kakapos 库对已有视频添加滤镜并导出；
  • 支持系统 MetalPerformanceShaders 和 CoreImage 滤镜混合使用；

总结下来目前将近两百种滤镜供您使用。✌️

如何使用

  • 代码零侵入注入滤镜功能，
原始代码：
ImageView.image = originImage

🎷注入滤镜代码：
let filter = C7ColorMatrix4x4(matrix: Matrix4x4.Color.sepia)
let filter2 = C7Granularity(grain: 0.8)
let filter3 = C7SoulOut(soul: 0.7)

let filters = [filter, filter2, filter3]

ImageView.image = try? originImage.makeGroup(filters: filters)

// 也可数据源模式使用
let dest = HarbethIO.init(element: originImage, filters: filters)

// 同步处理
ImageView.image = try? dest.output()

// 异步处理
dest.transmitOutput(success: { [weak self] image in
    DispatchQueue.main.async {
        self?.ImageView.image = image
    }
})

// 或者运算符操作
ImageView.image = originImage -->>> filters

// 甚至函数式编程高级用法
filters.forEach { originImage = originImage ->> $0 }
ImageView.image = originImage

// 甚至不定参数使用
ImageView.image = originImage.filtering(filter, filter2, filter3)

怎么使用就看你的心情了!!!🫤
  • 相机采集生成图片
// 注入边缘检测滤镜:
let filter = C7EdgeGlow(lineColor: .red)
// 注入颗粒感滤镜:
let filter2 = C7Granularity(grain: 0.8)

// 生成相机采集器:
let camera = C7CollectorCamera.init(delegate: self)
camera.captureSession.sessionPreset = AVCaptureSession.Preset.hd1280x720
camera.filters = [filter, filter2]

extension CameraViewController: C7CollectorImageDelegate {
    func preview(_ collector: C7Collector, fliter image: C7Image) {
        // 显示注入滤镜之后的图像
    }
}
  • 本地视频 or 网络视频简单注入滤镜
    • 🙄 详细请参考PlayerViewController
    • 您也可以自己去扩展，使用HarbethIO对采集的CVPixelBuffer进行滤镜注入处理。
lazy var video: C7CollectorVideo = {
    let videoURL = URL.init(string: "https://mp4.vjshi.com/2017-06-03/076f1b8201773231ca2f65e38c34033c.mp4")!
    let asset = AVURLAsset.init(url: videoURL)
    let playerItem = AVPlayerItem(asset: asset)
    let player = AVPlayer.init(playerItem: playerItem)
    let video = C7CollectorVideo.init(player: player, delegate: self)
    let filter = C7ColorMatrix4x4(matrix: Matrix4x4.Color.sepia)
    video.filters = [filter]
    return video
}()

// 播放视频
self.video.play()

extension PlayerViewController: C7CollectorImageDelegate {
    func preview(_ collector: C7Collector, fliter image: C7Image) {
        self.originImageView.image = image
        if let filter = self.tuple?.callback?(self.nextTime) {
            self.video.filters = [filter]
        }
    }
}

SwiftUI Support

  • 直接使用即可 HarbethView
  • 这个API可能也暂时不够稳定，暂时先这样吧！
  • 当然你也可以来完善它，感谢！ 🤲
let filters: [C7FilterProtocol] = [
    CIHighlight(highlight: intensity),
    C7WaterRipple(ripple: intensity),
]
HarbethView(image: inputImage, filters: filters, content: { image in
    image.resizable()
        .aspectRatio(contentMode: .fit)
}, async: false)

CocoaPods Install

  • 如果要导入 Metal 模块，则需要在 Podfile 中：
pod 'Harbeth'
  • 如果要导入 OpenCV 图像模块，则需要在 Podfile 中：
pod 'OpencvQueen'

Swift Package Manager

dependencies: [
    .package(url: "https://github.com/yangKJ/Harbeth.git", branch: "master"),
]

关于作者

当然如果您这边觉得好用对你有所帮助，请给作者一点辛苦的打赏吧。再次感谢感谢！！！
有空我也会一直更新维护优化 😁😁😁

救救孩子吧，谢谢各位老板。

🥺