美摄SDK For iOS  3.14.0
NvsCustomVideoFx.h
浏览该文件的文档.
1 //================================================================================
2 //
3 // (c) Copyright Meishe Co. Ltd, 2017. All rights reserved.
4 //
5 // This code and information is provided "as is" without warranty of any kind,
6 // either expressed or implied, including but not limited to the implied
7 // warranties of merchantability and/or fitness for a particular purpose.
8 //
9 //--------------------------------------------------------------------------------
10 // Birth Date: Jul 20. 2017
11 // Author: Meishe video team
12 //================================================================================
13 #pragma once
14 
15 #import <Foundation/Foundation.h>
16 #import "NvsCommonDef.h"
17 
19  int texId;
20  int width;
21  int height;
24 
26 };
27 
36  int64_t effectTime;
37  int64_t effectStartTime;
38  int64_t effectEndTime;
39  int64_t mediaStreamTime;
40 };
41 
43 
52 @protocol NvsCustomVideoFxRenderer <NSObject>
53 
66 - (void)didInit;
67 
80 - (void)didCleanup;
81 
96 - (void)didPreloadResources;
97 
126 - (void)didRender:(struct NvsCustomVideoFxRenderContext *)renderContext
127  renderHelper:(NvsCustomVideoFxRenderHelper *)renderHelper;
128 
129 @optional
130 
143 - (void)didClearCacheResources;
144 
159 - (bool)needInputBuddyFrame;
160 
161 @end
162 
170 
185 - (int)allocateRGBATexture:(NvsSize)texSize;
186 
203 - (int)allocateRGBATexture:(NvsSize)texSize format:(NvsGpuVideoFrameFormat)fmt;
204 
213 - (void)reclaimTexture:(int)texId;
214 
225 - (BOOL)uploadHostBufferToOpenGLTexture:(NvsVideoFrameInfo*)hostBuffer textureId:(int)tId;
226 
237 - (BOOL)uploadHostBufferToOpenGLTexture:(NvsVideoFrameInfoExt*)hostBuffer gpuVideoFrame:(struct NvsCustomVideoFxVideoFrame*)tex;
238 
239 @end
240 
NvsCustomVideoFxRenderContext::inputVideoFrame
struct NvsCustomVideoFxVideoFrame inputVideoFrame
输入视频帧
Definition: NvsCustomVideoFx.h:29
NvsVideoFrameColorPrimaries
NvsVideoFrameColorPrimaries
Definition: NvsCommonDef.h:254
NvsCustomVideoFxVideoFrame::texId
int texId
视频帧的纹理ID
Definition: NvsCustomVideoFx.h:19
NvsVideoFrameColorTransfer
NvsVideoFrameColorTransfer
Definition: NvsCommonDef.h:235
NvsCustomVideoFxVideoFrame::proxyScale
NvsRational proxyScale
Definition: NvsCustomVideoFx.h:23
NvsCustomVideoFxVideoFrame::isUpsideDownTexture
BOOL isUpsideDownTexture
值为YES表示这个视频帧中的纹理是上下颠倒的。用户在渲染时需对纹理坐标进行处理。
Definition: NvsCustomVideoFx.h:22
NvsVideoFrameInfo
视频帧信息
Definition: NvsCommonDef.h:446
NvsCustomVideoFxRenderContext::effectEndTime
int64_t effectEndTime
特效终止时间(单位微秒)
Definition: NvsCustomVideoFx.h:38
-[NvsCustomVideoFxRenderer-p didCleanup]
void didCleanup()
美摄SDK对自定义视频特效调用此方法以便让用户清理资源
-[NvsCustomVideoFxRenderer-p didClearCacheResources]
void didClearCacheResources()
美摄SDK对自定义视频特效调用此方法以便让进行资源清理。
NvsRational
比例值
Definition: NvsCommonDef.h:339
NvsCustomVideoFxRenderContext
Definition: NvsCustomVideoFx.h:28
NvsCustomVideoFxRenderContext::hasBuddyVideoFrame
bool hasBuddyVideoFrame
表示伴侣视频帧是否存在,伴侣视频帧只有在采集的时,而且设置了STREAMING_ENGINE_CAPTURE_FLAG_CAPTURE_BUDDY_HOST_VIDEO_FRAME才会存在
Definition: NvsCustomVideoFx.h:30
NvsCustomVideoFxVideoFrame::width
int width
视频帧的宽度
Definition: NvsCustomVideoFx.h:20
NvsCustomVideoFxRenderContext::mediaStreamTime
int64_t mediaStreamTime
特效终止时间(单位微秒)
Definition: NvsCustomVideoFx.h:39
NvsCustomVideoFxRenderContext::effectStartTime
int64_t effectStartTime
特效起始时间(单位微秒)
Definition: NvsCustomVideoFx.h:37
NvsCustomVideoFxRenderContext::inputBuddyVideoFrame
NvsVideoFrameInfo inputBuddyVideoFrame
输入视频帧在Host Memory中数据和信息
Definition: NvsCustomVideoFx.h:31
NvsCustomVideoFxRenderer-p
自定义视频特效渲染器接口
Definition: NvsCustomVideoFx.h:52
-[NvsCustomVideoFxRenderer-p needInputBuddyFrame]
bool needInputBuddyFrame()
美摄SDK对自定义视频特效调用此方法以便确认CustomVideoFx是否需要侣视频帧。
NvsCustomVideoFxRenderContext::inputBuddyVideoFrameColorMatrix
NvsVideoFrameYUVColorMatrix inputBuddyVideoFrameColorMatrix
Definition: NvsCustomVideoFx.h:32
NvsCustomVideoFxRenderContext::outputVideoFrame
struct NvsCustomVideoFxVideoFrame outputVideoFrame
输出视频帧
Definition: NvsCustomVideoFx.h:35
NvsCustomVideoFxVideoFrame::height
int height
视频帧的高度
Definition: NvsCustomVideoFx.h:21
NvsCustomVideoFxRenderHelper
自定义视频特效的辅助方法接口
Definition: NvsCustomVideoFx.h:170
NvsVideoFrameYUVColorMatrix
NvsVideoFrameYUVColorMatrix
Definition: NvsCommonDef.h:217
NVS_EXPORT
#define NVS_EXPORT
Definition: NvsCommonDef.h:20
-[NvsCustomVideoFxRenderer-p didPreloadResources]
void didPreloadResources()
美摄SDK对自定义视频特效调用此方法以便让进行一些资源预处理
NvsCustomVideoFxVideoFrame::texFormat
NvsGpuVideoFrameFormat texFormat
Definition: NvsCustomVideoFx.h:25
-[NvsCustomVideoFxRenderer-p didInit]
void didInit()
美摄SDK对自定义视频特效调用此方法以便让用户初始化一些资源
NvsCommonDef.h
NvsGpuVideoFrameFormat
NvsGpuVideoFrameFormat
视频帧像素格式
Definition: NvsCommonDef.h:202
NvsCustomVideoFxRenderContext::inputBuddyVideoFrameColorPrimaries
NvsVideoFrameColorPrimaries inputBuddyVideoFrameColorPrimaries
Definition: NvsCustomVideoFx.h:34
NvsCustomVideoFxVideoFrame
Definition: NvsCustomVideoFx.h:18
NvsCustomVideoFxRenderContext::effectTime
int64_t effectTime
特效时间(单位微秒)
Definition: NvsCustomVideoFx.h:36
NvsCustomVideoFxRenderContext::inputBuddyVideoFrameColorTransfer
NvsVideoFrameColorTransfer inputBuddyVideoFrameColorTransfer
Definition: NvsCustomVideoFx.h:33
NvsSize
尺寸
Definition: NvsCommonDef.h:350
NvsVideoFrameInfoExt
视频帧扩展信息
Definition: NvsCommonDef.h:466