ops_dispatch.c File Reference

#include "libavutil/avassert.h"
#include "libavutil/cpu.h"
#include "libavutil/mathematics.h"
#include "libavutil/mem.h"
#include "libavutil/mem_internal.h"
#include "libavutil/refstruct.h"
#include "ops.h"
#include "ops_internal.h"
#include "ops_dispatch.h"

Go to the source code of this file.

Data Structures
struct	SwsOpPass
	Copyright (C) 2025 Niklas Haas. More...

Functions
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. More...
int	ff_sws_ops_compile (SwsContext *ctx, const SwsOpList *ops, SwsCompiledOp *out)
	Compile a list of operations using the best available backend. More...
void	ff_sws_compiled_op_unref (SwsCompiledOp *comp)
static void	op_pass_free (void *ptr)
static void	get_row_data (const SwsOpPass *p, const int y_dst, const uint8_t *in[4], uint8_t *out[4])
static size_t	pixel_bytes (size_t pixels, int pixel_bits, enum AVRounding rounding)
static size_t	safe_bytes_pad (int linesize, int plane_pad)
static size_t	safe_blocks_offset (size_t num_blocks, unsigned block_size, ptrdiff_t safe_offset, const int32_t *offset_bytes)
static int	op_pass_setup (const SwsFrame *out, const SwsFrame *in, const SwsPass *pass)
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)
static void	op_pass_run (const SwsFrame *out, const SwsFrame *in, const int y, const int h, const SwsPass *pass)
static int	rw_planes (const SwsOp *op)
static int	rw_pixel_bits (const SwsOp *op)
static void	align_pass (SwsPass *pass, int block_size, int over_rw, int pixel_bits)
static int	compile (SwsGraph *graph, const SwsOpList *ops, SwsPass *input, SwsPass **output)
int	ff_sws_compile_pass (SwsGraph *graph, SwsOpList **pops, int flags, SwsPass *input, SwsPass **output)
	Resolves an operation list to a graph pass. More...

Function Documentation

ff_sws_ops_compile_backend()

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.

Returns 0 on success, or a negative error code on failure.

Definition at line 57 of file ops_dispatch.c.

Referenced by check_ops(), and ff_sws_ops_compile().

ff_sws_ops_compile()

int ff_sws_ops_compile	(	SwsContext *	ctx,
		const SwsOpList *	ops,
		SwsCompiledOp *	out
	)

Compile a list of operations using the best available backend.

Returns 0 on success, or a negative error code on failure.

Definition at line 84 of file ops_dispatch.c.

Referenced by compile().

ff_sws_compiled_op_unref()

void ff_sws_compiled_op_unref

(

SwsCompiledOp *

comp

)

Definition at line 106 of file ops_dispatch.c.

Referenced by check_ops(), and op_pass_free().

op_pass_free()

static void op_pass_free ( void *  ptr )

static

Definition at line 114 of file ops_dispatch.c.

Referenced by compile().

get_row_data()

static void get_row_data ( const SwsOpPass *  p, const int  y_dst, const uint8_t *  in[4], uint8_t *  out[4]  )

inlinestatic

Definition at line 128 of file ops_dispatch.c.

Referenced by op_pass_run().

pixel_bytes()

static size_t pixel_bytes ( size_t  pixels, int  pixel_bits, enum AVRounding  rounding  )

inlinestatic

Definition at line 139 of file ops_dispatch.c.

Referenced by op_pass_setup().

safe_bytes_pad()

static size_t safe_bytes_pad ( int  linesize, int  plane_pad  )

static

Definition at line 156 of file ops_dispatch.c.

Referenced by op_pass_setup().

safe_blocks_offset()

static size_t safe_blocks_offset ( size_t  num_blocks, unsigned  block_size, ptrdiff_t  safe_offset, const int32_t *  offset_bytes  )

static

Definition at line 163 of file ops_dispatch.c.

Referenced by op_pass_setup().

op_pass_setup()

static int op_pass_setup ( const SwsFrame *  out, const SwsFrame *  in, const SwsPass *  pass  )

static

Definition at line 173 of file ops_dispatch.c.

Referenced by compile().

copy_lines()

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  )

static

Definition at line 330 of file ops_dispatch.c.

Referenced by op_pass_run().

op_pass_run()

static void op_pass_run ( const SwsFrame *  out, const SwsFrame *  in, const int  y, const int  h, const SwsPass *  pass  )

static

To ensure safety, we need to consider the following:

1. We can overread the input, unless this is the last line of an unpadded buffer. All defined operations can handle arbitrary pixel input, so overread of arbitrary data is fine. For flipped images, this condition is actually inverted to where the first line is the one at the end of the buffer.
2. We can overwrite the output, as long as we don't write more than the amount of pixels that fit into one linesize. So we always need to memcpy the last column on the output side if unpadded.

Definition at line 341 of file ops_dispatch.c.

Referenced by compile().

rw_planes()

static int rw_planes ( const SwsOp *  op )

static

Definition at line 439 of file ops_dispatch.c.

Referenced by compile().

rw_pixel_bits()

static int rw_pixel_bits ( const SwsOp *  op )

static

Definition at line 444 of file ops_dispatch.c.

Referenced by compile().

align_pass()

static void align_pass ( SwsPass *  pass, int  block_size, int  over_rw, int  pixel_bits  )

static

Definition at line 453 of file ops_dispatch.c.

Referenced by compile().

compile()

static int compile ( SwsGraph *  graph, const SwsOpList *  ops, SwsPass *  input, SwsPass **  output  )

static

Definition at line 466 of file ops_dispatch.c.

Referenced by ff_sws_compile_pass().

ff_sws_compile_pass()

int ff_sws_compile_pass	(	SwsGraph *	graph,
		SwsOpList **	ops,
		int	flags,
		SwsPass *	input,
		SwsPass **	output
	)

Resolves an operation list to a graph pass.

The first and last operations must be a read/write respectively. flags is a list of SwsOpCompileFlags.

Takes over ownership of ops and sets it to NULL, even on failure.

Note: ops may be modified by this function.

Definition at line 576 of file ops_dispatch.c.