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_BASE_BIT_READER_H_ | 5 #ifndef MEDIA_BASE_BIT_READER_H_ |
6 #define MEDIA_BASE_BIT_READER_H_ | 6 #define MEDIA_BASE_BIT_READER_H_ |
7 | 7 |
8 #include <sys/types.h> | |
9 | |
10 #include "base/basictypes.h" | 8 #include "base/basictypes.h" |
11 #include "base/logging.h" | 9 #include "base/compiler_specific.h" |
| 10 #include "base/memory/scoped_ptr.h" |
| 11 #include "media/base/bit_reader_core.h" |
12 #include "media/base/media_export.h" | 12 #include "media/base/media_export.h" |
13 | 13 |
14 namespace media { | 14 namespace media { |
15 | 15 |
16 // A class to read bit streams. | 16 class MEDIA_EXPORT BitReader |
17 class MEDIA_EXPORT BitReader { | 17 : NON_EXPORTED_BASE(private BitReaderCore::ByteStreamProvider) { |
18 public: | 18 public: |
19 // Initialize the reader to start reading at |data|, |size| being size | 19 // Initialize the reader to start reading at |data|, |size| being size |
20 // of |data| in bytes. | 20 // of |data| in bytes. |
21 BitReader(const uint8* data, off_t size); | 21 BitReader(const uint8* data, int size); |
22 ~BitReader(); | 22 virtual ~BitReader(); |
23 | 23 |
24 // Read |num_bits| next bits from stream and return in |*out|, first bit | 24 template<typename T> bool ReadBits(int num_bits, T* out) { |
25 // from the stream starting at |num_bits| position in |*out|. | 25 return bit_reader_core_.ReadBits(num_bits, out); |
26 // |num_bits| cannot be larger than the bits the type can hold. | |
27 // Return false if the given number of bits cannot be read (not enough | |
28 // bits in the stream), true otherwise. When return false, the stream will | |
29 // enter a state where further ReadBits/SkipBits operations will always | |
30 // return false unless |num_bits| is 0. The type |T| has to be a primitive | |
31 // integer type. | |
32 template<typename T> bool ReadBits(int num_bits, T *out) { | |
33 DCHECK_LE(num_bits, static_cast<int>(sizeof(T) * 8)); | |
34 uint64 temp; | |
35 bool ret = ReadBitsInternal(num_bits, &temp); | |
36 *out = static_cast<T>(temp); | |
37 return ret; | |
38 } | 26 } |
39 | 27 |
40 // Skip |num_bits| next bits from stream. Return false if the given number of | 28 bool ReadFlag(bool* flag) { |
41 // bits cannot be skipped (not enough bits in the stream), true otherwise. | 29 return bit_reader_core_.ReadFlag(flag); |
42 // When return false, the stream will enter a state where further ReadBits/ | 30 } |
43 // SkipBits operations will always return false unless |num_bits| is 0. | |
44 bool SkipBits(int num_bits); | |
45 | 31 |
46 // Returns the number of bits available for reading. | 32 bool SkipBits(int num_bits) { |
47 int bits_available() const; | 33 return bit_reader_core_.SkipBits(num_bits); |
| 34 } |
| 35 |
| 36 int bits_available() const { |
| 37 return initial_size_ * 8 - bits_read(); |
| 38 } |
| 39 |
| 40 int bits_read() const { |
| 41 return bit_reader_core_.bits_read(); |
| 42 } |
48 | 43 |
49 private: | 44 private: |
50 // Help function used by ReadBits to avoid inlining the bit reading logic. | 45 // BitReaderCore::ByteStreamProvider implementation. |
51 bool ReadBitsInternal(int num_bits, uint64* out); | 46 virtual int GetBytes(int max_n, const uint8** out) OVERRIDE; |
52 | 47 |
53 // Advance to the next byte, loading it into curr_byte_. | 48 // Total number of bytes that was initially passed to BitReader. |
54 // If the num_remaining_bits_in_curr_byte_ is 0 after this function returns, | 49 const int initial_size_; |
55 // the stream has reached the end. | |
56 void UpdateCurrByte(); | |
57 | 50 |
58 // Pointer to the next unread (not in curr_byte_) byte in the stream. | 51 // Pointer to the next unread byte in the stream. |
59 const uint8* data_; | 52 const uint8* data_; |
60 | 53 |
61 // Bytes left in the stream (without the curr_byte_). | 54 // Bytes left in the stream. |
62 off_t bytes_left_; | 55 int bytes_left_; |
63 | 56 |
64 // Contents of the current byte; first unread bit starting at position | 57 BitReaderCore bit_reader_core_; |
65 // 8 - num_remaining_bits_in_curr_byte_ from MSB. | |
66 uint8 curr_byte_; | |
67 | 58 |
68 // Number of bits remaining in curr_byte_ | |
69 int num_remaining_bits_in_curr_byte_; | |
70 | |
71 private: | |
72 DISALLOW_COPY_AND_ASSIGN(BitReader); | 59 DISALLOW_COPY_AND_ASSIGN(BitReader); |
73 }; | 60 }; |
74 | 61 |
75 } // namespace media | 62 } // namespace media |
76 | 63 |
77 #endif // MEDIA_BASE_BIT_READER_H_ | 64 #endif // MEDIA_BASE_BIT_READER_H_ |
OLD | NEW |