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;
480 #define MAKE_FORMAT_LIST(type, field, count_field) \
484 for (count = 0; fmts[count] != -1; count++) \
486 formats = av_mallocz(sizeof(*formats)); \
489 formats->count_field = count; \
491 formats->field = av_malloc_array(count, sizeof(*formats->field)); \
492 if (!formats->field) { \
493 av_freep(&formats); \
498 #define MAKE_FORMAT_LIST_TYPE(name, type) \
499 AVFilterFormats *ff_make_ ## name ## _list(const type* fmts) \
501 MAKE_FORMAT_LIST(AVFilterFormats, formats, nb_formats); \
503 formats->formats[count] = (int)fmts[count]; \
516 for (count = 0; fmts[count].nb_channels; count++)
529 for (
int i = 0;
i < count;
i++) {
539 for (
int i = 0;
i < count;
i++)
547 #define ADD_FORMAT(f, fmt, unref_fn, type, list, nb) \
551 if (!(*f) && !(*f = av_mallocz(sizeof(**f)))) { \
552 return AVERROR(ENOMEM); \
555 fmts = av_realloc_array((*f)->list, (*f)->nb + 1, \
556 sizeof(*(*f)->list)); \
559 return AVERROR(ENOMEM); \
563 ASSIGN_FMT(f, fmt, list, nb); \
566 #define ASSIGN_FMT(f, fmt, list, nb) \
568 (*f)->list[(*f)->nb++] = fmt; \
578 #define ASSIGN_FMT(f, fmt, list, nb) \
581 memset((*f)->list + (*f)->nb, 0, sizeof(*(*f)->list)); \
582 ret = av_channel_layout_copy(&(*f)->list[(*f)->nb], fmt); \
598 int fmts[2] = { fmt, -1 };
622 unsigned nb_formats, fmt,
flags;
627 for (fmt = 0;; fmt++) {
634 (
desc->log2_chroma_w ||
desc->log2_chroma_h))
636 if ((
flags & (want | rej)) != want)
639 formats->formats[nb_formats] = fmt;
649 formats->nb_formats = nb_formats;
684 ret->all_layouts = 1;
693 ret->all_layouts =
ret->all_counts = 1;
735 #define FORMATS_REF(f, ref, unref_fn) \
739 return AVERROR(ENOMEM); \
741 tmp = av_realloc_array(f->refs, f->refcount + 1, sizeof(*f->refs)); \
744 return AVERROR(ENOMEM); \
747 f->refs[f->refcount++] = ref; \
761 #define FIND_REF_INDEX(ref, idx) \
764 for (i = 0; i < (*ref)->refcount; i ++) \
765 if((*ref)->refs[i] == ref) { \
771 #define FORMATS_UNREF(ref, list) \
778 FIND_REF_INDEX(ref, idx); \
781 memmove((*ref)->refs + idx, (*ref)->refs + idx + 1, \
782 sizeof(*(*ref)->refs) * ((*ref)->refcount - idx - 1)); \
783 --(*ref)->refcount; \
785 if (!(*ref)->refcount) { \
786 FREE_LIST(ref, list); \
787 av_free((*ref)->list); \
788 av_free((*ref)->refs); \
794 #define FREE_LIST(ref, list) do { } while(0)
801 #define FREE_LIST(ref, list) \
803 for (int i = 0; i < (*ref)->nb_channel_layouts; i++) \
804 av_channel_layout_uninit(&(*ref)->list[i]); \
812 #define FORMATS_CHANGEREF(oldref, newref) \
816 FIND_REF_INDEX(oldref, idx); \
819 (*oldref)->refs[idx] = newref; \
836 #define SET_COMMON_FORMATS(ctx, fmts, media_type, ref_fn, unref_fn) \
840 return AVERROR(ENOMEM); \
842 for (i = 0; i < ctx->nb_inputs; i++) { \
843 AVFilterLink *const link = ctx->inputs[i]; \
844 if (link && !link->outcfg.fmts && \
845 (media_type == AVMEDIA_TYPE_UNKNOWN || link->type == media_type)) { \
846 int ret = ref_fn(fmts, &ctx->inputs[i]->outcfg.fmts); \
852 for (i = 0; i < ctx->nb_outputs; i++) { \
853 AVFilterLink *const link = ctx->outputs[i]; \
854 if (link && !link->incfg.fmts && \
855 (media_type == AVMEDIA_TYPE_UNKNOWN || link->type == media_type)) { \
856 int ret = ref_fn(fmts, &ctx->outputs[i]->incfg.fmts); \
863 if (!fmts->refcount) \
984 #define SET_COMMON_FORMATS2(ctx, cfg_in, cfg_out, fmts, media_type, \
987 return AVERROR(ENOMEM); \
989 for (unsigned i = 0; i < ctx->nb_inputs; i++) { \
990 const AVFilterLink *const link = ctx->inputs[i]; \
991 if (!cfg_in[i]->fmts && \
992 (media_type == AVMEDIA_TYPE_UNKNOWN || \
993 link->type == media_type)) { \
994 int ret = ref_fn(fmts, &cfg_in[i]->fmts); \
1000 for (unsigned i = 0; i < ctx->nb_outputs; i++) { \
1001 const AVFilterLink *const link = ctx->outputs[i]; \
1002 if (!cfg_out[i]->fmts && \
1003 (media_type == AVMEDIA_TYPE_UNKNOWN || \
1004 link->type == media_type)) { \
1005 int ret = ref_fn(fmts, &cfg_out[i]->fmts); \
1012 if (!fmts->refcount) \
1177 switch (
f->formats_state) {
1202 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.
static AVFormatContext * ctx
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
New swscale design to change SwsGraph is what coordinates multiple passes These can include cascaded scaling error diffusion and so on Or we could have separate passes for the vertical and horizontal scaling In between each SwsPass lies a fully allocated image buffer Graph passes may have different levels of e g we can have a single threaded error diffusion pass following a multi threaded scaling pass SwsGraph is internally recreated whenever the image format
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.
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.
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.