Skip to content

Latest commit

 

History

History
107 lines (83 loc) · 3.2 KB

README.md

File metadata and controls

107 lines (83 loc) · 3.2 KB
Raw

GTK UVC VIEWER (guvcview)

Basic Configuration

Dependencies:

Guvcview depends on the following:

  • intltool,
  • autotools,
  • libsdl2 and/or sfml,
  • libgtk-3 or libqt5,
  • portaudio19,
  • libpng,
  • libavcodec,
  • libavutil,
  • libv4l,
  • libudev,
  • libusb-1.0,
  • libpulse (optional)
  • libgsl0 (optional)

On most distributions you can just install the development packages: intltool, autotools-dev, libsdl2-dev, libsfml-dev, libgtk-3-dev or qtbase5-dev, portaudio19-dev, libpng12-dev, libavcodec-dev, libavutil-dev, libv4l-dev, libudev-dev, libusb-1.0-0-dev, libpulse-dev, libgsl0-dev

Build configuration:

(./bootstrap.sh; ./configure)

The configure script is generated from configure.ac by autoconf, the helper script ./bootstrap.sh can be used for this, it will also run the generated configure with the command line options passed. After configuration a simple 'make && make install' will build and install guvcview and all the associated data files.

guvcview will build with Gtk3 support by default, if you want to use the Qt5 interface instead, just run ./configure --disable-gtk3 --enable-qt5 you can use SDL2 (enabled by default) and/or SFML (disabled by default) as the rendering engine, both engines can be enabled during configure so that you can choose between the two with a command line option.

Data Files:

(language files; image files; gnome menu entry)

guvcview data files are stored by default to /usr/local/share setting a different prefix (--prefix=BASEDIR) during configuration will change the installation path to BASEDIR/share.

Built files, src/guvcview and data/gnome.desktop, are dependent on this path, so if a new prefix is set a make clean is required before issuing the make command.

After running the configure script the normal, make && make install should build and install all the necessary files.

guvcview bin:

(guvcview)

The binarie file installs to the standart location, /usr/local/bin, to change the install path, configure must be executed with --prefix=DIR set, this will cause the bin file to be installed in DIR/bin, make sure DIR/bin is set in your PATH variable, or the gnome menu entry will fail.

guvcview libraries:

(libgviewv4l2core, libgviewrender, libgviewaudio, libgviewencoder)

The core functionality of guvcview is now split into 4 libraries these will install to ${prefix}/lib and development headers to ${prefix}/include/guvcview-2/libname. pkg-config should be use to determine the compile flags.

guvcview.desktop:

(data/guvcview.desktop)

The desktop file (gnome menu entry) is built from the data/guvcview.desktop.in definition and is dependent on the configure --prefix setting, any changes to this, must be done in data/guvcview.desktop.in.

configuration files:

(~/.config/guvcview2/video0)

The configuration file is saved into the $HOME dir when exiting guvcview. If a video device with index > 0, e.g: /dev/video1 is used then the file stored will be named ~/.config/guvcview2/video1

Executing guvcview

For instructions on the command line args execute "guvcview --help".