ConvertBits

AVS+
This feature is specific to AviSynthPlus. It is not supported in other AviSynth versions.

ConvertBits

Changes bit depth while keeping color format the same, if possible.
If the conversion is not possible – for example, converting RGB32 to 14bit – an error is raised.

ConvertBits(clip, int bits [, bool truerange, int dither, int dither_bits, bool fulls, bool fulld ] )

(older bit-depth conversion filters – deprecated)

ConvertToFloat(clip, int bits [, bool truerange, int dither, int dither_bits, bool fulls, bool fulld ] )
ConvertTo16bit(clip, int bits [, bool truerange, int dither, int dither_bits, bool fulls, bool fulld ] )
ConvertTo8bit(clip, int bits [, bool truerange, int dither, int dither_bits, bool fulls, bool fulld ] )

clip   = (required)

Source clip.

bits   = (required)

Bit depth of output clip. Valid values: 8, 10, 12, 14, 16 (integer) or 32 (floating point).

bool  truerange = true

When converting from true 10-16 bit formats, truerange=false indicates bitdepth of 16 bits regardless of the 10-12-14 bit format. Not applicable for non planar formats.

int  dither = -1

• If -1 (default), do not add dither;
• If 0, add ordered dither;
• If 1, add error diffusion (Floyd-Steinberg) dither ^doom9

Dithering is allowed only for scaling down (bit depth reduction), not up.

Dithering is allowed only for 10-16bit (not 32bit float) sources.

int  dither_bits = bits

Exaggerated dither effect: dither to a lower color depth than required by bits argument.

Has no effect if dither=-1 (off).

• Must be an even number from 2 to bits, inclusive.
• In addition, must be >= (clip.BitsPerComponent-8).

Examples

Conversion	Allowed Values
16 → 12bit	8, 10, 12
16 → 10bit	8, 10
16 →   8bit	8
14 → 10bit	6, 8, 10
14 →   8bit	6, 8
12 → 10bit	4, 6, 8, 10
12 →   8bit	4, 6, 8
10 →   8bit	2, 4, 6, 8

bool  fulls = (auto)

Use the default value unless you know what you are doing.

If true (RGB default), scale by multiplication: 0-255 → 0-65535;

if false (YUV default), scale by bit-shifting.

Use case: override greyscale conversion to fullscale instead of bit-shifts.

Conversion from and to float is always full-scale.

Alpha plane is always treated as full scale.

bool  fulld = fulls

Use the default value unless you know what you are doing.

At the moment, must match fulls.

Changes

20170310 r2440	parameter dither_bits
20170202 r2420	parameters fulls, fulld