soifunc 0.11.1__py3-none-any.whl → 0.11.2__py3-none-any.whl

soifunc/deband.py

@@ -15,6 +15,9 @@ def retinex_deband(
     showmask: bool = False,
 ) -> vs.VideoNode:
     """
+    Debanding using a contrast-adaptive edge mask to preserve details
+    even in dark areas.
+    
     "medium" `threshold` in f3kdb is 48. I think that's a bit strong.
     16 might be a more sane starting point. Increase as needed.
 

soifunc/denoise.py

@@ -18,6 +18,7 @@ def hqbm3d(
     """
     High-quality presets for motion compensated denoising.
     Uses BM3D for luma and nl_means for chroma.
+    This is a good denoiser for preserving detail on high-quality sources.
 
     Sane strength values will typically be below 1.0.
     """
@@ -48,12 +49,13 @@ def mc_dfttest(
     """
     A motion-compensated denoiser using DFTTEST.
     Even at the default `thSAD` of 75, it works well at eliminating noise.
-    Turn it up to 150 if you really need to nuke something.
-    It does an *okay* job at preserving details, but not nearly as good
-    as bm3d, so this is not recommended on clean, high quality sources.
+    Turn it up to 150 or more if you really need to nuke something.
+    It does a decent job at preserving details, but not nearly as good
+    as bm3d, so this is not recommended on clean, high-quality sources.
 
-    The `noisy` parameter helps preserve more detail on high-quality but grainy sources,
-    but is slower.
+    The `noisy` parameter did help preserve more detail on high-quality but grainy sources.
+    Currently it is deprecated, as the presets in `vsdenoise` changed,
+    but it may be un-deprecated in the future.
     """
     # TODO: Do we need to tweak anything for the `noisy` param?
     blksize = select_block_size(clip)

soifunc/resize.py

@@ -11,7 +11,7 @@ from vskernels import (
     ScalerLike,
     Spline36,
 )
-from vsscale import SSIM, ArtCNN, GenericScaler
+from vsscale import ArtCNN, GenericScaler
 from vstools import check_variable_format, inject_self, is_gpu_available, join, vs
 
 __all__ = [
@@ -53,18 +53,14 @@ def good_resize(
 
     is_upscale = clip.width < width or clip.height < height
     chroma_scaler = Spline36()
-    if anime:
-        if is_upscale:
-            if gpu:
-                luma_scaler = ArtCNN()
-            else:
-                luma_scaler = NNEDI3(scaler=Hermite(sigmoid=True))
-        else:
-            luma_scaler = Hermite(sigmoid=True)
+
+    # We've ended up where the only special case is anime + upscale + GPU enabled
+    if anime and is_upscale and gpu:
+        luma_scaler = ArtCNN(scaler=Hermite(sigmoid=True))
     elif is_upscale:
-        luma_scaler = NNEDI3(scaler=SSIM())
+        luma_scaler = NNEDI3(scaler=Hermite(sigmoid=True))
     else:
-        luma_scaler = SSIM()
+        luma_scaler = Hermite(sigmoid=True)
 
     return HybridScaler(luma_scaler, chroma_scaler).scale(
         clip, width, height, shift=shift

soifunc-0.11.2.dist-info/METADATA

@@ -0,0 +1,50 @@
+Metadata-Version: 2.3
+Name: soifunc
+Version: 0.11.2
+Summary: Soichiro's VapourSynth Functions Collection
+License: MIT
+Author: Josh Holmer
+Author-email: jholmer.in@gmail.com
+Requires-Python: >=3.12,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: vapoursynth (>=68)
+Requires-Dist: vsjetpack (>=0.5.1,<0.6.0)
+Description-Content-Type: text/markdown
+
+## soifunc
+
+Vapoursynth scripts that might be useful to someone
+
+### Installation
+
+#### Arch Linux
+
+Install from [AUR](https://aur.archlinux.org/packages/vapoursynth-plugin-soifunc-git)
+
+#### Other
+
+First install the required plugins which are not available in pip:
+
+- [neo_f3kdb](https://github.com/HomeOfAviSynthPlusEvolution/neo_f3kdb)
+- [znedi3](https://github.com/sekrit-twc/znedi3)
+- [nnedi3_resample](https://github.com/HomeOfVapourSynthEvolution/nnedi3_resample)
+
+Install from pip:
+
+```bash
+pip install soifunc
+```
+
+Or the latest git version:
+
+```bash
+pip install git+https://github.com/shssoichiro/soifunc.git
+```
+
+### Usage
+
+Please see the inline codedoc comments for usage details.
+

soifunc-0.11.2.dist-info/RECORD

@@ -0,0 +1,10 @@
+soifunc/__init__.py,sha256=H6BWoCLRW2ZD47wQtL72SIZvTpD6REH7cUqIYWvCn0k,174
+soifunc/deband.py,sha256=MbI5OOG8JpWqM5B5ux6OU784-39PtCMQWrh9mk4k2xY,1273
+soifunc/denoise.py,sha256=ALTftqL9Q1cPLKtAU60mT3-RUkVHXBqgg2Pa9GwjGIY,6982
+soifunc/interpolate.py,sha256=MNpYyO037H00vqA5d-WijeBd475oMssEvFLGXgeXPxw,4400
+soifunc/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+soifunc/resize.py,sha256=jr1kLU8IrXcLphjkhcXhls1HjhIKiryD8n6Kvwe1DU4,2988
+soifunc-0.11.2.dist-info/LICENSE,sha256=vgEDSMEV1J2nMiCgXE5_sjNtw2VT7_lP7rkAnrFKOWI,1068
+soifunc-0.11.2.dist-info/METADATA,sha256=1u10t9uHSCroEByTObR45ceT88YjOqtW28dHejnV1e0,1214
+soifunc-0.11.2.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+soifunc-0.11.2.dist-info/RECORD,,

soifunc-0.11.1.dist-info/METADATA

@@ -1,116 +0,0 @@
-Metadata-Version: 2.3
-Name: soifunc
-Version: 0.11.1
-Summary: Soichiro's VapourSynth Functions Collection
-License: MIT
-Author: Josh Holmer
-Author-email: jholmer.in@gmail.com
-Requires-Python: >=3.12,<4.0
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: vapoursynth (>=68)
-Requires-Dist: vsjetpack (>=0.5.1,<0.6.0)
-Description-Content-Type: text/markdown
-
-## soifunc
-
-Vapoursynth scripts that might be useful to someone
-
-### Installation
-
-#### Arch Linux
-
-Install from [AUR](https://aur.archlinux.org/packages/vapoursynth-plugin-soifunc-git)
-
-#### Other
-
-First install the required plugins which are not available in pip:
-
-- [neo_f3kdb](https://github.com/HomeOfAviSynthPlusEvolution/neo_f3kdb)
-- [znedi3](https://github.com/sekrit-twc/znedi3)
-- [nnedi3_resample](https://github.com/HomeOfVapourSynthEvolution/nnedi3_resample)
-
-Install from pip:
-
-```bash
-pip install soifunc
-```
-
-Or the latest git version:
-
-```bash
-pip install git+https://github.com/shssoichiro/soifunc.git
-```
-
-### Usage
-
-Any of the functions will require an `import soifunc` prior to where they are used.
-
-#### good_resize
-
-`clip = soifunc.good_resize(clip, 1920, 1080)`
-
-Resizes a clip to the specified dimensions using a high quality method.
-
-For upscaling, luma is resized using `nnedi3_resample`.
-
-For downscaling, luma is resized using `SSIM_downsample`.
-
-Chroma is always resized using `Spline36`.
-
-**If this filter causes your video to produce a blank output**, see this issue: https://github.com/HomeOfVapourSynthEvolution/VapourSynth-TCanny/issues/14
-
-Additional Params:
-
-- `gpu`: Whether to use the OpenCL version of supported dependencies. Defaults to auto-detect.
-
-#### retinex_deband
-
-`clip = soifunc.retinex_deband(clip, threshold = 16 [, showmask = False])`
-
-High quality debanding using a retinex mask, designed to preserve details in both light and dark areas.
-
-`threshold` controls debanding strength. `16` is a reasonable starting point. Increase as needed until satisfied.
-
-`showmask` is an optional debugging parameter, setting this to `True` will output the mask that will be used to preserve edges.
-
-Note that this debander does not automatically add grain.
-If you need to add grain before encoding, use `vsdeband.AddNoise`.
-If you're using AV1 grain synthesis, you _do not_ need to add grain before encoding.
-
-#### MCDenoise
-
-Applies motion compensation to a denoised clip to improve detail preservation.
-Credit to Clybius for creating this code.
-
-Example usage:
-
-```python
-import soifunc
-import dfttest2
-import functools    # functools is built in to python
-denoiser = functools.partial(dfttest2.DFTTest, sigma=1.5, backend=dfttest2.Backend.CPU)
-clip = soifunc.MCDenoise(clip, denoiser)
-```
-
-Params:
-
-- `denoiser`: A function defining how to denoise the motion-compensated frames.
-  Denoiser params can be added using `functools.partial`.
-- `prefilter`: An optional prefiltered input clip to enable better searching for motion vectors
-
-
-#### MagicDenoise
-
-Clybius's magic denoise function.
-
-Uses dark magic to denoise heavy grain from videos.
-Zero parameters, only magic.
-
-Params:
-
-- `clip`: The input video to apply deinterlacing to
-- `gpu`: Whether to use the OpenCL version of supported dependencies.
-

soifunc-0.11.1.dist-info/RECORD

@@ -1,10 +0,0 @@
-soifunc/__init__.py,sha256=H6BWoCLRW2ZD47wQtL72SIZvTpD6REH7cUqIYWvCn0k,174
-soifunc/deband.py,sha256=nbtRwktdN8Y-OuiSsj1mVg9vzJhJlu7r6dqs_TLa6rg,1174
-soifunc/denoise.py,sha256=6MY4m3x64gEIgnbVT48htFthG51sLsERN1YGbNYTdGY,6798
-soifunc/interpolate.py,sha256=MNpYyO037H00vqA5d-WijeBd475oMssEvFLGXgeXPxw,4400
-soifunc/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-soifunc/resize.py,sha256=PCq-nGt8ZHG4dlx3H1R_dRAebHWEc9Eu_coO3VRGlCY,3028
-soifunc-0.11.1.dist-info/LICENSE,sha256=vgEDSMEV1J2nMiCgXE5_sjNtw2VT7_lP7rkAnrFKOWI,1068
-soifunc-0.11.1.dist-info/METADATA,sha256=eGGA-OZ6xqMU8J8Yy806Z5vhOktA_-fxpjpMYt8957I,3364
-soifunc-0.11.1.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-soifunc-0.11.1.dist-info/RECORD,,