Android 相机库CameraView源码解析 (三) : 滤镜相关类说明

2023-12-04 08:04

本文主要是介绍Android 相机库CameraView源码解析 (三) : 滤镜相关类说明,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

1. 前言

这段时间,在使用 natario1/CameraView 来实现带滤镜的预览拍照录像功能。
由于CameraView封装的比较到位,在项目前期,的确为我们节省了不少时间。
但随着项目持续深入,对于CameraView的使用进入深水区,逐渐出现满足不了我们需求的情况。
Github中的issues中,有些BUG作者一直没有修复。

那要怎么办呢 ? 项目迫切地需要实现相关功能,只能自己硬着头皮去看它的源码,去解决这些问题。
上篇文章,我们对拍照的流程有了大致的了解,这篇文章,我们来看下滤镜相关的类,为后面带滤镜拍照的源码解析做下铺垫。

以下源码解析基于CameraView 2.7.2

implementation("com.otaliastudios:cameraview:2.7.2")

为了在博客上更好的展示,本文贴出的代码进行了部分精简

在这里插入图片描述

2. 如何设置滤镜

CameraView中,通过setFilter(Filter filter)来设置滤镜。

//初始化亮度滤镜
val brightnessFilter = BrightnessFilter()
//设置亮度值
brightnessFilter.setBrightness(1.5F)
//设置滤镜
cameraView.setFilter(brightnessFilter)

3. Filter

Filter是一个接口,定义了获取顶点着色器获取片元着色器当初始化时当销毁时当绘制时设置尺寸拷贝滤镜

public interface Filter {/*** 获取顶点着色器*/String getVertexShader();/*** 获取片元着色器*/String getFragmentShader();/*** 初始化时调用*/void onCreate(int programHandle);/*** 销毁时调用* */void onDestroy();/*** 当绘制的时候*/void draw(long timestampUs, float[] transformMatrix);/*** 设置尺寸*/void setSize(int width, int height);/*** 复制滤镜*/Filter copy();
}

4. BaseFilter

BaseFilter是一个抽象类,实现了Filter接口,BaseFilter实现了默认的顶点着色器和片元着色器,在onCreate的时候,创建了具体执行OpenGL APIGlTextureProgramcopy的时候,会根据OneParameterFilterTwoParameterFilter接口,复制Filter

public abstract class BaseFilter implements Filter {//...省略了具体代码...
}

接下来来看BaseFilter的具体代码

4.1 默认的顶点着色器和片元着色器

实现了默认的顶点着色器和片元着色器

protected final static String DEFAULT_VERTEX_POSITION_NAME = "aPosition";
protected final static String DEFAULT_VERTEX_TEXTURE_COORDINATE_NAME = "aTextureCoord";
protected final static String DEFAULT_VERTEX_MVP_MATRIX_NAME = "uMVPMatrix";
protected final static String DEFAULT_VERTEX_TRANSFORM_MATRIX_NAME = "uTexMatrix";
protected final static String DEFAULT_FRAGMENT_TEXTURE_COORDINATE_NAME = "vTextureCoord";private static String createDefaultVertexShader(@NonNull String vertexPositionName,@NonNull String vertexTextureCoordinateName,@NonNull String vertexModelViewProjectionMatrixName,@NonNull String vertexTransformMatrixName,@NonNull String fragmentTextureCoordinateName) {return "uniform mat4 "+vertexModelViewProjectionMatrixName+";\n"+ "uniform mat4 "+vertexTransformMatrixName+";\n"+ "attribute vec4 "+vertexPositionName+";\n"+ "attribute vec4 "+vertexTextureCoordinateName+";\n"+ "varying vec2 "+fragmentTextureCoordinateName+";\n"+ "void main() {\n"+ "    gl_Position = " +vertexModelViewProjectionMatrixName+" * "+ vertexPositionName+";\n"+ "    "+fragmentTextureCoordinateName+" = ("+vertexTransformMatrixName+" * "+ vertexTextureCoordinateName+").xy;\n"+ "}\n";
}private static String createDefaultFragmentShader(@NonNull String fragmentTextureCoordinateName) {return "#extension GL_OES_EGL_image_external : require\n"+ "precision mediump float;\n"+ "varying vec2 "+fragmentTextureCoordinateName+";\n"+ "uniform samplerExternalOES sTexture;\n"+ "void main() {\n"+ "  gl_FragColor = texture2D(sTexture, "+fragmentTextureCoordinateName+");\n"+ "}\n";
}

4.2 创建GlTextureProgram

GlTextureProgram是对OpenGL纹理绘制的具体实现,这里传入了顶点着色器和片元着色器等,创建了GlTextureProgram

@Override
public void onCreate(int programHandle) {program = new GlTextureProgram(programHandle,vertexPositionName,vertexModelViewProjectionMatrixName,vertexTextureCoordinateName,vertexTransformMatrixName);programDrawable = new GlRect();
}

4.3 设置尺寸并绘制

在合适的机会设置尺寸并绘制,绘制里面有三个方法onPreDrawonDrawonPostDraw,内部都是调用的GlTextureProgram对应的onPreDrawonDrawonPostDraw,而GlTextureProgram里面,我们现在只需要知道是OpenGL API具体的方法就行了。

@Override
public void setSize(int width, int height) {size = new Size(width, height);
}@Override
public void draw(long timestampUs, @NonNull float[] transformMatrix) {onPreDraw(timestampUs, transformMatrix);onDraw(timestampUs);onPostDraw(timestampUs);
}protected void onPreDraw(long timestampUs, @NonNull float[] transformMatrix) {program.setTextureTransform(transformMatrix);program.onPreDraw(programDrawable, programDrawable.getModelMatrix());
}protected void onDraw(long timestampUs) {program.onDraw(programDrawable);
}protected void onPostDraw(long timestampUs) {program.onPostDraw(programDrawable);
}

4.4 拷贝滤镜

copy方法,内部调用了getClass().newInstance()来反射得到一个新的BaseFilter,并赋值了Size,如果实现了OneParameterFilterTwoParameterFilter接口,还会给设置相关的参数。

比如亮度滤镜的亮度值,就需要实现OneParameterFilterTwoParameterFilter接口,从而使设置的亮度值,赋值到新的BaseFilter

@NonNull
@Override
public final BaseFilter copy() {BaseFilter copy = onCopy();if (size != null) {copy.setSize(size.getWidth(), size.getHeight());}if (this instanceof OneParameterFilter) {((OneParameterFilter) copy).setParameter1(((OneParameterFilter) this).getParameter1());}if (this instanceof TwoParameterFilter) {((TwoParameterFilter) copy).setParameter2(((TwoParameterFilter) this).getParameter2());}return copy;
}@NonNull
protected BaseFilter onCopy() {try {return getClass().newInstance();} catch (IllegalAccessException e) {throw new RuntimeException("Filters should have a public no-arguments constructor.", e);} catch (InstantiationException e) {throw new RuntimeException("Filters should have a public no-arguments constructor.", e);}
}

那么我们就会有疑问了,copy方法在什么情况下会使用呢 ?
根据源码,可以看到在带滤镜拍照相关的SnapshotGlPictureRecorder类中,会用到copy方法。

protected void onRendererFilterChanged(@NonNull Filter filter) {mTextureDrawer.setFilter(filter.copy());
}

就是预览和拍照用的BaseFilter其实不是同一个Fitler,而是会先copy一份,再去拍照。
因为为了预览流畅,预览和拍照其实用的不是同一个Surface(后面会讲),原来的Fitler已经被预览使用了,所以需要Copy一份,再给拍照使用。

5. 预置的滤镜

CameraView预置了一些常见的滤镜,可以直接拿来使用。

5.1 预设的滤镜大全

预设的滤镜有以下这些
在这里插入图片描述

5.2 亮度滤镜

比如BrightnessFilter是调节亮度的滤镜,其代码如下
可以看到,里面传入了相关的GLSL代码,并在onPreDraw设置了亮度值。

public class BrightnessFilter extends BaseFilter implements OneParameterFilter {private final static String FRAGMENT_SHADER = "#extension GL_OES_EGL_image_external : require\n"+ "precision mediump float;\n"+ "uniform samplerExternalOES sTexture;\n"+ "uniform float brightness;\n"+ "varying vec2 "+DEFAULT_FRAGMENT_TEXTURE_COORDINATE_NAME+";\n"+ "void main() {\n"+ "  vec4 color = texture2D(sTexture, "+DEFAULT_FRAGMENT_TEXTURE_COORDINATE_NAME+");\n"+ "  gl_FragColor = brightness * color;\n"+ "}\n";private float brightness = 2.0f; // 1.0F...2.0Fprivate int brightnessLocation = -1;public BrightnessFilter() { }/*** Sets the brightness adjustment.* 1.0: normal brightness.* 2.0: high brightness.** @param brightness brightness.*/@SuppressWarnings({"WeakerAccess", "unused"})public void setBrightness(float brightness) {if (brightness < 1.0f) brightness = 1.0f;if (brightness > 2.0f) brightness = 2.0f;this.brightness = brightness;}/*** Returns the current brightness.** @see #setBrightness(float)* @return brightness*/@SuppressWarnings({"unused", "WeakerAccess"})public float getBrightness() {return brightness;}@Overridepublic void setParameter1(float value) {// parameter is 0...1, brightness is 1...2.setBrightness(value + 1);}@Overridepublic float getParameter1() {// parameter is 0...1, brightness is 1...2.return getBrightness() - 1F;}@NonNull@Overridepublic String getFragmentShader() {return FRAGMENT_SHADER;}@Overridepublic void onCreate(int programHandle) {super.onCreate(programHandle);brightnessLocation = GLES20.glGetUniformLocation(programHandle, "brightness");Egloo.checkGlProgramLocation(brightnessLocation, "brightness");}@Overridepublic void onDestroy() {super.onDestroy();brightnessLocation = -1;}@Overrideprotected void onPreDraw(long timestampUs, @NonNull float[] transformMatrix) {super.onPreDraw(timestampUs, transformMatrix);GLES20.glUniform1f(brightnessLocation, brightness);Egloo.checkGlError("glUniform1f");}
}

6. MultiFilter

单个滤镜的调用直接调用某个滤镜就可以了,但如果是多个滤镜进行叠加,那么就需要用到MultiFilter,通过addFilter()来叠加多个滤镜。

public class MultiFilter implements Filter, OneParameterFilter, TwoParameterFilter {//...省略了具体代码...
}

6.1 添加滤镜

将添加的滤镜存储在filters列表中

final List<Filter> filters = new ArrayList<>();public void addFilter(@NonNull Filter filter) {if (filter instanceof MultiFilter) {MultiFilter multiFilter = (MultiFilter) filter;for (Filter multiChild : multiFilter.filters) {addFilter(multiChild);}return;}synchronized (lock) {if (!filters.contains(filter)) {filters.add(filter);states.put(filter, new State());}}
}

6.2 绘制滤镜

遍历filters列表,并调用一系列OpenGL的方法,逐个绘制滤镜,上一个滤镜绘制好后,下一个滤镜在上一个滤镜的基础上再绘制,从而最终达到滤镜叠加的效果。

@Override
public void draw(long timestampUs, @NonNull float[] transformMatrix) {synchronized (lock) {for (int i = 0; i < filters.size(); i++) {boolean isFirst = i == 0;boolean isLast = i == filters.size() - 1;Filter filter = filters.get(i);State state = states.get(filter);maybeSetSize(filter);maybeCreateProgram(filter, isFirst, isLast);maybeCreateFramebuffer(filter, isFirst, isLast);//noinspection ConstantConditionsGLES20.glUseProgram(state.programHandle);// Define the output framebuffer.// Each filter outputs into its own framebuffer object, except the// last filter, which outputs into the default framebuffer.if (!isLast) {state.outputFramebuffer.bind();GLES20.glClearColor(0, 0, 0, 0);} else {GLES20.glBindFramebuffer(GLES20.GL_FRAMEBUFFER, 0);}// Perform the actual drawing.// The first filter should apply all the transformations. Then,// since they are applied, we should use a no-op matrix.if (isFirst) {filter.draw(timestampUs, transformMatrix);} else {filter.draw(timestampUs, Egloo.IDENTITY_MATRIX);}// Set the input for the next cycle:// It is the framebuffer texture from this cycle. If this is the last// filter, reset this value just to cleanup.if (!isLast) {state.outputTexture.bind();} else {GLES20.glBindTexture(GLES20.GL_TEXTURE_2D, 0);GLES20.glActiveTexture(GLES20.GL_TEXTURE0);}GLES20.glUseProgram(0);}}
}

7. 其他

7.1 CameraView源码解析系列

Android 相机库CameraView源码解析 (一) : 预览-CSDN博客
Android 相机库CameraView源码解析 (二) : 拍照-CSDN博客
Android 相机库CameraView源码解析 (三) : 滤镜相关类说明-CSDN博客
Android 相机库CameraView源码解析 (四) : 带滤镜拍照-CSDN博客
Android 相机库CameraView源码解析 (五) : 保存滤镜效果-CSDN博客

这篇关于Android 相机库CameraView源码解析 (三) : 滤镜相关类说明的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/452753

相关文章

线上Java OOM问题定位与解决方案超详细解析

《线上JavaOOM问题定位与解决方案超详细解析》OOM是JVM抛出的错误,表示内存分配失败,:本文主要介绍线上JavaOOM问题定位与解决方案的相关资料,文中通过代码介绍的非常详细,需要的朋... 目录一、OOM问题核心认知1.1 OOM定义与技术定位1.2 OOM常见类型及技术特征二、OOM问题定位工具

深度解析Python中递归下降解析器的原理与实现

《深度解析Python中递归下降解析器的原理与实现》在编译器设计、配置文件处理和数据转换领域,递归下降解析器是最常用且最直观的解析技术,本文将详细介绍递归下降解析器的原理与实现,感兴趣的小伙伴可以跟随... 目录引言:解析器的核心价值一、递归下降解析器基础1.1 核心概念解析1.2 基本架构二、简单算术表达

深度解析Java @Serial 注解及常见错误案例

《深度解析Java@Serial注解及常见错误案例》Java14引入@Serial注解,用于编译时校验序列化成员,替代传统方式解决运行时错误,适用于Serializable类的方法/字段,需注意签... 目录Java @Serial 注解深度解析1. 注解本质2. 核心作用(1) 主要用途(2) 适用位置3

Java MCP 的鉴权深度解析

《JavaMCP的鉴权深度解析》文章介绍JavaMCP鉴权的实现方式,指出客户端可通过queryString、header或env传递鉴权信息,服务器端支持工具单独鉴权、过滤器集中鉴权及启动时鉴权... 目录一、MCP Client 侧(负责传递,比较简单)(1)常见的 mcpServers json 配置

从原理到实战解析Java Stream 的并行流性能优化

《从原理到实战解析JavaStream的并行流性能优化》本文给大家介绍JavaStream的并行流性能优化:从原理到实战的全攻略,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的... 目录一、并行流的核心原理与适用场景二、性能优化的核心策略1. 合理设置并行度:打破默认阈值2. 避免装箱

Maven中生命周期深度解析与实战指南

《Maven中生命周期深度解析与实战指南》这篇文章主要为大家详细介绍了Maven生命周期实战指南,包含核心概念、阶段详解、SpringBoot特化场景及企业级实践建议,希望对大家有一定的帮助... 目录一、Maven 生命周期哲学二、default生命周期核心阶段详解(高频使用)三、clean生命周期核心阶

Android协程高级用法大全

《Android协程高级用法大全》这篇文章给大家介绍Android协程高级用法大全,本文结合实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友跟随小编一起学习吧... 目录1️⃣ 协程作用域(CoroutineScope)与生命周期绑定Activity/Fragment 中手

深入解析C++ 中std::map内存管理

《深入解析C++中std::map内存管理》文章详解C++std::map内存管理,指出clear()仅删除元素可能不释放底层内存,建议用swap()与空map交换以彻底释放,针对指针类型需手动de... 目录1️、基本清空std::map2️、使用 swap 彻底释放内存3️、map 中存储指针类型的对象

Java Scanner类解析与实战教程

《JavaScanner类解析与实战教程》JavaScanner类(java.util包)是文本输入解析工具,支持基本类型和字符串读取,基于Readable接口与正则分隔符实现,适用于控制台、文件输... 目录一、核心设计与工作原理1.底层依赖2.解析机制A.核心逻辑基于分隔符(delimiter)和模式匹

Java+AI驱动实现PDF文件数据提取与解析

《Java+AI驱动实现PDF文件数据提取与解析》本文将和大家分享一套基于AI的体检报告智能评估方案,详细介绍从PDF上传、内容提取到AI分析、数据存储的全流程自动化实现方法,感兴趣的可以了解下... 目录一、核心流程:从上传到评估的完整链路二、第一步:解析 PDF,提取体检报告内容1. 引入依赖2. 封装