Go to the documentation of this file.
64 const LADSPA_Descriptor *
desc;
82 #define OFFSET(x) offsetof(LADSPAContext, x)
83 #define FLAGS AV_OPT_FLAG_AUDIO_PARAM | AV_OPT_FLAG_FILTERING_PARAM
93 {
"nb_samples",
"set the number of samples per requested frame",
OFFSET(nb_samples),
AV_OPT_TYPE_INT, {.i64=1024}, 1, INT_MAX,
FLAGS },
108 for (
int ctl = 0; ctl <
s->nb_outputcontrols; ctl++) {
112 latency =
lrintf(
s->octlv[ctl]);
123 const LADSPA_PortRangeHint *
h =
s->desc->PortRangeHints +
map[ctl];
127 if (LADSPA_IS_HINT_TOGGLED(
h->HintDescriptor)) {
130 if (LADSPA_IS_HINT_HAS_DEFAULT(
h->HintDescriptor))
133 if (LADSPA_IS_HINT_INTEGER(
h->HintDescriptor)) {
136 if (LADSPA_IS_HINT_BOUNDED_BELOW(
h->HintDescriptor))
139 if (LADSPA_IS_HINT_BOUNDED_ABOVE(
h->HintDescriptor))
144 else if (LADSPA_IS_HINT_HAS_DEFAULT(
h->HintDescriptor))
149 if (LADSPA_IS_HINT_BOUNDED_BELOW(
h->HintDescriptor))
152 if (LADSPA_IS_HINT_BOUNDED_ABOVE(
h->HintDescriptor))
157 else if (LADSPA_IS_HINT_HAS_DEFAULT(
h->HintDescriptor))
161 if (LADSPA_IS_HINT_SAMPLE_RATE(
h->HintDescriptor))
164 if (LADSPA_IS_HINT_LOGARITHMIC(
h->HintDescriptor))
176 int i,
h, p, new_out_samples;
177 int64_t out_duration;
184 if (!
s->nb_outputs ||
186 s->in_trim == 0 &&
s->out_pad == 0 &&
187 !(
s->desc->Properties & LADSPA_PROPERTY_INPLACE_BROKEN))) {
198 av_assert0(!
s->nb_outputs ||
out->ch_layout.nb_channels == (
s->nb_outputs *
s->nb_handles));
200 for (
h = 0;
h <
s->nb_handles;
h++) {
201 for (
i = 0;
i <
s->nb_inputs;
i++) {
202 p =
s->nb_handles > 1 ?
h :
i;
203 s->desc->connect_port(
s->handles[
h],
s->ipmap[
i],
207 for (
i = 0;
i <
s->nb_outputs;
i++) {
208 p =
s->nb_handles > 1 ?
h :
i;
209 s->desc->connect_port(
s->handles[
h],
s->opmap[
i],
210 (LADSPA_Data*)
out->extended_data[p]);
219 for (
i = 0;
i <
s->nb_outputcontrols;
i++)
228 new_out_samples =
out->nb_samples;
229 if (
s->in_trim > 0) {
230 int trim =
FFMIN(new_out_samples,
s->in_trim);
232 new_out_samples -= trim;
236 if (new_out_samples <= 0) {
239 }
else if (new_out_samples < out->nb_samples) {
240 int offset =
out->nb_samples - new_out_samples;
241 for (
int ch = 0; ch <
out->ch_layout.nb_channels; ch++)
242 memmove(
out->extended_data[ch],
out->extended_data[ch] +
sizeof(
float) *
offset,
243 sizeof(
float) * new_out_samples);
244 out->nb_samples = new_out_samples;
255 out->pts =
s->next_out_pts;
259 s->next_in_pts = in_pts + in_duration;
260 s->next_out_pts =
out->pts + out_duration;
273 if (
ctx->nb_inputs) {
281 s->out_pad -=
frame->nb_samples;
282 frame->pts =
s->next_in_pts;
289 if (
s->duration >= 0 && t >=
s->duration)
296 for (
i = 0;
i <
s->nb_outputs;
i++)
297 s->desc->connect_port(
s->handles[0],
s->opmap[
i],
298 (LADSPA_Data*)
out->extended_data[
i]);
300 s->desc->run(
s->handles[0],
s->nb_samples);
302 for (
i = 0;
i <
s->nb_outputcontrols;
i++)
305 out->sample_rate =
s->sample_rate;
307 s->pts +=
s->nb_samples;
315 const LADSPA_PortRangeHint *
h =
s->desc->PortRangeHints +
map[ctl];
316 const LADSPA_Data lower =
h->LowerBound;
317 const LADSPA_Data upper =
h->UpperBound;
319 if (LADSPA_IS_HINT_DEFAULT_MINIMUM(
h->HintDescriptor)) {
321 }
else if (LADSPA_IS_HINT_DEFAULT_MAXIMUM(
h->HintDescriptor)) {
323 }
else if (LADSPA_IS_HINT_DEFAULT_0(
h->HintDescriptor)) {
325 }
else if (LADSPA_IS_HINT_DEFAULT_1(
h->HintDescriptor)) {
327 }
else if (LADSPA_IS_HINT_DEFAULT_100(
h->HintDescriptor)) {
329 }
else if (LADSPA_IS_HINT_DEFAULT_440(
h->HintDescriptor)) {
331 }
else if (LADSPA_IS_HINT_DEFAULT_LOW(
h->HintDescriptor)) {
332 if (LADSPA_IS_HINT_LOGARITHMIC(
h->HintDescriptor))
333 values[ctl] =
exp(log(lower) * 0.75 + log(upper) * 0.25);
335 values[ctl] = lower * 0.75 + upper * 0.25;
336 }
else if (LADSPA_IS_HINT_DEFAULT_MIDDLE(
h->HintDescriptor)) {
337 if (LADSPA_IS_HINT_LOGARITHMIC(
h->HintDescriptor))
338 values[ctl] =
exp(log(lower) * 0.5 + log(upper) * 0.5);
340 values[ctl] = lower * 0.5 + upper * 0.5;
341 }
else if (LADSPA_IS_HINT_DEFAULT_HIGH(
h->HintDescriptor)) {
342 if (LADSPA_IS_HINT_LOGARITHMIC(
h->HintDescriptor))
343 values[ctl] =
exp(log(lower) * 0.25 + log(upper) * 0.75);
345 values[ctl] = lower * 0.25 + upper * 0.75;
355 s->handles =
av_calloc(
s->nb_handles,
sizeof(*
s->handles));
359 for (
i = 0;
i <
s->nb_handles;
i++) {
361 if (!
s->handles[
i]) {
367 for (j = 0; j <
s->nb_inputcontrols; j++)
368 s->desc->connect_port(
s->handles[
i],
s->icmap[j],
s->ictlv + j);
371 for (j = 0; j <
s->nb_outputcontrols; j++)
372 s->desc->connect_port(
s->handles[
i],
s->ocmap[j], &
s->octlv[j]);
374 if (
s->desc->activate)
375 s->desc->activate(
s->handles[
i]);
396 if (
ctx->nb_inputs) {
401 if (
s->nb_inputs ==
s->nb_outputs) {
404 #if FF_API_OLD_CHANNEL_LAYOUT
406 outlink->channel_layout =
inlink->channel_layout;
423 unsigned long *nb_inputs,
unsigned long *nb_outputs)
425 LADSPA_PortDescriptor pd;
428 for (
i = 0;
i <
desc->PortCount;
i++) {
429 pd =
desc->PortDescriptors[
i];
431 if (LADSPA_IS_PORT_AUDIO(pd)) {
432 if (LADSPA_IS_PORT_INPUT(pd)) {
434 }
else if (LADSPA_IS_PORT_OUTPUT(pd)) {
441 static void *
try_load(
const char *dir,
const char *soname)
447 ret = dlopen(path, RTLD_LOCAL|RTLD_NOW);
457 const char *label =
s->desc->Label;
458 LADSPA_PortRangeHint *
h = (LADSPA_PortRangeHint *)
s->desc->PortRangeHints +
461 if (port >=
s->nb_inputcontrols) {
463 port,
s->nb_inputcontrols);
467 if (LADSPA_IS_HINT_BOUNDED_BELOW(
h->HintDescriptor) &&
468 value < h->LowerBound) {
470 "%s: input control c%ld is below lower boundary of %0.4f.\n",
471 label, port,
h->LowerBound);
475 if (LADSPA_IS_HINT_BOUNDED_ABOVE(
h->HintDescriptor) &&
478 "%s: input control c%ld is above upper boundary of %0.4f.\n",
479 label, port,
h->UpperBound);
491 LADSPA_Descriptor_Function descriptor_fn;
492 const LADSPA_Descriptor *
desc;
493 LADSPA_PortDescriptor pd;
495 char *p, *
arg, *saveptr =
NULL;
496 unsigned long nb_ports;
504 if (
s->dl_name[0] ==
'/' ||
s->dl_name[0] ==
'.') {
506 s->dl_handle = dlopen(
s->dl_name, RTLD_LOCAL|RTLD_NOW);
509 char *paths =
av_strdup(getenv(
"LADSPA_PATH"));
510 const char *home_path = getenv(
"HOME");
511 const char *separator =
":";
515 while ((
arg =
av_strtok(p, separator, &saveptr)) && !
s->dl_handle) {
522 if (!
s->dl_handle && home_path && (paths =
av_asprintf(
"%s/.ladspa", home_path))) {
527 if (!
s->dl_handle && home_path && (paths =
av_asprintf(
"%s/.ladspa/lib", home_path))) {
533 s->dl_handle =
try_load(
"/usr/local/lib/ladspa",
s->dl_name);
536 s->dl_handle =
try_load(
"/usr/lib/ladspa",
s->dl_name);
543 descriptor_fn = dlsym(
s->dl_handle,
"ladspa_descriptor");
544 if (!descriptor_fn) {
556 for (
i = 0;
desc = descriptor_fn(
i);
i++) {
570 desc = descriptor_fn(
i);
576 if (
desc->Label && !strcmp(
desc->Label,
s->plugin))
582 nb_ports =
desc->PortCount;
590 s->ctl_needs_value =
av_calloc(nb_ports,
sizeof(*
s->ctl_needs_value));
591 if (!
s->ipmap || !
s->opmap || !
s->icmap ||
592 !
s->ocmap || !
s->ictlv || !
s->octlv || !
s->ctl_needs_value)
595 for (
i = 0;
i < nb_ports;
i++) {
596 pd =
desc->PortDescriptors[
i];
598 if (LADSPA_IS_PORT_AUDIO(pd)) {
599 if (LADSPA_IS_PORT_INPUT(pd)) {
600 s->ipmap[
s->nb_inputs] =
i;
602 }
else if (LADSPA_IS_PORT_OUTPUT(pd)) {
603 s->opmap[
s->nb_outputs] =
i;
606 }
else if (LADSPA_IS_PORT_CONTROL(pd)) {
607 if (LADSPA_IS_PORT_INPUT(pd)) {
608 s->icmap[
s->nb_inputcontrols] =
i;
610 if (LADSPA_IS_HINT_HAS_DEFAULT(
desc->PortRangeHints[
i].HintDescriptor))
613 s->ctl_needs_value[
s->nb_inputcontrols] = 1;
615 s->nb_inputcontrols++;
616 }
else if (LADSPA_IS_PORT_OUTPUT(pd)) {
617 s->ocmap[
s->nb_outputcontrols] =
i;
618 s->nb_outputcontrols++;
624 if (
s->options && !strcmp(
s->options,
"help")) {
625 if (!
s->nb_inputcontrols) {
627 "The '%s' plugin does not have any input controls.\n",
631 "The '%s' plugin has the following input controls:\n",
633 for (
i = 0;
i <
s->nb_inputcontrols;
i++)
659 s->ctl_needs_value[
i] = 0;
663 for (
i = 0;
i <
s->nb_inputcontrols;
i++) {
664 if (
s->ctl_needs_value[
i]) {
686 s->nb_inputs,
s->nb_outputs);
688 s->nb_inputcontrols,
s->nb_outputcontrols);
722 if (
s->nb_inputs == 1 &&
s->nb_outputs == 1) {
727 }
else if (
s->nb_inputs == 2 &&
s->nb_outputs == 2) {
738 if (
s->nb_inputs >= 1) {
750 if (!
s->nb_outputs) {
757 if (
s->nb_outputs >= 1) {
778 for (
i = 0;
i <
s->nb_handles;
i++) {
779 if (
s->desc->deactivate)
780 s->desc->deactivate(
s->handles[
i]);
781 if (
s->desc->cleanup)
782 s->desc->cleanup(
s->handles[
i]);
786 dlclose(
s->dl_handle);
801 char *res,
int res_len,
int flags)
825 .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.
#define FF_ENABLE_DEPRECATION_WARNINGS
@ 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.
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
#define AV_FIFO_FLAG_AUTO_GROW
Automatically resize the FIFO on writes, so that the data fits.
#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)
int av_fifo_read(AVFifo *f, void *buf, size_t nb_elems)
Read data from a FIFO.
#define AV_CHANNEL_LAYOUT_STEREO
const char * name
Filter name.
static av_cold void uninit(AVFilterContext *ctx)
int nb_channels
Number of channels in this layout.
A link between two filters.
int av_channel_layout_copy(AVChannelLayout *dst, const AVChannelLayout *src)
Make a copy of a channel layout.
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)
AVChannelLayout ch_layout
Channel layout of the audio data.
#define AVFILTER_FLAG_DYNAMIC_INPUTS
The number of the filter inputs is not determined just by AVFilter.inputs.
A filter pad used for either input or output.
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
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.
int64_t av_rescale_q(int64_t a, AVRational bq, AVRational cq)
Rescale a 64-bit integer by 2 rational numbers.
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)
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.
An AVChannelLayout holds information about the channel layout of audio data.
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
static AVRational av_make_q(int num, int den)
Create an AVRational.
#define AV_NOPTS_VALUE
Undefined timestamp value.
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)
AVFifo * av_fifo_alloc2(size_t nb_elems, size_t elem_size, unsigned int flags)
Allocate and initialize an AVFifo with a given element size.
#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
void av_fifo_freep2(AVFifo **f)
Free an AVFifo and reset pointer to NULL.
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
int av_fifo_write(AVFifo *f, const void *buf, size_t nb_elems)
Write data into a FIFO.
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)
#define FF_DISABLE_DEPRECATION_WARNINGS
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
AVChannelLayout ch_layout
channel layout of current buffer (see libavutil/channel_layout.h)
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.