qarv - a Qt interface to Aravis

DESCRIPTION

qarv provides a Qt interface to GeniCam ethernet cameras via the Aravis library.

For a user, qarv provides:

- Viewing the video, recording it and taking snapshots, with basic
  controls, such as frames-per-second, pixel format and
  exposure/gain easily accessible. Region-of-interest can be
  selected via manual entry or by drawing it directly in the video
  display.

- A viewer and transcoder for raw video dumps recorded with qarv.

- The network interface used by the camera is automatically
  detected and camera's packet size is set to match the interface
  MTU, providing usable (hopefully) performance with minimal
  interaction, unlike the default settings on some cameras.

- Full access to all camera features is available in a tree view.
  Settings can be saved and restored, subject to some limitations.

- Basic image transformations: mirroring, rotating, inverting.

- Histogram; clipped highlights can be marked in the video
  display.

For a programmer, qarv provides:

- QArvCamera class which isolates the Qt program from Aravis
  internals, thus avoiding clashes between Qt and Glib/GTK. It
  provides direct access to basic settings and emits signals when
  frames are ready. To access features not covered by the basic
  interface, it implements the QAbstractItemModel interface. This
  interface allows access to camera features using Qt's Model/View
  paradigm. The QArvCamera model can thus be plugged directly into
  a "view" widget, as is done in our GUI.

- QArvCameraDelegate class which implements the
  QStyledItemDelegate interface. It can be used with the
  QArvCamera model to get editing widgets for camera features.

- QArvGui class provides a camera control window that can be
  embedded into a host application. It is the same as the
  standalone application; in fact, the latter is simply a minimal
  host application. The difference is in the recording
  functionality: instead of recording to a file, the GUI will emit
  signals and pass frames to the host application.

- QArvDecoder and QArvPixelFormat, which are plugin interfaces for
  converting a raw frame into an OpenCV image. Convenience
  functions are available to obtain QImages. Currently provided
  are decoders for 8, 10, 12 (packed or unpacked) and 16 bit
  grayscale formats, plus anything supported by libav/ffmpeg. The
  libav plugin is exposed further to allow easy decoding of all
  pixel formats, not just those used by Aravis.

- QArvRecordedVideo class, which can read a raw video dumped by
  the qarv GUI and generate a QArvDecoder for decoding the frames.

- All of this is provided as libqarv, with headers installed in a
  standard location, such as /usr/include/qarv-1/.

Homepage: http://www.ad-vega.si/en/software/qarv Repository: https://github.com/AD-Vega/qarv Aravis: https://live.gnome.org/Aravis

REQUIREMENTS AND INSTALLATION

qarv requires Qt 5 (tested with 5.11), aravis-0.2 or later, OpenCV and either libav or ffmpeg.

Optionally, gstreamer-1.0 with the base, good, bad and libav plugin sets allows recording and transcoding to AVI and other non-raw formats. The gstreamer version should be at least 1.0.7; earlier versions have a bug that prevents them from working with qarv.

qarv is built using CMake. If you are not familiar with CMake, refer to any tutorial. But for starters, run these commands from the qarv source directory:

mkdir build cd build cmake .. make sudo make install

You can skip the "make install" step and run qarv from the build directory directly, although there might be problems with localization and icon loading.

API documentation can be generated when Doxygen is installed by running

make doc

LICENSING INFORMATION

qarv is provided under the GNU General Public License, version 3 or later. See COPYING for more information.

The icons included with qarv are part of the oxygen theme from the KDE project (www.kde.org). See res/icons/COPYING for licensing information.

The qarv icon itself is derived from the oxygen theme as well.

Copyright 2012-2015 Jure Varlec