OLD | NEW |
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 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 | 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_VIDEO_VIDEO_DECODE_ACCELERATOR_H_ | 5 #ifndef MEDIA_VIDEO_VIDEO_DECODE_ACCELERATOR_H_ |
6 #define MEDIA_VIDEO_VIDEO_DECODE_ACCELERATOR_H_ | 6 #define MEDIA_VIDEO_VIDEO_DECODE_ACCELERATOR_H_ |
7 | 7 |
8 #include <stdint.h> | 8 #include <stdint.h> |
9 | 9 |
10 #include <memory> | 10 #include <memory> |
11 #include <vector> | 11 #include <vector> |
12 | 12 |
13 #include "base/memory/ref_counted.h" | |
14 #include "base/memory/weak_ptr.h" | |
15 #include "media/base/bitstream_buffer.h" | 13 #include "media/base/bitstream_buffer.h" |
16 #include "media/base/surface_manager.h" | 14 #include "media/base/surface_manager.h" |
17 #include "media/base/video_decoder_config.h" | 15 #include "media/base/video_decoder_config.h" |
18 #include "media/video/picture.h" | 16 #include "media/video/picture.h" |
19 #include "ui/gfx/geometry/size.h" | 17 #include "ui/gfx/geometry/size.h" |
| 18 #include "ui/gl/gl_image.h" |
20 | 19 |
21 typedef unsigned int GLenum; | 20 typedef unsigned int GLenum; |
22 | 21 |
23 namespace base { | |
24 class SingleThreadTaskRunner; | |
25 } | |
26 | |
27 namespace media { | 22 namespace media { |
28 | 23 |
29 // Video decoder interface. | 24 // Video decoder interface. |
30 // This interface is extended by the various components that ultimately | 25 // This interface is extended by the various components that ultimately |
31 // implement the backend of PPB_VideoDecoder_Dev. | 26 // implement the backend of PPB_VideoDecoder_Dev. |
32 class MEDIA_EXPORT VideoDecodeAccelerator { | 27 class MEDIA_EXPORT VideoDecodeAccelerator { |
33 public: | 28 public: |
34 // Specification of a decoding profile supported by an decoder. | 29 // Specification of a decoding profile supported by an decoder. |
35 // |max_resolution| and |min_resolution| are inclusive. | 30 // |max_resolution| and |min_resolution| are inclusive. |
36 struct MEDIA_EXPORT SupportedProfile { | 31 struct MEDIA_EXPORT SupportedProfile { |
37 SupportedProfile(); | 32 SupportedProfile(); |
38 ~SupportedProfile(); | 33 ~SupportedProfile(); |
39 VideoCodecProfile profile; | 34 VideoCodecProfile profile; |
40 gfx::Size max_resolution; | 35 gfx::Size max_resolution; |
41 gfx::Size min_resolution; | 36 gfx::Size min_resolution; |
42 bool encrypted_only; | 37 bool encrypted_only; |
43 }; | 38 }; |
44 using SupportedProfiles = std::vector<SupportedProfile>; | 39 using SupportedProfiles = std::vector<SupportedProfile>; |
45 | 40 |
| 41 using MakeContextCurrentCallback = base::Callback<bool(void)>; |
| 42 using BindImageCallback = base::Callback< |
| 43 void(uint32_t, uint32_t, scoped_refptr<gl::GLImage>, bool)>; |
| 44 |
46 struct MEDIA_EXPORT Capabilities { | 45 struct MEDIA_EXPORT Capabilities { |
47 Capabilities(); | 46 Capabilities(); |
48 Capabilities(const Capabilities& other); | 47 Capabilities(const Capabilities& other); |
49 ~Capabilities(); | 48 ~Capabilities(); |
50 | 49 |
51 std::string AsHumanReadableString() const; | 50 std::string AsHumanReadableString() const; |
52 | 51 |
53 // Flags that can be associated with a VDA. | 52 // Flags that can be associated with a VDA. |
54 enum Flags { | 53 enum Flags { |
55 NO_FLAGS = 0, | 54 NO_FLAGS = 0, |
(...skipping 167 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
223 // "seek". | 222 // "seek". |
224 virtual void Reset() = 0; | 223 virtual void Reset() = 0; |
225 | 224 |
226 // Destroys the decoder: all pending inputs are dropped immediately and the | 225 // Destroys the decoder: all pending inputs are dropped immediately and the |
227 // component is freed. This call may asynchornously free system resources, | 226 // component is freed. This call may asynchornously free system resources, |
228 // but its client-visible effects are synchronous. After this method returns | 227 // but its client-visible effects are synchronous. After this method returns |
229 // no more callbacks will be made on the client. Deletes |this| | 228 // no more callbacks will be made on the client. Deletes |this| |
230 // unconditionally, so make sure to drop all pointers to it! | 229 // unconditionally, so make sure to drop all pointers to it! |
231 virtual void Destroy() = 0; | 230 virtual void Destroy() = 0; |
232 | 231 |
233 // TO BE CALLED IN THE SAME PROCESS AS THE VDA IMPLEMENTATION ONLY. | 232 // GPU PROCESS ONLY. Implementations of this interface in the |
234 // | 233 // content/common/gpu/media should implement this, and implementations in |
235 // A decode "task" is a sequence that includes a Decode() call from Client, | 234 // other processes should not override the default implementation. |
236 // as well as corresponding callbacks to return the input BitstreamBuffer | 235 // Returns true if VDA::Decode and VDA::Client callbacks can run on the IO |
237 // after use, and the resulting output Picture(s). | 236 // thread. Otherwise they will run on the GPU child thread. The purpose of |
238 // | 237 // running Decode on the IO thread is to reduce decode latency. Note Decode |
239 // If the Client can support running these three calls on a separate thread, | 238 // should return as soon as possible and not block on the IO thread. Also, |
240 // it may call this method to try to set up the VDA implementation to do so. | 239 // PictureReady should be run on the child thread if a picture is delivered |
241 // If the VDA can support this as well, return true, otherwise return false. | 240 // the first time so it can be cleared. |
242 // If true is returned, the client may submit each Decode() call (but no other | 241 virtual bool CanDecodeOnIOThread(); |
243 // calls) on |decode_task_runner|, and should then expect that | |
244 // NotifyEndOfBitstreamBuffer() and PictureReady() callbacks may come on | |
245 // |decode_task_runner| as well, called on |decode_client|, instead of client | |
246 // provided to Initialize(). | |
247 // | |
248 // This method may be called at any time. | |
249 // | |
250 // NOTE 1: some callbacks may still have to come on the main thread and the | |
251 // Client should handle both callbacks coming on main and |decode_task_runner| | |
252 // thread. | |
253 // | |
254 // NOTE 2: VDA implementations of Decode() must return as soon as possible and | |
255 // never block, as |decode_task_runner| may be a latency critical thread | |
256 // (such as the GPU IO thread). | |
257 // | |
258 // One application of this is offloading the GPU Child thread. In general, | |
259 // calls to VDA in GPU process have to be done on the GPU Child thread, as | |
260 // they may require GL context to be current. However, some VDAs may be able | |
261 // to run decode operations without GL context, which helps reduce latency and | |
262 // offloads the GPU Child thread. | |
263 virtual bool TryToSetupDecodeOnSeparateThread( | |
264 const base::WeakPtr<Client>& decode_client, | |
265 const scoped_refptr<base::SingleThreadTaskRunner>& decode_task_runner); | |
266 | 242 |
267 // Windows creates a BGRA texture. | 243 // Windows creates a BGRA texture. |
268 // TODO(dshwang): after moving to D3D11, remove this. crbug.com/438691 | 244 // TODO(dshwang): after moving to D3D11, remove this. crbug.com/438691 |
269 virtual GLenum GetSurfaceInternalFormat() const; | 245 virtual GLenum GetSurfaceInternalFormat() const; |
270 | 246 |
271 protected: | 247 protected: |
272 // Do not delete directly; use Destroy() or own it with a scoped_ptr, which | 248 // Do not delete directly; use Destroy() or own it with a scoped_ptr, which |
273 // will Destroy() it properly by default. | 249 // will Destroy() it properly by default. |
274 virtual ~VideoDecodeAccelerator(); | 250 virtual ~VideoDecodeAccelerator(); |
275 }; | 251 }; |
276 | 252 |
277 } // namespace media | 253 } // namespace media |
278 | 254 |
279 namespace std { | 255 namespace std { |
280 | 256 |
281 // Specialize std::default_delete so that scoped_ptr<VideoDecodeAccelerator> | 257 // Specialize std::default_delete so that scoped_ptr<VideoDecodeAccelerator> |
282 // uses "Destroy()" instead of trying to use the destructor. | 258 // uses "Destroy()" instead of trying to use the destructor. |
283 template <> | 259 template <> |
284 struct MEDIA_EXPORT default_delete<media::VideoDecodeAccelerator> { | 260 struct MEDIA_EXPORT default_delete<media::VideoDecodeAccelerator> { |
285 void operator()(media::VideoDecodeAccelerator* vda) const; | 261 void operator()(media::VideoDecodeAccelerator* vda) const; |
286 }; | 262 }; |
287 | 263 |
288 } // namespace std | 264 } // namespace std |
289 | 265 |
290 #endif // MEDIA_VIDEO_VIDEO_DECODE_ACCELERATOR_H_ | 266 #endif // MEDIA_VIDEO_VIDEO_DECODE_ACCELERATOR_H_ |
OLD | NEW |