GPUImage源码解析 -- GPUImageOutput/Input

在上一篇文章中介绍了GPUImage框架中的核心载体GPUImageFrameBuffer,在接下来的文章中,我们将介绍如何使用这个载体实现渲染和传递。本文将重点介绍GPUImage中的一个非常重要的基类GPUImageOutput和一个协议GPUImageInput。基本上所有重要的GPUImage处理类都是GPUImageOutput的子类,它实现了一个输出的基本功能。

同样的,基本上所有的GPUImage处理类也都遵循GPUImageInput协议。它定义了一个能够接收frameBuffer的接收者所必须实现的基本功能。主要包括:
*接收上一个GPUImageOutput的相关信息;
*接收并处理上一个GPUImageOutput渲染完成的通知;

GPUImageOutput

GPUImageOuput实现了一些作为一个Output的基本功能,主要包括:

  • 生成,管理到GPUImageFrameBuffer
  • Target的添加以及管理,用来生成整个FilterChain;
  • 产出一个渲染的结果;

GPUImageFrameBuffer的管理

每个GPUImageOutput都会包含一个自己的GPUImageFrameBuffer对象;可以通过outputFrameBuffer方法获得。这个FrameBuffer对象就是当前Output渲染的对象。

这个FrameBuffer对象不是一直存在的,而是当这个Output需要进行渲染的时候,才会从GPUImageFrameBufferCache中取一个。因此,并不是随时都能够获得一个GPUImageFrameBuffer对象的。一般情况下,当渲染完毕并且通知了FilterChain中的下一个target之后,就会被remove掉,并且归还给GPUImageFrameBufferCache以供重用。

与FrameBuffer相关的方法有:

- (void)setInputFramebufferForTarget:(id<GPUImageInput>)target atIndex:(NSInteger)inputTextureIndex;

这个方法的调用发生在当前output渲染完毕后,需要通知下一个receiver可以开始渲染的时候,把当前Output的FrameBuffer传递给下一个Input,让它可以使用这个FrameBuffer的结果进行渲染。

- (GPUImageFramebuffer *)framebufferForOutput;

这个方法可以获得当前正在渲染的frameBuffer,但是这个方法更大的用处是给子类提供一个覆盖的接口。子类可以通过覆盖这个方法,来提供输出的frameBuffer。因为有一些多个pass的滤镜可能会有多个FrameBuffer。

- (void)removeOutputFramebuffer;

这个方法用来移除当前渲染的frameBuffer,同样,这个方法更大的用处是给子类提供一个移除当前FrameBuffer的机会。

Target的管理

GPUImageOutput既然作为一个输出,那么自然就应该有对应的接受者来接受这个FrameBuffer并且使用这个Output处理的结果进行渲染。这些接受者我们都将它称之为target。每个Target都是一个实现了GPUImageInput协议的对象。这些对象可以接收FrameBuffer,处理当前Output渲染完毕的通知等等。GPUImageInput会在接下来的解析中详细介绍。

与Target管理相关的方法有:

- (NSArray*)targets;

这个方法可以获取到当前Output所有的target。每个Output都可以添加多个target,当这个Output渲染完成之后,每个target都会收到通知。

- (void)addTarget:(id<GPUImageInput>)newTarget;
- (void)addTarget:(id<GPUImageInput>)newTarget atTextureLocation:(NSInteger)textureLocation;

这两个addTarget方法的作用都是将下一个实现了GPUImageInput协议的对象添加到FilterChain当中来。在一个GPUImageInput被添加到FilterChain之后,它做的主要事情包括:将当前Output的outputFrameBuffer作为input传递给这个GPUImageInput对象;设置这个outputFrameBuffer所在的TextureLocation。TextureLocation的作用是:有些可以同时接受多个Input的对象,它要将不同的frameBuffer的texture绑定到不同的位置上。因为每个GL_TEXTURE同时只能接受一个texture的绑定。

[self setInputFramebufferForTarget:newTarget atIndex:textureLocation];
[targets addObject:newTarget];
[targetTextureIndices addObject:[NSNumber numberWithInteger:textureLocation]];

移除Targets:

- (void)removeTarget:(id<GPUImageInput>)targetToRemove;
- (void)removeAllTargets;

这两个方法的作用是将某一个或者所有的target都移出FilterChain。当一个target被移出FilterChain之后,它将不会再收到任何当前Output渲染完成的通知。

获取当前FrameBuffer的处理结果

GPUImageOutput提供了一些从当前Output获得处理结果的方法,让使用者可以简单的获得处理的结果:

- (CGImageRef)newCGImageFromCurrentlyProcessedOutput;
- (CGImageRef)newCGImageByFilteringCGImage:(CGImageRef)imageToFilter;
- (UIImage *)imageFromCurrentFramebuffer;
- (UIImage *)imageFromCurrentFramebufferWithOrientation:(UIImageOrientation)imageOrientation;
- (UIImage *)imageByFilteringImage:(UIImage *)imageToFilter;
- (CGImageRef)newCGImageByFilteringImage:(UIImage *)imageToFilter;

其中最核心的方法是newCGImageFromCurrentlyProcessedOutput,基本上所有的方法最终都调用了这个方法。但是GPUImageOutput并没有为这个方法提供默认的实现,而是提供了一个方法定义。具体的实现在它的两个重要的子类GPUImageFilterGPUImageFilterGroup中。而实际上最终调用的方法都在GPUImageFilter中实现了,GPUImageFilterGroup的实现实际上是调用了它的terminalFilter中的实现。

在获取一个FilterChain中的一个GPUImageOutput的处理结果时,有一个非常重要的方法需要调用:

- (void)useNextFrameForImageCapture;

在我们上一篇介绍GPUImageFrameBuffer的文章中,我们说到了所有的FrameBuffer都是有引用计数的,当一个FrameBuffer的引用计数为零的时候,它会被归还到FrameBufferCache中。当一个GPUImageOutput处于一个FilterChain中的时候,他渲染完成并且通知下一个input,当下一个input也渲染完成之后,这个FrameBuffer的引用计数就会为零,因此也会被释放掉。这个时候如果调用newCGImageFromCurrentlyProcessedOutput方法的话,就会多次释放一个FrameBuffer导致Crash,或者获取不到这个FrameBuffer。

useNextFrameForImageCapture方法的左右就是:在渲染的时候,再调用一次GPUImageFrameBufferlock方法,强行将引用计数+1.这样这个FrameBuffer就会一直存在于这个Output中,可以用来进行渲染结果的获取。

GPUImageInput

GPUImageInput协议是为了保证每一个接收GPUImageOutput输出的对象都能够正确地处理对应的输入的。它的功能主要包括:

  • 接收GPUmageOutput的输出信息;
  • 处理GPUImageOutput渲染完成的通知;

接收GPUImageOutput的输出信息

根据之前介绍的GPUImageOutput,它添加的每一个Target都必须实现了GPUImageInput协议。因此GPUImageInput协议保证了所有实现它的对象都能够接收output的输出。主要输出信息包括:

- (void)setInputFramebuffer:(GPUImageFramebuffer *)newInputFramebuffer atIndex:(NSInteger)textureIndex;
- (NSInteger)nextAvailableTextureIndex;
- (void)setInputSize:(CGSize)newSize atIndex:(NSInteger)textureIndex;
- (void)setInputRotation:(GPUImageRotationMode)newInputRotation atIndex:(NSInteger)textureIndex;

GPUImageInput可以接收的信息包括上一个Output输出的frameBuffer,frameBuffer的size以及rotation。同样的这些textureIndex都是为了提供个需要多个input的Filter准备的。

处理GPUImageOutput渲染完成的通知

GPUImageOutput在渲染完成之后,会通知它所有的targets,因此,GPUImageInput需要实现下面这个方法来接收这个通知,并且开始自己的渲染:

- (void)newFrameReadyAtTime:(CMTime)frameTime atIndex:(NSInteger)textureIndex;

其中,参数frameTime主要是给视频处理的时候使用的,当多个输入都是视频的时候,可以使用frameTime来确保多个输入是同步的;
本文主要介绍了GPUImage中最重要的基类和协议GPUImageOutputGPUImageInput,它们具体的实现都在GPUImageFilter以及GPUImageFilterGroup中,我们会在接下来的解析中具体看看他们的实现。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,324评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,356评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,328评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,147评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,160评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,115评论 1 296
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,025评论 3 417
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,867评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,307评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,528评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,688评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,409评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,001评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,657评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,811评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,685评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,573评论 2 353