FFmpeg coverage


Directory: ../../../ffmpeg/
File: src/libavfilter/vf_scale_vaapi.c
Date: 2026-05-02 03:33:10
Exec Total Coverage
Lines: 0 106 0.0%
Functions: 0 4 0.0%
Branches: 0 83 0.0%

Line Branch Exec Source
1 /*
2 * This file is part of FFmpeg.
3 *
4 * FFmpeg is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2.1 of the License, or (at your option) any later version.
8 *
9 * FFmpeg is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
13 *
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with FFmpeg; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17 */
18
19 #include <string.h>
20
21 #include "libavutil/opt.h"
22 #include "libavutil/pixdesc.h"
23
24 #include "avfilter.h"
25 #include "filters.h"
26 #include "scale_eval.h"
27 #include "video.h"
28 #include "vaapi_vpp.h"
29
30 typedef struct ScaleVAAPIContext {
31 VAAPIVPPContext vpp_ctx; // must be the first field
32
33 char *output_format_string;
34
35 int mode;
36
37 char *w_expr; // width expression string
38 char *h_expr; // height expression string
39
40 int force_original_aspect_ratio;
41 int force_divisible_by;
42 int reset_sar;
43
44 char *colour_primaries_string;
45 char *colour_transfer_string;
46 char *colour_matrix_string;
47 int colour_range;
48 char *chroma_location_string;
49
50 enum AVColorPrimaries colour_primaries;
51 enum AVColorTransferCharacteristic colour_transfer;
52 enum AVColorSpace colour_matrix;
53 enum AVChromaLocation chroma_location;
54 } ScaleVAAPIContext;
55
56 static const char *scale_vaapi_mode_name(int mode)
57 {
58 switch (mode) {
59 #define D(name) case VA_FILTER_SCALING_ ## name: return #name
60 D(DEFAULT);
61 D(FAST);
62 D(HQ);
63 D(NL_ANAMORPHIC);
64 #undef D
65 default:
66 return "Invalid";
67 }
68 }
69
70
71 static int scale_vaapi_config_output(AVFilterLink *outlink)
72 {
73 AVFilterLink *inlink = outlink->src->inputs[0];
74 AVFilterContext *avctx = outlink->src;
75 VAAPIVPPContext *vpp_ctx = avctx->priv;
76 ScaleVAAPIContext *ctx = avctx->priv;
77 double w_adj = 1.0;
78 int err;
79
80 if ((err = ff_scale_eval_dimensions(ctx,
81 ctx->w_expr, ctx->h_expr,
82 inlink, outlink,
83 &vpp_ctx->output_width, &vpp_ctx->output_height)) < 0)
84 return err;
85
86 if (ctx->reset_sar)
87 w_adj = inlink->sample_aspect_ratio.num ?
88 (double)inlink->sample_aspect_ratio.num / inlink->sample_aspect_ratio.den : 1;
89
90 err = ff_scale_adjust_dimensions(inlink, &vpp_ctx->output_width, &vpp_ctx->output_height,
91 ctx->force_original_aspect_ratio,
92 ctx->force_divisible_by, w_adj);
93 if (err < 0)
94 return err;
95
96 if (inlink->w == vpp_ctx->output_width && inlink->h == vpp_ctx->output_height &&
97 (vpp_ctx->input_frames->sw_format == vpp_ctx->output_format ||
98 vpp_ctx->output_format == AV_PIX_FMT_NONE) &&
99 ctx->colour_primaries == AVCOL_PRI_UNSPECIFIED &&
100 ctx->colour_transfer == AVCOL_TRC_UNSPECIFIED &&
101 ctx->colour_matrix == AVCOL_SPC_UNSPECIFIED &&
102 ctx->colour_range == AVCOL_RANGE_UNSPECIFIED &&
103 ctx->chroma_location == AVCHROMA_LOC_UNSPECIFIED)
104 vpp_ctx->passthrough = 1;
105
106 err = ff_vaapi_vpp_config_output(outlink);
107 if (err < 0)
108 return err;
109
110 if (ctx->reset_sar)
111 outlink->sample_aspect_ratio = (AVRational){1, 1};
112 else if (inlink->sample_aspect_ratio.num)
113 outlink->sample_aspect_ratio = av_mul_q((AVRational){outlink->h * inlink->w, outlink->w * inlink->h}, inlink->sample_aspect_ratio);
114 else
115 outlink->sample_aspect_ratio = inlink->sample_aspect_ratio;
116
117 return 0;
118 }
119
120 static int scale_vaapi_filter_frame(AVFilterLink *inlink, AVFrame *input_frame)
121 {
122 AVFilterContext *avctx = inlink->dst;
123 AVFilterLink *outlink = avctx->outputs[0];
124 VAAPIVPPContext *vpp_ctx = avctx->priv;
125 ScaleVAAPIContext *ctx = avctx->priv;
126 AVFrame *output_frame = NULL;
127 VAProcPipelineParameterBuffer params;
128 int err;
129
130 av_log(avctx, AV_LOG_DEBUG, "Filter input: %s, %ux%u (%"PRId64").\n",
131 av_get_pix_fmt_name(input_frame->format),
132 input_frame->width, input_frame->height, input_frame->pts);
133
134 if (vpp_ctx->passthrough)
135 return ff_filter_frame(outlink, input_frame);
136
137 if (vpp_ctx->va_context == VA_INVALID_ID)
138 return AVERROR(EINVAL);
139
140 output_frame = ff_get_video_buffer(outlink, vpp_ctx->output_width,
141 vpp_ctx->output_height);
142 if (!output_frame) {
143 err = AVERROR(ENOMEM);
144 goto fail;
145 }
146
147 err = av_frame_copy_props(output_frame, input_frame);
148 if (err < 0)
149 goto fail;
150
151 if (output_frame->width != input_frame->width || output_frame->height != input_frame->height) {
152 av_frame_side_data_remove_by_props(&output_frame->side_data,
153 &output_frame->nb_side_data,
154 AV_SIDE_DATA_PROP_SIZE_DEPENDENT);
155 }
156
157 if (ctx->colour_primaries != AVCOL_PRI_UNSPECIFIED)
158 output_frame->color_primaries = ctx->colour_primaries;
159 if (ctx->colour_transfer != AVCOL_TRC_UNSPECIFIED)
160 output_frame->color_trc = ctx->colour_transfer;
161 if (ctx->colour_matrix != AVCOL_SPC_UNSPECIFIED)
162 output_frame->colorspace = ctx->colour_matrix;
163 if (ctx->colour_range != AVCOL_RANGE_UNSPECIFIED)
164 output_frame->color_range = ctx->colour_range;
165 if (ctx->chroma_location != AVCHROMA_LOC_UNSPECIFIED)
166 output_frame->chroma_location = ctx->chroma_location;
167
168 err = ff_vaapi_vpp_init_params(avctx, &params,
169 input_frame, output_frame);
170 if (err < 0)
171 goto fail;
172
173 params.filter_flags |= ctx->mode;
174
175 err = ff_vaapi_vpp_render_picture(avctx, &params, output_frame);
176 if (err < 0)
177 goto fail;
178
179 av_frame_free(&input_frame);
180
181 av_log(avctx, AV_LOG_DEBUG, "Filter output: %s, %ux%u (%"PRId64"), mode: %s.\n",
182 av_get_pix_fmt_name(output_frame->format),
183 output_frame->width, output_frame->height, output_frame->pts,
184 scale_vaapi_mode_name(ctx->mode));
185
186 return ff_filter_frame(outlink, output_frame);
187
188 fail:
189 av_frame_free(&input_frame);
190 av_frame_free(&output_frame);
191 return err;
192 }
193
194 static av_cold int scale_vaapi_init(AVFilterContext *avctx)
195 {
196 VAAPIVPPContext *vpp_ctx = avctx->priv;
197 ScaleVAAPIContext *ctx = avctx->priv;
198
199 ff_vaapi_vpp_ctx_init(avctx);
200 vpp_ctx->pipeline_uninit = ff_vaapi_vpp_pipeline_uninit;
201
202 if (ctx->output_format_string) {
203 vpp_ctx->output_format = av_get_pix_fmt(ctx->output_format_string);
204 if (vpp_ctx->output_format == AV_PIX_FMT_NONE) {
205 av_log(avctx, AV_LOG_ERROR, "Invalid output format.\n");
206 return AVERROR(EINVAL);
207 }
208 } else {
209 // Use the input format once that is configured.
210 vpp_ctx->output_format = AV_PIX_FMT_NONE;
211 }
212
213 #define STRING_OPTION(var_name, func_name, default_value) do { \
214 if (ctx->var_name ## _string) { \
215 int var = av_ ## func_name ## _from_name(ctx->var_name ## _string); \
216 if (var < 0) { \
217 av_log(avctx, AV_LOG_ERROR, "Invalid %s.\n", #var_name); \
218 return AVERROR(EINVAL); \
219 } \
220 ctx->var_name = var; \
221 } else { \
222 ctx->var_name = default_value; \
223 } \
224 } while (0)
225
226 STRING_OPTION(colour_primaries, color_primaries, AVCOL_PRI_UNSPECIFIED);
227 STRING_OPTION(colour_transfer, color_transfer, AVCOL_TRC_UNSPECIFIED);
228 STRING_OPTION(colour_matrix, color_space, AVCOL_SPC_UNSPECIFIED);
229 STRING_OPTION(chroma_location, chroma_location, AVCHROMA_LOC_UNSPECIFIED);
230
231 return 0;
232 }
233
234 #define OFFSET(x) offsetof(ScaleVAAPIContext, x)
235 #define FLAGS (AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM)
236 static const AVOption scale_vaapi_options[] = {
237 { "w", "Output video width",
238 OFFSET(w_expr), AV_OPT_TYPE_STRING, {.str = "iw"}, .flags = FLAGS },
239 { "h", "Output video height",
240 OFFSET(h_expr), AV_OPT_TYPE_STRING, {.str = "ih"}, .flags = FLAGS },
241 { "format", "Output video format (software format of hardware frames)",
242 OFFSET(output_format_string), AV_OPT_TYPE_STRING, .flags = FLAGS },
243 { "mode", "Scaling mode",
244 OFFSET(mode), AV_OPT_TYPE_INT, { .i64 = VA_FILTER_SCALING_HQ },
245 0, VA_FILTER_SCALING_NL_ANAMORPHIC, FLAGS, .unit = "mode" },
246 { "default", "Use the default (depend on the driver) scaling algorithm",
247 0, AV_OPT_TYPE_CONST, { .i64 = VA_FILTER_SCALING_DEFAULT }, 0, 0, FLAGS, .unit = "mode" },
248 { "fast", "Use fast scaling algorithm",
249 0, AV_OPT_TYPE_CONST, { .i64 = VA_FILTER_SCALING_FAST }, 0, 0, FLAGS, .unit = "mode" },
250 { "hq", "Use high quality scaling algorithm",
251 0, AV_OPT_TYPE_CONST, { .i64 = VA_FILTER_SCALING_HQ }, 0, 0, FLAGS, .unit = "mode" },
252 { "nl_anamorphic", "Use nolinear anamorphic scaling algorithm",
253 0, AV_OPT_TYPE_CONST, { .i64 = VA_FILTER_SCALING_NL_ANAMORPHIC }, 0, 0, FLAGS, .unit = "mode" },
254
255 // These colour properties match the ones of the same name in vf_scale.
256 { "out_color_matrix", "Output colour matrix coefficient set",
257 OFFSET(colour_matrix_string), AV_OPT_TYPE_STRING, { .str = NULL }, .flags = FLAGS },
258 { "out_range", "Output colour range",
259 OFFSET(colour_range), AV_OPT_TYPE_INT, { .i64 = AVCOL_RANGE_UNSPECIFIED },
260 AVCOL_RANGE_UNSPECIFIED, AVCOL_RANGE_JPEG, FLAGS, .unit = "range" },
261 { "full", "Full range",
262 0, AV_OPT_TYPE_CONST, { .i64 = AVCOL_RANGE_JPEG }, 0, 0, FLAGS, .unit = "range" },
263 { "limited", "Limited range",
264 0, AV_OPT_TYPE_CONST, { .i64 = AVCOL_RANGE_MPEG }, 0, 0, FLAGS, .unit = "range" },
265 { "jpeg", "Full range",
266 0, AV_OPT_TYPE_CONST, { .i64 = AVCOL_RANGE_JPEG }, 0, 0, FLAGS, .unit = "range" },
267 { "mpeg", "Limited range",
268 0, AV_OPT_TYPE_CONST, { .i64 = AVCOL_RANGE_MPEG }, 0, 0, FLAGS, .unit = "range" },
269 { "tv", "Limited range",
270 0, AV_OPT_TYPE_CONST, { .i64 = AVCOL_RANGE_MPEG }, 0, 0, FLAGS, .unit = "range" },
271 { "pc", "Full range",
272 0, AV_OPT_TYPE_CONST, { .i64 = AVCOL_RANGE_JPEG }, 0, 0, FLAGS, .unit = "range" },
273 // These colour properties are new here.
274 { "out_color_primaries", "Output colour primaries",
275 OFFSET(colour_primaries_string), AV_OPT_TYPE_STRING,
276 { .str = NULL }, .flags = FLAGS },
277 { "out_color_transfer", "Output colour transfer characteristics",
278 OFFSET(colour_transfer_string), AV_OPT_TYPE_STRING,
279 { .str = NULL }, .flags = FLAGS },
280 { "out_chroma_location", "Output chroma sample location",
281 OFFSET(chroma_location_string), AV_OPT_TYPE_STRING,
282 { .str = NULL }, .flags = FLAGS },
283 { "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, SCALE_FORCE_OAR_NB-1, FLAGS, .unit = "force_oar" },
284 { "disable", NULL, 0, AV_OPT_TYPE_CONST, {.i64 = SCALE_FORCE_OAR_DISABLE }, 0, 0, FLAGS, .unit = "force_oar" },
285 { "decrease", NULL, 0, AV_OPT_TYPE_CONST, {.i64 = SCALE_FORCE_OAR_DECREASE }, 0, 0, FLAGS, .unit = "force_oar" },
286 { "increase", NULL, 0, AV_OPT_TYPE_CONST, {.i64 = SCALE_FORCE_OAR_INCREASE }, 0, 0, FLAGS, .unit = "force_oar" },
287 { "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 },
288 { "reset_sar", "reset SAR to 1 and scale to square pixels if scaling proportionally", OFFSET(reset_sar), AV_OPT_TYPE_BOOL, { .i64 = 0}, 0, 1, FLAGS },
289
290 { NULL },
291 };
292
293 AVFILTER_DEFINE_CLASS(scale_vaapi);
294
295 static const AVFilterPad scale_vaapi_inputs[] = {
296 {
297 .name = "default",
298 .type = AVMEDIA_TYPE_VIDEO,
299 .filter_frame = &scale_vaapi_filter_frame,
300 .config_props = &ff_vaapi_vpp_config_input,
301 },
302 };
303
304 static const AVFilterPad scale_vaapi_outputs[] = {
305 {
306 .name = "default",
307 .type = AVMEDIA_TYPE_VIDEO,
308 .config_props = &scale_vaapi_config_output,
309 },
310 };
311
312 const FFFilter ff_vf_scale_vaapi = {
313 .p.name = "scale_vaapi",
314 .p.description = NULL_IF_CONFIG_SMALL("Scale to/from VAAPI surfaces."),
315 .p.priv_class = &scale_vaapi_class,
316 .priv_size = sizeof(ScaleVAAPIContext),
317 .init = &scale_vaapi_init,
318 .uninit = &ff_vaapi_vpp_ctx_uninit,
319 FILTER_INPUTS(scale_vaapi_inputs),
320 FILTER_OUTPUTS(scale_vaapi_outputs),
321 FILTER_QUERY_FUNC2(&ff_vaapi_vpp_query_formats),
322 .flags_internal = FF_FILTER_FLAG_HWFRAME_AWARE,
323 };
324