com.netease.vcloud.video.effect

类 VideoEffect

java.lang.Object

com.netease.vcloud.video.effect.VideoEffect

public abstract class VideoEffect
extends java.lang.Object

视频前处理类 Created by hzzhujinbo on 2017/3/21.

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	VideoEffect.DataFormat
static class	VideoEffect.FilterType
static class	VideoEffect.Rect
static class	VideoEffect.TextureData
static class	VideoEffect.YUVData

构造器概要

构造器

构造器和说明
VideoEffect()

方法概要

限定符和类型	方法和说明
static int	AddBitmap(byte[] yuv, int width, int height, byte[] bitmap, int bitmapWidth, int bitmapHeight, int x, int y) 在YUV上添加图片
boolean	addBitmapToI420(byte[] yuv, int width, int height, byte[] bitmap, int bitmapWidth, int bitmapHeight, VideoEffect.Rect rect, int x, int y) 在YUV数据上添加bitmap格式的图片
void	addDynamicWaterMark(Bitmap[] bitmapArray, int x, int y, int fps, int cameraFps, boolean looped) 已过时。 replaced by addDynamicWaterMark(Bitmap[], int, int, int, int, boolean)
void	addDynamicWaterMark(Bitmap[] bitmapArray, VideoEffect.Rect rect, int x, int y, int fps, int cameraFps, boolean looped) 添加动态水印（只需要调用一次）
void	addGraffiti(Bitmap bitmap, int x, int y) 添加涂鸦（涂鸦需要每帧都调用）
void	addWaterMark(Bitmap bitmap, int x, int y) 已过时。 replaced by addWaterMark(Bitmap, Rect, int, int)
void	addWaterMark(Bitmap bitmap, VideoEffect.Rect rect, int x, int y) 添加水印（只需要调用一次）
abstract void	cameraSwitchDown() 相机切换通知
void	closeDynamicWaterMark(boolean close)
VideoEffect.TextureData[]	dealInTexture(int textureType, int textureId, int srcWidth, int srcHeight, int cameraRotation, int displayOrientation, int cropWidth, int cropHeight, boolean needI420Data, boolean needMirrorData) 对原始纹理进行旋转、裁剪等操作后返回一个Sample 2D类型的纹理以及yuv i420的buffer(如果需要)
VideoEffect.TextureData	effectDynamicWater(VideoEffect.TextureData data, boolean next, boolean needI420Data) 手动动态水印
void	effectDynamicWater(VideoEffect.YUVData data, boolean next) 手动动态水印
VideoEffect.TextureData	effectGraffiti(VideoEffect.TextureData data, boolean needI420Data) 手动涂鸦
void	effectGraffiti(VideoEffect.YUVData data) 手动涂鸦
VideoEffect.TextureData	effectWater(VideoEffect.TextureData data, boolean needI420Data) 手动水印
void	effectWater(VideoEffect.YUVData data) 手动水印
abstract byte[]	filterBitmapToRGBA(Bitmap bitmap, int width, int height) 对bitmap图片进行滤镜
abstract int	filterBitmapToTexture(Bitmap bitmap, int width, int height) 对bitmap图片进行滤镜
abstract byte[]	filterBufferToRGBA(VideoEffect.DataFormat format, byte[] data, int width, int height) 采用GPU对buffer数据进行滤镜处理（必须在具有EGLContext的线程上进行调用）
abstract boolean	filterInit(Context context) 初始化滤镜模块（已有EGLContext的线程中调用，如GLSurfaceView.Renderer 的 onSurfaceCreated ）
abstract boolean	filterInitWithoutGLContext(Context context) 初始化滤镜模块 如果当前线程没有EGLContext，那么该接口会创建一个 后续所有的API必须保证在*同一个*具有*GL Context*的线程被调用
abstract int	filterTexture(int texture, int width, int height) 采用GPU对Camera采集的OES Texture进行滤镜处理 （必须在具有EGLContext的线程上进行调用）
abstract byte[]	filterTextureToRGBA(int texture, int width, int height) 采用GPU对Camera采集的OES Texture进行滤镜处理 （必须在具有EGLContext的线程上进行调用）
abstract void	filterUnInit() 滤镜模式资源释放
static int	glReadPixelsPBO(int x, int y, int width, int height, int format, int type) JNI glReadPixels 用于PBO下GPU内存映射
static int	I420ToNV21(byte[] src, int width, int height, byte[] dst) I420转NV21
void	init(Context context, boolean useFilter, boolean hasGLContext) 初始化前处理
abstract void	setBeautyLevel(int level) 设置滤镜强度
abstract void	setBrightness(float brightness)
abstract void	setContrast(float contrast)
abstract void	setFilterLevel(float level) 设置滤镜强度
abstract void	setFilterType(VideoEffect.FilterType type) 设置滤镜类型
abstract void	setHue(float hue)
abstract void	setSaturation(float saturation)
abstract void	setSharpen(float sharpen)
static int	TOARGB(byte[] src, int colourSpaceType, int width, int height, byte[] dst) TOARGB
void	toI420(byte[] src, VideoEffect.DataFormat dataFormat, int width, int height, byte[] out) 原始视频数据转YUV，同时会根据配置进行水印、涂鸦等操作
static int	TOYUV(byte[] data, int colourSpaceType, int inWidth, int inHeight, int rotation, byte[] yuv, int outWidth, int outHeight) 原始视频数据转YUV
VideoEffect.YUVData[]	TOYUV420(byte[] src, VideoEffect.DataFormat dataFormat, int inWidth, int inHeight, int cameraRotation, int displayOrientation, int outWidth, int outHeight, boolean needMirrorData, boolean autoEffect) 原始视频数据转YUV，同时会根据配置进行水印、涂鸦、旋转等操作，保证输出的是正的YUV数据
void	unInit() 销毁前处理数据
static int	YUVMirror(byte[] srcYuv, int width, int height, byte[] dstYuv) mirror YUV 数据
static int	YUVScale(byte[] src, int inWidth, int inHeight, byte[] dst, int outWidth, int outHeight) YUV I420缩放

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

VideoEffect

public VideoEffect()

方法详细资料

addWaterMark

@Deprecated
public void addWaterMark(Bitmap bitmap,
                                     int x,
                                     int y)

已过时。 replaced by addWaterMark(Bitmap, Rect, int, int)

添加水印（只需要调用一次）

参数:

bitmap - 水印图片

x - 水印水平坐标X，整个图像左上角为（0，0）点

y - 水印垂直坐标Y，整个图像左上角为（0，0）点

addWaterMark

public void addWaterMark(Bitmap bitmap,
                         VideoEffect.Rect rect,
                         int x,
                         int y)

添加水印（只需要调用一次）

参数:

bitmap - 水印图片

rect - 水印具体位置（上下左右中四个基本位置）

x - 距离 rect 的 x 坐标

y - 距离 rect 的 y 坐标

addDynamicWaterMark

@Deprecated
public void addDynamicWaterMark(Bitmap[] bitmapArray,
                                            int x,
                                            int y,
                                            int fps,
                                            int cameraFps,
                                            boolean looped)

已过时。 replaced by addDynamicWaterMark(Bitmap[], int, int, int, int, boolean)

添加动态水印（只需要调用一次）

参数:

bitmapArray - 水印图片

x - 水印水平坐标X，整个图像左上角为（0，0）点

y - 水印垂直坐标Y，整个图像左上角为（0，0）点

fps - 动态水印的帧率

cameraFps - 相机采集的帧率

looped - 是否循环播放

addDynamicWaterMark

public void addDynamicWaterMark(Bitmap[] bitmapArray,
                                VideoEffect.Rect rect,
                                int x,
                                int y,
                                int fps,
                                int cameraFps,
                                boolean looped)

添加动态水印（只需要调用一次）

参数:

bitmapArray - 水印图片

rect - 水印具体位置（上下左右中四个基本位置）

x - 距离 rect 的 x 坐标

y - 距离 rect 的 y 坐标

fps - 动态水印的帧率

cameraFps - 相机采集的帧率

looped - 是否循环播放

closeDynamicWaterMark

public void closeDynamicWaterMark(boolean close)

addGraffiti

public void addGraffiti(Bitmap bitmap,
                        int x,
                        int y)

添加涂鸦（涂鸦需要每帧都调用）

参数:

bitmap - 水印图片

x - 水印水平坐标X，整个图像左上角为（0，0）点

y - 水印垂直坐标Y，整个图像左上角为（0，0）点

init

public void init(Context context,
                 boolean useFilter,
                 boolean hasGLContext)

初始化前处理

参数:

context - 应用上下文，建议使用ApplicationContext

useFilter - 是否使用滤镜

hasGLContext - 调用线程是否具有EGLContext

unInit

public void unInit()

销毁前处理数据

filterInit

public abstract boolean filterInit(Context context)

初始化滤镜模块（已有EGLContext的线程中调用，如GLSurfaceView.Renderer 的 onSurfaceCreated ）

参数:

context - 应用上下文，建议使用ApplicationContext

返回:

true/false

filterInitWithoutGLContext

public abstract boolean filterInitWithoutGLContext(Context context)

初始化滤镜模块 如果当前线程没有EGLContext，那么该接口会创建一个 后续所有的API必须保证在*同一个*具有*GL Context*的线程被调用

参数:

context - 应用上下文，建议使用ApplicationContext

返回:

true/false

filterUnInit

public abstract void filterUnInit()

滤镜模式资源释放

setFilterType

public abstract void setFilterType(VideoEffect.FilterType type)

设置滤镜类型

参数:

type - 滤镜类型

setFilterLevel

public abstract void setFilterLevel(float level)

设置滤镜强度

参数:

level - （0-1）

setBeautyLevel

public abstract void setBeautyLevel(int level)

设置滤镜强度

参数:

level - （0-5）

setBrightness

public abstract void setBrightness(float brightness)

setContrast

public abstract void setContrast(float contrast)

setSaturation

public abstract void setSaturation(float saturation)

setHue

public abstract void setHue(float hue)

setSharpen

public abstract void setSharpen(float sharpen)

filterBufferToRGBA

public abstract byte[] filterBufferToRGBA(VideoEffect.DataFormat format,
                                          byte[] data,
                                          int width,
                                          int height)

采用GPU对buffer数据进行滤镜处理（必须在具有EGLContext的线程上进行调用）

参数:

format - 数据类型

data - 原始数据

width - 图像宽

height - 图像高

返回:

RGBA图像数组

filterTextureToRGBA

public abstract byte[] filterTextureToRGBA(int texture,
                                           int width,
                                           int height)

采用GPU对Camera采集的OES Texture进行滤镜处理 （必须在具有EGLContext的线程上进行调用）

参数:

texture - OES Texture

width - 采集图像宽

height - 采集图像高

返回:

RGBA图像数组

cameraSwitchDown

public abstract void cameraSwitchDown()

相机切换通知

filterTexture

public abstract int filterTexture(int texture,
                                  int width,
                                  int height)

采用GPU对Camera采集的OES Texture进行滤镜处理 （必须在具有EGLContext的线程上进行调用）

参数:

texture - OES Texture

width - 采集图像宽

height - 采集图像高

返回:

2D texture纹理，可以对这个texture做后续操作，如硬编、预览

filterBitmapToTexture

public abstract int filterBitmapToTexture(Bitmap bitmap,
                                          int width,
                                          int height)

对bitmap图片进行滤镜

参数:

bitmap - 原始图片

width - 图片宽

height - 图片高

返回:

滤镜后的纹理

filterBitmapToRGBA

public abstract byte[] filterBitmapToRGBA(Bitmap bitmap,
                                          int width,
                                          int height)

对bitmap图片进行滤镜

参数:

bitmap - 原始图片

width - 图片宽

height - 图片高

返回:

滤镜后的RGBA数据

dealInTexture

public VideoEffect.TextureData[] dealInTexture(int textureType,
                                               int textureId,
                                               int srcWidth,
                                               int srcHeight,
                                               int cameraRotation,
                                               int displayOrientation,
                                               int cropWidth,
                                               int cropHeight,
                                               boolean needI420Data,
                                               boolean needMirrorData)

对原始纹理进行旋转、裁剪等操作后返回一个Sample 2D类型的纹理以及yuv i420的buffer(如果需要)

参数:

textureType - 输入纹理类型 GLES11Ext.GL_TEXTURE_EXTERNAL_OES、GLES20.GL_TEXTURE_2D

textureId - 输入纹理ID

srcWidth - 输入宽

srcHeight - 输入高

cameraRotation - 相机拍摄调度

displayOrientation - 计算后的显示角度

cropWidth - 裁剪宽

cropHeight - 裁剪高

needI420Data - 是否需要同时返回yuv I420格式的buffer

needMirrorData - 是否需要镜像后的数据（主要用于前置摄像头下水印、涂鸦等本地镜像显示和编码数据的区别）

返回:

Sample 2D类型的纹理以及yuv i420的buffer(如果需要)

TOYUV420

public VideoEffect.YUVData[] TOYUV420(byte[] src,
                                      VideoEffect.DataFormat dataFormat,
                                      int inWidth,
                                      int inHeight,
                                      int cameraRotation,
                                      int displayOrientation,
                                      int outWidth,
                                      int outHeight,
                                      boolean needMirrorData,
                                      boolean autoEffect)

原始视频数据转YUV，同时会根据配置进行水印、涂鸦、旋转等操作，保证输出的是正的YUV数据

参数:

src - 原始视频数据

dataFormat - 原始视频数据的色彩空间类型

inWidth - 输入视频宽

inHeight - 输入视频高

cameraRotation - 相机拍摄调度

displayOrientation - 计算后的显示角度

outWidth - 输出视频宽

outHeight - 输出视频高

needMirrorData - 是否需要镜像后的数据（主要用于前置摄像头下水印、涂鸦等本地镜像显示和编码数据的区别）

autoEffect - 是否自动添加上水印、涂鸦等

返回:

具有水印、涂鸦等正的YUV数据

toI420

public void toI420(byte[] src,
                   VideoEffect.DataFormat dataFormat,
                   int width,
                   int height,
                   byte[] out)

原始视频数据转YUV，同时会根据配置进行水印、涂鸦等操作

参数:

src - 原始数据

dataFormat - 原始数据格式

width - 视频宽

height - 视频高

out - 输出buffer,由外部创建

addBitmapToI420

public boolean addBitmapToI420(byte[] yuv,
                               int width,
                               int height,
                               byte[] bitmap,
                               int bitmapWidth,
                               int bitmapHeight,
                               VideoEffect.Rect rect,
                               int x,
                               int y)

在YUV数据上添加bitmap格式的图片

参数:

yuv - 原始yuv数据

width - yuv 宽

height - yuv 高

bitmap - bitmap的数据

bitmapWidth - bitmap 宽

bitmapHeight - bitmap 高

rect - 位置（上下左右中，或者没有）

x - 距离位置的X 坐标

y - 距离位置的 Y 坐标

返回:

true or false

effectWater

public void effectWater(VideoEffect.YUVData data)

手动水印

参数:

data - I420格式的数据

effectWater

public VideoEffect.TextureData effectWater(VideoEffect.TextureData data,
                                           boolean needI420Data)

手动水印

参数:

data - 纹理格式的数据

needI420Data - 是否需要I420数据

effectDynamicWater

public VideoEffect.TextureData effectDynamicWater(VideoEffect.TextureData data,
                                                  boolean next,
                                                  boolean needI420Data)

手动动态水印

参数:

data - 纹理格式的数据

next - 是否递增（主要用户本地显示与推流分开调用时，保证动态水印是同一张）

needI420Data - 是否需要I420数据

effectDynamicWater

public void effectDynamicWater(VideoEffect.YUVData data,
                               boolean next)

手动动态水印

参数:

data - I420格式的数据

next - 是否递增（主要用户本地显示与推流分开调用时，保证动态水印是同一张）

effectGraffiti

public VideoEffect.TextureData effectGraffiti(VideoEffect.TextureData data,
                                              boolean needI420Data)

手动涂鸦

参数:

data - 纹理格式的数据

needI420Data - 是否需要I420数据

effectGraffiti

public void effectGraffiti(VideoEffect.YUVData data)

手动涂鸦

参数:

data - I420格式的数据

TOARGB

public static int TOARGB(byte[] src,
                         int colourSpaceType,
                         int width,
                         int height,
                         byte[] dst)

TOARGB

参数:

src - 原始数据

colourSpaceType - 原始视频的色彩空间类型

width - 原始数据宽

height - 原始数据高

dst - 目标数据

返回:

处理结果 0 为成功

I420ToNV21

public static int I420ToNV21(byte[] src,
                             int width,
                             int height,
                             byte[] dst)

I420转NV21

参数:

src - i420 数据

width - 宽

height - 搞

dst - NV21数据

返回:

处理结果 0 为成功

glReadPixelsPBO

public static int glReadPixelsPBO(int x,
                                  int y,
                                  int width,
                                  int height,
                                  int format,
                                  int type)

JNI glReadPixels 用于PBO下GPU内存映射

参数:

x - image 左上角 x 坐标

y - image 左上角 y 坐标

width - image 宽

height - image 高

format - buffer 类型

type - buffer 格式

返回:

处理结果 0 为成功

TOYUV

public static int TOYUV(byte[] data,
                        int colourSpaceType,
                        int inWidth,
                        int inHeight,
                        int rotation,
                        byte[] yuv,
                        int outWidth,
                        int outHeight)

原始视频数据转YUV

参数:

data - 原始视频数据

colourSpaceType - 原始视频的色彩空间类型

inWidth - 输入视频宽

inHeight - 输入视频高

rotation - 旋转角度(0、90、180、270)

yuv - 输出的yuv

outWidth - 输出视频宽

outHeight - 输出视频高

返回:

处理结果 0 为成功

AddBitmap

public static int AddBitmap(byte[] yuv,
                            int width,
                            int height,
                            byte[] bitmap,
                            int bitmapWidth,
                            int bitmapHeight,
                            int x,
                            int y)

在YUV上添加图片

参数:

yuv - 原始YUV数据

width - yuv 宽

height - yuv 高

bitmap - 图片数据

bitmapWidth - 图片宽

bitmapHeight - 图片高

x - 图片左上角

y - 图片右上角

返回:

处理结果 0 为成功

YUVMirror

public static int YUVMirror(byte[] srcYuv,
                            int width,
                            int height,
                            byte[] dstYuv)

mirror YUV 数据

参数:

srcYuv - 原始YUV

width - yuv宽

height - yuv高

dstYuv - 输出的yuv

返回:

处理结果 0 为成功

YUVScale

public static int YUVScale(byte[] src,
                           int inWidth,
                           int inHeight,
                           byte[] dst,
                           int outWidth,
                           int outHeight)

YUV I420缩放

参数:

src - 原始YUV数据

inWidth - 原始宽

inHeight - 原始高

dst - 输出YUV数据

outWidth - 目标宽

outHeight - 目标高

返回: