Go to the documentation of this file.
   58     const LADSPA_Descriptor *
desc;
 
   72 #define OFFSET(x) offsetof(LADSPAContext, x) 
   73 #define FLAGS AV_OPT_FLAG_AUDIO_PARAM | AV_OPT_FLAG_FILTERING_PARAM 
   83     { 
"nb_samples", 
"set the number of samples per requested frame", 
OFFSET(nb_samples), 
AV_OPT_TYPE_INT, {.i64=1024}, 1, INT_MAX, 
FLAGS },
 
   98     for (
int ctl = 0; ctl < 
s->nb_outputcontrols; ctl++) {
 
  102         latency = 
lrintf(
s->octlv[ctl]);
 
  113     const LADSPA_PortRangeHint *
h = 
s->desc->PortRangeHints + 
map[ctl];
 
  117     if (LADSPA_IS_HINT_TOGGLED(
h->HintDescriptor)) {
 
  120         if (LADSPA_IS_HINT_HAS_DEFAULT(
h->HintDescriptor))
 
  123         if (LADSPA_IS_HINT_INTEGER(
h->HintDescriptor)) {
 
  126             if (LADSPA_IS_HINT_BOUNDED_BELOW(
h->HintDescriptor))
 
  129             if (LADSPA_IS_HINT_BOUNDED_ABOVE(
h->HintDescriptor))
 
  134             else if (LADSPA_IS_HINT_HAS_DEFAULT(
h->HintDescriptor))
 
  139             if (LADSPA_IS_HINT_BOUNDED_BELOW(
h->HintDescriptor))
 
  142             if (LADSPA_IS_HINT_BOUNDED_ABOVE(
h->HintDescriptor))
 
  147             else if (LADSPA_IS_HINT_HAS_DEFAULT(
h->HintDescriptor))
 
  151         if (LADSPA_IS_HINT_SAMPLE_RATE(
h->HintDescriptor))
 
  154         if (LADSPA_IS_HINT_LOGARITHMIC(
h->HintDescriptor))
 
  166     int i, 
h, p, new_out_samples;
 
  170     if (!
s->nb_outputs ||
 
  172          s->in_trim == 0 && 
s->out_pad == 0 &&
 
  173         !(
s->desc->Properties & LADSPA_PROPERTY_INPLACE_BROKEN))) {
 
  184     av_assert0(!
s->nb_outputs || 
out->channels == (
s->nb_outputs * 
s->nb_handles));
 
  186     for (
h = 0; 
h < 
s->nb_handles; 
h++) {
 
  187         for (
i = 0; 
i < 
s->nb_inputs; 
i++) {
 
  188             p = 
s->nb_handles > 1 ? 
h : 
i;
 
  189             s->desc->connect_port(
s->handles[
h], 
s->ipmap[
i],
 
  193         for (
i = 0; 
i < 
s->nb_outputs; 
i++) {
 
  194             p = 
s->nb_handles > 1 ? 
h : 
i;
 
  195             s->desc->connect_port(
s->handles[
h], 
s->opmap[
i],
 
  196                                   (LADSPA_Data*)
out->extended_data[p]);
 
  205     for (
i = 0; 
i < 
s->nb_outputcontrols; 
i++)
 
  211     new_out_samples = 
out->nb_samples;
 
  212     if (
s->in_trim > 0) {
 
  213         int trim = 
FFMIN(new_out_samples, 
s->in_trim);
 
  215         new_out_samples -= trim;
 
  219     if (new_out_samples <= 0) {
 
  222     } 
else if (new_out_samples < out->nb_samples) {
 
  223         int offset = 
out->nb_samples - new_out_samples;
 
  224         for (
int ch = 0; ch < 
out->channels; ch++)
 
  225             memmove(
out->extended_data[ch], 
out->extended_data[ch] + 
sizeof(
float) * 
offset,
 
  226                     sizeof(
float) * new_out_samples);
 
  227         out->nb_samples = new_out_samples;
 
  241     if (
ctx->nb_inputs) {
 
  249             s->out_pad -= 
frame->nb_samples;
 
  256     if (
s->duration >= 0 && t >= 
s->duration)
 
  263     for (
i = 0; 
i < 
s->nb_outputs; 
i++)
 
  264         s->desc->connect_port(
s->handles[0], 
s->opmap[
i],
 
  265                 (LADSPA_Data*)
out->extended_data[
i]);
 
  267     s->desc->run(
s->handles[0], 
s->nb_samples);
 
  269     for (
i = 0; 
i < 
s->nb_outputcontrols; 
i++)
 
  272     out->sample_rate = 
s->sample_rate;
 
  274     s->pts          += 
s->nb_samples;
 
  282     const LADSPA_PortRangeHint *
h = 
s->desc->PortRangeHints + 
map[ctl];
 
  283     const LADSPA_Data lower = 
h->LowerBound;
 
  284     const LADSPA_Data upper = 
h->UpperBound;
 
  286     if (LADSPA_IS_HINT_DEFAULT_MINIMUM(
h->HintDescriptor)) {
 
  288     } 
else if (LADSPA_IS_HINT_DEFAULT_MAXIMUM(
h->HintDescriptor)) {
 
  290     } 
else if (LADSPA_IS_HINT_DEFAULT_0(
h->HintDescriptor)) {
 
  292     } 
else if (LADSPA_IS_HINT_DEFAULT_1(
h->HintDescriptor)) {
 
  294     } 
else if (LADSPA_IS_HINT_DEFAULT_100(
h->HintDescriptor)) {
 
  296     } 
else if (LADSPA_IS_HINT_DEFAULT_440(
h->HintDescriptor)) {
 
  298     } 
else if (LADSPA_IS_HINT_DEFAULT_LOW(
h->HintDescriptor)) {
 
  299         if (LADSPA_IS_HINT_LOGARITHMIC(
h->HintDescriptor))
 
  300             values[ctl] = 
exp(log(lower) * 0.75 + log(upper) * 0.25);
 
  302             values[ctl] = lower * 0.75 + upper * 0.25;
 
  303     } 
else if (LADSPA_IS_HINT_DEFAULT_MIDDLE(
h->HintDescriptor)) {
 
  304         if (LADSPA_IS_HINT_LOGARITHMIC(
h->HintDescriptor))
 
  305             values[ctl] = 
exp(log(lower) * 0.5 + log(upper) * 0.5);
 
  307             values[ctl] = lower * 0.5 + upper * 0.5;
 
  308     } 
else if (LADSPA_IS_HINT_DEFAULT_HIGH(
h->HintDescriptor)) {
 
  309         if (LADSPA_IS_HINT_LOGARITHMIC(
h->HintDescriptor))
 
  310             values[ctl] = 
exp(log(lower) * 0.25 + log(upper) * 0.75);
 
  312             values[ctl] = lower * 0.25 + upper * 0.75;
 
  321     s->nb_handles = 
s->nb_inputs == 1 && 
s->nb_outputs == 1 ? 
link->
channels : 1;
 
  322     s->handles    = 
av_calloc(
s->nb_handles, 
sizeof(*
s->handles));
 
  326     for (
i = 0; 
i < 
s->nb_handles; 
i++) {
 
  328         if (!
s->handles[
i]) {
 
  334         for (j = 0; j < 
s->nb_inputcontrols; j++)
 
  335             s->desc->connect_port(
s->handles[
i], 
s->icmap[j], 
s->ictlv + j);
 
  338         for (j = 0; j < 
s->nb_outputcontrols; j++)
 
  339             s->desc->connect_port(
s->handles[
i], 
s->ocmap[j], &
s->octlv[j]);
 
  341         if (
s->desc->activate)
 
  342             s->desc->activate(
s->handles[
i]);
 
  363     if (
ctx->nb_inputs) {
 
  368         if (
s->nb_inputs == 
s->nb_outputs) {
 
  385                         unsigned long *nb_inputs, 
unsigned long *nb_outputs)
 
  387     LADSPA_PortDescriptor pd;
 
  390     for (
i = 0; 
i < 
desc->PortCount; 
i++) {
 
  391         pd = 
desc->PortDescriptors[
i];
 
  393         if (LADSPA_IS_PORT_AUDIO(pd)) {
 
  394             if (LADSPA_IS_PORT_INPUT(pd)) {
 
  396             } 
else if (LADSPA_IS_PORT_OUTPUT(pd)) {
 
  403 static void *
try_load(
const char *dir, 
const char *soname)
 
  409         ret = dlopen(path, RTLD_LOCAL|RTLD_NOW);
 
  419     const char *label = 
s->desc->Label;
 
  420     LADSPA_PortRangeHint *
h = (LADSPA_PortRangeHint *)
s->desc->PortRangeHints +
 
  423     if (port >= 
s->nb_inputcontrols) {
 
  425                port, 
s->nb_inputcontrols);
 
  429     if (LADSPA_IS_HINT_BOUNDED_BELOW(
h->HintDescriptor) &&
 
  430             value < h->LowerBound) {
 
  432                 "%s: input control c%ld is below lower boundary of %0.4f.\n",
 
  433                 label, port, 
h->LowerBound);
 
  437     if (LADSPA_IS_HINT_BOUNDED_ABOVE(
h->HintDescriptor) &&
 
  440                 "%s: input control c%ld is above upper boundary of %0.4f.\n",
 
  441                 label, port, 
h->UpperBound);
 
  453     LADSPA_Descriptor_Function descriptor_fn;
 
  454     const LADSPA_Descriptor *
desc;
 
  455     LADSPA_PortDescriptor pd;
 
  457     char *p, *
arg, *saveptr = 
NULL;
 
  458     unsigned long nb_ports;
 
  466     if (
s->dl_name[0] == 
'/' || 
s->dl_name[0] == 
'.') {
 
  468         s->dl_handle = dlopen(
s->dl_name, RTLD_LOCAL|RTLD_NOW);
 
  471         char *paths = 
av_strdup(getenv(
"LADSPA_PATH"));
 
  472         const char *home_path = getenv(
"HOME");
 
  473         const char *separator = 
":";
 
  477             while ((
arg = 
av_strtok(p, separator, &saveptr)) && !
s->dl_handle) {
 
  484         if (!
s->dl_handle && home_path && (paths = 
av_asprintf(
"%s/.ladspa", home_path))) {
 
  489         if (!
s->dl_handle && home_path && (paths = 
av_asprintf(
"%s/.ladspa/lib", home_path))) {
 
  495             s->dl_handle = 
try_load(
"/usr/local/lib/ladspa", 
s->dl_name);
 
  498             s->dl_handle = 
try_load(
"/usr/lib/ladspa", 
s->dl_name);
 
  505     descriptor_fn = dlsym(
s->dl_handle, 
"ladspa_descriptor");
 
  506     if (!descriptor_fn) {
 
  518         for (
i = 0; 
desc = descriptor_fn(
i); 
i++) {
 
  532             desc = descriptor_fn(
i);
 
  538             if (
desc->Label && !strcmp(
desc->Label, 
s->plugin))
 
  544     nb_ports = 
desc->PortCount;
 
  552     s->ctl_needs_value = 
av_calloc(nb_ports, 
sizeof(*
s->ctl_needs_value));
 
  553     if (!
s->ipmap || !
s->opmap || !
s->icmap ||
 
  554         !
s->ocmap || !
s->ictlv || !
s->octlv || !
s->ctl_needs_value)
 
  557     for (
i = 0; 
i < nb_ports; 
i++) {
 
  558         pd = 
desc->PortDescriptors[
i];
 
  560         if (LADSPA_IS_PORT_AUDIO(pd)) {
 
  561             if (LADSPA_IS_PORT_INPUT(pd)) {
 
  562                 s->ipmap[
s->nb_inputs] = 
i;
 
  564             } 
else if (LADSPA_IS_PORT_OUTPUT(pd)) {
 
  565                 s->opmap[
s->nb_outputs] = 
i;
 
  568         } 
else if (LADSPA_IS_PORT_CONTROL(pd)) {
 
  569             if (LADSPA_IS_PORT_INPUT(pd)) {
 
  570                 s->icmap[
s->nb_inputcontrols] = 
i;
 
  572                 if (LADSPA_IS_HINT_HAS_DEFAULT(
desc->PortRangeHints[
i].HintDescriptor))
 
  575                     s->ctl_needs_value[
s->nb_inputcontrols] = 1;
 
  577                 s->nb_inputcontrols++;
 
  578             } 
else if (LADSPA_IS_PORT_OUTPUT(pd)) {
 
  579                 s->ocmap[
s->nb_outputcontrols] = 
i;
 
  580                 s->nb_outputcontrols++;
 
  586     if (
s->options && !strcmp(
s->options, 
"help")) {
 
  587         if (!
s->nb_inputcontrols) {
 
  589                    "The '%s' plugin does not have any input controls.\n",
 
  593                    "The '%s' plugin has the following input controls:\n",
 
  595             for (
i = 0; 
i < 
s->nb_inputcontrols; 
i++)
 
  621         s->ctl_needs_value[
i] = 0;
 
  625     for (
i = 0; 
i < 
s->nb_inputcontrols; 
i++) {
 
  626         if (
s->ctl_needs_value[
i]) {
 
  648                               s->nb_inputs, 
s->nb_outputs);
 
  650                               s->nb_inputcontrols, 
s->nb_outputcontrols);
 
  677     if (
s->nb_inputs == 1 && 
s->nb_outputs == 1) {
 
  682     } 
else if (
s->nb_inputs == 2 && 
s->nb_outputs == 2) {
 
  693         if (
s->nb_inputs >= 1) {
 
  705             if (!
s->nb_outputs) {
 
  712         if (
s->nb_outputs >= 1) {
 
  733     for (
i = 0; 
i < 
s->nb_handles; 
i++) {
 
  734         if (
s->desc->deactivate)
 
  735             s->desc->deactivate(
s->handles[
i]);
 
  736         if (
s->desc->cleanup)
 
  737             s->desc->cleanup(
s->handles[
i]);
 
  741         dlclose(
s->dl_handle);
 
  754                            char *res, 
int res_len, 
int flags)
 
  778     .priv_class    = &ladspa_class,
 
  
static void * try_load(const char *dir, const char *soname)
 
AVFrame * ff_get_audio_buffer(AVFilterLink *link, int nb_samples)
Request an audio samples buffer with a specific set of permissions.
 
@ AV_SAMPLE_FMT_FLTP
float, planar
 
A list of supported channel layouts.
 
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later. That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another. Frame references ownership and permissions
 
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
 
static enum AVSampleFormat sample_fmts[]
 
enum MovChannelLayoutTag * layouts
 
#define AVERROR_EOF
End of file.
 
The exact code depends on how similar the blocks are and how related they are to the and needs to apply these operations to the correct inlink or outlink if there are several Macros are available to factor that when no extra processing is inlink
 
char * av_asprintf(const char *fmt,...)
 
int av_strcasecmp(const char *a, const char *b)
Locale-independent case-insensitive compare.
 
AVFILTER_DEFINE_CLASS(ladspa)
 
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
 
This structure describes decoded (raw) audio or video data.
 
#define FILTER_QUERY_FUNC(func)
 
int ff_request_frame(AVFilterLink *link)
Request an input frame from the filter at the other end of the link.
 
#define AV_LOG_VERBOSE
Detailed information.
 
static int config_output(AVFilterLink *outlink)
 
const char * name
Filter name.
 
static av_cold void uninit(AVFilterContext *ctx)
 
A link between two filters.
 
int channels
Number of channels.
 
static int process_command(AVFilterContext *ctx, const char *cmd, const char *args, char *res, int res_len, int flags)
 
static int connect_ports(AVFilterContext *ctx, AVFilterLink *link)
 
static int filter_frame(AVFilterLink *inlink, AVFrame *in)
 
const LADSPA_Descriptor * desc
 
static double val(void *priv, double ch)
 
static int request_frame(AVFilterLink *outlink)
 
#define AVFILTER_FLAG_DYNAMIC_INPUTS
The number of the filter inputs is not determined just by AVFilter.inputs.
 
#define AV_CH_LAYOUT_STEREO
 
A filter pad used for either input or output.
 
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
 
int channels
number of audio channels, only used for audio.
 
char * av_strtok(char *s, const char *delim, char **saveptr)
Split the string into several tokens which can be accessed by successive calls to av_strtok().
 
#define av_assert0(cond)
assert() equivalent, that is always enabled.
 
static const AVFilterPad outputs[]
 
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
 
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a link
 
int av_sscanf(const char *string, const char *format,...)
See libc sscanf manual for more information.
 
Describe the class of an AVClass context structure.
 
int av_frame_copy_props(AVFrame *dst, const AVFrame *src)
Copy only "metadata" fields from src to dst.
 
Rational number (pair of numerator and denominator).
 
int ff_append_inpad_free_name(AVFilterContext *f, AVFilterPad *p)
 
uint64_t channel_layout
channel layout of current buffer (see libavutil/channel_layout.h)
 
static void count_ports(const LADSPA_Descriptor *desc, unsigned long *nb_inputs, unsigned long *nb_outputs)
 
int(* filter_frame)(AVFilterLink *link, AVFrame *frame)
Filtering callback.
 
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several inputs
 
static int config_input(AVFilterLink *inlink)
 
static void print_ctl_info(AVFilterContext *ctx, int level, LADSPAContext *s, int ctl, unsigned long *map, LADSPA_Data *values, int print)
 
int(* config_props)(AVFilterLink *link)
Link configuration callback.
 
const OptionDef options[]
 
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
 
unsigned long nb_inputcontrols
 
static int set_control(AVFilterContext *ctx, unsigned long port, LADSPA_Data value)
 
int sample_rate
Sample rate of the audio data.
 
static void print(AVTreeNode *t, int depth)
 
int format
agreed upon media format
 
int av_frame_is_writable(AVFrame *frame)
Check if the frame data is writable.
 
AVFilterContext * src
source filter
 
AVFilterFormatsConfig incfg
Lists of supported formats / etc.
 
#define AVERROR_EXTERNAL
Generic error in an external library.
 
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf offset
 
#define AV_LOG_INFO
Standard information.
 
int sample_rate
samples per second
 
int nb_samples
number of audio samples (per channel) described by this frame
 
static int query_formats(AVFilterContext *ctx)
 
#define i(width, name, range_min, range_max)
 
#define AV_TIME_BASE
Internal time base represented as integer.
 
uint8_t ** extended_data
pointers to the data planes/channels.
 
AVSampleFormat
Audio sample formats.
 
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf default value
 
const char * name
Pad name.
 
int64_t av_rescale(int64_t a, int64_t b, int64_t c)
Rescale a 64-bit integer with rounding to nearest.
 
void * av_calloc(size_t nmemb, size_t size)
 
enum AVMediaType type
AVFilterPad type.
 
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several the filter must be ready for frames arriving randomly on any input any filter with several inputs will most likely require some kind of queuing mechanism It is perfectly acceptable to have a limited queue and to drop frames when the inputs are too unbalanced request_frame For filters that do not use the this method is called when a frame is wanted on an output For a it should directly call filter_frame on the corresponding output For a if there are queued frames already one of these frames should be pushed If the filter should request a frame on one of its repeatedly until at least one frame has been pushed Return or at least make progress towards producing a frame
 
const AVFilter ff_af_ladspa
 
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several the filter must be ready for frames arriving randomly on any input any filter with several inputs will most likely require some kind of queuing mechanism It is perfectly acceptable to have a limited queue and to drop frames when the inputs are too unbalanced request_frame For filters that do not use the this method is called when a frame is wanted on an output For a it should directly call filter_frame on the corresponding output For a if there are queued frames already one of these frames should be pushed If the filter should request a frame on one of its repeatedly until at least one frame has been pushed Return values
 
AVRational time_base
Define the time base used by the PTS of the frames/samples which will pass through this link.
 
static int find_latency(AVFilterContext *ctx, LADSPAContext *s)
 
char * av_strdup(const char *s)
Duplicate a string.
 
static void set_default_ctl_value(LADSPAContext *s, int ctl, unsigned long *map, LADSPA_Data *values)
 
const VDPAUPixFmtMap * map
 
static const AVOption ladspa_options[]
 
#define FILTER_OUTPUTS(array)
 
static const AVFilterPad ladspa_outputs[]
 
#define flags(name, subs,...)
 
#define AVERROR_EXIT
Immediate exit was requested; the called function should not be restarted.
 
static av_cold int init(AVFilterContext *ctx)
 
unsigned long nb_outputcontrols
 
static void * av_x_if_null(const void *p, const void *x)
Return x default pointer in case p is NULL.