1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
// Copyright (c) 2011 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef MEDIA_BASE_VIDEO_DECODER_CONFIG_H_
#define MEDIA_BASE_VIDEO_DECODER_CONFIG_H_
#include "base/basictypes.h"
#include "base/memory/scoped_ptr.h"
#include "media/base/media_export.h"
#include "media/base/video_frame.h"
#include "ui/gfx/rect.h"
#include "ui/gfx/size.h"
namespace media {
enum VideoCodec {
// These values are histogrammed over time; do not change their ordinal
// values. When deleting a codec replace it with a dummy value; when adding a
// codec, do so at the bottom (and update kVideoCodecMax).
kUnknownVideoCodec = 0,
kCodecH264,
kCodecVC1,
kCodecMPEG2,
kCodecMPEG4,
kCodecTheora,
kCodecVP8,
// DO NOT ADD RANDOM VIDEO CODECS!
//
// The only acceptable time to add a new codec is if there is production code
// that uses said codec in the same CL.
kVideoCodecMax = kCodecVP8 // Must equal the last "real" codec above.
};
class MEDIA_EXPORT VideoDecoderConfig {
public:
// Constructs an uninitialized object. Clients should call Initialize() with
// appropriate values before using.
VideoDecoderConfig();
// Constructs an initialized object. It is acceptable to pass in NULL for
// |extra_data|, otherwise the memory is copied.
VideoDecoderConfig(VideoCodec codec,
VideoFrame::Format format,
const gfx::Size& coded_size,
const gfx::Rect& visible_rect,
int frame_rate_numerator, int frame_rate_denominator,
int aspect_ratio_numerator, int aspect_ratio_denominator,
const uint8* extra_data, size_t extra_data_size);
~VideoDecoderConfig();
// Resets the internal state of this object.
void Initialize(VideoCodec codec,
VideoFrame::Format format,
const gfx::Size& coded_size,
const gfx::Rect& visible_rect,
int frame_rate_numerator, int frame_rate_denominator,
int aspect_ratio_numerator, int aspect_ratio_denominator,
const uint8* extra_data, size_t extra_data_size);
// Returns true if this object has appropriate configuration values, false
// otherwise.
bool IsValidConfig() const;
VideoCodec codec() const;
// Video format used to determine YUV buffer sizes.
VideoFrame::Format format() const;
// Width and height of video frame immediately post-decode. Not all pixels
// in this region are valid.
gfx::Size coded_size() const;
// Region of |coded_size_| that is visible.
gfx::Rect visible_rect() const;
// Final visible width and height of a video frame with aspect ratio taken
// into account.
gfx::Size natural_size() const;
// Frame rate in seconds expressed as a fraction.
//
// This information is required to properly timestamp video frames for
// codecs that contain repeated frames, such as found in H.264's
// supplemental enhancement information.
int frame_rate_numerator() const;
int frame_rate_denominator() const;
// Aspect ratio of the decoded video frame expressed as a fraction.
//
// TODO(scherkus): think of a better way to avoid having video decoders
// handle tricky aspect ratio dimension calculations.
int aspect_ratio_numerator() const;
int aspect_ratio_denominator() const;
// Optional byte data required to initialize video decoders, such as H.264
// AAVC data.
uint8* extra_data() const;
size_t extra_data_size() const;
private:
VideoCodec codec_;
VideoFrame::Format format_;
gfx::Size coded_size_;
gfx::Rect visible_rect_;
gfx::Size natural_size_;
int frame_rate_numerator_;
int frame_rate_denominator_;
int aspect_ratio_numerator_;
int aspect_ratio_denominator_;
scoped_array<uint8> extra_data_;
size_t extra_data_size_;
DISALLOW_COPY_AND_ASSIGN(VideoDecoderConfig);
};
} // namespace media
#endif // MEDIA_BASE_VIDEO_DECODER_CONFIG_H_
|
