graph.h File Reference

#include <stdbool.h>
#include "libavutil/slicethread.h"
#include "libavutil/buffer.h"
#include "swscale.h"
#include "format.h"
#include "lut3d.h"

Data Structures

struct SwsPassBuffer

Represents an output buffer for a filter pass. More...

struct SwsPass

Represents a single filter pass in the scaling graph. More...

struct SwsGraph

Filter graph, which represents a 'baked' pixel format conversion. More...

Typedefs

typedef void(* SwsPassFunc) (const SwsFrame *out, const SwsFrame *in, int y, int h, const SwsPass *pass)

Output h lines of filtered data.

typedef int(* SwsPassSetup) (const SwsFrame *out, const SwsFrame *in, const SwsPass *pass)

Function to run from the main thread before processing any lines.

Functions

static av_always_inline av_const int ff_fmt_vshift (enum AVPixelFormat fmt, int plane)

int ff_sws_pass_aligned_width (const SwsPass *pass, int width)

Align width to the optimal size for pass.

SwsGraph * ff_sws_graph_alloc (void)

Allocate an empty SwsGraph.

int ff_sws_graph_init (SwsGraph *graph, SwsContext *ctx, const SwsFormat *dst, const SwsFormat *src)

Initialize the filter graph for a given pair of formats.

int ff_sws_graph_add_pass (SwsGraph *graph, enum AVPixelFormat fmt, int width, int height, SwsPass *input, int lines, int align, SwsPassFunc run, SwsPassSetup setup, void *priv, void(*free)(void *priv), SwsPass **out_pass)

Allocate and add a new pass to the filter graph.

void ff_sws_pass_link_output (SwsPass *dst, const SwsPass *src)

Link the output buffers to a different pass, rather than allocating new image buffers.

void ff_sws_graph_rollback (SwsGraph *graph, int since_idx)

Remove all passes added since the given index.

void ff_sws_graph_free (SwsGraph **graph)

Uninitialize any state associate with this filter graph and free it.

void ff_sws_graph_update_metadata (SwsGraph *graph, const SwsColor *color)

Update dynamic per-frame HDR metadata without requiring a full reinit.

int ff_sws_graph_reinit (SwsGraph *graph, SwsContext *ctx, const SwsFormat *dst, const SwsFormat *src)

Wrapper around ff_sws_graph_init() that reuses the existing graph if the format is compatible.

int ff_sws_graph_run (SwsGraph *graph, const AVFrame *dst, const AVFrame *src)

Dispatch the filter graph on a single field of the given frames.

Typedef Documentation

◆ SwsPassFunc

typedef void(* SwsPassFunc) (const SwsFrame *out, const SwsFrame *in, int y, int h, const SwsPass *pass)

Output h lines of filtered data.

out and in point to the start of the image buffer for this pass.

Definition at line 46 of file graph.h.

◆ SwsPassSetup

typedef int(* SwsPassSetup) (const SwsFrame *out, const SwsFrame *in, const SwsPass *pass)

Function to run from the main thread before processing any lines.

Definition at line 52 of file graph.h.

Function Documentation

◆ ff_fmt_vshift()

static av_always_inline av_const int ff_fmt_vshift ( enum AVPixelFormat fmt,

int plane )

static

Definition at line 33 of file graph.h.

Referenced by frame_shift(), and run_copy().

◆ ff_sws_pass_aligned_width()

int ff_sws_pass_aligned_width ( const SwsPass * pass,

int width )

Align width to the optimal size for pass.

Definition at line 46 of file graph.c.

Referenced by sws_frame_setup().

◆ ff_sws_graph_alloc()

SwsGraph * ff_sws_graph_alloc ( void )

Allocate an empty SwsGraph.

Returns NULL on failure.

Definition at line 866 of file graph.c.

Referenced by main(), main(), sws_frame_setup(), and sws_uops_macros_gen().

◆ ff_sws_graph_init()

int ff_sws_graph_init ( SwsGraph * graph,

SwsContext * ctx,

const SwsFormat * dst,

const SwsFormat * src )

Initialize the filter graph for a given pair of formats.

Returns 0 or a negative error.

Definition at line 884 of file graph.c.

Referenced by ff_sws_graph_reinit().

◆ ff_sws_graph_add_pass()

int ff_sws_graph_add_pass ( SwsGraph * graph,

enum AVPixelFormat fmt,

int width,

int height,

SwsPass * input,

int lines,

int align,

SwsPassFunc run,

SwsPassSetup setup,

void * priv,

void(* free )(void *priv),

SwsPass ** out_pass )

Allocate and add a new pass to the filter graph.

Takes over ownership of priv, even on failure.

Parameters: graph Filter graph to add the pass to.

fmt Pixel format of the output image.

w Width of the output image.

h Height of the output image.

input Previous pass to read from, or NULL for the input image.

lines Override the number of lines processed for this pass. (Optional)

align Minimum slice alignment for this pass, or 0 for no threading.

run Filter function to run.

setup Optional setup function to run from the main thread.

priv Private state for the filter run function.

free Function to free the private state.

out_pass The newly added pass will be written here on success.

Returns: 0 or a negative error code

Definition at line 191 of file graph.c.

Referenced by add_legacy_3dlut_pass(), compile_single(), init_legacy_subpass(), and init_passes().

◆ ff_sws_pass_link_output()

void ff_sws_pass_link_output ( SwsPass * dst,

const SwsPass * src )

Link the output buffers to a different pass, rather than allocating new image buffers.

This allows reusing the same buffer for multiple passes, e.g. in the case of in-place passes or partial passes that modify different planes.

Any existing buffer on dst will be ignored/unref'd.

Definition at line 249 of file graph.c.

Referenced by compile_single().

◆ ff_sws_graph_rollback()

void ff_sws_graph_rollback ( SwsGraph * graph,

int since_idx )

Remove all passes added since the given index.

Definition at line 935 of file graph.c.

Referenced by ff_sws_compile_pass().

◆ ff_sws_graph_free()

void ff_sws_graph_free ( SwsGraph ** graph )

Uninitialize any state associate with this filter graph and free it.

Definition at line 942 of file graph.c.

Referenced by main(), main(), sws_frame_setup(), sws_freeContext(), and sws_uops_macros_gen().

◆ ff_sws_graph_update_metadata()

void ff_sws_graph_update_metadata ( SwsGraph * graph,

const SwsColor * color )

Update dynamic per-frame HDR metadata without requiring a full reinit.

Definition at line 987 of file graph.c.

Referenced by ff_sws_graph_reinit().

◆ ff_sws_graph_reinit()

int ff_sws_graph_reinit ( SwsGraph * graph,

SwsContext * ctx,

const SwsFormat * dst,

const SwsFormat * src )

Wrapper around ff_sws_graph_init() that reuses the existing graph if the format is compatible.

This will also update dynamic per-frame metadata.

Must also be called after changing any of the fields in ctx, or else they will have no effect.

Definition at line 973 of file graph.c.

Referenced by sws_frame_setup().

◆ ff_sws_graph_run()

int ff_sws_graph_run ( SwsGraph * graph,

const AVFrame * dst,

const AVFrame * src )

Dispatch the filter graph on a single field of the given frames.

Internally threaded.

Definition at line 1026 of file graph.c.

Referenced by sws_scale_frame().

Generated on Sun Sep 6 2026 19:21:22 for FFmpeg by doxygen 1.13.2