RTCVideoFrame is an ObjectiveC version of webrtc::VideoFrame, but it currently contains some extra logic beyond that. We want RTCVideoFrame to be as simple as possible, i.e. just a container with no extra state, so we can use it as input to RTCVideoSource without complicating the interface for consumers. BUG=webrtc:7177 NOTRY=True Review-Url: https://codereview.webrtc.org/2695203004 Cr-Commit-Position: refs/heads/master@{#16740}
62 lines
1.9 KiB
Objective-C
62 lines
1.9 KiB
Objective-C
/*
|
|
* Copyright 2015 The WebRTC project authors. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license
|
|
* that can be found in the LICENSE file in the root of the source
|
|
* tree. An additional intellectual property rights grant can be found
|
|
* in the file PATENTS. All contributing project authors may
|
|
* be found in the AUTHORS file in the root of the source tree.
|
|
*/
|
|
|
|
#import <AVFoundation/AVFoundation.h>
|
|
#import <Foundation/Foundation.h>
|
|
|
|
#import <WebRTC/RTCMacros.h>
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
typedef NS_ENUM(NSInteger, RTCVideoRotation) {
|
|
RTCVideoRotation_0 = 0,
|
|
RTCVideoRotation_90 = 90,
|
|
RTCVideoRotation_180 = 180,
|
|
RTCVideoRotation_270 = 270,
|
|
};
|
|
|
|
// RTCVideoFrame is an ObjectiveC version of webrtc::VideoFrame.
|
|
RTC_EXPORT
|
|
@interface RTCVideoFrame : NSObject
|
|
|
|
/** Width without rotation applied. */
|
|
@property(nonatomic, readonly) int width;
|
|
|
|
/** Height without rotation applied. */
|
|
@property(nonatomic, readonly) int height;
|
|
@property(nonatomic, readonly) RTCVideoRotation rotation;
|
|
/** Accessing YUV data should only be done for I420 frames, i.e. if nativeHandle
|
|
* is null. It is always possible to get such a frame by calling
|
|
* newI420VideoFrame.
|
|
*/
|
|
@property(nonatomic, readonly, nullable) const uint8_t *dataY;
|
|
@property(nonatomic, readonly, nullable) const uint8_t *dataU;
|
|
@property(nonatomic, readonly, nullable) const uint8_t *dataV;
|
|
@property(nonatomic, readonly) int strideY;
|
|
@property(nonatomic, readonly) int strideU;
|
|
@property(nonatomic, readonly) int strideV;
|
|
|
|
/** Timestamp in nanoseconds. */
|
|
@property(nonatomic, readonly) int64_t timeStampNs;
|
|
|
|
/** The native handle should be a pixel buffer on iOS. */
|
|
@property(nonatomic, readonly) CVPixelBufferRef nativeHandle;
|
|
|
|
- (instancetype)init NS_UNAVAILABLE;
|
|
|
|
/** Return a frame that is guaranteed to be I420, i.e. it is possible to access
|
|
* the YUV data on it.
|
|
*/
|
|
- (RTCVideoFrame *)newI420VideoFrame;
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|