Version History

.. automodule:: vsutil
   :noindex:

0.7.0

New functions:
- :func:`resolve_enum` added to public API (previously a private function used internally).
- :func:`get_lowest_value`, :func:`get_neutral_value`, and :func:`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 :func:`frame2clip`.

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

New functions:
- :func:`disallow_variable_format` and :func:`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 :func:`iterate`, fixing type-hinting and disallowing negative count.
- Dithering logic in :func:`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 :func:`depth`.

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

Changes to existing functions:
- Added enforce_cache parameter to :func:`frame2clip`.