AVCaptureStillImageOutput

AVCaptureStillImageOutput бетон sub класс AVCaptureOutput то, что Вы используете для получения высококачественного неподвижного изображения с сопроводительными метаданными.

В iOS 8.0 и более поздней поддержке неподвижного изображения было добавлено получение на кронштейнах. «Скобка неподвижного изображения» является пакетом изображений, взятых как можно быстрее по очереди, дополнительно с различными настройками от изображения до изображения.

В получении на кронштейнах, AVCaptureDevice экземпляр flashMode свойство проигнорировано (флэш-память вызывается прочь), как automaticallyEnablesStillImageStabilizationWhenAvailable свойство (стабилизация вызывается прочь).

Наследование

NSObject
AVCaptureOutput
AVCaptureStillImageOutput

NSObject
AVCaptureOutput
AVCaptureStillImageOutput

Соответствует

AnyObject
CVarArgType
Equatable
Hashable
NSObjectProtocol
Печатаемый
NSObject

Оператор импорта

Swift

import AVFoundation

Objective C

@import AVFoundation;

Доступность

Доступный в OS X v10.7 и позже.

Получение изображения


    
    captureStillImageAsynchronouslyFromConnection (_: completionHandler:)
    - captureStillImageAsynchronouslyFromConnection:completionHandler:

Сразу инициирует получение неподвижного изображения и возвраты.

Объявление

Swift

func captureStillImageAsynchronouslyFromConnection(_ connection: AVCaptureConnection!, completionHandler handler: ((CMSampleBuffer!, NSError!) -> Void)!)

Objective C

- (void)captureStillImageAsynchronouslyFromConnection:(AVCaptureConnection *)connection completionHandler:(void (^)(CMSampleBufferRef imageDataSampleBuffer, NSError *error))handler

Параметры


      connection

Соединение, от которого можно получить изображение.


      handler

Блок для вызова после изображения был получен. Блочные параметры следующие:


      imageDataSampleBuffer

Полученные данные.

Буферные присоединения могут содержать метаданные, надлежащие формату данных изображения. Например, буфер, содержащий данные JPEG, может перенести a kCGImagePropertyExifDictionary как присоединение. См. ImageIO/CGImageProperties.h для списка ключей и оцените типы.


      error

Если запрос не мог бы быть завершен, NSError объект, описывающий проблему; иначе nil.

Обсуждение

Этот метод сразу возвращается после того, как он вызывается, позже вызвав предоставленный блок обработчика завершения, когда данные изображения готовы. Если запрос не мог бы быть завершен, параметр ошибок будет содержать NSError объект, описывающий отказ.

Вы не должны предполагать, что обработчик завершения вызовут на определенном потоке.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.7 и позже.

capturingStillImage capturingStillImage Свойство

Указывает, получается ли неподвижное изображение. (только для чтения)

Объявление

Swift

var capturingStillImage: Bool { get }

Objective C

@property(readonly, getter=isCapturingStillImage) BOOL capturingStillImage

Обсуждение

Значение этого свойства YEStrue когда неподвижное изображение получается, и NOfalse когда никакое получение неподвижного изображения не в стадии реализации.

Это свойство поддерживает наблюдение значения ключа.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.8 и позже.

Конфигурирование настроек изображения

outputSettings outputSettings Свойство

Настройки сжатия для вывода.

Объявление

Swift

var outputSettings: [NSObject : AnyObject]!

Objective C

@property(nonatomic, copy) NSDictionary *outputSettings

Обсуждение

Использовать availableImageDataCVPixelFormatTypes и availableImageDataCodecTypes определить, какие ключи кодека и форматы пикселя поддерживаются.

На iOS в настоящее время единственные поддерживаемые ключи AVVideoCodecKey и kCVPixelBufferPixelFormatTypeKey. Ключи являются взаимоисключающими, только один может присутствовать. Рекомендуемые значения kCMVideoCodecType_JPEG для AVVideoCodecKey и kCVPixelFormatType_420YpCbCr8BiPlanarFullRange и kCVPixelFormatType_32BGRA для kCVPixelBufferPixelFormatTypeKey.

На iOS 6.0 и позже AVVideoQualityKey поддерживается и может только использоваться когда AVVideoCodecKey установлен в AVVideoCodecJPEG.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.7 и позже.
availableImageDataCVPixelFormatTypes availableImageDataCVPixelFormatTypes Свойство

Поддерживаемые форматы пикселя изображения, которые могут быть указаны как выходные настройки. (только для чтения)

Объявление

Swift

var availableImageDataCVPixelFormatTypes: [AnyObject]! { get }

Objective C

@property(nonatomic, readonly) NSArray *availableImageDataCVPixelFormatTypes

Обсуждение

Значение этого свойства является массивом NSNumber объекты, которые можно использовать в качестве значений для kCVPixelBufferPixelFormatTypeKey в outputSettings свойство.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.7 и позже.
availableImageDataCodecTypes availableImageDataCodecTypes Свойство

Поддерживаемые форматы кодека изображения, которые могут быть указаны как выходные настройки. (только для чтения)

Объявление

Swift

var availableImageDataCodecTypes: [AnyObject]! { get }

Objective C

@property(nonatomic, readonly) NSArray *availableImageDataCodecTypes

Обсуждение

Значение этого свойства является массивом NSString объекты, которые можно использовать в качестве значений для AVVideoCodecKey в outputSettings свойство.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.7 и позже.

Преобразование формата изображения


    
    jpegStillImageNSDataRepresentation (_:)
    + jpegStillImageNSDataRepresentation:

Возвраты NSData представление данных неподвижного изображения и присоединений метаданных в демонстрационном буфере JPEG.

Объявление

Swift

class func jpegStillImageNSDataRepresentation(_ jpegSampleBuffer: CMSampleBuffer!) -> NSData!

Objective C

+ (NSData *)jpegStillImageNSDataRepresentation:(CMSampleBufferRef)jpegSampleBuffer

Параметры


      jpegSampleBuffer

Демонстрационные буферные данные изображения JPEG переноса, дополнительно с выборкой метаданных Exif буферизуют присоединения.

Этот метод бросает NSInvalidArgumentException если jpegSampleBuffer NULL или не в формате JPEG.

Возвращаемое значение

NSData представление jpegSampleBuffer.

Обсуждение

Этот метод объединяет данные изображения и демонстрационные буферные присоединения метаданных Exif, не повторно сжимая изображение.

Возвращенный NSData объект подходит для записи в диск.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.7 и позже.