FFmpeg
Loading...
Searching...
No Matches
Data Structures | Macros | Enumerations | Functions | Variables
vf_colormatrix.c File Reference

ColorMatrix 2.0 is based on the original ColorMatrix filter by Wilbert Dijkhof. More...

#include <float.h>
#include "avfilter.h"
#include "filters.h"
#include "video.h"
#include "libavutil/opt.h"
#include "libavutil/pixdesc.h"

Go to the source code of this file.

Data Structures

struct  ColorMatrixContext
 
struct  ThreadData
 Used for passing data between threads. More...
 

Macros

#define NS(n)
 
#define CB(n)
 
#define OFFSET(x)
 
#define FLAGS   AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_FILTERING_PARAM
 
#define ma   m[0][0]
 
#define mb   m[0][1]
 
#define mc   m[0][2]
 
#define md   m[1][0]
 
#define me   m[1][1]
 
#define mf   m[1][2]
 
#define mg   m[2][0]
 
#define mh   m[2][1]
 
#define mi   m[2][2]
 
#define ima   im[0][0]
 
#define imb   im[0][1]
 
#define imc   im[0][2]
 
#define imd   im[1][0]
 
#define ime   im[1][1]
 
#define imf   im[1][2]
 
#define img   im[2][0]
 
#define imh   im[2][1]
 
#define imi   im[2][2]
 

Enumerations

enum  ColorMode {
  COLOR_MODE_NONE = -1 , COLOR_MODE_BT709 , COLOR_MODE_FCC , COLOR_MODE_BT601 ,
  COLOR_MODE_SMPTE240M , COLOR_MODE_BT2020 , COLOR_MODE_COUNT
}
 

Functions

 AVFILTER_DEFINE_CLASS (colormatrix)
 
static void inverse3x3 (double im[3][3], double m[3][3])
 
static void solve_coefficients (double cm[3][3], double rgb[3][3], double yuv[3][3])
 
static void calc_coefficients (AVFilterContext *ctx)
 
static av_cold int init (AVFilterContext *ctx)
 
static int process_slice_uyvy422 (AVFilterContext *ctx, void *arg, int jobnr, int nb_jobs)
 
static int process_slice_yuv444p (AVFilterContext *ctx, void *arg, int jobnr, int nb_jobs)
 
static int process_slice_yuv422p (AVFilterContext *ctx, void *arg, int jobnr, int nb_jobs)
 
static int process_slice_yuv420p (AVFilterContext *ctx, void *arg, int jobnr, int nb_jobs)
 
static int config_input (AVFilterLink *inlink)
 
static int filter_frame (AVFilterLink *link, AVFrame *in)
 

Variables

static const double yuv_coeff_luma [5][3]
 
static const AVOption colormatrix_options []
 
static const char *const color_modes [] = {"bt709", "fcc", "bt601", "smpte240m", "bt2020"}
 
static const AVFilterPad colormatrix_inputs []
 
const FFFilter ff_vf_colormatrix
 

Detailed Description

ColorMatrix 2.0 is based on the original ColorMatrix filter by Wilbert Dijkhof.

It adds the ability to convert between any of: Rec.709, FCC, Rec.601, and SMPTE 240M. It also makes pre and post clipping optional, adds an option to use scaled or non-scaled coefficients, and more...

Definition in file vf_colormatrix.c.

Macro Definition Documentation

◆ NS

#define NS ( n)
Value:
((n) < 0 ? (int)((n)*65536.0-0.5+DBL_EPSILON) : (int)((n)*65536.0+0.5))

Definition at line 38 of file vf_colormatrix.c.

Referenced by calc_coefficients().

◆ CB

#define CB ( n)
Value:
av_clip_uint8(n)
av_clip_uint8
#define av_clip_uint8
Definition common.h:106

Definition at line 39 of file vf_colormatrix.c.

Referenced by process_slice_uyvy422(), process_slice_yuv420p(), process_slice_yuv422p(), and process_slice_yuv444p().

◆ OFFSET

#define OFFSET ( x)
Value:
offsetof(ColorMatrixContext, x)

Definition at line 79 of file vf_colormatrix.c.

◆ FLAGS

#define FLAGS   AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_FILTERING_PARAM

Definition at line 80 of file vf_colormatrix.c.

◆ ma

#define ma   m[0][0]

Definition at line 98 of file vf_colormatrix.c.

Referenced by checkasm_var_add(), checkasm_var_sub(), fill_whitepoint_conv_table(), inverse3x3(), mode01(), mode21(), mode22(), and unwrap().

◆ mb

#define mb   m[0][1]

Definition at line 99 of file vf_colormatrix.c.

◆ mc

#define mc   m[0][2]

Definition at line 100 of file vf_colormatrix.c.

Referenced by create_vorbis_context(), decode_cu_r(), decode_move(), inter_pred(), inverse3x3(), ivi_decode_coded_blocks(), ivi_mc(), mc_bi_scaled(), mc_chroma_scaled(), mc_chroma_unscaled(), mc_luma_scaled(), mc_luma_unscaled(), mov_read_seek(), pred_gpm_blk(), put_main_header(), and qt_rtp_parse_packet().

◆ md

#define md   m[1][0]

Definition at line 101 of file vf_colormatrix.c.

Referenced by ac3_sum_square_butterfly_float_c(), ac3_sum_square_butterfly_int32_c(), apv_decode_metadata(), cbs_apv_free_metadata(), config_input(), filter_frame(), gnutls_x509_fingerprint(), init_pic_params(), inverse3x3(), main(), mbedtls_x509_fingerprint(), uninit(), vaapi_encode_av1_init_picture_params(), and x509_fingerprint().

◆ me

#define me   m[1][1]

Definition at line 102 of file vf_colormatrix.c.

Referenced by inverse3x3(), merge_context_after_me(), and read_ts().

◆ mf

#define mf   m[1][2]

Definition at line 103 of file vf_colormatrix.c.

Referenced by inverse3x3().

◆ mg

#define mg   m[2][0]

Definition at line 104 of file vf_colormatrix.c.

Referenced by find_mca_link_id(), inverse3x3(), lininterp(), mxf_add_metadata_set(), mxf_get_sorted_table_segments(), mxf_handle_missing_index_segment(), mxf_parse_structural_metadata(), mxf_read_close(), and mxf_resolve_strong_ref().

◆ mh

#define mh   m[2][1]

Definition at line 105 of file vf_colormatrix.c.

Referenced by av_file_map(), dwt_decode53(), dwt_decode97_float(), dwt_decode97_int(), dwt_encode53(), dwt_encode97_float(), dwt_encode97_int(), ff_mlp_read_major_sync(), inverse3x3(), mlp_parse(), read_major_sync(), and vulkan_encode_ffv1_init().

◆ mi

#define mi   m[2][2]

Definition at line 106 of file vf_colormatrix.c.

Referenced by affine_merge_candidate(), affine_merge_const1(), affine_merge_const2(), affine_merge_const3(), affine_merge_const4(), affine_merge_const5(), affine_merge_const6(), affine_merge_const_candidates(), affine_merge_zero_motion(), bcw_idx_decode(), cu_get_max_y(), derive_cb_prof_flag_lx(), derive_dmvr_bdof_flag(), estimate_affine_2d(), ff_vvc_affine_mvp(), ff_vvc_mvp(), ff_vvc_store_mv(), ff_vvc_store_sb_mvs(), ff_vvc_update_hmvp(), init_subblock_params(), inter_data(), interpolate_pchip(), inverse3x3(), merge_data_ciip(), merge_data_ibc(), minimize_error(), mode01(), mode21(), mode22(), mvds_decode(), mvf_to_mi(), mvp_add_difference(), mvp_data(), mvp_data_ibc(), optimize_model(), pred_affine_blk(), pred_regular_blk(), sb_mv_merge_mode(), sb_temporal_merge_candidate(), store_cp_mv(), and unwrap().

◆ ima

#define ima   im[0][0]

Definition at line 108 of file vf_colormatrix.c.

Referenced by adpcm_compress_trellis(), and inverse3x3().

◆ imb

#define imb   im[0][1]

Definition at line 109 of file vf_colormatrix.c.

Referenced by inverse3x3().

◆ imc

#define imc   im[0][2]

Definition at line 110 of file vf_colormatrix.c.

Referenced by inverse3x3().

◆ imd

#define imd   im[1][0]

Definition at line 111 of file vf_colormatrix.c.

Referenced by inverse3x3().

◆ ime

#define ime   im[1][1]

Definition at line 112 of file vf_colormatrix.c.

Referenced by inverse3x3().

◆ imf

#define imf   im[1][2]

Definition at line 113 of file vf_colormatrix.c.

Referenced by inverse3x3(), and min_cb_tl_init().

◆ img

#define img   im[2][0]

Definition at line 114 of file vf_colormatrix.c.

Referenced by add_hdr_plus(), add_hdr_smpte2094_app5(), aom_decode(), aom_encode(), aomfmt_to_pixfmt(), apply_color_indexing_transform(), apply_color_transform(), apply_predictor_transform(), apply_subtract_green_transform(), codecctl_imgp(), color_cache_put(), decode_entropy_coded_image(), decode_entropy_image(), decode_metadata(), ff_aom_image_copy_16_to_8(), fill_frame_from_iplimage(), fill_iplimage_from_frame(), get_huffman_group(), image_ctx_free(), inverse3x3(), mj2_create_image(), parse_transform_color_indexing(), set_pix_fmt(), set_pix_fmt(), vpx_decode(), write_header(), write_muxed_file(), write_packet(), write_packet_pipe(), write_picture(), and xcbgrab_frame().

◆ imh

#define imh   im[2][1]

Definition at line 115 of file vf_colormatrix.c.

Referenced by inverse3x3().

◆ imi

#define imi   im[2][2]

Definition at line 116 of file vf_colormatrix.c.

Referenced by inverse3x3().

Enumeration Type Documentation

◆ ColorMode

enum ColorMode
Enumerator
COLOR_MODE_NONE 
COLOR_MODE_BT709 
COLOR_MODE_FCC 
COLOR_MODE_BT601 
COLOR_MODE_SMPTE240M 
COLOR_MODE_BT2020 
COLOR_MODE_COUNT 

Definition at line 49 of file vf_colormatrix.c.

Function Documentation

◆ AVFILTER_DEFINE_CLASS()

AVFILTER_DEFINE_CLASS ( colormatrix )

◆ inverse3x3()

static void inverse3x3 ( double im[3][3],
double m[3][3] )
static

Definition at line 118 of file vf_colormatrix.c.

Referenced by calc_coefficients().

◆ solve_coefficients()

static void solve_coefficients ( double cm[3][3],
double rgb[3][3],
double yuv[3][3] )
static

Definition at line 133 of file vf_colormatrix.c.

Referenced by calc_coefficients().

◆ calc_coefficients()

static void calc_coefficients ( AVFilterContext * ctx)
static

Definition at line 141 of file vf_colormatrix.c.

Referenced by init().

◆ init()

static av_cold int init ( AVFilterContext * ctx)
static

Definition at line 184 of file vf_colormatrix.c.

◆ process_slice_uyvy422()

static int process_slice_uyvy422 ( AVFilterContext * ctx,
void * arg,
int jobnr,
int nb_jobs )
static

Definition at line 203 of file vf_colormatrix.c.

Referenced by filter_frame().

◆ process_slice_yuv444p()

static int process_slice_yuv444p ( AVFilterContext * ctx,
void * arg,
int jobnr,
int nb_jobs )
static

Definition at line 241 of file vf_colormatrix.c.

Referenced by filter_frame().

◆ process_slice_yuv422p()

static int process_slice_yuv422p ( AVFilterContext * ctx,
void * arg,
int jobnr,
int nb_jobs )
static

Definition at line 288 of file vf_colormatrix.c.

Referenced by filter_frame().

◆ process_slice_yuv420p()

static int process_slice_yuv420p ( AVFilterContext * ctx,
void * arg,
int jobnr,
int nb_jobs )
static

Definition at line 336 of file vf_colormatrix.c.

Referenced by filter_frame().

◆ config_input()

static int config_input ( AVFilterLink * inlink)
static

Definition at line 390 of file vf_colormatrix.c.

◆ filter_frame()

static int filter_frame ( AVFilterLink * link,
AVFrame * in )
static

Definition at line 405 of file vf_colormatrix.c.

Variable Documentation

◆ yuv_coeff_luma

const double yuv_coeff_luma[5][3]
static
Initial value:
= {
{ +0.7152, +0.0722, +0.2126 },
{ +0.5900, +0.1100, +0.3000 },
{ +0.5870, +0.1140, +0.2990 },
{ +0.7010, +0.0870, +0.2120 },
{ +0.6780, +0.0593, +0.2627 },
}

Definition at line 41 of file vf_colormatrix.c.

Referenced by calc_coefficients().

◆ colormatrix_options

const AVOption colormatrix_options[]
static
Initial value:
= {
{ "src", "set source color matrix", OFFSET(source), AV_OPT_TYPE_INT, {.i64=COLOR_MODE_NONE}, COLOR_MODE_NONE, COLOR_MODE_COUNT-1, .flags=FLAGS, .unit="color_mode" },
{ "dst", "set destination color matrix", OFFSET(dest), AV_OPT_TYPE_INT, {.i64=COLOR_MODE_NONE}, COLOR_MODE_NONE, COLOR_MODE_COUNT-1, .flags=FLAGS, .unit="color_mode" },
{ "bt709", "set BT.709 colorspace", 0, AV_OPT_TYPE_CONST, {.i64=COLOR_MODE_BT709}, .flags=FLAGS, .unit="color_mode" },
{ "fcc", "set FCC colorspace ", 0, AV_OPT_TYPE_CONST, {.i64=COLOR_MODE_FCC}, .flags=FLAGS, .unit="color_mode" },
{ "bt601", "set BT.601 colorspace", 0, AV_OPT_TYPE_CONST, {.i64=COLOR_MODE_BT601}, .flags=FLAGS, .unit="color_mode" },
{ "bt470", "set BT.470 colorspace", 0, AV_OPT_TYPE_CONST, {.i64=COLOR_MODE_BT601}, .flags=FLAGS, .unit="color_mode" },
{ "bt470bg", "set BT.470 colorspace", 0, AV_OPT_TYPE_CONST, {.i64=COLOR_MODE_BT601}, .flags=FLAGS, .unit="color_mode" },
{ "smpte170m", "set SMTPE-170M colorspace", 0, AV_OPT_TYPE_CONST, {.i64=COLOR_MODE_BT601}, .flags=FLAGS, .unit="color_mode" },
{ "smpte240m", "set SMPTE-240M colorspace", 0, AV_OPT_TYPE_CONST, {.i64=COLOR_MODE_SMPTE240M}, .flags=FLAGS, .unit="color_mode" },
{ "bt2020", "set BT.2020 colorspace", 0, AV_OPT_TYPE_CONST, {.i64=COLOR_MODE_BT2020}, .flags=FLAGS, .unit="color_mode" },
{ NULL }
}
FLAGS
#define FLAGS
Definition cmdutils.c:598
NULL
#define NULL
Definition coverity.c:32
OFFSET
#define OFFSET(x)
Definition ffmpeg_opt.c:1551
AV_OPT_TYPE_CONST
@ AV_OPT_TYPE_CONST
Special option type for declaring named constants.
Definition opt.h:298
AV_OPT_TYPE_INT
@ AV_OPT_TYPE_INT
Underlying C type is int.
Definition opt.h:258
COLOR_MODE_BT601
@ COLOR_MODE_BT601
Definition vf_colormatrix.c:53
COLOR_MODE_FCC
@ COLOR_MODE_FCC
Definition vf_colormatrix.c:52
COLOR_MODE_BT709
@ COLOR_MODE_BT709
Definition vf_colormatrix.c:51
COLOR_MODE_SMPTE240M
@ COLOR_MODE_SMPTE240M
Definition vf_colormatrix.c:54
COLOR_MODE_COUNT
@ COLOR_MODE_COUNT
Definition vf_colormatrix.c:56
COLOR_MODE_NONE
@ COLOR_MODE_NONE
Definition vf_colormatrix.c:50
COLOR_MODE_BT2020
@ COLOR_MODE_BT2020
Definition vf_colormatrix.c:55

Definition at line 82 of file vf_colormatrix.c.

◆ color_modes

const char* const color_modes[] = {"bt709", "fcc", "bt601", "smpte240m", "bt2020"}
static

Definition at line 182 of file vf_colormatrix.c.

Referenced by config_input().

◆ colormatrix_inputs

const AVFilterPad colormatrix_inputs[]
static
Initial value:
= {
{
.name = "default",
.type = AVMEDIA_TYPE_VIDEO,
.config_props = config_input,
.filter_frame = filter_frame,
},
}
config_input
static int config_input(AVFilterLink *inlink)
Definition af_acontrast.c:121
filter_frame
static int filter_frame(DBEDecodeContext *s, AVFrame *frame)
Definition dolby_e.c:1067
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition avutil.h:200

Definition at line 475 of file vf_colormatrix.c.

◆ ff_vf_colormatrix

const FFFilter ff_vf_colormatrix
Initial value:
= {
.p.name = "colormatrix",
.p.description = NULL_IF_CONFIG_SMALL("Convert color matrix."),
.p.priv_class = &colormatrix_class,
.p.flags = AVFILTER_FLAG_SUPPORT_TIMELINE_GENERIC | AVFILTER_FLAG_SLICE_THREADS,
.priv_size = sizeof(ColorMatrixContext),
.init = init,
FILTER_INPUTS(colormatrix_inputs),
FILTER_OUTPUTS(ff_video_default_filterpad),
FILTER_PIXFMTS(AV_PIX_FMT_YUV444P,
AV_PIX_FMT_YUV422P,
AV_PIX_FMT_YUV420P,
AV_PIX_FMT_UYVY422),
}
init
int(* init)(AVBSFContext *ctx)
Definition dts2pts.c:608
AVFILTER_FLAG_SUPPORT_TIMELINE_GENERIC
#define AVFILTER_FLAG_SUPPORT_TIMELINE_GENERIC
Some filters support a generic "enable" expression option that can be used to enable or disable a fil...
Definition avfilter.h:196
AVFILTER_FLAG_SLICE_THREADS
#define AVFILTER_FLAG_SLICE_THREADS
The filter supports multithreading by splitting frames into multiple parts and processing them concur...
Definition avfilter.h:166
FILTER_INPUTS
#define FILTER_INPUTS(array)
Definition filters.h:264
FILTER_OUTPUTS
#define FILTER_OUTPUTS(array)
Definition filters.h:265
FILTER_PIXFMTS
#define FILTER_PIXFMTS(...)
Definition filters.h:250
NULL_IF_CONFIG_SMALL
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
Definition internal.h:88
AV_PIX_FMT_YUV420P
@ AV_PIX_FMT_YUV420P
planar YUV 4:2:0, 12bpp, (1 Cr & Cb sample per 2x2 Y samples)
Definition pixfmt.h:73
AV_PIX_FMT_YUV422P
@ AV_PIX_FMT_YUV422P
planar YUV 4:2:2, 16bpp, (1 Cr & Cb sample per 2x1 Y samples)
Definition pixfmt.h:77
AV_PIX_FMT_UYVY422
@ AV_PIX_FMT_UYVY422
packed YUV 4:2:2, 16bpp, Cb Y0 Cr Y1
Definition pixfmt.h:88
AV_PIX_FMT_YUV444P
@ AV_PIX_FMT_YUV444P
planar YUV 4:4:4, 24bpp, (1 Cr & Cb sample per 1x1 Y samples)
Definition pixfmt.h:78
colormatrix_inputs
static const AVFilterPad colormatrix_inputs[]
Definition vf_colormatrix.c:475
ff_video_default_filterpad
const AVFilterPad ff_video_default_filterpad[1]
An AVFilterPad array whose only entry has name "default" and is of type AVMEDIA_TYPE_VIDEO.
Definition video.c:37

Definition at line 484 of file vf_colormatrix.c.

Generated on Sun Aug 16 2026 20:21:11 for FFmpeg by doxygen 1.13.2