framelock 0.3.0__py3-none-any.whl

framelock/__init__.py

@@ -0,0 +1,115 @@
+"""Synchronized multi-camera recording.
+
+Compose a recording session from heterogeneous sources — OAK-D devices
+(all three cameras, hardware-synced where possible), RTSP streams (e.g. an
+iPhone camera app), and anything else that can produce timestamped frames —
+and record them all into one session folder with per-device subfolders,
+per-frame timestamps, and cross-device sync groups.
+
+    from framelock import Session, OakD, RtspCamera, Ramp
+
+    oak = OakD(shutter_sync=True, shutter=1/125, iso=800)
+    phone = RtspCamera("rtsp://192.168.1.23:8554/live", name="iphone")
+
+    with Session("recordings", name="take1", warmup="auto") as session:
+        session.record(oak, phone)
+"""
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from framelock.audioalign import AirConditions, AlignmentResult, align_session
+    from framelock.soundspeed import SoundModel
+    from framelock.clock import ClockMap
+    from framelock.correspondence import Correspondence, write_correspondence
+    from framelock.controls import (
+        Automation, Control, ShutterFunc, ShutterRamp, ShutterStep,
+        FocusFunc, FocusRamp, FocusStep, Func, Interpolation, IsoFunc, IsoRamp,
+        IsoStep, Ramp, Step, ZoomFunc, ZoomRamp, ZoomStep,
+    )
+    from framelock.session import Session, Warmup
+    from framelock.sources.base import Source, SyncSample
+    from framelock.sources.mic import Microphone
+    from framelock.sources.oak import (
+        ExternalSync, OakD, Resolution, VideoFormat,
+    )
+    from framelock.sources.rtsp import RtspCamera, Transport
+    from framelock.sync import SyncGroup, Synchronizer
+    from framelock.chirps import (
+        BubbleCodeMicro,
+        GlassPlinkHidden,
+        HiddenChirpWater,
+        MLS,
+        NaturalWaterWood,
+        ReferenceLinearRamp,
+        Sweep,
+        Chirp,
+        TinySparkle,
+        ChirpKind,
+        Velvet,
+    )
+
+# Lazy imports (PEP 562): importing framelock stays instant and does not
+# pull in depthai/av until the corresponding source is actually used.
+_EXPORTS = {
+    "ClockMap": "framelock.clock",
+    "Correspondence": "framelock.correspondence",
+    "write_correspondence": "framelock.correspondence",
+    "Automation": "framelock.controls",
+    "Control": "framelock.controls",
+    "Interpolation": "framelock.controls",
+    "Func": "framelock.controls",
+    "Ramp": "framelock.controls",
+    "Step": "framelock.controls",
+    "ZoomRamp": "framelock.controls",
+    "ZoomFunc": "framelock.controls",
+    "ZoomStep": "framelock.controls",
+    "FocusRamp": "framelock.controls",
+    "FocusFunc": "framelock.controls",
+    "FocusStep": "framelock.controls",
+    "ShutterRamp": "framelock.controls",
+    "ShutterFunc": "framelock.controls",
+    "ShutterStep": "framelock.controls",
+    "IsoRamp": "framelock.controls",
+    "IsoFunc": "framelock.controls",
+    "IsoStep": "framelock.controls",
+    "Session": "framelock.session",
+    "Warmup": "framelock.session",
+    "Source": "framelock.sources.base",
+    "SyncSample": "framelock.sources.base",
+    "Microphone": "framelock.sources.mic",
+    "OakD": "framelock.sources.oak",
+    "Resolution": "framelock.sources.oak",
+    "VideoFormat": "framelock.sources.oak",
+    "ExternalSync": "framelock.sources.oak",
+    "RtspCamera": "framelock.sources.rtsp",
+    "Transport": "framelock.sources.rtsp",
+    "SyncGroup": "framelock.sync",
+    "Synchronizer": "framelock.sync",
+    "Chirp": "framelock.chirps",
+    "MLS": "framelock.chirps",
+    "Velvet": "framelock.chirps",
+    "Sweep": "framelock.chirps",
+    "ReferenceLinearRamp": "framelock.chirps",
+    "HiddenChirpWater": "framelock.chirps",
+    "GlassPlinkHidden": "framelock.chirps",
+    "BubbleCodeMicro": "framelock.chirps",
+    "TinySparkle": "framelock.chirps",
+    "NaturalWaterWood": "framelock.chirps",
+    "ChirpKind": "framelock.chirps",
+    "AirConditions": "framelock.audioalign",
+    "SoundModel": "framelock.soundspeed",
+    "align_session": "framelock.audioalign",
+    "AlignmentResult": "framelock.audioalign",
+}
+
+__all__ = sorted(_EXPORTS)
+
+
+def __getattr__(name: str):
+    module = _EXPORTS.get(name)
+    if module is None:
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+    import importlib
+
+    return getattr(importlib.import_module(module), name)

framelock/__main__.py

@@ -0,0 +1,6 @@
+"""python -m framelock"""
+
+from framelock.cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

framelock/_compat.py

@@ -0,0 +1,49 @@
+"""Environment quirks, contained.
+
+macOS + opencv-python + PyAV: each wheel bundles its OWN copy of FFmpeg,
+and when the second library loads, the Objective-C runtime prints
+duplicate-class warnings for FFmpeg's AVFoundation capture classes
+(AVFFrameReceiver / AVFAudioReceiver):
+
+    objc[…]: Class AVFFrameReceiver is implemented in both … libavdevice …
+
+Scary wording, benign here: those classes belong to libavdevice's camera
+capture, which framelock never uses through either library (we read and
+write files; live capture goes through DepthAI and RTSP). The wheels
+double-bundling is upstream's to fix; the noise is ours to silence — by
+importing both libraries together, early, with stderr muted at the file
+descriptor level (the objc runtime writes straight to fd 2, so Python's
+sys.stderr redirection cannot catch it).
+"""
+
+from __future__ import annotations
+
+import contextlib
+import os
+import sys
+
+
+@contextlib.contextmanager
+def _fd_stderr_silenced():
+    saved = os.dup(2)
+    devnull = os.open(os.devnull, os.O_WRONLY)
+    try:
+        os.dup2(devnull, 2)
+        yield
+    finally:
+        os.dup2(saved, 2)
+        os.close(saved)
+        os.close(devnull)
+
+
+def preload_media_libs() -> None:
+    """Import av and cv2 up front, muting the macOS duplicate-FFmpeg
+    warnings their combined load triggers. Call at CLI entry points; a
+    real ImportError still propagates (raised, not printed)."""
+    if sys.platform != "darwin":
+        return
+    with _fd_stderr_silenced():
+        with contextlib.suppress(ImportError):
+            import av  # noqa: F401
+        with contextlib.suppress(ImportError):
+            import cv2  # noqa: F401