#ifndef PICK_RGB_UTILS_H
#define PICK_RGB_UTILS_H
#include "tcommon.h"
#include <QRect>
#include <QRgb>
#undef DVAPI
#undef DVVAR
#ifdef TOONZQT_EXPORTS
#define DVAPI DV_EXPORT_API
#define DVVAR DV_EXPORT_VAR
#else
#define DVAPI DV_IMPORT_API
#define DVVAR DV_IMPORT_VAR
#endif
//-------------------------------------------------------------------------------
// Forward declarations
class QWidget;
class QGLWidget;
//-------------------------------------------------------------------------------
//! Returns the average color displayed in a widget across the specified rect.
/*! This function reads the widget's frame buffer content on given rect, and returns
a mean of its pixels. The widget's background color is assumed outside the
widget bounds.
\warning Use this function only on plain widgets - in case your widget inherits
QGLWidget, invoke the overloaded function accepting a QGLWidget* type
instead.
*/
QRgb DVAPI pickRGB(QWidget *widget, const QRect &rect);
inline QRgb pickRGB(QWidget *widget, const QPoint &pos)
{
return pickRGB(widget, QRect(pos.x(), pos.y(), 1, 1));
}
//! Returns the average color displayed in a QGLWidget instance across the specified rect.
/*! This function reads the widget's front frame buffer on given rect, and returns
a mean of its pixels.
\warning Pixel colors are undefined outside the widget's geometry.
*/
QRgb DVAPI pickRGB(QGLWidget *widget, const QRect &rect);
inline QRgb pickRGB(QGLWidget *widget, const QPoint &pos)
{
return pickRGB(widget, QRect(pos.x(), pos.y(), 1, 1));
}
//! Returns the average color displayed on screen across the specified rect.
/*! This function reads the screen's buffer on given rect, and returns
a mean of its pixels.
\warning In general, grabbing an area outside the screen is not safe.
This depends on the underlying window system.
*/
QRgb DVAPI pickScreenRGB(const QRect &rect);
inline QRgb pickScreenRGB(const QPoint &pos)
{
return pickScreenRGB(QRect(pos.x(), pos.y(), 1, 1));
}
#endif //PICK_RGB_UTILS_H