OTVideoFrame Class Reference

Inherits from NSObject
Declared in OTVideoKit.h

Overview

Defines a frame of a video. See [OTVideoRender renderVideoFrame:] and [OTVideoCaptureConsumer consumeFrame:].

Properties of OTVideoFrame objects

  planes

An array of planes in the video frame.

@property (nonatomic, strong) NSPointerArray *planes

Declared In

OTVideoKit.h

  timestamp

A timestap of the video frame.

@property (nonatomic, assign) CMTime timestamp

Declared In

OTVideoKit.h

  orientation

The orientation of the video frame.

@property (nonatomic, assign) OTVideoOrientation orientation

Declared In

OTVideoKit.h

  format

The format of the video frame.

@property (nonatomic, strong) OTVideoFormat *format

Declared In

OTVideoKit.h

  metadata

The metadata associated with this video frame, if any.

@property (nonatomic, readonly) NSData *metadata

Declared In

OTVideoKit.h

Instantiating OTVideoFrame objects

– init

Initializes an OTVideoFrame object.

- (nonnull id)init

Declared In

OTVideoKit.h

– initWithFormat:

Initializes an OTVideoFrame object with a specified format.

- (nonnull id)initWithFormat:(nonnull OTVideoFormat *)videoFormat

Parameters

videoFormat

The video format used by the video frame.

Declared In

OTVideoKit.h

– setPlanesWithPointers:numPlanes:

Sets planes for the video frame.

- (void)setPlanesWithPointers:(uint8_t *_Nonnull [ _Nonnull ])planes numPlanes:(int)numPlanes

Parameters

planes

The planes to assign.

numPlanes

The number of planes to assign.

Declared In

OTVideoKit.h

– clearPlanes

Cleans the planes in the video frame.

- (void)clearPlanes

Declared In

OTVideoKit.h

– convertInPlace:planes:strides:

Converts video frame without allocating new planes.

- (void)convertInPlace:(OTPixelFormat)pixelFormat planes:(uint8_t *_Nonnull *_Nonnull)planes strides:(int *_Nonnull)strides

Declared In

OTVideoKit.h

– getPlaneBinaryData:

Gets the binary data for the individual video frame.

- (uint8_t *_Nonnull)getPlaneBinaryData:(int)plane

Parameters

plane

The planes to assign.

Declared In

OTVideoKit.h

– getPlaneStride:

Gets the stride value for the plane

- (int)getPlaneStride:(int)plane

Parameters

plane

The planes to assign.

Declared In

OTVideoKit.h

– setMetadata:error:

Sets the metadata associated with this video frame.

- (void)setMetadata:(nonnull NSData *)data error:(out OTError *_Nullable *_Nullable)error

Parameters

data

The metadata to assign.

error

If the size of the metadata passed is bigger than 32 bytes this value is set to an OTError object with the code property set to OTNullOrInvalidParameter.

Declared In

OTVideoKit.h