vapoursynth-vszip 13.0.0__tar.gz

vapoursynth_vszip-13.0.0/.gitignore

@@ -0,0 +1,11 @@
+zig-out/
+.zig-cache/
+.vscode/
+run.bat
+build-help/releases.json
+build-help/zig-*
+.vsjet/
+*.h
+*.cpp
+*.so
+build/

vapoursynth_vszip-13.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Julek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

vapoursynth_vszip-13.0.0/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: vapoursynth-vszip
+Version: 13.0.0
+Summary: VapourSynth Zig Image Process
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: vapoursynth>=74
+Description-Content-Type: text/markdown
+
+## VapourSynth Zig Image Process
+
+[READ THE DOCS](https://github.com/dnjulek/vapoursynth-zip/wiki)
+
+# FILTERS
+- [AdaptiveBinarize](https://github.com/dnjulek/vapoursynth-zip/wiki/AdaptiveBinarize): based on [OpenCV's Adaptive Thresholding](https://docs.opencv.org/5.x/d7/d4d/tutorial_py_thresholding.html).
+- [Bilateral](https://github.com/dnjulek/vapoursynth-zip/wiki/Bilateral): A faster version of [VapourSynth-Bilateral](https://github.com/HomeOfVapourSynthEvolution/VapourSynth-Bilateral).
+- [BoxBlur](https://github.com/dnjulek/vapoursynth-zip/wiki/BoxBlur): A faster version of [std.BoxBlur](https://www.vapoursynth.com/doc/functions/video/boxblur.html).
+- [Checkmate](https://github.com/dnjulek/vapoursynth-zip/wiki/Checkmate): Spatial and temporal dot crawl reducer [from AviSynth](https://github.com/tp7/checkmate).
+- [CLAHE](https://github.com/dnjulek/vapoursynth-zip/wiki/CLAHE): Contrast Limited Adaptive Histogram Equalization [from OpenCV](https://docs.opencv.org/5.x/d5/daf/tutorial_py_histogram_equalization.html).
+- [ColorMap](https://github.com/dnjulek/vapoursynth-zip/wiki/ColorMap): A port of the [OpenCV ColorMap](https://docs.opencv.org/5.x/d3/d50/group__imgproc__colormap.html).
+- [CombMask](https://github.com/dnjulek/vapoursynth-zip/wiki/CombMask): Port of CombMask [from AviSynth](http://avisynth.nl/index.php/CombMask).
+- [CombMaskMT](https://github.com/dnjulek/vapoursynth-zip/wiki/CombMaskMT): Port of MTCombMask [from AviSynth](http://avisynth.nl/index.php/MTCombMask).
+- [Deband](https://github.com/dnjulek/vapoursynth-zip/wiki/Deband): A faster version of [neo_f3kdb](https://github.com/HomeOfAviSynthPlusEvolution/neo_f3kdb) with float support.
+- [ImageRead](https://github.com/dnjulek/vapoursynth-zip/wiki/ImageRead): Load image using [Zig Image library](https://github.com/zigimg/zigimg).
+- [Limiter](https://github.com/dnjulek/vapoursynth-zip/wiki/Limiter): A faster version of [core.std.Limiter](https://www.vapoursynth.com/doc/functions/video/limiter.html).
+- [LimitFilter](https://github.com/dnjulek/vapoursynth-zip/wiki/LimitFilter): Performs a soft-limiting between two clips to limit the difference of filtering while avoiding artifacts.
+- [PackRGB](https://github.com/dnjulek/vapoursynth-zip/wiki/PackRGB): Planar to interleaved RGB filter.
+- [PlaneAverage](https://github.com/dnjulek/vapoursynth-zip/wiki/PlaneAverage): Vapoursynth [PlaneStats](https://www.vapoursynth.com/doc/functions/video/planestats.html) with threshold.
+- [PlaneMinMax](https://github.com/dnjulek/vapoursynth-zip/wiki/PlaneMinMax): Vapoursynth [PlaneStats](https://www.vapoursynth.com/doc/functions/video/planestats.html) with threshold.
+- [RFS](https://github.com/dnjulek/vapoursynth-zip/wiki/RFS): Replace frames plugin.
+- [SSIMULACRA2](https://github.com/dnjulek/vapoursynth-zip/wiki/SSIMULACRA2): Image metric [SSIMULACRA2](https://github.com/cloudinary/ssimulacra2).
+- [XPSNR](https://github.com/dnjulek/vapoursynth-zip/wiki/XPSNR): Image metric [XPSNR](https://github.com/fraunhoferhhi/xpsnr).
+
+# BENCHMARK
+
+```py
+src = core.std.BlankClip(None, 1920, 1080, vs.YUV420P16, 5000)
+
+src.bilateral.Bilateral(ref=None, sigmaS=2, sigmaR=2, planes=[0,1,2]).set_output(1) 
+# Output 5000 frames in 43.35 seconds (115.35 fps)
+src.vszip.Bilateral(ref=None, sigmaS=2, sigmaR=2, planes=[0,1,2]).set_output(2) 
+# Output 5000 frames in 35.37 seconds (141.36 fps)
+
+src.std.BoxBlur(hradius=13, hpasses=1, vradius=13, vpasses=1).set_output(3) 
+# Output 5000 frames in 16.74 seconds (298.60 fps)
+src.vszip.BoxBlur(hradius=13, hpasses=1, vradius=13, vpasses=1).set_output(4) 
+# Output 5000 frames in 4.78 seconds (1046.11 fps)
+
+src.std.BoxBlur(hradius=13, hpasses=5, vradius=13, vpasses=5).set_output(5) 
+# Output 5000 frames in 76.72 seconds (65.17 fps)
+src.vszip.BoxBlur(hradius=13, hpasses=5, vradius=13, vpasses=5).set_output(6) 
+# Output 5000 frames in 13.62 seconds (367.01 fps)
+```
+
+## Building
+
+- Via manual download:\
+Put [zig-0.15.2](https://ziglang.org/download/) in your PATH and run: ``zig build -Doptimize=ReleaseFast``.
+- Via automated scripts:
+```ps
+git clone https://github.com/dnjulek/vapoursynth-zip
+cd vapoursynth-zip/build-help && ./build.ps1
+```
+- Via AUR (for Arch Linux):\
+Run ``paru -S vapoursynth-plugin-vszip-git``
+- Via vsrepo (for Windows):\
+Run ``vsrepo install vszip``

vapoursynth_vszip-13.0.0/README.md

@@ -0,0 +1,58 @@
+## VapourSynth Zig Image Process
+
+[READ THE DOCS](https://github.com/dnjulek/vapoursynth-zip/wiki)
+
+# FILTERS
+- [AdaptiveBinarize](https://github.com/dnjulek/vapoursynth-zip/wiki/AdaptiveBinarize): based on [OpenCV's Adaptive Thresholding](https://docs.opencv.org/5.x/d7/d4d/tutorial_py_thresholding.html).
+- [Bilateral](https://github.com/dnjulek/vapoursynth-zip/wiki/Bilateral): A faster version of [VapourSynth-Bilateral](https://github.com/HomeOfVapourSynthEvolution/VapourSynth-Bilateral).
+- [BoxBlur](https://github.com/dnjulek/vapoursynth-zip/wiki/BoxBlur): A faster version of [std.BoxBlur](https://www.vapoursynth.com/doc/functions/video/boxblur.html).
+- [Checkmate](https://github.com/dnjulek/vapoursynth-zip/wiki/Checkmate): Spatial and temporal dot crawl reducer [from AviSynth](https://github.com/tp7/checkmate).
+- [CLAHE](https://github.com/dnjulek/vapoursynth-zip/wiki/CLAHE): Contrast Limited Adaptive Histogram Equalization [from OpenCV](https://docs.opencv.org/5.x/d5/daf/tutorial_py_histogram_equalization.html).
+- [ColorMap](https://github.com/dnjulek/vapoursynth-zip/wiki/ColorMap): A port of the [OpenCV ColorMap](https://docs.opencv.org/5.x/d3/d50/group__imgproc__colormap.html).
+- [CombMask](https://github.com/dnjulek/vapoursynth-zip/wiki/CombMask): Port of CombMask [from AviSynth](http://avisynth.nl/index.php/CombMask).
+- [CombMaskMT](https://github.com/dnjulek/vapoursynth-zip/wiki/CombMaskMT): Port of MTCombMask [from AviSynth](http://avisynth.nl/index.php/MTCombMask).
+- [Deband](https://github.com/dnjulek/vapoursynth-zip/wiki/Deband): A faster version of [neo_f3kdb](https://github.com/HomeOfAviSynthPlusEvolution/neo_f3kdb) with float support.
+- [ImageRead](https://github.com/dnjulek/vapoursynth-zip/wiki/ImageRead): Load image using [Zig Image library](https://github.com/zigimg/zigimg).
+- [Limiter](https://github.com/dnjulek/vapoursynth-zip/wiki/Limiter): A faster version of [core.std.Limiter](https://www.vapoursynth.com/doc/functions/video/limiter.html).
+- [LimitFilter](https://github.com/dnjulek/vapoursynth-zip/wiki/LimitFilter): Performs a soft-limiting between two clips to limit the difference of filtering while avoiding artifacts.
+- [PackRGB](https://github.com/dnjulek/vapoursynth-zip/wiki/PackRGB): Planar to interleaved RGB filter.
+- [PlaneAverage](https://github.com/dnjulek/vapoursynth-zip/wiki/PlaneAverage): Vapoursynth [PlaneStats](https://www.vapoursynth.com/doc/functions/video/planestats.html) with threshold.
+- [PlaneMinMax](https://github.com/dnjulek/vapoursynth-zip/wiki/PlaneMinMax): Vapoursynth [PlaneStats](https://www.vapoursynth.com/doc/functions/video/planestats.html) with threshold.
+- [RFS](https://github.com/dnjulek/vapoursynth-zip/wiki/RFS): Replace frames plugin.
+- [SSIMULACRA2](https://github.com/dnjulek/vapoursynth-zip/wiki/SSIMULACRA2): Image metric [SSIMULACRA2](https://github.com/cloudinary/ssimulacra2).
+- [XPSNR](https://github.com/dnjulek/vapoursynth-zip/wiki/XPSNR): Image metric [XPSNR](https://github.com/fraunhoferhhi/xpsnr).
+
+# BENCHMARK
+
+```py
+src = core.std.BlankClip(None, 1920, 1080, vs.YUV420P16, 5000)
+
+src.bilateral.Bilateral(ref=None, sigmaS=2, sigmaR=2, planes=[0,1,2]).set_output(1) 
+# Output 5000 frames in 43.35 seconds (115.35 fps)
+src.vszip.Bilateral(ref=None, sigmaS=2, sigmaR=2, planes=[0,1,2]).set_output(2) 
+# Output 5000 frames in 35.37 seconds (141.36 fps)
+
+src.std.BoxBlur(hradius=13, hpasses=1, vradius=13, vpasses=1).set_output(3) 
+# Output 5000 frames in 16.74 seconds (298.60 fps)
+src.vszip.BoxBlur(hradius=13, hpasses=1, vradius=13, vpasses=1).set_output(4) 
+# Output 5000 frames in 4.78 seconds (1046.11 fps)
+
+src.std.BoxBlur(hradius=13, hpasses=5, vradius=13, vpasses=5).set_output(5) 
+# Output 5000 frames in 76.72 seconds (65.17 fps)
+src.vszip.BoxBlur(hradius=13, hpasses=5, vradius=13, vpasses=5).set_output(6) 
+# Output 5000 frames in 13.62 seconds (367.01 fps)
+```
+
+## Building
+
+- Via manual download:\
+Put [zig-0.15.2](https://ziglang.org/download/) in your PATH and run: ``zig build -Doptimize=ReleaseFast``.
+- Via automated scripts:
+```ps
+git clone https://github.com/dnjulek/vapoursynth-zip
+cd vapoursynth-zip/build-help && ./build.ps1
+```
+- Via AUR (for Arch Linux):\
+Run ``paru -S vapoursynth-plugin-vszip-git``
+- Via vsrepo (for Windows):\
+Run ``vsrepo install vszip``

vapoursynth_vszip-13.0.0/build.zig

@@ -0,0 +1,67 @@
+const std = @import("std");
+const zon = @import("build.zig.zon");
+
+pub fn build(b: *std.Build) !void {
+    ensureZigVersion(try .parse(zon.minimum_zig_version)) catch return;
+    const target = b.standardTargetOptions(.{});
+    const optimize = b.standardOptimizeOption(.{});
+
+    const lib = b.addLibrary(.{
+        .name = "vszip",
+        .linkage = .dynamic,
+        .root_module = b.createModule(.{
+            .root_source_file = b.path("src/vszip.zig"),
+            .target = target,
+            .optimize = optimize,
+        }),
+    });
+
+    const options = b.addOptions();
+    const version = try std.SemanticVersion.parse(zon.version);
+    options.addOption(std.SemanticVersion, "version", version);
+    lib.root_module.addOptions("zon", options);
+
+    const zigimg_dependency = b.dependency("zigimg", .{
+        .target = target,
+        .optimize = optimize,
+    });
+
+    lib.root_module.addImport("zigimg", zigimg_dependency.module("zigimg"));
+
+    const vapoursynth_dep = b.dependency("vapoursynth", .{
+        .target = target,
+        .optimize = optimize,
+    });
+
+    lib.root_module.addImport("vapoursynth", vapoursynth_dep.module("vapoursynth"));
+    lib.linkLibC();
+
+    if (lib.root_module.optimize == .ReleaseFast) {
+        lib.root_module.strip = true;
+    }
+
+    b.installArtifact(lib);
+}
+
+fn ensureZigVersion(min_zig_version: std.SemanticVersion) !void {
+    var installed_ver = @import("builtin").zig_version;
+    installed_ver.build = null;
+
+    if (installed_ver.order(min_zig_version) == .lt) {
+        std.log.err("\n" ++
+            \\---------------------------------------------------------------------------
+            \\
+            \\Installed Zig compiler version is too old.
+            \\
+            \\Min. required version: {any}
+            \\Installed version: {any}
+            \\
+            \\Please install newer version and try again.
+            \\Latest version can be found here: https://ziglang.org/download/
+            \\
+            \\---------------------------------------------------------------------------
+            \\
+        , .{ min_zig_version, installed_ver });
+        return error.ZigIsTooOld;
+    }
+}

vapoursynth_vszip-13.0.0/build.zig.zon

@@ -0,0 +1,20 @@
+.{
+    .name = .vszip,
+    .version = "13.0.0",
+    .paths = .{""},
+    .fingerprint = 0x7466a154dbe09310,
+    .minimum_zig_version = "0.15.2",
+    .dependencies = .{
+        .vapoursynth = .{
+            // zig fetch --save git+https://github.com/dnjulek/vapoursynth-zig.git
+            .url = "git+https://github.com/dnjulek/vapoursynth-zig.git#8e93fe3433bb977135f81040bb59d964c58a1cb9",
+            .hash = "vapoursynth-4.0.0-jLYMQ799AgCA8sL5lgewK9acIrAKjs-ByT2pdKI5dHq2",
+        },
+
+        .zigimg = .{
+            // zig fetch --save git+https://github.com/zigimg/zigimg.git
+            .url = "git+https://github.com/zigimg/zigimg.git#362cdd6bce109f7bc674be134cddd378f52da5d4",
+            .hash = "zigimg-0.1.0-8_eo2jNrFQD4mu3EAUkfQRmCkyfprdIXc8JQ6uyxhjSQ",
+        },
+    },
+}

vapoursynth_vszip-13.0.0/hatch_build.py

@@ -0,0 +1,144 @@
+import os
+import sys
+import shutil
+import subprocess
+from pathlib import Path
+from typing import Any
+
+from hatchling.builders.hooks.plugin.interface import BuildHookInterface
+from packaging import tags
+
+library_suffixes = frozenset({'.so', '.dll', '.dylib'})
+
+cpus = [
+    {'cpu': 'x86_64'}, 
+    {'cpu': 'haswell', 'opt_level': 'v3'},
+    {'cpu': 'znver4-sse4a', 'opt_level': 'v4'}, # "-sse4a" means *remove* the use of SSE4a (which Intel never implemented)
+]
+
+targets = {
+    # Linux
+    'aarch64-linux-gnu': {
+        'zig_target': 'aarch64-linux-gnu.2.17', 
+        'python_platform_tag': 'manylinux_2_17_aarch64',
+        'basename': 'libvszip',
+    },
+    'aarch64-linux-musl': {
+        'zig_target': 'aarch64-linux-musl', 
+        'python_platform_tag': 'musllinux_1_2_aarch64',
+        'basename': 'libvszip',
+    },
+    'x86_64-linux-gnu': {
+        'zig_target': 'x86_64-linux-gnu.2.17', 
+        'python_platform_tag': 'manylinux_2_17_x86_64',
+        'basename': 'libvszip',
+        'cpus': cpus,
+    },
+    'x86_64-linux-musl': {
+        'zig_target': 'x86_64-linux-musl', 
+        'python_platform_tag': 'musllinux_1_2_x86_64',
+        'basename': 'libvszip',
+        'cpus': cpus, 
+    },
+
+    # Mac
+    'aarch64-macos': {
+        'zig_target': 'aarch64-macos', 
+        'python_platform_tag': 'macosx_11_0_arm64',
+        'basename': 'libvszip',
+    },
+    'x86_64-macos': {
+        'zig_target': 'x86_64-macos', 
+        'python_platform_tag': 'macosx_11_0_x86_64',
+        'basename': 'libvszip',
+    },
+
+    # Windows
+    'x86_64-windows': {
+        'zig_target': 'x86_64-windows', 
+        'python_platform_tag': 'win_amd64',
+        'basename': 'vszip',
+        'cpus': cpus, 
+    },
+}
+
+
+class CustomHook(BuildHookInterface[Any]):
+    """
+    Custom build hook to compile the Zig project and package the resulting binaries.
+    """
+
+    source_dir = Path("zig-out")
+    target_dir = Path("vapoursynth/plugins/vszip")
+
+    def initialize(self, version: str, build_data: dict[str, Any]) -> None:
+        """
+        Called before the build process starts.
+        Sets build metadata and executes the Zig compilation.
+        """
+        # https://hatch.pypa.io/latest/plugins/builder/wheel/#build-data
+        build_data["pure_python"] = False
+
+        # Ensure the target directory exists
+        self.target_dir.mkdir(parents=True, exist_ok=True)
+
+        # Cross-compilation support
+        if "ZTARGET" in os.environ:
+            # Ex: ZTARGET="x86_64-linux-gnu"
+            ztarget = os.environ["ZTARGET"]
+
+            if ztarget not in targets:
+                raise ValueError(f"Unsupported target {ztarget}")
+
+            target = targets[ztarget]
+            zig_target = target['zig_target']
+            python_platform_tag = target['python_platform_tag']
+
+            build_data["tag"] = f"py3-none-{python_platform_tag}"
+
+            if 'cpus' in target: 
+                # Build all optimization levels of the library
+                for cpu_spec in target['cpus']:
+                    subprocess.run([sys.executable, "-m", "ziglang", "build", "-Doptimize=ReleaseFast", f"-Dtarget={zig_target}", f"-Dcpu={cpu_spec['cpu']}"], check=True)
+
+                    for file_path in self.source_dir.rglob("*"):
+                        if file_path.is_file() and file_path.suffix in library_suffixes:
+                            if 'opt_level' in cpu_spec:
+                                name = file_path.stem + f".{cpu_spec['opt_level']}" + file_path.suffix
+                                shutil.copy2(file_path, Path(self.target_dir, name))
+                            else:
+                                shutil.copy2(file_path, self.target_dir)
+            else:
+                subprocess.run([sys.executable, "-m", "ziglang", "build", "-Doptimize=ReleaseFast", f"-Dtarget={zig_target}"], check=True)
+
+                for file_path in self.source_dir.rglob("*"):
+                    if file_path.is_file() and file_path.suffix in library_suffixes:
+                        shutil.copy2(file_path, self.target_dir)
+
+            # Write a manifest to ensure instruction set-based loading works as desired
+            # https://github.com/vapoursynth/vapoursynth/discussions/1196
+            manifest_path = Path(self.target_dir, "manifest.vs")
+            with open(manifest_path, "wt") as manifest:
+                manifest.writelines([
+                    "[VapourSynth Manifest V1]\n"
+                    f"{target['basename']}\n"
+                ])
+
+        # Build for *this* machine
+        else:
+            build_data["tag"] = f"py3-none-{next(tags.platform_tags())}"
+
+            subprocess.run([sys.executable, "-m", "ziglang", "build", "-Doptimize=ReleaseFast"], check=True)
+        
+            # Copy the compiled binaries
+            for file_path in self.source_dir.rglob("*"):
+                if file_path.is_file() and file_path.suffix in library_suffixes:
+                    shutil.copy2(file_path, self.target_dir)
+
+
+    def finalize(self, version: str, build_data: dict[str, Any], artifact_path: str) -> None:
+        """
+        Called after the build process finishes.
+        Cleans up temporary build artifacts.
+        """
+        shutil.rmtree(self.target_dir.parent, ignore_errors=True)

vapoursynth_vszip-13.0.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["hatchling>=1.29.0", "packaging", "ziglang==0.15.2"]
+build-backend = "hatchling.build"
+
+[project]
+name = "vapoursynth-vszip"
+description = "VapourSynth Zig Image Process"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.12"
+dependencies = ["VapourSynth>=74"]
+dynamic = ["version"]
+
+[tool.hatch.version]
+source = "regex"
+path = "build.zig.zon"
+pattern = '\.version\s*=\s*"(?P<version>[^"]+)"'
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src",
+    "build.zig",
+    "build.zig.zon",
+]
+
+[tool.hatch.build.targets.wheel]
+include = ["vapoursynth/plugins/vszip"]
+artifacts = [
+    "vapoursynth/plugins/vszip/*.dylib",
+    "vapoursynth/plugins/vszip/*.so",
+    "vapoursynth/plugins/vszip/*.dll",
+    "vapoursynth/plugins/vszip/manifest.vs",
+]
+
+[tool.hatch.build.targets.wheel.hooks.custom]
+path = "hatch_build.py"