OLD | NEW |
1 // Copyright 2013 The Chromium Authors. All rights reserved. | 1 // Copyright 2013 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef MEDIA_BASE_VIDEO_FRAME_POOL_H_ | 5 #ifndef MEDIA_BASE_VIDEO_FRAME_POOL_H_ |
6 #define MEDIA_BASE_VIDEO_FRAME_POOL_H_ | 6 #define MEDIA_BASE_VIDEO_FRAME_POOL_H_ |
7 | 7 |
8 #include "media/base/media_export.h" | 8 #include "media/base/media_export.h" |
9 #include "media/base/video_frame.h" | 9 #include "media/base/video_frame.h" |
10 | 10 |
11 namespace media { | 11 namespace media { |
12 | 12 |
13 // Simple VideoFrame pool used to avoid unnecessarily allocating and destroying | 13 // Simple VideoFrame pool used to avoid unnecessarily allocating and destroying |
14 // VideoFrame objects. The pool manages the memory for the VideoFrame | 14 // VideoFrame objects. The pool manages the memory for the VideoFrame |
15 // returned by CreateFrame(). When one of these VideoFrames is destroyed, | 15 // returned by CreateFrame(). When one of these VideoFrames is destroyed, |
16 // the memory is returned to the pool for use by a subsequent CreateFrame() | 16 // the memory is returned to the pool for use by a subsequent CreateFrame() |
17 // call. The memory in the pool is retained for the life of the | 17 // call. The memory in the pool is retained for the life of the |
18 // VideoFramePool object. If the parameters passed to CreateFrame() change | 18 // VideoFramePool object. If the parameters passed to CreateFrame() change |
19 // during the life of this object, then the memory used by frames with the old | 19 // during the life of this object, then the memory used by frames with the old |
20 // parameter values will be purged from the pool. | 20 // parameter values will be purged from the pool. |
21 class MEDIA_EXPORT VideoFramePool { | 21 class MEDIA_EXPORT VideoFramePool { |
22 public: | 22 public: |
23 VideoFramePool(); | 23 VideoFramePool(); |
24 ~VideoFramePool(); | 24 ~VideoFramePool(); |
25 | 25 |
26 // Returns a frame from the pool that matches the specified | 26 // Returns a frame from the pool that matches the specified |
27 // parameters or creates a new frame if no suitable frame exists in | 27 // parameters or creates a new frame if no suitable frame exists in |
28 // the pool. | 28 // the pool. The pool is drained if no matching frame is found. |
| 29 // The buffer for the new frame will be zero initialized. Reused frames will |
| 30 // not be zero initialized. |
29 scoped_refptr<VideoFrame> CreateFrame(VideoPixelFormat format, | 31 scoped_refptr<VideoFrame> CreateFrame(VideoPixelFormat format, |
30 const gfx::Size& coded_size, | 32 const gfx::Size& coded_size, |
31 const gfx::Rect& visible_rect, | 33 const gfx::Rect& visible_rect, |
32 const gfx::Size& natural_size, | 34 const gfx::Size& natural_size, |
33 base::TimeDelta timestamp); | 35 base::TimeDelta timestamp); |
34 | 36 |
35 protected: | 37 protected: |
36 friend class VideoFramePoolTest; | 38 friend class VideoFramePoolTest; |
37 | 39 |
38 // Returns the number of frames in the pool for testing purposes. | 40 // Returns the number of frames in the pool for testing purposes. |
39 size_t GetPoolSizeForTesting() const; | 41 size_t GetPoolSizeForTesting() const; |
40 | 42 |
41 private: | 43 private: |
42 class PoolImpl; | 44 class PoolImpl; |
43 scoped_refptr<PoolImpl> pool_; | 45 scoped_refptr<PoolImpl> pool_; |
44 | 46 |
45 DISALLOW_COPY_AND_ASSIGN(VideoFramePool); | 47 DISALLOW_COPY_AND_ASSIGN(VideoFramePool); |
46 }; | 48 }; |
47 | 49 |
48 } // namespace media | 50 } // namespace media |
49 | 51 |
50 #endif // MEDIA_BASE_VIDEO_FRAME_POOL_H_ | 52 #endif // MEDIA_BASE_VIDEO_FRAME_POOL_H_ |
OLD | NEW |