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 REMOTING_CODEC_VIDEO_DECODER_H_ | 5 #ifndef REMOTING_CODEC_VIDEO_DECODER_H_ |
6 #define REMOTING_CODEC_VIDEO_DECODER_H_ | 6 #define REMOTING_CODEC_VIDEO_DECODER_H_ |
7 | 7 |
8 #include "base/basictypes.h" | 8 #include "base/basictypes.h" |
9 #include "remoting/proto/video.pb.h" | 9 #include "remoting/proto/video.pb.h" |
10 #include "third_party/skia/include/core/SkRect.h" | 10 |
11 #include "third_party/skia/include/core/SkRegion.h" | 11 namespace webrtc { |
12 #include "third_party/skia/include/core/SkSize.h" | 12 class DesktopRect; |
| 13 class DesktopRegion; |
| 14 class DesktopSize; |
| 15 } // namespace webrtc |
13 | 16 |
14 namespace remoting { | 17 namespace remoting { |
15 | 18 |
16 // Interface for a decoder that takes a stream of bytes from the network and | 19 // Interface for a decoder that takes a stream of bytes from the network and |
17 // outputs frames of data. | 20 // outputs frames of data. |
18 class VideoDecoder { | 21 class VideoDecoder { |
19 public: | 22 public: |
20 // DecodeResult is returned from DecodePacket() and indicates current state | 23 // DecodeResult is returned from DecodePacket() and indicates current state |
21 // of the decoder. DECODE_DONE means that last packet for the frame was | 24 // of the decoder. DECODE_DONE means that last packet for the frame was |
22 // processed, and the frame can be displayed now. DECODE_ERROR is returned if | 25 // processed, and the frame can be displayed now. DECODE_ERROR is returned if |
23 // there was an error in the stream. | 26 // there was an error in the stream. |
24 enum DecodeResult { | 27 enum DecodeResult { |
25 DECODE_ERROR, | 28 DECODE_ERROR, |
26 DECODE_DONE, | 29 DECODE_DONE, |
27 }; | 30 }; |
28 | 31 |
29 VideoDecoder() {} | 32 VideoDecoder() {} |
30 virtual ~VideoDecoder() {} | 33 virtual ~VideoDecoder() {} |
31 | 34 |
32 // Initializes the decoder and sets the output dimensions. | 35 // Initializes the decoder and sets the output dimensions. |
33 // |screen size| must not be empty. | 36 // |screen size| must not be empty. |
34 virtual void Initialize(const SkISize& screen_size) = 0; | 37 virtual void Initialize(const webrtc::DesktopSize& screen_size) = 0; |
35 | 38 |
36 // Feeds more data into the decoder. | 39 // Feeds more data into the decoder. |
37 virtual DecodeResult DecodePacket(const VideoPacket* packet) = 0; | 40 virtual DecodeResult DecodePacket(const VideoPacket* packet) = 0; |
38 | 41 |
39 // Returns true if decoder is ready to accept data via DecodePacket. | 42 // Returns true if decoder is ready to accept data via DecodePacket. |
40 virtual bool IsReadyForData() = 0; | 43 virtual bool IsReadyForData() = 0; |
41 | 44 |
42 virtual VideoPacketFormat::Encoding Encoding() = 0; | 45 virtual VideoPacketFormat::Encoding Encoding() = 0; |
43 | 46 |
44 // Marks the specified |region| of the view for update the next time | 47 // Marks the specified |region| of the view for update the next time |
45 // RenderFrame() is called. |region| is expressed in |view_size| coordinates. | 48 // RenderFrame() is called. |region| is expressed in |view_size| coordinates. |
46 // |view_size| must not be empty. | 49 // |view_size| must not be empty. |
47 virtual void Invalidate(const SkISize& view_size, | 50 virtual void Invalidate(const webrtc::DesktopSize& view_size, |
48 const SkRegion& region) = 0; | 51 const webrtc::DesktopRegion& region) = 0; |
49 | 52 |
50 // Copies invalidated pixels within |clip_area| to |image_buffer|. Pixels are | 53 // Copies invalidated pixels within |clip_area| to |image_buffer|. Pixels are |
51 // invalidated either by new data received in DecodePacket(), or by explicit | 54 // invalidated either by new data received in DecodePacket(), or by explicit |
52 // calls to Invalidate(). |clip_area| is specified in |view_size| coordinates. | 55 // calls to Invalidate(). |clip_area| is specified in |view_size| coordinates. |
53 // If |view_size| differs from the source size then the copied pixels will be | 56 // If |view_size| differs from the source size then the copied pixels will be |
54 // scaled accordingly. |view_size| cannot be empty. | 57 // scaled accordingly. |view_size| cannot be empty. |
55 // | 58 // |
56 // |image_buffer|'s origin must correspond to the top-left of |clip_area|, | 59 // |image_buffer|'s origin must correspond to the top-left of |clip_area|, |
57 // and the buffer must be large enough to hold |clip_area| RGBA32 pixels. | 60 // and the buffer must be large enough to hold |clip_area| RGBA32 pixels. |
58 // |image_stride| gives the output buffer's stride in pixels. | 61 // |image_stride| gives the output buffer's stride in pixels. |
59 // | 62 // |
60 // On return, |output_region| contains the updated area, in |view_size| | 63 // On return, |output_region| contains the updated area, in |view_size| |
61 // coordinates. | 64 // coordinates. |
62 virtual void RenderFrame(const SkISize& view_size, | 65 virtual void RenderFrame(const webrtc::DesktopSize& view_size, |
63 const SkIRect& clip_area, | 66 const webrtc::DesktopRect& clip_area, |
64 uint8* image_buffer, | 67 uint8* image_buffer, |
65 int image_stride, | 68 int image_stride, |
66 SkRegion* output_region) = 0; | 69 webrtc::DesktopRegion* output_region) = 0; |
67 | 70 |
68 // Returns the "shape", if any, of the most recently rendered frame. | 71 // Returns the "shape", if any, of the most recently rendered frame. |
69 // The shape is returned in source dimensions. | 72 // The shape is returned in source dimensions. |
70 virtual const SkRegion* GetImageShape() = 0; | 73 virtual const webrtc::DesktopRegion* GetImageShape() = 0; |
71 }; | 74 }; |
72 | 75 |
73 } // namespace remoting | 76 } // namespace remoting |
74 | 77 |
75 #endif // REMOTING_CODEC_VIDEO_DECODER_H_ | 78 #endif // REMOTING_CODEC_VIDEO_DECODER_H_ |
OLD | NEW |