mirror of
https://github.com/mollyim/webrtc.git
synced 2025-05-16 15:20:42 +01:00
62238097c9
This is a safe cleanup change since top-level const applied to parameters in function declarations (that are not also definitions) are ignored by the compiler. Hence, such changes do not change the type of the declared functions and are simply no-ops. Bug: webrtc:13610 Change-Id: Ibafb92c45119a6d8bdb6f9109aa8dad6385163a9 Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/249086 Reviewed-by: Niels Moller <nisse@webrtc.org> Reviewed-by: Harald Alvestrand <hta@webrtc.org> Commit-Queue: Ali Tofigh <alito@webrtc.org> Cr-Commit-Position: refs/heads/main@{#35802}
115 lines
4.5 KiB
C++
115 lines
4.5 KiB
C++
/*
|
|
* 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_VIDEO_CAPTURE_H_
|
|
#define MODULES_VIDEO_CAPTURE_VIDEO_CAPTURE_H_
|
|
|
|
#include "api/video/video_rotation.h"
|
|
#include "api/video/video_sink_interface.h"
|
|
#include "modules/video_capture/video_capture_defines.h"
|
|
|
|
namespace webrtc {
|
|
|
|
class VideoCaptureModule : public rtc::RefCountInterface {
|
|
public:
|
|
// Interface for receiving information about available camera devices.
|
|
class DeviceInfo {
|
|
public:
|
|
virtual uint32_t NumberOfDevices() = 0;
|
|
|
|
// Returns the available capture devices.
|
|
// deviceNumber - Index of capture device.
|
|
// deviceNameUTF8 - Friendly name of the capture device.
|
|
// deviceUniqueIdUTF8 - Unique name of the capture device if it exist.
|
|
// Otherwise same as deviceNameUTF8.
|
|
// productUniqueIdUTF8 - Unique product id if it exist.
|
|
// Null terminated otherwise.
|
|
virtual int32_t GetDeviceName(uint32_t deviceNumber,
|
|
char* deviceNameUTF8,
|
|
uint32_t deviceNameLength,
|
|
char* deviceUniqueIdUTF8,
|
|
uint32_t deviceUniqueIdUTF8Length,
|
|
char* productUniqueIdUTF8 = 0,
|
|
uint32_t productUniqueIdUTF8Length = 0) = 0;
|
|
|
|
// Returns the number of capabilities this device.
|
|
virtual int32_t NumberOfCapabilities(const char* deviceUniqueIdUTF8) = 0;
|
|
|
|
// Gets the capabilities of the named device.
|
|
virtual int32_t GetCapability(const char* deviceUniqueIdUTF8,
|
|
uint32_t deviceCapabilityNumber,
|
|
VideoCaptureCapability& capability) = 0;
|
|
|
|
// Gets clockwise angle the captured frames should be rotated in order
|
|
// to be displayed correctly on a normally rotated display.
|
|
virtual int32_t GetOrientation(const char* deviceUniqueIdUTF8,
|
|
VideoRotation& orientation) = 0;
|
|
|
|
// Gets the capability that best matches the requested width, height and
|
|
// frame rate.
|
|
// Returns the deviceCapabilityNumber on success.
|
|
virtual int32_t GetBestMatchedCapability(
|
|
const char* deviceUniqueIdUTF8,
|
|
const VideoCaptureCapability& requested,
|
|
VideoCaptureCapability& resulting) = 0;
|
|
|
|
// Display OS /capture device specific settings dialog
|
|
virtual int32_t DisplayCaptureSettingsDialogBox(
|
|
const char* deviceUniqueIdUTF8,
|
|
const char* dialogTitleUTF8,
|
|
void* parentWindow,
|
|
uint32_t positionX,
|
|
uint32_t positionY) = 0;
|
|
|
|
virtual ~DeviceInfo() {}
|
|
};
|
|
|
|
// Register capture data callback
|
|
virtual void RegisterCaptureDataCallback(
|
|
rtc::VideoSinkInterface<VideoFrame>* dataCallback) = 0;
|
|
|
|
// Remove capture data callback
|
|
virtual void DeRegisterCaptureDataCallback() = 0;
|
|
|
|
// Start capture device
|
|
virtual int32_t StartCapture(const VideoCaptureCapability& capability) = 0;
|
|
|
|
virtual int32_t StopCapture() = 0;
|
|
|
|
// Returns the name of the device used by this module.
|
|
virtual const char* CurrentDeviceName() const = 0;
|
|
|
|
// Returns true if the capture device is running
|
|
virtual bool CaptureStarted() = 0;
|
|
|
|
// Gets the current configuration.
|
|
virtual int32_t CaptureSettings(VideoCaptureCapability& settings) = 0;
|
|
|
|
// Set the rotation of the captured frames.
|
|
// If the rotation is set to the same as returned by
|
|
// DeviceInfo::GetOrientation the captured frames are
|
|
// displayed correctly if rendered.
|
|
virtual int32_t SetCaptureRotation(VideoRotation rotation) = 0;
|
|
|
|
// Tells the capture module whether to apply the pending rotation. By default,
|
|
// the rotation is applied and the generated frame is up right. When set to
|
|
// false, generated frames will carry the rotation information from
|
|
// SetCaptureRotation. Return value indicates whether this operation succeeds.
|
|
virtual bool SetApplyRotation(bool enable) = 0;
|
|
|
|
// Return whether the rotation is applied or left pending.
|
|
virtual bool GetApplyRotation() = 0;
|
|
|
|
protected:
|
|
~VideoCaptureModule() override {}
|
|
};
|
|
|
|
} // namespace webrtc
|
|
#endif // MODULES_VIDEO_CAPTURE_VIDEO_CAPTURE_H_
|