File: playback.h

package info (click to toggle)
lsp-plugins 1.2.5-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 91,856 kB
  • sloc: cpp: 427,831; xml: 57,779; makefile: 9,961; php: 1,005; sh: 18
file content (128 lines) | stat: -rw-r--r-- 5,354 bytes parent folder | download
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
/*
 * Copyright (C) 2022 Linux Studio Plugins Project <https://lsp-plug.in/>
 *           (C) 2022 Vladimir Sadovnikov <sadko4u@gmail.com>
 *
 * This file is part of lsp-dsp-units
 * Created on: 24 нояб. 2022 г.
 *
 * lsp-dsp-units is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * any later version.
 *
 * lsp-dsp-units is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with lsp-dsp-units. If not, see <https://www.gnu.org/licenses/>.
 */

#ifndef LSP_PLUG_IN_DSP_UNITS_SAMPLING_HELPERS_PLAYBACK_H_
#define LSP_PLUG_IN_DSP_UNITS_SAMPLING_HELPERS_PLAYBACK_H_

#include <lsp-plug.in/dsp-units/version.h>

#include <lsp-plug.in/common/types.h>
#include <lsp-plug.in/dsp-units/iface/IStateDumper.h>
#include <lsp-plug.in/dsp-units/sampling/helpers/batch.h>
#include <lsp-plug.in/dsp-units/sampling/types.h>
#include <lsp-plug.in/dsp-units/sampling/Sample.h>
#include <lsp-plug.in/dsp-units/sampling/PlaySettings.h>

namespace lsp
{
    namespace dspu
    {
        namespace playback
        {
            /**
             * The actual state of the playback of the sample
             */
            enum playback_state_t
            {
                STATE_NONE,                     // No active state
                STATE_PLAY,                     // Regular play
                STATE_STOP,                     // Playback till the end of the sample, do not loop
                STATE_CANCEL                    // Immediately cancel the playback
            };

            /**
             * Low-level data structure that holds the state of the finite machine
             * that introduces the playback of the single sample
             */
            typedef struct playback_t
            {
                wsize_t             nTimestamp;     // The actual playback timestamp in stamples
                wsize_t             nCancelTime;    // The actual cancel timestamp
                Sample             *pSample;        // Pointer to the sample
                size_t              nSerial;        // Serial version of playback object
                ssize_t             nID;            // ID of instrument
                size_t              nChannel;       // Channel to play
                playback_state_t    enState;        // State of the playback
                float               fVolume;        // The volume of the sample
                bool                bReverse;       // The reverse playback flag
                ssize_t             nPosition;      // Current playback position
                size_t              nFadeout;       // Fadeout length for cancelling
                sample_loop_t       enLoopMode;     // Loop mode
                size_t              nLoopStart;     // Start of the loop
                size_t              nLoopEnd;       // End of the loop
                size_t              nXFade;         // The crossfade time in stamples
                sample_crossfade_t  enXFadeType;    // The crossfade type
                play_batch_t        sBatch[2];      // Batch queue for execution
            } playback_t;

            LSP_DSP_UNITS_PUBLIC
            void        compute_initial_batch(playback_t *pb, const PlaySettings *settings);

            LSP_DSP_UNITS_PUBLIC
            void        compute_next_batch(playback_t *pb);

            LSP_DSP_UNITS_PUBLIC
            void        recompute_next_batch(playback_t *pb);

            LSP_DSP_UNITS_PUBLIC
            void        complete_current_batch(playback_t *pb);

            LSP_DSP_UNITS_PUBLIC
            size_t      execute_batch(float *dst, const batch_t *b, playback_t *pb, size_t samples);

            LSP_DSP_UNITS_PUBLIC
            size_t      apply_fade_out(float *dst, playback_t *pb, size_t samples);


            LSP_DSP_UNITS_PUBLIC
            void        clear_playback(playback_t *pb);

            LSP_DSP_UNITS_PUBLIC
            void        reset_playback(playback_t *pb);

            LSP_DSP_UNITS_PUBLIC
            void        start_playback(playback_t *pb, Sample *sample, const PlaySettings *settings);

            LSP_DSP_UNITS_PUBLIC
            size_t      process_playback(float *dst, playback_t *pb, size_t samples);

            LSP_DSP_UNITS_PUBLIC
            void        stop_playback(playback_t *pb, size_t delay = 0);

            LSP_DSP_UNITS_PUBLIC
            bool        cancel_playback(playback_t *pb, size_t fadeout = 0, size_t delay = 0);

            LSP_DSP_UNITS_PUBLIC
            void        dump_playback_plain(IStateDumper *v, const playback_t *pb);

            LSP_DSP_UNITS_PUBLIC
            void        dump_playback(IStateDumper *v, const playback_t *pb);

            LSP_DSP_UNITS_PUBLIC
            void        dump_playback(IStateDumper *v, const char *name, const playback_t *pb);

        } /* namespace playback */
    } /* namespace dspu */
} /* namespace lsp */



#endif /* LSP_PLUG_IN_DSP_UNITS_SAMPLING_HELPERS_PLAYBACK_H_ */