X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=src%2Fcolortools.h;h=0441377c4e8df12bc923dc385ea81444ec772ee9;hb=90e0ecffea8748dbb97479dafb5e50af3a71e471;hp=6a4ec19d3e12c658d39c0162fdd3932c8b36cc18;hpb=2f0bbf264645a589fad0cb4b7d686699a00ed00f;p=kdenlive diff --git a/src/colortools.h b/src/colortools.h index 6a4ec19d..0441377c 100644 --- a/src/colortools.h +++ b/src/colortools.h @@ -17,6 +17,8 @@ #include + + class ColorTools : public QObject { Q_OBJECT @@ -24,6 +26,8 @@ class ColorTools : public QObject public: ColorTools(); + enum ColorsRGB { COL_R, COL_G, COL_B, COL_Luma }; + /** @brief Draws a UV plane with given Y value. scaling defines how far to zoom in (or out). Lower value = zoom in. @@ -31,10 +35,36 @@ public: If not the full rect should be filled, set circleOnly to true. See also: http://en.wikipedia.org/wiki/YUV and http://de.wikipedia.org/wiki/Vektorskop */ - QImage yuvColorWheel(const QSize& size, const unsigned char Y, const float scaling, const bool modifiedVersion, const bool circleOnly); + QImage yuvColorWheel(const QSize& size, const unsigned char &Y, const float &scaling, const bool &modifiedVersion, const bool &circleOnly); + /** + @brief Draws a UV plane with given UV angle (ratio u:v stays constant) + scaling defines how far to zoom in (or out). Lower value = zoom in. + angle defines the angle in a default U/V plane. A vertical plane, on which Y goes from 0 to 1, + is then laid through the UV plane, with the defined angle. + @see yuvColorWheel() + */ + QImage yuvVerticalPlane(const QSize &size, const float &angle, const float &scaling); + /** + @brief Draws a RGB plane with two values on one axis and one on the other. + This is e.g. useful as background for a curves dialog. On the line from bottom left to top right + are neutral colors. The colors on the y axis show what the neutral color will look like when modifying the curve. + color defines the color to modify on the y axis. The other two components will be increased + in equal terms (linear as well) on the x axis. + scaling \in ]0,1] defines the maximum variance of the selected component; Chosing a value lower than 1 + simulates the case that the curves can adjust only +- scaling*255. This mainly delivers a more constant look + when also using the Luma component for the curves display but might not represent the actual color change! + */ + static QImage rgbCurvePlane(const QSize &size, const ColorTools::ColorsRGB &color, float scaling = 1); + /** + @brief Draws a YPbPr plane with Pb on the x axis and Pr on the y axis. + Y is the Y value to use. + scaling defines how far to zoom in (or out). Lower value = zoom in. + See also: http://de.wikipedia.org/wiki/YPbPr-Farbmodell and http://www.poynton.com/ColorFAQ.html + */ + QImage yPbPrColorWheel(const QSize &size, const unsigned char &Y, const float &scaling, const bool &circleOnly); signals: - void signalWheelCalculationFinished(); + void signalYuvWheelCalculationFinished(); }; #endif // COLORTOOLS_H