Instance Property

videoOrientation

Indicates whether to rotate the video flowing through the connection to a given orientation.

Declaration

@property(nonatomic) AVCaptureVideoOrientation videoOrientation;

Discussion

This property is only applicable to connections involving video.

If the value of supportsVideoOrientation is YES, you can set videoOrientation to rotate the video buffers consumed by the connection’s output. Setting videoOrientation doesn’t necessarily result in a physical rotation of video buffers. For example, a video connection to an AVCaptureMovieFileOutput object handles orientation using a QuickTime track matrix. A video connection to an AVCaptureStillImageOutput object handles orientation using Exif tags.

AVCaptureVideoDataOutput clients may receive physically rotated pixel buffers in their captureOutput:didOutputSampleBuffer:fromConnection: delegate callback. The AVCaptureVideoDataOutput hardware accelerates the rotation operation and supports all four AVCaptureVideoOrientation modes. A client sets videoOrientation or videoMirrored on the video data output’s video AVCaptureConnection to request physical buffer rotation.

See Also

Managing Video Configuration

supportsVideoOrientation

A Boolean value that indicates whether the connection supports changing the orientation of the video.

AVCaptureVideoOrientation

Constants indicating video orientation.

videoFieldMode

An indicator of how interlaced video flowing through the connection should be treated

supportsVideoFieldMode

A Boolean value that indicates whether the connection supports setting the videoFieldMode property.

videoMinFrameDuration

The minimum time interval between which the receiver should output consecutive video frames.

supportsVideoMinFrameDuration

A Boolean value that indicates whether the connection supports setting the videoMinFrameDuration property.

videoMaxFrameDuration

The maximum time interval between which the receiver should output consecutive video frames.

supportsVideoMaxFrameDuration

A Boolean value that indicates whether the connection supports setting the videoMaxFrameDuration property.

videoScaleAndCropFactor

The current video scale and crop factor in use by the receiver.

videoMaxScaleAndCropFactor

The maximum video scale and crop factor by the connection.