fmtconv — format conversion tools for Vapoursynth and Avisynth+

Abstract

Table of contents

1. Introduction
2. Usage
   1. Loading
   2. Examples for Vapoursynth
   3. Examples for Avisynth+
   4. Compiling from the source code
3. Filter description
   1. bitdepth
   2. convert
   3. matrix
   4. matrix2020cl
   5. primaries
   6. resample
   7. transfer
   8. stack16tonative, nativetostack16
4. Troubleshooting
5. Changelog

I) Introduction

Fmtconv is a format-conversion plug-in for the Vapoursynth and Avisynth+ video processing engines. It does:

• Resizing.
• Bitdepth conversion with dithering.
• Colorspace conversion (matrix, transfer characteristics and chromatic adaptation).

It supports:

• Pixel data types: 8-–12-, 14- and 16-bit integer, 32-bit float.
• Colorspaces: RGB, Y, YUV, YCoCg, YDzDx and ICtCp in 4:4:4, 4:2:2, 4:2:0 and 4:1:1 chroma subsampling factors.
• Progressive and interlaced content.

Fmtconv is focussed primarily on quality and exactness rather than execution speed. This does not mean it is slow or unoptimized, but fmtconv is clearly not on par with the fastest equivalent 8-bit filters.

II) Usage

Loading fmtconv

Using the Python 3.8 interface (or a higher version, it depends on your Vapoursynth version):

import vapoursynth as vs
core = vs.core
core.std.LoadPlugin (path=r'C:\path\fmtconv.dll')

Of course you can avoid the LoadPlugin command by copying the plug-in file to the autoloading directory. Check the Vapoursynth manual for more information.

Examples for Vapoursynth

A basic example

Requires FFmpegSource2:

# Load Vapoursynth
import vapoursynth as vs
core = vs.core

# Load the plug-ins
core.std.LoadPlugin (path=r'C:\path\fmtconv.dll')
core.std.LoadPlugin (path=r'C:\path\ffms2.dll')

# Load the video clip into c using FFmpegSource
c = core.ffms2.Source (source=r'C:\path\video.mkv')

# Change the resolution. The output clip is now in 16 bits.
c = c.fmtc.resample (w=1280, h=720)

# Dither the result, back to 8 bits
c = c.fmtc.bitdepth (bits=8)

# Send the processed clip to the calling process
c.set_output ()

Resizing and chroma subsampling conversions

Simple resize with 16- or 32-bit output:

c = c.fmtc.resample (w=1280, h=720)

Bobbing an interlaced stream (here, Top Field First):

c = c.std.SeparateFields (tff=True)
c = c.fmtc.resample (scalev=2, kernel="cubic", interlaced=1, interlacedd=0)

Converting a progressive stream from YUV 4:2:2 to 4:2:0 and back to 8 bits:

c = c.fmtc.resample (css="420")
c = c.fmtc.bitdepth (bits=8)

Same as above, with interlaced content:

tff = True
c = c.std.SeparateFields (tff=tff)
c = c.fmtc.resample (css="420", interlaced=1)
c = c.fmtc.bitdepth (bits=8)
c = c.std.DoubleWeave (tff=tff)
c = c.std.SelectEvery (cycle=2, offsets=0)

Colorspace conversions

Y’Cb’Cr’ 4:2:0 to R’G’B’:

c = c.fmtc.resample (css="444")
c = c.fmtc.matrix (mat="601", col_fam=vs.RGB)
c = c.fmtc.bitdepth (bits=8)

R’G’B’ to Y’Cb’Cr’ 4:2:0:

c = c.fmtc.matrix (mat="601", col_fam=vs.YUV, bits=16)
c = c.fmtc.resample (css="420")
c = c.fmtc.bitdepth (bits=8)

Y’Cb’Cr colormatrix conversion from BT. 601 to BT. 709. For example to insert a PAL DVD content into an HDTV stream. Note that we need to convert the clip to 4:4:4 in an intermediate step because matrix can only process 4:4:4.

c = c.fmtc.resample (css="444")
c = c.fmtc.matrix (mats="601", matd="709")
c = c.fmtc.resample (css="420")
c = c.fmtc.bitdepth (bits=8)

Same as above, but with a 525-line content, requiring a gamut conversion. We have to insert an intermediate step in linear RGB. For this, we use the BT. 1886 transfer curve in both directions:

c = c.fmtc.resample (css="444")
c = c.fmtc.matrix (mats="601")
c = c.fmtc.transfer (transs="1886", transd="linear")
c = c.fmtc.primaries (prims="601-525", primd="709")
c = c.fmtc.transfer (transs="linear", transd="1886")
c = c.fmtc.matrix (mat="709")
c = c.fmtc.resample (css="420")
c = c.fmtc.bitdepth (bits=8)

Conversion from full range to TV-range:

c = c.fmtc.bitdepth (fulls=True, fulld=False)

Displaying an anamorphic 1440x1080 HDTV content on a standard computer display:

c = c.fmtc.resample (w=1920, h=1080, css="444")
c = c.fmtc.matrix (mat="709", col_fam=vs.RGB)
c = c.fmtc.transfer (transs="1886", transd="srgb")
c = c.fmtc.bitdepth (bits=8)

Displaying a UHDTV HDR content encoded with BT.2100 IC_TC_P-PQ on a standard computer display. Conversion to sRGB (SDR) is done by reducing the contrast from an arbitrary factor and clipping the pixel values at the end. Obviously this is a poor solution, a tone mapping algorithm would be more suited for this task. With PQ, the linear values go way above 1.0 which is 203 cd/m² for the reference white, so even if we reduce the contrast, we convert data to float to prevent information loss during the subsequent color conversion steps (this is optional):

c = c.fmtc.resample (css="444") # -> I'Ct'Cp' 4:4:4
c = c.fmtc.matrix (mats="ICtCp_PQ", matd="rgb") # -> L'M'S'
c = c.fmtc.transfer (transs="2084", transd="linear", cont=0.2, flt=True) # -> LMS
c = c.fmtc.matrix (mats="lms", matd="rgb") # -> RGB
c = c.fmtc.primaries (prims="2100", primd="srgb")
c = c.fmtc.transfer (transs="linear", transd="srgb")
c = c.fmtc.bitdepth (bits=8)

Examples for Avisynth+

Soon…

Compiling from the source code

Visual C++

Visual Studio 2019 or later is required, previous versions are not supported anymore. Just load build/win/fmtconv.sln and run the compiler.

You can also import all the *.cpp, *.h and *.hpp files located in the src directory and its subfolders. Then:

• Add . (the src directory) as include path.
• For the whole project, enable the SS2 instruction set.
• Enable the AVX2 instruction set for the *.cpp files containing avx2 in their name, and the AVX set for the avx files.
• Enable optimizations maximizing speed and “any suitable” functions for inlining.

GNU/Linux and other Unix-like systems

On Linux and similar GNU-based systems (including MSYS2 and Cygwin), the build directory contains autotools settings:

cd build/unix
./autogen.sh
./configure
make
make install

You can add some options to the configure command:

• --enable-debug to activate debugging code
• CXX='clang++' CC='clang' to use Clang instead of the default compiler which is usually GCC

Only the Vapoursynth plug-in can be built in the GNU-based environment.

III) Filters description

bitdepth

fmtc.bitdepth (
	clip       : vnode     ;
	csp        : int  : opt;
	bits       : int  : opt;
	flt        : int  : opt;
	planes     : int[]: opt; (all)
	fulls      : int  : opt; (depends)
	fulld      : int  : opt; (fulls)
	dmode      : int  : opt; (3)
	ampo       : float: opt; (1)
	ampn       : float: opt; (0)
	dyn        : int  : opt; (False)
	staticnoise: int  : opt; (False)
	cpuopt     : int  : opt; (-1)
	patsize    : int  : opt; (32)
	tpdfo      : int  : opt; (0)
	tpdfn      : int  : opt; (0)
	corplane   : int  : opt; (0)
)

fmtc_bitdepth (
	clip   c,

	int    bits (-1),
	bool   flt (undefined),
	string planes ("all"),
	bool   fulls (depends),
	bool   fulld (fulls),
	int    dmode (3),
	float  ampo (1),
	float  ampn (0),
	bool   dyn (false),
	bool   staticnoise (false),
	int    cpuopt (-1),
	int    patsize (32),
	bool   tpdfo (false),
	bool   tpdfn (false),
	bool   corplane (false)
)

Bitdepth conversion with optional dithering.

Dithering is performed when meeting at least one of these conditions:

• Reducing the bitdepth of integer data, or converting from float to integer.
• Doing a full-range ↔ TV-range conversion between integer formats, because the resulting values haven’t an exact representation.

Video compression seems to retrain better pure ordered (Bayer) dithering. Therefore this is the recommended method to avoid color banding in 8 bit signals, unless you encode at high bitrates. If you don’t care about video compression, error diffusion, void and cluster and quasirandom sequence methods give the most accurate results. To avoid discontinuities between purely flat areas and dithered areas (also called noise modulation), you can add a bit of noise, ideally in triangular distribution.

The internal noise generator is deterministic and will give the same result each run.

The internal processing is done in floating point as soon as the input is floating point or a range conversion is detected.

The _ColorRange frame property is set if at least one of the fulls or fulld parameter has been explicitely defined.

Parameters

clip

The input clip. Mandatory. Supported input formats:

• 8-–12-, 14- and 16-bit integer.
• 32-bit floating point.
• Any planar colorspace.

csp

Vapoursynth The destination format, as a Vapoursynth constant. Can only change the bitdepth and the data type (integer or float). Supported destination colorspaces are the same as for the input clip.

bits

Destination bitdepth. It’s sometimes more convenient to provide only the number of bits rather than the full format. When there is no ambiguity between bitdepth and data type, the data type is automatically selected depending on the bitdepth. For example, specifying 32 bits is enough to switch the output to float.

Avisynth+ A negative value means that the parameter is left undefined.

flt

Set it to 1 to convert to float, and to 0 for integer data. As long as only 32-bit floating point data is supported, you don’t need to specify the bitdepth for a float conversion.

planes

A list of planes to process. The content of an unprocessed plane should be considered as garbage.

Vapoursynth Planes as index (0 to 2), in any order.

Avisynth+ This is a string made of concatenated substrings for each plane, in any order. The planes are identified by their index, as well as the following aliases:

fulls, fulld

Indicates if the clip is full-range (True) or TV-range (False). fulls is for input, fulld for output. Reference black and white have different values depending on the range. In 8 bits, pixel values scale from 0 to 255 in full range, and 16 to 235 in TV-range (16 to 240 for the YUV chroma planes). This value has no meaning for float data.

The default value depends on the colorspace. For example, full-range is assumed for RGB and YCoCg colorspaces. Others are assumed TV-range. These parameters are mainly intended to guide conversions between integer and floating-point data. They can also be used for range conversions. Pixel values are not clipped during a conversion between two TV-range formats.

Avisynth+ Alpha planes are always processed as full-range.

dmode

Dithering mode, when applicable.

When using error-diffusion dithering on interlaced content, you should separate the fields first before converting them.

ampo

The ordered dither peak-to-peak amplitude, depends on the target bitdepth. ≥ 0. On error diffusion algorithms, it increases the collected error amount, helping to extend the range of the dithering while preserving its natural pattern (especially Atkinson’s). This gives a better looking result than just adding noise.

ampn

The noise peak-to-peak amplitude, depends on the target bitdepth. ≥ 0. Currently, the maximum value is 4. The noise is added before dithering. It reduces the SNR but a small amount may give a better, more uniform visual appearance.

dyn

Indicates if the ordered dither pattern is dynamic (True) or static (False). If dynamic, the pattern is changed or rotated each frame.

staticnoise

If set to 1, the noise generated with ampn is static and remains the same every frame.

cpuopt

Limits the CPU instruction set. −1: automatic (no limitation), 0: default instruction set only (depends on the compilation settings), 1: limit to SSE2, 10: limit to AVX2.

patsize

Width of the pattern used in the Void and cluster algorithm. The only valid values are power of 2 ranging from 4 to 1024: 4, 8, 16, 32, 64, 128, 256, 512 and 1024.

tpdfo

Set it to 1 to enable the triangular probability distribution function (TPDF) for halftone-based dithering algorithms. It has no effect on error diffusion methods. 0 is the standard rectangular distribution (RPDF). Note that when triangular distribution is enabled, the maximum halftone amplitude is multiplied by 1.414 at constant ampo.

tpdfn

Same as tpdfo, but for the additive noise part. TPDF noise looks more natural than RPDF noise, and is a crude approximation of a gaussian noise, with a bounded amplitude. Maximum noise amplitude is multiplied by 1.414 at constant ampn, so the introduced noise power is kept approximately constant.

corplane

Set it to 1 to keep the dither and noise patterns correlated for all the planes. When processing a RGB picture, it helps to prevent colored noise on grey features.

convert

fmtc.convert (
	# Input
	clip       : vnode       ;

	# Resizing/resampling
	w          : int    : opt;
	h          : int    : opt;
	sx         : float[]: opt; (0)
	sy         : float[]: opt; (0)
	sw         : float[]: opt; (0)
	sh         : float[]: opt; (0)
	scale      : float  : opt; (0)
	scaleh     : float  : opt; (0)
	scalev     : float  : opt; (0)
	kernel     : data[] : opt; ("spline36")
	kernelh    : data[] : opt; (kernel)
	kernelv    : data[] : opt; (kernel)
	impulse    : float[]: opt;
	impulseh   : float[]: opt; (impulse)
	impulsev   : float[]: opt; (impulse)
	taps       : int[]  : opt; (4)
	tapsh      : int[]  : opt; (taps)
	tapsh      : int[]  : opt; (taps)
	a1         : float[]: opt;
	a2         : float[]: opt;
	a3         : float[]: opt;
	kovrspl    : int[]  : opt; (1)
	fh         : float[]: opt; (1)
	fv         : float[]: opt; (1)
	cnorm      : int[]  : opt; (True)
	totalh     : float[]: opt; (0)
	totalv     : float[]: opt; (0)
	invks      : int[]  : opt; (False)
	invksh     : int[]  : opt; (invks)
	invksv     : int[]  : opt; (invks)
	invkstaps  : int[]  : opt; (4)
	invkstapsh : int[]  : opt; (invkstaps)
	invkstapsv : int[]  : opt; (invkstaps)
	center     : int[]  : opt; (True)

	# Output clip format
	csp        : int    : opt;
	css        : data   : opt;
	col_fam    : int    : opt;
	bits       : int    : opt;
	flt        : int    : opt;

	# Output dithering
	dmode      : int    : opt; (3)
	ampo       : float  : opt; (1)
	ampn       : float  : opt; (0)
	dyn        : int    : opt; (False)
	staticnoise: int    : opt; (False)

	# Common sub-format spec
	cplace     : data   : opt; ("mpeg2")
	mat        : data   : opt;
	coef       : float[]: opt;
	interlaced : int    : opt; (2)
	tff        : int    : opt; (2)
	useflt     : int    : opt; (False)

	# Input clip sub-format spec
	fulls      : int    : opt; (depends on the colorspace)
	cplaces    : data   : opt; (cplace)
	mats       : data   : opt;

	# Output clip sub-format spec
	fulld      : int    : opt; (fulls)
	cplaced    : data   : opt; (cplace)
	matd       : data   : opt;

	# Transfer curve parameters
	transs     : data[] : opt;
	transd     : data[] : opt;
	cont       : float  : opt;
	gcor       : float  : opt;

	cpuopt     : int    : opt; (-1)
)

Multi-purpose conversion function.

Not available yet.

matrix

fmtc.matrix (
	clip     : vnode       ;
	mat      : data   : opt;
	mats     : data   : opt;
	matd     : data   : opt;
	fulls    : int    : opt; (depends)
	fulld    : int    : opt; (depends)
	coef     : float[]: opt;
	csp      : int    : opt;
	col_fam  : int    : opt;
	bits     : int    : opt;
	singleout: int    : opt; (-1)
	cpuopt   : int    : opt; (-1)
)

fmtc_matrix (
	clip   c,
	string mat (undefined),
	string mats (undefined),
	string matd (undefined),
	bool   fulls (depends),
	bool   fulld (depends),
	arrayf coef (undefined),
	string csp (undefined),
	string col_fam (undefined),
	int    bits (undefined),
	int    singleout (-1),
	int    cpuopt (-1)
)

Colorspace conversion or simple cross-plane matrix.

For Y’Cb’Cr’ and Y’Co’Cg’ colorspaces, 4:4:4 is required (no chroma subsampling). To process a subsampled colorspace, you must convert it to 4:4:4 first.

The output is not dithered, therefore you should output at a higher bitdepth than the input and dither afterward with bitdepth to avoid potential banding.

When the destination color family (R’G’B’, Y’Cb’Cr’ or Y’Co’Cg’) is not specified (via col_fam or csp), the function tries to deduce it from the matrix settings and the source color family. If it cannot be deduced, the color family remains unchanged.

Please note that this function doesn’t do conversions based on the color primaries. The R’G’B’ data are always releative to their specified standard. For example, converting Y’Cb’Cr’ data straight from BT.2020 to BT.709 doesn’t make sense as these colorspaces are defined with different primaries. For meaningful results, convert to R’G’B’ then to linear RGB and use primaries to perform the intermediary conversion.

The _ColorRange frame property is set if the fulld parameter has been explicitely defined or if a preset is used. If the destination colorspace is a standardized one (as deduced from the specified matrix), the _Matrix and _ColorSpace properties are set, otherwise they are deleted from the frame.

Avisynth+If an alpha channel is present in both the source and destination colorspaces, it is copied and its bitdepth is possibly adapted to the destination format. If there is no alpha channel in the source, full opacity is assumed. If there is no alpha channel in the destination, the plane is lost.

Parameters

clip

The input clip. Mandatory. Supported input formats:

• 8-, 10-, 12-, 14- and 16-bit integer.
• 32-bit floating point.
• Any planar colorspace with 3 planes.

Vapoursynth 9-bit integer data is supported too.

Avisynth+ Colorspaces with an alpha channel are supported too.

mat

Predefined matrix for conversions to and from R’G’B’. The direction is deduced from the specified input and output colorspaces. Possible values are:

mats, matd

Source and destinations matrices for YUV. Use both when you want to do a conversion between BT.601 and BT.709. Values are the same as mat, with the addition of:

When using one of these additional values, make sure to set the other mats or matd with "rgb" to clarify the conversion direction. IC_TC_P transforms from R’G’B’ require the following steps:

• Convert from R’G’B’ to linear BT.2100 RGB with transfer then possibly primaries.
• Convert from linear BT.2100 RGB to linear LMS using matrix with "LMS".
• Convert from linear LMS to L’M’S’ using transfer with "2084" or "hlg".
• Convert from L’M’S’ to IC_TC_P using matrix with "ICtCp_PQ" or "ICtCp_HLG", respectively.

For the inverse conversion, reverse the steps. Beware, chromatic information for pixels of the highest luminance range cannot be represented in integer IC_TC_P and will be clipped because of the large matrix coefficients.

fulls, fulld

Indicates if the clip is full-range (True) or TV-range (False). fulls is for input, fulld for output. Reference black and white have different values depending on the range. In 8 bits, pixel values scale from 0 to 255 in full range, and 16 to 235 in TV-range (16 to 240 for the YUV chroma planes). This value has no meaning for float data.

The default value depends on the colorspace. For example, full-range is assumed for R’G’B’ and Y’Co’Cg’ colorspaces. Others are assumed TV-range. These parameters are mainly intended to guide conversions between integer and floating-point data. They can also be used for range conversions. Pixel values are not clipped during a conversion between two TV-range formats.

coef

A list of 12 coefficients for a custom matrix. The coefficients should be scaled assuming the input is floating point, even if the actual input is integer. This means luma and R’G’B’ signals range from 0 to 1, and chroma signals from −0.5 to +0.5. Coefficients are listed by rows. Each row is terminated with a fourth coefficient, the additive constant (still in floating-point range). This means the matrix is actually 4×3 and during the multiplication, the input column-vector has an implicit 1 appended to its end. For example, with an R’G’B’ input:

Vapoursynth List is a regular array.

Avisynth+ List can be an array of float values if supported by the scripting language, or a string containing the values printed and separated with spaces.

csp

The destination format. It cannot change the data type (integer or float) nor the chroma subsampling. If the colorspace family is set to GRAY (or Y), single-plane processing is enabled. The output plane is selected with singleout (0 if not specified). Only planar colorspaces are allowed.

Vapoursynth The format is a Vapoursynth built-in constant.

Avisynth+ The format is a string with the same kind of content as the result from BuildPixelType or the pixel_type parameter from BlankClip. For example: "RGBP48", "YV12", "YUV444PS"…

col_fam

Explicit specification of the destination color family, as Vapoursynth constant. Supersedes the color family from csp. You can only specify colorspace with the same number of planes as the input clip.

bits

Explicit specification of the destination bitdepth. The only allowed values are 8, 10, 12, 14, 16 and 32. However you cannot reduce the bitdepth, only keep it constant or increase it. Supersedes the bitdepth from csp.

Vapoursynth 9 bits is allowed too.

singleout

Enable single-plane processing. This is useful to obtain only the luma from an R’G’B’ input, for example. The parameter is the plane index, ranging from 0 to 2. A negative value specifies that all planes should be processed. If singleout is ≥ 0, it supersedes the colorspace family specified in csp.

Note: when extracting a chroma plane, results between int with TV range and float data type may slightly differ. This is because in float, a neutral chroma (0%) is converted to the exact value of a medium gray (50%). In integer, the chroma output value is mapped 1–1 to the luma channel. However in TV-range, medium gray is not located exactly at the half of the data range, it lies slightly below.

cpuopt

Limits the CPU instruction set. −1: automatic (no limitation), 0: default instruction set only (depends on the compilation settings), 1: limit to SSE2, 7: limit to AVX, 10: limit to AVX2.

matrix2020cl

fmtc.matrix2020cl (
	clip    : vnode     ;
	full    : int  : opt; (False)
	csp     : int  : opt;
	bits    : int  : opt;
	cpuopt  : int  : opt; (-1)
)

fmtc_matrix2020cl (
	clip   c,
	bool   full (false),
	string csp (undefined),
	int    bits (undefined),
	int    cpuopt (-1)
)

Colorspace conversion using the ITU-R BT.2020 constant luminance matrix.

The function converts between linear RGB and Y’Cb’Cr’ colorspaces. This conversion cannot be achieve with a classic linear matrix. The output colorspace, hence the direction of the conversion, is automatically deduced from the input colorspace.

For Y’Cb’Cr’ colorspaces, 4:4:4 is required (no chroma subsampling). To process a subsampled colorspace, you must convert it to 4:4:4 first.

The RGB colorspace is always 16 bits when using integers, or 32 bits in float. The output is not dithered, therefore you should output at a higher bitdepth than the input and dither afterward with bitdepth to avoid potential banding.

Please note that the RGB content is always assumed to be linear light. The BT.2020 gamma curve is used in both directions. When operating on floating point data, the function uses the 12-bit variant of the scaling coefficients.

The _Matrix, _ColorSpace and _Transfer frame properties are set according to the transformation. The _ColorRange property is set if the full parameter has been explicitely defined.

Avisynth+If an alpha channel is present in both the source and destination colorspaces, it is copied and its bitdepth is possibly adapted to the destination format. If there is no alpha channel in the source, full opacity is assumed. If there is no alpha channel in the destination, the plane is lost.

Parameters

clip

The input clip. Mandatory. Supported input formats:

• 8-, 10-, 12-, 14- and 16-bit integer for Y’Cb’Cr’, 16-bit integer for RGB.
• 32-bit floating point.
• YUV and RGB colorspaces.

Vapoursynth 9-bit integer data is supported too.

Avisynth+ Colorspaces with an alpha channel are supported too.

full

Indicates if the Y’Cb’Cr’ clip is full-range (True) or TV-range (False). Reference black and white have different values depending on the range. In 8 bits, pixel values scale from 0 to 255 in full range, and 16 to 235 in TV-range (16 to 240 for the YUV chroma planes). This value has no meaning for float data.

csp

It must be compatible with what is logically expected as output (RGB or YUV). It cannot change the data type (integer or float) nor the chroma subsampling. If the output is integer RGB, the bitdepth must be 16. Only planar colorspaces are allowed.

Vapoursynth The format is a Vapoursynth built-in constant.

Avisynth+ The format is a string with the same kind of content as the result from BuildPixelType or the pixel_type parameter from BlankClip. For example: "RGBP48", "YV12", "YUV444PS"…

bits

Explicit specification of the destination bitdepth. The only allowed values are 8, 10, 12, 14, 16 and 32. They are restricted by the output data type and format (16 bits for integer RGB). Supersedes the bitdepth from csp.

Vapoursynth 9 bits is allowed too.

cpuopt

Limits the CPU instruction set. −1: automatic (no limitation), 0: default instruction set only (depends on the compilation settings).

primaries

fmtc.primaries (
	clip  : vnode       ;
	rs    : float[]: opt;
	gs    : float[]: opt;
	bs    : float[]: opt;
	ws    : float[]: opt;
	rd    : float[]: opt;
	gd    : float[]: opt;
	bd    : float[]: opt;
	wd    : float[]: opt;
	prims : data   : opt;
	primd : data   : opt;
	wconv : int    : opt; (False)
	cpuopt: int    : opt; (-1)
)

fmtc_primaries (
	clip   c,
	arrayf rs (undefined),
	arrayf gs (undefined),
	arrayf bs (undefined),
	arrayf ws (undefined),
	arrayf rd (undefined),
	arrayf gd (undefined),
	arrayf bd (undefined),
	arrayf wd (undefined),
	string prims (undefined),
	string primd (undefined),
	bool   wconv (False),
	int    cpuopt (-1)
)

Performs a gamut conversion given a set of three primary colors and a reference white to another set of primary colors and a target reference white. Illuminant conversions are done using the Bradford method.

Pixel values are left intact after the transform, they are not bound to the target gamut and could be invalid colors. However, when using 16-bit unsigned integer they are clipped to representable data values.

All colors are given in xyY colorspace, with their x and y coordinates.

You must supply the full description of the original and target gamuts, with the built-in presets or by setting individual components.

Please note that this function does not work at the same level as matrix. The latter converts between gamma-compressed RGB and YUV-like colorspaces, while primaries operates on linear RGB colorspaces exclusively, whose specifications are given by the primaries. For more details, see Charles Poynton, A Guided Tour of Color Space, 1997.

The _Primaries frame property is set or deleted, depending on the target gamut.

Parameters

clip

The input clip. Mandatory. Supported colorspaces are 16-bit int or 32-bit float linear RGB. You should use the transfer function to convert between linear RGB and gamma-compressed R’G’B ’colorspaces.

rs, gs, bs, ws

Primaries for the source colorspace as red, green, blue and reference white. Each variable contains two components, x and y, in this order. The y value cannot be null.

Vapoursynth Parameters are regular arrays.

Avisynth+ Parameters can be arrays of two float values if supported by the scripting language, or strings containing both values printed and separated with a space.

rd, gd, bd, wd

Primaries for the target colorspace. If not specified, the value is copied from the source colorspace.

prims, primd

Primaries presets for the source and destination colorspaces. Superseded by individual r, g, b and w settings. Possible values are:

wconv

Indicates we want a full conversion for the white point.

If set to False, chromatic adaptation will be used, so the white will stay white on the destination illuminant and colors will be adapted to implement a real illuminant change. This is generally what you want when converting between gamuts: the eye adapts to the new white and colors should be matched accordingly.

If set to True, the chromatic adaptation is bypassed. The white from the source colorspace will appear with a tint if the target colorspace has a different white point. Use this if you want to emulate what a picture displayed with a monitor using the source illuminant looks like on a display using the target illuminant. This is also what you want when converting to and from XYZ for further operations in this colorspace.

cpuopt

Limits the CPU instruction set. −1: automatic (no limitation), 0: default instruction set only (depends on the compilation settings), 1: limit to SSE2, 7: limit to AVX, 10: limit to AVX2.

resample

fmtc.resample (
	clip       : vnode       ;
	w          : int    : opt;
	h          : int    : opt;
	sx         : float[]: opt; (0)
	sy         : float[]: opt; (0)
	sw         : float[]: opt; (0)
	sh         : float[]: opt; (0)
	scale      : float  : opt; (0)
	scaleh     : float  : opt; (0)
	scalev     : float  : opt; (0)
	kernel     : data[] : opt; ("spline36")
	kernelh    : data[] : opt; (kernel)
	kernelv    : data[] : opt; (kernel)
	impulse    : float[]: opt;
	impulseh   : float[]: opt; (impulse)
	impulsev   : float[]: opt; (impulse)
	taps       : int[]  : opt; (4)
	tapsh      : int[]  : opt; (taps)
	tapsv      : int[]  : opt; (taps)
	a1         : float[]: opt;
	a2         : float[]: opt;
	a3         : float[]: opt;
	a1h        : float[]: opt; (a1)
	a2h        : float[]: opt; (a2)
	a3h        : float[]: opt; (a3)
	a1v        : float[]: opt; (a1)
	a2v        : float[]: opt; (a2)
	a3v        : float[]: opt; (a3)
	kovrspl    : int[]  : opt; (1)
	fh         : float[]: opt; (1)
	fv         : float[]: opt; (1)
	cnorm      : int[]  : opt; (True)
	total      : float[]: opt; (0)
	totalh     : float[]: opt; (total)
	totalv     : float[]: opt; (total)
	invks      : int[]  : opt; (False)
	invksh     : int[]  : opt; (invks)
	invksv     : int[]  : opt; (invks)
	invkstaps  : int[]  : opt; (4)
	invkstapsh : int[]  : opt; (invkstaps)
	invkstapsv : int[]  : opt; (invkstaps)
	csp        : int    : opt;
	css        : data   : opt;
	planes     : float[]: opt; (3)
	fulls      : int    : opt; (depends)
	fulld      : int    : opt; (fulls)
	center     : int[]  : opt; (True)
	cplace     : data   : opt; ("mpeg2")
	cplaces    : data   : opt; (cplace)
	cplaced    : data   : opt; (cplace)
	interlaced : int    : opt; (2)
	interlacedd: int    : opt; (interlaced)
	tff        : int    : opt; (2)
	tffd       : int    : opt; (tff)
	flt        : int    : opt; (False)
	cpuopt     : int    : opt; (-1)
)

fmtc_resample (
	clip   c,
	int    w (undefined),
	int    h (undefined),
	arrayf sx (0),
	arrayf sy (0),
	arrayf sw (0),
	arrayf sh (0),
	float  scale  (0),
	float  scaleh (0),
	float  scalev (0),
	string kernel  ("spline36"),
	string kernelh (kernel),
	string kernelv (kernel),
	arrayf impulse  (undefined),
	arrayf impulseh (impulse),
	arrayf impulsev (impulse),
	arrayi taps (4),
	arrayi tapsh (taps),
	arrayi tapsv (taps),
	arrayf a1 (undefined),
	arrayf a2 (undefined),
	arrayf a3 (undefined),
	arrayf a1h (a1),
	arrayf a2h (a2),
	arrayf a3h (a3),
	arrayf a1v (a1),
	arrayf a2v (a2),
	arrayf a3v (a3),
	int    kovrspl (1),
	arrayf fh (1),
	arrayf fv (1),
	bool   cnorm (true),
	arrayf total (0),
	arrayf totalh (total),
	arrayf totalv (total),
	arrayb invks  (false),
	arrayb invksh (invks),
	arrayb invksv (invks),
	arrayi invkstaps  (4),
	arrayi invkstapsh (invkstaps),
	arrayi invkstapsv (invkstaps),
	string csp (undefined),
	string css (undefined),
	arrayf planes (all),
	int    fulls (depends),
	int    fulld (fulls),
	arrayb center (true),
	string cplace  ("mpeg2"),
	string cplaces (cplace),
	string cplaced (cplace),
	int    interlaced (2),
	int    interlacedd (interlaced),
	int    tff (2),
	int    tffd (ttf),
	bool   flt (false),
	int    cpuopt (-1)
)

Resizes the planes of a clip. This function can change the chroma subsampling.

Output is always 16-bit integer (default for integer input) or 32-bit float. Use fmtc.bitdepth to convert the result to a lower bitdepth. It is possible to select the internal precision: float, or 16-bit integers with a 32-bit accumulator for the convolution. Internal conversion from float or 32-bit integers to 16 bits is done by quick rounding (no dithering). The integer operation path is available only when input and output formats are integer too.

The function can resize interlaced content, but only if presented as separated, interleaved fields. It uses the _Field and _FieldBased frame properties to detect interlaced content and field parity, maintaining the correct chroma and luma relative positions. If this automatic detection is not desired, you can specify manually the interlaced and tff parameters. Simple intra-field deinterlacing (“bob”) can be achieved this way, by specifying scalev=2.

Excepted impulse*, array parameters allow to specify plane-specific values. When specifying less than 3 values, the last specified value will be reused for the next planes. However planes works slightly differently, check the related paragraph for details.

Avisynth+ Arrays can be specified as values printed in a string and separated with spaces.

Note: field resizing is not always the best way to handle interlaced content, especially for upscales. You’ll probably have better results by using a “smart” deinterlacer (making use of temporal information and anti-aliasing), resizing the progressive content at double rate then reinterlacing. Simple field resampling is more or less equivalent to this method, using a naive bob.

Avisynth+ Interlacing parameters are automatically detected with global clip information which can be overriden by frame properties.

The function can also be used to compute horizontal and vertical convolutions. If you do so, don’t forget to set:

• fh or fv to −1 to make sure the clip is processed even if its size doesn’t change,
• cnorm to false to avoid automatic kernel normalisation if your impulse is already normalised, or specify total if the normalisation factor is not the sum of the impulse
• and center to False to keep the desired spacing between the sampling points.

The function handles the following frame properties:

Parameters

clip

Clip to be resized. Mandatory. Supported input formats:

• 8-, 9-, 10-, 12-, 14- and 16-bit integer.
• 32-bit floating point.
• Any planar colorspace.

w, h

New picture width and height in pixels, > 0. If not specified, it will keep the original dimensions. The dimensions must be compatible with the destination chroma subsampling. They take precedence over the scale, scaleh and scalev parameters.

sx, sy

Coordinate of the top-left corner of the picture sub-area used as source for the resizing. They can be fractional. If negative, the picture is extended by replicating the left pixel column.

These parameters are arrays, so it’s possible to specify a different value for each plane. The last value is used for the unspecified planes. The coordinates are always related to the pixel dimensions, you don’t need to scale them with the chroma subsampling.

sw, sh

Size in pixels of the sub-area to resize. They can be fractional. If 0, the area has the same size as the source clip. If negative, they define coordinates relative to the bottom-right corner, in a Crop-like manner. These parameters are arrays like sx and sy.

scale, scaleh, scalev

Use these parameters to set relative dimensions, > 0. For example scale=0.5 will halve the picture size. The computed dimensions will be compatible with the destination chroma subsampling. Zero is ignored.

kernel

Kernel used by the resizer. Possible values are:

impulse, impulseh, impulsev

Offers the possibility to create your own kernel (useful for convolutions). Add your coefficents in the array. The number of coefficients must be odd. The curve is linearly interpolated between the provided points. You can oversample the impulse by setting kovrspl to a value > 1. To activate the custom kernel, set kernel="impulse".

taps, tapsh, tapsv

Some kernels have a variable number of sample points, given by this parameter. Actually this counts half the number of lobes (or equivalent); in case of downscaling, the actual number of sample points may be greater than the specified value. Range: 1–128

a1, a2, a3, a1h, a2h, a3h, a1v, a2v, a3v

Specific parameters, depending on the selected kernel.

kovrspl

Specifies here how many times the kernel is oversampled when you provide a custom impluse response. ≥ 1.

fh, fv

Horizontal and vertical frequency factors, also known as inverse kernel support. They are multipliers on the theoretical kernel cutoff frequency in both directions. Values below 1.0 spatially expand the kernel and blur the picture. Values over 1.0 shrink the kernel and let higher frequencies pass. The result will look sharper but more aliased. The multiplicator is applied after the kernel scaling in case of downsizing. Negative values force the processing, even if the horizontal size doesn’t change. The filter will use the absolute parameter value.

cnorm

If set to true, the impulse sum is normalised to 1 for each pixel. This is the normal behaviour when resizing, to make sure the energy is constant for all pixels. If you use the resizer as a convolution engine, it is advised to disable the normalisation.

total, totalh, totalv

When cnorm is activated, these parameters specify the normalisation value for the corresponding kernel. 0 means that the normalisation value is the sum of the coefficients. The Masktools’mt_convolution function has a single parameter for this use: total = totalh × totalv. Because the convolution is computed with floating point data, there is no saturation of intermediate results, therefore the balance between totalh and totalv is not important, only their product will be taken into account. Note that because kernels are single-dimention, the “parent” total parameter here is the sum of the coefficients for each direction, not the product of totalh and totalv.

invks, invksh, invksv

Set these parameter to True to activate the kernel inversion mode for the specified direction (use invks for both). Inverting the kernel allows to “undo” a previous upsizing by compensating the loss in high frequencies, giving a sharper and more accurate output than classic kernels, closer to the original. This is particularly useful for clips upscaled with a bilinear kernel. All the kernel-related parameters specify the kernel to undo. The target resolution must be as close as possible to the initial resolution. The kernel inversion is mainly intended to downsize an upscaled picture. Using it for upsizing will not restore details but will give a sligthly sharper look, at the cost of a bit of aliasing and ringing. This mode is somewhat equivalent to the debilinear plug-in but works with a different principle.

invkstaps, invkstapsh, invkstapsv

In kernel inversion mode (invks=True), this parameter sets the number of taps for the inverted kernel. Use it as a tradeof between softness and ringing. Range: 1–128

csp

Can only change the bitdepth and the data type (integer or float). Only 16-bit integer (xxxP16) and 32-bit float data types are allowed.

Vapoursynth The format is a Vapoursynth built-in constant.

Avisynth+ The format is a string with the same kind of content as the result from BuildPixelType or the pixel_type parameter from BlankClip.

css

Destination chroma subsampling, for YUV (and YCoCg) colorspaces. Supersedes the chroma subsampling from csp. You can also specify the subsampling with the predefined values or with a two-digit string. The first digit for the horizontal subsampling, and the second for the vertical subsampling. Only power-of-2 numbers are allowed. For example "41" is equivalent to 4:1:1 and "22" to 4:2:0.

The predefined values are:

planes

This array decribes how each plane should be processed. It’s similar to the y, u and v parameters in Masktools 2.

Avisynth+ The parameter can also be specified as a string. See the planes parameter from the fmtc_bitdepth function for more details.

fulls, fulld

Indicates if the clip is full-range (True) or TV-range (False). fulls is for input, fulld for output. Reference black and white have different values depending on the range. In 8 bits, pixel values scale from 0 to 255 in full range, and 16 to 235 in TV-range (16 to 240 for the Y’Cb’Cr’ chroma planes). This value has no meaning for float data.

The default value depends on the colorspace. For example, full-range is assumed for RGB and YCoCg colorspaces. Others are assumed TV-range. These parameters are mainly intended to guide conversions between integer and floating-point data. They can also be used for range conversions. Pixel values are not clipped during a conversion between two TV-range formats.

center

Like the Avisynth standard resizers, this resizer preserves the position of the picture center. Disable this parameter if you may want to resize by preserving the top-left corner position. Similarly, if you are convolving without resizing, setting it to false ensures you that the same kernel will be applied to all pixels.

cplace, cplaces, cplaced

Placement of the chroma samples. cplaces specifies the source clip only, cplaced the destination clip. Can be one of these strings:

The chroma placement is ignored when center is set to False or kernel to "point". You’ll find below an overview of common chroma placement and subsampling combinations:

interlaced, interlacedd

Specifies if the clip is made of frames or fields. interlacedd overrides interlaced for output.

tff, tffd

When processing interlaced content, specifies the field parity. tffd overrides tff for output.

flt

Flag to force floating point operations. When set to False, integer operations are used, but only if both input and output formats are integer. If it’s not the case, floating point operations are silently used as fallback.

cpuopt

Limits the CPU instruction set. −1: automatic (no limitation), 0: default instruction set only (depends on the compilation settings), 1: limit to SSE2, 10: limit to AVX2.

transfer

fmtc.transfer (
	clip    : vnode       ;
	transs  : data[] : opt;
	transd  : data[] : opt;
	cont    : float  : opt;
	gcor    : float  : opt;
	bits    : int    : opt;
	flt     : int    : opt;
	fulls   : int    : opt; (True)
	fulld   : int    : opt; (True)
	logceis : int    : opt; (800)
	logceid : int    : opt; (800)
	cpuopt  : int    : opt; (-1)
	blacklvl: float  : opt; (0)
	sceneref: int    : opt; (undefined)
	lb      : float  : opt;
	lw      : float  : opt;
	lw_s    : float  : opt; (lw)
	lw_d    : float  : opt; (lw)
	ambient : float  : opt;
	match   : int    : opt; (1)
	gy      : int    : opt;
	debug   : int    : opt; (0)
	sig_c   : float  : opt; (6.5)
	sig_t   : float  : opt; (0.5)

)

fmtc_transfer (
	clip   c,
	string transs (undefined),
	string transd (undefined),
	float  cont (1),
	float  gcor (1),
	int    bits (undefined),
	bool   flt (undefined),
	bool   fulls (true),
	bool   fulld (true),
	int    logceis (800),
	int    logceid (800),
	int    cpuopt (-1),
	float  blacklvl (0),
	bool   sceneref (undefined),
	float  lb (undefined),
	float  lw (undefined),
	float  lw_s (lw),
	float  lw_d (lw),
	float  ambient (undefined),
	int    match (1),
	bool   gy (undefined),
	int    debug (0),
	float  sig_c (6.5),
	float  sig_t (0.5)
)

Applies electro-optical and opto-electrical transfer characteristics to the video signal to convert between linear and gamma-corrected modes.

The function offers four conversions in a row; all are optional:

• an electro-optical transfer function (EOTF) or an inverse opto-electrical transfer function (OETF⁻¹) converting the signal from gamma-compressed to linear light (scene or display),
• a contrast adjustement,
• a gamma correction operating on the linear signal,
• and an opto-electrical transfer function (OETF) or an inverse electro-optical transfer function (EOTF⁻¹) to encode the signal back to a non-linear domain.

It is possible to specify the linear step as scene-referred or display-referred. The latter is the default.

By default, the function tries to match the reference white levels between the transfer functions by automatically scaling the linear light values. In the linear range, reference white is generally associated to the normalised value 1.0, peak white might be much higher. This is important to remember when dealing with HDR content, especially when using integer data types which do not allow overflow (normalised values above 1.0). An additional contrast step might be required to fit the content into the desired range, when linear values are used as input or output. Please refer to the curve table below to check the luminance information.

This function is for simple conversions only, it doesn’t do sophisticated tone mapping.

As input, the function accepts only RGB and grayscale colorspaces.

As output, the data type can be changed while the colorspace is kept. Only 16-bit integer and 32-bit float are supported. Use bitdepth to properly convert the output to a lower bitdepth.

The signal may be clipped depending on the transfer specification or the domain requirement of the functions.

The function sets the _ColorRange and _Transfer frame properties.

Avisynth+ Colorspaces with an alpha channel are supported too, but the channel is left untouched.

Parameters

clip

The input clip. Supported input formats:

• 8- to 16-bit integer.
• 32-bit floating point.
• RGB or grayscale.

transs, transd

Transfer characteristics for input and output, respectively. The characteristic may be an OETF, an EOTF, or just remain unspecified. It is direct or inverted according to where it is applied, output or input. The intermediate state is assumed linear light. The curve set is the same as the list in ISO/IEC 23008-2 (HEVC), with a few additions from various camera manufacturers or NLE systems.

Most curves map their value from the 0–1 range to 0–1, but some are for high dynamic range or wide gamut signals and locate their value for peak white much higher. Generally, display-referred linear scales are mapped to a known range in cd/m², whereas scene-referred linear scales are arbitrary.

cont

Optional contrast adjustment to apply to the linear signal. This is a multiplicative value, 1 is neutral. Contrast is modified before the gamma correction. This parameter is useful to match the reference or peak white points between transfer functions which have not the same reference.

gcor

Optional gamma correction to apply to the linear signal. This is a power value, 1 is a bypass. Comes after contrast adjustment. In display-referred mode, the invariant (neutral) point of the correction is the reference white.

bits

Sets the output bitdepth. Currently only 16-bit integer and 32-bit float are supported. The data type is adapted automatically if required. This parameter shouldn’t conflict with flt.

flt

Set it to 0 to convert the output to integer, or to 1 to convert to floating point data.

fulls, fulld

Indicates if the clip is full-range (True) or TV-range (False). fulls is for input, fulld for output. Reference black and white have different values depending on the range. In 8 bits, pixel values scale from 0 to 255 in full range, and 16 to 235 in TV-range (16 to 240 for the Y’Cb’Cr’ chroma planes). This value has no meaning for float data.

logceis, logceid

Exposure index (EI) for the Arri Log C Alexa 2.x and 3.x curves. Allowed values are: 160, 200, 250, 320, 400, 500, 640, 800 (default), 1000, 1280 and 1600.

cpuopt

Limits the CPU instruction set. −1: automatic (no limitation), 0: default instruction set only (depends on the compilation settings), 1: limit to SSE2, 10: limit to AVX2.

blacklvl

This parameter is deprecated, please use lb and lw instead.

Black level value (linear range) for the electro-optical transfer function. It shifts and stretches the transfer curve in order to make the black value in gamma-encoded range match the specified level in linear range. Raising the black level is equivalent to increasing the brightness setting combined with a slight contrast reduction not to alter the white. The parameter should be ≥ 0. There is no specific unit, it’s just a value from the target linear range, generally in 0–1. Internally, it is converted to lb, so it uses lw as reference. If the latter is not specified by the user, it uses 100 cd/m², even if the transfer function is HDR. Ignored when the linear light is scene-referred.

sceneref

Indicates that the linear light step is scene-referred. When set to False, the linear light is display-referred. This helps removing ambiguity when BT.2100 transfer functions (PQ and HLG) are used. Direct or inverse OOTFs are switched as required.

lb

Indicate the black level for the source transfer function, in cd/m². This parameters is taken into account when display-referred transfer functions are used. The EOTF (source) function uses lb as brightness setting.

lw, lws, lwd

Indicate the peak white levels in cd/m². lws is for the source transfer function, and lwd for the destination one. These parameters are taken into account to scale the luminance when the following conditions are met:

• display-referred transfer functions are used,
• match is set to 2 (display luminance matching) and
• the EOTF shouldn’t specify any scale for the luminance (the cd/m² value for F’ = 1.0).

Minimum lw value is 0.1 cd/m². System gamma may be changed according to the lw parameter. Unless specified, HDR functions use a peak white of 1000 cd/m². Similarly, SDR and other functions use 100 cd/m² by default. It is strongly recommended to manually set lw when using the HLG curve, otherwise the automatic L_W estimation could result in something unexpected.

ambient

Default ambient luminance for display-referred transfer functions, in cd/m². This adapts automatically the OOTF system gamma.

match

Selects the luminance matching between the transfer functions.

Display luminance matching is available only for display-referred transfers. It is automatically disabled when sceneref is True. Linear scale in luminance match is at least 100 cd/m², but the exact value is unspecified and depends on the involved transfer functions.

gy

Overrides default gamma processing. When set to False, gamma is applied on each component separately. Processing is fast, but possibly distorts the colors. When set to True, gamma is applied to the luminance only, leaving the colors undistorted. When the parameter is unspecified, the gamma processing is selected depending on the transfer functions. More specifically, the HLG OOTF curve requires applying the gamma on luminance. Other curves use standard gamma processing.

debug

When this parameter is not null, a property is attached to the processed frames. It contains a text string with debugging information about light levels and system gamma used at each stage of the processing. The name of the property is "FmtcTransferDbg" followed with the parameter value, so multiple calls to transfer can be checked simultaneously.

sig_c

Curvature value for the sigmoid curve, in range 0.1–10. You can use the "sigmoid" curve instead of the "linear" one to prevent exagerated ringing when resizing in linear light. This is not a real transfer function but it fits well here in a workflow. The higher the curvature value, the more non-linear the function. The sigmoid curve with its parameters can be visualised here.

sig_t

Inflection point for the sigmoid curve, in range 0–1. The closer to 1, the more the curve looks like a standard power curve.

stack16tonative, nativetostack16

fmtc.stack16tonative (
	clip: clip;
)

fmtc.nativetostack16 (
	clip: clip;
)

Converts between 16-bit clips and stack16 clips. A stack16 clip is a 8-bit clip containing the picture made of the most significant byte of each pixel, stacked on the top of a picture made of their least significant byte. These functions are meant to offer interoperability with Avisynth plug-ins using this format.

Parameters

clip

The input clip. Mandatory. Can be only 8-bit integer for stack16tonative and 16-bit integer for nativetostack16.

IV) Troubleshooting

I’m waiting for your complaints.

V) Changelog

r31, 202x-xx-xx

• resample: fixed 14 to 16 bit AVX2 conversion path, thanks to NSQY for the report.
• transfer: Added L* transfer function.
• transfer: Added Arri LogC4 transfer function.
• primaries: Added Arri Wide Gamut 4 colorspace.
• Program path without x86 SIMD: fixed wrong conversions affecting a lot of functions (noticed on ARM/Apple). Thanks to SaltyChiang for the fix.

r30, 2022-08-29

• matrix: The _ColorRange frame property is now set when a matrix preset is used.
• transfer: Added ACEScct transfer function.
• primaries: Added DCI P3+ and Cinema Gamut presets.
• primaries: Added wconv parameter for full conversion.
• Changed the configure options to compile with Clang.
• Updated datatypes in the examples.

r29, 2022-04-11

• Vapoursynth: switched to API v4. Fmtconv now requires Vapoursynth r55 or later, API v3 is not supported anymore.
• resample: Fixed degnerated cases with invks causing a crash. Thanks to Dogway for the report.
• resample/Avisynth+: fixed frame property writing when only cplaced is defined, thanks to Dogway for the report.
• transfer: Added sigmoid curve as a transfer function.
• transfer: Fixed the float to integer path.

r28, 2021-11-20

• bitdepth: Faster void and cluster pattern generation. Larger patterns are allowed.
• matrix: Added an alias for "fcc"
• primaries: New presets: Free Scale-gamut, DaVinci Wide Gamut, DRAGONcolor, DRAGONcolor2, REDcolor, REDcolor2, REDcolor3, REDcolor4 and REDWideGamutRGB.
• primaries: Fixed Sony P22 primaries.
• primaries: Removed the deprecated "dcip3" alias for "p3d65".
• transfer: Added DaVinci Intermediate, RED Log3G10, REDlog, Cineon and Panalog.
• Vapoursynth and Avisynth+ plug-ins are now contained in the same binary file.

r27, 2021-10-30

• matrix: fixed coefficient errors when using singleout.
• primaries: added Sony P22 primaries.
• transfer: better selection between linear and logarithmic input for LUTs, LUT size reduced.
• transfer: fixed crash with grey colorspace. Thanks to vxzms for the report.

r26, 2021-10-19

• matrix: fixed the output colorspace when using singleout.
• matrix: fixed the output colorspace when using a custom matrix. Thanks to vxzms for the report.
• matrix/Vapoursynth: _Matrix and _ColorSpace frame properties are actually deleted when a custom matrix is used or the final colorspace is unknown. Thanks to mysteryx93 for the report.
• resample: fixed empty custom impulse that could cause a crash.
• resample: added top-left chroma location.
• resample/Avisynth+: interlacing detection now uses the global stream information when the frame properties are not available.
• resample/Avisynth+: fixed the planes parameter.
• transfer: Linear light can now be display- or scene-referred. Added sceneref, lw, lws, lwd, lb, ambiant and deprecated blacklvl.
• transfer: By default, automatically matches the reference white levels for source and destination transfer curves. This may cause some backward incompatibilities. match parameter added.
• transfer: Removed the planes parameter introduced in r24 because planes are no longer independent of each other.
• transfer: debug provides information about the transfer operation and levels as a frame property.
• transfer: BT.470M characteristic is now a pure power curve, instead of a copy of the sRGB curve.
• transfer/Avisynth+: fixed flt + bits combination that was ignored. Thanks to DTL for the report.
• transfer/Avisynth+: fixed case sensitivity to transs and transd.
• transfer/Vapoursynth: fixed logceis and logceid that were missing from the function registration since their introduction in r23… Thanks to groucho86 for the report.
• Fixed compatibility with Avisynth+ 3.7.1.
• Avisynth+: fixed "RGBPxx" colorspace values that weren’t correctly interpreted as planar.

r25, 2021-09-19

• bitdepth/Avisynth+: fixed I420 input that couldn’t be converted to higher bitdepth. Thanks to StvG for the report.
• matrix: fixed the output colorspace autodetection which failed with specific matrix combinations.
• resample/Avisynth+: fixed fulls and fulld parameters which were wrongly defined as int instead of bool.
• resample/Avisynth+: fixed cplaced which was wrongly copied from cplaces. Thanks to TbtBI for the report.
• transfer: automatically adapts the output format (16-bit integer) if the input is a low-bitdepth clip and nothing is specified in bits nor flt, instead of emitting an error.
• transfer: fixed the BT.2100 HLG curve that was inverted.
• transfer: fixed the sRGB curve linear part and extended its positive range. Thanks to poisondeathray for the report.
• Avisynth+: fixed a crash occuring when using data bitdepths between 9 and 14. Thanks to tormento for the report.

r24, 2021-08-16

• bitdepth: added dithering mode 9: quasirandom sequences.
• bitdepth: added a triangular probability distribution function (TPDF) for the dithering patterns and noises, along with the associated parameters tpdfo and tpdfn.
• bitdepth: added corplane parameter to prevent colored noise in RGB processing.
• bitdepth: fixed crash when trying to change the range (full or TV) without reducing the bitdepth.
• matrix: deletes the _Matrix and _ColorSpace properties if a non-standard matrix is used.
• matrix2020cl: sets the _Matrix and _Transfer frame properties.
• matrix2020cl: fixed hideous colors when converting slightly out-of-colorspace values from integer Y’Cb’Cr’ to integer linear RGB.
• resample: totalh and totalv are now correctly taken into account, added total parameter too.
• resample: added a planes parameter.
• transfer: sYCC curve (similar to sRGB) now supports signed values.
• transfer: added a planes parameter.
• Added support for Avisynth+
• Added information on functions reading and writing frame properties.
• Added support for 14-bit data.
• Vapoursynth: still uses API v3.6 but can use Python constants from API v4.0.

r23, 2021-07-14

• transfer: added an Exposure Index (EI) parameter for the Arri Log C Alexa 2.x and 3.x curves.
• bitdepth: properly sets the _ColorRange attribute.
• Doesn’t output a debug message when AVSTP is not found.
• Fixed a concurrency issue by using a more recent toolkit when compiling with MSVC.
• Windows XP is not supported any more.

r22, 2019-12-11

• bitdepth: upconversions for full range data now scale to the maximum value instead of shifting bits. Thanks to Z4ST1N for the report.
• matrix: added support for the Y’D’_ZD’_X, IC_TC_P-PQ and IC_TC_P-HLG colorspaces.
• matrix: fixed a case issue for matrix identifiers.
• primaries: added support for P3-DCI, P3-D65 and P3-D60. The old DCI-P3 was actually P3-D65. The code "dcip3" remains for backward compatibility but is deprecated.
• primaries: added support for the EBU 3213-E colorspace.
• primaries: added a "2100" alias for the BT.2020/BT.2100 colorspace.
• primaries: fixed a divide-by-0 crash when using CIEXYZ as destination colorspace
• primaries: fixed a bug preventing to use the "uhdtv" string for BT.2020 primaries
• transfer: added support for hybrid log-gamma (HLG) curves.
• transfer: for the SMPTE SM 2084 curve, the specific value of 0 now gives a true 0 in both directions (minor change).
• transfer: BT.2020 curve for 12-bit data now uses exact values giving a continuous derivative (minor change).
• transfer: now uses more accurate constants for the sRGB curve, giving a better derivative continuity (minor change).
• transfer: fixed a bug with the alternate formula for BT.1886 curve.
• Should now build correctly on FreeBSD (patch by jbeich)
• Fixed compilation for Linux on ARM or aarch64. Binaries not tested yet.

r21, 2019-12-08

• transfer: fixed highlight clipping for several high dynamic range transfer curves, thanks to groucho86 for the report.

r20, 2016-03-25

• primaries: fixed a bug preventing to set all primaries individually without specifying any preset.
• primaries: fixed a bug in the color conversion, thanks to J1Man for having spotted it.

r19, 2016-03-19

• primaries: refined the values for the Adobe Wide gamut and BT.2020 primaries.
• primaries: added DCI-P3, ACES AP0/AP1, S-Gamut, S-Gamut3.Cine, ALEXA and V-Gamut presets.
• transfer: added ACEScc, ERIMM, S-Log2, S-Log3 and V-Log curves.

r18, 2016-03-08

• Added the primaries function to convert between gamuts.
• The “full” range is now closer to what is specified in the standards.
• A recent Vapoursynth is now required because API headers were updated to version 3.1.4.
• transfer: added the Adobe RGB and ProPhoto / ROMM curves.

r17, 2015-07-08

• bitdepth: added “Void and cluster” dithering method and its patsize parameter.
• bitdepth: added floating point implementation for the Ostromoukhov dithering
• bitdepth: added SSE2 optimizations for halftone modes (0, 1 and 8).
• bitdepth: fixed incorrect conversion from float to 8-bit integer using the “fast” modes with SSE2 instruction set.

r16, 2015-07-01

• bitdepth: added support for 11-bit and 14-bit integer input.
• bitdepth: fixed a slight plane inconsistency when dithering grey multi-plane pictures using an error diffusion algorithm.
• matrix2020cl: added SSE2 optimisations for the floating point path.
• resample: sx, sy, sw and sh parameters passed as arrays are now correctly taken into account. Thanks to mawen1250 for the bug report.
• transfer: added the blacklvl parameter.

r15, 2015-05-22

• resample and bitdepth: fixed a bug creating dark lines or weird patterns. Was introduced in r13 while trying to fix the buffer overflow problem. Thanks to feisty2 for spotting it.
• resample: fixed the non-SIMD code path, causing crashes.

r14, 2015-05-20

• matrix: fixed a bug introducing wrong offsets in custom matrix coefficients, thanks to mawen1250 for the report.

r13, 2015-05-18

• matrix: optimized the SSE2 and AVX2 paths for integer data.
• Added cpuopt to some functions, to manually limit the instruction set optimizations.
• Added build files for the unix-like systems, thanks to jackoneill.
• Fixed a buffer overflow bug in the SSE2 and AVX2 code of bitdepth and resample, thanks to jackoneill for reporting it.
• Removed the int16tofloat and floattoint16 temporary functions.

r12, 2015-05-08

• resample: fixed a crash in the AVX2 code path, thanks to HolyWu for spotting it.

r11, 2015-05-07

• transfer: fixed a bug in the SSE2 code path.

r10, 2015-05-06

• fmtconv is compatible with the older Vapoursynth versions again until API 3.2 is out.
• Source code: fixed compilation problems.

r9, 2015-05-06

• Added the transfer function.
• resample: Most kernel-related parameters are now arrays, allowing to specify different values for each plane.
• resample: Allows horizontal and vertical values for taps and invkstap.
• resample: AVX2 optimizations.
• matrix: Tries to deduce the target colorspace from simple matrix settings, sets the new _Matrix frame property, AVX2 optimizations.
• bitdepth: SSE2 optimizations for the “fast” algorithm.

r8, 2013-11-30

• resample: Fixed bugs introduced in r7.
• Fixed a range conversion issue in “plane copy” modes with source and destination formats are the same.

r7, 2013-11-27

• 64-bit windows version.
• resample: A few optimizations for special cases.
• resample: fixed the coefficients used in integer resizing, whose sum was sometimes off by a few units.

r6, 2013-08-24

• matrix: single-plane output now works correctly.

r5, 2013-08-18

• Added 12-bit support for all the functions.
• Added matrix2020cl to convert between linear RGB and Y’Cb’Cr’ colorspaces using the BT.2020 constant luminance matrix.
• matrix: Added the BT.2020 matrix, non constant luminance mode only.
• matrix: Added single-plane output with the singleout parameter.
• resample: allows x:y:z form for specifying the colorspace subsampling css.
• resample: added SSE2 integer calculations for slight speed improvement. Activated by default, use flt=1 to compute everything in float (previous operating mode).

r4, 2012-12-09

• Added a documentation.
• Filters now write some frame properties when known.
• Fixed the code so it can be compiled on Linux. Thanks to Jackoneill/Nodame for testing.
• bitdepth: no need to specify any bitdepth or colorspace (for simple range conversions).
• matrix: Added SSE2 implementation for integer processing.
• matrix: Allows the destination bitdepth to be higher than the input (added the bits parameter).
• matrix: col_fam completes csp instead of replacing it.
• resample: Added interlacedd to specify if output is interlaced (allows simple bobbing).
• resample: Added tff and tffd to specify field parity.
• resample: Added scale, scaleh and scalev for easier magnification.
• resample: Added a two-digit mode to css.
• resample: Fixed a typo preventing to select 4:1:1 chroma subsampling.
• Added nativetostack16.

r3, 2012-11-23

• bitdepth: changed the bitdepth parameter to bits.
• bitdepth: added SSE2 optimizations for upconversions.
• resample: added interlaced resizing (interlaced parameter).
• resample: now sets _ColorRange and _ChromaLocation properties when known.
• resample: fixed the planes parameter previously interpreted as 0 (black or green screen).

r2, 2012-11-18

• bitdepth: implemented fast dither mode (but not in SSE2 yet).
• bitdepth: optimized float-to-integer path.
• bitdepth: faster dithering when ampo = 1 and ampn = 0.
• matrix: enabled the SSE path for float operations.
• resample: optimized paths involving float input or output.
• resample: fixed white/magenta screen with 8-bit input and float output.

r1, 2012-11-16

• Initial release.