#include "libavutil/avassert.h"
#include "libavutil/avstring.h"
#include "libavutil/bswap.h"
#include "libavutil/mem.h"
#include "libavutil/rational.h"
#include "libavutil/refstruct.h"
#include "ops.h"
#include "ops_internal.h"

Macros
#define	PRINTQ(q) print_q(q, (char[32]){0}, sizeof(char[32]))

Functions
const char *	ff_sws_pixel_type_name (SwsPixelType type)

int	ff_sws_pixel_type_size (SwsPixelType type)

bool	ff_sws_pixel_type_is_int (SwsPixelType type)

const char *	ff_sws_op_type_name (SwsOpType op)

static AVRational	av_min_q (AVRational a, AVRational b)

static AVRational	av_max_q (AVRational a, AVRational b)

void	ff_sws_apply_op_q (const SwsOp *op, AVRational x[4])
	Apply an operation to an AVRational. More...

static SwsCompFlags	merge_comp_flags (SwsCompFlags a, SwsCompFlags b)

static void	propagate_flags (SwsOp op, const SwsComps prev)

static void	clear_undefined_values (AVRational dst[4], const AVRational src[4])

void	ff_sws_op_list_update_comps (SwsOpList *ops)
	Infer + propagate known information about components. More...

static void	op_uninit (SwsOp *op)

SwsOpList *	ff_sws_op_list_alloc (void)

void	ff_sws_op_list_free (SwsOpList **p_ops)

SwsOpList *	ff_sws_op_list_duplicate (const SwsOpList *ops)
	Returns a duplicate of `ops`, or NULL on OOM. More...

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. More...

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. More...

void	ff_sws_op_list_remove_at (SwsOpList *ops, int index, int count)

int	ff_sws_op_list_insert_at (SwsOpList ops, int index, SwsOp op)

int	ff_sws_op_list_append (SwsOpList ops, SwsOp op)
	These will take over ownership of `op` and set it to {0}, even on failure. More...

bool	ff_sws_op_list_is_noop (const SwsOpList *ops)
	Returns whether an op list represents a true no-op operation, i.e. More...

int	ff_sws_op_list_max_size (const SwsOpList *ops)
	Returns the size of the largest pixel type used in `ops`. More...

uint32_t	ff_sws_linear_mask (const SwsLinearOp c)

static const char *	describe_lin_mask (uint32_t mask)

static char	describe_comp_flags (SwsCompFlags flags)

static const char *	describe_order (SwsSwizzleOp order, int planes, char buf[32])

static const char *	print_q (const AVRational q, char buf[], int buf_len)

void	ff_sws_op_list_print (void log, int lev, int lev_extra, const SwsOpList ops)
	Print out the contents of an operation list. More...

Variables
const SwsOpBackend	backend_c
	Copyright (C) 2025 Niklas Haas. More...

const SwsOpBackend	backend_murder

const SwsOpBackend	backend_x86

const SwsOpBackend	backend_vulkan

const SwsOpBackend *const	ff_sws_op_backends []

static const SwsCompFlags	flags_identity = SWS_COMP_ZERO \| SWS_COMP_EXACT

Macro Definition Documentation

◆ PRINTQ

#define PRINTQ ( q ) print_q(q, (char[32]){0}, sizeof(char[32]))

Definition at line 752 of file ops.c.

Function Documentation

◆ ff_sws_pixel_type_name()

const char* ff_sws_pixel_type_name ( SwsPixelType type )

Definition at line 48 of file ops.c.

Referenced by check_clear(), check_convert(), check_dither(), check_linear(), check_min_max(), check_read_write(), check_scale(), check_shift(), check_swizzle(), and ff_sws_op_list_print().

◆ ff_sws_pixel_type_size()

int ff_sws_pixel_type_size ( SwsPixelType type )

Definition at line 63 of file ops.c.

Referenced by check_clear(), check_convert(), check_scale(), compile(), ff_sws_apply_op_q(), ff_sws_op_list_max_size(), ff_sws_pixel_expand(), ff_sws_solve_shuffle(), normalize_clear(), op_match(), rndq(), rw_pixel_bits(), and setup_swap_bytes().

◆ ff_sws_pixel_type_is_int()

bool ff_sws_pixel_type_is_int ( SwsPixelType type )

Definition at line 78 of file ops.c.

Referenced by check_clear(), check_convert(), check_dither(), check_linear(), check_scale(), check_shift(), ff_sws_apply_op_q(), ff_sws_op_list_optimize(), ff_sws_op_list_update_comps(), and rndq().

◆ ff_sws_op_type_name()

const char* ff_sws_op_type_name ( SwsOpType op )

Definition at line 95 of file ops.c.

Referenced by ff_sws_op_list_print().

◆ av_min_q()

static AVRational av_min_q	(	AVRational	a,
		AVRational	b
	)

static

Definition at line 122 of file ops.c.

Referenced by ff_sws_apply_op_q().

◆ av_max_q()

static AVRational av_max_q	(	AVRational	a,
		AVRational	b
	)

static

Definition at line 127 of file ops.c.

Referenced by ff_sws_apply_op_q().

◆ ff_sws_apply_op_q()

void ff_sws_apply_op_q	(	const SwsOp *	op,
		AVRational	x[4]
	)

Apply an operation to an AVRational.

No-op for read/write operations.

Definition at line 132 of file ops.c.

Referenced by ff_sws_op_list_update_comps(), and op_commute_clear().

◆ merge_comp_flags()

static SwsCompFlags merge_comp_flags	(	SwsCompFlags	a,
		SwsCompFlags	b
	)

static

Definition at line 243 of file ops.c.

Referenced by ff_sws_op_list_update_comps().

◆ propagate_flags()

static void propagate_flags	(	SwsOp *	op,
		const SwsComps *	prev
	)

static

Definition at line 251 of file ops.c.

Referenced by ff_sws_op_list_update_comps().

◆ clear_undefined_values()

static void clear_undefined_values	(	AVRational	dst[4],
		const AVRational	src[4]
	)

static

Definition at line 258 of file ops.c.

Referenced by ff_sws_op_list_update_comps().

◆ ff_sws_op_list_update_comps()

void ff_sws_op_list_update_comps ( SwsOpList * ops )

Infer + propagate known information about components.

Called automatically when needed by the optimizer and compiler.

Definition at line 267 of file ops.c.

Referenced by ff_sws_op_list_optimize(), and ff_sws_ops_compile_backend().

◆ op_uninit()

static void op_uninit ( SwsOp * op )

static

Definition at line 504 of file ops.c.

Referenced by ff_sws_op_list_free(), ff_sws_op_list_insert_at(), and ff_sws_op_list_remove_at().

◆ ff_sws_op_list_alloc()

SwsOpList* ff_sws_op_list_alloc ( void )

Definition at line 515 of file ops.c.

Referenced by run_test().

◆ ff_sws_op_list_free()

void ff_sws_op_list_free ( SwsOpList ** p_ops )

Definition at line 527 of file ops.c.

Referenced by ff_sws_compile_pass(), ff_sws_ops_compile_backend(), and run_test().

◆ ff_sws_op_list_duplicate()

SwsOpList* ff_sws_op_list_duplicate ( const SwsOpList * ops )

Returns a duplicate of ops, or NULL on OOM.

Definition at line 541 of file ops.c.

Referenced by ff_sws_ops_compile_backend().

◆ ff_sws_op_list_input()

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.

for a pure CLEAR-only operation list).

This will always be an op of type SWS_OP_READ.

Definition at line 570 of file ops.c.

Referenced by compile(), ff_sws_compile_pass(), ff_sws_op_list_is_noop(), and ff_sws_solve_shuffle().

◆ ff_sws_op_list_output()

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.

This will always be an op of type SWS_OP_WRITE.

Definition at line 579 of file ops.c.

Referenced by compile(), ff_sws_compile_pass(), and ff_sws_op_list_is_noop().

◆ ff_sws_op_list_remove_at()

void ff_sws_op_list_remove_at	(	SwsOpList *	ops,
		int	index,
		int	count
	)

Definition at line 588 of file ops.c.

Referenced by ff_sws_op_list_optimize().

◆ ff_sws_op_list_insert_at()

int ff_sws_op_list_insert_at	(	SwsOpList *	ops,
		int	index,
		SwsOp *	op
	)

Definition at line 598 of file ops.c.

Referenced by ff_sws_op_list_append(), and ff_sws_op_list_optimize().

◆ ff_sws_op_list_append()

int ff_sws_op_list_append	(	SwsOpList *	ops,
		SwsOp *	op
	)

These will take over ownership of op and set it to {0}, even on failure.

Definition at line 612 of file ops.c.

◆ ff_sws_op_list_is_noop()

bool ff_sws_op_list_is_noop ( const SwsOpList * ops )

Returns whether an op list represents a true no-op operation, i.e.

may be eliminated entirely from an execution graph.

Note that this check is unlikely to ever be hit in practice, since it would imply the existence of planar formats with different plane orders between them, e.g. rgbap <-> gbrap, which doesn't currently exist. However, the check is cheap and lets me sleep at night.

Definition at line 617 of file ops.c.

Referenced by ff_sws_compile_pass(), and run_test().

◆ ff_sws_op_list_max_size()

int ff_sws_op_list_max_size ( const SwsOpList * ops )

Returns the size of the largest pixel type used in ops.

Definition at line 646 of file ops.c.

Referenced by compile().

◆ ff_sws_linear_mask()

uint32_t ff_sws_linear_mask ( const SwsLinearOp c )

Definition at line 657 of file ops.c.

Referenced by extract_swizzle(), and ff_sws_op_list_optimize().

◆ describe_lin_mask()

static const char* describe_lin_mask ( uint32_t mask )

static

Definition at line 669 of file ops.c.

Referenced by ff_sws_op_list_print().

◆ describe_comp_flags()

static char describe_comp_flags ( SwsCompFlags flags )

static

Definition at line 710 of file ops.c.

Referenced by ff_sws_op_list_print().

◆ describe_order()

static const char* describe_order	(	SwsSwizzleOp	order,
		int	planes,
		char	buf[32]
	)

static

Definition at line 724 of file ops.c.

Referenced by ff_sws_op_list_print().

◆ print_q()

static const char* print_q	(	const AVRational	q,
		char	buf[],
		int	buf_len
	)

static

Definition at line 736 of file ops.c.

◆ 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 at line 754 of file ops.c.

Referenced by compile(), ff_sws_compile_pass(), ff_sws_ops_compile(), and run_test().

Variable Documentation

◆ backend_c

const SwsOpBackend backend_c

This file is part of FFmpeg.

FFmpeg is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

FFmpeg is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with FFmpeg; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA

Definition at line 104 of file ops_backend.c.

◆ backend_murder

const SwsOpBackend backend_murder

Definition at line 130 of file ops_memcpy.c.

◆ backend_x86

const SwsOpBackend backend_x86

Definition at line 765 of file ops.c.

◆ backend_vulkan

const SwsOpBackend backend_vulkan

Definition at line 339 of file ops.c.

◆ ff_sws_op_backends

const SwsOpBackend* const ff_sws_op_backends[]

Initial value:

= {
    &backend_murder,
 
    &backend_c,
 
    NULL
}

Definition at line 36 of file ops.c.

Referenced by check_ops(), and ff_sws_ops_compile().

◆ flags_identity

const SwsCompFlags flags_identity = SWS_COMP_ZERO | SWS_COMP_EXACT

static

Definition at line 242 of file ops.c.

Referenced by ff_sws_op_list_update_comps().

Macros

Functions

Variables

Macro Definition Documentation

◆ PRINTQ

Function Documentation

◆ ff_sws_pixel_type_name()

◆ ff_sws_pixel_type_size()

◆ ff_sws_pixel_type_is_int()

◆ ff_sws_op_type_name()

◆ av_min_q()

◆ av_max_q()

◆ ff_sws_apply_op_q()

◆ merge_comp_flags()

◆ propagate_flags()

◆ clear_undefined_values()

◆ ff_sws_op_list_update_comps()

◆ op_uninit()

◆ ff_sws_op_list_alloc()

◆ ff_sws_op_list_free()

◆ ff_sws_op_list_duplicate()

◆ ff_sws_op_list_input()

◆ ff_sws_op_list_output()

◆ ff_sws_op_list_remove_at()

◆ ff_sws_op_list_insert_at()

◆ ff_sws_op_list_append()

◆ ff_sws_op_list_is_noop()

◆ ff_sws_op_list_max_size()

◆ ff_sws_linear_mask()

◆ describe_lin_mask()

◆ describe_comp_flags()

◆ describe_order()

◆ print_q()

◆ ff_sws_op_list_print()

Variable Documentation

◆ backend_c

◆ backend_murder

◆ backend_x86

◆ backend_vulkan

◆ ff_sws_op_backends

◆ flags_identity