Go to the documentation of this file.
74 av_log(
ctx, msg_lev,
"Backend '%s' failed to compile operations: %s\n",
82 "block size = %d, over-read = %d, over-write = %d, cpu flags = 0x%x\n",
83 backend->
name,
out->block_size,
out->over_read,
out->over_write,
136 const uint8_t *in[4], uint8_t *
out[4])
139 const int y_src =
p->offsets_y ?
p->offsets_y[y_dst] : y_dst;
140 for (
int i = 0;
i <
p->planes_in;
i++)
142 for (
int i = 0;
i <
p->planes_out;
i++)
149 const uint64_t
bits = (uint64_t) pixels * pixel_bits;
156 return (
bits + 7) >> 3;
167 return FFMAX(safe_bytes, 0);
171 ptrdiff_t safe_offset,
174 size_t safe_blocks = num_blocks;
175 while (safe_blocks && offset_bytes[safe_blocks * block_size - 1] > safe_offset)
192 const unsigned block_size =
comp->block_size;
193 const size_t num_blocks = (pass->
width + block_size - 1) / block_size;
194 const size_t aligned_w = num_blocks * block_size;
195 if (aligned_w < pass->
width)
197 p->num_blocks = num_blocks;
198 p->memcpy_first =
false;
199 p->memcpy_last =
false;
200 p->memcpy_out =
false;
202 size_t safe_blocks = num_blocks;
203 for (
int i = 0;
i <
p->planes_in;
i++) {
204 int idx =
p->idx_in[
i];
205 int chroma = idx == 1 || idx == 2;
209 size_t input_bytes = in->
linesize[idx];
210 if (
p->filter_size_h && float_in) {
217 size_t safe_blocks_in;
219 size_t filter_size =
pixel_bytes(
p->filter_size_h,
p->pixel_bits_in,
222 safe_bytes - filter_size,
228 if (safe_blocks_in < num_blocks) {
229 p->memcpy_first |= in->
linesize[idx] < 0;
231 safe_blocks =
FFMIN(safe_blocks, safe_blocks_in);
242 for (
int i = 0;
i <
p->planes_out;
i++) {
243 int idx =
p->idx_out[
i];
244 int chroma = idx == 1 || idx == 2;
249 if (safe_blocks_out < num_blocks) {
250 p->memcpy_out =
true;
251 safe_blocks =
FFMIN(safe_blocks, safe_blocks_out);
262 const bool memcpy_in =
p->memcpy_first ||
p->memcpy_last;
263 if (!memcpy_in && !
p->memcpy_out) {
271 size_t alloc_size = 0;
274 const size_t safe_width = safe_blocks * block_size;
275 const size_t tail_size = pass->
width - safe_width;
278 p->tail_blocks = num_blocks - safe_blocks;
289 const size_t alloc_width = aligned_w - safe_width;
290 for (
int i = 0; memcpy_in &&
i <
p->planes_in;
i++) {
296 needed_size =
p->tail_size_in;
306 for (
int i = 0;
p->memcpy_out &&
i <
p->planes_out;
i++) {
319 alloc_size += aligned_w *
sizeof(*exec->
in_offset_x);
326 uint8_t *tail_buf =
p->tail_buf;
327 for (
int i = 0; memcpy_in &&
i <
p->planes_in;
i++) {
328 tail->
in[
i] = tail_buf;
332 for (
int i = 0;
p->memcpy_out &&
i <
p->planes_out;
i++) {
333 tail->
out[
i] = tail_buf;
339 for (
int i = safe_width;
i < aligned_w;
i++)
347 const uint8_t *
src,
const size_t src_stride,
348 const int h,
const size_t bytes)
350 for (
int y = 0; y <
h; y++) {
382 const bool memcpy_in =
p->memcpy_last && y +
h == pass->
height ||
383 p->memcpy_first && y == 0;
384 const bool memcpy_out =
p->memcpy_out;
385 const size_t num_blocks =
p->num_blocks;
386 const size_t tail_blocks =
p->tail_blocks;
389 if (!memcpy_in && !memcpy_out) {
391 comp->func(&exec,
comp->priv, 0, y, num_blocks, y +
h);
397 if (num_blocks > tail_blocks) {
398 for (
int i = 0;
i < 4;
i++) {
402 exec.in_bump[
i] += exec.block_size_in * tail_blocks;
403 exec.out_bump[
i] += exec.block_size_out * tail_blocks;
406 comp->func(&exec,
comp->priv, 0, y, num_blocks - tail_blocks, y +
h);
413 for (
int i = 0;
i <
p->planes_in;
i++) {
415 if (!exec.in_offset_x || memcpy_in)
416 exec.in[
i] +=
p->tail_off_in;
417 tail.in[
i] += y * tail.in_stride[
i];
419 for (
int i = 0;
i <
p->planes_out;
i++) {
420 exec.out[
i] +=
p->tail_off_out;
421 tail.out[
i] += y * tail.out_stride[
i];
424 for (
int i = 0;
i <
p->planes_in;
i++) {
427 exec.in[
i], exec.in_stride[
i],
h,
p->tail_size_in);
430 const size_t loop_size = tail_blocks * exec.block_size_in;
431 tail.in[
i] = exec.in[
i];
432 tail.in_stride[
i] = exec.in_stride[
i];
433 tail.in_bump[
i] = exec.in_stride[
i] - loop_size;
437 for (
int i = 0; !memcpy_out &&
i <
p->planes_out;
i++) {
439 const size_t loop_size = tail_blocks * exec.block_size_out;
440 tail.out[
i] = exec.out[
i];
441 tail.out_stride[
i] = exec.out_stride[
i];
442 tail.out_bump[
i] = exec.out_stride[
i] - loop_size;
447 comp->func(&tail,
comp->priv, num_blocks - tail_blocks, y, num_blocks, y +
h);
449 for (
int i = 0; memcpy_out &&
i <
p->planes_out;
i++) {
451 tail.out[
i], tail.out_stride[
i],
h,
p->tail_size_out);
457 return op->rw.packed ? 1 :
op->rw.elems;
462 const int elems =
op->rw.packed ?
op->rw.elems : 1;
464 const int bits = 8 >>
op->rw.frac;
475 const int pad = (over_rw * 8 + pixel_bits - 1) / pixel_bits;
498 if (
p->comp.opaque) {
502 input,
c.slice_align,
c.func_opaque,
514 .height =
dst->height,
519 if (block_bits_in & 0x7 || block_bits_out & 0x7) {
525 p->exec_base.block_size_in = block_bits_in >> 3;
526 p->exec_base.block_size_out = block_bits_out >> 3;
528 for (
int i = 0;
i < 4;
i++) {
545 for (
int y = 0; y <
filter->dst_size - 1; y++) {
546 int next =
filter->offsets[y + 1];
547 bump[y] = next -
line - 1;
550 bump[
filter->dst_size - 1] = 0;
551 p->exec_base.in_bump_y = bump;
560 p->exec_base.in_offset_x =
offset;
562 for (
int x = 0; x <
filter->dst_size; x++) {
567 if ((
bits & 0x7) || (
bits >> 3) > INT32_MAX) {
573 for (
int x =
filter->dst_size; x < pixels; x++)
575 p->exec_base.block_size_in = 0;
576 p->filter_size_h =
filter->filter_size;
612 if (!
read || !write) {
614 "and write, respectively.\n");
640 if (
first && !rest) {
static void copy_lines(uint8_t *dst, const size_t dst_stride, const uint8_t *src, const size_t src_stride, const int h, const size_t bytes)
@ AV_ROUND_UP
Round toward +infinity.
unsigned int tail_buf_size
static int rw_planes(const SwsOp *op)
void ff_sws_op_list_free(SwsOpList **p_ops)
#define AV_LOG_WARNING
Something somehow does not look correct.
Represents a single filter pass in the scaling graph.
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
SwsOpList * ff_sws_op_list_duplicate(const SwsOpList *ops)
Returns a duplicate of ops, or NULL on OOM.
static void comp(unsigned char *dst, ptrdiff_t dst_stride, unsigned char *src, ptrdiff_t src_stride, int add)
ptrdiff_t in_bump[4]
Pointer bump, difference between stride and processed line size.
const SwsOp * ff_sws_op_list_input(const SwsOpList *ops)
Returns the input operation for a given op list, or NULL if there is none (e.g.
const AVPixFmtDescriptor * av_pix_fmt_desc_get(enum AVPixelFormat pix_fmt)
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
#define AV_PIX_FMT_FLAG_FLOAT
The pixel format contains IEEE-754 floating point values.
Represents a computed filter kernel.
@ AV_ROUND_ZERO
Round toward zero.
AVRounding
Rounding methods.
#define AV_LOG_VERBOSE
Detailed information.
void(* filter)(uint8_t *src, int stride, int qscale)
int width
Dimensions and format.
int ff_sws_pixel_type_size(SwsPixelType type)
int ff_sws_op_list_subpass(SwsOpList *ops, SwsOpList **out_rest)
Eliminate SWS_OP_FILTER_* operations by merging them with prior SWS_OP_READ operations.
void ff_sws_op_list_print(void *log, int lev, int lev_extra, const SwsOpList *ops)
Print out the contents of an operation list.
const SwsOpBackend *const ff_sws_op_backends[]
int(* compile)(SwsContext *ctx, SwsOpList *ops, SwsCompiledOp *out)
Compile an operation list to an implementation chain.
enum AVPixelFormat hw_format
If NONE, backend only supports software frames.
static void get_row_data(const SwsOpPass *p, const int y_dst, const uint8_t *in[4], uint8_t *out[4])
static size_t safe_blocks_offset(size_t num_blocks, unsigned block_size, ptrdiff_t safe_offset, const int32_t *offset_bytes)
Represents a view into a single field of frame data.
trying all byte sequences megabyte in length and selecting the best looking sequence will yield cases to try But first
#define AV_LOG_TRACE
Extremely verbose debugging, useful for libav* development.
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
enum AVPixelFormat format
#define AV_CEIL_RSHIFT(a, b)
static int op(uint8_t **dst, const uint8_t *dst_end, GetByteContext *gb, int pixel, int count, int *x, int width, int linesize)
Perform decode operation.
#define av_assert0(cond)
assert() equivalent, that is always enabled.
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
static AVFormatContext * ctx
uint8_t log2_chroma_w
Amount to shift the luma width right to find the chroma width.
const SwsOp * ff_sws_op_list_output(const SwsOpList *ops)
Returns the output operation for a given op list, or NULL if there is none.
#define FFABS(a)
Absolute value, Note, INT_MIN / INT64_MIN result in undefined behavior as they are not representable ...
Copyright (C) 2026 Niklas Haas.
bool ff_sws_op_list_is_noop(const SwsOpList *ops)
Returns whether an op list represents a true no-op operation, i.e.
static void op_pass_free(void *ptr)
void ff_sws_compiled_op_unref(SwsCompiledOp *comp)
#define av_unreachable(msg)
Asserts that are used as compiler optimization hints depending upon ASSERT_LEVEL and NBDEBUG.
void av_fast_mallocz(void *ptr, unsigned int *size, size_t min_size)
Allocate and clear a buffer, reusing the given one if large enough.
size_t av_cpu_max_align(void)
Get the maximum data alignment that may be required by FFmpeg.
static int rw_pixel_bits(const SwsOp *op)
static int compile(SwsGraph *graph, const SwsOpBackend *backend, const SwsOpList *ops, SwsPass *input, SwsPass **output)
uint64_t flags
Combination of AV_PIX_FMT_FLAG_...
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
@ AV_ROUND_DOWN
Round toward -infinity.
static void copy(const float *p1, float *p2, const int length)
uint8_t ptrdiff_t const uint8_t ptrdiff_t int intptr_t intptr_t int int16_t * dst
#define i(width, name, range_min, range_max)
#define av_err2str(errnum)
Convenience macro, the return value should be used only directly in function arguments but never stan...
static int op_pass_setup(const SwsFrame *out, const SwsFrame *in, const SwsPass *pass)
void ff_sws_op_list_update_comps(SwsOpList *ops)
Infer + propagate known information about components.
static int compile_backend(SwsContext *ctx, const SwsOpBackend *backend, const SwsOpList *ops, SwsCompiledOp *out)
static const uint8_t *BS_FUNC() align(BSCTX *bc)
Skip bits to a byte boundary.
void * av_refstruct_ref(void *obj)
Create a new reference to an object managed via this API, i.e.
SwsPassBuffer * output
Filter output buffer.
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf offset
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
void av_refstruct_unref(void *objp)
Decrement the reference count of the underlying object and automatically free the object if there are...
int ff_sws_op_list_optimize(SwsOpList *ops)
Fuse compatible and eliminate redundant operations, as well as replacing some operations with more ef...
int32_t * in_offset_x
Pixel offset map; for horizontal scaling, in bytes.
@ AV_ROUND_INF
Round away from zero.
#define av_malloc_array(a, b)
#define av_assert1(cond)
assert() equivalent, that does not lie in speed critical code.
#define DECLARE_ALIGNED_32(t, v)
Copyright (C) 2025 Niklas Haas.
static size_t pixel_bytes(size_t pixels, int pixel_bits, enum AVRounding rounding)
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.
IDirect3DDxgiInterfaceAccess _COM_Outptr_ void ** p
static size_t safe_bytes_pad(int linesize, int plane_pad)
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.
Filter graph, which represents a 'baked' pixel format conversion.
Descriptor that unambiguously describes how the bits of a pixel are stored in the up to 4 data planes...
static void align_pass(SwsPass *pass, int block_size, int over_rw, int pixel_bits)
static void op_pass_run(const SwsFrame *out, const SwsFrame *in, const int y, const int h, const SwsPass *pass)
Represents an output buffer for a filter pass.
Helper struct for representing a list of operations.
Main external API structure.
uint8_t log2_chroma_h
Amount to shift the luma height right to find the chroma height.
static uint32_t BS_FUNC() read(BSCTX *bc, unsigned int n)
Return n bits from the buffer, n has to be in the 0-32 range.
int ff_sws_ops_compile(SwsContext *ctx, const SwsOpBackend *backend, const SwsOpList *ops, SwsCompiledOp *out)
Attempt to compile a list of operations using a specific backend, or the best available backend if ba...
void ff_sws_graph_rollback(SwsGraph *graph, int since_idx)
Remove all passes added since the given index.