X-Git-Url: https://main.carlh.net/gitweb/?a=blobdiff_plain;f=src%2Flib%2Faudio_buffers.h;h=09faf9ee192cc7cc2ee086267102c22133b2c079;hb=7231634b0535c77037602c23bfb97f707421b338;hp=6b57bd142ff5bf674f75c78f2bf987ce7c0cc1a8;hpb=e16c8ed02a0cb1f733a990d75a9de1bf50cf89bd;p=dcpomatic.git diff --git a/src/lib/audio_buffers.h b/src/lib/audio_buffers.h index 6b57bd142..09faf9ee1 100644 --- a/src/lib/audio_buffers.h +++ b/src/lib/audio_buffers.h @@ -1,5 +1,5 @@ /* - Copyright (C) 2012-2013 Carl Hetherington + Copyright (C) 2012-2014 Carl Hetherington This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -17,27 +17,42 @@ */ +/** @file src/lib/audio_buffers.h + * @brief AudioBuffers class. + */ + +#ifndef DCPOMATIC_AUDIO_BUFFERS_H +#define DCPOMATIC_AUDIO_BUFFERS_H + #include +#include /** @class AudioBuffers * @brief A class to hold multi-channel audio data in float format. + * + * The use of int32_t for frame counts in this class is due to the + * round-up to the next power-of-2 code in ::ensure_size; if that + * were changed the frame count could use any integer type. */ class AudioBuffers { public: - AudioBuffers (int channels, int frames); + AudioBuffers (int channels, int32_t frames); AudioBuffers (AudioBuffers const &); AudioBuffers (boost::shared_ptr); ~AudioBuffers (); AudioBuffers & operator= (AudioBuffers const &); - void ensure_size (int); + boost::shared_ptr clone () const; + boost::shared_ptr channel (int) const; + + void ensure_size (int32_t); float** data () const { return _data; } - + float* data (int) const; int channels () const { @@ -48,27 +63,32 @@ public: return _frames; } - void set_frames (int f); + void set_frames (int32_t f); void make_silent (); void make_silent (int c); - void make_silent (int from, int frames); + void make_silent (int32_t from, int32_t frames); + + void apply_gain (float); - void copy_from (AudioBuffers const * from, int frames_to_copy, int read_offset, int write_offset); - void move (int from, int to, int frames); - void accumulate_channel (AudioBuffers const *, int, int); - void accumulate_frames (AudioBuffers const *, int read_offset, int write_offset, int frames); + void copy_from (AudioBuffers const * from, int32_t frames_to_copy, int32_t read_offset, int32_t write_offset); + void copy_channel_from (AudioBuffers const * from, int from_channel, int to_channel); + void move (int32_t from, int32_t to, int32_t frames); + void accumulate_channel (AudioBuffers const * from, int from_channel, int to_channel, float gain = 1); + void accumulate_frames (AudioBuffers const *, int32_t read_offset, int32_t write_offset, int32_t frames); private: - void allocate (int, int); + void allocate (int channels, int32_t frames); void deallocate (); - + /** Number of channels */ int _channels; /** Number of frames (where a frame is one sample across all channels) */ - int _frames; + int32_t _frames; /** Number of frames that _data can hold */ - int _allocated_frames; + int32_t _allocated_frames; /** Audio data (so that, e.g. _data[2][6] is channel 2, sample 6) */ float** _data; }; + +#endif