Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(211)

Unified Diff: media/capture/video/video_capture_buffer_pool_impl.h

Issue 2361173002: Move classses VideoCaptureDeviceClient and VideoCaptureBufferPool to media/capture/video (Closed)
Patch Set: Created 4 years, 3 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
Index: media/capture/video/video_capture_buffer_pool_impl.h
diff --git a/media/capture/video/video_capture_buffer_pool_impl.h b/media/capture/video/video_capture_buffer_pool_impl.h
new file mode 100644
index 0000000000000000000000000000000000000000..e9ac1e96ac8c007ca378ce04c3d7a21b743f7487
--- /dev/null
+++ b/media/capture/video/video_capture_buffer_pool_impl.h
@@ -0,0 +1,114 @@
+// Copyright (c) 2013 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_VIDEO_CAPTURE_VIDEO_CAPTURE_BUFFER_POOL_IMPL_H_
+#define MEDIA_VIDEO_CAPTURE_VIDEO_CAPTURE_BUFFER_POOL_IMPL_H_
+
+#include <stddef.h>
+
+#include <map>
+
+#include "base/files/file.h"
+#include "base/macros.h"
+#include "base/memory/ref_counted.h"
+#include "base/memory/shared_memory.h"
+#include "base/process/process.h"
+#include "base/synchronization/lock.h"
+#include "build/build_config.h"
+#include "media/base/video_capture_types.h"
+#include "media/base/video_frame.h"
+#include "media/capture/capture_export.h"
+#include "media/capture/video/video_capture_buffer_handle.h"
+#include "media/capture/video/video_capture_buffer_pool.h"
+#include "media/capture/video/video_capture_buffer_tracker_factory.h"
+#include "ui/gfx/geometry/size.h"
+#include "ui/gfx/gpu_memory_buffer.h"
+
+namespace media {
+
+// A thread-safe class that does the bookkeeping and lifetime management for a
+// pool of pixel buffers cycled between an in-process producer (e.g. a
+// VideoCaptureDevice) and a set of out-of-process consumers. The pool is
+// intended to be orchestrated by a VideoCaptureDevice::Client, but is designed
+// to outlive the controller if necessary. The pixel buffers may be backed by a
+// SharedMemory, but this is not compulsory.
+//
+// Producers get a buffer by calling ReserveForProducer(), and may pass on their
+// ownership to the consumer by calling HoldForConsumers(), or drop the buffer
+// (without further processing) by calling RelinquishProducerReservation().
+// Consumers signal that they are done with the buffer by calling
+// RelinquishConsumerHold().
+//
+// Buffers are allocated on demand, but there will never be more than |count|
+// buffers in existence at any time. Buffers are identified by an int value
+// called |buffer_id|. -1 (kInvalidId) is never a valid ID, and is returned by
+// some methods to indicate failure. The active set of buffer ids may change
+// over the lifetime of the buffer pool, as existing buffers are freed and
+// reallocated at larger size. When reallocation occurs, new buffer IDs will
+// circulate.
mcasas 2016/09/22 21:41:58 I think these class-comments should go in VideoCa
chfremer 2016/09/22 23:41:52 Done.
+class CAPTURE_EXPORT VideoCaptureBufferPoolImpl
+ : public VideoCaptureBufferPool {
+ public:
+ explicit VideoCaptureBufferPoolImpl(
+ std::unique_ptr<VideoCaptureBufferTrackerFactory> buffer_tracker_factory,
+ int count);
+
+ // Implementation of VideoCaptureBufferPool interface:
+ bool ShareToProcess(int buffer_id,
+ base::ProcessHandle process_handle,
+ base::SharedMemoryHandle* new_handle) override;
+ bool ShareToProcess2(int buffer_id,
+ int plane,
+ base::ProcessHandle process_handle,
+ gfx::GpuMemoryBufferHandle* new_handle) override;
+ std::unique_ptr<VideoCaptureBufferHandle> GetBufferHandle(
+ int buffer_id) override;
+ int ReserveForProducer(const gfx::Size& dimensions,
+ media::VideoPixelFormat format,
+ media::VideoPixelStorage storage,
+ int* buffer_id_to_drop) override;
+ void RelinquishProducerReservation(int buffer_id) override;
+ int ResurrectLastForProducer(const gfx::Size& dimensions,
+ media::VideoPixelFormat format,
+ media::VideoPixelStorage storage) override;
+ double GetBufferPoolUtilization() const override;
+ void HoldForConsumers(int buffer_id, int num_clients) override;
+ void RelinquishConsumerHold(int buffer_id, int num_clients) override;
+
+ private:
+ friend class base::RefCountedThreadSafe<VideoCaptureBufferPoolImpl>;
+ ~VideoCaptureBufferPoolImpl() override;
+
+ int ReserveForProducerInternal(const gfx::Size& dimensions,
+ media::VideoPixelFormat format,
+ media::VideoPixelStorage storage,
+ int* tracker_id_to_drop);
+
+ VideoCaptureBufferTracker* GetTracker(int buffer_id);
+
+ // The max number of buffers that the pool is allowed to have at any moment.
+ const int count_;
+
+ // Protects everything below it.
+ mutable base::Lock lock_;
+
+ // The ID of the next buffer.
+ int next_buffer_id_;
+
+ // The ID of the buffer last relinquished by the producer (a candidate for
+ // resurrection).
+ int last_relinquished_buffer_id_;
+
+ // The buffers, indexed by the first parameter, a buffer id.
+ using TrackerMap = std::map<int, VideoCaptureBufferTracker*>;
+ TrackerMap trackers_;
+
+ std::unique_ptr<VideoCaptureBufferTrackerFactory> buffer_tracker_factory_;
mcasas 2016/09/22 21:41:58 nit: Probably can be made const.
chfremer 2016/09/22 23:41:52 Done.
+
+ DISALLOW_IMPLICIT_CONSTRUCTORS(VideoCaptureBufferPoolImpl);
+};
+
+} // namespace media
+
+#endif // MEDIA_VIDEO_CAPTURE_VIDEO_CAPTURE_BUFFER_POOL_IMPL_H_

Powered by Google App Engine
This is Rietveld 408576698