cropping_window_capturer.h

Enable keyboard shortcuts

/*

 *  Copyright (c) 2014 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_DESKTOP_CAPTURE_CROPPING_WINDOW_CAPTURER_H_

#define MODULES_DESKTOP_CAPTURE_CROPPING_WINDOW_CAPTURER_H_

#include <memory>

#include "modules/desktop_capture/desktop_capture_options.h"

#include "modules/desktop_capture/desktop_capture_types.h"

#include "modules/desktop_capture/desktop_capturer.h"

#include "modules/desktop_capture/desktop_frame.h"

#include "modules/desktop_capture/desktop_geometry.h"

#include "modules/desktop_capture/shared_memory.h"

#include "rtc_base/system/rtc_export.h"

namespace webrtc {

// WindowCapturer implementation that uses a screen capturer to capture the

// whole screen and crops the video frame to the window area when the captured

// window is on top.

class RTC_EXPORT CroppingWindowCapturer : public DesktopCapturer,

                                          public DesktopCapturer::Callback {

 public:

  static std::unique_ptr<DesktopCapturer> CreateCapturer(

      const DesktopCaptureOptions& options);

  ~CroppingWindowCapturer() override;

  // DesktopCapturer implementation.

  void Start(DesktopCapturer::Callback* callback) override;

  void SetSharedMemoryFactory(

      std::unique_ptr<SharedMemoryFactory> shared_memory_factory) override;

  void CaptureFrame() override;

  void SetExcludedWindow(WindowId window) override;

  bool GetSourceList(SourceList* sources) override;

  bool SelectSource(SourceId id) override;

  bool FocusOnSelectedSource() override;

  bool IsOccluded(const DesktopVector& pos) override;

  // DesktopCapturer::Callback implementation, passed to `screen_capturer_` to

  // intercept the capture result.

  void OnCaptureResult(DesktopCapturer::Result result,

                       std::unique_ptr<DesktopFrame> frame) override;

 protected:

  explicit CroppingWindowCapturer(const DesktopCaptureOptions& options);

  // The platform implementation should override these methods.

  // Returns true if it is OK to capture the whole screen and crop to the

  // selected window, i.e. the selected window is opaque, rectangular, and not

  // occluded.

  virtual bool ShouldUseScreenCapturer() = 0;

  // Returns the window area relative to the top left of the virtual screen

  // within the bounds of the virtual screen. This function should return the

  // DesktopRect in full desktop coordinates, i.e. the top-left monitor starts

  // from (0, 0).

  virtual DesktopRect GetWindowRectInVirtualScreen() = 0;

  WindowId selected_window() const { return selected_window_; }

  WindowId excluded_window() const { return excluded_window_; }

  DesktopCapturer* window_capturer() const { return window_capturer_.get(); }

 private:

  DesktopCaptureOptions options_;

  DesktopCapturer::Callback* callback_;

  std::unique_ptr<DesktopCapturer> window_capturer_;

  std::unique_ptr<DesktopCapturer> screen_capturer_;

  SourceId selected_window_;

  WindowId excluded_window_;

};

}  // namespace webrtc

#endif  // MODULES_DESKTOP_CAPTURE_CROPPING_WINDOW_CAPTURER_H_