QVideo 3.2.2__tar.gz → 3.4.0__tar.gz

{qvideo-3.2.2 → qvideo-3.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: QVideo
-Version: 3.2.2
+Version: 3.4.0
 Summary: PyQt-based framework for integrating video cameras into research applications
 Author-email: "David G. Grier" <david.grier@nyu.edu>
 License: GPL-3.0-or-later
@@ -36,7 +36,7 @@ Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
 Provides-Extra: docs
-Requires-Dist: furo; extra == "docs"
+Requires-Dist: pydata-sphinx-theme; extra == "docs"
 Requires-Dist: sphinx; extra == "docs"
 Requires-Dist: sphinx-autodoc-typehints; extra == "docs"
 Dynamic: license-file
@@ -47,6 +47,7 @@ Dynamic: license-file
 [![Python](https://img.shields.io/pypi/pyversions/QVideo)](https://pypi.org/project/QVideo/)
 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](LICENSE.md)
 [![Tests](https://github.com/davidgrier/QVideo/actions/workflows/test.yml/badge.svg)](https://github.com/davidgrier/QVideo/actions/workflows/test.yml)
+[![Documentation](https://readthedocs.org/projects/qvideo/badge/?version=latest)](https://qvideo.readthedocs.io/en/latest/)
 
 **QVideo** is a framework for integrating video cameras into PyQt5 projects
 for scientific research.  It provides a unified, registration-based property
@@ -156,5 +157,5 @@ additional code needed.
 ## Acknowledgements
 
 Work on this project at New York University is supported by the National
-Science Foundation of the United States under award number DMR-2104837 and
+Science Foundation of the United States under award number DMR-2428983 and
 by an award from the TAC Program of New York University.

{qvideo-3.2.2 → qvideo-3.4.0}/QCamcorder.py

@@ -3,7 +3,7 @@
 
 Run directly to launch a full camcorder application with camera selection::
 
-    python -m QVideo.QCamcorder [-c|-f|-s|-v] [cameraID]
+    python -m QVideo.QCamcorder [-b|-c|-f|-i|-m|-p|-r|-v] [cameraID]
 
 Camera flags (mutually exclusive):
 
@@ -15,7 +15,9 @@ Camera flags (mutually exclusive):
     -i [cameraID]   IDS Imaging camera (requires IDS peak SDK)
     -m [cameraID]   MATRIX VISION mvGenTLProducer (universal GenICam, not FLIR)
     -p [cameraID]   Raspberry Pi camera module (requires picamera2)
+    -r [cameraID]   OpenCV camera with resolution drop-down selector
     -v [cameraID]   Allied Vision VimbaX camera
+    -h              Show help and exit
 
 If no flag is given, a noise camera is used as a fallback.
 '''
@@ -67,6 +69,8 @@ class QCamcorder(QWidget):
     def _setupUi(self) -> None:
         uic.loadUi(str(self.UIFILE), self)
         self.controls.layout().addWidget(self.cameraWidget)
+        self.layout().setStretch(0, 1)  # screen takes all surplus horizontal space
+        self.layout().setStretch(1, 0)  # controls stay at their natural width
 
     def _connectSignals(self) -> None:
         self.dvr.playing.connect(self.dvrPlayback)

{qvideo-3.2.2 → qvideo-3.4.0}/QVideo.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: QVideo
-Version: 3.2.2
+Version: 3.4.0
 Summary: PyQt-based framework for integrating video cameras into research applications
 Author-email: "David G. Grier" <david.grier@nyu.edu>
 License: GPL-3.0-or-later
@@ -36,7 +36,7 @@ Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
 Provides-Extra: docs
-Requires-Dist: furo; extra == "docs"
+Requires-Dist: pydata-sphinx-theme; extra == "docs"
 Requires-Dist: sphinx; extra == "docs"
 Requires-Dist: sphinx-autodoc-typehints; extra == "docs"
 Dynamic: license-file
@@ -47,6 +47,7 @@ Dynamic: license-file
 [![Python](https://img.shields.io/pypi/pyversions/QVideo)](https://pypi.org/project/QVideo/)
 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](LICENSE.md)
 [![Tests](https://github.com/davidgrier/QVideo/actions/workflows/test.yml/badge.svg)](https://github.com/davidgrier/QVideo/actions/workflows/test.yml)
+[![Documentation](https://readthedocs.org/projects/qvideo/badge/?version=latest)](https://qvideo.readthedocs.io/en/latest/)
 
 **QVideo** is a framework for integrating video cameras into PyQt5 projects
 for scientific research.  It provides a unified, registration-based property
@@ -156,5 +157,5 @@ additional code needed.
 ## Acknowledgements
 
 Work on this project at New York University is supported by the National
-Science Foundation of the United States under award number DMR-2104837 and
+Science Foundation of the United States under award number DMR-2428983 and
 by an award from the TAC Program of New York University.

{qvideo-3.2.2 → qvideo-3.4.0}/QVideo.egg-info/SOURCES.txt

@@ -41,6 +41,11 @@ cameras/Picamera/_tree.py
 cameras/Vimbax/__init__.py
 cameras/Vimbax/_camera.py
 cameras/Vimbax/_tree.py
+demos/ROIdemo.py
+demos/__init__.py
+demos/demo.py
+demos/filterdemo.py
+demos/trackpydemo.py
 dvr/QDVRWidget.py
 dvr/QHDF5Reader.py
 dvr/QHDF5Writer.py
@@ -56,6 +61,7 @@ filters/QBlurFilter.py
 filters/QEdgeFilter.py
 filters/QRGBFilter.py
 filters/QSampleHold.py
+filters/QYOLOFilter.py
 filters/_MedianBase.py
 filters/__init__.py
 lib/QCamera.py
@@ -63,16 +69,19 @@ lib/QCameraTree.py
 lib/QFPSMeter.py
 lib/QFilterBank.py
 lib/QListCameras.py
+lib/QVideoFilter.py
 lib/QVideoReader.py
 lib/QVideoScreen.py
 lib/QVideoSource.py
 lib/QVideoWriter.py
-lib/VideoFilter.py
 lib/__init__.py
 lib/chooser.py
 lib/clickable.py
 lib/resolutions.py
 lib/types.py
+overlays/__init__.py
+overlays/trackpy.py
+overlays/yolo.py
 tests/test_chooser.py
 tests/test_clickable.py
 tests/test_demo.py
@@ -116,4 +125,5 @@ tests/test_qvideowriter.py
 tests/test_qvimbaxcamera.py
 tests/test_resolutions.py
 tests/test_roidemo.py
+tests/test_trackpy_overlay.py
 tests/test_videofilter.py

{qvideo-3.2.2 → qvideo-3.4.0}/QVideo.egg-info/requires.txt

@@ -10,7 +10,7 @@ pytest
 pytest-cov
 
 [docs]
-furo
+pydata-sphinx-theme
 sphinx
 sphinx-autodoc-typehints
 

{qvideo-3.2.2 → qvideo-3.4.0}/README.md

@@ -4,6 +4,7 @@
 [![Python](https://img.shields.io/pypi/pyversions/QVideo)](https://pypi.org/project/QVideo/)
 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](LICENSE.md)
 [![Tests](https://github.com/davidgrier/QVideo/actions/workflows/test.yml/badge.svg)](https://github.com/davidgrier/QVideo/actions/workflows/test.yml)
+[![Documentation](https://readthedocs.org/projects/qvideo/badge/?version=latest)](https://qvideo.readthedocs.io/en/latest/)
 
 **QVideo** is a framework for integrating video cameras into PyQt5 projects
 for scientific research.  It provides a unified, registration-based property
@@ -113,5 +114,5 @@ additional code needed.
 ## Acknowledgements
 
 Work on this project at New York University is supported by the National
-Science Foundation of the United States under award number DMR-2104837 and
+Science Foundation of the United States under award number DMR-2428983 and
 by an award from the TAC Program of New York University.

{qvideo-3.2.2 → qvideo-3.4.0}/cameras/Basler/_tree.py

@@ -56,7 +56,7 @@ class QBaslerTree(QGenicamTree):
                  controls: list[str] | None = None,
                  **kwargs) -> None:
         camera = camera or QBaslerCamera(cameraID=cameraID)
-        camera.setSettings(self._DEFAULT_SETTINGS)
+        camera.settings = self._DEFAULT_SETTINGS
         super().__init__(*args,
                          camera=camera,
                          controls=controls or self._DEFAULT_CONTROLS,

{qvideo-3.2.2 → qvideo-3.4.0}/cameras/Flir/_camera.py

@@ -15,6 +15,14 @@ class QFlirCamera(QGenicamCamera):
 
     If Spinnaker is not installed, instantiation raises :exc:`TypeError`.
 
+    .. warning::
+
+        Spinnaker GenTL producer **4.3.0.189** contains a bug in which
+        ``DevClose()`` hangs indefinitely when the camera is released.
+        This causes the application to hang on exit.  FLIR customer
+        support has confirmed the bug.  If you experience this issue,
+        downgrade to Spinnaker **4.1.0.172** or earlier.
+
     Parameters
     ----------
     cameraID : int

{qvideo-3.2.2 → qvideo-3.4.0}/cameras/Flir/_tree.py

@@ -10,7 +10,7 @@ class QFlirTree(QGenicamTree):
 
     '''Camera property tree for :class:`~QVideo.cameras.Flir.QFlirCamera`.
 
-    Builds a :class:`~QVideo.lib.QCameraTree.QCameraTree` with a curated
+    Builds a :class:`~QVideo.lib.QcameraTree.QCameraTree` with a curated
     set of controls and sensible default settings for FLIR cameras.
 
     Parameters
@@ -59,7 +59,8 @@ class QFlirTree(QGenicamTree):
                  controls: list[str] | None = None,
                  **kwargs) -> None:
         camera = camera or QFlirCamera(cameraID=cameraID)
-        camera.setSettings(self._DEFAULT_SETTINGS)
+        camera.settings = {k: v for k, v in self._DEFAULT_SETTINGS.items()
+                           if k in camera.properties}
         super().__init__(*args,
                          camera=camera,
                          controls=controls or self._DEFAULT_CONTROLS,

qvideo-3.4.0/cameras/Genicam/__init__.py

@@ -0,0 +1,11 @@
+from ._camera import QGenicamCamera, QGenicamSource
+from ._tree import QGenicamTree
+
+# Tell Sphinx that these classes belong to the public package namespace,
+# not the private _camera / _tree submodules, to avoid duplicate
+# object descriptions in the generated docs.
+QGenicamCamera.__module__ = __name__
+QGenicamSource.__module__ = __name__
+QGenicamTree.__module__ = __name__
+
+__all__ = 'QGenicamCamera QGenicamSource QGenicamTree'.split()

{qvideo-3.2.2 → qvideo-3.4.0}/cameras/Genicam/_camera.py

@@ -103,10 +103,25 @@ class QGenicamCamera(QCamera):
 
     @staticmethod
     def _make_getter(feature: IValue):
-        '''Return a zero-argument callable that reads the feature value.'''
+        '''Return a zero-argument callable that reads the feature value.
+
+        The returned callable checks the current access mode before reading,
+        returning ``None`` for features that are not readable at call time
+        (e.g. enumeration nodes whose access mode changes after acquisition
+        starts).
+        '''
         if isinstance(feature, IEnumeration):
-            return lambda: feature.to_string()
-        return lambda: feature.value
+            def getter():
+                if feature.node.get_access_mode() in (EAccessMode.RO, EAccessMode.RW):
+                    return feature.to_string()
+                return None
+            return getter
+
+        def getter():
+            if feature.node.get_access_mode() in (EAccessMode.RO, EAccessMode.RW):
+                return feature.value
+            return None
+        return getter
 
     @staticmethod
     def _feature_ptype(feature: IValue) -> type:
@@ -179,8 +194,7 @@ class QGenicamCamera(QCamera):
                 return
             name = feature.node.name
             getter = self._make_getter(feature)
-            writable = (mode == EAccessMode.RW) or (name in self.protected)
-            setter = self._make_setter(feature, name) if writable else None
+            setter = self._make_setter(feature, name)
             self.registerProperty(name,
                                   getter=getter,
                                   setter=setter,
@@ -271,6 +285,7 @@ class QGenicamCamera(QCamera):
             self.harvester.reset()
         except Exception:
             pass
+        self.nodeMap = None
 
     def _deinitialize(self) -> None:
         '''Stop acquisition and release the GenICam device.'''
@@ -343,6 +358,28 @@ class QGenicamCamera(QCamera):
         logger.warning(f'node {name} is unknown')
         return None
 
+    _SHAPE_ALIASES = frozenset(('width', 'height'))
+
+    @property
+    def settings(self) -> QCamera.Settings:
+        '''All registered property values, excluding lowercase shape aliases.
+
+        GenICam cameras register ``width``/``height`` as lowercase aliases for
+        ``Width``/``Height`` so that :attr:`~QVideo.lib.QCamera.QCamera.shape`
+        and attribute access (``camera.width``) work the same as on other
+        backends.  Those aliases are excluded here so that
+        :class:`~QVideo.cameras.Genicam._tree.QGenicamTree` does not try to
+        sync them to tree parameters (which use the canonical GenICam names).
+        '''
+        return {name: spec['getter']()
+                for name, spec in self._properties.items()
+                if name not in self._SHAPE_ALIASES}
+
+    @settings.setter
+    def settings(self, settings: QCamera.Settings) -> None:
+        for key, value in settings.items():
+            self.set(key, value)
+
     def is_readwrite(self, feature: str) -> bool:
         '''Return ``True`` if the named feature is currently writable.
 

{qvideo-3.2.2 → qvideo-3.4.0}/cameras/Genicam/_tree.py

@@ -4,6 +4,7 @@ from QVideo.cameras.Genicam import QGenicamCamera
 from genicam.genapi import (IValue, EAccessMode, EVisibility,
                             ICategory, ICommand, IEnumeration,
                             IBoolean, IInteger, IFloat, IString)
+from pyqtgraph.Qt import QtCore
 import logging
 
 
@@ -21,6 +22,12 @@ class QGenicamTree(QCameraTree):
     GenICam node map and exposes visibility and per-feature enable/disable
     controls.
 
+    A timer polls the camera periodically so that autonomous camera-side
+    changes (e.g. ``Gain`` being adjusted by auto-exposure, ``GainAuto``
+    reverting from ``"Once"`` to ``"Off"``) are reflected in the UI.
+    ``PyNodeCallback`` is not used because it only fires when the **host**
+    writes a node, not when the camera changes a value autonomously.
+
     Parameters
     ----------
     camera : QGenicamCamera
@@ -48,12 +55,23 @@ class QGenicamTree(QCameraTree):
         self.controls = controls
         self.visibility = visibility
         self._updateEnabled()
+        self._pollTimer = QtCore.QTimer(self)
+        self._pollTimer.setInterval(500)
+        self._pollTimer.timeout.connect(self._pollCamera)
+        self._pollTimer.start()
+        QtCore.QCoreApplication.instance().aboutToQuit.connect(self._pollTimer.stop)
+
+    def closeEvent(self, event) -> None:
+        self._pollTimer.stop()
+        super().closeEvent(event)
 
     def description(self, camera: QGenicamCamera) -> dict:
         '''Return a dictionary describing the node map of the camera'''
         root = camera.node('Root')
+        if root is None:
+            return []
         description = self.describe(root)
-        return description['children']
+        return description.get('children', [])
 
     def describe(self, feature: IValue) -> dict[str, object]:
         '''Return a dictionary describing the specified feature'''
@@ -110,6 +128,8 @@ class QGenicamTree(QCameraTree):
             p.sigValueChanged.connect(self._handleItemChanges)
 
     def _handleItemChanges(self) -> None:
+        if self._ignoreSync:
+            return
         logger.debug('Handling item changes')
         self._updateVisible()
         self._updateEnabled()
@@ -168,6 +188,53 @@ class QGenicamTree(QCameraTree):
             finally:
                 p.blockSignals(False)
 
+    def _pollCamera(self) -> None:
+        '''Refresh all readable Parameter values and enabled states.
+
+        Called by the poll timer to pick up autonomous camera-side changes
+        that do not generate host-side notifications — e.g. ``Gain`` being
+        adjusted during auto-exposure, or ``GainAuto`` reverting from
+        ``"Once"`` to ``"Off"`` after the sweep completes.
+
+        Returns immediately if the camera is no longer open (e.g. during
+        application shutdown) to prevent accessing freed C++ genapi objects.
+
+        Signals are not blocked so that the visual widgets update and
+        ``_handleItemChanges`` fires when a value changes.
+        :attr:`_ignoreSync` is set for the duration so that the resulting
+        ``sigTreeStateChanged`` emissions do not send values back to the
+        camera.  :meth:`_updateEnabled` is called unconditionally so that
+        access-mode changes (e.g. ``ExposureTime`` becoming writable again
+        after the sweep) are reflected even when the controlling node value
+        has not changed.
+        '''
+        if not self.camera.isOpen():
+            return
+        self._ignoreSync = True
+        try:
+            self._updateLimits()
+            for item in self.listAllItems()[1:]:
+                p = item.param
+                if not p.opts.get('visible', False):
+                    continue
+                name = p.opts.get('name')
+                if not self.camera.has_node(name):
+                    continue
+                node = self.camera.node(name)
+                mode = node.node.get_access_mode()
+                if mode not in (EAccessMode.RO, EAccessMode.RW):
+                    continue
+                if isinstance(node, IEnumeration):
+                    value = node.to_string()
+                elif isinstance(node, (IBoolean, IInteger, IFloat, IString)):
+                    value = node.value
+                else:
+                    continue
+                p.setValue(value)
+            self._updateEnabled()
+        finally:
+            self._ignoreSync = False
+
     def _updateLimits(self) -> None:
         '''Refresh Parameter constraints from the live GenICam node values.
 

{qvideo-3.2.2 → qvideo-3.4.0}/cameras/IDS/_tree.py

@@ -54,7 +54,7 @@ class QIDSTree(QGenicamTree):
                  controls: list[str] | None = None,
                  **kwargs) -> None:
         camera = camera or QIDSCamera(cameraID=cameraID)
-        camera.setSettings(self._DEFAULT_SETTINGS)
+        camera.settings = self._DEFAULT_SETTINGS
         super().__init__(*args,
                          camera=camera,
                          controls=controls or self._DEFAULT_CONTROLS,

{qvideo-3.2.2 → qvideo-3.4.0}/cameras/MV/_tree.py

@@ -54,7 +54,7 @@ class QMVTree(QGenicamTree):
                  controls: list[str] | None = None,
                  **kwargs) -> None:
         camera = camera or QMVCamera(cameraID=cameraID)
-        camera.setSettings(self._DEFAULT_SETTINGS)
+        camera.settings = self._DEFAULT_SETTINGS
         super().__init__(*args,
                          camera=camera,
                          controls=controls or self._DEFAULT_CONTROLS,

{qvideo-3.2.2 → qvideo-3.4.0}/cameras/OpenCV/_resolution_tree.py

@@ -117,8 +117,12 @@ class QOpenCVResolutionTree(QCameraTree):
             if change == 'value' and param.name() == 'resolution':
                 if value in self._resolutionMap:
                     w, h = self._resolutionMap[value]
+                    fps = (self.camera.fps
+                           if 'fps' in self.camera._properties else None)
                     self.camera.set('width', w)
                     self.camera.set('height', h)
+                    if fps is not None:
+                        self.camera.set('fps', fps)
                 return
         super()._sync(root, changes)
 

qvideo-3.4.0/demos/ROIdemo.py

@@ -0,0 +1,146 @@
+#!/usr/bin/env python3
+'''Camcorder demo with a draggable ROI for recording a cropped video region.
+
+Run directly::
+
+    python -m QVideo.demos.ROIdemo
+'''
+
+from QVideo.QCamcorder import QCamcorder
+from pyqtgraph.Qt.QtCore import pyqtSignal, pyqtSlot
+import pyqtgraph as pg
+import numpy as np
+from pathlib import Path
+
+
+__all__ = ['ROIFilter', 'ROIDemo']
+
+
+class ROIFilter(pg.RectROI):
+    '''Draggable rectangular ROI that crops video frames to its bounds.
+
+    Subclasses :class:`pyqtgraph.RectROI` and adds a :attr:`newFrame`
+    signal and :meth:`crop` slot, making it compatible with
+    :class:`~QVideo.lib.QVideoWriter` as a frame source.
+
+    Parameters
+    ----------
+    fps : float
+        Frame rate of the video source [frames per second].
+        Stored as an attribute for :class:`~QVideo.lib.QVideoWriter`
+        compatibility.
+    pos : list[float]
+        Initial [x, y] position of the ROI.
+    size : list[float]
+        Initial [width, height] of the ROI.
+    **kwargs :
+        Additional keyword arguments forwarded to
+        :class:`~pyqtgraph.RectROI`.
+
+    Signals
+    -------
+    newFrame : np.ndarray
+        Emitted with the cropped frame each time :meth:`crop` is called.
+    '''
+
+    #: Emitted with the cropped frame each time :meth:`crop` is called.
+    newFrame = pyqtSignal(np.ndarray)
+
+    def __init__(self, fps: float, *args, **kwargs) -> None:
+        super().__init__(*args, **kwargs)
+        self.fps = fps
+
+    @pyqtSlot(np.ndarray)
+    def crop(self, frame: np.ndarray) -> None:
+        '''Crop *frame* to the current ROI bounds and emit :attr:`newFrame`.
+
+        Parameters
+        ----------
+        frame : np.ndarray
+            Input video frame to crop.
+        '''
+        x, y = self.pos()
+        w, h = self.size()
+        crop = frame[int(y):int(y + h), int(x):int(x + w)]
+        self.newFrame.emit(crop)
+
+
+class ROIDemo(QCamcorder):
+    '''Camcorder demo with a draggable ROI for recording cropped video.
+
+    Subclasses :class:`~QVideo.QCamcorder.QCamcorder` and overlays a
+    resizable :class:`ROIFilter` on the video screen. While recording,
+    camera frames are routed through the ROI cropper before being saved
+    by the DVR.
+
+    Parameters
+    ----------
+    cameraTree : QCameraTree
+        Camera control tree providing the video source.
+    **kwargs :
+        Additional keyword arguments forwarded to
+        :class:`~QVideo.QCamcorder.QCamcorder`.
+
+    Attributes
+    ----------
+    ROI_POS : list[int]
+        Default [x, y] position of the ROI overlay. Default: ``[100, 100]``.
+    ROI_SIZE : list[int]
+        Default [width, height] of the ROI overlay. Default: ``[400, 400]``.
+    '''
+
+    ROI_POS: list[int] = [100, 100]
+    ROI_SIZE: list[int] = [400, 400]
+
+    def _setupUi(self) -> None:
+        super()._setupUi()
+        self.roi = ROIFilter(self.source.fps,
+                             self.ROI_POS, self.ROI_SIZE,
+                             snapSize=8,
+                             scaleSnap=True,
+                             sideScalers=True,
+                             movable=True,
+                             invertible=False,
+                             rotatable=False,
+                             removable=False)
+        self.screen.view.addItem(self.roi)
+        self.dvr.filename = str(Path.home() / 'roidemo.avi')
+
+    def _connectSignals(self) -> None:
+        super()._connectSignals()
+        self.dvr.source = self.roi
+        self.dvr.recording.connect(self.recording)
+
+    @pyqtSlot(bool)
+    def recording(self, is_recording: bool) -> None:
+        '''Respond to DVR recording state changes.
+
+        Locks the ROI and connects the camera source to the ROI cropper
+        when recording starts; unlocks and disconnects when stopped.
+
+        Parameters
+        ----------
+        is_recording : bool
+            ``True`` when the DVR starts recording, ``False`` when stopped.
+        '''
+        if is_recording:
+            self.roi.movable = False
+            self.source.newFrame.connect(self.roi.crop)
+        else:
+            self.roi.movable = True
+            self.source.newFrame.disconnect(self.roi.crop)
+
+
+def main() -> None:  # pragma: no cover
+    '''Launch the ROI demo with an interactively chosen camera.'''
+    from QVideo.lib import choose_camera
+
+    pg.mkQApp()
+    camera = choose_camera().start()
+    widget = ROIDemo(camera)
+    widget.show()
+    pg.exec()
+
+
+if __name__ == '__main__':  # pragma: no cover
+    main()

qvideo-3.4.0/demos/__init__.py

@@ -0,0 +1,69 @@
+'''Runnable demo applications built on the QVideo framework.
+
+Each demo composes a :class:`~QVideo.lib.QCameraTree.QCameraTree` with one
+or more QVideo widgets into a standalone window.  All demos use
+:func:`~QVideo.lib.chooser.choose_camera` to present a camera-selection
+dialog at startup, so no camera-specific code is needed in the demo itself.
+
+Demos
+-----
+demo
+    Minimal layout: live video screen alongside a camera control tree.
+    The starting point for building a custom camera application.
+
+filterdemo
+    Extends :mod:`demo` with a :class:`~QVideo.lib.QFilterBank.QFilterBank`
+    panel so that image-processing filters can be toggled and adjusted
+    alongside the live feed.
+
+ROIdemo
+    Extends :class:`~QVideo.QCamcorder.QCamcorder` with a draggable
+    rectangular ROI overlay.  Only the cropped region is saved when
+    the DVR records, making it easy to capture a sub-region of interest.
+
+trackpydemo
+    Extends :mod:`demo` with a :class:`~QVideo.overlays.trackpy.QTrackpyWidget`
+    panel so that trackpy particle positions are overlaid on the live feed
+    in real time and locate results are available via a signal.
+
+Running
+-------
+Each demo can be launched directly::
+
+    python -m QVideo.demos.demo
+    python -m QVideo.demos.filterdemo
+    python -m QVideo.demos.ROIdemo
+    python -m QVideo.demos.trackpydemo
+
+Camera selection
+----------------
+All demos accept the same command-line flags to select a camera backend.
+If no flag is given, a noise camera is used as a fallback.
+
+.. code-block:: text
+
+    -b [cameraID]   Basler camera (requires pylon SDK)
+    -c [cameraID]   OpenCV camera
+    -f [cameraID]   FLIR camera (requires Spinnaker SDK)
+    -i [cameraID]   IDS Imaging camera (requires IDS peak SDK)
+    -m [cameraID]   MATRIX VISION mvGenTLProducer (universal GenICam, not FLIR)
+    -p [cameraID]   Raspberry Pi camera module (requires picamera2)
+    -r [cameraID]   OpenCV camera with resolution drop-down selector
+    -v [cameraID]   Allied Vision VimbaX camera
+    -h              Show help and exit
+
+``cameraID`` is an optional integer index (default ``0``) used when
+multiple cameras of the same type are connected.  The flags are mutually
+exclusive — only one backend can be selected at a time.
+
+Example::
+
+    python -m QVideo.demos.demo -f        # first FLIR camera
+    python -m QVideo.demos.filterdemo -c 1  # second OpenCV camera
+'''
+
+from .demo import Demo
+from .filterdemo import FilterDemo
+from .ROIdemo import ROIFilter, ROIDemo
+from .trackpydemo import TrackpyDemo
+