ConvertBits - Revision history

FranceBB: /* ConvertBits */

2023-12-03T02:02:12Z

‎ConvertBits

Pinterf: /* Changes */ fix table formatting

2021-12-09T14:28:50Z

‎Changes: fix table formatting

Pinterf: /* Changes */ 3.7.1

2021-12-09T14:26:49Z

‎Changes: 3.7.1

Pinterf: /* ConvertBits */ bit parameter made optional

2021-12-09T14:23:55Z

‎ConvertBits: bit parameter made optional

Pinterf: /* ConvertBits */ 3.7.1. changes, allowed parameters, frame props

2021-12-09T14:16:18Z

‎ConvertBits: 3.7.1. changes, allowed parameters, frame props

Raffriff42: add link

2018-04-01T18:32:04Z

add link

Raffriff42: dither update

2018-04-01T18:02:30Z

dither update

Pinterf: /* ConvertBits */ bad conversion example to 14bits

2018-03-05T12:03:34Z

‎ConvertBits: bad conversion example to 14bits

Raffriff42: update for AVS+ r2632 cont'd TODO: fulls, fulld

2018-03-05T01:34:45Z

update for AVS+ r2632 cont'd TODO: fulls, fulld

Raffriff42: update for AVS+ r2632

2018-03-05T01:30:23Z

update for AVS+ r2632

@@ Line 41: / Line 41: @@
 ::*If ''1'', add [[wikipedia:Floyd–Steinberg_dithering|error diffusion (Floyd-Steinberg)]] dither <sup>[http://forum.doom9.org/showthread.php?p=1838145#post1838145 doom9]</sup>
 ::Dithering is allowed only for scaling down (bit depth reduction), not up. Bit depth can be kept though if a smaller dither_bits is given.
-::From 3.7.1: no limit. Note: (behind the scenese) 32 bit float clips are first converted down to 16 (or less if needed) bits, then are further dithered down from this intermediate clip.
+::From 3.7.1: no limit. Note: (behind the scenes) 32 bit float clips are first converted down to 16 (or less if needed) bits, then are further dithered down from this intermediate clip.
 ::<3.7.1: Dithering is allowed only for 10-16bit (not 32bit float) sources.

@@ Line 112: / Line 112: @@
 |-
 | 3.7.1
-| parameter ''bits'' optional
+|parameter ''bits'' optional
-| _ChromaRange frame property handling
+<p>_ChromaRange frame property handling</p>
-| Free fulls-fulld combination
+<p>Free fulls-fulld combination</p>
-| Free target dither_bits down to 1
+<p>Free target dither_bits down to 1</p>
-| Allow dithering from 32 bit float
+<p>Allow dithering from 32 bit float</p>
-| Allow dithering while keeping actual bit depth (but with a smaller dither_bits)
+<p>Allow dithering while keeping actual bit depth (but with a smaller dither_bits)</p>
-| Specially handled full scale chroma
+<p>Specially handled full scale chroma</p>
 |-
 | 20170310 r2440

@@ Line 110: / Line 110: @@
 ==== Changes ====
 {|border=1 cellspacing=1 cellpadding=4
 |-
 | 20170310 r2440

@@ Line 26: / Line 26: @@
 ::Source clip.
-:{{Par2||bits|(required)}}
+:{{Par2|bits|int|(actual bit depth)}}
-::Bit depth of output clip. Valid values: ''8'', ''10'', ''12'', ''14'', ''16'' (integer) or ''32'' (floating point).
+::Bit depth of output clip. If provided valid values are: ''8'', ''10'', ''12'', ''14'', ''16'' (integer) or ''32'' (floating point).
 :{{Par2|truerange|bool|true}}
@@ Line 39: / Line 41: @@
 ::*If ''1'', add [[wikipedia:Floyd–Steinberg_dithering|error diffusion (Floyd-Steinberg)]] dither <sup>[http://forum.doom9.org/showthread.php?p=1838145#post1838145 doom9]</sup>
 ::Dithering is allowed only for scaling down (bit depth reduction), not up. Bit depth can be kept though if a smaller dither_bits is given.
 ::From 3.7.1: no limit. Note: (behind the scenese) 32 bit float clips are first converted down to 16 (or less if needed) bits, then are further dithered down from this intermediate clip.
 :{{Par2|dither_bits|int|{{Template:FuncArg|bits}}}}
@@ Line 46: / Line 48: @@
 ::Has no effect if {{FuncArg|dither}}=''-1'' (off).
 ::* from 3.7.1 Arbitrary number from 1 to {{FuncArg|bits}}, inclusive.
-::* until 3.7.1: Must be an even number from ''2'' to {{FuncArg|bits}}, inclusive.
+::* <3.7.1: Must be an even number from ''2'' to {{FuncArg|bits}}, inclusive.
-::* until 3.7.1: In addition, must be >= ({{FuncArg|clip}}.[[Clip_properties#Color_Format|BitsPerComponent]]-8).
+::* <3.7.1: In addition, must be >= ({{FuncArg|clip}}.[[Clip_properties#Color_Format|BitsPerComponent]]-8).
 :{{Par2|fulls|bool|(auto)}}
 ::''Use the default value unless you know what you are doing.''
@@ Line 60: / Line 62: @@
 ::''Use the default value unless you know what you are doing.''
 ::From 3.7.1: can be any combination with {{FuncArg|fulls}}.
-::Until 3.7.1: ''must'' match {{FuncArg|fulls}}.
+::<3.7.1: ''must'' match {{FuncArg|fulls}}.

@@ Line 30: / Line 30: @@
 :{{Par2|truerange|bool|true}}
 ::When converting from true 10-16 bit formats, {{FuncArg|truerange}}=false indicates bitdepth of 16 bits regardless of the 10-12-14 bit format. Not applicable for non planar formats.
@@ Line 37: / Line 38: @@
 ::*If ''0'', add [[Ordered_dithering|ordered]] dither;
 ::*If ''1'', add [[wikipedia:Floyd–Steinberg_dithering|error diffusion (Floyd-Steinberg)]] dither <sup>[http://forum.doom9.org/showthread.php?p=1838145#post1838145 doom9]</sup>
-::Dithering is allowed only for scaling down (bit depth reduction), not up.
+::Dithering is allowed only for scaling down (bit depth reduction), not up. Bit depth can be kept though if a smaller dither_bits is given.
-::Dithering is allowed only for 10-16bit (not 32bit float) sources.
+::Until 3.7.1: Dithering is allowed only for 10-16bit (not 32bit float) sources.
 :{{Par2|dither_bits|int|{{Template:FuncArg|bits}}}}
 ::Exaggerated dither effect: dither to a lower color depth than required by {{FuncArg|bits}} argument.
 ::Has no effect if {{FuncArg|dither}}=''-1'' (off).
-::* Must be an even number from ''2'' to {{FuncArg|bits}}, inclusive.
+::* from 3.7.1 Arbitrary number from 1 to {{FuncArg|bits}}, inclusive.
-::* In addition, must be >= ({{FuncArg|clip}}.[[Clip_properties#Color_Format|BitsPerComponent]]-8).
+::* until 3.7.1: Must be an even number from ''2'' to {{FuncArg|bits}}, inclusive.
-:::{| class="wikitable"
+::* until 3.7.1: In addition, must be >= ({{FuncArg|clip}}.[[Clip_properties#Color_Format|BitsPerComponent]]-8).
-|+ style="text-align:left"|''Examples''
-!Conversion&nbsp;&nbsp;
-!Allowed Values&nbsp;
-|-
-|16 &rarr; 12bit
-|8, 10, 12
-|-
-|16 &rarr; 10bit
-|8, 10
-|-
-|16 &rarr; &nbsp;&nbsp;8bit
-|8
-|-
-|14 &rarr; 10bit
-|6, 8, 10
-|-
-|14 &rarr; &nbsp;&nbsp;8bit
-|6, 8
-|-
-|12 &rarr; 10bit
-|4, 6, 8, 10
-|-
-|12 &rarr; &nbsp;&nbsp;8bit
-|4, 6, 8
-|-
-|10 &rarr; &nbsp;&nbsp;8bit
-|2, 4, 6, 8
-|}
-−
 :{{Par2|fulls|bool|(auto)}}
 ::''Use the default value unless you know what you are doing.''
-::If ''true'' (RGB default), scale by multiplication: 0-255 &rarr; 0-65535;
+::Default value can come from <code>_ChromaRange</code> frame property
 ::if ''false'' (YUV default), scale by [[wikipedia:Arithmetic_shift|bit-shifting]].
 ::Use case: override greyscale conversion to fullscale instead of bit-shifts.
@@ Line 85: / Line 59: @@
 :{{Par2|fulld|bool|{{Template:FuncArg|fulls}}}}
 ::''Use the default value unless you know what you are doing.''
-::At the moment, ''must'' match {{FuncArg|fulls}}.
+::From 3.7.1: can be any combination with {{FuncArg|fulls}}.
 <!--

@@ Line 35: / Line 35: @@
 :{{Par2|dither|int|-1}}
 ::*If ''-1'' (default), do not add dither;
-::*If ''0'', add [[Ordered_dithering|ordered dither]];
+::*If ''0'', add [[Ordered_dithering|ordered]] dither;
-::*If ''1'', add [[wikipedia:Floyd–Steinberg_dithering|error diffusion (Floyd-Steinberg) dither]]
+::*If ''1'', add [[wikipedia:Floyd–Steinberg_dithering|error diffusion (Floyd-Steinberg)]] dither <sup>[http://forum.doom9.org/showthread.php?p=1838145#post1838145 doom9]</sup>
 ::Dithering is allowed only for scaling down (bit depth reduction), not up.
 ::Dithering is allowed only for 10-16bit (not 32bit float) sources.

@@ Line 8: / Line 8: @@
 ==== ConvertBits ====
 Changes bit depth while keeping [[Avisynthplus_color_formats|color format]] the same, if possible. <br>
-If the conversion is not possible &ndash; for example, converting [[RGB32]] to 16bit &ndash; an error is raised.
+If the conversion is not possible &ndash; for example, converting [[RGB32]] to 14bit &ndash; an error is raised.

@@ Line 12: / Line 12: @@
 {{FuncDef
-|ConvertBits(clip, int bits [, bool ''truerange'', int ''dither'', float ''scale'', int ''dither_bits'', bool ''fulls'', bool ''fulld'' ] )}}
+|ConvertBits(clip, int bits [, bool ''truerange'', int ''dither'', int ''dither_bits'', bool ''fulls'', bool ''fulld'' ] )}}
@@ Line 18: / Line 18: @@
 {{Func3Def
-|ConvertToFloat(clip, int bits [, bool ''truerange'', int ''dither'', float ''scale'', int ''dither_bits'', bool ''fulls'', bool ''fulld'' ] )
+|ConvertToFloat(clip, int bits [, bool ''truerange'', int ''dither'', int ''dither_bits'', bool ''fulls'', bool ''fulld'' ] )
-|ConvertTo16bit(clip, int bits [, bool ''truerange'', int ''dither'', float ''scale'', 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'', float ''scale'', int ''dither_bits'', bool ''fulls'', bool ''fulld'' ] )}}
+|ConvertTo8bit(clip, int bits [, bool ''truerange'', int ''dither'', int ''dither_bits'', bool ''fulls'', bool ''fulld'' ] )}}
@@ Line 30: / Line 30: @@
 :{{Par2|truerange|bool|true}}
-::'''''Deprecated &ndash; use the default value.'''''
+::''Deprecated &ndash; use the default value.''
 {{HiddenAnchor|dither}}
@@ Line 37: / Line 37: @@
 ::Dithering is allowed only for scaling down (bit depth reduction), not up.
 ::Dithering is allowed only for 10-16bit (not 32bit float) sources.
 :{{Par2|dither_bits|int|{{Template:FuncArg|bits}}}}
@@ Line 77: / Line 74: @@
 :{{Par2|fulls|bool|(auto)}}
-::'''''Use the default value unless you know what you are doing.'''''
+::''Use the default value unless you know what you are doing.''
 ::If ''true'' (RGB default), scale by multiplication: 0-255 &rarr; 0-65535;
 ::if ''false'' (YUV default), scale by [[wikipedia:Arithmetic_shift|bit-shifting]].
@@ Line 85: / Line 82: @@
 :{{Par2|fulld|bool|{{Template:FuncArg|fulls}}}}
-::'''''Use the default value unless you know what you are doing.'''''
+::''Use the default value unless you know what you are doing.''
 ::At the moment, ''must'' match {{FuncArg|fulls}}.