Chromium Code Reviews| 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 |