consolidate roll methods into Route::roll()
[ardour.git] / libs / ardour / audio_track.cc
1 /*
2     Copyright (C) 2002 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 #include <boost/scoped_array.hpp>
21
22 #include "pbd/enumwriter.h"
23 #include "pbd/error.h"
24
25 #include "evoral/Curve.hpp"
26
27 #include "ardour/amp.h"
28 #include "ardour/audio_buffer.h"
29 #include "ardour/audio_track.h"
30 #include "ardour/audioplaylist.h"
31 #include "ardour/boost_debug.h"
32 #include "ardour/buffer_set.h"
33 #include "ardour/delivery.h"
34 #include "ardour/disk_reader.h"
35 #include "ardour/disk_writer.h"
36 #include "ardour/meter.h"
37 #include "ardour/monitor_control.h"
38 #include "ardour/playlist_factory.h"
39 #include "ardour/processor.h"
40 #include "ardour/profile.h"
41 #include "ardour/region.h"
42 #include "ardour/region_factory.h"
43 #include "ardour/session.h"
44 #include "ardour/session_playlists.h"
45 #include "ardour/source.h"
46 #include "ardour/types_convert.h"
47 #include "ardour/utils.h"
48
49 #include "pbd/i18n.h"
50
51 using namespace std;
52 using namespace ARDOUR;
53 using namespace PBD;
54
55 AudioTrack::AudioTrack (Session& sess, string name, TrackMode mode)
56         : Track (sess, name, PresentationInfo::AudioTrack, mode)
57 {
58 }
59
60 AudioTrack::~AudioTrack ()
61 {
62         if (_freeze_record.playlist && !_session.deletion_in_progress()) {
63                 _freeze_record.playlist->release();
64         }
65 }
66
67 #ifdef XXX_OLD_DESTRUCTIVE_API_XXX
68 int
69 AudioTrack::set_mode (TrackMode m)
70 {
71         if (m != _mode) {
72
73                 if (!Profile->get_trx() && _diskstream->set_destructive (m == Destructive)) {
74                         return -1;
75                 }
76
77                 _diskstream->set_non_layered (m == NonLayered);
78                 _mode = m;
79
80                 TrackModeChanged (); /* EMIT SIGNAL */
81         }
82
83         return 0;
84 }
85
86 bool
87 AudioTrack::can_use_mode (TrackMode m, bool& bounce_required)
88 {
89         switch (m) {
90         case NonLayered:
91         case Normal:
92                 bounce_required = false;
93                 return true;
94
95         case Destructive:
96                 if (Profile->get_trx()) {
97                         return false;
98                 } else {
99                         return _diskstream->can_become_destructive (bounce_required);
100                 }
101                 break;
102
103         default:
104                 return false;
105         }
106 }
107 #endif
108
109 int
110 AudioTrack::set_state (const XMLNode& node, int version)
111 {
112         if (!node.get_property (X_("mode"), _mode)) {
113                 _mode = Normal;
114         }
115
116         if (Profile->get_trx() && _mode == Destructive) {
117                 /* Tracks does not support destructive tracks and trying to
118                    handle it as a normal track would be wrong.
119                 */
120                 error << string_compose (_("%1: this session uses destructive tracks, which are not supported"), PROGRAM_NAME) << endmsg;
121                 return -1;
122         }
123
124         if (Track::set_state (node, version)) {
125                 return -1;
126         }
127
128         pending_state = const_cast<XMLNode*> (&node);
129
130         if (_session.state_of_the_state() & Session::Loading) {
131                 _session.StateReady.connect_same_thread (*this, boost::bind (&AudioTrack::set_state_part_two, this));
132         } else {
133                 set_state_part_two ();
134         }
135
136         return 0;
137 }
138
139 XMLNode&
140 AudioTrack::state (bool full_state)
141 {
142         XMLNode& root (Track::state(full_state));
143         XMLNode* freeze_node;
144
145         if (_freeze_record.playlist) {
146                 XMLNode* inode;
147
148                 freeze_node = new XMLNode (X_("freeze-info"));
149                 freeze_node->set_property ("playlist", _freeze_record.playlist->name());
150                 freeze_node->set_property ("state", _freeze_record.state);
151
152                 for (vector<FreezeRecordProcessorInfo*>::iterator i = _freeze_record.processor_info.begin(); i != _freeze_record.processor_info.end(); ++i) {
153                         inode = new XMLNode (X_("processor"));
154                         inode->set_property (X_ ("id"), (*i)->id.to_s ());
155                         inode->add_child_copy ((*i)->state);
156
157                         freeze_node->add_child_nocopy (*inode);
158                 }
159
160                 root.add_child_nocopy (*freeze_node);
161         }
162
163         root.set_property (X_("mode"), _mode);
164
165         return root;
166 }
167
168 void
169 AudioTrack::set_state_part_two ()
170 {
171         XMLNode* fnode;
172         XMLProperty const * prop;
173
174         /* This is called after all session state has been restored but before
175            have been made ports and connections are established.
176         */
177
178         if (pending_state == 0) {
179                 return;
180         }
181
182         if ((fnode = find_named_node (*pending_state, X_("freeze-info"))) != 0) {
183
184                 _freeze_record.state = Frozen;
185
186                 for (vector<FreezeRecordProcessorInfo*>::iterator i = _freeze_record.processor_info.begin(); i != _freeze_record.processor_info.end(); ++i) {
187                         delete *i;
188                 }
189                 _freeze_record.processor_info.clear ();
190
191                 if ((prop = fnode->property (X_("playlist"))) != 0) {
192                         boost::shared_ptr<Playlist> pl = _session.playlists->by_name (prop->value());
193                         if (pl) {
194                                 _freeze_record.playlist = boost::dynamic_pointer_cast<AudioPlaylist> (pl);
195                                 _freeze_record.playlist->use();
196                         } else {
197                                 _freeze_record.playlist.reset ();
198                                 _freeze_record.state = NoFreeze;
199                         return;
200                         }
201                 }
202
203                 fnode->get_property (X_("state"), _freeze_record.state);
204
205                 XMLNodeConstIterator citer;
206                 XMLNodeList clist = fnode->children();
207
208                 for (citer = clist.begin(); citer != clist.end(); ++citer) {
209                         if ((*citer)->name() != X_("processor")) {
210                                 continue;
211                         }
212
213                         if ((prop = (*citer)->property (X_("id"))) == 0) {
214                                 continue;
215                         }
216
217                         FreezeRecordProcessorInfo* frii = new FreezeRecordProcessorInfo (*((*citer)->children().front()),
218                                                                                    boost::shared_ptr<Processor>());
219                         frii->id = prop->value ();
220                         _freeze_record.processor_info.push_back (frii);
221                 }
222         }
223 }
224
225 int
226 AudioTrack::export_stuff (BufferSet& buffers, samplepos_t start, samplecnt_t nframes,
227                           boost::shared_ptr<Processor> endpoint, bool include_endpoint, bool for_export, bool for_freeze)
228 {
229         boost::scoped_array<gain_t> gain_buffer (new gain_t[nframes]);
230         boost::scoped_array<Sample> mix_buffer (new Sample[nframes]);
231
232         Glib::Threads::RWLock::ReaderLock rlock (_processor_lock);
233
234         boost::shared_ptr<AudioPlaylist> apl = boost::dynamic_pointer_cast<AudioPlaylist>(playlist());
235
236         assert(apl);
237         assert(buffers.count().n_audio() >= 1);
238         assert ((samplecnt_t) buffers.get_audio(0).capacity() >= nframes);
239
240         if (apl->read (buffers.get_audio(0).data(), mix_buffer.get(), gain_buffer.get(), start, nframes) != nframes) {
241                 return -1;
242         }
243
244         uint32_t n=1;
245         Sample* b = buffers.get_audio(0).data();
246         BufferSet::audio_iterator bi = buffers.audio_begin();
247         ++bi;
248         for ( ; bi != buffers.audio_end(); ++bi, ++n) {
249                 if (n < _disk_reader->output_streams().n_audio()) {
250                         if (apl->read (bi->data(), mix_buffer.get(), gain_buffer.get(), start, nframes, n) != nframes) {
251                                 return -1;
252                         }
253                         b = bi->data();
254                 } else {
255                         /* duplicate last across remaining buffers */
256                         memcpy (bi->data(), b, sizeof (Sample) * nframes);
257                 }
258         }
259
260         bounce_process (buffers, start, nframes, endpoint, include_endpoint, for_export, for_freeze);
261
262         return 0;
263 }
264
265 bool
266 AudioTrack::bounceable (boost::shared_ptr<Processor> endpoint, bool include_endpoint) const
267 {
268         if (!endpoint && !include_endpoint) {
269                 /* no processing - just read from the playlist and create new
270                    files: always possible.
271                 */
272                 return true;
273         }
274
275         Glib::Threads::RWLock::ReaderLock lm (_processor_lock);
276         uint32_t naudio = n_inputs().n_audio();
277
278         for (ProcessorList::const_iterator r = _processors.begin(); r != _processors.end(); ++r) {
279
280                 /* if we're not including the endpoint, potentially stop
281                    right here before we test matching i/o valences.
282                 */
283
284                 if (!include_endpoint && (*r) == endpoint) {
285                         return true;
286                 }
287
288                 /* ignore any processors that do routing, because we will not
289                  * use them during a bounce/freeze/export operation.
290                  */
291
292                 if ((*r)->does_routing()) {
293                         continue;
294                 }
295
296                 /* does the output from the last considered processor match the
297                  * input to this one?
298                  */
299
300                 if (naudio != (*r)->input_streams().n_audio()) {
301                         return false;
302                 }
303
304                 /* we're including the endpoint - if we just hit it,
305                    then stop.
306                 */
307
308                 if ((*r) == endpoint) {
309                         return true;
310                 }
311
312                 /* save outputs of this processor to test against inputs
313                    of the next one.
314                 */
315
316                 naudio = (*r)->output_streams().n_audio();
317         }
318
319         return true;
320 }
321
322 boost::shared_ptr<Region>
323 AudioTrack::bounce (InterThreadInfo& itt)
324 {
325         return bounce_range (_session.current_start_sample(), _session.current_end_sample(), itt, main_outs(), false);
326 }
327
328 boost::shared_ptr<Region>
329 AudioTrack::bounce_range (samplepos_t start, samplepos_t end, InterThreadInfo& itt,
330                           boost::shared_ptr<Processor> endpoint, bool include_endpoint)
331 {
332         vector<boost::shared_ptr<Source> > srcs;
333         return _session.write_one_track (*this, start, end, false, srcs, itt, endpoint, include_endpoint, false, false);
334 }
335
336 void
337 AudioTrack::freeze_me (InterThreadInfo& itt)
338 {
339         vector<boost::shared_ptr<Source> > srcs;
340         string new_playlist_name;
341         boost::shared_ptr<Playlist> new_playlist;
342         string dir;
343         string region_name;
344
345         if ((_freeze_record.playlist = boost::dynamic_pointer_cast<AudioPlaylist>(playlist())) == 0) {
346                 return;
347         }
348
349         uint32_t n = 1;
350
351         while (n < (UINT_MAX-1)) {
352
353                 string candidate;
354
355                 candidate = string_compose ("<F%2>%1", _freeze_record.playlist->name(), n);
356
357                 if (_session.playlists->by_name (candidate) == 0) {
358                         new_playlist_name = candidate;
359                         break;
360                 }
361
362                 ++n;
363
364         }
365
366         if (n == (UINT_MAX-1)) {
367           error << string_compose (X_("There are too many frozen versions of playlist \"%1\""
368                             " to create another one"), _freeze_record.playlist->name())
369                << endmsg;
370                 return;
371         }
372
373         boost::shared_ptr<Region> res;
374
375         if ((res = _session.write_one_track (*this, _session.current_start_sample(), _session.current_end_sample(),
376                                         true, srcs, itt, main_outs(), false, false, true)) == 0) {
377                 return;
378         }
379
380         _freeze_record.processor_info.clear ();
381
382         {
383                 Glib::Threads::RWLock::ReaderLock lm (_processor_lock);
384
385                 for (ProcessorList::iterator r = _processors.begin(); r != _processors.end(); ++r) {
386
387                         if ((*r)->does_routing() && (*r)->active()) {
388                                 break;
389                         }
390                         if (!boost::dynamic_pointer_cast<PeakMeter>(*r)) {
391
392                                 FreezeRecordProcessorInfo* frii  = new FreezeRecordProcessorInfo ((*r)->get_state(), (*r));
393
394                                 frii->id = (*r)->id();
395
396                                 _freeze_record.processor_info.push_back (frii);
397
398                                 /* now deactivate the processor, */
399                                 if (!boost::dynamic_pointer_cast<Amp>(*r)) {
400                                         (*r)->deactivate ();
401                                 }
402                         }
403
404                         _session.set_dirty ();
405                 }
406         }
407
408         new_playlist = PlaylistFactory::create (DataType::AUDIO, _session, new_playlist_name, false);
409
410         /* XXX need main outs automation state _freeze_record.pan_automation_state = _mainpanner->automation_state(); */
411
412         region_name = new_playlist_name;
413
414         /* create a new region from all filesources, keep it private */
415
416         PropertyList plist;
417
418         plist.add (Properties::start, 0);
419         plist.add (Properties::length, srcs[0]->length(srcs[0]->timeline_position()));
420         plist.add (Properties::name, region_name);
421         plist.add (Properties::whole_file, true);
422
423         boost::shared_ptr<Region> region (RegionFactory::create (srcs, plist, false));
424
425         new_playlist->set_orig_track_id (id());
426         new_playlist->add_region (region, _session.current_start_sample());
427         new_playlist->set_frozen (true);
428         region->set_locked (true);
429
430         use_playlist (DataType::AUDIO, boost::dynamic_pointer_cast<AudioPlaylist>(new_playlist));
431         _disk_writer->set_record_enabled (false);
432
433         _freeze_record.playlist->use(); // prevent deletion
434
435         /* reset stuff that has already been accounted for in the freeze process */
436
437         gain_control()->set_value (GAIN_COEFF_UNITY, Controllable::NoGroup);
438         gain_control()->set_automation_state (Off);
439
440         /* XXX need to use _main_outs _panner->set_automation_state (Off); */
441
442         _freeze_record.state = Frozen;
443         FreezeChange(); /* EMIT SIGNAL */
444 }
445
446 void
447 AudioTrack::unfreeze ()
448 {
449         if (_freeze_record.playlist) {
450                 _freeze_record.playlist->release();
451                 use_playlist (DataType::AUDIO, _freeze_record.playlist);
452
453                 {
454                         Glib::Threads::RWLock::ReaderLock lm (_processor_lock); // should this be a write lock? jlc
455                         for (ProcessorList::iterator i = _processors.begin(); i != _processors.end(); ++i) {
456                                 for (vector<FreezeRecordProcessorInfo*>::iterator ii = _freeze_record.processor_info.begin(); ii != _freeze_record.processor_info.end(); ++ii) {
457                                         if ((*ii)->id == (*i)->id()) {
458                                                 (*i)->set_state (((*ii)->state), Stateful::current_state_version);
459                                                 break;
460                                         }
461                                 }
462                         }
463                 }
464
465                 _freeze_record.playlist.reset ();
466                 /* XXX need to use _main_outs _panner->set_automation_state (_freeze_record.pan_automation_state); */
467         }
468
469         _freeze_record.state = UnFrozen;
470         FreezeChange (); /* EMIT SIGNAL */
471 }
472
473 boost::shared_ptr<AudioFileSource>
474 AudioTrack::write_source (uint32_t n)
475 {
476         assert (_disk_writer);
477         return _disk_writer->audio_write_source (n);
478 }