I'm confused by the convertbits Wiki page:
Code:
bool truerange = true
Use the default value unless you know what you are doing.
(TODO if false, seems to either do nothing or corrupt output)
Only allowed with Planar color formats.
If true (default), convert 10-16 bit formats without re-scaling underlying pixel data. For example,
clip10bit.ConvertBits(16, truerange=false)
will leave pixel data in the 0..1023 range, but will change the color format from YUVxxxP10 to YUVxxxP16.
It says
true will
not "re-scale underlying pixel data" but then says
false will leave pixel data in the original 10-bit range. Is this a mistake, or ambiguous terminology?
I'd also argue that "truerange" is not a good name for the parameter anyway, as it gives little hint as to what it does, either as false or true.