Go to the documentation of this file.
35 #define MERGE_REF(ret, a, fmts, type, fail_statement) \
40 if (!(tmp = av_realloc_array(ret->refs, ret->refcount + a->refcount, \
45 for (i = 0; i < a->refcount; i ++) { \
46 ret->refs[ret->refcount] = a->refs[i]; \
47 *ret->refs[ret->refcount++] = ret; \
62 #define MERGE_FORMATS(a, b, fmts, nb, type, check, empty_allowed) \
64 int i, j, k = 0, skip = 0; \
66 if (empty_allowed) { \
67 if (!a->nb || !b->nb) { \
71 FFSWAP(type *, a, b); \
76 for (i = 0; i < a->nb; i++) \
77 for (j = 0; j < b->nb; j++) \
78 if (a->fmts[i] == b->fmts[j]) { \
81 a->fmts[k++] = a->fmts[i]; \
92 MERGE_REF(a, b, fmts, type, return AVERROR(ENOMEM);); \
99 int alpha1=0, alpha2=0;
100 int chroma1=0, chroma2=0;
115 for (
i = 0;
i <
a->nb_formats;
i++) {
117 for (j = 0; j <
b->nb_formats; j++) {
121 if (
a->formats[
i] ==
b->formats[j]) {
129 if (alpha2 > alpha1 || chroma2 > chroma1)
188 if (
a ==
b)
return 1;
217 unsigned a_all =
a->all_layouts +
a->all_counts;
218 unsigned b_all =
b->all_layouts +
b->all_counts;
219 int ret_max, ret_nb = 0,
i, j,
round;
223 if (
a ==
b)
return 1;
228 FFSWAP(
unsigned, a_all, b_all);
231 if (a_all == 1 && !b_all) {
233 for (
i = j = 0;
i <
b->nb_channel_layouts;
i++)
234 if (
KNOWN(&
b->channel_layouts[
i]) &&
i != j++) {
243 b->nb_channel_layouts = j;
249 ret_max =
a->nb_channel_layouts +
b->nb_channel_layouts;
254 for (
i = 0;
i <
a->nb_channel_layouts;
i++) {
255 if (!
KNOWN(&
a->channel_layouts[
i]))
257 for (j = 0; j <
b->nb_channel_layouts; j++) {
271 for (
i = 0;
i <
a->nb_channel_layouts;
i++) {
276 for (j = 0; j <
b->nb_channel_layouts; j++)
287 for (
i = 0;
i <
a->nb_channel_layouts;
i++) {
288 if (
KNOWN(&
a->channel_layouts[
i]))
290 for (j = 0; j <
b->nb_channel_layouts; j++)
303 if (
a->refcount >
b->refcount)
310 b->nb_channel_layouts = ret_nb;
349 #define PRINT_NAME(type, type_name) \
350 static void print_##type_name(AVBPrint *bp, const void *fmtsp) \
352 const AVFilterFormats *fmts = fmtsp; \
353 for (int i = 0; i < fmts->nb_formats; i++) { \
354 const char *name = av_##type_name(fmts->formats[i]); \
355 av_bprint_chars(bp, ' ', i ? 1 : 0); \
356 av_bprint_append_data(bp, name, name ? strlen(name) : 0); \
369 for (
int i = 0;
i <
layouts->nb_channel_layouts;
i++) {
378 for (
int i = 0;
i <
rates->nb_formats;
i++)
382 #define CONVERSION_FILTER_SWSCALE \
383 .conversion_filter = "scale", \
384 .conversion_opts_offset = offsetof(AVFilterGraph, scale_sws_opts),
386 #define CONVERSION_FILTER_ARESAMPLE \
387 .conversion_filter = "aresample", \
388 .conversion_opts_offset = offsetof(AVFilterGraph, aresample_swr_opts),
392 .name =
"Pixel formats",
396 .print_list = print_get_pix_fmt_name,
400 .name =
"Color spaces",
404 .print_list = print_color_space_name,
408 .name =
"Color ranges",
412 .print_list = print_color_range_name,
416 .name =
"Alpha modes",
420 .print_list = print_alpha_mode_name,
421 .conversion_filter =
"premultiply_dynamic",
427 .name =
"Channel layouts",
435 .name =
"Sample rates",
443 .name =
"Sample formats",
447 .print_list = print_get_sample_fmt_name,
464 switch (
link->type) {
467 default:
return NULL;
475 for (
p = fmts; *
p != -1;
p++) {
482 #define MAKE_FORMAT_LIST(type, field, count_field) \
486 for (count = 0; fmts[count] != -1; count++) \
488 formats = av_mallocz(sizeof(*formats)); \
491 formats->count_field = count; \
493 formats->field = av_malloc_array(count, sizeof(*formats->field)); \
494 if (!formats->field) { \
495 av_freep(&formats); \
504 formats->formats[count] = fmts[count];
527 for (
int i = 0;
i < count;
i++) {
537 for (
int i = 0;
i < count;
i++)
545 #define ADD_FORMAT(f, fmt, unref_fn, type, list, nb) \
549 if (!(*f) && !(*f = av_mallocz(sizeof(**f)))) { \
550 return AVERROR(ENOMEM); \
553 fmts = av_realloc_array((*f)->list, (*f)->nb + 1, \
554 sizeof(*(*f)->list)); \
557 return AVERROR(ENOMEM); \
561 ASSIGN_FMT(f, fmt, list, nb); \
564 #define ASSIGN_FMT(f, fmt, list, nb) \
566 (*f)->list[(*f)->nb++] = fmt; \
576 #define ASSIGN_FMT(f, fmt, list, nb) \
579 memset((*f)->list + (*f)->nb, 0, sizeof(*(*f)->list)); \
580 ret = av_channel_layout_copy(&(*f)->list[(*f)->nb], fmt); \
596 int fmts[2] = { fmt, -1 };
620 unsigned nb_formats, fmt,
flags;
625 for (fmt = 0;; fmt++) {
632 (
desc->log2_chroma_w ||
desc->log2_chroma_h))
634 if ((
flags & (want | rej)) != want)
637 formats->formats[nb_formats] = fmt;
647 formats->nb_formats = nb_formats;
682 ret->all_layouts = 1;
691 ret->all_layouts =
ret->all_counts = 1;
733 #define FORMATS_REF(f, ref, unref_fn) \
737 return AVERROR(ENOMEM); \
739 tmp = av_realloc_array(f->refs, f->refcount + 1, sizeof(*f->refs)); \
742 return AVERROR(ENOMEM); \
745 f->refs[f->refcount++] = ref; \
759 #define FIND_REF_INDEX(ref, idx) \
762 for (i = 0; i < (*ref)->refcount; i ++) \
763 if((*ref)->refs[i] == ref) { \
769 #define FORMATS_UNREF(ref, list) \
776 FIND_REF_INDEX(ref, idx); \
779 memmove((*ref)->refs + idx, (*ref)->refs + idx + 1, \
780 sizeof(*(*ref)->refs) * ((*ref)->refcount - idx - 1)); \
781 --(*ref)->refcount; \
783 if (!(*ref)->refcount) { \
784 FREE_LIST(ref, list); \
785 av_free((*ref)->list); \
786 av_free((*ref)->refs); \
792 #define FREE_LIST(ref, list) do { } while(0)
799 #define FREE_LIST(ref, list) \
801 for (int i = 0; i < (*ref)->nb_channel_layouts; i++) \
802 av_channel_layout_uninit(&(*ref)->list[i]); \
810 #define FORMATS_CHANGEREF(oldref, newref) \
814 FIND_REF_INDEX(oldref, idx); \
817 (*oldref)->refs[idx] = newref; \
834 #define SET_COMMON_FORMATS(ctx, fmts, media_type, ref_fn, unref_fn) \
838 return AVERROR(ENOMEM); \
840 for (i = 0; i < ctx->nb_inputs; i++) { \
841 AVFilterLink *const link = ctx->inputs[i]; \
842 if (link && !link->outcfg.fmts && \
843 (media_type == AVMEDIA_TYPE_UNKNOWN || link->type == media_type)) { \
844 int ret = ref_fn(fmts, &ctx->inputs[i]->outcfg.fmts); \
850 for (i = 0; i < ctx->nb_outputs; i++) { \
851 AVFilterLink *const link = ctx->outputs[i]; \
852 if (link && !link->incfg.fmts && \
853 (media_type == AVMEDIA_TYPE_UNKNOWN || link->type == media_type)) { \
854 int ret = ref_fn(fmts, &ctx->outputs[i]->incfg.fmts); \
861 if (!fmts->refcount) \
972 #define SET_COMMON_FORMATS2(ctx, cfg_in, cfg_out, fmts, media_type, \
975 return AVERROR(ENOMEM); \
977 for (unsigned i = 0; i < ctx->nb_inputs; i++) { \
978 const AVFilterLink *const link = ctx->inputs[i]; \
979 if (!cfg_in[i]->fmts && \
980 (media_type == AVMEDIA_TYPE_UNKNOWN || \
981 link->type == media_type)) { \
982 int ret = ref_fn(fmts, &cfg_in[i]->fmts); \
988 for (unsigned i = 0; i < ctx->nb_outputs; i++) { \
989 const AVFilterLink *const link = ctx->outputs[i]; \
990 if (!cfg_out[i]->fmts && \
991 (media_type == AVMEDIA_TYPE_UNKNOWN || \
992 link->type == media_type)) { \
993 int ret = ref_fn(fmts, &cfg_out[i]->fmts); \
1000 if (!fmts->refcount) \
1150 switch (
f->formats_state) {
1175 ctx->nb_outputs ?
ctx->outputs[0]->type :
A list of supported channel layouts.
AVPixelFormat
Pixel format.
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 minimum maximum flags name is the option name
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
@ FF_FILTER_FORMATS_QUERY_FUNC
formats.query active.
enum MovChannelLayoutTag * layouts
const AVPixFmtDescriptor * av_pix_fmt_desc_get(enum AVPixelFormat pix_fmt)
@ AVCOL_SPC_NB
Not part of ABI.
@ FF_FILTER_FORMATS_SINGLE_PIXFMT
formats.pix_fmt active
int nb_channels
Number of channels in this layout.
A link between two filters.
int av_channel_layout_describe_bprint(const AVChannelLayout *channel_layout, AVBPrint *bp)
bprint variant of av_channel_layout_describe().
static const FFFilter * fffilter(const AVFilter *f)
@ AVCOL_SPC_RESERVED
reserved for future use by ITU-T and ISO/IEC just like 15-255 are
#define AV_PIX_FMT_FLAG_HWACCEL
Pixel format is an HW accelerated format.
@ AVCOL_RANGE_NB
Not part of ABI.
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 type
Callbacks and properties to describe the steps of a format negotiation.
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
#define FF_ARRAY_ELEMS(a)
#define check(x, y, S, v)
#define av_assert0(cond)
assert() equivalent, that is always enabled.
int av_sample_fmt_is_planar(enum AVSampleFormat sample_fmt)
Check if the sample format is planar.
#define AV_PIX_FMT_FLAG_ALPHA
The pixel format has an alpha channel.
const char * av_get_sample_fmt_name(enum AVSampleFormat sample_fmt)
Return the name of sample_fmt, or NULL if sample_fmt is not recognized.
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
uint8_t nb_components
The number of components each pixel has, (1-4)
uint64_t flags
Combination of AV_PIX_FMT_FLAG_...
@ FF_FILTER_FORMATS_SINGLE_SAMPLEFMT
formats.sample_fmt active.
AVAlphaMode
Correlation between the alpha channel and color values.
An AVChannelLayout holds information about the channel layout of audio data.
AVChannelLayout * channel_layouts
list of channel layouts
char all_layouts
accept any known channel layout
char all_counts
accept any channel layout or count
@ AVALPHA_MODE_NB
Not part of ABI.
@ AVMEDIA_TYPE_UNKNOWN
Usually treated as AVMEDIA_TYPE_DATA.
The reader does not expect b to be semantically here and if the code is changed by maybe adding a a division or other the signedness will almost certainly be mistaken To avoid this confusion a new type was SUINT is the C unsigned type but it holds a signed int to use the same example SUINT a
int av_channel_layout_compare(const AVChannelLayout *chl, const AVChannelLayout *chl1)
Check whether two channel layouts are semantically the same, i.e.
#define av_assert2(cond)
assert() equivalent, that does lie in speed critical code.
@ FF_FILTER_FORMATS_PASSTHROUGH
The default value meaning that this filter supports all formats and (for audio) sample rates and chan...
#define i(width, name, range_min, range_max)
static av_always_inline av_const double round(double x)
int av_get_bytes_per_sample(enum AVSampleFormat sample_fmt)
Return number of bytes per sample.
#define av_malloc_array(a, b)
AVColorSpace
YUV colorspace type.
#define av_assert1(cond)
assert() equivalent, that does not lie in speed critical code.
AVSampleFormat
Audio sample formats.
static const AVChannelLayout ch_layouts[]
void * av_mallocz(size_t size)
Allocate a memory block with alignment suitable for all memory accesses (including vectors if availab...
void * av_calloc(size_t nmemb, size_t size)
#define FFSWAP(type, a, b)
int av_channel_layout_check(const AVChannelLayout *channel_layout)
Check whether a channel layout is valid, i.e.
void av_bprintf(AVBPrint *buf, const char *fmt,...)
@ FF_FILTER_FORMATS_QUERY_FUNC2
formats.query_func2 active.
void av_channel_layout_uninit(AVChannelLayout *channel_layout)
Free any allocated data in the channel layout and reset the channel count to 0.
static int ref[MAX_W *MAX_W]
#define AV_PIX_FMT_FLAG_PLANAR
At least one pixel component is not in the first data plane.
IDirect3DDxgiInterfaceAccess _COM_Outptr_ void ** p
int av_channel_layout_copy(AVChannelLayout *dst, const AVChannelLayout *src)
Make a copy of a channel layout.
int nb_channel_layouts
number of channel layouts
Descriptor that unambiguously describes how the bits of a pixel are stored in the up to 4 data planes...
static const uint16_t channel_layouts[7]
@ FF_FILTER_FORMATS_SAMPLEFMTS_LIST
formats.samples_list active.
void av_bprint_chars(AVBPrint *buf, char c, unsigned n)
Append char c n times to a print buffer.
AVColorRange
Visual content value range.
@ FF_FILTER_FORMATS_PIXFMT_LIST
formats.pixels_list active.