OLD | NEW |
1 // Copyright 2014 The Chromium Authors. All rights reserved. | 1 // Copyright 2014 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_FORMATS_MP4_BOX_READER_H_ | 5 #ifndef MEDIA_FORMATS_MP4_BOX_READER_H_ |
6 #define MEDIA_FORMATS_MP4_BOX_READER_H_ | 6 #define MEDIA_FORMATS_MP4_BOX_READER_H_ |
7 | 7 |
8 #include <stdint.h> | 8 #include <stdint.h> |
9 | 9 |
10 #include <limits> | 10 #include <limits> |
(...skipping 83 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
94 ~BoxReader(); | 94 ~BoxReader(); |
95 | 95 |
96 // Create a BoxReader from a buffer. Note that this function may return NULL | 96 // Create a BoxReader from a buffer. Note that this function may return NULL |
97 // if an intact, complete box was not available in the buffer. If |*err| is | 97 // if an intact, complete box was not available in the buffer. If |*err| is |
98 // set, there was a stream-level error when creating the box; otherwise, NULL | 98 // set, there was a stream-level error when creating the box; otherwise, NULL |
99 // values are only expected when insufficient data is available. | 99 // values are only expected when insufficient data is available. |
100 // | 100 // |
101 // |buf| is retained but not owned, and must outlive the BoxReader instance. | 101 // |buf| is retained but not owned, and must outlive the BoxReader instance. |
102 static BoxReader* ReadTopLevelBox(const uint8_t* buf, | 102 static BoxReader* ReadTopLevelBox(const uint8_t* buf, |
103 const size_t buf_size, | 103 const size_t buf_size, |
104 const scoped_refptr<MediaLog>& media_log, | 104 MediaLog* media_log, |
105 bool* err); | 105 bool* err); |
106 | 106 |
107 // Read the box header from the current buffer. This function returns true if | 107 // Read the box header from the current buffer. This function returns true if |
108 // there is enough data to read the header and the header is sane; that is, it | 108 // there is enough data to read the header and the header is sane; that is, it |
109 // does not check to ensure the entire box is in the buffer before returning | 109 // does not check to ensure the entire box is in the buffer before returning |
110 // true. The semantics of |*err| are the same as above. | 110 // true. The semantics of |*err| are the same as above. |
111 // | 111 // |
112 // |buf| is not retained. | 112 // |buf| is not retained. |
113 static bool StartTopLevelBox(const uint8_t* buf, | 113 static bool StartTopLevelBox(const uint8_t* buf, |
114 const size_t buf_size, | 114 const size_t buf_size, |
115 const scoped_refptr<MediaLog>& media_log, | 115 MediaLog* media_log, |
116 FourCC* type, | 116 FourCC* type, |
117 size_t* box_size, | 117 size_t* box_size, |
118 bool* err) WARN_UNUSED_RESULT; | 118 bool* err) WARN_UNUSED_RESULT; |
119 | 119 |
120 // Create a BoxReader from a buffer. |buf| must be the complete buffer, as | 120 // Create a BoxReader from a buffer. |buf| must be the complete buffer, as |
121 // errors are returned when sufficient data is not available. |buf| can start | 121 // errors are returned when sufficient data is not available. |buf| can start |
122 // with any type of box -- it does not have to be IsValidTopLevelBox(). | 122 // with any type of box -- it does not have to be IsValidTopLevelBox(). |
123 // | 123 // |
124 // |buf| is retained but not owned, and must outlive the BoxReader instance. | 124 // |buf| is retained but not owned, and must outlive the BoxReader instance. |
125 static BoxReader* ReadConcatentatedBoxes(const uint8_t* buf, | 125 static BoxReader* ReadConcatentatedBoxes(const uint8_t* buf, |
126 const size_t buf_size); | 126 const size_t buf_size); |
127 | 127 |
128 // Returns true if |type| is recognized to be a top-level box, false | 128 // Returns true if |type| is recognized to be a top-level box, false |
129 // otherwise. This returns true for some boxes which we do not parse. | 129 // otherwise. This returns true for some boxes which we do not parse. |
130 // Helpful in debugging misaligned appends. | 130 // Helpful in debugging misaligned appends. |
131 static bool IsValidTopLevelBox(const FourCC& type, | 131 static bool IsValidTopLevelBox(const FourCC& type, MediaLog* media_log); |
132 const scoped_refptr<MediaLog>& media_log); | |
133 | 132 |
134 // Scan through all boxes within the current box, starting at the current | 133 // Scan through all boxes within the current box, starting at the current |
135 // buffer position. Must be called before any of the *Child functions work. | 134 // buffer position. Must be called before any of the *Child functions work. |
136 bool ScanChildren() WARN_UNUSED_RESULT; | 135 bool ScanChildren() WARN_UNUSED_RESULT; |
137 | 136 |
138 // Return true if child with type |child.BoxType()| exists. | 137 // Return true if child with type |child.BoxType()| exists. |
139 bool HasChild(Box* child) WARN_UNUSED_RESULT; | 138 bool HasChild(Box* child) WARN_UNUSED_RESULT; |
140 | 139 |
141 // Read exactly one child box from the set of children. The type of the child | 140 // Read exactly one child box from the set of children. The type of the child |
142 // will be determined by the BoxType() method of |child|. | 141 // will be determined by the BoxType() method of |child|. |
(...skipping 33 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
176 | 175 |
177 size_t box_size() const { | 176 size_t box_size() const { |
178 DCHECK(box_size_known_); | 177 DCHECK(box_size_known_); |
179 return box_size_; | 178 return box_size_; |
180 } | 179 } |
181 | 180 |
182 FourCC type() const { return type_; } | 181 FourCC type() const { return type_; } |
183 uint8_t version() const { return version_; } | 182 uint8_t version() const { return version_; } |
184 uint32_t flags() const { return flags_; } | 183 uint32_t flags() const { return flags_; } |
185 | 184 |
186 const scoped_refptr<MediaLog>& media_log() const { return media_log_; } | 185 MediaLog* media_log() const { return media_log_; } |
187 | 186 |
188 private: | 187 private: |
189 // Create a BoxReader from |buf|. |is_EOS| should be true if |buf| is | 188 // Create a BoxReader from |buf|. |is_EOS| should be true if |buf| is |
190 // complete stream (i.e. no additional data is expected to be appended). | 189 // complete stream (i.e. no additional data is expected to be appended). |
191 BoxReader(const uint8_t* buf, | 190 BoxReader(const uint8_t* buf, |
192 const size_t buf_size, | 191 const size_t buf_size, |
193 const scoped_refptr<MediaLog>& media_log, | 192 MediaLog* media_log, |
194 bool is_EOS); | 193 bool is_EOS); |
195 | 194 |
196 // Must be called immediately after init. If the return is false, this | 195 // Must be called immediately after init. If the return is false, this |
197 // indicates that the box header and its contents were not available in the | 196 // indicates that the box header and its contents were not available in the |
198 // stream or were nonsensical, and that the box must not be used further. In | 197 // stream or were nonsensical, and that the box must not be used further. In |
199 // this case, if |*err| is false, the problem was simply a lack of data, and | 198 // this case, if |*err| is false, the problem was simply a lack of data, and |
200 // should only be an error condition if some higher-level component knows that | 199 // should only be an error condition if some higher-level component knows that |
201 // no more data is coming (i.e. EOS or end of containing box). If |*err| is | 200 // no more data is coming (i.e. EOS or end of containing box). If |*err| is |
202 // true, the error is unrecoverable and the stream should be aborted. | 201 // true, the error is unrecoverable and the stream should be aborted. |
203 bool ReadHeader(bool* err); | 202 bool ReadHeader(bool* err); |
204 | 203 |
205 // Read all children, optionally checking FourCC. Returns true if all | 204 // Read all children, optionally checking FourCC. Returns true if all |
206 // children are successfully parsed and, if |check_box_type|, have the | 205 // children are successfully parsed and, if |check_box_type|, have the |
207 // correct box type for |T|. Note that this method is mutually exclusive | 206 // correct box type for |T|. Note that this method is mutually exclusive |
208 // with ScanChildren(). | 207 // with ScanChildren(). |
209 template <typename T> | 208 template <typename T> |
210 bool ReadAllChildrenInternal(std::vector<T>* children, bool check_box_type); | 209 bool ReadAllChildrenInternal(std::vector<T>* children, bool check_box_type); |
211 | 210 |
212 scoped_refptr<MediaLog> media_log_; | 211 MediaLog* media_log_; |
213 size_t box_size_; | 212 size_t box_size_; |
214 bool box_size_known_; | 213 bool box_size_known_; |
215 FourCC type_; | 214 FourCC type_; |
216 uint8_t version_; | 215 uint8_t version_; |
217 uint32_t flags_; | 216 uint32_t flags_; |
218 | 217 |
219 typedef std::multimap<FourCC, BoxReader> ChildMap; | 218 typedef std::multimap<FourCC, BoxReader> ChildMap; |
220 | 219 |
221 // The set of child box FourCCs and their corresponding buffer readers. Only | 220 // The set of child box FourCCs and their corresponding buffer readers. Only |
222 // valid if scanned_ is true. | 221 // valid if scanned_ is true. |
(...skipping 66 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
289 pos_ += child_reader.box_size(); | 288 pos_ += child_reader.box_size(); |
290 } | 289 } |
291 | 290 |
292 return !err; | 291 return !err; |
293 } | 292 } |
294 | 293 |
295 } // namespace mp4 | 294 } // namespace mp4 |
296 } // namespace media | 295 } // namespace media |
297 | 296 |
298 #endif // MEDIA_FORMATS_MP4_BOX_READER_H_ | 297 #endif // MEDIA_FORMATS_MP4_BOX_READER_H_ |
OLD | NEW |