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) {
512 &cfg_in[0]->color_spaces)) < 0)
516 &cfg_in[0]->color_ranges)) < 0)
551 main_link =
ctx->inputs[0];
561 (
double)
inlink->sample_aspect_ratio.num /
inlink->sample_aspect_ratio.den : 1;
580 if (
scale->uses_ref) {
599 expr =
scale->h_expr;
607 expr =
scale->w_expr;
620 "Error when evaluating the expression '%s'.\n", expr);
625 int h_pos_override,
int v_pos_override,
626 int h_sub,
int v_sub,
int index)
638 h_pos *= (1 << h_sub) - 1;
639 v_pos *= (1 << v_sub) - 1;
641 if (h_pos_override != -513)
642 h_pos = h_pos_override;
643 if (v_pos_override != -513)
644 v_pos = v_pos_override;
647 if (v_sub &&
index > 0) {
656 v_pos += (256 << v_sub) - 256;
664 *h_pos_out = h_sub ? h_pos : -513;
665 *v_pos_out = v_sub ? v_pos : -513;
679 uint8_t *flags_val =
NULL;
680 int in_range, in_colorspace;
690 scale->force_original_aspect_ratio,
691 scale->force_divisible_by);
696 if (outlink->
w > INT_MAX ||
697 outlink->
h > INT_MAX ||
698 (outlink->
h *
inlink->w) > INT_MAX ||
699 (outlink->
w *
inlink->h) > INT_MAX)
708 in_range =
scale->in_range;
712 in_colorspace =
scale->in_color_matrix;
713 if (in_colorspace == -1 )
723 if (inlink0->
w == outlink->
w &&
724 inlink0->
h == outlink->
h &&
728 scale->in_chroma_loc ==
scale->out_chroma_loc)
734 for (
i = 0;
i < 3;
i++) {
735 int in_full, out_full, brightness, contrast, saturation;
736 int h_chr_pos, v_chr_pos;
737 const int *inv_table, *
table;
762 desc->log2_chroma_w,
desc->log2_chroma_h,
i);
776 (
int **)&
table, &out_full,
777 &brightness, &contrast, &saturation);
779 if (
scale->in_color_matrix == -1 )
790 brightness, contrast, saturation);
792 if (!
scale->interlaced)
805 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",
808 inlink->sample_aspect_ratio.num,
inlink->sample_aspect_ratio.den,
821 scale->fs.in[0].time_base =
ctx->inputs[0]->time_base;
822 scale->fs.in[0].sync = 1;
825 if (
scale->uses_ref) {
827 scale->fs.in[1].time_base =
ctx->inputs[1]->time_base;
828 scale->fs.in[1].sync = 0;
873 for (
int i = 0;
i < 4 &&
frame->data[
i];
i++) {
874 if (
i == 1 && is_pal)
883 int orig_h_src =
src->height;
884 int orig_h_dst =
dst->height;
894 for (
int i = 0;
i < 4;
i++) {
895 src->linesize[
i] *= 2;
896 dst->linesize[
i] *= 2;
906 for (
int i = 0;
i < 4;
i++) {
907 src->linesize[
i] /= 2;
908 dst->linesize[
i] /= 2;
910 src->height = orig_h_src;
911 dst->height = orig_h_dst;
1031 out->width = outlink->
w;
1032 out->height = outlink->
h;
1036 out->chroma_location =
scale->out_chroma_loc;
1038 if (
scale->output_is_pal)
1041 av_reduce(&
out->sample_aspect_ratio.num, &
out->sample_aspect_ratio.den,
1046 if (
scale->interlaced>0 || (
scale->interlaced<0 &&
1070 int ret = 0, frame_changed;
1076 if (
scale->uses_ref) {
1086 frame_changed =
ref->width != reflink->
w ||
1087 ref->height != reflink->
h ||
1094 if (frame_changed) {
1096 reflink->
w =
ref->width;
1097 reflink->
h =
ref->height;
1111 #if FF_API_FRAME_PKT
1161 if (frame_changed) {
1176 #if FF_API_FRAME_PKT
1187 char *res,
int res_len,
int flags)
1194 w = !strcmp(cmd,
"width") || !strcmp(cmd,
"w");
1195 h = !strcmp(cmd,
"height") || !strcmp(cmd,
"h");
1199 pexpr_ptr =
w ? &
scale->w_pexpr : &
scale->h_pexpr;
1219 switch ((uintptr_t) *iter) {
1221 *iter = (
void*)(uintptr_t) 1;
1224 *iter = (
void*)(uintptr_t) 2;
1236 if (prev ==
s->sws_opts)
1241 #define OFFSET(x) offsetof(ScaleContext, x)
1242 #define FLAGS AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_FILTERING_PARAM
1243 #define TFLAGS AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_RUNTIME_PARAM
1284 {
"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 },
1285 {
"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 },
1286 {
"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 },
1287 {
"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 },
1288 {
"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" },
1292 {
"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 },
1328 .description =
NULL_IF_CONFIG_SMALL(
"Scale the input video size and/or convert the image format."),
1345 *iter = (
void*)(uintptr_t)
c;
1396 .
name =
"scale2ref",
1397 .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 sws_setColorspaceDetails(SwsContext *c, const int inv_table[4], int srcRange, const int table[4], int dstRange, int brightness, int contrast, int saturation)
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)
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 sws_freeContext(SwsContext *swsContext)
Free the swscaler context swsContext.
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
av_warn_unused_result int sws_init_context(SwsContext *sws_context, SwsFilter *srcFilter, SwsFilter *dstFilter)
Initialize the swscaler context sws_context.
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)
struct SwsContext SwsContext
#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.
static int query_formats(const AVFilterContext *ctx, AVFilterFormatsConfig **cfg_in, AVFilterFormatsConfig **cfg_out)
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.
@ 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)
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.
SwsContext * sws_alloc_context(void)
Allocate an empty SwsContext.
uint8_t ptrdiff_t const uint8_t ptrdiff_t int intptr_t intptr_t int int16_t * dst
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
int sws_getColorspaceDetails(SwsContext *c, int **inv_table, int *srcRange, int **table, int *dstRange, int *brightness, int *contrast, int *saturation)
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
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.
#define FILTER_QUERY_FUNC2(func)
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 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 ...
static int scale_eval_dimensions(AVFilterContext *ctx)
static const char *const var_names[]
static const AVOption scale_options[]
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 av_opt_get(void *obj, const char *name, int search_flags, uint8_t **out_val)
int sws_scale_frame(SwsContext *sws, AVFrame *dst, const AVFrame *src)
Scale source data from src and write the output to dst.
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
@ 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.