AVCaptureOutput Class Reference

Inherits from
Conforms to
Framework
/System/Library/Frameworks/AVFoundation.framework
Availability
Available in OS X v10.7 and later.
Declared in
AVCaptureOutput.h
Related sample code

Overview

AVCaptureOutput is an abstract base-class describing an output destination of an AVCaptureSession object.

AVCaptureOutput provides an abstract interface for connecting capture output destinations, such as files and video previews, to an capture session (an instance of AVCaptureSession). A capture output can have multiple connections represented by AVCaptureConnection objects, one for each stream of media that it receives from a capture input (an instance of AVCaptureInput). A capture output does not have any connections when it is first created. When you add an output to a capture session, connections are created that map media data from that session’s inputs to its outputs.

You can add concrete AVCaptureOutput instances to an capture session using addOutput:.

Tasks

Accessing Connections

Properties

connections

The capture output object’s connections. (read-only)

@property(nonatomic, readonly) NSArray *connections
Discussion

The value of this property is an array of AVCaptureConnection objects, each describing the mapping between the receiver and the capture input ports (see AVCaptureInputPort) of one or more capture inputs (see AVCaptureInput).

Availability
  • Available in OS X v10.7 and later.
Declared In
AVCaptureOutput.h

Instance Methods

connectionWithMediaType:

Returns the first connection in the connections array with an input port of a specified media type.

- (AVCaptureConnection *)connectionWithMediaType:(NSString *)mediaType
Parameters
mediaType

An AVMediaType constant from AVMediaFormat.h, for example, AVMediaTypeVideo.

Return Value

The first capture connection in the connections array that has an AVCaptureInputPort with media type mediaType, or nil if no connection with the specified media type is found.

Availability
  • Available in OS X v10.7 and later.
Related Sample Code
Declared In
AVCaptureOutput.h