remoting/client/plugin/pepper_video_renderer.h

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef REMOTING_CLIENT_PLUGIN_PEPPER_VIDEO_RENDERER_H_
   6 #define REMOTING_CLIENT_PLUGIN_PEPPER_VIDEO_RENDERER_H_
   7
   8 #include "remoting/client/video_renderer.h"
   9
  10 namespace webrtc {
  11 class DesktopSize;
  12 class DesktopVector;
  13 class DesktopRegion;
  14 }  // namespace webrtc
  15
  16 namespace pp {
  17 class Instance;
  18 class View;
  19 }  // namespace pp
  20
  21 namespace remoting {
  22
  23 class ClientContext;
  24
  25 // Interface for video renderers that render video in pepper plugin.
  26 class PepperVideoRenderer : public VideoRenderer {
  27  public:
  28   class EventHandler {
  29    public:
  30     EventHandler() {}
  31     virtual ~EventHandler() {}
  32
  33     // Called if video decoding fails, for any reason.
  34     virtual void OnVideoDecodeError() = 0;
  35
  36     // Called when the first frame is received.
  37     virtual void OnVideoFirstFrameReceived() = 0;
  38
  39     // Called when stream size changes.
  40     virtual void OnVideoSize(const webrtc::DesktopSize& size,
  41                              const webrtc::DesktopVector& dpi) = 0;
  42
  43     // Called when desktop shape changes. |shape| should be NULL if frames are
  44     // un-shaped.
  45     virtual void OnVideoShape(const webrtc::DesktopRegion* shape) = 0;
  46
  47     // Called with each frame's updated region, if EnableDebugDirtyRegion(true)
  48     // was called.
  49     virtual void OnVideoFrameDirtyRegion(
  50         const webrtc::DesktopRegion& dirty_region) = 0;
  51   };
  52
  53   // Initializes the renderer. |instance| and |event_handler| must outlive the
  54   // renderer. Returns false if the renderer cannot be initialized.
  55   virtual bool Initialize(pp::Instance* instance,
  56                           const ClientContext& context,
  57                           EventHandler* event_handler) = 0;
  58
  59   // Must be called whenever the plugin view changes.
  60   virtual void OnViewChanged(const pp::View& view) = 0;
  61
  62   // Enables or disables delivery of dirty region information to the
  63   // EventHandler, for debugging purposes.
  64   virtual void EnableDebugDirtyRegion(bool enable) = 0;
  65 };
  66
  67 }  // namespace remoting
  68
  69 #endif  // REMOTING_CLIENT_PLUGIN_PEPPER_VIDEO_RENDERER_H_