OLD | NEW |
1 // Copyright 2015 The Chromium Authors. All rights reserved. | 1 // Copyright 2015 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_CAST_SENDER_SENDER_ENCODED_FRAME_H_ | 5 #ifndef MEDIA_CAST_SENDER_SENDER_ENCODED_FRAME_H_ |
6 #define MEDIA_CAST_SENDER_SENDER_ENCODED_FRAME_H_ | 6 #define MEDIA_CAST_SENDER_SENDER_ENCODED_FRAME_H_ |
7 | 7 |
8 #include "base/time/time.h" | 8 #include "base/time/time.h" |
9 #include "media/cast/net/cast_transport_config.h" | 9 #include "media/cast/net/cast_transport_config.h" |
10 | 10 |
11 namespace media { | 11 namespace media { |
12 namespace cast { | 12 namespace cast { |
13 | 13 |
14 // Extends EncodedFrame with additional fields used within the sender-side of | 14 // Extends EncodedFrame with additional fields used within the sender-side of |
15 // the library. | 15 // the library. |
16 struct SenderEncodedFrame : public EncodedFrame { | 16 struct SenderEncodedFrame : public EncodedFrame { |
17 SenderEncodedFrame(); | 17 SenderEncodedFrame(); |
18 ~SenderEncodedFrame() final; | 18 ~SenderEncodedFrame() final; |
19 | 19 |
20 // The amount of real-world time it took to encode the frame, divided by the | 20 // The amount the encoder was utilized for this frame. Example: For the |
21 // maximum amount of time allowed. Example: For the software VP8 encoder, | 21 // software VP8 encoder, this would be the elapsed encode time (according to |
22 // this would be the elapsed encode time (according to the base::TimeTicks | 22 // the base::TimeTicks clock) divided by the VideoFrame's duration. |
23 // clock) divided by the VideoFrame's duration. | |
24 // | 23 // |
25 // Meaningful values are non-negative, with 0.0 [impossibly] representing 0% | 24 // Meaningful values are non-negative, with 0.0 [impossibly] representing 0% |
26 // utilization, 1.0 representing 100% utilization, and values greater than 1.0 | 25 // utilization, 1.0 representing 100% utilization, and values greater than 1.0 |
27 // indicating the encode time took longer than the media duration of the | 26 // indicating the encoder utilized more resources than a maximum sustainable |
28 // frame. Negative values indicate the field was not computed. | 27 // rate, based on the data volume of the input. Negative values indicate the |
29 // | 28 // field was not computed. |
30 // TODO(miu): Rename to encoder_cpu_utilization. | 29 double encoder_utilization; |
31 double deadline_utilization; | |
32 | 30 |
33 // The amount of "lossiness" needed to encode the frame within the targeted | 31 // The amount of "lossiness" needed to encode the frame within the targeted |
34 // bandwidth. More-complex frame content and/or lower target encode bitrates | 32 // bandwidth. More-complex frame content and/or lower target encode bitrates |
35 // will cause this value to rise. | 33 // will cause this value to rise. |
36 // | 34 // |
37 // Meaningful values are non-negative, with 0.0 indicating the frame is very | 35 // Meaningful values are non-negative, with 0.0 indicating the frame is very |
38 // simple and/or the target encode bitrate is very large, 1.0 indicating the | 36 // simple and/or the target encode bitrate is very large, 1.0 indicating the |
39 // frame contains very complex content and/or the target encode bitrate is | 37 // frame contains very complex content and/or the target encode bitrate is |
40 // very small, and values greater than 1.0 indicating the encoder cannot | 38 // very small, and values greater than 1.0 indicating the encoder cannot |
41 // encode the frame within the target bitrate (even at its lowest quality | 39 // encode the frame within the target bitrate (even at its lowest quality |
42 // setting). Negative values indicate the field was not computed. | 40 // setting). Negative values indicate the field was not computed. |
43 // | 41 // |
44 // TODO(miu): Rename to idealized_bitrate_utilization. | 42 // TODO(miu): Rename to idealized_bitrate_utilization. |
45 double lossy_utilization; | 43 double lossy_utilization; |
46 | 44 |
47 // The time at which the encode of the frame completed. | 45 // The time at which the encode of the frame completed. |
48 base::TimeTicks encode_completion_time; | 46 base::TimeTicks encode_completion_time; |
49 }; | 47 }; |
50 | 48 |
51 } // namespace cast | 49 } // namespace cast |
52 } // namespace media | 50 } // namespace media |
53 | 51 |
54 #endif // MEDIA_CAST_SENDER_SENDER_ENCODED_FRAME_H_ | 52 #endif // MEDIA_CAST_SENDER_SENDER_ENCODED_FRAME_H_ |
OLD | NEW |