Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jss95/civiq6

Python package to integrate VimbaPython with Qt6.
https://github.com/jss95/civiq6

pyqt6 pyside6 python qt6 vimba vimba-python vimba-sdk

Last synced: 26 days ago
JSON representation

Python package to integrate VimbaPython with Qt6.

Host: GitHub
URL: https://github.com/jss95/civiq6
Owner: JSS95
License: mit
Created: 2022-06-07T14:35:23.000Z (over 2 years ago)
Default Branch: master
Last Pushed: 2023-09-26T06:46:59.000Z (about 1 year ago)
Last Synced: 2024-04-23T08:07:58.710Z (7 months ago)
Topics: pyqt6, pyside6, python, qt6, vimba, vimba-python, vimba-sdk
Language: Python
Homepage: https://civiq6.readthedocs.io/
Size: 131 KB
Stars: 2
Watchers: 1
Forks: 1
Open Issues: 2
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # CIViQ6 - Camera Integration for Vimba and Qt6

[![PyPI version](https://badge.fury.io/py/CIViQ6.svg)](https://badge.fury.io/py/CIViQ6)

[![Python Version](https://img.shields.io/pypi/pyversions/civiq6)](https://pypi.org/project/civiq6/)

[![Build Status](https://github.com/JSS95/civiq6/actions/workflows/ci.yml/badge.svg)](https://github.com/JSS95/civiq6/actions/workflows/ci.yml)

[![Documentation Status](https://readthedocs.org/projects/civiq6/badge/?version=latest)](https://civiq6.readthedocs.io/en/latest/?badge=latest)

[![License](https://img.shields.io/github/license/JSS95/civiq6)](https://github.com/JSS95/civiq6/blob/master/LICENSE)

CIViQ6 is a Python package which integrates [VimbaPython](https://github.com/alliedvision/VimbaPython) and Qt6 multimedia scheme.

It provides:

- Class to instantiate the Vimba instance in `QThread`

- Camera API similar to that of QtMultimedia

- Compatibility with `QVideoSink` and `QVideoWidget`

The following Qt bindings are supported:

- [PySide6](https://pypi.org/project/PySide6/)

- [PyQt6](https://pypi.org/project/PyQt6/)

This package is tested using Vimba 6.0, VimbaPython 1.2.1, and Mako U-130B camera device connected to the device with Window 11.

# How to use

CIViQ6 imitates QtMultimedia scheme to provide API for the Allied Vision camera device.

|     CIViQ6 class    |    Qt6 counterpart   |

| ------------------- | -------------------- |

|     VimbaRunner     |           -          |

|     VimbaDevices    |      QMediaDevices   |

|  VimbaCameraDevice  |      QCameraDevice   |

|     VimbaCamera     |        QCamera       |

| VimbaCaptureSession | QMediaCaptureSession |

## Running the Vimba instance

`VimbaRunner` is a runner which wraps the VimbaPython API and starts Vimba.

To start the Vimba instance, move `VimbaRunner` to a dedicated `QThread` and run it.

This task must be done before any other Vimba-related operation.

## Streaming the camera

Once the Vimba instance is started, user can construct `VimbaCamera` instance, set it to `VimbaCaptureSession`, and run it just as one would do with `QCamera` and `QMediaCaptureSession`.

Set `QVideoWidget` or `QVideoSink` (or any other `QObject`-based preview) to the capture session to stream the camera.

## Setting the camera properties

`VimbaCamera` provides methods which return VimbaPython's `Feature` objects that can get and set the camera properties.

## Capturing and recording

Unlike Qt6, CIViQ6 does not have default classes that support image capturing and video recording from `VimbaCaptureSession`. User must define own classes that write VimbaPython's `Frame` object to file.

The documentaion provides examples for defining the image capturer and video recorder.

# Examples

Use cases are provided in [examples](https://github.com/JSS95/civiq6/tree/master/civiq6/examples) directory.

They can be found in documentation as well.

# Installation

Before you install, be careful for other Qt-dependent packages installed in your environment.

For example, non-headless `OpenCV-Python` modifies the Qt dependency thus can make other Qt bindings unavailable.

To install CIViQ6, you first need to install [VimbaPython](https://github.com/alliedvision/VimbaPython) package which is not distributed by PyPI.

Go to its repository and follow the instructions.

After VimbaPython is installed, `civiq6` can be installed using `pip`.

```

$ pip install civiq6

```

# Documentation

CIViQ6 is documented with [Sphinx](https://pypi.org/project/Sphinx/).

Documentation can be found on Read the Docs:

> https://civiq6.readthedocs.io/

If you want to build the document yourself, clone the source code and install with `[doc]` option.

This option installs the additional packages to build the document and to run the examples.

Go to `doc` directory and build the document.

```

$ pip install civiq6[doc]

$ cd doc

$ make html

```

Document will be generated in `build/html` directory. Open `index.html` to see the central page.