prepare standalone amlogic grabber

activate internal amlogic grabber forwarding


Former-commit-id: 21dabf759935836eef556baeb8a27e362e95ae96

include/grabber/AmlogicGrabber.h

@@ -0,0 +1,58 @@
+#pragma once
+
+// STL includes
+#include <cstdint>
+
+// Utils includes
+#include <utils/Image.h>
+#include <utils/ColorBgr.h>
+#include <utils/VideoMode.h>
+
+///
+/// The DispmanxFrameGrabber is used for creating snapshots of the display (screenshots) with a
+/// downsized and scaled resolution.
+///
+class AmlogicGrabber
+{
+public:
+	///
+	/// Construct a AmlogicGrabber that will capture snapshots with specified dimensions.
+	///
+	/// @param[in] width  The width of the captured screenshot
+	/// @param[in] height The heigth of the captured screenshot
+	///
+	AmlogicGrabber(const unsigned width, const unsigned height);
+	~AmlogicGrabber();
+
+	///
+	/// Set the video mode (2D/3D)
+	/// @param[in] mode The new video mode
+	///
+	void setVideoMode(const VideoMode videoMode);
+
+	///
+	/// 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)
+	/// @return Zero on success else negative
+	///
+	int grabFrame(Image<ColorBgr> & image);
+
+	/**
+	 * Returns true if video is playing over the amlogic chip
+	 * @return True if video is playing else false
+	 */
+	bool isVideoPlaying();
+private:
+
+	/// With of the captured snapshot [pixels]
+	const unsigned _width;
+	/// Height of the captured snapshot [pixels]
+	const unsigned _height;
+
+	/** The snapshot/capture device of the amlogic video chip */
+	int _amlogicCaptureDev;
+};