KImageEffect Class Reference
This class includes various QImage based graphical effects. More...
#include <kimageeffect.h>
Public Types | |
enum | GradientType { VerticalGradient, HorizontalGradient, DiagonalGradient, CrossDiagonalGradient, PyramidGradient, RectangleGradient, PipeCrossGradient, EllipticGradient } |
enum | RGBComponent { Red, Green, Blue, Gray, All } |
enum | Lighting { NorthLite, NWLite, WestLite, SWLite, SouthLite, SELite, EastLite, NELite } |
enum | ModulationType { Intensity, Saturation, HueShift, Contrast } |
enum | NoiseType { UniformNoise = 0, GaussianNoise, MultiplicativeGaussianNoise, ImpulseNoise, LaplacianNoise, PoissonNoise } |
enum | RotateDirection { Rotate90, Rotate180, Rotate270 } |
enum | BumpmapType { Linear, Spherical, Sinuosidal } |
enum | Disposition { NoImage = 0, Centered, Tiled, CenterTiled, CenteredMaxpect, TiledMaxpect, Scaled, CenteredAutoFit } |
Static Public Member Functions | |
static QImage | gradient (const QSize &size, const QColor &ca, const QColor &cb, GradientType type, int ncols=3) |
static QImage | unbalancedGradient (const QSize &size, const QColor &ca, const QColor &cb, GradientType type, int xfactor=100, int yfactor=100, int ncols=3) |
static QImage & | blend (const QColor &clr, QImage &dst, float opacity) |
static QImage & | blend (QImage &src, QImage &dst, float opacity) |
static QImage & | blend (QImage &image, float initial_intensity, const QColor &bgnd, GradientType eff, bool anti_dir=false) |
static QImage & | blend (QImage &image1, QImage &image2, GradientType gt, int xf=100, int yf=100) |
static QImage & | blend (QImage &image1, QImage &image2, QImage &blendImage, RGBComponent channel) |
static bool | blend (const QImage &upper, const QImage &lower, QImage &output) |
static bool | blend (int &x, int &y, const QImage &upper, const QImage &lower, QImage &output) |
static bool | blendOnLower (int x, int y, const QImage &upper, const QImage &lower) |
static void | blendOnLower (const QImage &upper, const QPoint &upperOffset, QImage &lower, const QRect &lowerRect) |
static void | blendOnLower (const QImage &upper, const QPoint &upperOffset, QImage &lower, const QRect &lowerRect, float opacity) |
static QRect | computeDestinationRect (const QSize &lowerSize, Disposition disposition, QImage &upper) |
static void | blendOnLower (QImage &upper, QImage &lower, Disposition disposition, float opacity) |
static QImage & | channelIntensity (QImage &image, float percent, RGBComponent channel) |
static QImage & | fade (QImage &image, float val, const QColor &color) |
static QImage & | flatten (QImage &image, const QColor &ca, const QColor &cb, int ncols=0) |
static QImage & | hash (QImage &image, Lighting lite=NorthLite, unsigned int spacing=0) |
static QImage & | intensity (QImage &image, float percent) |
static QImage & | modulate (QImage &image, QImage &modImage, bool reverse, ModulationType type, int factor, RGBComponent channel) |
static QImage & | toGray (QImage &image, bool fast=false) |
static QImage & | desaturate (QImage &image, float desat=0.3) |
static QImage & | contrast (QImage &image, int c) |
static QImage & | dither (QImage &image, const QColor *palette, int size) |
static QImage & | selectedImage (QImage &img, const QColor &col) |
static void | contrastHSV (QImage &img, bool sharpen=true) |
static void | normalize (QImage &img) |
static void | equalize (QImage &img) |
static void | threshold (QImage &img, unsigned int value=128) |
static void | solarize (QImage &img, double factor=50.0) |
static QImage | emboss (QImage &src, double radius, double sigma) |
static QImage | emboss (QImage &src) |
static QImage | despeckle (QImage &src) |
static QImage | charcoal (QImage &src, double radius, double sigma) |
static QImage | charcoal (QImage &src, double factor=50.0) |
static QImage | rotate (QImage &src, RotateDirection r) |
static QImage | sample (QImage &src, int w, int h) |
static QImage | addNoise (QImage &src, NoiseType type=GaussianNoise) |
static QImage | blur (QImage &src, double radius, double sigma) |
static QImage | blur (QImage &src, double factor=50.0) |
static QImage | edge (QImage &src, double radius) |
static QImage | implode (QImage &src, double factor=30.0, unsigned int background=0xFFFFFFFF) |
static QImage | oilPaintConvolve (QImage &src, double radius) |
static QImage | oilPaint (QImage &src, int radius=3) |
static QImage | sharpen (QImage &src, double radius, double sigma) |
static QImage | sharpen (QImage &src, double factor=30.0) |
static QImage | spread (QImage &src, unsigned int amount=3) |
static QImage | shade (QImage &src, bool color_shading=true, double azimuth=30.0, double elevation=30.0) |
static QImage | swirl (QImage &src, double degrees=50.0, unsigned int background=0xFFFFFFFF) |
static QImage | wave (QImage &src, double amplitude=25.0, double frequency=150.0, unsigned int background=0xFFFFFFFF) |
static QImage | bumpmap (QImage &img, QImage &map, double azimuth, double elevation, int depth, int xofs, int yofs, int waterlevel, int ambient, bool compensate, bool invert, BumpmapType type, bool tiled) |
Detailed Description
This class includes various QImage based graphical effects.Everything is static, so there is no need to create an instance of this class. You can just call the static methods. They are encapsulated here merely to provide a common namespace.
Definition at line 50 of file kimageeffect.h.
Member Enumeration Documentation
|
This enum provides a gradient type specification.
Definition at line 58 of file kimageeffect.h. |
|
This enum provides a RGB channel specification.
Definition at line 73 of file kimageeffect.h. |
|
This enum provides a lighting direction specification.
Definition at line 84 of file kimageeffect.h. |
|
This enum provides a modulation type specification.
Definition at line 98 of file kimageeffect.h. |
|
This enum provides a noise type specification.
Definition at line 108 of file kimageeffect.h. |
|
This enum provides a rotation specification.
Definition at line 120 of file kimageeffect.h. |
|
This enum lists possible bumpmapping implementations.
Definition at line 129 of file kimageeffect.h. |
|
Disposition of a source image on top of a destination image.
Definition at line 326 of file kimageeffect.h. |
Member Function Documentation
|
Create a gradient from color a to color b of the specified type.
Definition at line 123 of file kimageeffect.cpp. References QColor::blue(), QPixmap::defaultDepth(), dither(), endl(), QColor::green(), QSize::height(), QColor::red(), QImage::scanLine(), QColor::setRgb(), and QSize::width(). Referenced by KPixmapEffect::gradient(). |
|
Create an unbalanced gradient. An unbalanced gradient is a gradient where the transition from color a to color b is not linear, but in this case, exponential.
Definition at line 387 of file kimageeffect.cpp. References QColor::blue(), QPixmap::defaultDepth(), dither(), QColor::green(), QSize::height(), QColor::red(), QColor::rgb(), QImage::scanLine(), QColor::setRgb(), and QSize::width(). Referenced by blend(), and KPixmapEffect::unbalancedGradient(). |
|
Blends a color into the destination image, using an opacity value for blending one into another. Very fast direct pixel manipulation is used. This function uses MMX and SSE2 instructions to blend the image on processors that support it.
Definition at line 1066 of file kimageeffect.cpp. References QImage::bits(), QColor::blue(), QImage::convertDepth(), QImage::depth(), QColor::green(), KCPUInfo::haveExtension(), QImage::height(), KCPUInfo::IntelMMX, KCPUInfo::IntelSSE2, QColor::red(), QColor::rgb(), and QImage::width(). Referenced by KPixmapEffect::blend(), blend(), and selectedImage(). |
|
Blend the src image into the destination image, using an opacity value for blending one into another. Very fast direct pixel manipulation is used. This function uses MMX and SSE2 instructions to blend the images on processors that support it.
Definition at line 1307 of file kimageeffect.cpp. References QImage::bits(), QImage::convertDepth(), QImage::depth(), KCPUInfo::haveExtension(), QImage::height(), KCPUInfo::IntelMMX, KCPUInfo::IntelSSE2, and QImage::width(). |
|
Blend the provided image into a background of the indicated color.
Definition at line 1536 of file kimageeffect.cpp. References QImage::bits(), QColor::blue(), QImage::depth(), endl(), QColor::green(), QImage::height(), intensity(), QColor::red(), and QImage::width(). |
|
Blend an image into another one, using a gradient type for blending from one to another.
Definition at line 1744 of file kimageeffect.cpp. References blend(), QImage::height(), Red, QImage::size(), unbalancedGradient(), and QImage::width(). |
|
Blend an image into another one, using a color channel of a third image for the decision of blending from one to another.
Definition at line 1762 of file kimageeffect.cpp. References QImage::bits(), Blue, QImage::colorTable(), QImage::convertDepth(), QImage::depth(), endl(), Green, QImage::height(), Red, and QImage::width(). |
|
Blend an image into another one, using alpha in the expected way.
Definition at line 2377 of file kimageeffect.cpp. References QImage::copy(), QImage::depth(), QImage::height(), QImage::scanLine(), and QImage::width(). |
|
Blend an image into another one, using alpha in the expected way and over coordinates
The output is a QImage which is the
Definition at line 2449 of file kimageeffect.cpp. References QImage::create(), QImage::depth(), QImage::height(), QImage::scanLine(), and QImage::width(). |
|
Blend an image into another one, using alpha in the expected way and over coordinates
The output is painted in the own
Definition at line 2513 of file kimageeffect.cpp. References QImage::depth(), QImage::height(), QImage::scanLine(), and QImage::width(). Referenced by blendOnLower(). |
|
Blend part of an image into part of another, using the alpha channel in the expected way. Note that the destination rectangle will be correctly clipped.
Definition at line 2583 of file kimageeffect.cpp. References QImage::height(), QRect::height(), QRect::isValid(), QImage::rect(), QImage::scanLine(), QRect::setHeight(), QRect::setWidth(), QImage::width(), QRect::width(), QRect::x(), QPoint::x(), QRect::y(), and QPoint::y(). |
|
Blend part of an image into part of another, using the opacity value and the alpha channel in the expected way. Note that the destination rectangle will be correctly clipped.
Definition at line 2605 of file kimageeffect.cpp. References QImage::height(), QRect::height(), QRect::isValid(), QImage::rect(), QImage::scanLine(), QRect::setHeight(), QRect::setWidth(), QImage::width(), QRect::width(), QRect::x(), QPoint::x(), QRect::y(), and QPoint::y(). |
|
Compute the destination rectangle where to draw the upper image on top of another image using the given disposition. For tiled disposition, the rectangle should be duplicated on the whole area to obtained the wanted effect.
Definition at line 2627 of file kimageeffect.cpp. References Centered, CenteredAutoFit, CenteredMaxpect, CenterTiled, QImage::height(), QSize::height(), NoImage, Scaled, QRect::setCoords(), QRect::setRect(), QImage::smoothScale(), Tiled, TiledMaxpect, QImage::width(), and QSize::width(). Referenced by blendOnLower(). |
|
Blend an image on top of another using a given disposition and a given opacity. The alpha channel of the upper image is used in the expected way. Beware the upper image may be modified.
Definition at line 2692 of file kimageeffect.cpp. References blendOnLower(), QRect::bottom(), computeDestinationRect(), QImage::height(), QRect::left(), QRect::right(), QImage::size(), QRect::top(), and QImage::width(). |
|
Modifies the intensity of a pixmap's RGB channel component.
Definition at line 845 of file kimageeffect.cpp. References QImage::bits(), QImage::colorTable(), QImage::depth(), Green, QImage::height(), QImage::numColors(), Red, and QImage::width(). Referenced by KPixmapEffect::channelIntensity(). |
|
Fade an image to a certain background color. The number of colors will not be changed.
Definition at line 2043 of file kimageeffect.cpp. References QColor::blue(), QImage::color(), QImage::depth(), QColor::green(), QImage::height(), QImage::numColors(), QColor::red(), QImage::scanLine(), QImage::setColor(), and QImage::width(). Referenced by KPixmapEffect::fade(). |
|
This recolors a pixmap. The most dark color will become color a, the most bright one color b, and in between.
Definition at line 1946 of file kimageeffect.cpp. References QColor::blue(), QImage::color(), QImage::depth(), dither(), QColor::green(), QImage::height(), QImage::numColors(), QImage::pixel(), QColor::red(), QColor::rgb(), QImage::setColor(), QImage::setPixel(), and QImage::width(). Referenced by KPixmapEffect::pattern(). |
|
Build a hash on any given QImage.
Definition at line 1865 of file kimageeffect.cpp. References QImage::bits(), EastLite, endl(), QImage::height(), NELite, NorthLite, NWLite, SELite, SouthLite, SWLite, WestLite, and QImage::width(). Referenced by KPixmapEffect::hash(). |
|
Either brighten or dim the image by a specified percent. For example, .50 will modify the colors by 50%. This function uses MMX instructions to process the image on processors that support it.
Definition at line 653 of file kimageeffect.cpp. References QImage::bits(), QImage::colorTable(), QImage::depth(), KCPUInfo::haveExtension(), QImage::height(), KCPUInfo::IntelMMX, QImage::numColors(), and QImage::width(). Referenced by blend(), and KPixmapEffect::intensity(). |
|
Modulate the image with a color channel of another image.
Definition at line 936 of file kimageeffect.cpp. References All, Blue, QImage::colorTable(), Contrast, QImage::convertDepth(), QImage::depth(), Gray, Green, QImage::height(), QColor::hsv(), HueShift, Intensity, Red, QColor::rgb(), Saturation, QImage::scanLine(), QColor::setHsv(), QColor::setRgb(), and QImage::width(). |
|
Convert an image to grayscale.
Definition at line 2125 of file kimageeffect.cpp. References QImage::bits(), QImage::color(), QImage::colorTable(), QImage::depth(), QImage::height(), QImage::numBytes(), QImage::numColors(), QImage::setColor(), and QImage::width(). Referenced by charcoal(), and KPixmapEffect::toGray(). |
|
Desaturate an image evenly.
Definition at line 2175 of file kimageeffect.cpp. References QImage::bits(), QImage::colorTable(), QImage::depth(), QImage::height(), QColor::hsv(), QImage::numColors(), QColor::rgb(), QColor::setHsv(), QColor::setRgb(), and QImage::width(). Referenced by KPixmapEffect::desaturate(). |
|
Fast, but low quality contrast of an image. Also see contrastHSV.
Definition at line 2198 of file kimageeffect.cpp. References QImage::bits(), QImage::colorTable(), QImage::depth(), QImage::height(), QImage::numColors(), and QImage::width(). Referenced by KPixmapEffect::contrast(). |
|
Dither an image using Floyd-Steinberg dithering for low-color situations.
Definition at line 2260 of file kimageeffect.cpp. References QColor::blue(), QImage::depth(), QColor::green(), QImage::height(), QColor::red(), QImage::scanLine(), QImage::setColor(), QImage::setNumColors(), and QImage::width(). Referenced by KPixmapEffect::blend(), KPixmapEffect::dither(), flatten(), gradient(), KPixmapEffect::hash(), and unbalancedGradient(). |
|
Calculate the image for a selected image, for instance a selected icon on the desktop.
Definition at line 2704 of file kimageeffect.cpp. References blend(). Referenced by KPixmapEffect::selectedPixmap(). |
|
High quality, expensive HSV contrast. You can do a faster one by just taking a intensity threshold (ie: 128) and incrementing RGB color channels above it and decrementing those below it, but this gives much better results.
Definition at line 4642 of file kimageeffect.cpp. References QImage::bits(), QColor::blue(), QImage::colorTable(), QImage::depth(), QColor::green(), QImage::height(), QColor::hsv(), QImage::numColors(), QColor::red(), QColor::setHsv(), QColor::setRgb(), and QImage::width(). |
|
Normalises the pixel values to span the full range of color values. This is a contrast enhancement technique.
Definition at line 3721 of file kimageeffect.cpp. References QImage::convertDepth(), QImage::depth(), QImage::height(), QImage::scanLine(), and QImage::width(). Referenced by charcoal(). |
|
Performs histogram equalisation on the reference image.
Definition at line 3931 of file kimageeffect.cpp. References QImage::convertDepth(), QImage::depth(), QImage::height(), QImage::scanLine(), and QImage::width(). Referenced by emboss(). |
|
Thresholds the reference image. You can also threshold images by using ThresholdDither in the various QPixmap/QImage convert methods, but this lets you specify a threshold value.
Definition at line 2839 of file kimageeffect.cpp. References QImage::bits(), QImage::colorTable(), QImage::depth(), QImage::height(), QImage::numColors(), and QImage::width(). Referenced by solarize(). |
|
Produces a 'solarization' effect seen when exposing a photographic film to light during the development process.
Definition at line 3450 of file kimageeffect.cpp. References QImage::bits(), QImage::colorTable(), QImage::depth(), QImage::height(), QImage::numColors(), threshold(), and QImage::width(). |
|
Embosses the source image. This involves highlighting the edges and applying various other enhancements in order to get a metal effect.
Definition at line 4069 of file kimageeffect.cpp. References QImage::convertDepth(), QImage::depth(), equalize(), QImage::height(), and QImage::width(). Referenced by emboss(). |
|
Convenience method.
Definition at line 4063 of file kimageeffect.cpp. References emboss(). |
|
Minimizes speckle noise in the source image using the 8 hull algorithm.
Definition at line 2935 of file kimageeffect.cpp. References QImage::colorTable(), QImage::depth(), QImage::height(), QImage::scanLine(), and QImage::width(). |
|
Produces a neat little "charcoal" effect.
Definition at line 3711 of file kimageeffect.cpp. References blur(), edge(), QImage::invertPixels(), normalize(), and toGray(). Referenced by charcoal(). |
|
This is provided for binary compatability only! Use the above method with a radius and sigma instead!
Definition at line 3705 of file kimageeffect.cpp. References charcoal(). |
|
Rotates the image by the specified amount.
Definition at line 3352 of file kimageeffect.cpp. References QImage::colorTable(), QImage::create(), QImage::depth(), QImage::height(), QImage::numColors(), Rotate180, Rotate270, Rotate90, QImage::scanLine(), QImage::setNumColors(), and QImage::width(). |
|
Scales an image using simple pixel sampling. This does not produce nearly as nice a result as QImage::smoothScale(), but has the advantage of being much faster - only a few milliseconds.
Definition at line 2746 of file kimageeffect.cpp. References QImage::colorTable(), QImage::depth(), QImage::height(), QImage::numColors(), QImage::scanLine(), QImage::setNumColors(), and QImage::width(). |
|
Adds noise to an image.
Definition at line 3141 of file kimageeffect.cpp. References QImage::colorTable(), QImage::depth(), QImage::height(), QImage::scanLine(), and QImage::width(). |
|
Blurs an image by convolving pixel neighborhoods.
Definition at line 4288 of file kimageeffect.cpp. References QImage::convertDepth(), QImage::create(), QImage::depth(), QImage::height(), QImage::jumpTable(), QImage::scanLine(), and QImage::width(). Referenced by blur(), and charcoal(). |
|
This is provided for binary compatability only! Use the above method with a radius and sigma instead!
Definition at line 4282 of file kimageeffect.cpp. References blur(). |
|
Detects edges in an image using pixel neighborhoods and an edge detection mask.
Definition at line 4031 of file kimageeffect.cpp. References QImage::height(), and QImage::width(). Referenced by charcoal(). |
|
Implodes an image by a specified percent.
Definition at line 3271 of file kimageeffect.cpp. References QImage::colorTable(), QImage::depth(), QImage::height(), QImage::scanLine(), and QImage::width(). |
|
Produces an oil painting effect.
Definition at line 3641 of file kimageeffect.cpp. References QImage::convertDepth(), QImage::depth(), QImage::detach(), QImage::height(), QImage::jumpTable(), QImage::scanLine(), and QImage::width(). Referenced by oilPaint(). |
|
This is provided for binary compatability only! Use the above method instead!
Definition at line 3635 of file kimageeffect.cpp. References oilPaintConvolve(). |
|
Sharpens the pixels in the image using pixel neighborhoods.
Definition at line 4464 of file kimageeffect.cpp. References QImage::width(). Referenced by sharpen(). |
|
This is provided for binary compatability only! Use the above method instead!
Definition at line 4458 of file kimageeffect.cpp. References sharpen(). |
|
Randomly displaces pixels.
Definition at line 3473 of file kimageeffect.cpp. References QImage::depth(), QImage::detach(), QImage::height(), QImage::scanLine(), and QImage::width(). |
|
Shades the image using a distance light source.
Definition at line 4504 of file kimageeffect.cpp. References QImage::colorTable(), QImage::depth(), QImage::height(), QImage::scanLine(), and QImage::width(). |
|
Swirls the image by a specified amount.
Definition at line 3524 of file kimageeffect.cpp. References QImage::colorTable(), QImage::depth(), QImage::height(), QImage::scanLine(), and QImage::width(). |
|
Modifies the pixels along a sine wave.
Definition at line 3602 of file kimageeffect.cpp. References QImage::height(), QImage::scanLine(), and QImage::width(). |
|
A bumpmapping algorithm.
Definition at line 4885 of file kimageeffect.cpp. References QImage::create(), QImage::depth(), FXCLAMP, QImage::hasAlphaBuffer(), QImage::height(), QImage::scanLine(), and QImage::width(). |
The documentation for this class was generated from the following files: