audio_buffer.h revision 7d4cd473f85ac64c3747c96c277f9e506a0d2246
17d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)// Copyright 2013 The Chromium Authors. All rights reserved. 27d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 37d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)// found in the LICENSE file. 47d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) 57d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)#ifndef MEDIA_BASE_AUDIO_BUFFER_H_ 67d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)#define MEDIA_BASE_AUDIO_BUFFER_H_ 77d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) 87d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)#include <vector> 97d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) 107d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)#include "base/memory/aligned_memory.h" 117d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)#include "base/memory/ref_counted.h" 127d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)#include "base/memory/scoped_ptr.h" 137d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)#include "base/time.h" 147d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)#include "media/base/media_export.h" 157d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)#include "media/base/sample_format.h" 167d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) 177d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)namespace media { 187d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)class AudioBus; 197d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) 207d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)// An audio buffer that takes a copy of the data passed to it, holds it, and 217d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)// copies it into an AudioBus when needed. Also supports an end of stream 227d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)// marker. 237d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)class MEDIA_EXPORT AudioBuffer 247d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) : public base::RefCountedThreadSafe<AudioBuffer> { 257d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) public: 267d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // Create an AudioBuffer whose channel data is copied from |data|. For 277d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // interleaved data, only the first buffer is used. For planar data, the 287d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // number of buffers must be equal to |channel_count|. |frame_count| is the 297d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // number of frames in each buffer. |data| must not be null and |frame_count| 307d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // must be >= 0. 317d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // 327d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // TODO(jrummell): Compute duration rather than pass it in. 337d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) static scoped_refptr<AudioBuffer> CopyFrom(SampleFormat sample_format, 347d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) int channel_count, 357d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) int frame_count, 367d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) const uint8* const* data, 377d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) const base::TimeDelta timestamp, 387d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) const base::TimeDelta duration); 397d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) 407d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // Create a AudioBuffer indicating we've reached end of stream. 417d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // Calling any method other than end_of_stream() on the resulting buffer 427d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // is disallowed. 437d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) static scoped_refptr<AudioBuffer> CreateEOSBuffer(); 447d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) 457d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // Copy frames into |dest|. |frames_to_copy| is the number of frames to copy. 467d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // |source_frame_offset| specified how many frames in the buffer to skip 477d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // first. |dest_frame_offset| is the frame offset in |dest|. The frames are 487d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // converted from their source format into planar float32 data (which is all 497d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // that AudioBus handles). 507d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) void ReadFrames(int frames_to_copy, 517d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) int source_frame_offset, 527d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) int dest_frame_offset, 537d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) AudioBus* dest); 547d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) 557d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // Return the number of frames held. 567d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) int frame_count() const { return frame_count_; } 577d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) 587d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // Access to constructor parameters. 597d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) base::TimeDelta timestamp() const { return timestamp_; } 607d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) base::TimeDelta duration() const { return duration_; } 617d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) 627d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // If there's no data in this buffer, it represents end of stream. 637d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) bool end_of_stream() const { return data_ == NULL; } 647d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) 657d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) private: 667d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) friend class base::RefCountedThreadSafe<AudioBuffer>; 677d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) 687d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // Allocates aligned contiguous buffer to hold all channel data (1 block for 697d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // interleaved data, |channel_count| blocks for planar data), copies 707d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // [data,data+data_size) to the allocated buffer(s). If |data| is null an end 717d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // of stream buffer is created. 727d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) AudioBuffer(SampleFormat sample_format, 737d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) int channel_count, 747d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) int frame_count, 757d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) const uint8* const* data, 767d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) const base::TimeDelta timestamp, 777d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) const base::TimeDelta duration); 787d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) 797d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) virtual ~AudioBuffer(); 807d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) 817d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) SampleFormat sample_format_; 827d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) int channel_count_; 837d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) int frame_count_; 847d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) base::TimeDelta timestamp_; 857d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) base::TimeDelta duration_; 867d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) 877d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // Contiguous block of channel data. 887d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) scoped_ptr_malloc<uint8, base::ScopedPtrAlignedFree> data_; 897d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) 907d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) // For planar data, points to each channels data. 917d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) std::vector<uint8*> channel_data_; 927d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) 937d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) DISALLOW_IMPLICIT_CONSTRUCTORS(AudioBuffer); 947d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)}; 957d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) 967d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)} // namespace media 977d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles) 987d4cd473f85ac64c3747c96c277f9e506a0d2246Torne (Richard Coles)#endif // MEDIA_BASE_AUDIO_BUFFER_H_ 99