CIViQ6 is a Python package which integrates VimbaPython and Qt6 multimedia scheme.
It provides:
- Class to instantiate the Vimba instance in
QThread - Camera API similar to that of QtMultimedia
- Compatibility with
QVideoSinkandQVideoWidget
The following Qt bindings are supported:
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.
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 |
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.
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.
VimbaCamera provides methods which return VimbaPython's Feature objects that can get and set the camera properties.
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.
Use cases are provided in examples directory. They can be found in documentation as well.
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 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
CIViQ6 is documented with Sphinx. Documentation can be found on Read the Docs:
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.