toposync-ext-cameras 0.1.1__tar.gz

toposync_ext_cameras-0.1.1/.gitignore

@@ -0,0 +1,39 @@
+.DS_Store
+.env
+.venv
+__pycache__/
+*.pyc
+.pytest_cache/
+.ruff_cache/
+
+node_modules/
+yarn.lock
+.pnp.cjs
+.pnp.loader.mjs
+.yarn/
+dist/
+build/
+.parcel-cache/
+
+.toposync-data/
+.toposync-processor-data
+toposync-data/
+
+*.log
+
+*.ignore.md
+ignore/
+
+# Playwright
+test-results/
+playwright-report/
+yolo*.pt
+
+# Streaming extension engines are downloaded at runtime.
+extensions/streaming/src/toposync_ext_streaming/bin/mediamtx/**/mediamtx*
+extensions/streaming/src/toposync_ext_streaming/bin/ffmpeg/**/ffmpeg*
+
+# Vision model artifacts are provisioned locally and must not be committed.
+extensions/vision/models/
+
+*.temporary.*

toposync_ext_cameras-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mateus Calza
+
+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.

toposync_ext_cameras-0.1.1/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: toposync-ext-cameras
+Version: 0.1.1
+Summary: Toposync first-party extension: RTSP cameras and camera pipeline operators.
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: numpy>=1.26
+Requires-Dist: opencv-python-headless>=4.10
+Requires-Dist: pillow<13,>=10
+Requires-Dist: toposync-core>=0.3.0
+Description-Content-Type: text/markdown
+
+# Toposync Cameras extension
+
+First-party extension focused on camera integration for the global Pipelines runtime.
+
+## What it provides
+
+- RTSP camera settings and indexing (`/api/cameras/index`)
+- RTSP snapshot endpoints used by UI/tools
+- Control-point-set mapping endpoint for camera/composition interpolation
+- Camera pipeline operators registry integration
+- Camera element/editor UI in the composition
+
+The old per-camera detections runtime (`/api/cameras/detections/*`, `cameras.tracking`, and `toposync_ext_cameras.processor_server`) is no longer part of this extension.
+
+## APIs
+
+- `GET /api/cameras/index`
+- `POST /api/cameras/rtsp/snapshot`
+- `GET /api/cameras/cameras/{camera_id}/snapshot`
+- `POST /api/cameras/control_points/map`
+
+`camera.camera_mapping` and the editor now use `control_point_sets` as the canonical mapping model:
+
+- fixed camera: one set with `pose_reference = null`
+- PTZ camera: one or more sets, optionally bound to a `pose_reference`
+- preview API: receives a single `control_point_set` payload and maps `image <-> world`
+
+## Pipeline operators (registered by this extension)
+
+- `camera.source`
+- `camera.motion_gate`
+- `camera.object_crop`
+- `camera.camera_mapping`
+- `camera.area_restriction`
+- `camera.velocity_estimation`
+- `camera.best_frame_selector`
+
+Public vision operators are registered by the `com.toposync.vision` extension:
+
+- `vision.detect`
+- `vision.track`
+
+Legacy vendor-specific YOLO/Ultralytics runtimes are not part of the official first-party path in this extension. If you need one of those integrations in the future, ship it as a separate package and keep `vision.detect` / `vision.track` as the public operator contract.
+
+## Dependencies
+
+- `ffmpeg` must be available in `PATH` for snapshot capture.
+- OpenCV is required by frame/motion processing:
+  - `uv pip install opencv-python-headless`
+- Vision runtimes are optional and can be installed from `extensions/vision`.
+
+## Snapshot tuning
+
+- `TOPOSYNC_CAMERA_SNAPSHOT_TTL_S` (default: `0.8`)
+- `TOPOSYNC_CAMERA_SNAPSHOT_FFMPEG_CONCURRENCY` (default: `2`)
+
+## RTSP note
+
+Some cameras expose `/stream1` and `/stream2`. If `/stream1` is unstable for snapshots, configure `rtsp_url` with the substream (`/stream2`) explicitly.

toposync_ext_cameras-0.1.1/README.md

@@ -0,0 +1,59 @@
+# Toposync Cameras extension
+
+First-party extension focused on camera integration for the global Pipelines runtime.
+
+## What it provides
+
+- RTSP camera settings and indexing (`/api/cameras/index`)
+- RTSP snapshot endpoints used by UI/tools
+- Control-point-set mapping endpoint for camera/composition interpolation
+- Camera pipeline operators registry integration
+- Camera element/editor UI in the composition
+
+The old per-camera detections runtime (`/api/cameras/detections/*`, `cameras.tracking`, and `toposync_ext_cameras.processor_server`) is no longer part of this extension.
+
+## APIs
+
+- `GET /api/cameras/index`
+- `POST /api/cameras/rtsp/snapshot`
+- `GET /api/cameras/cameras/{camera_id}/snapshot`
+- `POST /api/cameras/control_points/map`
+
+`camera.camera_mapping` and the editor now use `control_point_sets` as the canonical mapping model:
+
+- fixed camera: one set with `pose_reference = null`
+- PTZ camera: one or more sets, optionally bound to a `pose_reference`
+- preview API: receives a single `control_point_set` payload and maps `image <-> world`
+
+## Pipeline operators (registered by this extension)
+
+- `camera.source`
+- `camera.motion_gate`
+- `camera.object_crop`
+- `camera.camera_mapping`
+- `camera.area_restriction`
+- `camera.velocity_estimation`
+- `camera.best_frame_selector`
+
+Public vision operators are registered by the `com.toposync.vision` extension:
+
+- `vision.detect`
+- `vision.track`
+
+Legacy vendor-specific YOLO/Ultralytics runtimes are not part of the official first-party path in this extension. If you need one of those integrations in the future, ship it as a separate package and keep `vision.detect` / `vision.track` as the public operator contract.
+
+## Dependencies
+
+- `ffmpeg` must be available in `PATH` for snapshot capture.
+- OpenCV is required by frame/motion processing:
+  - `uv pip install opencv-python-headless`
+- Vision runtimes are optional and can be installed from `extensions/vision`.
+
+## Snapshot tuning
+
+- `TOPOSYNC_CAMERA_SNAPSHOT_TTL_S` (default: `0.8`)
+- `TOPOSYNC_CAMERA_SNAPSHOT_FFMPEG_CONCURRENCY` (default: `2`)
+
+## RTSP note
+
+Some cameras expose `/stream1` and `/stream2`. If `/stream1` is unstable for snapshots, configure `rtsp_url` with the substream (`/stream2`) explicitly.

toposync_ext_cameras-0.1.1/pyproject.toml

@@ -0,0 +1,19 @@
+[project]
+name = "toposync-ext-cameras"
+version = "0.1.1"
+description = "Toposync first-party extension: RTSP cameras and camera pipeline operators."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+dependencies = ["toposync-core>=0.3.0", "numpy>=1.26", "opencv-python-headless>=4.10", "pillow>=10,<13"]
+
+[project.entry-points."toposync.extensions"]
+cameras = "toposync_ext_cameras.plugin:CamerasExtension"
+
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/toposync_ext_cameras"]

toposync_ext_cameras-0.1.1/src/toposync_ext_cameras/__init__.py

@@ -0,0 +1 @@
+__all__ = ["CamerasExtension"]

toposync_ext_cameras-0.1.1/src/toposync_ext_cameras/extension.json

@@ -0,0 +1,12 @@
+{
+  "schema_version": 1,
+  "id": "com.toposync.cameras",
+  "name": "Cameras",
+  "version": "0.1.1",
+  "frontend": {
+    "kind": "module-federation",
+    "remote_entry": "remoteEntry.js",
+    "scope": "cameras",
+    "module": "./activate"
+  }
+}

toposync_ext_cameras-0.1.1/src/toposync_ext_cameras/onvif/__init__.py

@@ -0,0 +1,28 @@
+"""Minimal ONVIF helpers (SOAP + WS-Security UsernameToken + WS-Discovery) used by the Cameras extension.
+
+This intentionally avoids external dependencies to keep the extension lightweight.
+"""
+
+from .client import (
+    OnvifClient,
+    OnvifError,
+    OnvifProfile,
+    OnvifPtzPreset,
+    OnvifPtzStatus,
+    normalize_onvif_xaddr,
+    normalize_rtsp_url,
+)
+from .discovery import OnvifDiscoveredDevice, discover_onvif_devices, parse_ws_discovery_probe_matches
+
+__all__ = [
+    "OnvifClient",
+    "OnvifError",
+    "OnvifProfile",
+    "OnvifPtzPreset",
+    "OnvifPtzStatus",
+    "OnvifDiscoveredDevice",
+    "discover_onvif_devices",
+    "parse_ws_discovery_probe_matches",
+    "normalize_onvif_xaddr",
+    "normalize_rtsp_url",
+]