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_DECODER_BUFFER_H_ | 5 #ifndef MEDIA_BASE_DECODER_BUFFER_H_ |
6 #define MEDIA_BASE_DECODER_BUFFER_H_ | 6 #define MEDIA_BASE_DECODER_BUFFER_H_ |
7 | 7 |
8 #include <string> | 8 #include <string> |
9 | 9 |
| 10 #include "base/logging.h" |
10 #include "base/memory/aligned_memory.h" | 11 #include "base/memory/aligned_memory.h" |
11 #include "base/memory/ref_counted.h" | 12 #include "base/memory/ref_counted.h" |
12 #include "base/memory/scoped_ptr.h" | 13 #include "base/memory/scoped_ptr.h" |
13 #include "base/time/time.h" | 14 #include "base/time/time.h" |
14 #include "build/build_config.h" | 15 #include "build/build_config.h" |
| 16 #include "media/base/decrypt_config.h" |
15 #include "media/base/media_export.h" | 17 #include "media/base/media_export.h" |
16 | 18 |
17 namespace media { | 19 namespace media { |
18 | 20 |
19 class DecryptConfig; | |
20 | |
21 // A specialized buffer for interfacing with audio / video decoders. | 21 // A specialized buffer for interfacing with audio / video decoders. |
22 // | 22 // |
23 // Specifically ensures that data is aligned and padded as necessary by the | 23 // Specifically ensures that data is aligned and padded as necessary by the |
24 // underlying decoding framework. On desktop platforms this means memory is | 24 // underlying decoding framework. On desktop platforms this means memory is |
25 // allocated using FFmpeg with particular alignment and padding requirements. | 25 // allocated using FFmpeg with particular alignment and padding requirements. |
26 // | 26 // |
27 // Also includes decoder specific functionality for decryption. | 27 // Also includes decoder specific functionality for decryption. |
28 // | 28 // |
29 // NOTE: It is illegal to call any method when IsEndOfStream() is true. | 29 // NOTE: It is illegal to call any method when end_of_stream() is true. |
30 class MEDIA_EXPORT DecoderBuffer | 30 class MEDIA_EXPORT DecoderBuffer |
31 : public base::RefCountedThreadSafe<DecoderBuffer> { | 31 : public base::RefCountedThreadSafe<DecoderBuffer> { |
32 public: | 32 public: |
33 enum { | 33 enum { |
34 kPaddingSize = 16, | 34 kPaddingSize = 16, |
35 #if defined(ARCH_CPU_ARM_FAMILY) | 35 #if defined(ARCH_CPU_ARM_FAMILY) |
36 kAlignmentSize = 16 | 36 kAlignmentSize = 16 |
37 #else | 37 #else |
38 kAlignmentSize = 32 | 38 kAlignmentSize = 32 |
39 #endif | 39 #endif |
40 }; | 40 }; |
41 | 41 |
42 // Allocates buffer with |size| >= 0. Buffer will be padded and aligned | 42 // Allocates buffer with |size| >= 0. Buffer will be padded and aligned |
43 // as necessary. | 43 // as necessary. |
44 explicit DecoderBuffer(int size); | 44 explicit DecoderBuffer(int size); |
45 | 45 |
46 // Create a DecoderBuffer whose |data_| is copied from |data|. Buffer will be | 46 // Create a DecoderBuffer whose |data_| is copied from |data|. Buffer will be |
47 // padded and aligned as necessary. |data| must not be NULL and |size| >= 0. | 47 // padded and aligned as necessary. |data| must not be NULL and |size| >= 0. |
48 static scoped_refptr<DecoderBuffer> CopyFrom(const uint8* data, int size); | 48 static scoped_refptr<DecoderBuffer> CopyFrom(const uint8* data, int size); |
49 | 49 |
50 // Create a DecoderBuffer whose |data_| is copied from |data| and |side_data_| | 50 // Create a DecoderBuffer whose |data_| is copied from |data| and |side_data_| |
51 // is copied from |side_data|. Buffers will be padded and aligned as necessary | 51 // is copied from |side_data|. Buffers will be padded and aligned as necessary |
52 // Data pointers must not be NULL and sizes must be >= 0. | 52 // Data pointers must not be NULL and sizes must be >= 0. |
53 static scoped_refptr<DecoderBuffer> CopyFrom(const uint8* data, int size, | 53 static scoped_refptr<DecoderBuffer> CopyFrom(const uint8* data, int size, |
54 const uint8* side_data, | 54 const uint8* side_data, |
55 int side_data_size); | 55 int side_data_size); |
56 | 56 |
57 // Create a DecoderBuffer indicating we've reached end of stream. | 57 // Create a DecoderBuffer indicating we've reached end of stream. |
58 // | 58 // |
59 // Calling any method other than IsEndOfStream() on the resulting buffer | 59 // Calling any method other than end_of_stream() on the resulting buffer |
60 // is disallowed. | 60 // is disallowed. |
61 static scoped_refptr<DecoderBuffer> CreateEOSBuffer(); | 61 static scoped_refptr<DecoderBuffer> CreateEOSBuffer(); |
62 | 62 |
63 base::TimeDelta GetTimestamp() const; | 63 base::TimeDelta timestamp() const { |
64 void SetTimestamp(const base::TimeDelta& timestamp); | 64 DCHECK(!end_of_stream()); |
| 65 return timestamp_; |
| 66 } |
65 | 67 |
66 base::TimeDelta GetDuration() const; | 68 void set_timestamp(const base::TimeDelta& timestamp) { |
67 void SetDuration(const base::TimeDelta& duration); | 69 DCHECK(!end_of_stream()); |
| 70 timestamp_ = timestamp; |
| 71 } |
68 | 72 |
69 const uint8* GetData() const; | 73 base::TimeDelta duration() const { |
70 uint8* GetWritableData() const; | 74 DCHECK(!end_of_stream()); |
| 75 return duration_; |
| 76 } |
71 | 77 |
72 int GetDataSize() const; | 78 void set_duration(const base::TimeDelta& duration) { |
| 79 DCHECK(!end_of_stream()); |
| 80 duration_ = duration; |
| 81 } |
73 | 82 |
74 const uint8* GetSideData() const; | 83 const uint8* data() const { |
75 int GetSideDataSize() const; | 84 DCHECK(!end_of_stream()); |
| 85 return data_.get(); |
| 86 } |
76 | 87 |
77 const DecryptConfig* GetDecryptConfig() const; | 88 uint8* writable_data() const { |
78 void SetDecryptConfig(scoped_ptr<DecryptConfig> decrypt_config); | 89 DCHECK(!end_of_stream()); |
| 90 return data_.get(); |
| 91 } |
| 92 |
| 93 int data_size() const { |
| 94 DCHECK(!end_of_stream()); |
| 95 return size_; |
| 96 } |
| 97 |
| 98 const uint8* side_data() const { |
| 99 DCHECK(!end_of_stream()); |
| 100 return side_data_.get(); |
| 101 } |
| 102 |
| 103 int side_data_size() const { |
| 104 DCHECK(!end_of_stream()); |
| 105 return side_data_size_; |
| 106 } |
| 107 |
| 108 const DecryptConfig* decrypt_config() const { |
| 109 DCHECK(!end_of_stream()); |
| 110 return decrypt_config_.get(); |
| 111 } |
| 112 |
| 113 void set_decrypt_config(scoped_ptr<DecryptConfig> decrypt_config) { |
| 114 DCHECK(!end_of_stream()); |
| 115 decrypt_config_ = decrypt_config.Pass(); |
| 116 } |
79 | 117 |
80 // If there's no data in this buffer, it represents end of stream. | 118 // If there's no data in this buffer, it represents end of stream. |
81 bool IsEndOfStream() const; | 119 bool end_of_stream() const { |
| 120 return data_ == NULL; |
| 121 } |
82 | 122 |
83 // Returns a human-readable string describing |*this|. | 123 // Returns a human-readable string describing |*this|. |
84 std::string AsHumanReadableString(); | 124 std::string AsHumanReadableString(); |
85 | 125 |
86 protected: | 126 protected: |
87 friend class base::RefCountedThreadSafe<DecoderBuffer>; | 127 friend class base::RefCountedThreadSafe<DecoderBuffer>; |
88 | 128 |
89 // Allocates a buffer of size |size| >= 0 and copies |data| into it. Buffer | 129 // Allocates a buffer of size |size| >= 0 and copies |data| into it. Buffer |
90 // will be padded and aligned as necessary. If |data| is NULL then |data_| is | 130 // will be padded and aligned as necessary. If |data| is NULL then |data_| is |
91 // set to NULL and |buffer_size_| to 0. | 131 // set to NULL and |buffer_size_| to 0. |
(...skipping 13 matching lines...) Expand all Loading... |
105 | 145 |
106 // Constructor helper method for memory allocations. | 146 // Constructor helper method for memory allocations. |
107 void Initialize(); | 147 void Initialize(); |
108 | 148 |
109 DISALLOW_COPY_AND_ASSIGN(DecoderBuffer); | 149 DISALLOW_COPY_AND_ASSIGN(DecoderBuffer); |
110 }; | 150 }; |
111 | 151 |
112 } // namespace media | 152 } // namespace media |
113 | 153 |
114 #endif // MEDIA_BASE_DECODER_BUFFER_H_ | 154 #endif // MEDIA_BASE_DECODER_BUFFER_H_ |
OLD | NEW |