Go to the documentation of this file.
58 ptrdiff_t linesize1[4];
59 for (
int i = 0;
i < 4;
i++)
77 for (
int i = 0;
i < 4;
i++) {
176 for (
int j = 0; j < lines; j++) {
177 memcpy(
out.data[
i], in.
data[
i], linesize);
189 const int x0 =
c->src0Alpha - 1;
190 const int w4 = 4 * pass->
width;
191 const int src_stride = in->
linesize[0];
192 const int dst_stride =
out->linesize[0];
193 const uint8_t *
src = in->
data[0] + y * src_stride;
194 uint8_t *
dst =
out->data[0] + y * dst_stride;
196 for (
int y = 0; y <
h; y++) {
198 for (
int x = x0; x < w4; x += 4)
210 c->xyz12Torgb48(
c,
out->data[0] + y *
out->linesize[0],
out->linesize[0],
219 c->rgb48Toxyz12(
c,
out->data[0] + y *
out->linesize[0],
out->linesize[0],
242 for (
int i = 0;
i < 4;
i++)
243 memset(
c->dither_error[
i], 0,
sizeof(
c->dither_error[0][0]) * (
sws->
dst_w + 2));
276 c->convert_unscaled(
c, (
const uint8_t *
const *) in.
data, in.
linesize, y,
h,
277 out->data,
out->linesize);
309 x_pos *= (1 << sub_x) - 1;
310 y_pos *= (1 << sub_y) - 1;
322 y_pos += (256 << sub_y) - 256;
330 *h_chr_pos = sub_x ? x_pos : -513;
331 *v_chr_pos = sub_y ? y_pos : -513;
336 if (
override == -513 ||
override == *chr_pos)
341 "Setting chroma position directly is deprecated, make sure "
342 "the frame is tagged with the correct chroma location.\n");
356 const int unscaled = src_w == dst_w && src_h == dst_h;
357 int align =
c->dst_slice_align;
361 if (
c->cascaded_context[0]) {
362 const int num_cascaded =
c->cascaded_context[2] ? 3 : 2;
363 for (
int i = 0;
i < num_cascaded;
i++) {
364 const int is_last =
i + 1 == num_cascaded;
368 c->cascaded_context[
i] =
NULL;
390 if (
c->srcXYZ && !(
c->dstXYZ && unscaled)) {
444 c2->srcColorspaceTable[
i] =
c->srcColorspaceTable[
i];
445 c2->dstColorspaceTable[
i] =
c->dstColorspaceTable[
i];
450 if (
c->dstXYZ && !(
c->srcXYZ && unscaled)) {
506 int in_full, out_full, brightness, contrast,
saturation;
507 const int *inv_table, *
table;
509 (
int **)&
table, &out_full,
545 if (
src.width !=
dst.width ||
src.height !=
dst.height ||
546 src.desc->log2_chroma_h ||
src.desc->log2_chroma_w ||
547 dst.desc->log2_chroma_h ||
dst.desc->log2_chroma_w)
597 #define add_convert_pass add_legacy_sws_pass
667 if (fmt_in !=
src.format) {
736 const int slice_y = jobnr * pass->
slice_h;
759 graph->num_threads = 1;
763 graph->num_threads =
ret;
801 return c1->flags ==
c2->flags &&
802 c1->threads ==
c2->threads &&
803 c1->dither ==
c2->dither &&
804 c1->alpha_blend ==
c2->alpha_blend &&
805 c1->gamma_flag ==
c2->gamma_flag &&
806 c1->src_h_chr_pos ==
c2->src_h_chr_pos &&
807 c1->src_v_chr_pos ==
c2->src_v_chr_pos &&
808 c1->dst_h_chr_pos ==
c2->dst_h_chr_pos &&
809 c1->dst_v_chr_pos ==
c2->dst_v_chr_pos &&
810 c1->intent ==
c2->intent &&
811 !memcmp(
c1->scaler_params,
c2->scaler_params,
sizeof(
c1->scaler_params));
static void error(const char *err)
int sws_setColorspaceDetails(SwsContext *c, const int inv_table[4], int srcRange, const int table[4], int dstRange, int brightness, int contrast, int saturation)
void ff_sws_op_list_free(SwsOpList **p_ops)
#define AV_LOG_WARNING
Something somehow does not look correct.
AVPixelFormat
Pixel format.
AVSliceThread * slicethread
Represents a single filter pass in the scaling graph.
SwsOpList * ff_sws_op_list_alloc(void)
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
SwsPass ** passes
Sorted sequence of filter passes to apply.
static int adapt_colors(SwsGraph *graph, SwsFormat src, SwsFormat dst, SwsPass *input, SwsPass **output)
static int init_passes(SwsGraph *graph)
int src_w
Deprecated frame property overrides, for the legacy API only.
uint8_t * data
The data buffer.
int ff_sws_graph_reinit(SwsContext *ctx, const SwsFormat *dst, const SwsFormat *src, int field, SwsGraph **out_graph)
Wrapper around ff_sws_graph_create() that reuses the existing graph if the format is compatible.
RefStruct is an API for creating reference-counted objects with minimal overhead.
enum AVPixelFormat format
static IPT saturation(const CmsCtx *ctx, IPT ipt)
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
void(* sws_filter_run_t)(const SwsImg *out, const SwsImg *in, int y, int h, const SwsPass *pass)
Output h lines of filtered data.
SwsFormat src
Currently active format and processing parameters.
void avpriv_slicethread_execute(AVSliceThread *ctx, int nb_jobs, int execute_main)
Execute slice threading.
@ AVCOL_RANGE_JPEG
Full range content.
static av_always_inline int isGray(enum AVPixelFormat pix_fmt)
static const uint16_t table[]
unsigned flags
Bitmask of SWS_*.
#define AV_LOG_VERBOSE
Detailed information.
enum AVPixelFormat ff_sws_lut3d_pick_pixfmt(SwsFormat fmt, int output)
Pick the best compatible pixfmt for a given SwsFormat.
void(* free)(void *priv)
Optional private state and associated free() function.
Represents a view into a single field of frame data.
AVBufferRef * buf[AV_NUM_DATA_POINTERS]
AVBuffer references backing the data for this frame.
int ff_sws_init_single_context(SwsContext *sws, SwsFilter *srcFilter, SwsFilter *dstFilter)
SwsPixelType
Copyright (C) 2025 Niklas Haas.
static int init_legacy_subpass(SwsGraph *graph, SwsContext *sws, SwsPass *input, SwsPass **output)
int avpriv_slicethread_create(AVSliceThread **pctx, void *priv, void(*worker_func)(void *priv, int jobnr, int threadnr, int nb_jobs, int nb_threads), void(*main_func)(void *priv), int nb_threads)
Create slice threading context.
static int pass_append(SwsGraph *graph, enum AVPixelFormat fmt, int w, int h, SwsPass **pass, int align, void *priv, sws_filter_run_t run)
int src_v_chr_pos
Source vertical chroma position in luma grid / 256.
static SwsContext * slice_ctx(const SwsPass *pass, int y)
av_warn_unused_result int sws_init_context(SwsContext *sws_context, SwsFilter *srcFilter, SwsFilter *dstFilter)
Initialize the swscaler context sws_context.
SwsContext opts_copy
Cached copy of the public options that were used to construct this SwsGraph.
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 type
int av_image_check_size2(unsigned int w, unsigned int h, int64_t max_pixels, enum AVPixelFormat pix_fmt, int log_offset, void *log_ctx)
Check if the given dimension of an image is valid, meaning that all bytes of a plane of an image with...
int ff_sws_graph_create(SwsContext *ctx, const SwsFormat *dst, const SwsFormat *src, int field, SwsGraph **out_graph)
Allocate and initialize the filter graph.
#define FF_ARRAY_ELEMS(a)
static void legacy_chr_pos(SwsGraph *graph, int *chr_pos, int override, int *warned)
SwsDither dither
Dither mode.
int av_image_fill_linesizes(int linesizes[4], enum AVPixelFormat pix_fmt, int width)
Fill plane linesizes for an image with pixel format pix_fmt and width width.
int av_chroma_location_enum_to_pos(int *xpos, int *ypos, enum AVChromaLocation pos)
Converts AVChromaLocation to swscale x/y chroma position.
void ff_update_palette(SwsInternal *c, const uint32_t *pal)
int flags
Flags modifying the (de)muxer behaviour.
SwsLut3D * ff_sws_lut3d_alloc(void)
void(* setup)(const SwsImg *out, const SwsImg *in, const SwsPass *pass)
Called once from the main thread before running the filter.
#define av_assert0(cond)
assert() equivalent, that is always enabled.
int intent
Desired ICC intent for color space conversions.
static void * av_refstruct_alloc_ext(size_t size, unsigned flags, void *opaque, void(*free_cb)(AVRefStructOpaque opaque, void *obj))
A wrapper around av_refstruct_alloc_ext_c() for the common case of a non-const qualified opaque.
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
#define AV_PIX_FMT_FLAG_ALPHA
The pixel format has an alpha channel.
static AVFormatContext * ctx
void ff_sws_lut3d_update(SwsLut3D *lut3d, const SwsColor *new_src)
Update the tone mapping state.
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 field
uint8_t log2_chroma_w
Amount to shift the luma width right to find the chroma width.
static void free_buffer(AVRefStructOpaque opaque, void *obj)
@ AV_PIX_FMT_RGBA
packed RGBA 8:8:8:8, 32bpp, RGBARGBA...
SwsPass * ff_sws_graph_add_pass(SwsGraph *graph, enum AVPixelFormat fmt, int width, int height, SwsPass *input, int align, void *priv, sws_filter_run_t run)
Allocate and add a new pass to the filter graph.
void ff_sws_lut3d_free(SwsLut3D **plut3d)
static const int sizes[][2]
New swscale design to change SwsGraph is what coordinates multiple passes These can include cascaded scaling error diffusion and so on Or we could have separate passes for the vertical and horizontal scaling In between each SwsPass lies a fully allocated image buffer Graph passes may have different levels of e g we can have a single threaded error diffusion pass following a multi threaded scaling pass SwsGraph is internally recreated whenever the image format
void ff_sws_graph_run(SwsGraph *graph, const SwsImg *output, const SwsImg *input)
Dispatch the filter graph on a single field.
void av_buffer_unref(AVBufferRef **buf)
Free a given reference and automatically free the buffer if there are no more references to it.
int gamma_flag
Use gamma correct scaling.
int av_image_fill_plane_sizes(size_t sizes[4], enum AVPixelFormat pix_fmt, int height, const ptrdiff_t linesizes[4])
Fill plane sizes for an image with pixel format pix_fmt and height height.
static void run_xyz2rgb(const SwsImg *out, const SwsImg *in, int y, int h, const SwsPass *pass)
int ff_sws_lut3d_generate(SwsLut3D *lut3d, enum AVPixelFormat fmt_in, enum AVPixelFormat fmt_out, const SwsColorMap *map)
Recalculate the (static) 3DLUT state with new settings.
int src_range
Source is full range.
size_t av_cpu_max_align(void)
Get the maximum data alignment that may be required by FFmpeg.
@ AVCOL_RANGE_UNSPECIFIED
int dst_h_chr_pos
Destination horizontal chroma position.
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
static void run_legacy_swscale(const SwsImg *out_base, const SwsImg *in, int y, int h, const SwsPass *pass)
int av_opt_copy(void *dst, const void *src)
Copy options from src object into dest object.
void ff_sws_graph_free(SwsGraph **pgraph)
Uninitialize any state associate with this filter graph and free it.
static int add_legacy_sws_pass(SwsGraph *graph, SwsFormat src, SwsFormat dst, SwsPass *input, SwsPass **output)
static void free_lut3d(void *priv)
SwsContext * sws_alloc_context(void)
Allocate an empty SwsContext and set its fields to default values.
uint8_t ptrdiff_t const uint8_t ptrdiff_t int intptr_t intptr_t int int16_t * dst
static av_always_inline int usePal(enum AVPixelFormat pix_fmt)
#define i(width, name, range_min, range_max)
static void setup_lut3d(const SwsImg *out, const SwsImg *in, const SwsPass *pass)
void ff_sws_lut3d_apply(const SwsLut3D *lut3d, const uint8_t *in, int in_stride, uint8_t *out, int out_stride, int w, int h)
Applies a color transformation to a plane.
SwsAlphaBlend alpha_blend
Alpha blending mode.
int src_h
Width and height of the source frame.
struct SwsGraph::@537 exec
Temporary execution state inside ff_sws_graph_run(); used to pass data to worker threads.
@ AVCHROMA_LOC_UNSPECIFIED
int sws_getColorspaceDetails(SwsContext *c, int **inv_table, int *srcRange, int **table, int *dstRange, int *brightness, int *contrast, int *saturation)
static const uint8_t *BS_FUNC() align(BSCTX *bc)
Skip bits to a byte boundary.
SwsPassBuffer * output
Filter output buffer.
AVBufferRef * av_buffer_alloc(size_t size)
Allocate an AVBuffer of the given size using av_malloc().
int dst_format
Destination pixel format.
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
AVChromaLocation
Location of chroma samples.
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...
static SwsContext * sws[3]
static void free_legacy_swscale(void *priv)
static SwsImg pass_output(const SwsPass *pass, const SwsImg *fallback)
static av_always_inline av_const int ff_fmt_vshift(enum AVPixelFormat fmt, int plane)
static int opts_equal(const SwsContext *c1, const SwsContext *c2)
static void run_rgb0(const SwsImg *out, const SwsImg *in, int y, int h, const SwsPass *pass)
#define av_assert1(cond)
assert() equivalent, that does not lie in speed critical code.
static void run_rgb2xyz(const SwsImg *out, const SwsImg *in, int y, int h, const SwsPass *pass)
int dst_h
Width and height of the destination frame.
static void run_copy(const SwsImg *out_base, const SwsImg *in_base, int y, int h, const SwsPass *pass)
static av_const SwsImg ff_sws_img_shift(const SwsImg *base, const int y)
void * av_calloc(size_t nmemb, size_t size)
static void get_chroma_pos(SwsGraph *graph, int *h_chr_pos, int *v_chr_pos, const SwsFormat *fmt)
int av_dynarray_add_nofree(void *tab_ptr, int *nb_ptr, void *elem)
Add an element to a dynamic array.
int ff_sws_compile_pass(SwsGraph *graph, SwsOpList *ops, int flags, SwsFormat dst, SwsPass *input, SwsPass **output)
Resolves an operation list to a graph pass.
double scaler_params[2]
Extra parameters for fine-tuning certain scalers.
the frame and frame reference mechanism is intended to as much as expensive copies of that data while still allowing the filters to produce correct results The data is stored in buffers represented by AVFrame structures Several references can point to the same frame buffer
@ AVCHROMA_LOC_CENTER
MPEG-1 4:2:0, JPEG 4:2:0, H.263 4:2:0.
bool ff_sws_color_map_noop(const SwsColorMap *map)
Returns true if the given color map is a semantic no-op - that is, the overall RGB end to end transfo...
static void setup_legacy_swscale(const SwsImg *out, const SwsImg *in, const SwsPass *pass)
int ff_swscale(SwsInternal *c, const uint8_t *const src[], const int srcStride[], int srcSliceY, int srcSliceH, uint8_t *const dst[], const int dstStride[], int dstSliceY, int dstSliceH)
A reference to a data buffer.
const int * sws_getCoefficients(int colorspace)
Return a pointer to yuv<->rgb coefficients for the given colorspace suitable for sws_setColorspaceDet...
Filter graph, which represents a 'baked' pixel format conversion.
int src_format
Source pixel format.
const VDPAUPixFmtMap * map
int dst_range
Destination is full range.
static int pass_alloc_output(SwsPass *pass)
static void run_legacy_unscaled(const SwsImg *out, const SwsImg *in_base, int y, int h, const SwsPass *pass)
sws_filter_run_t run
Filter main execution function.
void sws_free_context(SwsContext **ctx)
Free the context and everything associated with it, and write NULL to the provided pointer.
void ff_sws_op_list_print(void *log, int lev, const SwsOpList *ops)
Print out the contents of an operation list.
int linesize[AV_NUM_DATA_POINTERS]
For video, a positive or negative value, which is typically indicating the size in bytes of each pict...
void avpriv_slicethread_free(AVSliceThread **pctx)
Destroy slice threading context.
int src_h_chr_pos
Source horizontal chroma position.
static SwsInternal * sws_internal(const SwsContext *sws)
const SwsPass * input
Filter input.
Represents an allocated output buffer for a filter pass.
Helper struct for representing a list of operations.
static void run_lut3d(const SwsImg *out_base, const SwsImg *in_base, int y, int h, const SwsPass *pass)
int dst_v_chr_pos
Destination vertical chroma position.
Main external API structure.
static void sws_graph_worker(void *priv, int jobnr, int threadnr, int nb_jobs, int nb_threads)
void ff_sws_graph_update_metadata(SwsGraph *graph, const SwsColor *color)
Update dynamic per-frame HDR metadata without requiring a full reinit.
@ SWS_UNSTABLE
Allow using experimental new code paths.
uint8_t log2_chroma_h
Amount to shift the luma height right to find the chroma height.
static int buffer_get_sizes(SwsPassBuffer *buffer, size_t sizes[4])
const char * av_get_pix_fmt_name(enum AVPixelFormat pix_fmt)
Return the short name for a pixel format, NULL in case pix_fmt is unknown.
static av_always_inline int isALPHA(enum AVPixelFormat pix_fmt)