libs/ardour/ardour/sndfilesource.h

   1 /*
   2     Copyright (C) 2006 Paul Davis
   3
   4     This program is free software; you can redistribute it and/or modify
   5     it under the terms of the GNU General Public License as published by
   6     the Free Software Foundation; either version 2 of the License, or
   7     (at your option) any later version.
   8
   9     This program is distributed in the hope that it will be useful,
  10     but WITHOUT ANY WARRANTY; without even the implied warranty of
  11     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12     GNU General Public License for more details.
  13
  14     You should have received a copy of the GNU General Public License
  15     along with this program; if not, write to the Free Software
  16     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  17
  18 */
  19
  20 #ifndef __sndfile_source_h__
  21 #define __sndfile_source_h__
  22
  23 #include <sndfile.h>
  24
  25 #include "ardour/audiofilesource.h"
  26 #include "ardour/broadcast_info.h"
  27 #include "ardour/progress.h"
  28
  29 namespace ARDOUR {
  30
  31 class LIBARDOUR_API SndFileSource : public AudioFileSource {
  32   public:
  33         /** Constructor to be called for existing external-to-session files */
  34         SndFileSource (Session&, const std::string& path, int chn, Flag flags);
  35
  36         /* Constructor to be called for new in-session files */
  37         SndFileSource (Session&, const std::string& path, const std::string& origin,
  38                        SampleFormat samp_format, HeaderFormat hdr_format, framecnt_t rate,
  39                        Flag flags = SndFileSource::default_writable_flags);
  40
  41         /* Constructor to be called for recovering files being used for
  42          * capture. They are in-session, they already exist, they should not
  43          * be writable. They are an odd hybrid (from a constructor point of
  44          * view) of the previous two constructors.
  45          */
  46         SndFileSource (Session&, const std::string& path, int chn);
  47
  48         /** Constructor to be called for existing in-session files during
  49          * session loading
  50          */
  51         SndFileSource (Session&, const XMLNode&);
  52
  53         /** Constructor to losslessly compress existing source */
  54         SndFileSource (Session& s, const AudioFileSource& other, const std::string& path, bool use16bits = false, Progress* p = NULL);
  55
  56         ~SndFileSource ();
  57
  58         float sample_rate () const;
  59         int update_header (framepos_t when, struct tm&, time_t);
  60         int flush_header ();
  61         void flush ();
  62
  63         framepos_t natural_position () const;
  64
  65         framepos_t last_capture_start_frame() const;
  66         void mark_capture_start (framepos_t);
  67         void mark_capture_end ();
  68         void clear_capture_marks();
  69
  70 #ifdef XXX_OLD_DESTRUCTIVE_API_XXX
  71         bool set_destructive (bool yn);
  72 #endif
  73
  74         bool one_of_several_channels () const;
  75     uint32_t channel_count () const { return _info.channels; }
  76
  77         bool clamped_at_unity () const;
  78
  79         static void setup_standard_crossfades (Session const &, framecnt_t sample_rate);
  80         static const Source::Flag default_writable_flags;
  81
  82         static int get_soundfile_info (const std::string& path, SoundFileInfo& _info, std::string& error_msg);
  83
  84   protected:
  85         void close ();
  86
  87         void set_path (const std::string& p);
  88         void set_header_timeline_position ();
  89
  90         framecnt_t read_unlocked (Sample *dst, framepos_t start, framecnt_t cnt) const;
  91         framecnt_t write_unlocked (Sample *dst, framecnt_t cnt);
  92         framecnt_t write_float (Sample* data, framepos_t pos, framecnt_t cnt);
  93
  94   private:
  95         SNDFILE* _sndfile;
  96         SF_INFO _info;
  97         BroadcastInfo *_broadcast_info;
  98
  99         void init_sndfile ();
 100         int open();
 101         int setup_broadcast_info (framepos_t when, struct tm&, time_t);
 102         void file_closed ();
 103
 104         /* destructive */
 105
 106         static framecnt_t xfade_frames;
 107         static gain_t* out_coefficient;
 108         static gain_t* in_coefficient;
 109
 110         bool          _capture_start;
 111         bool          _capture_end;
 112         framepos_t     capture_start_frame;
 113         framepos_t     file_pos; // unit is frames
 114         Sample*        xfade_buf;
 115
 116         framecnt_t crossfade (Sample* data, framecnt_t cnt, int dir);
 117         void set_timeline_position (framepos_t);
 118         framecnt_t destructive_write_unlocked (Sample *dst, framecnt_t cnt);
 119         framecnt_t nondestructive_write_unlocked (Sample *dst, framecnt_t cnt);
 120         void handle_header_position_change ();
 121         PBD::ScopedConnection header_position_connection;
 122 };
 123
 124 } // namespace ARDOUR
 125
 126 #endif /* __sndfile_source_h__ */
 127