Go to the documentation of this file.
74 av_log(
ctx, msg_lev,
"Backend '%s' failed to compile operations: %s\n",
95 "block size = %d, over-read = %d, over-write = %d, cpu flags = 0x%x\n",
96 backend->
name,
out->block_size,
out->over_read,
out->over_write,
129 const uint8_t *in[4], uint8_t *
out[4])
132 const int y_src =
p->offsets_y ?
p->offsets_y[y_dst] : y_dst;
133 for (
int i = 0;
i <
p->planes_in;
i++)
135 for (
int i = 0;
i <
p->planes_out;
i++)
142 const uint64_t
bits = (uint64_t) pixels * pixel_bits;
149 return (
bits + 7) >> 3;
160 return FFMAX(safe_bytes, 0);
164 ptrdiff_t safe_offset,
167 size_t safe_blocks = num_blocks;
168 while (safe_blocks && offset_bytes[safe_blocks * block_size - 1] > safe_offset)
184 const unsigned block_size =
comp->block_size;
185 const size_t num_blocks = (pass->
width + block_size - 1) / block_size;
186 const size_t aligned_w = num_blocks * block_size;
187 if (aligned_w < pass->
width)
189 p->num_blocks = num_blocks;
190 p->memcpy_first =
false;
191 p->memcpy_last =
false;
192 p->memcpy_out =
false;
194 size_t safe_blocks = num_blocks;
195 for (
int i = 0;
i <
p->planes_in;
i++) {
196 int idx =
p->idx_in[
i];
197 int chroma = idx == 1 || idx == 2;
201 size_t safe_blocks_in;
203 size_t filter_size =
pixel_bytes(
p->filter_size,
p->pixel_bits_in,
206 safe_bytes - filter_size,
212 if (safe_blocks_in < num_blocks) {
213 p->memcpy_first |= in->
linesize[idx] < 0;
215 safe_blocks =
FFMIN(safe_blocks, safe_blocks_in);
226 for (
int i = 0;
i <
p->planes_out;
i++) {
227 int idx =
p->idx_out[
i];
228 int chroma = idx == 1 || idx == 2;
233 if (safe_blocks_out < num_blocks) {
234 p->memcpy_out =
true;
235 safe_blocks =
FFMIN(safe_blocks, safe_blocks_out);
246 const bool memcpy_in =
p->memcpy_first ||
p->memcpy_last;
247 if (!memcpy_in && !
p->memcpy_out) {
255 size_t alloc_size = 0;
258 const size_t safe_width = safe_blocks * block_size;
259 const size_t tail_size = pass->
width - safe_width;
262 p->tail_blocks = num_blocks - safe_blocks;
273 const size_t alloc_width = aligned_w - safe_width;
274 for (
int i = 0; memcpy_in &&
i <
p->planes_in;
i++) {
280 needed_size =
p->tail_size_in;
290 for (
int i = 0;
p->memcpy_out &&
i <
p->planes_out;
i++) {
303 alloc_size += aligned_w *
sizeof(*exec->
in_offset_x);
310 uint8_t *tail_buf =
p->tail_buf;
311 for (
int i = 0; memcpy_in &&
i <
p->planes_in;
i++) {
312 tail->
in[
i] = tail_buf;
316 for (
int i = 0;
p->memcpy_out &&
i <
p->planes_out;
i++) {
317 tail->
out[
i] = tail_buf;
323 for (
int i = safe_width;
i < aligned_w;
i++)
331 const uint8_t *
src,
const size_t src_stride,
332 const int h,
const size_t bytes)
334 for (
int y = 0; y <
h; y++) {
366 const bool memcpy_in =
p->memcpy_last && y +
h == pass->
height ||
367 p->memcpy_first && y == 0;
368 const bool memcpy_out =
p->memcpy_out;
369 const size_t num_blocks =
p->num_blocks;
370 const size_t tail_blocks =
p->tail_blocks;
373 if (!memcpy_in && !memcpy_out) {
375 comp->func(&exec,
comp->priv, 0, y, num_blocks, y +
h);
381 if (num_blocks > tail_blocks) {
382 for (
int i = 0;
i < 4;
i++) {
386 exec.in_bump[
i] += exec.block_size_in * tail_blocks;
387 exec.out_bump[
i] += exec.block_size_out * tail_blocks;
390 comp->func(&exec,
comp->priv, 0, y, num_blocks - tail_blocks, y +
h);
397 for (
int i = 0;
i <
p->planes_in;
i++) {
399 if (!exec.in_offset_x || memcpy_in)
400 exec.in[
i] +=
p->tail_off_in;
401 tail.in[
i] += y * tail.in_stride[
i];
403 for (
int i = 0;
i <
p->planes_out;
i++) {
404 exec.out[
i] +=
p->tail_off_out;
405 tail.out[
i] += y * tail.out_stride[
i];
408 for (
int i = 0;
i <
p->planes_in;
i++) {
411 exec.in[
i], exec.in_stride[
i],
h,
p->tail_size_in);
414 const size_t loop_size = tail_blocks * exec.block_size_in;
415 tail.in[
i] = exec.in[
i];
416 tail.in_stride[
i] = exec.in_stride[
i];
417 tail.in_bump[
i] = exec.in_stride[
i] - loop_size;
421 for (
int i = 0; !memcpy_out &&
i <
p->planes_out;
i++) {
423 const size_t loop_size = tail_blocks * exec.block_size_out;
424 tail.out[
i] = exec.out[
i];
425 tail.out_stride[
i] = exec.out_stride[
i];
426 tail.out_bump[
i] = exec.out_stride[
i] - loop_size;
431 comp->func(&tail,
comp->priv, num_blocks - tail_blocks, y, num_blocks, y +
h);
433 for (
int i = 0; memcpy_out &&
i <
p->planes_out;
i++) {
435 tail.out[
i], tail.out_stride[
i],
h,
p->tail_size_out);
441 return op->rw.packed ? 1 :
op->rw.elems;
446 const int elems =
op->rw.packed ?
op->rw.elems : 1;
448 const int bits = 8 >>
op->rw.frac;
459 const int pad = (over_rw * 8 + pixel_bits - 1) / pixel_bits;
480 if (
p->comp.opaque) {
484 input,
c.slice_align,
c.func_opaque,
496 .height =
dst->height,
501 if (block_bits_in & 0x7 || block_bits_out & 0x7) {
507 p->exec_base.block_size_in = block_bits_in >> 3;
508 p->exec_base.block_size_out = block_bits_out >> 3;
510 for (
int i = 0;
i < 4;
i++) {
527 for (
int y = 0; y <
filter->dst_size - 1; y++) {
528 int next =
filter->offsets[y + 1];
529 bump[y] = next -
line - 1;
532 bump[
filter->dst_size - 1] = 0;
533 p->exec_base.in_bump_y = bump;
542 p->exec_base.in_offset_x =
offset;
544 for (
int x = 0; x <
filter->dst_size; x++) {
549 if ((
bits & 0x7) || (
bits >> 3) > INT32_MAX) {
555 for (
int x =
filter->dst_size; x < pixels; x++)
557 p->exec_base.block_size_in = 0;
558 p->filter_size =
filter->filter_size;
592 if (!
read || !write) {
594 "and write, respectively.\n");
619 if (prev ==
input && !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)
int ff_sws_ops_compile(SwsContext *ctx, const SwsOpList *ops, SwsCompiledOp *out)
Compile a list of operations using the best available backend.
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
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)
static int compile(SwsGraph *graph, const SwsOpList *ops, SwsPass *input, SwsPass **output)
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])
int ff_sws_compile_pass(SwsGraph *graph, SwsOpList **pops, int flags, SwsPass *input, SwsPass **output)
Resolves an operation list to a graph pass.
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.
#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
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)
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 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_ops_compile_backend(SwsContext *ctx, const SwsOpBackend *backend, const SwsOpList *ops, SwsCompiledOp *out)
Attempt to compile a list of operations using a specific backend.
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.
void ff_sws_graph_rollback(SwsGraph *graph, int since_idx)
Remove all passes added since the given index.