File: AudioGraphTask.h

package info (click to toggle)
audacity 3.7.3%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 125,252 kB
  • sloc: cpp: 358,238; ansic: 75,458; lisp: 7,761; sh: 3,410; python: 1,503; xml: 1,385; perl: 854; makefile: 122
file content (54 lines) | stat: -rw-r--r-- 1,199 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
/**********************************************************************

  Audacity: A Digital Audio Editor

  @file AudioGraphTask.h

  Dominic Mazzoni
  Vaughan Johnson

  Paul Licameli split from PerTrackEffect.h

**********************************************************************/

#ifndef __AUDACITY_AUDIO_GRAPH_TASK__
#define __AUDACITY_AUDIO_GRAPH_TASK__

namespace AudioGraph {

class Buffers;
class Sink;
class Source;

//! Copies from a Source to a Sink, mediated by Buffers
struct AUDIO_GRAPH_API Task {
public:
   /*!
    @pre `source.AcceptsBlockSize(buffers.BlockSize())`
    @pre `source.AcceptsBuffers(buffers)`
    @pre `sink.AcceptsBuffers(buffers)`
    */
   Task(Source &source, Buffers &buffers, Sink &sink);
   enum class Status { More, Done, Fail };
   //! Do an increment of the copy
   Status RunOnce();
   //! Do the complete copy
   /*!
    @return success
    @pre `mBuffers.Remaining() >= mBuffers.BlockSize()`
    @post result:  `result == Status::Fail ||
       mBuffers.Remaining() >= mBuffers.BlockSize()`
    */
   bool RunLoop();
private:
   Source &mSource;
   Buffers &mBuffers;
   Sink &mSink;

#ifndef NDEBUG
   bool mRanOnce{ false };
#endif
};

}
#endif