| Index: content/browser/renderer_host/media/video_capture_buffer_pool.h
|
| diff --git a/content/browser/renderer_host/media/video_capture_buffer_pool.h b/content/browser/renderer_host/media/video_capture_buffer_pool.h
|
| deleted file mode 100644
|
| index 4dc59acb146831ee11b1d58bd424d8a9796bac2b..0000000000000000000000000000000000000000
|
| --- a/content/browser/renderer_host/media/video_capture_buffer_pool.h
|
| +++ /dev/null
|
| @@ -1,185 +0,0 @@
|
| -// 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 CONTENT_BROWSER_RENDERER_HOST_MEDIA_VIDEO_CAPTURE_BUFFER_POOL_H_
|
| -#define CONTENT_BROWSER_RENDERER_HOST_MEDIA_VIDEO_CAPTURE_BUFFER_POOL_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 "content/common/content_export.h"
|
| -#include "media/base/video_capture_types.h"
|
| -#include "media/base/video_frame.h"
|
| -#include "ui/gfx/geometry/size.h"
|
| -#include "ui/gfx/gpu_memory_buffer.h"
|
| -
|
| -namespace content {
|
| -
|
| -class VideoCaptureBufferHandle;
|
| -class VideoCaptureBufferTracker;
|
| -
|
| -class CONTENT_EXPORT VideoCaptureBufferPool
|
| - : public base::RefCountedThreadSafe<VideoCaptureBufferPool> {
|
| - public:
|
| - static constexpr int kInvalidId = -1;
|
| -
|
| - // One-time (per client/per-buffer) initialization to share a particular
|
| - // buffer to a process. The shared handle is returned as |new_handle|.
|
| - virtual bool ShareToProcess(int buffer_id,
|
| - base::ProcessHandle process_handle,
|
| - base::SharedMemoryHandle* new_handle) = 0;
|
| - virtual bool ShareToProcess2(int buffer_id,
|
| - int plane,
|
| - base::ProcessHandle process_handle,
|
| - gfx::GpuMemoryBufferHandle* new_handle) = 0;
|
| -
|
| - // Try and obtain a BufferHandle for |buffer_id|.
|
| - virtual std::unique_ptr<VideoCaptureBufferHandle> GetBufferHandle(
|
| - int buffer_id) = 0;
|
| -
|
| - // Reserve or allocate a buffer to support a packed frame of |dimensions| of
|
| - // pixel |format| and return its id. This will fail (returning kInvalidId) if
|
| - // the pool already is at its |count| limit of the number of allocations, and
|
| - // all allocated buffers are in use by the producer and/or consumers.
|
| - //
|
| - // If successful, the reserved buffer remains reserved (and writable by the
|
| - // producer) until ownership is transferred either to the consumer via
|
| - // HoldForConsumers(), or back to the pool with
|
| - // RelinquishProducerReservation().
|
| - //
|
| - // On occasion, this call will decide to free an old buffer to make room for a
|
| - // new allocation at a larger size. If so, the ID of the destroyed buffer is
|
| - // returned via |buffer_id_to_drop|.
|
| - virtual int ReserveForProducer(const gfx::Size& dimensions,
|
| - media::VideoPixelFormat format,
|
| - media::VideoPixelStorage storage,
|
| - int* buffer_id_to_drop) = 0;
|
| -
|
| - // Indicate that a buffer held for the producer should be returned back to the
|
| - // pool without passing on to the consumer. This effectively is the opposite
|
| - // of ReserveForProducer().
|
| - virtual void RelinquishProducerReservation(int buffer_id) = 0;
|
| -
|
| - // Attempt to reserve the same buffer that was relinquished in the last call
|
| - // to RelinquishProducerReservation(). If the buffer is not still being
|
| - // consumed, and has not yet been re-used since being consumed, and the
|
| - // specified |dimensions|, |format|, and |storage| agree with its last
|
| - // reservation, this will succeed. Otherwise, |kInvalidId| will be returned.
|
| - //
|
| - // A producer may assume the content of the buffer has been preserved and may
|
| - // also make modifications.
|
| - virtual int ResurrectLastForProducer(const gfx::Size& dimensions,
|
| - media::VideoPixelFormat format,
|
| - media::VideoPixelStorage storage) = 0;
|
| -
|
| - // Returns a snapshot of the current number of buffers in-use divided by the
|
| - // maximum |count_|.
|
| - virtual double GetBufferPoolUtilization() const = 0;
|
| -
|
| - // Transfer a buffer from producer to consumer ownership.
|
| - // |buffer_id| must be a buffer index previously returned by
|
| - // ReserveForProducer(), and not already passed to HoldForConsumers().
|
| - virtual void HoldForConsumers(int buffer_id, int num_clients) = 0;
|
| -
|
| - // Indicate that one or more consumers are done with a particular buffer. This
|
| - // effectively is the opposite of HoldForConsumers(). Once the consumers are
|
| - // done, a buffer is returned to the pool for reuse.
|
| - virtual void RelinquishConsumerHold(int buffer_id, int num_clients) = 0;
|
| -
|
| - protected:
|
| - virtual ~VideoCaptureBufferPool() {}
|
| -
|
| - private:
|
| - friend class base::RefCountedThreadSafe<VideoCaptureBufferPool>;
|
| -};
|
| -
|
| -// 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.
|
| -class CONTENT_EXPORT VideoCaptureBufferPoolImpl
|
| - : public VideoCaptureBufferPool {
|
| - public:
|
| - explicit VideoCaptureBufferPoolImpl(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_;
|
| -
|
| - DISALLOW_IMPLICIT_CONSTRUCTORS(VideoCaptureBufferPoolImpl);
|
| -};
|
| -
|
| -} // namespace content
|
| -
|
| -#endif // CONTENT_BROWSER_RENDERER_HOST_MEDIA_VIDEO_CAPTURE_BUFFER_POOL_H_
|
|
|