Ссылка класса AVCaptureStillImageOutput

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


    
    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

Доступность

Доступный в iOS 4.0 и позже.

capturingStillImage Свойство

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

Объявление

Swift

var capturingStillImage: Bool { get }

Objective C

@property(readonly, getter=isCapturingStillImage) BOOL capturingStillImage

Обсуждение

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

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

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 5.0 и позже.

Получение и установка настроек стабилизации изображения

stillImageStabilizationActive Свойство

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

Объявление

Swift

var stillImageStabilizationActive: Bool { get }

Objective C

@property(nonatomic, readonly, getter=isStillImageStabilizationActive) BOOL stillImageStabilizationActive

Обсуждение

Возвраты свойства YEStrue если видео стабилизация используется в настоящее время; иначе NOfalse.

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

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 7.0 и позже.
automaticallyEnablesStillImageStabilizationWhenAvailable Свойство

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

Объявление

Swift

var automaticallyEnablesStillImageStabilizationWhenAvailable: Bool

Objective C

@property(nonatomic) BOOL automaticallyEnablesStillImageStabilizationWhenAvailable

Обсуждение

Если stillImageStabilizationSupported возвраты YEStrue, стабилизация изображения может быть применена для сокращения размытости, обычно находимой при слабом освещении фотографии. Когда стабилизация включена, получения неподвижного изображения подвергаются дополнительной задержке.

Значение по умолчанию YEStrue когда поддерживается устройством ввода данных; иначе NOfalse.

Установка этого свойства выдает исключение (NSInvalidArgumentException) если stillImageStabilizationSupported возвраты NOfalse.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 7.0 и позже.
stillImageStabilizationSupported Свойство

Булево значение, указывающее ли неподвижное изображение, в настоящее время будучи полученным стабилизация неподвижного изображения поддержек. (только для чтения)

Объявление

Swift

var stillImageStabilizationSupported: Bool { get }

Objective C

@property(nonatomic, readonly, getter=isStillImageStabilizationSupported) BOOL stillImageStabilizationSupported

Обсуждение

automaticallyEnablesStillImageStabilizationWhenAvailable если это свойство возвращается, свойство может только быть установлено YEStrue.

Значение может измениться как сеанс sessionPreset или устройство ввода данных activeFormat изменения.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 7.0 и позже.

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

highResolutionStillImageOutputEnabled Свойство

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

Объявление

Swift

var highResolutionStillImageOutputEnabled: Bool

Objective C

@property(nonatomic, getter=isHighResolutionStillImageOutputEnabled) BOOL highResolutionStillImageOutputEnabled

Обсуждение

По умолчанию, AVCaptureStillImageOutput испускает изображения с теми же размерностями как его источник AVCaptureDevice экземпляр activeFormat.formatDescription. Однако, если Вы устанавливаете это свойство в YEStrue, получатель испускает неподвижные изображения в устройстве захвата изображения highResolutionStillImageDimensions значение.

Примечание:

Если Вы включаете видео стабилизацию путем установки preferredVideoStabilizationMode к YEStrue для любого вывода, неподвижные изображения высокого разрешения, испускаемые AVCaptureStillImageOutput может быть меньшим на 10% или больше.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 8.0 и позже.
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

Доступность

Доступный в iOS 4.0 и позже.
availableImageDataCVPixelFormatTypes Свойство

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

Объявление

Swift

var availableImageDataCVPixelFormatTypes: [AnyObject]! { get }

Objective C

@property(nonatomic, readonly) NSArray *availableImageDataCVPixelFormatTypes

Обсуждение

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

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.
availableImageDataCodecTypes Свойство

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

Объявление

Swift

var availableImageDataCodecTypes: [AnyObject]! { get }

Objective C

@property(nonatomic, readonly) NSArray *availableImageDataCodecTypes

Обсуждение

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

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 4.0 и позже.

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


    
    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

Доступность

Доступный в iOS 4.0 и позже.

Неподвижное изображение получение на кронштейнах


    
    captureStillImageBracketAsynchronouslyFromConnection (_: withSettingsArray:completionHandler:)
    - captureStillImageBracketAsynchronouslyFromConnection:withSettingsArray:completionHandler:

Получает скобку неподвижного изображения.

Объявление

Swift

func captureStillImageBracketAsynchronouslyFromConnection(_ connection: AVCaptureConnection!, withSettingsArray settings: [AnyObject]!, completionHandler handler: ((CMSampleBuffer!, AVCaptureBracketedStillImageSettings!, NSError!) -> Void)!)

Objective C

- (void)captureStillImageBracketAsynchronouslyFromConnection:(AVCaptureConnection *)connection withSettingsArray:(NSArray *)settings completionHandler:(void (^)(CMSampleBufferRef sampleBuffer, AVCaptureBracketedStillImageSettings *stillImageSettings, NSError *error))handler

Параметры


      connection

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


      settings

Массив AVCaptureBracketedStillImageSettings объекты. Все элементы массива должны иметь то же AVCaptureBracketedStillImageSettings подкласс, или NSInvalidArgumentException исключение выдается.


      handler

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

Блок имеет три параметра:

`sampleBuffer`	Если запрос получения успешен, содержит допустимый CMSampleBuffer.
`stillImageSettings`	Содержит `AVCaptureBracketedStillImageSettings` объект, соответствующий этому неподвижному изображению.
`error`	Если получение на кронштейнах перестало работать, `sampleBuffer` `NULL` и ошибка не -`nil`.

Если количество settings параметр превышает maxBracketedCaptureStillImageCount, тогда AVErrorMaximumStillImageCaptureRequestsExceeded возвращается.

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

Обсуждение

Если Вы не вызвали prepareToCaptureStillImageBracketFromConnection:withSettingsArray:completionHandler: для этого запроса скобки неподвижного изображения скобка не может быть сразу взята, поскольку получатель, возможно, внутренне должен подготовить ресурсы.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 8.0 и позже.

См. также

– captureStillImageAsynchronouslyFromConnection:completionHandler:
– prepareToCaptureStillImageBracketFromConnection:withSettingsArray:completionHandler:
maxBracketedCaptureStillImageCount

maxBracketedCaptureStillImageCount Свойство

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

Объявление

Swift

var maxBracketedCaptureStillImageCount: Int { get }

Objective C

@property(nonatomic, readonly) NSUInteger maxBracketedCaptureStillImageCount

Обсуждение

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

Максимальное количество неподвижных изображений, которые могут быть взяты в одиночной скобке, зависит от размера изображений, получаемых, и следовательно может меняться в зависимости от AVCaptureSession-sessionPreset и значений AVCaptureDevice-activeFormat.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 8.0 и позже.

См. также

– captureStillImageAsynchronouslyFromConnection:completionHandler:
– captureStillImageBracketAsynchronouslyFromConnection:withSettingsArray:completionHandler:
– prepareToCaptureStillImageBracketFromConnection:withSettingsArray:completionHandler:


    
    prepareToCaptureStillImageBracketFromConnection (_: withSettingsArray:completionHandler:)
    - prepareToCaptureStillImageBracketFromConnection:withSettingsArray:completionHandler:

Позволяет получателю подготавливать ресурсы перед получением скобки неподвижного изображения.

Объявление

Swift

func prepareToCaptureStillImageBracketFromConnection(_ connection: AVCaptureConnection!, withSettingsArray settings: [AnyObject]!, completionHandler handler: ((Bool, NSError!) -> Void)!)

Objective C

- (void)prepareToCaptureStillImageBracketFromConnection:(AVCaptureConnection *)connection withSettingsArray:(NSArray *)settings completionHandler:(void (^)(BOOL prepared, NSError *error))handler

Параметры


      connection

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


      settings

Массив AVCaptureBracketedStillImageSettings объекты. Все элементы массива должны иметь то же AVCaptureBracketedStillImageSettings подкласс, или NSInvalidArgumentException исключение выдается.


      handler

Пользователь обеспечил блок, который вызовут асинхронно, как только ресурсы были успешно выделены для указанной работы получения на кронштейнах.

Блок имеет два параметра:

`prepared`	Если достаточные ресурсы не могли бы быть выделены, этот параметр `NOfalse`, и `error` параметр содержит не -`nil` ошибочное значение.
`error`	Значение не -`nil` если встречаются с ошибкой.

Если количество settings параметр превышает maxBracketedCaptureStillImageCount, тогда AVErrorMaximumStillImageCaptureRequestsExceeded возвращается.

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

Обсуждение

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

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в iOS 8.0 и позже.

См. также

– captureStillImageAsynchronouslyFromConnection:completionHandler:
– captureStillImageBracketAsynchronouslyFromConnection:withSettingsArray:completionHandler:
maxBracketedCaptureStillImageCount