FFmpeg
Data Structures | Macros | Enumerations | Functions | Variables
vf_colorspace.c File Reference
#include "libavutil/avassert.h"
#include "libavutil/mem_internal.h"
#include "libavutil/opt.h"
#include "libavutil/pixdesc.h"
#include "libavutil/pixfmt.h"
#include "avfilter.h"
#include "colorspacedsp.h"
#include "formats.h"
#include "internal.h"
#include "video.h"
#include "colorspace.h"

Go to the source code of this file.

Data Structures

struct  ColorPrimaries
 
struct  TransferCharacteristics
 
struct  ColorSpaceContext
 
struct  ThreadData
 Used for passing data between threads. More...
 

Macros

#define supported_depth(d)   ((d) == 8 || (d) == 10 || (d) == 12)
 
#define supported_subsampling(lcw, lch)   (((lcw) == 0 && (lch) == 0) || ((lcw) == 1 && (lch) == 0) || ((lcw) == 1 && (lch) == 1))
 
#define supported_format(d)
 
#define OFFSET(x)   offsetof(ColorSpaceContext, x)
 
#define FLAGS   AV_OPT_FLAG_FILTERING_PARAM | AV_OPT_FLAG_VIDEO_PARAM
 
#define ENUM(x, y, z)   { x, "", 0, AV_OPT_TYPE_CONST, { .i64 = y }, INT_MIN, INT_MAX, FLAGS, z }
 

Enumerations

enum  DitherMode { DITHER_NONE, DITHER_FSB, DITHER_NB }
 
enum  Colorspace {
  CS_UNSPECIFIED, CS_BT470M, CS_BT470BG, CS_BT601_6_525,
  CS_BT601_6_625, CS_BT709, CS_SMPTE170M, CS_SMPTE240M,
  CS_BT2020, CS_NB
}
 
enum  Whitepoint {
  WP_D65, WP_C, WP_DCI, WP_E,
  WP_NB
}
 
enum  WhitepointAdaptation {
  WP_ADAPT_BRADFORD, WP_ADAPT_VON_KRIES, NB_WP_ADAPT_NON_IDENTITY, WP_ADAPT_IDENTITY = NB_WP_ADAPT_NON_IDENTITY,
  NB_WP_ADAPT
}
 

Functions

static const struct TransferCharacteristicsget_transfer_characteristics (enum AVColorTransferCharacteristic trc)
 
static const struct ColorPrimariesget_color_primaries (enum AVColorPrimaries prm)
 
static int fill_gamma_table (ColorSpaceContext *s)
 
static void fill_whitepoint_conv_table (double out[3][3], enum WhitepointAdaptation wp_adapt, enum Whitepoint src, enum Whitepoint dst)
 
static void apply_lut (int16_t *buf[3], ptrdiff_t stride, int w, int h, const int16_t *lut)
 
static int convert (AVFilterContext *ctx, void *data, int job_nr, int n_jobs)
 
static int get_range_off (AVFilterContext *ctx, int *off, int *y_rng, int *uv_rng, enum AVColorRange rng, int depth)
 
static int create_filtergraph (AVFilterContext *ctx, const AVFrame *in, const AVFrame *out)
 
static av_cold int init (AVFilterContext *ctx)
 
static void uninit (AVFilterContext *ctx)
 
static int filter_frame (AVFilterLink *link, AVFrame *in)
 
static int query_formats (AVFilterContext *ctx)
 
static int config_props (AVFilterLink *outlink)
 
 AVFILTER_DEFINE_CLASS (colorspace)
 

Variables

static enum AVColorTransferCharacteristic default_trc [CS_NB+1]
 
static enum AVColorPrimaries default_prm [CS_NB+1]
 
static enum AVColorSpace default_csp [CS_NB+1]
 
static const struct TransferCharacteristics transfer_characteristics [AVCOL_TRC_NB]
 
static const struct WhitepointCoefficients whitepoint_coefficients [WP_NB]
 
static const struct ColorPrimaries color_primaries [AVCOL_PRI_NB]
 
static const AVOption colorspace_options []
 
static const AVFilterPad inputs []
 
static const AVFilterPad outputs []
 
const AVFilter ff_vf_colorspace
 

Macro Definition Documentation

◆ supported_depth

#define supported_depth (   d)    ((d) == 8 || (d) == 10 || (d) == 12)

◆ supported_subsampling

#define supported_subsampling (   lcw,
  lch 
)    (((lcw) == 0 && (lch) == 0) || ((lcw) == 1 && (lch) == 0) || ((lcw) == 1 && (lch) == 1))

◆ supported_format

#define supported_format (   d)
Value:
((d) != NULL && (d)->nb_components == 3 && \
supported_depth((d)->comp[0].depth) && \
supported_subsampling((d)->log2_chroma_w, (d)->log2_chroma_h))

◆ OFFSET

#define OFFSET (   x)    offsetof(ColorSpaceContext, x)

Definition at line 931 of file vf_colorspace.c.

◆ FLAGS

Definition at line 932 of file vf_colorspace.c.

◆ ENUM

#define ENUM (   x,
  y,
 
)    { x, "", 0, AV_OPT_TYPE_CONST, { .i64 = y }, INT_MIN, INT_MAX, FLAGS, z }

Definition at line 933 of file vf_colorspace.c.

Enumeration Type Documentation

◆ DitherMode

enum DitherMode
Enumerator
DITHER_NONE 
DITHER_FSB 
DITHER_NB 

Definition at line 39 of file vf_colorspace.c.

◆ Colorspace

enum Colorspace
Enumerator
CS_UNSPECIFIED 
CS_BT470M 
CS_BT470BG 
CS_BT601_6_525 
CS_BT601_6_625 
CS_BT709 
CS_SMPTE170M 
CS_SMPTE240M 
CS_BT2020 
CS_NB 

Definition at line 45 of file vf_colorspace.c.

◆ Whitepoint

enum Whitepoint
Enumerator
WP_D65 
WP_C 
WP_DCI 
WP_E 
WP_NB 

Definition at line 58 of file vf_colorspace.c.

◆ WhitepointAdaptation

Enumerator
WP_ADAPT_BRADFORD 
WP_ADAPT_VON_KRIES 
NB_WP_ADAPT_NON_IDENTITY 
WP_ADAPT_IDENTITY 
NB_WP_ADAPT 

Definition at line 66 of file vf_colorspace.c.

Function Documentation

◆ get_transfer_characteristics()

static const struct TransferCharacteristics* get_transfer_characteristics ( enum AVColorTransferCharacteristic  trc)
static

Definition at line 191 of file vf_colorspace.c.

Referenced by create_filtergraph().

◆ get_color_primaries()

static const struct ColorPrimaries* get_color_primaries ( enum AVColorPrimaries  prm)
static

Definition at line 225 of file vf_colorspace.c.

Referenced by create_filtergraph().

◆ fill_gamma_table()

static int fill_gamma_table ( ColorSpaceContext s)
static

Definition at line 238 of file vf_colorspace.c.

Referenced by create_filtergraph().

◆ fill_whitepoint_conv_table()

static void fill_whitepoint_conv_table ( double  out[3][3],
enum WhitepointAdaptation  wp_adapt,
enum Whitepoint  src,
enum Whitepoint  dst 
)
static

Definition at line 282 of file vf_colorspace.c.

Referenced by create_filtergraph().

◆ apply_lut()

static void apply_lut ( int16_t *  buf[3],
ptrdiff_t  stride,
int  w,
int  h,
const int16_t *  lut 
)
static

Definition at line 319 of file vf_colorspace.c.

Referenced by convert().

◆ convert()

static int convert ( AVFilterContext ctx,
void *  data,
int  job_nr,
int  n_jobs 
)
static

Definition at line 342 of file vf_colorspace.c.

◆ get_range_off()

static int get_range_off ( AVFilterContext ctx,
int off,
int y_rng,
int uv_rng,
enum AVColorRange  rng,
int  depth 
)
static

Definition at line 412 of file vf_colorspace.c.

Referenced by create_filtergraph().

◆ create_filtergraph()

static int create_filtergraph ( AVFilterContext ctx,
const AVFrame in,
const AVFrame out 
)
static

Definition at line 442 of file vf_colorspace.c.

Referenced by filter_frame().

◆ init()

static av_cold int init ( AVFilterContext ctx)
static

Definition at line 737 of file vf_colorspace.c.

◆ uninit()

static void uninit ( AVFilterContext ctx)
static

Definition at line 746 of file vf_colorspace.c.

Referenced by filter_frame().

◆ filter_frame()

static int filter_frame ( AVFilterLink link,
AVFrame in 
)
static

Definition at line 764 of file vf_colorspace.c.

◆ query_formats()

static int query_formats ( AVFilterContext ctx)
static

Definition at line 884 of file vf_colorspace.c.

◆ config_props()

static int config_props ( AVFilterLink outlink)
static

Definition at line 912 of file vf_colorspace.c.

◆ AVFILTER_DEFINE_CLASS()

AVFILTER_DEFINE_CLASS ( colorspace  )

Variable Documentation

◆ default_trc

enum AVColorTransferCharacteristic default_trc[CS_NB+1]
static

◆ default_prm

enum AVColorPrimaries default_prm[CS_NB+1]
static

◆ default_csp

enum AVColorSpace default_csp[CS_NB+1]
static

◆ transfer_characteristics

const struct TransferCharacteristics transfer_characteristics[AVCOL_TRC_NB]
static
Initial value:
= {
[AVCOL_TRC_BT709] = { 1.099, 0.018, 0.45, 4.5 },
[AVCOL_TRC_GAMMA22] = { 1.0, 0.0, 1.0 / 2.2, 0.0 },
[AVCOL_TRC_GAMMA28] = { 1.0, 0.0, 1.0 / 2.8, 0.0 },
[AVCOL_TRC_SMPTE170M] = { 1.099, 0.018, 0.45, 4.5 },
[AVCOL_TRC_SMPTE240M] = { 1.1115, 0.0228, 0.45, 4.0 },
[AVCOL_TRC_LINEAR] = { 1.0, 0.0, 1.0, 0.0 },
[AVCOL_TRC_IEC61966_2_1] = { 1.055, 0.0031308, 1.0 / 2.4, 12.92 },
[AVCOL_TRC_IEC61966_2_4] = { 1.099, 0.018, 0.45, 4.5 },
[AVCOL_TRC_BT2020_10] = { 1.099, 0.018, 0.45, 4.5 },
[AVCOL_TRC_BT2020_12] = { 1.0993, 0.0181, 0.45, 4.5 },
}

Definition at line 177 of file vf_colorspace.c.

Referenced by color_config(), get_transfer_characteristics(), h264_metadata_update_sps(), mpeg2_metadata_init(), sequence_display_extension(), vui_parameters(), and vui_parameters_default().

◆ whitepoint_coefficients

const struct WhitepointCoefficients whitepoint_coefficients[WP_NB]
static
Initial value:
= {
[WP_D65] = { 0.3127, 0.3290 },
[WP_C] = { 0.3100, 0.3160 },
[WP_DCI] = { 0.3140, 0.3510 },
[WP_E] = { 1/3.0f, 1/3.0f },
}

Definition at line 204 of file vf_colorspace.c.

Referenced by create_filtergraph(), and fill_whitepoint_conv_table().

◆ color_primaries

const struct ColorPrimaries color_primaries[AVCOL_PRI_NB]
static
Initial value:
= {
[AVCOL_PRI_BT709] = { WP_D65, { 0.640, 0.330, 0.300, 0.600, 0.150, 0.060 } },
[AVCOL_PRI_BT470M] = { WP_C, { 0.670, 0.330, 0.210, 0.710, 0.140, 0.080 } },
[AVCOL_PRI_BT470BG] = { WP_D65, { 0.640, 0.330, 0.290, 0.600, 0.150, 0.060 } },
[AVCOL_PRI_SMPTE170M] = { WP_D65, { 0.630, 0.340, 0.310, 0.595, 0.155, 0.070 } },
[AVCOL_PRI_SMPTE240M] = { WP_D65, { 0.630, 0.340, 0.310, 0.595, 0.155, 0.070 } },
[AVCOL_PRI_SMPTE428] = { WP_E, { 0.735, 0.265, 0.274, 0.718, 0.167, 0.009 } },
[AVCOL_PRI_SMPTE431] = { WP_DCI, { 0.680, 0.320, 0.265, 0.690, 0.150, 0.060 } },
[AVCOL_PRI_SMPTE432] = { WP_D65, { 0.680, 0.320, 0.265, 0.690, 0.150, 0.060 } },
[AVCOL_PRI_FILM] = { WP_C, { 0.681, 0.319, 0.243, 0.692, 0.145, 0.049 } },
[AVCOL_PRI_BT2020] = { WP_D65, { 0.708, 0.292, 0.170, 0.797, 0.131, 0.046 } },
[AVCOL_PRI_JEDEC_P22] = { WP_D65, { 0.630, 0.340, 0.295, 0.605, 0.155, 0.077 } },
}

Definition at line 211 of file vf_colorspace.c.

Referenced by color_config(), convert_primaries(), get_color_primaries(), mov_read_colr(), mov_read_vpcc(), print_primaries(), scale_vaapi_init(), and tonemap_vaapi_init().

◆ colorspace_options

const AVOption colorspace_options[]
static

Definition at line 935 of file vf_colorspace.c.

◆ inputs

const AVFilterPad inputs[]
static
Initial value:
= {
{
.name = "default",
.filter_frame = filter_frame,
},
{ NULL }
}

Definition at line 1054 of file vf_colorspace.c.

◆ outputs

const AVFilterPad outputs[]
static
Initial value:
= {
{
.name = "default",
.config_props = config_props,
},
{ NULL }
}

Definition at line 1063 of file vf_colorspace.c.

◆ ff_vf_colorspace

const AVFilter ff_vf_colorspace
Initial value:
= {
.name = "colorspace",
.description = NULL_IF_CONFIG_SMALL("Convert between colorspaces."),
.init = init,
.uninit = uninit,
.query_formats = query_formats,
.priv_size = sizeof(ColorSpaceContext),
.priv_class = &colorspace_class,
}

Definition at line 1072 of file vf_colorspace.c.

comp
static void comp(unsigned char *dst, ptrdiff_t dst_stride, unsigned char *src, ptrdiff_t src_stride, int add)
Definition: eamad.c:85
AVCOL_TRC_LINEAR
@ AVCOL_TRC_LINEAR
"Linear transfer characteristics"
Definition: pixfmt.h:482
CS_SMPTE240M
@ CS_SMPTE240M
Definition: vf_colorspace.c:53
AVCOL_TRC_UNSPECIFIED
@ AVCOL_TRC_UNSPECIFIED
Definition: pixfmt.h:476
AVCOL_PRI_JEDEC_P22
@ AVCOL_PRI_JEDEC_P22
Definition: pixfmt.h:465
AVCOL_TRC_BT2020_12
@ AVCOL_TRC_BT2020_12
ITU-R BT2020 for 12-bit system.
Definition: pixfmt.h:489
CS_BT709
@ CS_BT709
Definition: vf_colorspace.c:51
AVCOL_SPC_BT470BG
@ AVCOL_SPC_BT470BG
also ITU-R BT601-6 625 / ITU-R BT1358 625 / ITU-R BT1700 625 PAL & SECAM / IEC 61966-2-4 xvYCC601
Definition: pixfmt.h:508
AVCOL_TRC_IEC61966_2_1
@ AVCOL_TRC_IEC61966_2_1
IEC 61966-2-1 (sRGB or sYCC)
Definition: pixfmt.h:487
WP_D65
@ WP_D65
Definition: vf_colorspace.c:59
WP_DCI
@ WP_DCI
Definition: vf_colorspace.c:61
AVCOL_TRC_GAMMA28
@ AVCOL_TRC_GAMMA28
also ITU-R BT470BG
Definition: pixfmt.h:479
ColorSpaceContext
Definition: vf_colorspace.c:122
CS_BT2020
@ CS_BT2020
Definition: vf_colorspace.c:54
CS_BT601_6_525
@ CS_BT601_6_525
Definition: vf_colorspace.c:49
AVCOL_TRC_GAMMA22
@ AVCOL_TRC_GAMMA22
also ITU-R BT470M / ITU-R BT1700 625 PAL & SECAM
Definition: pixfmt.h:478
CS_BT470BG
@ CS_BT470BG
Definition: vf_colorspace.c:48
CS_UNSPECIFIED
@ CS_UNSPECIFIED
Definition: vf_colorspace.c:46
AVCOL_SPC_SMPTE170M
@ AVCOL_SPC_SMPTE170M
also ITU-R BT601-6 525 / ITU-R BT1358 525 / ITU-R BT1700 NTSC / functionally identical to above
Definition: pixfmt.h:509
filter_frame
static int filter_frame(AVFilterLink *link, AVFrame *in)
Definition: vf_colorspace.c:764
AVCOL_PRI_SMPTE428
@ AVCOL_PRI_SMPTE428
SMPTE ST 428-1 (CIE 1931 XYZ)
Definition: pixfmt.h:460
AVCOL_PRI_SMPTE240M
@ AVCOL_PRI_SMPTE240M
identical to above, also called "SMPTE C" even though it uses D65
Definition: pixfmt.h:457
AVCOL_PRI_UNSPECIFIED
@ AVCOL_PRI_UNSPECIFIED
Definition: pixfmt.h:451
AVCOL_PRI_BT470BG
@ AVCOL_PRI_BT470BG
also ITU-R BT601-6 625 / ITU-R BT1358 625 / ITU-R BT1700 625 PAL & SECAM
Definition: pixfmt.h:455
AVCOL_PRI_SMPTE170M
@ AVCOL_PRI_SMPTE170M
also ITU-R BT601-6 525 / ITU-R BT1358 525 / ITU-R BT1700 NTSC
Definition: pixfmt.h:456
init
static av_cold int init(AVFilterContext *ctx)
Definition: vf_colorspace.c:737
config_props
static int config_props(AVFilterLink *outlink)
Definition: vf_colorspace.c:912
CS_NB
@ CS_NB
Definition: vf_colorspace.c:55
NULL
#define NULL
Definition: coverity.c:32
CS_SMPTE170M
@ CS_SMPTE170M
Definition: vf_colorspace.c:52
AVCOL_TRC_IEC61966_2_4
@ AVCOL_TRC_IEC61966_2_4
IEC 61966-2-4.
Definition: pixfmt.h:485
AVCOL_PRI_BT709
@ AVCOL_PRI_BT709
also ITU-R BT1361 / IEC 61966-2-4 / SMPTE RP 177 Annex B
Definition: pixfmt.h:450
AVCOL_TRC_BT2020_10
@ AVCOL_TRC_BT2020_10
ITU-R BT2020 for 10-bit system.
Definition: pixfmt.h:488
AVCOL_PRI_BT2020
@ AVCOL_PRI_BT2020
ITU-R BT2020.
Definition: pixfmt.h:459
uninit
static void uninit(AVFilterContext *ctx)
Definition: vf_colorspace.c:746
AVCOL_PRI_SMPTE431
@ AVCOL_PRI_SMPTE431
SMPTE ST 431-2 (2011) / DCI P3.
Definition: pixfmt.h:462
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:117
AVCOL_TRC_SMPTE240M
@ AVCOL_TRC_SMPTE240M
Definition: pixfmt.h:481
AVCOL_PRI_FILM
@ AVCOL_PRI_FILM
colour filters using Illuminant C
Definition: pixfmt.h:458
AV_PIX_FMT_FLAG_RGB
#define AV_PIX_FMT_FLAG_RGB
The pixel format contains RGB-like data (as opposed to YUV/grayscale).
Definition: pixdesc.h:137
WP_E
@ WP_E
Definition: vf_colorspace.c:62
AVCOL_TRC_BT709
@ AVCOL_TRC_BT709
also ITU-R BT1361
Definition: pixfmt.h:475
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:126
AVCOL_SPC_SMPTE240M
@ AVCOL_SPC_SMPTE240M
derived from 170M primaries and D65 white point, 170M is derived from BT470 System M's primaries
Definition: pixfmt.h:510
query_formats
static int query_formats(AVFilterContext *ctx)
Definition: vf_colorspace.c:884
AVCOL_SPC_BT2020_NCL
@ AVCOL_SPC_BT2020_NCL
ITU-R BT2020 non-constant luminance system.
Definition: pixfmt.h:513
CS_BT601_6_625
@ CS_BT601_6_625
Definition: vf_colorspace.c:50
AVCOL_SPC_UNSPECIFIED
@ AVCOL_SPC_UNSPECIFIED
Definition: pixfmt.h:505
AVCOL_PRI_BT470M
@ AVCOL_PRI_BT470M
also FCC Title 47 Code of Federal Regulations 73.682 (a)(20)
Definition: pixfmt.h:453
outputs
static const AVFilterPad outputs[]
Definition: vf_colorspace.c:1063
CS_BT470M
@ CS_BT470M
Definition: vf_colorspace.c:47
WP_C
@ WP_C
Definition: vf_colorspace.c:60
AVCOL_TRC_SMPTE170M
@ AVCOL_TRC_SMPTE170M
also ITU-R BT601-6 525 or 625 / ITU-R BT1358 525 or 625 / ITU-R BT1700 NTSC
Definition: pixfmt.h:480
inputs
static const AVFilterPad inputs[]
Definition: vf_colorspace.c:1054
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:117
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
AVCOL_PRI_SMPTE432
@ AVCOL_PRI_SMPTE432
SMPTE ST 432-1 (2010) / P3 D65 / Display P3.
Definition: pixfmt.h:463
d
d
Definition: ffmpeg_filter.c:156
flags
#define flags(name, subs,...)
Definition: cbs_av1.c:561
AVCOL_SPC_BT709
@ AVCOL_SPC_BT709
also ITU-R BT1361 / IEC 61966-2-4 xvYCC709 / derived in SMPTE RP 177 Annex B
Definition: pixfmt.h:504