english README please click here

fusion是什么？

Android上的OpenGL ES特效渲染库，类似IOS上的 GPUImage.

• 高度抽象了输入输出及渲染过程，隐藏了复杂繁琐的OpenGL API，即使不会OpenGL也能轻松上手。
• 统一渲染过程，通过RenderChain/RenderGraph将渲染器按chain/graph进行组织管理，并通过RenderPipline统一输入输出。
• 支持图片/视频/相机输入，自带视频编解码和相机逻辑。
• 支持图片/视频离屏渲染用于保存。
• 支持texture/frame buffer/program自动回收复用。
• 封装了GL线程及EGL环境，可通过GLThread及EGL帮助快速创建GL环境。
• 自带渲染显示View，也可以使用系统的GLSurfaceView。
• 自带常用渲染效果，可继承SimpleRenderer/RenderChain/RenderGraph实现复杂效果，也可自行实现Renderer接口。

持续更新中...

引入方法

根gradle中添加：

allprojects {
    repositories {
    	...
    	maven { url 'https://www.jitpack.io' }
    }
}

要引入的module中添加：

dependencies {
	implementation 'com.github.kenneycode:fusion:1.2.0'
}

图片渲染基本用法

// 创建RenderChain并添加一些renderer
val renderer = RenderChain()
	.addRenderer(ScaleRenderer().apply { setFlip(false, true); setScale(0.8f) })
	.addRenderer(CropRenderer().apply { setCropRect(0.1f, 0.9f, 0.8f, 0.2f) })
	.addRenderer(LUTRenderer().apply { setLUTImage(Util.decodeBitmapFromAssets("test_lut.png")!!); setLUTStrength(0.8f) })
	.addRenderer(GaussianBlurRenderer().apply { setBlurRadius(10) })

// 创建RenderPipeline，连接输入、渲染器与输出
renderPipeline = RenderPipeline
	.input(FusionImage(Util.decodeBitmapFromAssets("test.png")!!))
	.renderWith(renderer)
	.useContext(fusionView)
	.output(fusionView)

// 开始处理
renderPipeline.start()

视频渲染基本用法

// 创建RenderChain并添加一些renderer
val renderer = RenderChain()
	.addRenderer(OES2RGBARenderer())
	.addRenderer(LUTRenderer().apply { setLUTImage(Util.decodeBitmapFromAssets("test_lut.png")!!); setLUTStrength(0.8f) })
	.addRenderer(GaussianBlurRenderer().apply { setBlurRadius(10) })

// 创建RenderPipeline，连接输入、渲染器与输出
renderPipeline = RenderPipeline
    .input(FusionVideo("/sdcard/test.mp4"))
    .renderWith(renderer)
    .useContext(fusionView)
    .output(fusionView)

// 开始处理
renderPipeline.start()

相机渲染基本用法

// 创建RenderChain并添加一些renderer
val renderer = RenderChain()
	.addRenderer(OESConvertRenderer())
	.addRenderer(LUTRenderer().apply { setLUTImage(BitmapUtil.decodeBitmapFromAssets("test_lut.png")!!); setLUTStrength(0.8f) })

// 相机配置
val fusionCameraConfig = FusionCamera.Config().apply {
    windowRotation = activity!!.windowManager.defaultDisplay.rotation
    desiredPreviewSize = Size(1080, 1920)
}

// 创建RenderPipeline，连接输入、渲染器与输出
renderPipeline = RenderPipeline
    .input(FusionCamera(fusionCameraConfig))
    .renderWith(renderer)
    .useContext(fusionView)
    .output(fusionView)

// 开始处理
renderPipeline.start()

更多用法请查看demo。

谢谢！