1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
|
// Copyright (c) 2010 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef REMOTING_HOST_CAPTURER_H_
#define REMOTING_HOST_CAPTURER_H_
#include "base/basictypes.h"
#include "base/callback.h"
#include "base/synchronization/lock.h"
#include "base/task.h"
#include "remoting/base/capture_data.h"
#include "remoting/base/types.h"
class MessageLoop;
namespace remoting {
// A class to perform the task of capturing the image of a window.
// The capture action is asynchronous to allow maximum throughput.
//
// The full capture process is as follows:
//
// (1) InvalidateRects
// This is an optional step where regions of the screen are marked as
// invalid. Some platforms (Windows, for now) won't use this and will
// instead calculate the diff-regions later (in step (2). Other
// platforms (Mac) will use this to mark all the changed regions of the
// screen. Some limited rect-merging (e.g., to eliminate exact
// duplicates) may be done here.
//
// (2) CaptureInvalidRects
// This is where the bits for the invalid rects are packaged up and sent
// to the encoder.
// A screen capture is performed if needed. For example, Windows requires
// a capture to calculate the diff from the previous screen, whereas the
// Mac version does not.
//
// Implementation has to ensure the following guarantees:
// 1. Double buffering
// Since data can be read while another capture action is happening.
class Capturer {
public:
// CaptureCompletedCallback is called when the capturer has completed.
typedef Callback1<scoped_refptr<CaptureData> >::Type CaptureCompletedCallback;
virtual ~Capturer();
// Create platform-specific cpaturer.
static Capturer* Create(MessageLoop* message_loop);
// Called when the screen configuration is changed.
virtual void ScreenConfigurationChanged() = 0;
// Return the pixel format of the screen.
virtual media::VideoFrame::Format pixel_format() const;
// Clear out the list of invalid rects.
void ClearInvalidRects();
// Invalidate the specified screen rects.
void InvalidateRects(const InvalidRects& inval_rects);
// Invalidate the entire screen, of a given size.
void InvalidateScreen(const gfx::Size& size);
// Invalidate the entire screen, using the size of the most recently
// captured screen.
virtual void InvalidateFullScreen();
// Capture the screen data associated with each of the accumulated
// rects in |inval_rects|.
// This routine will first call CalculateInvalidRects to update the
// list of |inval_rects|.
// When the capture is complete, |callback| is called.
//
// If |inval_rects_| is empty, then this does nothing except
// call the |callback| routine.
//
// It is OK to call this method while another thread is reading
// data of the last capture.
// There can be at most one concurrent read going on when this
// method is called.
virtual void CaptureInvalidRects(CaptureCompletedCallback* callback);
// Get the size of the most recently captured screen.
const gfx::Size& size_most_recent() const { return size_most_recent_; }
protected:
explicit Capturer(MessageLoop* message_loop);
// Update the list of |invalid_rects| to prepare for capturing the
// screen data.
// Depending on the platform implementation, this routine might:
// (a) Analyze screen and calculate the list of rects that have changed
// since the last capture.
// (b) Merge already-acculumated rects into a more optimal list (for
// example, by combining or removing rects).
virtual void CalculateInvalidRects() = 0;
// Capture the specified screen rects and call |callback| when complete.
// Dirty or invalid regions are ignored and only the given |rects| areas are
// captured.
// This routine is used internally by CaptureInvalidRects().
virtual void CaptureRects(const InvalidRects& rects,
CaptureCompletedCallback* callback) = 0;
// Finish/cleanup capture task.
// This should be called by CaptureRects() when it finishes.
// This routine should (at least):
// (1) Call the |callback| routine.
// (2) Select the next screen buffer.
// Note that capturers are required to be double-buffered so that we can
// read from one which capturing into another.
void FinishCapture(scoped_refptr<CaptureData> data,
CaptureCompletedCallback* callback);
// Called by subclasses' CalculateInvalidRects() method to check if
// InvalidateFullScreen() was called by user.
bool IsCaptureFullScreen(int width, int height);
// Number of screen buffers.
static const int kNumBuffers = 2;
// Format of pixels returned in buffer.
media::VideoFrame::Format pixel_format_;
// The current buffer with valid data for reading.
int current_buffer_;
// Message loop that operations should run on.
MessageLoop* message_loop_;
private:
// Rects that have been manually invalidated (through InvalidateRect).
// These will be returned as dirty_rects in the capture data during the next
// capture.
InvalidRects inval_rects_;
// A lock protecting |inval_rects_| across threads.
base::Lock inval_rects_lock_;
// The size of the most recently captured screen.
gfx::Size size_most_recent_;
};
} // namespace remoting
#endif // REMOTING_HOST_CAPTURER_H_
|