AVCaptureStillImageOutput.CaptureStillImageBracket Method

Definition

Captures an image bracket from an inpute device.

[Foundation.Export("captureStillImageBracketAsynchronouslyFromConnection:withSettingsArray:completionHandler:")]
[ObjCRuntime.Introduced(ObjCRuntime.PlatformName.iOS, 8, 0, ObjCRuntime.PlatformArchitecture.All, null)]
public virtual void CaptureStillImageBracket (AVFoundation.AVCaptureConnection connection, AVFoundation.AVCaptureBracketedStillImageSettings[] settings, Action<CoreMedia.CMSampleBuffer,AVFoundation.AVCaptureBracketedStillImageSettings,Foundation.NSError> imageHandler);
abstract member CaptureStillImageBracket : AVFoundation.AVCaptureConnection * AVFoundation.AVCaptureBracketedStillImageSettings[] * Action<CoreMedia.CMSampleBuffer, AVFoundation.AVCaptureBracketedStillImageSettings, Foundation.NSError> -> unit
override this.CaptureStillImageBracket : AVFoundation.AVCaptureConnection * AVFoundation.AVCaptureBracketedStillImageSettings[] * Action<CoreMedia.CMSampleBuffer, AVFoundation.AVCaptureBracketedStillImageSettings, Foundation.NSError> -> unit

Parameters

connection
AVCaptureConnection

The connection source for the image.

settings
AVCaptureBracketedStillImageSettings[]

Array of settings.   This value should not exceed the MaxBracketedCaptureStillImageCount property.

imageHandler
Action<CMSampleBuffer,AVCaptureBracketedStillImageSettings,NSError>

Method to invoke for each image that has been captured.   

It receives both the CMSampleBuffer with the image data, the settings for this particular image being captured as well as the error (if any) for the captured image.   

The error parameter will be null on success, otherwise it will contain an NSError with the details.

Attributes

Remarks

This method will capture a series of images, one for each item in the settings array and provide these to the provided imageHandler callback.

You should invoke PrepareToCaptureStillImageBracket(AVCaptureConnection, AVCaptureBracketedStillImageSettings[], Action<Boolean,NSError>) in advance to allocate the resources needed, otherwise there might be a delay when this method is invoked.

There are no guarantees about which thread will be used to post the message to your imageHandler.

Applies to