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 | |
QImage | gradient (const QSize &size, const QColor &ca, const QColor &cb, GradientType type, int ncols=3) |
QImage | unbalancedGradient (const QSize &size, const QColor &ca, const QColor &cb, GradientType type, int xfactor=100, int yfactor=100, int ncols=3) |
QImage & | blend (const QColor &clr, QImage &dst, float opacity) |
QImage & | blend (QImage &src, QImage &dst, float opacity) |
QImage & | blend (QImage &image, float initial_intensity, const QColor &bgnd, GradientType eff, bool anti_dir=false) |
QImage & | blend (QImage &image1, QImage &image2, GradientType gt, int xf=100, int yf=100) |
QImage & | blend (QImage &image1, QImage &image2, QImage &blendImage, RGBComponent channel) |
bool | blend (const QImage &upper, const QImage &lower, QImage &output) |
bool | blend (int &x, int &y, const QImage &upper, const QImage &lower, QImage &output) |
bool | blendOnLower (int x, int y, const QImage &upper, const QImage &lower) |
void | blendOnLower (const QImage &upper, const QPoint &upperOffset, QImage &lower, const QRect &lowerRect) |
void | blendOnLower (const QImage &upper, const QPoint &upperOffset, QImage &lower, const QRect &lowerRect, float opacity) |
QRect | computeDestinationRect (const QSize &lowerSize, Disposition disposition, QImage &upper) |
void | blendOnLower (QImage &upper, QImage &lower, Disposition disposition, float opacity) |
QImage & | channelIntensity (QImage &image, float percent, RGBComponent channel) |
QImage & | fade (QImage &image, float val, const QColor &color) |
QImage & | flatten (QImage &image, const QColor &ca, const QColor &cb, int ncols=0) |
QImage & | hash (QImage &image, Lighting lite=NorthLite, unsigned int spacing=0) |
QImage & | intensity (QImage &image, float percent) |
QImage & | modulate (QImage &image, QImage &modImage, bool reverse, ModulationType type, int factor, RGBComponent channel) |
QImage & | toGray (QImage &image, bool fast=false) |
QImage & | desaturate (QImage &image, float desat=0.3) |
QImage & | contrast (QImage &image, int c) |
QImage & | dither (QImage &image, const QColor *palette, int size) |
QImage & | selectedImage (QImage &img, const QColor &col) |
void | contrastHSV (QImage &img, bool sharpen=true) |
void | normalize (QImage &img) |
void | equalize (QImage &img) |
void | threshold (QImage &img, unsigned int value=128) |
void | solarize (QImage &img, double factor=50.0) |
QImage | emboss (QImage &src, double radius, double sigma) |
QImage | emboss (QImage &src) |
QImage | despeckle (QImage &src) |
QImage | charcoal (QImage &src, double radius, double sigma) |
QImage | charcoal (QImage &src, double factor=50.0) |
QImage | rotate (QImage &src, RotateDirection r) |
QImage | sample (QImage &src, int w, int h) |
QImage | addNoise (QImage &src, NoiseType type=GaussianNoise) |
QImage | blur (QImage &src, double radius, double sigma) |
QImage | blur (QImage &src, double factor=50.0) |
QImage | edge (QImage &src, double radius) |
QImage | implode (QImage &src, double factor=30.0, unsigned int background=0xFFFFFFFF) |
QImage | oilPaintConvolve (QImage &src, double radius) |
QImage | oilPaint (QImage &src, int radius=3) |
QImage | sharpen (QImage &src, double radius, double sigma) |
QImage | sharpen (QImage &src, double factor=30.0) |
QImage | spread (QImage &src, unsigned int amount=3) |
QImage | shade (QImage &src, bool color_shading=true, double azimuth=30.0, double elevation=30.0) |
QImage | swirl (QImage &src, double degrees=50.0, unsigned int background=0xFFFFFFFF) |
QImage | wave (QImage &src, double amplitude=25.0, double frequency=150.0, unsigned int background=0xFFFFFFFF) |
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 48 of file kimageeffect.h.
Member Enumeration Documentation
|
This enum provides a gradient type specification.
Definition at line 56 of file kimageeffect.h. |
|
This enum provides a RGB channel specification.
Definition at line 71 of file kimageeffect.h. |
|
This enum provides a lighting direction specification.
Definition at line 82 of file kimageeffect.h. |
|
This enum provides a modulation type specification.
Definition at line 96 of file kimageeffect.h. |
|
This enum provides a noise type specification.
Definition at line 106 of file kimageeffect.h. |
|
This enum provides a rotation specification.
Definition at line 118 of file kimageeffect.h. |
|
This enum lists possible bumpmapping implementations.
Definition at line 127 of file kimageeffect.h. |
|
Disposition of a source image on top of a destination image.
Definition at line 324 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 dither(). 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 dither(). 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 KCPUInfo::haveExtension(). 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 KCPUInfo::haveExtension(). |
|
Blend the provided image into a background of the indicated color.
Definition at line 1536 of file kimageeffect.cpp. References intensity(). |
|
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(), Red, and unbalancedGradient(). |
|
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. |
|
Blend an image into another one, using alpha in the expected way.
Definition at line 2377 of file kimageeffect.cpp. |
|
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. |
|
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. 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. |
|
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. |
|
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, NoImage, Scaled, Tiled, and TiledMaxpect. 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(), and computeDestinationRect(). |
|
Modifies the intensity of a pixmap's RGB channel component.
Definition at line 845 of file kimageeffect.cpp. 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. 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 dither(). Referenced by KPixmapEffect::pattern(). |
|
Build a hash on any given QImage.
Definition at line 1865 of file kimageeffect.cpp. References EastLite, NELite, NorthLite, NWLite, SELite, SouthLite, SWLite, and WestLite. 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 KCPUInfo::haveExtension(). 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, Contrast, Gray, Green, HueShift, Intensity, Red, and Saturation. |
|
Convert an image to grayscale.
Definition at line 2125 of file kimageeffect.cpp. Referenced by charcoal(), and KPixmapEffect::toGray(). |
|
Desaturate an image evenly.
Definition at line 2175 of file kimageeffect.cpp. Referenced by KPixmapEffect::desaturate(). |
|
Fast, but low quality contrast of an image. Also see contrastHSV.
Definition at line 2198 of file kimageeffect.cpp. Referenced by KPixmapEffect::contrast(). |
|
Dither an image using Floyd-Steinberg dithering for low-color situations.
Definition at line 2260 of file kimageeffect.cpp. 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 4640 of file kimageeffect.cpp. |
|
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. Referenced by charcoal(). |
|
Performs histogram equalisation on the reference image.
Definition at line 3929 of file kimageeffect.cpp. 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. |
|
Produces a 'solarization' effect seen when exposing a photographic film to light during the development process.
Definition at line 3450 of file kimageeffect.cpp. |
|
Embosses the source image. This involves highlighting the edges and applying various other enhancements in order to get a metal effect.
Definition at line 4067 of file kimageeffect.cpp. References equalize(). Referenced by emboss(). |
|
Convenience method.
Definition at line 4061 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. |
|
Produces a neat little "charcoal" effect.
Definition at line 3711 of file kimageeffect.cpp. References blur(), edge(), 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. |
|
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. |
|
Adds noise to an image.
Definition at line 3141 of file kimageeffect.cpp. |
|
Blurs an image by convolving pixel neighborhoods.
Definition at line 4286 of file kimageeffect.cpp. 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 4280 of file kimageeffect.cpp. References blur(). |
|
Detects edges in an image using pixel neighborhoods and an edge detection mask.
Definition at line 4029 of file kimageeffect.cpp. Referenced by charcoal(). |
|
Implodes an image by a specified percent.
Definition at line 3271 of file kimageeffect.cpp. |
|
Produces an oil painting effect.
Definition at line 3641 of file kimageeffect.cpp. 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 4462 of file kimageeffect.cpp. Referenced by sharpen(). |
|
This is provided for binary compatability only! Use the above method instead!
Definition at line 4456 of file kimageeffect.cpp. References sharpen(). |
|
Randomly displaces pixels.
Definition at line 3473 of file kimageeffect.cpp. |
|
Shades the image using a distance light source.
Definition at line 4502 of file kimageeffect.cpp. References shade(). Referenced by shade(). |
|
Swirls the image by a specified amount.
Definition at line 3524 of file kimageeffect.cpp. |
|
Modifies the pixels along a sine wave.
Definition at line 3602 of file kimageeffect.cpp. |
|
A bumpmapping algorithm.
Definition at line 4883 of file kimageeffect.cpp. |
The documentation for this class was generated from the following files: