diff options
Diffstat (limited to 'third_party/libwebrtc/modules/video_capture/video_capture_impl.h')
-rw-r--r-- | third_party/libwebrtc/modules/video_capture/video_capture_impl.h | 137 |
1 files changed, 137 insertions, 0 deletions
diff --git a/third_party/libwebrtc/modules/video_capture/video_capture_impl.h b/third_party/libwebrtc/modules/video_capture/video_capture_impl.h new file mode 100644 index 0000000000..dcc93fd3a0 --- /dev/null +++ b/third_party/libwebrtc/modules/video_capture/video_capture_impl.h @@ -0,0 +1,137 @@ +/* + * Copyright (c) 2012 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. + */ + +#ifndef MODULES_VIDEO_CAPTURE_MAIN_SOURCE_VIDEO_CAPTURE_IMPL_H_ +#define MODULES_VIDEO_CAPTURE_MAIN_SOURCE_VIDEO_CAPTURE_IMPL_H_ + +/* + * video_capture_impl.h + */ + +#include <stddef.h> +#include <stdint.h> + +#include "api/scoped_refptr.h" +#include "api/sequence_checker.h" +#include "api/video/video_frame.h" +#include "api/video/video_rotation.h" +#include "api/video/video_sink_interface.h" +#include "modules/video_capture/video_capture.h" +#include "modules/video_capture/video_capture_config.h" +#include "modules/video_capture/video_capture_defines.h" +#include "rtc_base/race_checker.h" +#include "rtc_base/synchronization/mutex.h" +#include "rtc_base/system/rtc_export.h" + +namespace webrtc { + +class VideoCaptureOptions; + +namespace videocapturemodule { +// Class definitions +class RTC_EXPORT VideoCaptureImpl : public VideoCaptureModule { + public: + /* + * Create a video capture module object + * + * id - unique identifier of this video capture module object + * deviceUniqueIdUTF8 - name of the device. Available names can be found by + * using GetDeviceName + */ + static rtc::scoped_refptr<VideoCaptureModule> Create( + const char* deviceUniqueIdUTF8); + static rtc::scoped_refptr<VideoCaptureModule> Create( + VideoCaptureOptions* options, + const char* deviceUniqueIdUTF8); + + static DeviceInfo* CreateDeviceInfo(); + static DeviceInfo* CreateDeviceInfo(VideoCaptureOptions* options); + + // Helpers for converting between (integral) degrees and + // VideoRotation values. Return 0 on success. + static int32_t RotationFromDegrees(int degrees, VideoRotation* rotation); + static int32_t RotationInDegrees(VideoRotation rotation, int* degrees); + + // Call backs + void RegisterCaptureDataCallback( + rtc::VideoSinkInterface<VideoFrame>* dataCallback) override; + virtual void RegisterCaptureDataCallback( + RawVideoSinkInterface* dataCallback) override; + void DeRegisterCaptureDataCallback( + rtc::VideoSinkInterface<VideoFrame>* dataCallback) override; + + int32_t StopCaptureIfAllClientsClose() override; + int32_t SetCaptureRotation(VideoRotation rotation) override; + bool SetApplyRotation(bool enable) override; + bool GetApplyRotation() override; + + const char* CurrentDeviceName() const override; + + // `capture_time` must be specified in NTP time format in milliseconds. + int32_t IncomingFrame(uint8_t* videoFrame, + size_t videoFrameLength, + const VideoCaptureCapability& frameInfo, + int64_t captureTime = 0); + + // Platform dependent + int32_t StartCapture(const VideoCaptureCapability& capability) override; + int32_t StopCapture() override; + bool CaptureStarted() override; + int32_t CaptureSettings(VideoCaptureCapability& /*settings*/) override; + + protected: + VideoCaptureImpl(); + ~VideoCaptureImpl() override; + + // Calls to the public API must happen on a single thread. + SequenceChecker api_checker_; + // RaceChecker for members that can be accessed on the API thread while + // capture is not happening, and on a callback thread otherwise. + rtc::RaceChecker capture_checker_; + // current Device unique name; + char* _deviceUniqueId RTC_GUARDED_BY(api_checker_); + + // moved DeliverCapturedFrame to protected for VideoCaptureAndroid (mjf) + int32_t DeliverCapturedFrame(VideoFrame& captureFrame) + RTC_EXCLUSIVE_LOCKS_REQUIRED(api_lock_); + Mutex api_lock_; + // Should be set by platform dependent code in StartCapture. + VideoCaptureCapability _requestedCapability RTC_GUARDED_BY(api_checker_); + + private: + void UpdateFrameCount(); + uint32_t CalculateFrameRate(int64_t now_ns); + void DeliverRawFrame(uint8_t* videoFrame, + size_t videoFrameLength, + const VideoCaptureCapability& frameInfo, + int64_t captureTime) + RTC_EXCLUSIVE_LOCKS_REQUIRED(api_lock_); + + // last time the module process function was called. + int64_t _lastProcessTimeNanos RTC_GUARDED_BY(capture_checker_); + // last time the frame rate callback function was called. + int64_t _lastFrameRateCallbackTimeNanos RTC_GUARDED_BY(capture_checker_); + + std::set<rtc::VideoSinkInterface<VideoFrame>*> _dataCallBacks RTC_GUARDED_BY(api_lock_); + RawVideoSinkInterface* _rawDataCallBack RTC_GUARDED_BY(api_lock_); + + int64_t _lastProcessFrameTimeNanos RTC_GUARDED_BY(capture_checker_); + // timestamp for local captured frames + int64_t _incomingFrameTimesNanos[kFrameRateCountHistorySize] RTC_GUARDED_BY( + capture_checker_); + // Set if the frame should be rotated by the capture module. + VideoRotation _rotateFrame RTC_GUARDED_BY(api_lock_); + + // Indicate whether rotation should be applied before delivered externally. + bool apply_rotation_ RTC_GUARDED_BY(api_lock_); +}; +} // namespace videocapturemodule +} // namespace webrtc +#endif // MODULES_VIDEO_CAPTURE_MAIN_SOURCE_VIDEO_CAPTURE_IMPL_H_ |