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)
191 const unsigned block_size =
comp->block_size;
192 const size_t num_blocks = (pass->
width + block_size - 1) / block_size;
193 const size_t aligned_w = num_blocks * block_size;
194 if (aligned_w < pass->
width)
196 p->num_blocks = num_blocks;
197 p->memcpy_first =
false;
198 p->memcpy_last =
false;
199 p->memcpy_out =
false;
201 size_t safe_blocks = num_blocks;
202 for (
int i = 0;
i <
p->planes_in;
i++) {
203 int idx =
p->idx_in[
i];
204 int chroma = idx == 1 || idx == 2;
208 size_t safe_blocks_in;
210 size_t filter_size =
pixel_bytes(
p->filter_size,
p->pixel_bits_in,
213 safe_bytes - filter_size,
219 if (safe_blocks_in < num_blocks) {
220 p->memcpy_first |= in->
linesize[idx] < 0;
222 safe_blocks =
FFMIN(safe_blocks, safe_blocks_in);
233 for (
int i = 0;
i <
p->planes_out;
i++) {
234 int idx =
p->idx_out[
i];
235 int chroma = idx == 1 || idx == 2;
240 if (safe_blocks_out < num_blocks) {
241 p->memcpy_out =
true;
242 safe_blocks =
FFMIN(safe_blocks, safe_blocks_out);
253 const bool memcpy_in =
p->memcpy_first ||
p->memcpy_last;
254 if (!memcpy_in && !
p->memcpy_out) {
262 size_t alloc_size = 0;
265 const size_t safe_width = safe_blocks * block_size;
266 const size_t tail_size = pass->
width - safe_width;
269 p->tail_blocks = num_blocks - safe_blocks;
280 const size_t alloc_width = aligned_w - safe_width;
281 for (
int i = 0; memcpy_in &&
i <
p->planes_in;
i++) {
287 needed_size =
p->tail_size_in;
297 for (
int i = 0;
p->memcpy_out &&
i <
p->planes_out;
i++) {
310 alloc_size += aligned_w *
sizeof(*exec->
in_offset_x);
317 uint8_t *tail_buf =
p->tail_buf;
318 for (
int i = 0; memcpy_in &&
i <
p->planes_in;
i++) {
319 tail->
in[
i] = tail_buf;
323 for (
int i = 0;
p->memcpy_out &&
i <
p->planes_out;
i++) {
324 tail->
out[
i] = tail_buf;
330 for (
int i = safe_width;
i < aligned_w;
i++)
338 const uint8_t *
src,
const size_t src_stride,
339 const int h,
const size_t bytes)
341 for (
int y = 0; y <
h; y++) {
373 const bool memcpy_in =
p->memcpy_last && y +
h == pass->
height ||
374 p->memcpy_first && y == 0;
375 const bool memcpy_out =
p->memcpy_out;
376 const size_t num_blocks =
p->num_blocks;
377 const size_t tail_blocks =
p->tail_blocks;
380 if (!memcpy_in && !memcpy_out) {
382 comp->func(&exec,
comp->priv, 0, y, num_blocks, y +
h);
388 if (num_blocks > tail_blocks) {
389 for (
int i = 0;
i < 4;
i++) {
393 exec.in_bump[
i] += exec.block_size_in * tail_blocks;
394 exec.out_bump[
i] += exec.block_size_out * tail_blocks;
397 comp->func(&exec,
comp->priv, 0, y, num_blocks - tail_blocks, y +
h);
404 for (
int i = 0;
i <
p->planes_in;
i++) {
406 if (!exec.in_offset_x || memcpy_in)
407 exec.in[
i] +=
p->tail_off_in;
408 tail.in[
i] += y * tail.in_stride[
i];
410 for (
int i = 0;
i <
p->planes_out;
i++) {
411 exec.out[
i] +=
p->tail_off_out;
412 tail.out[
i] += y * tail.out_stride[
i];
415 for (
int i = 0;
i <
p->planes_in;
i++) {
418 exec.in[
i], exec.in_stride[
i],
h,
p->tail_size_in);
421 const size_t loop_size = tail_blocks * exec.block_size_in;
422 tail.in[
i] = exec.in[
i];
423 tail.in_stride[
i] = exec.in_stride[
i];
424 tail.in_bump[
i] = exec.in_stride[
i] - loop_size;
428 for (
int i = 0; !memcpy_out &&
i <
p->planes_out;
i++) {
430 const size_t loop_size = tail_blocks * exec.block_size_out;
431 tail.out[
i] = exec.out[
i];
432 tail.out_stride[
i] = exec.out_stride[
i];
433 tail.out_bump[
i] = exec.out_stride[
i] - loop_size;
438 comp->func(&tail,
comp->priv, num_blocks - tail_blocks, y, num_blocks, y +
h);
440 for (
int i = 0; memcpy_out &&
i <
p->planes_out;
i++) {
442 tail.out[
i], tail.out_stride[
i],
h,
p->tail_size_out);
448 return op->rw.packed ? 1 :
op->rw.elems;
453 const int elems =
op->rw.packed ?
op->rw.elems : 1;
455 const int bits = 8 >>
op->rw.frac;
466 const int pad = (over_rw * 8 + pixel_bits - 1) / pixel_bits;
489 if (
p->comp.opaque) {
493 input,
c.slice_align,
c.func_opaque,
505 .height =
dst->height,
510 if (block_bits_in & 0x7 || block_bits_out & 0x7) {
516 p->exec_base.block_size_in = block_bits_in >> 3;
517 p->exec_base.block_size_out = block_bits_out >> 3;
519 for (
int i = 0;
i < 4;
i++) {
536 for (
int y = 0; y <
filter->dst_size - 1; y++) {
537 int next =
filter->offsets[y + 1];
538 bump[y] = next -
line - 1;
541 bump[
filter->dst_size - 1] = 0;
542 p->exec_base.in_bump_y = bump;
551 p->exec_base.in_offset_x =
offset;
553 for (
int x = 0; x <
filter->dst_size; x++) {
558 if ((
bits & 0x7) || (
bits >> 3) > INT32_MAX) {
564 for (
int x =
filter->dst_size; x < pixels; x++)
566 p->exec_base.block_size_in = 0;
567 p->filter_size =
filter->filter_size;
603 if (!
read || !write) {
605 "and write, respectively.\n");
631 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
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 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
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)
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.