Metal入門教程（三）攝像頭採集渲染

落影發表於2018-07-09

前言

Metal入門教程（一）圖片繪製
Metal入門教程（二）三維變換

前面的教程介紹瞭如何繪製一張圖片和如何把圖片顯示到3D物體上並進行三維變換，這次介紹如何用Metal渲染攝像頭採集到的影象。

Metal系列教程的程式碼地址；
OpenGL ES系列教程在這裡；

你的star和fork是我的源動力，你的意見能讓我走得更遠。

正文

核心思路

用AVFoundation採集攝像頭資料得到CMSampleBufferRef，用CoreVideo提供的方法將影象資料轉為Metal的紋理，再用MetalPerformanceShaders的高斯模糊濾鏡對影象進行處理，結果展示到螢幕上。

效果展示

Metal入門教程（三）攝像頭採集渲染
123.gif

具體步驟

1、Metal相關設定
- (void)setupMetal {
    self.mtkView = [[MTKView alloc] initWithFrame:self.view.bounds];
    self.mtkView.device = MTLCreateSystemDefaultDevice();
    [self.view insertSubview:self.mtkView atIndex:0];
    self.mtkView.delegate = self;
    self.mtkView.framebufferOnly = NO;
    self.commandQueue = [self.mtkView.device newCommandQueue];
    CVMetalTextureCacheCreate(NULL, NULL, self.mtkView.device, NULL, &_textureCache);
}
複製程式碼

除了正常建立和初始化MTKView之外，這裡還多兩行程式碼：

  • 設定MTKView的dramwable紋理是可讀寫的；（預設是隻讀）
  • 建立CVMetalTextureCacheRef _textureCache，這是Core Video的Metal紋理快取；
2、攝像頭採集設定
- (void)setupCaptureSession {
    self.mCaptureSession = [[AVCaptureSession alloc] init];
    self.mCaptureSession.sessionPreset = AVCaptureSessionPreset1920x1080;
    self.mProcessQueue = dispatch_queue_create("mProcessQueue", DISPATCH_QUEUE_SERIAL); // 序列佇列
    AVCaptureDevice *inputCamera = nil;
    NSArray *devices = [AVCaptureDevice devicesWithMediaType:AVMediaTypeVideo];
    for (AVCaptureDevice *device in devices) {
        if ([device position] == AVCaptureDevicePositionBack) {
            inputCamera = device;
        }
    }
    self.mCaptureDeviceInput = [[AVCaptureDeviceInput alloc] initWithDevice:inputCamera error:nil];
    if ([self.mCaptureSession canAddInput:self.mCaptureDeviceInput]) {
        [self.mCaptureSession addInput:self.mCaptureDeviceInput];
    }
    self.mCaptureDeviceOutput = [[AVCaptureVideoDataOutput alloc] init];
    [self.mCaptureDeviceOutput setAlwaysDiscardsLateVideoFrames:NO];
    // 這裡設定格式為BGRA，而不用YUV的顏色空間，避免使用Shader轉換
    [self.mCaptureDeviceOutput setVideoSettings:[NSDictionary dictionaryWithObject:[NSNumber numberWithInt:kCVPixelFormatType_32BGRA] forKey:(id)kCVPixelBufferPixelFormatTypeKey]];
    [self.mCaptureDeviceOutput setSampleBufferDelegate:self queue:self.mProcessQueue];
    if ([self.mCaptureSession canAddOutput:self.mCaptureDeviceOutput]) {
        [self.mCaptureSession addOutput:self.mCaptureDeviceOutput];
    }
    AVCaptureConnection *connection = [self.mCaptureDeviceOutput connectionWithMediaType:AVMediaTypeVideo];
    [connection setVideoOrientation:AVCaptureVideoOrientationPortrait]; // 設定方向
    [self.mCaptureSession startRunning];
}
複製程式碼

建立AVCaptureSession、AVCaptureDeviceInput和AVCaptureVideoDataOutput，注意在建立AVCaptureVideoDataOutput時，需要指定內容格式，這裡使用的是BGRA的格式；
同時需要設定採集的方向，否則影象會出現旋轉；

3、攝像頭採集回撥
- (void)captureOutput:(AVCaptureOutput *)captureOutput didOutputSampleBuffer:(CMSampleBufferRef)sampleBuffer fromConnection:(AVCaptureConnection *)connection {
    CVPixelBufferRef pixelBuffer = CMSampleBufferGetImageBuffer(sampleBuffer);
    
    size_t width = CVPixelBufferGetWidth(pixelBuffer);
    size_t height = CVPixelBufferGetHeight(pixelBuffer);
    
    CVMetalTextureRef tmpTexture = NULL;
    // 如果MTLPixelFormatBGRA8Unorm和攝像頭採集時設定的顏色格式不一致，則會出現影象異常的情況；
    CVReturn status = CVMetalTextureCacheCreateTextureFromImage(kCFAllocatorDefault, self.textureCache, pixelBuffer, NULL, MTLPixelFormatBGRA8Unorm, width, height, 0, &tmpTexture);
    if(status == kCVReturnSuccess)
    {
        self.mtkView.drawableSize = CGSizeMake(width, height);
        self.texture = CVMetalTextureGetTexture(tmpTexture);
        CFRelease(tmpTexture);
    }
}
複製程式碼

這是demo的核心內容，攝像頭回傳CMSampleBufferRef資料，找到CVPixelBufferRef，用CVMetalTextureCacheCreateTextureFromImage建立CoreVideo的Metal紋理快取CVMetalTextureRef，最後通過CVMetalTextureGetTexture得到Metal的紋理；
這個過程與Metal入門教程（一）圖片繪製使用device newTextureWithDescriptor建立紋理，再通過texture replaceRegion的方式上傳紋理資料類似，但是效能上有提升。

4、渲染處理
- (void)drawInMTKView:(MTKView *)view {
    if (self.texture) {
        id<MTLCommandBuffer> commandBuffer = [self.commandQueue commandBuffer]; // 建立指令緩衝
        id<MTLTexture> drawingTexture = view.currentDrawable.texture; // 把MKTView作為目標紋理
        
        MPSImageGaussianBlur *filter = [[MPSImageGaussianBlur alloc] initWithDevice:self.mtkView.device sigma:1]; // 這裡的sigma值可以修改，sigma值越高影象越模糊
        [filter encodeToCommandBuffer:commandBuffer sourceTexture:self.texture destinationTexture:drawingTexture]; // 把攝像頭返回影象資料的原始資料
        
        [commandBuffer presentDrawable:view.currentDrawable]; // 展示資料
        [commandBuffer commit];
        
        self.texture = NULL;
    }
}
複製程式碼

這也是demo的核心內容，MetalPerformanceShaders是Metal的一個整合庫，有一些濾鏡處理的Metal實現，demo選用其中的高斯模糊處理MPSImageGaussianBlur；
MPSImageGaussianBlur以一個Metal紋理作為輸入，以一個Metal紋理作為輸出；
這裡的輸入是從攝像頭採集的影象，也即是第三步建立的紋理；輸出的紋理是MTKView的currentDrawable.texture；
在繪製完之後呼叫presentDrawable:展示渲染結果。

注意事項

1、執行後Crash，提示frameBufferOnly texture not supported for compute
這是因為MTKView的drawable紋理預設是隻用來展示渲染結果，只允許作為framebuffer attachments，需要設定framebufferOnly為NO；

self.mtkView.framebufferOnly = NO;
複製程式碼

2、影象顯示異常，偏綠or偏藍
如果MTLPixelFormatBGRA8Unorm和攝像頭採集時設定的顏色格式不一致，則會出現影象異常的情況，以下兩行程式碼需要設定同樣的格式：

    [self.mCaptureDeviceOutput setVideoSettings:[NSDictionary dictionaryWithObject:[NSNumber numberWithInt:kCVPixelFormatType_32BGRA] forKey:(id)kCVPixelBufferPixelFormatTypeKey]];

    CVReturn status = CVMetalTextureCacheCreateTextureFromImage(kCFAllocatorDefault, self.textureCache, pixelBuffer, NULL, MTLPixelFormatBGRA8Unorm, width, height, 0, &tmpTexture);
複製程式碼

3、影象顯示異常，倒置or旋轉
如果出現影象朝向異常的情況，可以通過下面的兩種方式進行修改：

  • 修改AVCaptureConnection的朝向：
    [connection setVideoOrientation:AVCaptureVideoOrientationPortrait];
  • 或者給MTKView增加旋轉變換：
    self.mtkView.transform = CGAffineTransformMakeRotation(M_PI / 2);

總結

本文有兩個核心點：從CVPixelBufferRef建立Metal紋理以及MetalPerformanceShaders的使用和理解，這兩個點也引入後續Metal更復雜的能力，分別是視訊渲染和自定義Shader計算。
同時從這個demo可以看到相對OpenGL，Metal對影象的處理更為方便，程式碼也更為精簡。
程式碼的地址在這裡，歡迎交流。


相關文章