FFmpeg
graph.c
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2024 Niklas Haas
3  *
4  * This file is part of FFmpeg.
5  *
6  * FFmpeg is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * FFmpeg is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with FFmpeg; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19  */
20 
21 #include "libavutil/avassert.h"
22 #include "libavutil/cpu.h"
23 #include "libavutil/error.h"
24 #include "libavutil/hwcontext.h"
25 #include "libavutil/imgutils.h"
26 #include "libavutil/macros.h"
27 #include "libavutil/mem.h"
28 #include "libavutil/opt.h"
29 #include "libavutil/pixdesc.h"
30 #include "libavutil/refstruct.h"
31 #include "libavutil/slicethread.h"
32 
33 #include "libswscale/swscale.h"
34 #include "libswscale/format.h"
35 
36 #include "cms.h"
37 #include "lut3d.h"
38 #include "swscale_internal.h"
39 #include "graph.h"
40 #include "ops.h"
41 #include "ops_dispatch.h"
42 #if CONFIG_VULKAN
43 #include "vulkan/ops.h"
44 #endif
45 
47 {
48  if (!pass)
49  return width;
50 
51  size_t aligned_w = width;
52  aligned_w = FFALIGN(aligned_w, pass->output->width_align);
53  aligned_w += pass->output->width_pad;
54  return aligned_w <= INT_MAX ? aligned_w : width;
55 }
56 
57 /* Allocates one buffer per plane */
59 {
60  int ret = av_image_check_size2(dst->width, dst->height, INT64_MAX,
61  dst->format, 0, NULL);
62  if (ret < 0)
63  return ret;
64 
65  const int align = av_cpu_max_align();
66  const int aligned_w = FFALIGN(dst->width, align);
67  ret = av_image_fill_linesizes(dst->linesize, dst->format, aligned_w);
68  if (ret < 0)
69  return ret;
70 
71  ptrdiff_t linesize1[4];
72  for (int i = 0; i < 4; i++)
73  linesize1[i] = dst->linesize[i] = FFALIGN(dst->linesize[i], align);
74 
75  size_t sizes[4];
76  ret = av_image_fill_plane_sizes(sizes, dst->format, dst->height, linesize1);
77  if (ret < 0)
78  return ret;
79 
80  for (int i = 0; i < 4; i++) {
81  if (!sizes[i])
82  break;
84  if (!buf)
85  return AVERROR(ENOMEM);
86  dst->data[i] = buf->data;
87  dst->buf[i] = buf;
88  }
89 
90  return 0;
91 }
92 
93 #if CONFIG_VULKAN
94 static int pass_alloc_output_hw(SwsPass *pass, AVFrame *avframe,
95  AVBufferRef *dev_ref)
96 {
97  SwsPassBuffer *buffer = pass->output;
98  AVBufferRef *frames_ref = av_hwframe_ctx_alloc(dev_ref);
99  if (!frames_ref)
100  return AVERROR(ENOMEM);
101 
102  AVHWFramesContext *hwfc = (AVHWFramesContext *)frames_ref->data;
103  hwfc->format = AV_PIX_FMT_VULKAN;
104  hwfc->sw_format = pass->format;
105  hwfc->width = buffer->width;
106  hwfc->height = buffer->height;
107 
108  int ret = av_hwframe_ctx_init(frames_ref);
109  if (ret >= 0) {
110  avframe->format = AV_PIX_FMT_VULKAN;
111  ret = av_hwframe_get_buffer(frames_ref, avframe, 0);
112  }
113  av_buffer_unref(&frames_ref);
114  return ret;
115 }
116 #endif
117 
118 static int pass_alloc_output(SwsPass *pass)
119 {
120  if (!pass || pass->output->avframe)
121  return 0;
122 
123  SwsPassBuffer *buffer = pass->output;
124  AVFrame *avframe = av_frame_alloc();
125  if (!avframe)
126  return AVERROR(ENOMEM);
127  avframe->width = buffer->width;
128  avframe->height = buffer->height;
129 
130  int ret;
131 
132 #if CONFIG_VULKAN
133  const SwsGraph *graph = pass->graph;
134  if (graph->src.hw_format == AV_PIX_FMT_VULKAN &&
135  graph->dst.hw_format == AV_PIX_FMT_VULKAN) {
136  AVBufferRef *dev_ref = ff_sws_vk_device_ref(graph->ctx);
137  if (dev_ref) {
138  ret = pass_alloc_output_hw(pass, avframe, dev_ref);
139  if (ret >= 0)
140  goto done;
141  av_frame_unref(avframe);
142  }
143  }
144 #endif
145 
146  avframe->format = pass->format;
147  ret = frame_alloc_planes(avframe);
148  if (ret < 0) {
149  av_frame_free(&avframe);
150  return ret;
151  }
152 
153 #if CONFIG_VULKAN
154 done:
155 #endif
156  buffer->avframe = avframe;
157  ff_sws_frame_from_avframe(&buffer->frame, avframe);
158  return 0;
159 }
160 
161 static void free_buffer(AVRefStructOpaque opaque, void *obj)
162 {
163  SwsPassBuffer *buffer = obj;
164  av_frame_free(&buffer->avframe);
165 }
166 
167 static void pass_free(SwsPass *pass)
168 {
169  if (pass->free)
170  pass->free(pass->priv);
171  av_refstruct_unref(&pass->output);
172  av_free(pass);
173 }
174 
176  int width, int height, SwsPass *input,
177  int align, SwsPassFunc run, SwsPassSetup setup,
178  void *priv, void (*free_cb)(void *priv),
179  SwsPass **out_pass)
180 {
181  int ret;
182  SwsPass *pass = av_mallocz(sizeof(*pass));
183  if (!pass) {
184  if (free_cb)
185  free_cb(priv);
186  return AVERROR(ENOMEM);
187  }
188 
189  pass->graph = graph;
190  pass->run = run;
191  pass->setup = setup;
192  pass->priv = priv;
193  pass->free = free_cb;
194  pass->format = fmt;
195  pass->width = width;
196  pass->height = height;
197  pass->input = input;
198  pass->output = av_refstruct_alloc_ext(sizeof(*pass->output), 0, NULL, free_buffer);
199  if (!pass->output) {
200  ret = AVERROR(ENOMEM);
201  goto fail;
202  }
203 
204  if (!align) {
205  pass->slice_h = pass->height;
206  pass->num_slices = 1;
207  } else {
208  pass->slice_h = (pass->height + graph->num_threads - 1) / graph->num_threads;
209  pass->slice_h = FFALIGN(pass->slice_h, align);
210  pass->num_slices = (pass->height + pass->slice_h - 1) / pass->slice_h;
211  }
212 
213  /* Align output buffer to include extra slice padding */
214  pass->output->height = pass->slice_h * pass->num_slices;
215  pass->output->width = pass->width;
216  pass->output->width_align = 1;
217 
218  ret = av_dynarray_add_nofree(&graph->passes, &graph->num_passes, pass);
219  if (ret < 0)
220  goto fail;
221 
222  *out_pass = pass;
223  return 0;
224 
225 fail:
226  pass_free(pass);
227  return ret;
228 }
229 
230 static void frame_shift(const SwsFrame *f, const int y, uint8_t *data[4])
231 {
232  for (int i = 0; i < 4; i++) {
233  if (f->data[i])
234  data[i] = f->data[i] + (y >> ff_fmt_vshift(f->format, i)) * f->linesize[i];
235  else
236  data[i] = NULL;
237  }
238 }
239 
240 static void run_copy(const SwsFrame *out, const SwsFrame *in, int y, int h,
241  const SwsPass *pass)
242 {
243  uint8_t *in_data[4], *out_data[4];
244  frame_shift(in, y, in_data);
245  frame_shift(out, y, out_data);
246 
247  for (int i = 0; i < 4 && out_data[i]; i++) {
248  const int lines = h >> ff_fmt_vshift(in->format, i);
249  av_assert1(in_data[i]);
250 
251  if (in_data[i] == out_data[i]) {
252  av_assert0(in->linesize[i] == out->linesize[i]);
253  } else if (in->linesize[i] == out->linesize[i]) {
254  memcpy(out_data[i], in_data[i], lines * out->linesize[i]);
255  } else {
256  const int linesize = FFMIN(out->linesize[i], in->linesize[i]);
257  for (int j = 0; j < lines; j++) {
258  memcpy(out_data[i], in_data[i], linesize);
259  in_data[i] += in->linesize[i];
260  out_data[i] += out->linesize[i];
261  }
262  }
263  }
264 }
265 
266 static void run_rgb0(const SwsFrame *out, const SwsFrame *in, int y, int h,
267  const SwsPass *pass)
268 {
269  SwsInternal *c = pass->priv;
270  const int x0 = c->src0Alpha - 1;
271  const int w4 = 4 * pass->width;
272  const int src_stride = in->linesize[0];
273  const int dst_stride = out->linesize[0];
274  const uint8_t *src = in->data[0] + y * src_stride;
275  uint8_t *dst = out->data[0] + y * dst_stride;
276 
277  for (int y = 0; y < h; y++) {
278  memcpy(dst, src, w4 * sizeof(*dst));
279  for (int x = x0; x < w4; x += 4)
280  dst[x] = 0xFF;
281 
282  src += src_stride;
283  dst += dst_stride;
284  }
285 }
286 
287 static void run_xyz2rgb(const SwsFrame *out, const SwsFrame *in, int y, int h,
288  const SwsPass *pass)
289 {
290  const SwsInternal *c = pass->priv;
291  c->xyz12Torgb48(c, out->data[0] + y * out->linesize[0], out->linesize[0],
292  in->data[0] + y * in->linesize[0], in->linesize[0],
293  pass->width, h);
294 }
295 
296 static void run_rgb2xyz(const SwsFrame *out, const SwsFrame *in, int y, int h,
297  const SwsPass *pass)
298 {
299  const SwsInternal *c = pass->priv;
300  c->rgb48Toxyz12(c, out->data[0] + y * out->linesize[0], out->linesize[0],
301  in->data[0] + y * in->linesize[0], in->linesize[0],
302  pass->width, h);
303 }
304 
305 /***********************************************************************
306  * Internal ff_swscale() wrapper. This reuses the legacy scaling API. *
307  * This is considered fully deprecated, and will be replaced by a full *
308  * reimplementation ASAP. *
309  ***********************************************************************/
310 
311 static void free_legacy_swscale(void *priv)
312 {
313  SwsContext *sws = priv;
314  sws_free_context(&sws);
315 }
316 
317 static int setup_legacy_swscale(const SwsFrame *out, const SwsFrame *in,
318  const SwsPass *pass)
319 {
320  SwsContext *sws = pass->priv;
321  SwsInternal *c = sws_internal(sws);
322  if (sws->flags & SWS_BITEXACT && sws->dither == SWS_DITHER_ED && c->dither_error[0]) {
323  for (int i = 0; i < 4; i++)
324  memset(c->dither_error[i], 0, sizeof(c->dither_error[0][0]) * (sws->dst_w + 2));
325  }
326 
327  if (usePal(sws->src_format))
328  ff_update_palette(c, (const uint32_t *) in->data[1]);
329 
330  return 0;
331 }
332 
333 static inline SwsContext *slice_ctx(const SwsPass *pass, int y)
334 {
335  SwsContext *sws = pass->priv;
336  SwsInternal *parent = sws_internal(sws);
337  if (pass->num_slices == 1)
338  return sws;
339 
340  av_assert1(parent->nb_slice_ctx == pass->num_slices);
341  sws = parent->slice_ctx[y / pass->slice_h];
342 
343  if (usePal(sws->src_format)) {
344  SwsInternal *sub = sws_internal(sws);
345  memcpy(sub->pal_yuv, parent->pal_yuv, sizeof(sub->pal_yuv));
346  memcpy(sub->pal_rgb, parent->pal_rgb, sizeof(sub->pal_rgb));
347  }
348 
349  return sws;
350 }
351 
352 static void run_legacy_unscaled(const SwsFrame *out, const SwsFrame *in,
353  int y, int h, const SwsPass *pass)
354 {
355  SwsContext *sws = slice_ctx(pass, y);
356  SwsInternal *c = sws_internal(sws);
357  uint8_t *in_data[4];
358  frame_shift(in, y, in_data);
359 
360  c->convert_unscaled(c, (const uint8_t *const *) in_data, in->linesize, y, h,
361  out->data, out->linesize);
362 }
363 
364 static void run_legacy_swscale(const SwsFrame *out, const SwsFrame *in,
365  int y, int h, const SwsPass *pass)
366 {
367  SwsContext *sws = slice_ctx(pass, y);
368  SwsInternal *c = sws_internal(sws);
369  uint8_t *out_data[4];
370  frame_shift(out, y, out_data);
371 
372  ff_swscale(c, (const uint8_t *const *) in->data, in->linesize, 0,
373  sws->src_h, out_data, out->linesize, y, h);
374 }
375 
376 static void get_chroma_pos(SwsGraph *graph, int *h_chr_pos, int *v_chr_pos,
377  const SwsFormat *fmt)
378 {
379  enum AVChromaLocation chroma_loc = fmt->loc;
380  const int sub_x = fmt->desc->log2_chroma_w;
381  const int sub_y = fmt->desc->log2_chroma_h;
382  int x_pos, y_pos;
383 
384  /* Explicitly default to center siting for compatibility with swscale */
385  if (chroma_loc == AVCHROMA_LOC_UNSPECIFIED) {
386  chroma_loc = AVCHROMA_LOC_CENTER;
387  graph->incomplete |= sub_x || sub_y;
388  }
389 
390  /* av_chroma_location_enum_to_pos() always gives us values in the range from
391  * 0 to 256, but we need to adjust this to the true value range of the
392  * subsampling grid, which may be larger for h/v_sub > 1 */
393  av_chroma_location_enum_to_pos(&x_pos, &y_pos, chroma_loc);
394  x_pos *= (1 << sub_x) - 1;
395  y_pos *= (1 << sub_y) - 1;
396 
397  /* Fix vertical chroma position for interlaced frames */
398  if (sub_y && fmt->interlaced) {
399  /* When vertically subsampling, chroma samples are effectively only
400  * placed next to even rows. To access them from the odd field, we need
401  * to account for this shift by offsetting the distance of one luma row.
402  *
403  * For 4x vertical subsampling (v_sub == 2), they are only placed
404  * next to every *other* even row, so we need to shift by three luma
405  * rows to get to the chroma sample. */
406  if (graph->field == FIELD_BOTTOM)
407  y_pos += (256 << sub_y) - 256;
408 
409  /* Luma row distance is doubled for fields, so halve offsets */
410  y_pos >>= 1;
411  }
412 
413  /* Explicitly strip chroma offsets when not subsampling, because it
414  * interferes with the operation of flags like SWS_FULL_CHR_H_INP */
415  *h_chr_pos = sub_x ? x_pos : -513;
416  *v_chr_pos = sub_y ? y_pos : -513;
417 }
418 
419 static void legacy_chr_pos(SwsGraph *graph, int *chr_pos, int override, int *warned)
420 {
421  if (override == -513 || override == *chr_pos)
422  return;
423 
424  if (!*warned) {
426  "Setting chroma position directly is deprecated, make sure "
427  "the frame is tagged with the correct chroma location.\n");
428  *warned = 1;
429  }
430 
431  *chr_pos = override;
432 }
433 
434 /* Takes over ownership of `sws` */
435 static int init_legacy_subpass(SwsGraph *graph, SwsContext *sws,
437 {
438  SwsInternal *c = sws_internal(sws);
439  const int src_w = sws->src_w, src_h = sws->src_h;
440  const int dst_w = sws->dst_w, dst_h = sws->dst_h;
441  const int unscaled = src_w == dst_w && src_h == dst_h;
442  int align = c->dst_slice_align;
443  SwsPass *pass = NULL;
444  int ret;
445 
446  if (c->cascaded_context[0]) {
447  const int num_cascaded = c->cascaded_context[2] ? 3 : 2;
448  for (int i = 0; i < num_cascaded; i++) {
449  const int is_last = i + 1 == num_cascaded;
450 
451  /* Steal cascaded context, so we can manage its lifetime independently */
452  SwsContext *sub = c->cascaded_context[i];
453  c->cascaded_context[i] = NULL;
454 
455  ret = init_legacy_subpass(graph, sub, input, is_last ? output : &input);
456  if (ret < 0)
457  break;
458  }
459 
460  sws_free_context(&sws);
461  return ret;
462  }
463 
464  if (sws->dither == SWS_DITHER_ED && !c->convert_unscaled)
465  align = 0; /* disable slice threading */
466 
467  if (c->src0Alpha && !c->dst0Alpha && isALPHA(sws->dst_format)) {
468  ret = ff_sws_graph_add_pass(graph, AV_PIX_FMT_RGBA, src_w, src_h, input,
469  1, run_rgb0, NULL, c, NULL, &input);
470  if (ret < 0) {
471  sws_free_context(&sws);
472  return ret;
473  }
474  }
475 
476  if (c->srcXYZ && !(c->dstXYZ && unscaled)) {
477  ret = ff_sws_graph_add_pass(graph, AV_PIX_FMT_RGB48, src_w, src_h, input,
478  1, run_xyz2rgb, NULL, c, NULL, &input);
479  if (ret < 0) {
480  sws_free_context(&sws);
481  return ret;
482  }
483  }
484 
485  ret = ff_sws_graph_add_pass(graph, sws->dst_format, dst_w, dst_h, input, align,
486  c->convert_unscaled ? run_legacy_unscaled : run_legacy_swscale,
488  if (ret < 0)
489  return ret;
490 
491  /**
492  * For slice threading, we need to create sub contexts, similar to how
493  * swscale normally handles it internally. The most important difference
494  * is that we handle cascaded contexts before threaded contexts; whereas
495  * context_init_threaded() does it the other way around.
496  */
497 
498  if (pass->num_slices > 1) {
499  c->slice_ctx = av_calloc(pass->num_slices, sizeof(*c->slice_ctx));
500  if (!c->slice_ctx)
501  return AVERROR(ENOMEM);
502 
503  for (int i = 0; i < pass->num_slices; i++) {
504  SwsContext *slice;
505  SwsInternal *c2;
506  slice = c->slice_ctx[i] = sws_alloc_context();
507  if (!slice)
508  return AVERROR(ENOMEM);
509  c->nb_slice_ctx++;
510 
511  c2 = sws_internal(slice);
512  c2->parent = sws;
513 
514  ret = av_opt_copy(slice, sws);
515  if (ret < 0)
516  return ret;
517 
519  if (ret < 0)
520  return ret;
521 
522  sws_setColorspaceDetails(slice, c->srcColorspaceTable,
523  slice->src_range, c->dstColorspaceTable,
524  slice->dst_range, c->brightness, c->contrast,
525  c->saturation);
526 
527  for (int i = 0; i < FF_ARRAY_ELEMS(c->srcColorspaceTable); i++) {
528  c2->srcColorspaceTable[i] = c->srcColorspaceTable[i];
529  c2->dstColorspaceTable[i] = c->dstColorspaceTable[i];
530  }
531  }
532  }
533 
534  if (c->dstXYZ && !(c->srcXYZ && unscaled)) {
535  ret = ff_sws_graph_add_pass(graph, AV_PIX_FMT_RGB48, dst_w, dst_h, pass,
536  1, run_rgb2xyz, NULL, c, NULL, &pass);
537  if (ret < 0)
538  return ret;
539  }
540 
541  *output = pass;
542  return 0;
543 }
544 
545 static int add_legacy_sws_pass(SwsGraph *graph, const SwsFormat *src,
546  const SwsFormat *dst, SwsPass *input,
547  SwsPass **output)
548 {
549  int ret, warned = 0;
550  SwsContext *const ctx = graph->ctx;
551  if (src->hw_format != AV_PIX_FMT_NONE || dst->hw_format != AV_PIX_FMT_NONE)
552  return AVERROR(ENOTSUP);
553 
554  SwsContext *sws = sws_alloc_context();
555  if (!sws)
556  return AVERROR(ENOMEM);
557 
558  sws->flags = ctx->flags;
559  sws->dither = ctx->dither;
560  sws->alpha_blend = ctx->alpha_blend;
561  sws->gamma_flag = ctx->gamma_flag;
562  sws->scaler = ctx->scaler;
563  sws->scaler_sub = ctx->scaler_sub;
564 
565  sws->src_w = src->width;
566  sws->src_h = src->height;
567  sws->src_format = src->format;
568  sws->src_range = src->range == AVCOL_RANGE_JPEG;
569 
570  sws->dst_w = dst->width;
571  sws->dst_h = dst->height;
572  sws->dst_format = dst->format;
573  sws->dst_range = dst->range == AVCOL_RANGE_JPEG;
574  get_chroma_pos(graph, &sws->src_h_chr_pos, &sws->src_v_chr_pos, src);
575  get_chroma_pos(graph, &sws->dst_h_chr_pos, &sws->dst_v_chr_pos, dst);
576 
577  graph->incomplete |= src->range == AVCOL_RANGE_UNSPECIFIED;
578  graph->incomplete |= dst->range == AVCOL_RANGE_UNSPECIFIED;
579 
580  /* Allow overriding chroma position with the legacy API */
581  legacy_chr_pos(graph, &sws->src_h_chr_pos, ctx->src_h_chr_pos, &warned);
582  legacy_chr_pos(graph, &sws->src_v_chr_pos, ctx->src_v_chr_pos, &warned);
583  legacy_chr_pos(graph, &sws->dst_h_chr_pos, ctx->dst_h_chr_pos, &warned);
584  legacy_chr_pos(graph, &sws->dst_v_chr_pos, ctx->dst_v_chr_pos, &warned);
585 
586  for (int i = 0; i < SWS_NUM_SCALER_PARAMS; i++)
587  sws->scaler_params[i] = ctx->scaler_params[i];
588 
589  ret = sws_init_context(sws, NULL, NULL);
590  if (ret < 0) {
591  sws_free_context(&sws);
592  return ret;
593  }
594 
595  /* Set correct color matrices */
596  {
597  int in_full, out_full, brightness, contrast, saturation;
598  const int *inv_table, *table;
599  sws_getColorspaceDetails(sws, (int **)&inv_table, &in_full,
600  (int **)&table, &out_full,
601  &brightness, &contrast, &saturation);
602 
603  inv_table = sws_getCoefficients(src->csp);
604  table = sws_getCoefficients(dst->csp);
605 
606  graph->incomplete |= src->csp != dst->csp &&
607  (src->csp == AVCOL_SPC_UNSPECIFIED ||
608  dst->csp == AVCOL_SPC_UNSPECIFIED);
609 
610  sws_setColorspaceDetails(sws, inv_table, in_full, table, out_full,
611  brightness, contrast, saturation);
612  }
613 
614  return init_legacy_subpass(graph, sws, input, output);
615 }
616 
617 /*********************************
618  * Format conversion and scaling *
619  *********************************/
620 
621 #if CONFIG_UNSTABLE
622 static int add_convert_pass(SwsGraph *graph, const SwsFormat *src,
623  const SwsFormat *dst, SwsPass *input,
624  SwsPass **output)
625 {
626  SwsContext *ctx = graph->ctx;
627  int ret = AVERROR(ENOTSUP);
628 
629  /* Mark the entire new ops infrastructure as experimental for now */
630  if (!(ctx->flags & SWS_UNSTABLE))
631  goto fail;
632 
633  SwsOpList *ops;
634  ret = ff_sws_op_list_generate(ctx, src, dst, &ops, &graph->incomplete);
635  if (ret < 0)
636  goto fail;
637 
638  av_log(ctx, AV_LOG_VERBOSE, "Conversion pass for %s -> %s:\n",
639  av_get_pix_fmt_name(src->format), av_get_pix_fmt_name(dst->format));
640 
641  av_log(ctx, AV_LOG_DEBUG, "Unoptimized operation list:\n");
643 
645  if (ret < 0)
646  goto fail;
647 
648  ret = 0;
649  /* fall through */
650 
651 fail:
652  if (ret == AVERROR(ENOTSUP))
653  return add_legacy_sws_pass(graph, src, dst, input, output);
654  return ret;
655 }
656 #else
657 #define add_convert_pass add_legacy_sws_pass
658 #endif
659 
660 
661 /**************************
662  * Gamut and tone mapping *
663  **************************/
664 
665 static void free_lut3d(void *priv)
666 {
667  SwsLut3D *lut = priv;
668  ff_sws_lut3d_free(&lut);
669 }
670 
671 static int setup_lut3d(const SwsFrame *out, const SwsFrame *in, const SwsPass *pass)
672 {
673  SwsLut3D *lut = pass->priv;
674 
675  /* Update dynamic frame metadata from the original source frame */
676  ff_sws_lut3d_update(lut, &pass->graph->src.color);
677  return 0;
678 }
679 
680 static void run_lut3d(const SwsFrame *out, const SwsFrame *in, int y, int h,
681  const SwsPass *pass)
682 {
683  SwsLut3D *lut = pass->priv;
684  uint8_t *in_data[4], *out_data[4];
685  frame_shift(in, y, in_data);
686  frame_shift(out, y, out_data);
687 
688  ff_sws_lut3d_apply(lut, in_data[0], in->linesize[0], out_data[0],
689  out->linesize[0], pass->width, h);
690 }
691 
694 {
695  enum AVPixelFormat fmt_in, fmt_out;
696  SwsColorMap map = {0};
697  SwsLut3D *lut;
698  int ret;
699 
700  /**
701  * Grayspace does not really have primaries, so just force the use of
702  * the equivalent other primary set to avoid a conversion. Technically,
703  * this does affect the weights used for the Grayscale conversion, but
704  * in practise, that should give the expected results more often than not.
705  */
706  if (isGray(dst.format)) {
707  dst.color = src.color;
708  } else if (isGray(src.format)) {
709  src.color = dst.color;
710  }
711 
712  /* Fully infer color spaces before color mapping logic */
713  graph->incomplete |= ff_infer_colors(&src.color, &dst.color);
714 
715  map.intent = graph->ctx->intent;
716  map.src = src.color;
717  map.dst = dst.color;
718 
720  return 0;
721 
722  if (src.hw_format != AV_PIX_FMT_NONE || dst.hw_format != AV_PIX_FMT_NONE)
723  return AVERROR(ENOTSUP);
724 
725  lut = ff_sws_lut3d_alloc();
726  if (!lut)
727  return AVERROR(ENOMEM);
728 
729  fmt_in = ff_sws_lut3d_pick_pixfmt(src, 0);
730  fmt_out = ff_sws_lut3d_pick_pixfmt(dst, 1);
731  if (fmt_in != src.format) {
732  SwsFormat tmp = src;
733  tmp.format = fmt_in;
734  ret = add_convert_pass(graph, &src, &tmp, input, &input);
735  if (ret < 0) {
736  ff_sws_lut3d_free(&lut);
737  return ret;
738  }
739  }
740 
741  ret = ff_sws_lut3d_generate(lut, fmt_in, fmt_out, &map);
742  if (ret < 0) {
743  ff_sws_lut3d_free(&lut);
744  return ret;
745  }
746 
747  return ff_sws_graph_add_pass(graph, fmt_out, src.width, src.height,
748  input, 1, run_lut3d, setup_lut3d, lut,
749  free_lut3d, output);
750 }
751 
752 /***************************************
753  * Main filter graph construction code *
754  ***************************************/
755 
756 static int init_passes(SwsGraph *graph)
757 {
758  SwsFormat src = graph->src;
759  SwsFormat dst = graph->dst;
760  SwsPass *pass = NULL; /* read from main input image */
761  int ret;
762 
763  ret = adapt_colors(graph, src, dst, pass, &pass);
764  if (ret < 0)
765  return ret;
766  src.format = pass ? pass->format : src.format;
767  src.color = dst.color;
768 
769  if (!ff_fmt_equal(&src, &dst)) {
770  ret = add_convert_pass(graph, &src, &dst, pass, &pass);
771  if (ret < 0)
772  return ret;
773  }
774 
775  if (pass)
776  return 0;
777 
778  /* No passes were added, so no operations were necessary */
779  graph->noop = 1;
780 
781  /* Add threaded memcpy pass */
782  return ff_sws_graph_add_pass(graph, dst.format, dst.width, dst.height,
783  pass, 1, run_copy, NULL, NULL, NULL, &pass);
784 }
785 
786 static void sws_graph_worker(void *priv, int jobnr, int threadnr, int nb_jobs,
787  int nb_threads)
788 {
789  SwsGraph *graph = priv;
790  const SwsPass *pass = graph->exec.pass;
791  const int slice_y = jobnr * pass->slice_h;
792  const int slice_h = FFMIN(pass->slice_h, pass->height - slice_y);
793 
794  pass->run(graph->exec.output, graph->exec.input, slice_y, slice_h, pass);
795 }
796 
798 {
799  return av_mallocz(sizeof(SwsGraph));
800 }
801 
802 static void graph_uninit(SwsGraph *graph)
803 {
805 
806  for (int i = 0; i < graph->num_passes; i++)
807  pass_free(graph->passes[i]);
808  av_free(graph->passes);
809 
810  memset(graph, 0, sizeof(*graph));
811 }
812 
814  const SwsFormat *src, int field)
815 {
816  int ret;
817  if (graph->ctx) {
818  av_log(ctx, AV_LOG_ERROR, "Graph is already initialized\n");
819  return AVERROR(EINVAL);
820  }
821 
822  graph->ctx = ctx;
823  graph->src = *src;
824  graph->dst = *dst;
825  graph->field = field;
826  graph->opts_copy = *ctx;
827 
828  if (ctx->threads == 1) {
829  graph->num_threads = 1;
830  } else {
831  ret = avpriv_slicethread_create(&graph->slicethread, (void *) graph,
832  sws_graph_worker, NULL, ctx->threads);
833  if (ret == AVERROR(ENOSYS)) {
834  /* Fall back to single threaded operation */
835  graph->num_threads = 1;
836  } else if (ret < 0) {
837  goto error;
838  } else {
839  graph->num_threads = ret;
840  }
841  }
842 
843  ret = init_passes(graph);
844  if (ret < 0)
845  goto error;
846 
847  /* Resolve output buffers for all intermediate passes */
848  for (int i = 0; i < graph->num_passes; i++) {
849  ret = pass_alloc_output(graph->passes[i]->input);
850  if (ret < 0)
851  goto error;
852  }
853 
854  return 0;
855 
856 error:
857  graph_uninit(graph);
858  return ret;
859 }
860 
862  int field, SwsGraph **out_graph)
863 {
864  SwsGraph *graph = ff_sws_graph_alloc();
865  if (!graph)
866  return AVERROR(ENOMEM);
867 
868  int ret = ff_sws_graph_init(graph, ctx, dst, src, field);
869  if (ret < 0) {
870  ff_sws_graph_free(&graph);
871  return ret;
872  }
873 
874  *out_graph = graph;
875  return 0;
876 }
877 
878 void ff_sws_graph_rollback(SwsGraph *graph, int since_idx)
879 {
880  for (int i = since_idx; i < graph->num_passes; i++)
881  pass_free(graph->passes[i]);
882  graph->num_passes = since_idx;
883 }
884 
886 {
887  SwsGraph *graph = *pgraph;
888  if (!graph)
889  return;
890 
891  graph_uninit(graph);
892  av_free(graph);
893  *pgraph = NULL;
894 }
895 
896 /* Tests only options relevant to SwsGraph */
897 static int opts_equal(const SwsContext *c1, const SwsContext *c2)
898 {
899  return c1->flags == c2->flags &&
900  c1->threads == c2->threads &&
901  c1->dither == c2->dither &&
902  c1->alpha_blend == c2->alpha_blend &&
903  c1->gamma_flag == c2->gamma_flag &&
904  c1->src_h_chr_pos == c2->src_h_chr_pos &&
905  c1->src_v_chr_pos == c2->src_v_chr_pos &&
906  c1->dst_h_chr_pos == c2->dst_h_chr_pos &&
907  c1->dst_v_chr_pos == c2->dst_v_chr_pos &&
908  c1->intent == c2->intent &&
909  c1->scaler == c2->scaler &&
910  c1->scaler_sub == c2->scaler_sub &&
911  !memcmp(c1->scaler_params, c2->scaler_params, sizeof(c1->scaler_params));
912 
913 }
914 
916  const SwsFormat *src, int field)
917 {
918  if (ff_fmt_equal(&graph->src, src) && ff_fmt_equal(&graph->dst, dst) &&
919  opts_equal(ctx, &graph->opts_copy))
920  {
921  ff_sws_graph_update_metadata(graph, &src->color);
922  return 0;
923  }
924 
925  graph_uninit(graph);
926  return ff_sws_graph_init(graph, ctx, dst, src, field);
927 }
928 
930 {
931  if (!color)
932  return;
933 
935 }
936 
937 static void get_field(SwsGraph *graph, const AVFrame *avframe, SwsFrame *frame)
938 {
940 
941  if (!(avframe->flags & AV_FRAME_FLAG_INTERLACED)) {
942  av_assert1(!graph->field);
943  return;
944  }
945 
946  if (graph->field == FIELD_BOTTOM) {
947  /* Odd rows, offset by one line */
949  for (int i = 0; i < 4; i++) {
950  if (frame->data[i])
951  frame->data[i] += frame->linesize[i];
952  if (desc->flags & AV_PIX_FMT_FLAG_PAL)
953  break;
954  }
955  }
956 
957  /* Take only every second line */
958  for (int i = 0; i < 4; i++)
959  frame->linesize[i] <<= 1;
960 
961  frame->height = (frame->height + (graph->field == FIELD_TOP)) >> 1;
962 }
963 
964 int ff_sws_graph_run(SwsGraph *graph, const AVFrame *dst, const AVFrame *src)
965 {
966  av_assert0(dst->format == graph->dst.hw_format || dst->format == graph->dst.format);
967  av_assert0(src->format == graph->src.hw_format || src->format == graph->src.format);
968 
969  SwsFrame src_field, dst_field;
970  get_field(graph, dst, &dst_field);
971  get_field(graph, src, &src_field);
972 
973  for (int i = 0; i < graph->num_passes; i++) {
974  const SwsPass *pass = graph->passes[i];
975  graph->exec.pass = pass;
976  graph->exec.input = pass->input ? &pass->input->output->frame : &src_field;
977  graph->exec.output = pass->output->avframe ? &pass->output->frame : &dst_field;
978  if (pass->setup) {
979  int ret = pass->setup(graph->exec.output, graph->exec.input, pass);
980  if (ret < 0)
981  return ret;
982  }
983 
984  if (pass->num_slices == 1) {
985  pass->run(graph->exec.output, graph->exec.input, 0, pass->height, pass);
986  } else {
988  }
989  }
990 
991  return 0;
992 }
error
static void error(const char *err)
Definition: target_bsf_fuzzer.c:32
sws_setColorspaceDetails
int sws_setColorspaceDetails(SwsContext *c, const int inv_table[4], int srcRange, const int table[4], int dstRange, int brightness, int contrast, int saturation)
Definition: utils.c:848
AV_LOG_WARNING
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:216
AVPixelFormat
AVPixelFormat
Pixel format.
Definition: pixfmt.h:71
add_legacy_sws_pass
static int add_legacy_sws_pass(SwsGraph *graph, const SwsFormat *src, const SwsFormat *dst, SwsPass *input, SwsPass **output)
Definition: graph.c:545
SwsGraph::slicethread
AVSliceThread * slicethread
Definition: graph.h:123
SwsGraph::ctx
SwsContext * ctx
Definition: graph.h:122
SwsPass
Represents a single filter pass in the scaling graph.
Definition: graph.h:75
SwsGraph::pass
const SwsPass * pass
Definition: graph.h:151
AVERROR
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
opt.h
SwsGraph::passes
SwsPass ** passes
Sorted sequence of filter passes to apply.
Definition: graph.h:131
adapt_colors
static int adapt_colors(SwsGraph *graph, SwsFormat src, SwsFormat dst, SwsPass *input, SwsPass **output)
Definition: graph.c:692
out
static FILE * out
Definition: movenc.c:55
color
Definition: vf_paletteuse.c:513
init_passes
static int init_passes(SwsGraph *graph)
Definition: graph.c:756
SwsFormat::interlaced
int interlaced
Definition: format.h:79
av_pix_fmt_desc_get
const AVPixFmtDescriptor * av_pix_fmt_desc_get(enum AVPixelFormat pix_fmt)
Definition: pixdesc.c:3456
SwsContext::src_w
int src_w
Deprecated frame property overrides, for the legacy API only.
Definition: swscale.h:253
AVBufferRef::data
uint8_t * data
The data buffer.
Definition: buffer.h:90
AVRefStructOpaque
RefStruct is an API for creating reference-counted objects with minimal overhead.
Definition: refstruct.h:58
AVHWFramesContext::format
enum AVPixelFormat format
The pixel format identifying the underlying HW surface type.
Definition: hwcontext.h:200
SwsPass::format
enum AVPixelFormat format
Definition: graph.h:84
saturation
static IPT saturation(const CmsCtx *ctx, IPT ipt)
Definition: cms.c:559
run_rgb0
static void run_rgb0(const SwsFrame *out, const SwsFrame *in, int y, int h, const SwsPass *pass)
Definition: graph.c:266
output
filter_frame For filters that do not use the this method is called when a frame is pushed to the filter s input It can be called at any time except in a reentrant way If the input frame is enough to produce output
Definition: filter_design.txt:226
av_frame_free
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
Definition: frame.c:64
SwsGraph::src
SwsFormat src
Currently active format and processing parameters.
Definition: graph.h:143
avpriv_slicethread_execute
void avpriv_slicethread_execute(AVSliceThread *ctx, int nb_jobs, int execute_main)
Execute slice threading.
Definition: slicethread.c:270
av_hwframe_ctx_init
int av_hwframe_ctx_init(AVBufferRef *ref)
Finalize the context before use.
Definition: hwcontext.c:337
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:459
pixdesc.h
frame_shift
static void frame_shift(const SwsFrame *f, const int y, uint8_t *data[4])
Definition: graph.c:230
ops.h
AVFrame::width
int width
Definition: frame.h:531
AVCOL_RANGE_JPEG
@ AVCOL_RANGE_JPEG
Full range content.
Definition: pixfmt.h:777
isGray
static av_always_inline int isGray(enum AVPixelFormat pix_fmt)
Definition: swscale_internal.h:805
av_hwframe_ctx_alloc
AVBufferRef * av_hwframe_ctx_alloc(AVBufferRef *device_ref_in)
Allocate an AVHWFramesContext tied to a given device context.
Definition: hwcontext.c:263
SwsGraph::output
const SwsFrame * output
Definition: graph.h:153
run_copy
static void run_copy(const SwsFrame *out, const SwsFrame *in, int y, int h, const SwsPass *pass)
Definition: graph.c:240
pass_free
static void pass_free(SwsPass *pass)
Definition: graph.c:167
SWS_BITEXACT
@ SWS_BITEXACT
Definition: swscale.h:157
SwsPass::setup
SwsPassSetup setup
Called once from the main thread before running the filter.
Definition: graph.h:104
table
static const uint16_t table[]
Definition: prosumer.c:203
data
const char data[16]
Definition: mxf.c:149
SwsContext::flags
unsigned flags
Bitmask of SWS_*.
Definition: swscale.h:219
AV_LOG_VERBOSE
#define AV_LOG_VERBOSE
Detailed information.
Definition: log.h:226
ff_sws_lut3d_pick_pixfmt
enum AVPixelFormat ff_sws_lut3d_pick_pixfmt(SwsFormat fmt, int output)
Pick the best compatible pixfmt for a given SwsFormat.
Definition: lut3d.c:52
ops_dispatch.h
AVFrame::flags
int flags
Frame flags, a combination of AV_FRAME_FLAGS.
Definition: frame.h:703
SwsPass::free
void(* free)(void *priv)
Optional private state and associated free() function.
Definition: graph.h:109
c1
static const uint64_t c1
Definition: murmur3.c:52
AVHWFramesContext::width
int width
The allocated dimensions of the frames in this pool.
Definition: hwcontext.h:220
format.h
SwsPass::input
SwsPass * input
Filter input.
Definition: graph.h:93
AV_PIX_FMT_VULKAN
@ AV_PIX_FMT_VULKAN
Vulkan hardware images.
Definition: pixfmt.h:379
ff_sws_graph_alloc
SwsGraph * ff_sws_graph_alloc(void)
Allocate an empty SwsGraph.
Definition: graph.c:797
ff_sws_init_single_context
int ff_sws_init_single_context(SwsContext *sws, SwsFilter *srcFilter, SwsFilter *dstFilter)
Definition: utils.c:1136
SwsColorMap
Definition: cms.h:60
SwsPass::width
int width
Definition: graph.h:85
ff_sws_op_list_print
void ff_sws_op_list_print(void *log, int lev, int lev_extra, const SwsOpList *ops)
Print out the contents of an operation list.
Definition: ops.c:961
ff_color_update_dynamic
static void ff_color_update_dynamic(SwsColor *dst, const SwsColor *src)
Definition: format.h:70
init_legacy_subpass
static int init_legacy_subpass(SwsGraph *graph, SwsContext *sws, SwsPass *input, SwsPass **output)
Definition: graph.c:435
SwsFrame::data
uint8_t * data[4]
Definition: format.h:212
setup_lut3d
static int setup_lut3d(const SwsFrame *out, const SwsFrame *in, const SwsPass *pass)
Definition: graph.c:671
avpriv_slicethread_create
int avpriv_slicethread_create(AVSliceThread **pctx, void *priv, void(*worker_func)(void *priv, int jobnr, int threadnr, int nb_jobs, int nb_threads), void(*main_func)(void *priv), int nb_threads)
Create slice threading context.
Definition: slicethread.c:261
macros.h
fail
#define fail()
Definition: checkasm.h:225
FIELD_BOTTOM
@ FIELD_BOTTOM
Definition: format.h:57
SwsContext::src_v_chr_pos
int src_v_chr_pos
Source vertical chroma position in luma grid / 256.
Definition: swscale.h:259
slice_ctx
static SwsContext * slice_ctx(const SwsPass *pass, int y)
Definition: graph.c:333
sws_init_context
av_warn_unused_result int sws_init_context(SwsContext *sws_context, SwsFilter *srcFilter, SwsFilter *dstFilter)
Initialize the swscaler context sws_context.
Definition: utils.c:1919
ff_sws_graph_init
int ff_sws_graph_init(SwsGraph *graph, SwsContext *ctx, const SwsFormat *dst, const SwsFormat *src, int field)
Initialize the filter graph for a given pair of formats.
Definition: graph.c:813
SwsGraph::opts_copy
SwsContext opts_copy
Cached copy of the public options that were used to construct this SwsGraph.
Definition: graph.h:138
SwsPassBuffer::frame
SwsFrame frame
Definition: graph.h:60
refstruct.h
av_image_check_size2
int av_image_check_size2(unsigned int w, unsigned int h, int64_t max_pixels, enum AVPixelFormat pix_fmt, int log_offset, void *log_ctx)
Check if the given dimension of an image is valid, meaning that all bytes of a plane of an image with...
Definition: imgutils.c:289
ff_sws_graph_create
int ff_sws_graph_create(SwsContext *ctx, const SwsFormat *dst, const SwsFormat *src, int field, SwsGraph **out_graph)
Allocate and initialize the filter graph.
Definition: graph.c:861
av_frame_alloc
AVFrame * av_frame_alloc(void)
Allocate an AVFrame and set its fields to default values.
Definition: frame.c:52
SwsFrame
Represents a view into a single field of frame data.
Definition: format.h:210
avassert.h
ff_sws_op_list_generate
int ff_sws_op_list_generate(SwsContext *ctx, const SwsFormat *src, const SwsFormat *dst, SwsOpList **out_ops, bool *incomplete)
Generate an SwsOpList defining a conversion from src to dst.
AV_LOG_TRACE
#define AV_LOG_TRACE
Extremely verbose debugging, useful for libav* development.
Definition: log.h:236
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:210
SwsInternal::pal_rgb
uint32_t pal_rgb[256]
Definition: swscale_internal.h:401
FF_ARRAY_ELEMS
#define FF_ARRAY_ELEMS(a)
Definition: sinewin_tablegen.c:29
legacy_chr_pos
static void legacy_chr_pos(SwsGraph *graph, int *chr_pos, int override, int *warned)
Definition: graph.c:419
SwsFrame::format
enum AVPixelFormat format
Definition: format.h:219
AVHWFramesContext::height
int height
Definition: hwcontext.h:220
SwsContext::dither
SwsDither dither
Dither mode.
Definition: swscale.h:235
SwsPass::priv
void * priv
Definition: graph.h:110
run_xyz2rgb
static void run_xyz2rgb(const SwsFrame *out, const SwsFrame *in, int y, int h, const SwsPass *pass)
Definition: graph.c:287
FIELD_TOP
@ FIELD_TOP
Definition: format.h:56
SwsInternal::nb_slice_ctx
int nb_slice_ctx
Definition: swscale_internal.h:345
av_image_fill_linesizes
int av_image_fill_linesizes(int linesizes[4], enum AVPixelFormat pix_fmt, int width)
Fill plane linesizes for an image with pixel format pix_fmt and width width.
Definition: imgutils.c:89
SwsInternal::slice_ctx
SwsContext ** slice_ctx
Definition: swscale_internal.h:343
av_chroma_location_enum_to_pos
int av_chroma_location_enum_to_pos(int *xpos, int *ypos, enum AVChromaLocation pos)
Converts AVChromaLocation to swscale x/y chroma position.
Definition: pixdesc.c:3898
ff_update_palette
void ff_update_palette(SwsInternal *c, const uint32_t *pal)
Definition: swscale.c:873
ff_sws_graph_reinit
int ff_sws_graph_reinit(SwsGraph *graph, SwsContext *ctx, const SwsFormat *dst, const SwsFormat *src, int field)
Wrapper around ff_sws_graph_init() that reuses the existing graph if the format is compatible.
Definition: graph.c:915
AVFormatContext::flags
int flags
Flags modifying the (de)muxer behaviour.
Definition: avformat.h:1435
ops.h
ff_sws_lut3d_alloc
SwsLut3D * ff_sws_lut3d_alloc(void)
Definition: lut3d.c:32
av_assert0
#define av_assert0(cond)
assert() equivalent, that is always enabled.
Definition: avassert.h:42
SwsContext::intent
int intent
Desired ICC intent for color space conversions.
Definition: swscale.h:267
av_refstruct_alloc_ext
static void * av_refstruct_alloc_ext(size_t size, unsigned flags, void *opaque, void(*free_cb)(AVRefStructOpaque opaque, void *obj))
A wrapper around av_refstruct_alloc_ext_c() for the common case of a non-const qualified opaque.
Definition: refstruct.h:94
AV_LOG_DEBUG
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
Definition: log.h:231
SwsGraph::num_passes
int num_passes
Definition: graph.h:132
ctx
static AVFormatContext * ctx
Definition: movenc.c:49
ff_sws_lut3d_update
void ff_sws_lut3d_update(SwsLut3D *lut3d, const SwsColor *new_src)
Update the tone mapping state.
Definition: lut3d.c:239
field
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
Definition: writing_filters.txt:78
AVPixFmtDescriptor::log2_chroma_w
uint8_t log2_chroma_w
Amount to shift the luma width right to find the chroma width.
Definition: pixdesc.h:80
SwsPass::run
SwsPassFunc run
Filter main execution function.
Definition: graph.h:83
free_buffer
static void free_buffer(AVRefStructOpaque opaque, void *obj)
Definition: graph.c:161
av_mallocz
#define av_mallocz(s)
Definition: tableprint_vlc.h:31
tmp
static uint8_t tmp[40]
Definition: aes_ctr.c:52
AV_PIX_FMT_RGBA
@ AV_PIX_FMT_RGBA
packed RGBA 8:8:8:8, 32bpp, RGBARGBA...
Definition: pixfmt.h:100
SwsGraph::field
int field
Definition: graph.h:144
ff_sws_lut3d_free
void ff_sws_lut3d_free(SwsLut3D **plut3d)
Definition: lut3d.c:42
NULL
#define NULL
Definition: coverity.c:32
sizes
static const int sizes[][2]
Definition: img2dec.c:62
AVHWFramesContext::sw_format
enum AVPixelFormat sw_format
The pixel format identifying the actual data layout of the hardware frames.
Definition: hwcontext.h:213
run
uint8_t run
Definition: svq3.c:207
av_buffer_unref
void av_buffer_unref(AVBufferRef **buf)
Free a given reference and automatically free the buffer if there are no more references to it.
Definition: buffer.c:139
run_legacy_swscale
static void run_legacy_swscale(const SwsFrame *out, const SwsFrame *in, int y, int h, const SwsPass *pass)
Definition: graph.c:364
SwsContext::gamma_flag
int gamma_flag
Use gamma correct scaling.
Definition: swscale.h:245
av_image_fill_plane_sizes
int av_image_fill_plane_sizes(size_t sizes[4], enum AVPixelFormat pix_fmt, int height, const ptrdiff_t linesizes[4])
Fill plane sizes for an image with pixel format pix_fmt and height height.
Definition: imgutils.c:111
ff_infer_colors
bool ff_infer_colors(SwsColor *src, SwsColor *dst)
Definition: format.c:540
ff_sws_lut3d_generate
int ff_sws_lut3d_generate(SwsLut3D *lut3d, enum AVPixelFormat fmt_in, enum AVPixelFormat fmt_out, const SwsColorMap *map)
Recalculate the (static) 3DLUT state with new settings.
Definition: lut3d.c:211
SwsContext::src_range
int src_range
Source is full range.
Definition: swscale.h:257
av_cpu_max_align
size_t av_cpu_max_align(void)
Get the maximum data alignment that may be required by FFmpeg.
Definition: cpu.c:287
SwsGraph::exec
struct SwsGraph::@564 exec
Temporary execution state inside ff_sws_graph_run(); used to pass data to worker threads.
SwsPass::graph
const SwsGraph * graph
Definition: graph.h:76
AVCOL_RANGE_UNSPECIFIED
@ AVCOL_RANGE_UNSPECIFIED
Definition: pixfmt.h:743
SwsContext::dst_h_chr_pos
int dst_h_chr_pos
Destination horizontal chroma position.
Definition: swscale.h:262
c
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
Definition: undefined.txt:32
SwsPassBuffer::avframe
AVFrame * avframe
Definition: graph.h:63
error.h
ff_sws_pass_aligned_width
int ff_sws_pass_aligned_width(const SwsPass *pass, int width)
Align width to the optimal size for pass.
Definition: graph.c:46
graph_uninit
static void graph_uninit(SwsGraph *graph)
Definition: graph.c:802
av_opt_copy
int av_opt_copy(void *dst, const void *src)
Copy options from src object into dest object.
Definition: opt.c:2145
ff_sws_graph_free
void ff_sws_graph_free(SwsGraph **pgraph)
Uninitialize any state associate with this filter graph and free it.
Definition: graph.c:885
SwsPass::height
int height
Definition: graph.h:85
f
f
Definition: af_crystalizer.c:122
lut3d.h
free_lut3d
static void free_lut3d(void *priv)
Definition: graph.c:665
height
#define height
Definition: dsp.h:89
frame_alloc_planes
static int frame_alloc_planes(AVFrame *dst)
Definition: graph.c:58
sws_alloc_context
SwsContext * sws_alloc_context(void)
Allocate an empty SwsContext and set its fields to default values.
Definition: utils.c:1031
dst
uint8_t ptrdiff_t const uint8_t ptrdiff_t int intptr_t intptr_t int int16_t * dst
Definition: dsp.h:87
usePal
static av_always_inline int usePal(enum AVPixelFormat pix_fmt)
Definition: swscale_internal.h:936
cpu.h
i
#define i(width, name, range_min, range_max)
Definition: cbs_h264.c:63
ff_sws_lut3d_apply
void ff_sws_lut3d_apply(const SwsLut3D *lut3d, const uint8_t *in, int in_stride, uint8_t *out, int out_stride, int w, int h)
Applies a color transformation to a plane.
Definition: lut3d.c:250
AV_PIX_FMT_RGB48
#define AV_PIX_FMT_RGB48
Definition: pixfmt.h:525
run_legacy_unscaled
static void run_legacy_unscaled(const SwsFrame *out, const SwsFrame *in, int y, int h, const SwsPass *pass)
Definition: graph.c:352
SwsContext::alpha_blend
SwsAlphaBlend alpha_blend
Alpha blending mode.
Definition: swscale.h:240
SwsPassBuffer::height
int height
Definition: graph.h:62
SwsContext::src_h
int src_h
Width and height of the source frame.
Definition: swscale.h:253
AVCHROMA_LOC_UNSPECIFIED
@ AVCHROMA_LOC_UNSPECIFIED
Definition: pixfmt.h:797
SwsFormat
Definition: format.h:77
AVFrame::format
int format
format of the frame, -1 if unknown or unset Values correspond to enum AVPixelFormat for video frames,...
Definition: frame.h:546
sws_getColorspaceDetails
int sws_getColorspaceDetails(SwsContext *c, int **inv_table, int *srcRange, int **table, int *dstRange, int *brightness, int *contrast, int *saturation)
Definition: utils.c:1006
align
static const uint8_t *BS_FUNC() align(BSCTX *bc)
Skip bits to a byte boundary.
Definition: bitstream_template.h:419
SwsFormat::loc
enum AVChromaLocation loc
Definition: format.h:84
SwsColor
Definition: format.h:60
SwsPass::output
SwsPassBuffer * output
Filter output buffer.
Definition: graph.h:98
av_buffer_alloc
AVBufferRef * av_buffer_alloc(size_t size)
Allocate an AVBuffer of the given size using av_malloc().
Definition: buffer.c:77
SwsContext::dst_format
int dst_format
Destination pixel format.
Definition: swscale.h:256
SWS_OP_FLAG_OPTIMIZE
@ SWS_OP_FLAG_OPTIMIZE
Definition: ops.h:372
run_lut3d
static void run_lut3d(const SwsFrame *out, const SwsFrame *in, int y, int h, const SwsPass *pass)
Definition: graph.c:680
input
and forward the test the status of outputs and forward it to the corresponding return FFERROR_NOT_READY If the filters stores internally one or a few frame for some input
Definition: filter_design.txt:172
slicethread.h
SwsGraph::input
const SwsFrame * input
Definition: graph.h:152
AVChromaLocation
AVChromaLocation
Location of chroma samples.
Definition: pixfmt.h:796
av_refstruct_unref
void av_refstruct_unref(void *objp)
Decrement the reference count of the underlying object and automatically free the object if there are...
Definition: refstruct.c:120
SwsPassBuffer::width_align
int width_align
Definition: graph.h:66
free_legacy_swscale
static void free_legacy_swscale(void *priv)
Definition: graph.c:311
SwsLut3D
Definition: lut3d.h:50
SwsGraph::dst
SwsFormat dst
Definition: graph.h:143
ff_fmt_vshift
static av_always_inline av_const int ff_fmt_vshift(enum AVPixelFormat fmt, int plane)
Definition: graph.h:32
SwsFormat::format
enum AVPixelFormat format
Definition: format.h:80
SwsPass::slice_h
int slice_h
Definition: graph.h:86
SwsGraph::num_threads
int num_threads
Definition: graph.h:124
opts_equal
static int opts_equal(const SwsContext *c1, const SwsContext *c2)
Definition: graph.c:897
SwsFormat::desc
const AVPixFmtDescriptor * desc
Definition: format.h:85
av_assert1
#define av_assert1(cond)
assert() equivalent, that does not lie in speed critical code.
Definition: avassert.h:58
setup_legacy_swscale
static int setup_legacy_swscale(const SwsFrame *out, const SwsFrame *in, const SwsPass *pass)
Definition: graph.c:317
SwsContext::scaler
SwsScaler scaler
Scaling filter.
Definition: swscale.h:275
swscale_internal.h
graph.h
FFMIN
#define FFMIN(a, b)
Definition: macros.h:49
av_frame_unref
void av_frame_unref(AVFrame *frame)
Unreference all the buffers referenced by frame and reset the frame fields.
Definition: frame.c:496
SwsContext::scaler_sub
SwsScaler scaler_sub
Scaler used specifically for up/downsampling subsampled (chroma) planes.
Definition: swscale.h:283
SwsContext::dst_h
int dst_h
Width and height of the destination frame.
Definition: swscale.h:254
AVCOL_SPC_UNSPECIFIED
@ AVCOL_SPC_UNSPECIFIED
Definition: pixfmt.h:703
AV_FRAME_FLAG_INTERLACED
#define AV_FRAME_FLAG_INTERLACED
A flag to mark frames whose content is interlaced.
Definition: frame.h:682
av_calloc
void * av_calloc(size_t nmemb, size_t size)
Definition: mem.c:264
get_chroma_pos
static void get_chroma_pos(SwsGraph *graph, int *h_chr_pos, int *v_chr_pos, const SwsFormat *fmt)
Definition: graph.c:376
AVHWFramesContext
This struct describes a set or pool of "hardware" frames (i.e.
Definition: hwcontext.h:118
ff_sws_graph_add_pass
int ff_sws_graph_add_pass(SwsGraph *graph, enum AVPixelFormat fmt, int width, int height, SwsPass *input, int align, SwsPassFunc run, SwsPassSetup setup, void *priv, void(*free_cb)(void *priv), SwsPass **out_pass)
Allocate and add a new pass to the filter graph.
Definition: graph.c:175
SWS_DITHER_ED
@ SWS_DITHER_ED
Definition: swscale.h:83
SwsInternal
Definition: swscale_internal.h:335
ret
ret
Definition: filter_design.txt:187
SwsPassFunc
void(* SwsPassFunc)(const SwsFrame *out, const SwsFrame *in, int y, int h, const SwsPass *pass)
Output h lines of filtered data.
Definition: graph.h:45
frame
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
Definition: filter_design.txt:265
ff_fmt_equal
static int ff_fmt_equal(const SwsFormat *fmt1, const SwsFormat *fmt2)
Definition: format.h:135
SwsPassBuffer::width_pad
int width_pad
Definition: graph.h:67
SwsGraph::noop
bool noop
Definition: graph.h:126
av_dynarray_add_nofree
int av_dynarray_add_nofree(void *tab_ptr, int *nb_ptr, void *elem)
Add an element to a dynamic array.
Definition: mem.c:315
AVFrame::height
int height
Definition: frame.h:531
c2
static const uint64_t c2
Definition: murmur3.c:53
SwsPassBuffer::width
int width
Definition: graph.h:62
buffer
the frame and frame reference mechanism is intended to as much as expensive copies of that data while still allowing the filters to produce correct results The data is stored in buffers represented by AVFrame structures Several references can point to the same frame buffer
Definition: filter_design.txt:49
AVCHROMA_LOC_CENTER
@ AVCHROMA_LOC_CENTER
MPEG-1 4:2:0, JPEG 4:2:0, H.263 4:2:0.
Definition: pixfmt.h:799
SWS_NUM_SCALER_PARAMS
#define SWS_NUM_SCALER_PARAMS
Extra parameters for fine-tuning certain scalers.
Definition: swscale.h:224
AV_PIX_FMT_NONE
@ AV_PIX_FMT_NONE
Definition: pixfmt.h:72
SwsFormat::hw_format
enum AVPixelFormat hw_format
Definition: format.h:81
SwsFormat::color
SwsColor color
Definition: format.h:86
get_field
static void get_field(SwsGraph *graph, const AVFrame *avframe, SwsFrame *frame)
Definition: graph.c:937
ff_sws_color_map_noop
bool ff_sws_color_map_noop(const SwsColorMap *map)
Returns true if the given color map is a semantic no-op - that is, the overall RGB end to end transfo...
Definition: cms.c:34
SwsPassSetup
int(* SwsPassSetup)(const SwsFrame *out, const SwsFrame *in, const SwsPass *pass)
Function to run from the main thread before processing any lines.
Definition: graph.h:51
ff_swscale
int ff_swscale(SwsInternal *c, const uint8_t *const src[], const int srcStride[], int srcSliceY, int srcSliceH, uint8_t *const dst[], const int dstStride[], int dstSliceY, int dstSliceH)
Definition: swscale.c:263
ff_sws_compile_pass
int ff_sws_compile_pass(SwsGraph *graph, const SwsOpBackend *backend, SwsOpList **pops, int flags, SwsPass *input, SwsPass **output)
Resolves an operation list to a graph pass.
Definition: ops_dispatch.c:594
cms.h
add_convert_pass
#define add_convert_pass
Definition: graph.c:657
desc
const char * desc
Definition: libsvtav1.c:83
SwsInternal::pal_yuv
uint32_t pal_yuv[256]
Definition: swscale_internal.h:400
SwsGraph::incomplete
bool incomplete
Definition: graph.h:125
mem.h
AVBufferRef
A reference to a data buffer.
Definition: buffer.h:82
sws_getCoefficients
const int * sws_getCoefficients(int colorspace)
Return a pointer to yuv<->rgb coefficients for the given colorspace suitable for sws_setColorspaceDet...
Definition: yuv2rgb.c:61
SwsContext::dst_w
int dst_w
Definition: swscale.h:254
SwsGraph
Filter graph, which represents a 'baked' pixel format conversion.
Definition: graph.h:121
SwsContext::src_format
int src_format
Source pixel format.
Definition: swscale.h:255
AVPixFmtDescriptor
Descriptor that unambiguously describes how the bits of a pixel are stored in the up to 4 data planes...
Definition: pixdesc.h:69
map
const VDPAUPixFmtMap * map
Definition: hwcontext_vdpau.c:71
av_free
#define av_free(p)
Definition: tableprint_vlc.h:34
FFALIGN
#define FFALIGN(x, a)
Definition: macros.h:78
run_rgb2xyz
static void run_rgb2xyz(const SwsFrame *out, const SwsFrame *in, int y, int h, const SwsPass *pass)
Definition: graph.c:296
SwsContext::dst_range
int dst_range
Destination is full range.
Definition: swscale.h:258
pass_alloc_output
static int pass_alloc_output(SwsPass *pass)
Definition: graph.c:118
ff_sws_graph_run
int ff_sws_graph_run(SwsGraph *graph, const AVFrame *dst, const AVFrame *src)
Dispatch the filter graph on a single field of the given frames.
Definition: graph.c:964
sws_free_context
void sws_free_context(SwsContext **ctx)
Free the context and everything associated with it, and write NULL to the provided pointer.
Definition: utils.c:2369
imgutils.h
hwcontext.h
avpriv_slicethread_free
void avpriv_slicethread_free(AVSliceThread **pctx)
Destroy slice threading context.
Definition: slicethread.c:275
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:27
SwsContext::src_h_chr_pos
int src_h_chr_pos
Source horizontal chroma position.
Definition: swscale.h:260
sws_internal
static SwsInternal * sws_internal(const SwsContext *sws)
Definition: swscale_internal.h:79
SwsPassBuffer
Represents an output buffer for a filter pass.
Definition: graph.h:59
h
h
Definition: vp9dsp_template.c:2070
SwsPass::num_slices
int num_slices
Definition: graph.h:87
width
#define width
Definition: dsp.h:89
ff_sws_vk_device_ref
AVBufferRef * ff_sws_vk_device_ref(SwsContext *sws)
Returns the Vulkan device reference associated with sws, or NULL if Vulkan has not been initialized f...
Definition: ops.c:85
SwsOpList
Helper struct for representing a list of operations.
Definition: ops.h:288
SwsContext::dst_v_chr_pos
int dst_v_chr_pos
Destination vertical chroma position.
Definition: swscale.h:261
SwsContext
Main external API structure.
Definition: swscale.h:206
AV_PIX_FMT_FLAG_PAL
#define AV_PIX_FMT_FLAG_PAL
Pixel format has a palette in data[1], values are indexes in this palette.
Definition: pixdesc.h:120
av_hwframe_get_buffer
int av_hwframe_get_buffer(AVBufferRef *hwframe_ref, AVFrame *frame, int flags)
Allocate a new frame attached to the given AVHWFramesContext.
Definition: hwcontext.c:506
SwsFrame::linesize
int linesize[4]
Definition: format.h:213
sws_graph_worker
static void sws_graph_worker(void *priv, int jobnr, int threadnr, int nb_jobs, int nb_threads)
Definition: graph.c:786
ff_sws_graph_update_metadata
void ff_sws_graph_update_metadata(SwsGraph *graph, const SwsColor *color)
Update dynamic per-frame HDR metadata without requiring a full reinit.
Definition: graph.c:929
SWS_UNSTABLE
@ SWS_UNSTABLE
Allow using experimental new code paths.
Definition: swscale.h:164
AVPixFmtDescriptor::log2_chroma_h
uint8_t log2_chroma_h
Amount to shift the luma height right to find the chroma height.
Definition: pixdesc.h:89
SwsContext::scaler_params
double scaler_params[SWS_NUM_SCALER_PARAMS]
Definition: swscale.h:225
src
#define src
Definition: vp8dsp.c:248
swscale.h
av_get_pix_fmt_name
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.
Definition: pixdesc.c:3376
isALPHA
static av_always_inline int isALPHA(enum AVPixelFormat pix_fmt)
Definition: swscale_internal.h:896
ff_sws_graph_rollback
void ff_sws_graph_rollback(SwsGraph *graph, int since_idx)
Remove all passes added since the given index.
Definition: graph.c:878
ff_sws_frame_from_avframe
void ff_sws_frame_from_avframe(SwsFrame *dst, const AVFrame *src)
Initialize a SwsFrame from an AVFrame.
Definition: format.c:653