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.