Version History¶

VSUtil. A collection of general-purpose VapourSynth functions to be reused in modules and scripts.

0.7.0¶

New functions:
- resolve_enum() added to public API (previously a private function used internally).
- get_lowest_value(), get_neutral_value(), and get_peak_value() for relevant min/median/max float values based on sample-type and bit depth.
Changes to existing functions:
- Deprecated enforce_cache parameter of frame2clip().

Split single __init__.py file into submodules.
New functions:
- scale_value() added to scale values for bit depth, sample type, or range conversion.

New functions:
- disallow_variable_format() and disallow_variable_resolution() function decorators added that raise exceptions on variable-format or variable-res clips. Helpful for functions that assume the input clip’s format is a valid vapoursynth.Format instance.
Changes to existing functions:
- Removed functools.reduce usage in iterate(), fixing type-hinting and disallowing negative count.
- Dithering logic in depth() is now handled in a separate private function.
Bug fixes:
- Will no longer dither for 8-bit full-range to 16-bit full-range conversions in depth().

Now uses Python 3.8 positional-only arguments (see PEP 570 for more information):
- get_subsampling() clip parameter
- get_depth() clip parameter
- get_plane_size() frame parameter
- insert_clip() clip parameter
- plane() clip and planeno parameters
- get_y() clip parameter
- split() clip parameter
- frame2clip() frame parameter
- is_image() filename parameter
New classes:
- Dither and Range enumerations added to simpliy range, range_in, and dither_type arguments to vapoursynth.core.resize.
New functions:
- Added a bit depth converter, depth(), that automatically handles dithering and format changes.
Changes to existing functions:
- get_subsampling() now returns None for formats without subsampling (i.e. RGB).
- get_w() only_even parameter changed to keyword-only argument.

Changes to existing functions:
- Added enforce_cache parameter to frame2clip().