e5eeb987fa
I will implement the more complex setup of providing options for most of the configuration that Rubber Band provides, at a later date, when I feel like creating a complex configuration dialog for it, and asking for help translating every option and setting. Signed-off-by: Christopher Snowhill <kode54@gmail.com>
216 lines
8.1 KiB
C
216 lines
8.1 KiB
C
|
|
/* -*- c-basic-offset: 4 indent-tabs-mode: nil -*- vi:set ts=8 sts=4 sw=4: */
|
|
|
|
/*
|
|
Rubber Band Library
|
|
An audio time-stretching and pitch-shifting library.
|
|
Copyright 2007-2024 Particular Programs Ltd.
|
|
|
|
This program is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU General Public License as
|
|
published by the Free Software Foundation; either version 2 of the
|
|
License, or (at your option) any later version. See the file
|
|
COPYING included with this distribution for more information.
|
|
|
|
Alternatively, if you have a valid commercial licence for the
|
|
Rubber Band Library obtained by agreement with the copyright
|
|
holders, you may redistribute and/or modify it under the terms
|
|
described in that licence.
|
|
|
|
If you wish to distribute code using the Rubber Band Library
|
|
under terms other than those of the GNU General Public License,
|
|
you must obtain a valid commercial licence before doing so.
|
|
*/
|
|
|
|
#ifndef RUBBERBAND_C_API_H
|
|
#define RUBBERBAND_C_API_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#define RUBBERBAND_VERSION "4.0.0"
|
|
#define RUBBERBAND_API_MAJOR_VERSION 3
|
|
#define RUBBERBAND_API_MINOR_VERSION 0
|
|
|
|
#undef RB_EXTERN
|
|
#ifdef _MSC_VER
|
|
#ifndef RUBBERBAND_STATIC
|
|
#define RB_EXTERN extern __declspec(dllexport)
|
|
#else
|
|
#define RB_EXTERN extern
|
|
#endif
|
|
#else
|
|
#define RB_EXTERN extern
|
|
#endif
|
|
|
|
/**
|
|
* This is a C-linkage interface to the Rubber Band time stretcher.
|
|
*
|
|
* This is a wrapper interface: the primary interface is in C++ and is
|
|
* defined and documented in RubberBandStretcher.h and
|
|
* RubberBandLiveShifter.h. The library itself is implemented in C++,
|
|
* and requires C++ standard library support even when using the
|
|
* C-linkage API.
|
|
*
|
|
* Please see RubberBandStretcher.h and RubberBandLiveShifter.h for
|
|
* documentation.
|
|
*
|
|
* If you are writing to the C++ API, do not include this header.
|
|
*/
|
|
|
|
enum RubberBandOption {
|
|
|
|
RubberBandOptionProcessOffline = 0x00000000,
|
|
RubberBandOptionProcessRealTime = 0x00000001,
|
|
|
|
RubberBandOptionStretchElastic = 0x00000000, // obsolete
|
|
RubberBandOptionStretchPrecise = 0x00000010, // obsolete
|
|
|
|
RubberBandOptionTransientsCrisp = 0x00000000,
|
|
RubberBandOptionTransientsMixed = 0x00000100,
|
|
RubberBandOptionTransientsSmooth = 0x00000200,
|
|
|
|
RubberBandOptionDetectorCompound = 0x00000000,
|
|
RubberBandOptionDetectorPercussive = 0x00000400,
|
|
RubberBandOptionDetectorSoft = 0x00000800,
|
|
|
|
RubberBandOptionPhaseLaminar = 0x00000000,
|
|
RubberBandOptionPhaseIndependent = 0x00002000,
|
|
|
|
RubberBandOptionThreadingAuto = 0x00000000,
|
|
RubberBandOptionThreadingNever = 0x00010000,
|
|
RubberBandOptionThreadingAlways = 0x00020000,
|
|
|
|
RubberBandOptionWindowStandard = 0x00000000,
|
|
RubberBandOptionWindowShort = 0x00100000,
|
|
RubberBandOptionWindowLong = 0x00200000,
|
|
|
|
RubberBandOptionSmoothingOff = 0x00000000,
|
|
RubberBandOptionSmoothingOn = 0x00800000,
|
|
|
|
RubberBandOptionFormantShifted = 0x00000000,
|
|
RubberBandOptionFormantPreserved = 0x01000000,
|
|
|
|
RubberBandOptionPitchHighSpeed = 0x00000000,
|
|
RubberBandOptionPitchHighQuality = 0x02000000,
|
|
RubberBandOptionPitchHighConsistency = 0x04000000,
|
|
|
|
RubberBandOptionChannelsApart = 0x00000000,
|
|
RubberBandOptionChannelsTogether = 0x10000000,
|
|
|
|
RubberBandOptionEngineFaster = 0x00000000,
|
|
RubberBandOptionEngineFiner = 0x20000000
|
|
};
|
|
|
|
typedef int RubberBandOptions;
|
|
|
|
struct RubberBandState_;
|
|
typedef struct RubberBandState_ *RubberBandState;
|
|
|
|
RB_EXTERN RubberBandState rubberband_new(unsigned int sampleRate,
|
|
unsigned int channels,
|
|
RubberBandOptions options,
|
|
double initialTimeRatio,
|
|
double initialPitchScale);
|
|
|
|
RB_EXTERN void rubberband_delete(RubberBandState);
|
|
|
|
RB_EXTERN void rubberband_reset(RubberBandState);
|
|
|
|
RB_EXTERN int rubberband_get_engine_version(RubberBandState);
|
|
|
|
RB_EXTERN void rubberband_set_time_ratio(RubberBandState, double ratio);
|
|
RB_EXTERN void rubberband_set_pitch_scale(RubberBandState, double scale);
|
|
|
|
RB_EXTERN double rubberband_get_time_ratio(const RubberBandState);
|
|
RB_EXTERN double rubberband_get_pitch_scale(const RubberBandState);
|
|
|
|
RB_EXTERN void rubberband_set_formant_scale(RubberBandState, double scale);
|
|
RB_EXTERN double rubberband_get_formant_scale(const RubberBandState);
|
|
|
|
RB_EXTERN unsigned int rubberband_get_preferred_start_pad(const RubberBandState);
|
|
RB_EXTERN unsigned int rubberband_get_start_delay(const RubberBandState);
|
|
RB_EXTERN unsigned int rubberband_get_latency(const RubberBandState);
|
|
|
|
RB_EXTERN void rubberband_set_transients_option(RubberBandState, RubberBandOptions options);
|
|
RB_EXTERN void rubberband_set_detector_option(RubberBandState, RubberBandOptions options);
|
|
RB_EXTERN void rubberband_set_phase_option(RubberBandState, RubberBandOptions options);
|
|
RB_EXTERN void rubberband_set_formant_option(RubberBandState, RubberBandOptions options);
|
|
RB_EXTERN void rubberband_set_pitch_option(RubberBandState, RubberBandOptions options);
|
|
|
|
RB_EXTERN void rubberband_set_expected_input_duration(RubberBandState, unsigned int samples);
|
|
|
|
RB_EXTERN unsigned int rubberband_get_samples_required(const RubberBandState);
|
|
|
|
RB_EXTERN void rubberband_set_max_process_size(RubberBandState, unsigned int samples);
|
|
RB_EXTERN unsigned int rubberband_get_process_size_limit(RubberBandState);
|
|
|
|
RB_EXTERN void rubberband_set_key_frame_map(RubberBandState, unsigned int keyframecount, unsigned int *from, unsigned int *to);
|
|
|
|
RB_EXTERN void rubberband_study(RubberBandState, const float *const *input, unsigned int samples, int final);
|
|
RB_EXTERN void rubberband_process(RubberBandState, const float *const *input, unsigned int samples, int final);
|
|
|
|
RB_EXTERN int rubberband_available(const RubberBandState);
|
|
RB_EXTERN unsigned int rubberband_retrieve(const RubberBandState, float *const *output, unsigned int samples);
|
|
|
|
RB_EXTERN unsigned int rubberband_get_channel_count(const RubberBandState);
|
|
|
|
RB_EXTERN void rubberband_calculate_stretch(RubberBandState);
|
|
|
|
RB_EXTERN void rubberband_set_debug_level(RubberBandState, int level);
|
|
RB_EXTERN void rubberband_set_default_debug_level(int level);
|
|
|
|
|
|
enum RubberBandLiveOption {
|
|
|
|
RubberBandLiveOptionWindowShort = 0x00000000,
|
|
RubberBandLiveOptionWindowMedium = 0x00100000,
|
|
|
|
RubberBandLiveOptionFormantShifted = 0x00000000,
|
|
RubberBandLiveOptionFormantPreserved = 0x01000000,
|
|
|
|
RubberBandLiveOptionChannelsApart = 0x00000000,
|
|
RubberBandLiveOptionChannelsTogether = 0x10000000
|
|
};
|
|
|
|
typedef int RubberBandLiveOptions;
|
|
|
|
struct RubberBandLiveState_;
|
|
typedef struct RubberBandLiveState_ *RubberBandLiveState;
|
|
|
|
RB_EXTERN RubberBandLiveState rubberband_live_new(unsigned int sampleRate,
|
|
unsigned int channels,
|
|
RubberBandOptions options);
|
|
|
|
RB_EXTERN void rubberband_live_delete(RubberBandLiveState);
|
|
|
|
RB_EXTERN void rubberband_live_reset(RubberBandLiveState);
|
|
|
|
RB_EXTERN void rubberband_live_set_pitch_scale(RubberBandLiveState, double scale);
|
|
RB_EXTERN double rubberband_live_get_pitch_scale(const RubberBandLiveState);
|
|
|
|
RB_EXTERN void rubberband_live_set_formant_scale(RubberBandLiveState, double scale);
|
|
RB_EXTERN double rubberband_live_get_formant_scale(const RubberBandLiveState);
|
|
|
|
RB_EXTERN unsigned int rubberband_live_get_start_delay(const RubberBandLiveState);
|
|
|
|
RB_EXTERN void rubberband_live_set_formant_option(RubberBandLiveState, RubberBandOptions options);
|
|
|
|
RB_EXTERN unsigned int rubberband_live_get_block_size(RubberBandLiveState);
|
|
|
|
RB_EXTERN void rubberband_live_shift(RubberBandLiveState, const float *const *input, float *const *output);
|
|
|
|
RB_EXTERN unsigned int rubberband_live_get_channel_count(const RubberBandLiveState);
|
|
|
|
RB_EXTERN void rubberband_live_set_debug_level(RubberBandLiveState, int level);
|
|
RB_EXTERN void rubberband_live_set_default_debug_level(int level);
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#undef RB_EXTERN
|
|
|
|
#endif
|