StormByte-Multimedia 3.3.2
C++26 multimedia processing module of the StormByte suite
Loading...
Searching...
No Matches
rubberband.hxx
Go to the documentation of this file.
1/*
2 * Copyright (C) 2024-2026 David C. Manuelda (StormBytePP)
3 *
4 * This file is part of StormByte-Multimedia.
5 *
6 * StormByte-Multimedia original source is dual-licensed:
7 *
8 * 1. GNU Lesser General Public License v3.0 (or later)
9 * You may redistribute and/or modify this file under the terms of the
10 * GNU Lesser General Public License as published by the Free Software
11 * Foundation, either version 3 of the License, or (at your option)
12 * any later version.
13 *
14 * 2. Commercial license
15 * Alternatively, this file may be used under the terms of a commercial
16 * license agreement with the copyright holder
17 * (David C. Manuelda <StormByte@gmail.com>).
18 *
19 * Both licenses apply only to original StormByte-Multimedia source in this
20 * file. Third-party components — including FFmpeg and embedded trained data —
21 * remain under their own licenses and are not covered by the commercial grant.
22 *
23 * A written StormByte commercial agreement may license this original source
24 * on terms other than the LGPL, including specific use, distribution or
25 * linking arrangements such as static linking, as stated in that agreement.
26 * It does not grant rights to dependencies or waive their license conditions.
27 * Enabling WITH_GPL or WITH_NONFREE may include components with separate
28 * obligations for modification, linking (static or dynamic), redistribution
29 * or works that incorporate them. The person modifying, linking, packaging or
30 * distributing the resulting work is responsible for determining and meeting
31 * all applicable requirements, including any needed patent permissions.
32 * A StormByte commercial agreement does not provide those rights for GPL or
33 * nonfree components.
34 *
35 * Neither license grants any patent rights. Any patent licenses required
36 * to use this software or third-party components must be obtained separately
37 * from the patent holders.
38 *
39 * StormByte-Multimedia is distributed in the hope that it will be useful,
40 * but WITHOUT ANY WARRANTY; without even the implied warranty of
41 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
42 * GNU Lesser General Public License for more details.
43 *
44 * You should have received a copy of the GNU Lesser General Public License
45 * version 3 along with StormByte-Multimedia. If not, see
46 * <https://www.gnu.org/licenses/lgpl-3.0.html>.
47 *
48 * SPDX-License-Identifier: LGPL-3.0-or-later OR LicenseRef-StormByte-Commercial
49 */
50
51#pragma once
52
53#include <StormByte/logger/log.hxx>
57#include <StormByte/safe/optional.hxx>
58#include <StormByte/safe/pointers.hxx>
59#include <StormByte/safe/string.hxx>
60
61#include <memory>
62
100 public:
108 Safe::Optional<double> tempo = {},
109 Safe::Optional<double> pitch = {});
110
115 Rubberband(const Rubberband& other) = delete;
116
121 Rubberband(Rubberband&& other) noexcept = delete;
122
126 ~Rubberband() noexcept override;
127
133 Rubberband& operator=(const Rubberband& other) = delete;
134
140 Rubberband& operator=(Rubberband&& other) noexcept = delete;
141
146 enum StormByte::Multimedia::Type Media() const noexcept override;
147
151 void Clean() noexcept override;
152
156 void Setup() noexcept override;
157
162 void Process(const Pipeline::Frame& frame) noexcept override;
163
167 void Eof() noexcept override;
168
169 private:
174 Safe::String Chain() const;
175
176 Safe::Optional<double> m_tempoIn;
177 Safe::Optional<double> m_pitchIn;
178 StormByte::Safe::Unique<StormByte::Multimedia::FFmpeg::AVFilterGraph> m_graph;
179 };
180}
181
STORMBYTE_DECLARE_MAYBE_SAFE(StormByte::Buffer::Bridge)
Rubberband(Safe::Shared< StormByte::Logger::Log > log, Safe::Optional< double > tempo={}, Safe::Optional< double > pitch={})
Rubber Band tempo / pitch (rubberband).
Rubberband(const Rubberband &other)=delete
Copy construction is disabled.
Rubberband(Rubberband &&other) noexcept=delete
Move construction is disabled.
~Rubberband() noexcept override
Releases the provider-owned graph.
void Clean() noexcept override
Drops the cached graph.
void Process(const Pipeline::Frame &frame) noexcept override
Pushes one audio frame through rubberband and Save.
enum StormByte::Multimedia::Type Media() const noexcept override
Media this filter handles.
void Eof() noexcept override
Drains samples still held by the stretcher.
void Setup() noexcept override
Resets the graph before the first frame.
FFmpeg(const FFmpeg &other)=delete
Copy is not allowed.
One-pass filter that mutates decoded frames.
Definition ffmpeg.hxx:844
One decoded access unit.
Definition frame.hxx:103
Multimedia module of the StormByte suite.
Pipeline Demux / decode / filter / encode / mux types.
Root namespace of the StormByte C++ suite.
#define STORMBYTE_MULTIMEDIA_PUBLIC
Definition visibility.h:61