Index: media/capture/thread_safe_capture_oracle.h |
diff --git a/media/capture/thread_safe_capture_oracle.h b/media/capture/thread_safe_capture_oracle.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..d15a18d3c603f23b41a7c4a315950f01412488f5 |
--- /dev/null |
+++ b/media/capture/thread_safe_capture_oracle.h |
@@ -0,0 +1,105 @@ |
+// Copyright 2014 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 MEDIA_CAPTURE_THREAD_SAFE_CAPTURE_ORACLE_H_ |
+#define MEDIA_CAPTURE_THREAD_SAFE_CAPTURE_ORACLE_H_ |
+ |
+#include <string> |
+ |
+#include "base/memory/ref_counted.h" |
+#include "base/memory/scoped_ptr.h" |
+#include "media/base/media_export.h" |
+#include "media/base/video_frame.h" |
+#include "media/capture/capture_resolution_chooser.h" |
+#include "media/capture/video_capture_oracle.h" |
+#include "media/video/capture/video_capture_device.h" |
+ |
+namespace media { |
+ |
+class VideoCaptureParams; |
+class VideoFrame; |
+ |
+// Thread-safe, refcounted proxy to the VideoCaptureOracle. This proxy wraps |
+// the VideoCaptureOracle, which decides which frames to capture, and a |
+// VideoCaptureDevice::Client, which allocates and receives the captured |
+// frames, in a lock to synchronize state between the two. |
+class MEDIA_EXPORT ThreadSafeCaptureOracle |
+ : public base::RefCountedThreadSafe<ThreadSafeCaptureOracle> { |
+ public: |
+ ThreadSafeCaptureOracle(scoped_ptr<VideoCaptureDevice::Client> client, |
+ const VideoCaptureParams& params); |
+ |
+ // Called when a captured frame is available or an error has occurred. |
+ // If |success| is true then |frame| is valid and |timestamp| indicates when |
+ // the frame was painted. |
+ // If |success| is false, all other parameters are invalid. |
+ typedef base::Callback<void(const scoped_refptr<VideoFrame>& frame, |
+ base::TimeTicks timestamp, |
+ bool success)> CaptureFrameCallback; |
+ |
+ bool ObserveEventAndDecideCapture(VideoCaptureOracle::Event event, |
+ const gfx::Rect& damage_rect, |
+ base::TimeTicks event_time, |
+ scoped_refptr<VideoFrame>* storage, |
+ CaptureFrameCallback* callback); |
+ |
+ base::TimeDelta min_capture_period() const { |
+ return oracle_.min_capture_period(); |
+ } |
+ |
+ gfx::Size max_frame_size() const { |
+ return params_.requested_format.frame_size; |
+ } |
+ |
+ // Returns the current capture resolution. |
+ gfx::Size GetCaptureSize() const; |
+ |
+ // Updates capture resolution based on the supplied source size and the |
+ // maximum frame size. |
+ void UpdateCaptureSize(const gfx::Size& source_size); |
+ |
+ // Stop new captures from happening (but doesn't forget the client). |
+ void Stop(); |
+ |
+ // Signal an error to the client. |
+ void ReportError(const std::string& reason); |
+ |
+ private: |
+ friend class base::RefCountedThreadSafe<ThreadSafeCaptureOracle>; |
+ virtual ~ThreadSafeCaptureOracle(); |
+ |
+ // Callback invoked on completion of all captures. |
+ void DidCaptureFrame( |
+ int frame_number, |
+ scoped_ptr<VideoCaptureDevice::Client::Buffer> buffer, |
+ base::TimeTicks capture_begin_time, |
+ base::TimeDelta estimated_frame_duration, |
+ const scoped_refptr<VideoFrame>& frame, |
+ base::TimeTicks timestamp, |
+ bool success); |
+ |
+ // Callback invoked once all consumers have finished with a delivered video |
+ // frame. Consumer feedback signals are scanned from the frame's |metadata|. |
+ void DidConsumeFrame(int frame_number, |
+ const media::VideoFrameMetadata* metadata); |
+ |
+ // Protects everything below it. |
+ mutable base::Lock lock_; |
+ |
+ // Recipient of our capture activity. |
+ scoped_ptr<VideoCaptureDevice::Client> client_; |
+ |
+ // Makes the decision to capture a frame. |
+ VideoCaptureOracle oracle_; |
+ |
+ // The video capture parameters used to construct the oracle proxy. |
+ const VideoCaptureParams params_; |
+ |
+ // Determines video capture frame sizes. |
+ CaptureResolutionChooser resolution_chooser_; |
+}; |
+ |
+} // namespace media |
+ |
+#endif // MEDIA_CAPTURE_THREAD_SAFE_CAPTURE_ORACLE_H_ |