new frame grabber handling (#137)

* - implement framegrabber type option
- framegrabber autoselect
- integrate x11 grabber in hyperiond

* add doxy

* v4l: select device by name
hyperiond: fix x11 grabber connection to kodichecker
config: tune default prios of boblight and v4l

* make v4l name finding case insensitive

include/grabber/X11Grabber.h

@@ -28,6 +28,26 @@ public:
 	bool Setup();
 
 	Image<ColorRgb> & grab();
+	
+	///
+	/// Captures a single snapshot of the display and writes the data to the given image. The
+	/// provided image should have the same dimensions as the configured values (_width and
+	/// _height)
+	///
+	/// @param[out] image  The snapped screenshot (should be initialized with correct width and
+	/// height)
+	///
+	int grabFrame(Image<ColorRgb> & image);
+	
+	///
+	/// update dimension according current screen
+	int updateScreenDimensions();
+
+	/// gets resulting height of image
+	const unsigned getImageWidth() { return _croppedWidth; };
+
+	/// gets resulting width of image
+	const unsigned getImageHeight() { return _croppedHeight; };
 
 private:
 	ImageResampler _imageResampler;
@@ -63,7 +83,6 @@ private:
 	void freeResources();
 	void setupResources();
 	
-	int updateScreenDimensions();
 	
 	Logger * _log;
 };

include/grabber/X11Wrapper.h

@@ -0,0 +1,100 @@
+#pragma once
+
+// QT includes
+#include <QObject>
+#include <QTimer>
+
+// Utils includes
+#include <utils/Image.h>
+#include <utils/ColorRgb.h>
+#include <utils/GrabbingMode.h>
+#include <utils/VideoMode.h>
+
+// Forward class declaration
+class X11Grabber;
+class Hyperion;
+class ImageProcessor;
+
+///
+/// The X11Wrapper uses an instance of the X11Grabber to obtain ImageRgb's from the
+/// displayed content. This ImageRgb is processed to a ColorRgb for each led and commmited to the
+/// attached Hyperion.
+///
+class X11Wrapper: public QObject
+{
+	Q_OBJECT
+public:
+	///
+	/// Constructs the framebuffer frame grabber with a specified grab size and update rate.
+	///
+	/// @param[in] device X11 device name/path
+	/// @param[in] grabWidth  The width of the grabbed image [pixels]
+	/// @param[in] grabHeight  The height of the grabbed images [pixels]
+	/// @param[in] updateRate_Hz  The image grab rate [Hz]
+	///
+	X11Wrapper(bool useXGetImage, int cropLeft, int cropRight, int cropTop, int cropBottom, int horizontalPixelDecimation, int verticalPixelDecimation, const unsigned updateRate_Hz, const int priority);
+
+	///
+	/// Destructor of this framebuffer frame grabber. Releases any claimed resources.
+	///
+	virtual ~X11Wrapper();
+
+public slots:
+	///
+	/// Starts the grabber wich produces led values with the specified update rate
+	///
+	void start();
+
+	///
+	/// Performs a single frame grab and computes the led-colors
+	///
+	void action();
+
+	///
+	/// Stops the grabber
+	///
+	void stop();
+
+	///
+	/// Set the grabbing mode
+	/// @param[in] mode The new grabbing mode
+	///
+	void setGrabbingMode(const GrabbingMode mode);
+
+	///
+	/// Set the video mode (2D/3D)
+	/// @param[in] mode The new video mode
+	///
+	void setVideoMode(const VideoMode videoMode);
+
+signals:
+	void emitImage(int priority, const Image<ColorRgb> & image, const int timeout_ms);
+
+private:
+	/// The update rate [Hz]
+	const int _updateInterval_ms;
+	/// The timeout of the led colors [ms]
+	const int _timeout_ms;
+	/// The priority of the led colors
+	const int _priority;
+
+	/// The timer for generating events with the specified update rate
+	QTimer _timer;
+
+	/// The image used for grabbing frames
+	Image<ColorRgb> _image;
+	/// The actual grabber
+	X11Grabber * _grabber;
+	/// The processor for transforming images to led colors
+	ImageProcessor * _processor;
+
+	/// The list with computed led colors
+	std::vector<ColorRgb> _ledColors;
+
+	/// Pointer to Hyperion for writing led values
+	Hyperion * _hyperion;
+	
+	bool _init;
+	bool _x11SetupSuccess;
+};
+