Go to the documentation of this file.
274 av_log(
ctx,
AV_LOG_ERROR,
"Expressions with frame variables 'n', 't', 'pos' are not valid in init eval_mode.\n");
284 int ret, is_inited = 0;
285 char *old_str_expr =
NULL;
296 old_pexpr = *pexpr_ptr;
329 *pexpr_ptr = old_pexpr;
340 if (!
scale->sws_opts)
378 "Size and width/height expressions cannot be set at the same time.\n");
385 if (
scale->size_str) {
389 "Invalid size '%s'\n",
scale->size_str);
410 if (
scale->in_color_matrix != -1 &&
433 if (
scale->param[
i] != DBL_MAX) {
510 &
ctx->inputs[0]->outcfg.color_spaces)) < 0)
514 &
ctx->inputs[0]->outcfg.color_ranges)) < 0)
549 main_link =
ctx->inputs[0];
559 (
double)
inlink->sample_aspect_ratio.num /
inlink->sample_aspect_ratio.den : 1;
578 if (
scale->uses_ref) {
597 expr =
scale->h_expr;
605 expr =
scale->w_expr;
618 "Error when evaluating the expression '%s'.\n", expr);
623 int h_pos_override,
int v_pos_override,
624 int h_sub,
int v_sub,
int index)
636 h_pos *= (1 << h_sub) - 1;
637 v_pos *= (1 << v_sub) - 1;
639 if (h_pos_override != -513)
640 h_pos = h_pos_override;
641 if (v_pos_override != -513)
642 v_pos = v_pos_override;
645 if (v_sub &&
index > 0) {
654 v_pos += (256 << v_sub) - 256;
662 *h_pos_out = h_sub ? h_pos : -513;
663 *v_pos_out = v_sub ? v_pos : -513;
677 uint8_t *flags_val =
NULL;
678 int in_range, in_colorspace;
688 scale->force_original_aspect_ratio,
689 scale->force_divisible_by);
694 if (outlink->
w > INT_MAX ||
695 outlink->
h > INT_MAX ||
696 (outlink->
h *
inlink->w) > INT_MAX ||
697 (outlink->
w *
inlink->h) > INT_MAX)
706 in_range =
scale->in_range;
710 in_colorspace =
scale->in_color_matrix;
711 if (in_colorspace == -1 )
721 if (inlink0->
w == outlink->
w &&
722 inlink0->
h == outlink->
h &&
726 scale->in_chroma_loc ==
scale->out_chroma_loc)
732 for (
i = 0;
i < 3;
i++) {
734 int h_chr_pos, v_chr_pos;
735 const int *inv_table, *
table;
760 desc->log2_chroma_w,
desc->log2_chroma_h,
i);
774 (
int **)&
table, &out_full,
777 if (
scale->in_color_matrix == -1 )
790 if (!
scale->interlaced)
803 av_log(
ctx,
AV_LOG_VERBOSE,
"w:%d h:%d fmt:%s csp:%s range:%s sar:%d/%d -> w:%d h:%d fmt:%s csp:%s range:%s sar:%d/%d flags:%s\n",
806 inlink->sample_aspect_ratio.num,
inlink->sample_aspect_ratio.den,
819 scale->fs.in[0].time_base =
ctx->inputs[0]->time_base;
820 scale->fs.in[0].sync = 1;
823 if (
scale->uses_ref) {
825 scale->fs.in[1].time_base =
ctx->inputs[1]->time_base;
826 scale->fs.in[1].sync = 0;
871 for (
int i = 0;
i < 4 &&
frame->data[
i];
i++) {
872 if (
i == 1 && is_pal)
881 int orig_h_src =
src->height;
882 int orig_h_dst = dst->
height;
892 for (
int i = 0;
i < 4;
i++) {
893 src->linesize[
i] *= 2;
904 for (
int i = 0;
i < 4;
i++) {
905 src->linesize[
i] /= 2;
908 src->height = orig_h_src;
1029 out->width = outlink->
w;
1030 out->height = outlink->
h;
1034 out->chroma_location =
scale->out_chroma_loc;
1036 if (
scale->output_is_pal)
1039 av_reduce(&
out->sample_aspect_ratio.num, &
out->sample_aspect_ratio.den,
1044 if (
scale->interlaced>0 || (
scale->interlaced<0 &&
1068 int ret = 0, frame_changed;
1074 if (
scale->uses_ref) {
1084 frame_changed =
ref->width != reflink->
w ||
1085 ref->height != reflink->
h ||
1092 if (frame_changed) {
1094 reflink->
w =
ref->width;
1095 reflink->
h =
ref->height;
1109 #if FF_API_FRAME_PKT
1159 if (frame_changed) {
1174 #if FF_API_FRAME_PKT
1185 char *res,
int res_len,
int flags)
1192 w = !strcmp(cmd,
"width") || !strcmp(cmd,
"w");
1193 h = !strcmp(cmd,
"height") || !strcmp(cmd,
"h");
1197 pexpr_ptr =
w ? &
scale->w_pexpr : &
scale->h_pexpr;
1217 switch ((uintptr_t) *iter) {
1219 *iter = (
void*)(uintptr_t) 1;
1222 *iter = (
void*)(uintptr_t) 2;
1234 if (prev ==
s->sws_opts)
1239 #define OFFSET(x) offsetof(ScaleContext, x)
1240 #define FLAGS AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_FILTERING_PARAM
1241 #define TFLAGS AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_RUNTIME_PARAM
1282 {
"in_v_chr_pos",
"input vertical chroma position in luma grid/256" ,
OFFSET(in_v_chr_pos),
AV_OPT_TYPE_INT, { .i64 = -513}, -513, 512,
FLAGS },
1283 {
"in_h_chr_pos",
"input horizontal chroma position in luma grid/256",
OFFSET(in_h_chr_pos),
AV_OPT_TYPE_INT, { .i64 = -513}, -513, 512,
FLAGS },
1284 {
"out_v_chr_pos",
"output vertical chroma position in luma grid/256" ,
OFFSET(out_v_chr_pos),
AV_OPT_TYPE_INT, { .i64 = -513}, -513, 512,
FLAGS },
1285 {
"out_h_chr_pos",
"output horizontal chroma position in luma grid/256",
OFFSET(out_h_chr_pos),
AV_OPT_TYPE_INT, { .i64 = -513}, -513, 512,
FLAGS },
1286 {
"force_original_aspect_ratio",
"decrease or increase w/h if necessary to keep the original AR",
OFFSET(force_original_aspect_ratio),
AV_OPT_TYPE_INT, { .i64 = 0}, 0, 2,
FLAGS, .unit =
"force_oar" },
1290 {
"force_divisible_by",
"enforce that the output resolution is divisible by a defined integer when force_original_aspect_ratio is used",
OFFSET(force_divisible_by),
AV_OPT_TYPE_INT, { .i64 = 1}, 1, 256,
FLAGS },
1326 .description =
NULL_IF_CONFIG_SMALL(
"Scale the input video size and/or convert the image format."),
1343 *iter = (
void*)(uintptr_t)
c;
1394 .
name =
"scale2ref",
1395 .description =
NULL_IF_CONFIG_SMALL(
"Scale the input video size and/or convert the image format to the given reference."),
static int filter_frame_ref(AVFilterLink *link, AVFrame *in)
AVFrame * ff_get_video_buffer(AVFilterLink *link, int w, int h)
Request a picture buffer with a specific set of permissions.
#define FF_ENABLE_DEPRECATION_WARNINGS
static int config_props_ref(AVFilterLink *outlink)
int ff_framesync_configure(FFFrameSync *fs)
Configure a frame sync structure.
#define AV_LOG_WARNING
Something somehow does not look correct.
enum AVColorRange color_range
MPEG vs JPEG YUV range.
AVPixelFormat
Pixel format.
struct SwsContext * sws_opts
static int check_exprs(AVFilterContext *ctx)
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 input_is_pal
set to 1 if the input format is paletted
void ff_framesync_uninit(FFFrameSync *fs)
Free all memory currently allocated.
#define sws_isSupportedOutput(x)
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
const AVPixFmtDescriptor * av_pix_fmt_desc_get(enum AVPixelFormat pix_fmt)
static int query_formats(AVFilterContext *ctx)
int ff_framesync_get_frame(FFFrameSync *fs, unsigned in, AVFrame **rframe, unsigned get)
Get the current frame in an input.
static const AVFilterPad avfilter_vf_scale2ref_outputs[]
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
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
enum AVColorSpace colorspace
YUV colorspace type.
#define FILTER_INPUTS(array)
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).
@ AVCOL_RANGE_JPEG
Full range content.
static int request_frame_ref(AVFilterLink *outlink)
int av_opt_set_double(void *obj, const char *name, double val, int search_flags)
@ AVCOL_SPC_NB
Not part of ABI.
static int scale_parse_expr(AVFilterContext *ctx, char *str_expr, AVExpr **pexpr_ptr, const char *var, const char *args)
static const AVClass scale2ref_class
static const uint16_t table[]
static int request_frame(AVFilterLink *outlink)
const AVPixFmtDescriptor * av_pix_fmt_desc_next(const AVPixFmtDescriptor *prev)
Iterate over all pixel format descriptors known to libavutil.
int ff_request_frame(AVFilterLink *link)
Request an input frame from the filter at the other end of the link.
double var_values[VARS_NB]
#define AV_LOG_VERBOSE
Detailed information.
@ AVCOL_SPC_RGB
order of coefficients is actually GBR, also IEC 61966-2-1 (sRGB), YZX and ST 428-1
int flags
Frame flags, a combination of AV_FRAME_FLAGS.
const char * name
Filter name.
@ EXT_INFINITY
Extend the frame to infinity.
A link between two filters.
Link properties exposed to filter code, but not external callers.
int av_expr_parse(AVExpr **expr, const char *s, const char *const *const_names, const char *const *func1_names, double(*const *funcs1)(void *, double), const char *const *func2_names, double(*const *funcs2)(void *, double, double), int log_offset, void *log_ctx)
Parse an expression.
@ AVCOL_SPC_BT470BG
also ITU-R BT601-6 625 / ITU-R BT1358 625 / ITU-R BT1700 625 PAL & SECAM / IEC 61966-2-4 xvYCC601
@ EXT_STOP
Completely stop all streams with this one.
int ff_append_inpad(AVFilterContext *f, AVFilterPad *p)
Append a new input/output pad to the filter's list of such pads.
const char * av_color_space_name(enum AVColorSpace space)
static const AVFilterPad avfilter_vf_scale_inputs[]
static void frame_offset(AVFrame *frame, int dir, int is_pal)
struct SwsContext * isws[2]
software scaler context for interlaced material
int eval_mode
expression evaluation mode
@ EXT_NULL
Ignore this stream and continue processing the other ones.
const AVClass * sws_get_class(void)
Get the AVClass for swsContext.
int av_opt_set(void *obj, const char *name, const char *val, int search_flags)
#define AVFILTER_FLAG_DYNAMIC_INPUTS
The number of the filter inputs is not determined just by AVFilter.inputs.
int av_reduce(int *dst_num, int *dst_den, int64_t num, int64_t den, int64_t max)
Reduce a fraction.
void av_expr_free(AVExpr *e)
Free a parsed expression previously created with av_expr_parse().
static av_cold int preinit(AVFilterContext *ctx)
A filter pad used for either input or output.
static int activate(AVFilterContext *ctx)
@ AV_PIX_FMT_BGR8
packed RGB 3:3:2, 8bpp, (msb)2B 3G 3R(lsb)
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
#define FF_ARRAY_ELEMS(a)
static void * scale2ref_child_next(void *obj, void *prev)
struct SwsContext * sws
software scaler context
int av_chroma_location_enum_to_pos(int *xpos, int *ypos, enum AVChromaLocation pos)
Converts AVChromaLocation to swscale x/y chroma position.
int slice_y
top of current output slice
@ AVCOL_SPC_SMPTE170M
also ITU-R BT601-6 525 / ITU-R BT1358 525 / ITU-R BT1700 NTSC / functionally identical to above
static enum AVPixelFormat pix_fmt
@ AV_OPT_TYPE_DOUBLE
Underlying C type is double.
int av_expr_count_vars(AVExpr *e, unsigned *counter, int size)
Track the presence of variables and their number of occurrences in a parsed expression.
AVRational sample_aspect_ratio
agreed upon sample aspect ratio
static av_cold int init(AVFilterContext *ctx)
#define av_assert0(cond)
assert() equivalent, that is always enabled.
static int process_command(AVFilterContext *ctx, const char *cmd, const char *args, char *res, int res_len, int flags)
double av_expr_eval(AVExpr *e, const double *const_values, void *opaque)
Evaluate a previously parsed expression.
int64_t av_rescale_q(int64_t a, AVRational bq, AVRational cq)
Rescale a 64-bit integer by 2 rational numbers.
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 field
uint8_t log2_chroma_w
Amount to shift the luma width right to find the chroma width.
int ff_fmt_is_in(int fmt, const int *fmts)
Tell if an integer is contained in the provided -1-terminated list of integers.
#define FILTER_OUTPUTS(array)
int avpriv_set_systematic_pal2(uint32_t pal[256], enum AVPixelFormat pix_fmt)
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
const char * av_color_range_name(enum AVColorRange range)
static int scale_field(ScaleContext *scale, AVFrame *dst, AVFrame *src, int field)
#define LIBAVUTIL_VERSION_INT
const AVClass ff_framesync_class
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.
#define fs(width, name, subs,...)
@ AVCHROMA_LOC_LEFT
MPEG-2/4 4:2:0, H.264 default for 4:2:0.
Rational number (pair of numerator and denominator).
@ AVCHROMA_LOC_TOPLEFT
ITU-R 601, SMPTE 274M 296M S314M(DV 4:1:1), mpeg2 4:2:2.
static const AVClass * scale2ref_child_class_iterate(void **iter)
AVFilterLink ** inputs
array of pointers to input links
const char * av_default_item_name(void *ptr)
Return the context name.
struct SwsContext * sws_alloc_context(void)
Allocate an empty SwsContext.
@ AVCOL_SPC_YCGCO
used by Dirac / VC-2 and H.264 FRext, see ITU-T SG16
int av_opt_get_int(void *obj, const char *name, int search_flags, int64_t *out_val)
int sws_setColorspaceDetails(struct SwsContext *c, const int inv_table[4], int srcRange, const int table[4], int dstRange, int brightness, int contrast, int saturation)
uint64_t flags
Combination of AV_PIX_FMT_FLAG_...
const AVFilter ff_vf_scale2ref
@ AVCOL_RANGE_UNSPECIFIED
Undefined Behavior In the C some operations are like signed integer dereferencing freed accessing outside allocated Undefined Behavior must not occur in a C it is not safe even if the output of undefined operations is unused The unsafety may seem nit picking but Optimizing compilers have in fact optimized code on the assumption that no undefined Behavior occurs Optimizing code based on wrong assumptions can and has in some cases lead to effects beyond the output of computations The signed integer overflow problem in speed critical code Code which is highly optimized and works with signed integers sometimes has the problem that often the output of the computation does not c
int av_opt_set_int(void *obj, const char *name, int64_t val, int search_flags)
static FilterLink * ff_filter_link(AVFilterLink *link)
@ AV_CLASS_CATEGORY_FILTER
int av_opt_copy(void *dst, const void *src)
Copy options from src object into dest object.
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
void *(* child_next)(void *obj, void *prev)
Return next AVOptions-enabled child or NULL.
int format
agreed upon media format
static const AVClass * child_class_iterate(void **iter)
AVRational time_base
Time base for the timestamps in this frame.
static int scale_frame(AVFilterLink *link, AVFrame **frame_in, AVFrame **frame_out)
@ AVCHROMA_LOC_UNSPECIFIED
attribute_deprecated int64_t pkt_pos
reordered pos from the last AVPacket that has been input into the decoder
int format
format of the frame, -1 if unknown or unset Values correspond to enum AVPixelFormat for video frames,...
AVFilterContext * src
source filter
enum AVPixelFormat av_pix_fmt_desc_get_id(const AVPixFmtDescriptor *desc)
static int filter_frame(AVFilterLink *link, AVFrame *in)
int av_parse_video_size(int *width_ptr, int *height_ptr, const char *str)
Parse str and put in width_ptr and height_ptr the detected values.
#define sws_isSupportedInput(x)
@ AVCOL_SPC_SMPTE240M
derived from 170M primaries and D65 white point, 170M is derived from BT470 System M's primaries
int vsub
chroma subsampling
int sws_scale_frame(struct SwsContext *c, AVFrame *dst, const AVFrame *src)
Scale source data from src and write the output to dst.
static int config_props(AVFilterLink *outlink)
int output_is_pal
set to 1 if the output format is paletted
int sws_isSupportedEndiannessConversion(enum AVPixelFormat pix_fmt)
#define i(width, name, range_min, range_max)
@ AVCOL_SPC_BT2020_NCL
ITU-R BT2020 non-constant luminance system.
int w
agreed upon image width
int ff_filter_get_nb_threads(AVFilterContext *ctx)
Get number of threads for current filter instance.
const char * name
Pad name.
char * h_expr
height expression string
#define AV_FRAME_FLAG_INTERLACED
A flag to mark frames whose content is interlaced.
@ AVCOL_RANGE_MPEG
Narrow or limited range content.
static void calc_chroma_pos(int *h_pos_out, int *v_pos_out, int chroma_loc, int h_pos_override, int v_pos_override, int h_sub, int v_sub, int index)
static const AVFilterPad avfilter_vf_scale_outputs[]
@ AV_PIX_FMT_PAL8
8 bits with AV_PIX_FMT_RGB32 palette
#define FFSWAP(type, a, b)
const char * class_name
The name of the class; usually it is the same name as the context structure type to which the AVClass...
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
static void * child_next(void *obj, void *prev)
int ff_framesync_init(FFFrameSync *fs, AVFilterContext *parent, unsigned nb_in)
Initialize a frame sync structure.
AVRational sample_aspect_ratio
Sample aspect ratio for the video frame, 0/1 if unknown/unspecified.
int sws_getColorspaceDetails(struct SwsContext *c, int **inv_table, int *srcRange, int **table, int *dstRange, int *brightness, int *contrast, int *saturation)
int ff_scale_adjust_dimensions(AVFilterLink *inlink, int *ret_w, int *ret_h, int force_original_aspect_ratio, int force_divisible_by)
Transform evaluated width and height obtained from ff_scale_eval_dimensions into actual target width ...
av_warn_unused_result int sws_init_context(struct SwsContext *sws_context, SwsFilter *srcFilter, SwsFilter *dstFilter)
Initialize the swscaler context sws_context.
static int scale_eval_dimensions(AVFilterContext *ctx)
static const char *const var_names[]
static const AVOption scale_options[]
void sws_freeContext(struct SwsContext *swsContext)
Free the swscaler context swsContext.
int h
agreed upon image height
static int do_scale(FFFrameSync *fs)
@ AVCHROMA_LOC_CENTER
MPEG-1 4:2:0, JPEG 4:2:0, H.263 4:2:0.
@ AVCOL_SPC_FCC
FCC Title 47 Code of Federal Regulations 73.682 (a)(20)
@ AV_OPT_TYPE_INT
Underlying C type is int.
static av_cold void uninit(AVFilterContext *ctx)
int force_original_aspect_ratio
static int ref[MAX_W *MAX_W]
AVRational time_base
Define the time base used by the PTS of the frames/samples which will pass through this link.
static const AVFilterPad avfilter_vf_scale2ref_inputs[]
AVRational av_mul_q(AVRational b, AVRational c)
Multiply two rationals.
#define FF_DISABLE_DEPRECATION_WARNINGS
char * av_strdup(const char *s)
Duplicate a string.
const int * sws_getCoefficients(int colorspace)
Return a pointer to yuv<->rgb coefficients for the given colorspace suitable for sws_setColorspaceDet...
static const int sws_colorspaces[]
Descriptor that unambiguously describes how the bits of a pixel are stored in the up to 4 data planes...
static void scale(int *out, const int *in, const int w, const int h, const int shift)
@ AV_OPT_TYPE_BOOL
Underlying C type is int.
enum AVColorSpace colorspace
For non-YUV links, these are respectively set to fallback values (as appropriate for that colorspace)...
static const AVClass scale_class
char * w_expr
width expression string
#define flags(name, subs,...)
@ AVCHROMA_LOC_NB
Not part of ABI.
int linesize[AV_NUM_DATA_POINTERS]
For video, a positive or negative value, which is typically indicating the size in bytes of each pict...
int av_opt_get(void *obj, const char *name, int search_flags, uint8_t **out_val)
AVRational frame_rate
Frame rate of the stream on the link, or 1/0 if unknown or variable.
int ff_framesync_activate(FFFrameSync *fs)
Examine the frames in the filter's input and try to produce output.
@ AV_OPT_TYPE_STRING
Underlying C type is a uint8_t* that is either NULL or points to a C string allocated with the av_mal...
@ AVCOL_SPC_BT709
also ITU-R BT1361 / IEC 61966-2-4 xvYCC709 / derived in SMPTE RP 177 Annex B
#define AV_PIX_FMT_FLAG_PAL
Pixel format has a palette in data[1], values are indexes in this palette.
enum AVColorRange color_range
agreed upon YUV color range
@ AV_OPT_TYPE_CONST
Special option type for declaring named constants.
const AVFilter ff_vf_scale
#define FILTER_QUERY_FUNC(func)
@ AVCHROMA_LOC_BOTTOMLEFT
uint8_t log2_chroma_h
Amount to shift the luma height right to find the chroma height.
void ff_framesync_preinit(FFFrameSync *fs)
Pre-initialize a frame sync structure.
static void * av_x_if_null(const void *p, const void *x)
Return x default pointer in case p is NULL.
const char * av_get_pix_fmt_name(enum AVPixelFormat pix_fmt)
Return the short name for a pixel format, NULL in case pix_fmt is unknown.
double param[2]
Input parameters for scaling algorithms that need them.