OLD | NEW |
---|---|
(Empty) | |
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | |
2 // Use of this source code is governed by a BSD-style license that can be | |
3 // found in the LICENSE file. | |
4 | |
5 #ifndef CC_VIDEO_FRAME_PROVIDER_H_ | |
6 #define CC_VIDEO_FRAME_PROVIDER_H_ | |
7 | |
8 #include "base/memory/ref_counted.h" | |
9 | |
10 namespace media { | |
11 class VideoFrame; | |
12 } | |
13 | |
14 namespace cc { | |
15 | |
16 // Threading notes: This class may be used in a multi threaded manner. | |
17 // Specifically, the implementation may call getCurrentFrame() or | |
18 // putCurrentFrame() from the compositor thread. If so, the caller is | |
19 // responsible for making sure Client::didReceiveFrame and | |
20 // Client::didUpdateMatrix are only called from this same thread. | |
21 class VideoFrameProvider { | |
22 public: | |
23 virtual ~VideoFrameProvider() {} | |
24 | |
25 class Client { | |
26 public: | |
27 // Provider will call this method to tell the client to stop using it. | |
28 // StopUsingProvider() may be called from any thread. The client should | |
29 // block until it has PutCurrentFrame() any outstanding frames. | |
30 virtual void StopUsingProvider() = 0; | |
31 | |
32 // Notifies the provider's client that a call to GetCurrentFrame() will | |
33 // return new data. | |
34 virtual void DidReceiveFrame() = 0; | |
35 | |
36 // Notifies the provider's client of a new UV transform matrix to be used. | |
37 virtual void DidUpdateMatrix(const float*) = 0; | |
38 }; | |
39 | |
40 // May be called from any thread, but there must be some external guarantee | |
41 // that the provider is not destroyed before this call returns. | |
42 virtual void SetVideoFrameProviderClient(Client*) = 0; | |
43 | |
44 // This function places a lock on the current frame and returns a pointer to | |
45 // it. Calls to this method should always be followed with a call to | |
46 // PutCurrentFrame(). | |
47 // Only the current provider client should call this function. | |
48 virtual scoped_refptr<media::VideoFrame> GetCurrentFrame() = 0; | |
49 // This function releases the lock on the video frame. It should always be | |
jamesr
2013/01/03 23:35:55
nit: newline above this to separate the previous f
danakj
2013/01/04 14:01:29
Done.
| |
50 // called after GetCurrentFrame(). Frames passed into this method | |
51 // should no longer be referenced after the call is made. Only the current | |
52 // provider client should call this function. | |
53 virtual void PutCurrentFrame(scoped_refptr<media::VideoFrame>) = 0; | |
54 }; | |
55 | |
56 } // namespace cc | |
57 | |
58 #endif // CC_VIDEO_FRAME_PROVIDER_H_ | |
OLD | NEW |