vsanalog 0.2.0__py3-none-win_amd64.whl

vsanalog/__init__.py

@@ -0,0 +1,120 @@
+"""VapourSynth plugin for working with digitized analog video signals."""
+
+from __future__ import annotations
+
+import functools
+import platform
+import sys
+from collections.abc import Callable, Sequence
+from importlib.metadata import version as _get_version
+from pathlib import Path
+from typing import Any, TypeVar
+
+if sys.version_info >= (3, 10):
+    from typing import ParamSpec
+else:
+    from typing_extensions import ParamSpec
+
+import vapoursynth as vs
+
+__all__ = ["decode_4fsc_video", "requires_plugin"]
+
+__version__ = _get_version("vsanalog")
+
+P = ParamSpec("P")
+R = TypeVar("R")
+
+
+def _get_plugin_path() -> Path:
+    """Derive the filesystem path of the bundled vsanalog shared library."""
+    suffix = {"Windows": ".dll", "Darwin": ".dylib"}.get(platform.system(), ".so")
+    _packages_root = Path(__file__).resolve().parent.parent
+    return _packages_root / "vapoursynth" / "plugins" / f"vsanalog{suffix}"
+
+
+def _ensure_plugin_loaded() -> None:
+    """Load the vsanalog VapourSynth plugin if it isn't already available."""
+    if not hasattr(vs.core, "analog"):
+        plugin_path = _get_plugin_path()
+        if not plugin_path.is_file():
+            raise FileNotFoundError(
+                f"vsanalog plugin not found at {plugin_path}. "
+                "Ensure the vsanalog package is properly installed."
+            )
+        vs.core.std.LoadPlugin(plugin_path)
+
+
+def requires_plugin(func: Callable[P, R]) -> Callable[P, R]:
+    """Decorator ensuring the vsanalog VapourSynth plugin is loaded."""
+
+    @functools.wraps(func)
+    def wrapper(*args: P.args, **kwargs: P.kwargs) -> R:
+        _ensure_plugin_loaded()
+        return func(*args, **kwargs)
+
+    return wrapper
+
+
+@requires_plugin
+def decode_4fsc_video(
+    composite_or_luma_source: str | Path,
+    chroma_or_pb_source: str | Path | None = None,
+    pr_source: str | Path | None = None,
+    *,
+    decoder: str | None = None,
+    reverse_fields: bool = False,
+    chroma_gain: float = 1.0,
+    chroma_phase: float = 0.0,
+    chroma_nr: float = 0.0,
+    luma_nr: float = 0.0,
+    phase_compensation: bool = False,
+    padding_multiple: int = 8,
+    dropout_correct: bool = False,
+    dropout_overcorrect: bool = False,
+    dropout_intra: bool = False,
+    dropout_composite_or_luma_extra_sources: Sequence[str | Path] | None = None,
+    dropout_chroma_extra_sources: Sequence[str | Path] | None = None,
+    fpsnum: int | None = None,
+    fpsden: int = 1,
+) -> vs.VideoNode:
+    """Decode 4𝑓𝑠𝑐 (four times subcarrier frequency) digitized analog video.
+
+    Reads time-base corrected (TBC) captures produced by ld-decode or vhs-decode
+    and returns a VapourSynth clip in YUV444PS or GRAYS format (32-bit float).
+    """
+    kwargs: dict[str, Any] = {}
+
+    # Optional parameters — only pass when explicitly provided so the
+    # C++ side can distinguish "not given" from "given as default".
+    if chroma_or_pb_source is not None:
+        kwargs["chroma_or_pb_source"] = chroma_or_pb_source
+    if pr_source is not None:
+        kwargs["pr_source"] = pr_source
+    if decoder is not None:
+        kwargs["decoder"] = decoder
+    if dropout_composite_or_luma_extra_sources is not None:
+        kwargs["dropout_composite_or_luma_extra_sources"] = (
+            dropout_composite_or_luma_extra_sources
+        )
+    if dropout_chroma_extra_sources is not None:
+        kwargs["dropout_chroma_extra_sources"] = dropout_chroma_extra_sources
+    if fpsnum is not None:
+        kwargs["fpsnum"] = fpsnum
+        kwargs["fpsden"] = fpsden
+
+    # VapourSynth's Python bindings handle bool→int and Path→str
+    # coercion automatically, so remaining args pass through as-is.
+    return vs.core.analog.decode_4fsc_video(
+        composite_or_luma_source,
+        reverse_fields=reverse_fields,
+        chroma_gain=chroma_gain,
+        chroma_phase=chroma_phase,
+        chroma_nr=chroma_nr,
+        luma_nr=luma_nr,
+        phase_compensation=phase_compensation,
+        padding_multiple=padding_multiple,
+        dropout_correct=dropout_correct,
+        dropout_overcorrect=dropout_overcorrect,
+        dropout_intra=dropout_intra,
+        **kwargs,
+    )

vsanalog/__pyinstaller/__init__.py

@@ -0,0 +1,5 @@
+from pathlib import Path
+
+
+def get_hook_dirs():
+    return (str(Path(__file__).parent),)

vsanalog/__pyinstaller/hook-vsanalog.py

@@ -0,0 +1,9 @@
+import platform
+from pathlib import Path
+
+_suffix = {"Windows": ".dll", "Darwin": ".dylib"}.get(platform.system(), ".so")
+_packages_root = Path(__file__).resolve().parent.parent.parent
+_plugin = _packages_root / "vapoursynth" / "plugins" / f"vsanalog{_suffix}"
+
+if _plugin.is_file():
+    binaries = [(str(_plugin), "vapoursynth/plugins")]

vsanalog-0.2.0.dist-info/METADATA

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: vsanalog
+Version: 0.2.0
+Summary: VapourSynth plugin for working with digitized analog video signals
+License-Expression: GPL-3.0-or-later
+Requires-Python: >=3.9
+Requires-Dist: vapoursynth>=55
+Requires-Dist: typing_extensions>=4.0; python_version < "3.10"
+

vsanalog-0.2.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+vsanalog-0.2.0.dist-info/METADATA,sha256=TD1xy2sYeXyn3tXFmwozNWAK8aZw5LU5zgDNpKnTi5o,283
+vsanalog-0.2.0.dist-info/WHEEL,sha256=eGbHOVnVkNk5N_A188Q13-gtiwyWWQjeSFRh9oxazXU,84
+vsanalog-0.2.0.dist-info/entry_points.txt,sha256=A3onFMxdGVjPaDwQchXDGS8dwPouScm1-LfTKc3f8yk,66
+vapoursynth/plugins/vsanalog.dll,sha256=NH9ZwZhUU3VVdy2U2U2ub0hKtitrrZlyYgt5ZqtOlmg,357376
+vapoursynth/plugins/vsanalog.lib,sha256=StzHA4cVUKAAwiZTcAUnQUCA5IisN6iGetJ5tDDfOPg,1784
+vsanalog/__init__.py,sha256=W9khR0Rvcx0iCsPYHBLcxd_ksSXyh7eOpRQ0lI2tlHc,4256
+vsanalog/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+vsanalog/__pyinstaller/__init__.py,sha256=xqxr9SRah90a5sdNCkoyLGh9veEnEp98qtDMT4RgaN4,94
+vsanalog/__pyinstaller/hook-vsanalog.py,sha256=qZqW9B-3OkDsRAK3rvCFKjEhvo-uMcvyuiT_P5sNWuo,348
+vsanalog-0.2.0.dist-info/RECORD,,

vsanalog-0.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: meson
+Root-Is-Purelib: false
+Tag: py3-none-win_amd64
+

vsanalog-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[pyinstaller40]
+hook-dirs = vsanalog.__pyinstaller:get_hook_dirs
+