.TH "KImageEffect" kde3 "11 Jun 2005" "Version Version 3.4.1" "kdefx Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KImageEffect \- This class includes various \fBQImage\fP based graphical effects.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <kimageeffect.h>\fP
.PP
.SS "Public Types"

.in +1c
.ti -1c
.RI "enum \fBGradientType\fP { \fBVerticalGradient\fP, \fBHorizontalGradient\fP, \fBDiagonalGradient\fP, \fBCrossDiagonalGradient\fP, \fBPyramidGradient\fP, \fBRectangleGradient\fP, \fBPipeCrossGradient\fP, \fBEllipticGradient\fP }"
.br
.ti -1c
.RI "enum \fBRGBComponent\fP { \fBRed\fP, \fBGreen\fP, \fBBlue\fP, \fBGray\fP, \fBAll\fP }"
.br
.ti -1c
.RI "enum \fBLighting\fP { \fBNorthLite\fP, \fBNWLite\fP, \fBWestLite\fP, \fBSWLite\fP, \fBSouthLite\fP, \fBSELite\fP, \fBEastLite\fP, \fBNELite\fP }"
.br
.ti -1c
.RI "enum \fBModulationType\fP { \fBIntensity\fP, \fBSaturation\fP, \fBHueShift\fP, \fBContrast\fP }"
.br
.ti -1c
.RI "enum \fBNoiseType\fP { \fBUniformNoise\fP = 0, \fBGaussianNoise\fP, \fBMultiplicativeGaussianNoise\fP, \fBImpulseNoise\fP, \fBLaplacianNoise\fP, \fBPoissonNoise\fP }"
.br
.ti -1c
.RI "enum \fBRotateDirection\fP { \fBRotate90\fP, \fBRotate180\fP, \fBRotate270\fP }"
.br
.ti -1c
.RI "enum \fBBumpmapType\fP { \fBLinear\fP, \fBSpherical\fP, \fBSinuosidal\fP }"
.br
.ti -1c
.RI "enum \fBDisposition\fP { \fBNoImage\fP =  0, \fBCentered\fP, \fBTiled\fP, \fBCenterTiled\fP, \fBCenteredMaxpect\fP, \fBTiledMaxpect\fP, \fBScaled\fP, \fBCenteredAutoFit\fP }"
.br
.in -1c
.SS "Static Public Member Functions"

.in +1c
.ti -1c
.RI "static \fBQImage\fP \fBgradient\fP (const \fBQSize\fP &size, const \fBQColor\fP &ca, const \fBQColor\fP &cb, \fBGradientType\fP type, int ncols=3)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBunbalancedGradient\fP (const \fBQSize\fP &size, const \fBQColor\fP &ca, const \fBQColor\fP &cb, \fBGradientType\fP type, int xfactor=100, int yfactor=100, int ncols=3)"
.br
.ti -1c
.RI "static \fBQImage\fP & \fBblend\fP (const \fBQColor\fP &clr, \fBQImage\fP &dst, float opacity)"
.br
.ti -1c
.RI "static \fBQImage\fP & \fBblend\fP (\fBQImage\fP &src, \fBQImage\fP &dst, float opacity)"
.br
.ti -1c
.RI "static \fBQImage\fP & \fBblend\fP (\fBQImage\fP &image, float initial_intensity, const \fBQColor\fP &bgnd, \fBGradientType\fP eff, bool anti_dir=false)"
.br
.ti -1c
.RI "static \fBQImage\fP & \fBblend\fP (\fBQImage\fP &image1, \fBQImage\fP &image2, \fBGradientType\fP gt, int xf=100, int yf=100)"
.br
.ti -1c
.RI "static \fBQImage\fP & \fBblend\fP (\fBQImage\fP &image1, \fBQImage\fP &image2, \fBQImage\fP &blendImage, \fBRGBComponent\fP channel)"
.br
.ti -1c
.RI "static bool \fBblend\fP (const \fBQImage\fP &upper, const \fBQImage\fP &lower, \fBQImage\fP &output)"
.br
.ti -1c
.RI "static bool \fBblend\fP (int &x, int &y, const \fBQImage\fP &upper, const \fBQImage\fP &lower, \fBQImage\fP &output)"
.br
.ti -1c
.RI "static bool \fBblendOnLower\fP (int x, int y, const \fBQImage\fP &upper, const \fBQImage\fP &lower)"
.br
.ti -1c
.RI "static void \fBblendOnLower\fP (const \fBQImage\fP &upper, const \fBQPoint\fP &upperOffset, \fBQImage\fP &lower, const \fBQRect\fP &lowerRect)"
.br
.ti -1c
.RI "static void \fBblendOnLower\fP (const \fBQImage\fP &upper, const \fBQPoint\fP &upperOffset, \fBQImage\fP &lower, const \fBQRect\fP &lowerRect, float opacity)"
.br
.ti -1c
.RI "static \fBQRect\fP \fBcomputeDestinationRect\fP (const \fBQSize\fP &lowerSize, \fBDisposition\fP disposition, \fBQImage\fP &upper)"
.br
.ti -1c
.RI "static void \fBblendOnLower\fP (\fBQImage\fP &upper, \fBQImage\fP &lower, \fBDisposition\fP disposition, float opacity)"
.br
.ti -1c
.RI "static \fBQImage\fP & \fBchannelIntensity\fP (\fBQImage\fP &image, float percent, \fBRGBComponent\fP channel)"
.br
.ti -1c
.RI "static \fBQImage\fP & \fBfade\fP (\fBQImage\fP &image, float val, const \fBQColor\fP &color)"
.br
.ti -1c
.RI "static \fBQImage\fP & \fBflatten\fP (\fBQImage\fP &image, const \fBQColor\fP &ca, const \fBQColor\fP &cb, int ncols=0)"
.br
.ti -1c
.RI "static \fBQImage\fP & \fBhash\fP (\fBQImage\fP &image, \fBLighting\fP lite=NorthLite, unsigned int spacing=0)"
.br
.ti -1c
.RI "static \fBQImage\fP & \fBintensity\fP (\fBQImage\fP &image, float percent)"
.br
.ti -1c
.RI "static \fBQImage\fP & \fBmodulate\fP (\fBQImage\fP &image, \fBQImage\fP &modImage, bool reverse, \fBModulationType\fP type, int factor, \fBRGBComponent\fP channel)"
.br
.ti -1c
.RI "static \fBQImage\fP & \fBtoGray\fP (\fBQImage\fP &image, bool fast=false)"
.br
.ti -1c
.RI "static \fBQImage\fP & \fBdesaturate\fP (\fBQImage\fP &image, float desat=0.3)"
.br
.ti -1c
.RI "static \fBQImage\fP & \fBcontrast\fP (\fBQImage\fP &image, int c)"
.br
.ti -1c
.RI "static \fBQImage\fP & \fBdither\fP (\fBQImage\fP &image, const \fBQColor\fP *palette, int size)"
.br
.ti -1c
.RI "static \fBQImage\fP & \fBselectedImage\fP (\fBQImage\fP &img, const \fBQColor\fP &col)"
.br
.ti -1c
.RI "static void \fBcontrastHSV\fP (\fBQImage\fP &img, bool sharpen=true)"
.br
.ti -1c
.RI "static void \fBnormalize\fP (\fBQImage\fP &img)"
.br
.ti -1c
.RI "static void \fBequalize\fP (\fBQImage\fP &img)"
.br
.ti -1c
.RI "static void \fBthreshold\fP (\fBQImage\fP &img, unsigned int value=128)"
.br
.ti -1c
.RI "static void \fBsolarize\fP (\fBQImage\fP &img, double factor=50.0)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBemboss\fP (\fBQImage\fP &src, double radius, double sigma)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBemboss\fP (\fBQImage\fP &src)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBdespeckle\fP (\fBQImage\fP &src)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBcharcoal\fP (\fBQImage\fP &src, double radius, double sigma)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBcharcoal\fP (\fBQImage\fP &src, double factor=50.0)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBrotate\fP (\fBQImage\fP &src, \fBRotateDirection\fP r)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBsample\fP (\fBQImage\fP &src, int w, int h)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBaddNoise\fP (\fBQImage\fP &src, \fBNoiseType\fP type=GaussianNoise)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBblur\fP (\fBQImage\fP &src, double radius, double sigma)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBblur\fP (\fBQImage\fP &src, double factor=50.0)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBedge\fP (\fBQImage\fP &src, double radius)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBimplode\fP (\fBQImage\fP &src, double factor=30.0, unsigned int background=0xFFFFFFFF)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBoilPaintConvolve\fP (\fBQImage\fP &src, double radius)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBoilPaint\fP (\fBQImage\fP &src, int radius=3)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBsharpen\fP (\fBQImage\fP &src, double radius, double sigma)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBsharpen\fP (\fBQImage\fP &src, double factor=30.0)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBspread\fP (\fBQImage\fP &src, unsigned int amount=3)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBshade\fP (\fBQImage\fP &src, bool color_shading=true, double azimuth=30.0, double elevation=30.0)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBswirl\fP (\fBQImage\fP &src, double degrees=50.0, unsigned int background=0xFFFFFFFF)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBwave\fP (\fBQImage\fP &src, double amplitude=25.0, double frequency=150.0, unsigned int background=0xFFFFFFFF)"
.br
.ti -1c
.RI "static \fBQImage\fP \fBbumpmap\fP (\fBQImage\fP &img, \fBQImage\fP &map, double azimuth, double elevation, int depth, int xofs, int yofs, int waterlevel, int ambient, bool compensate, bool invert, \fBBumpmapType\fP type, bool tiled)"
.br
.in -1c
.SH "Detailed Description"
.PP 
This class includes various \fBQImage\fP 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. 
.PP
Definition at line 50 of file kimageeffect.h.
.SH "Member Enumeration Documentation"
.PP 
.SS "enum \fBKImageEffect::GradientType\fP"
.PP
This enum provides a gradient type specification. 
.PP
\fBSee also:\fP
.RS 4
\fBKImageEffect::blend()\fP, \fBKImageEffect::gradient()\fP, \fBKImageEffect::unbalancedGradient()\fP 
.RE
.PP

.PP
Definition at line 58 of file kimageeffect.h.
.SS "enum \fBKImageEffect::RGBComponent\fP"
.PP
This enum provides a RGB channel specification. 
.PP
\fBSee also:\fP
.RS 4
\fBKImageEffect::blend()\fP, \fBKImageEffect::channelIntensity()\fP, \fBKImageEffect::modulate()\fP 
.RE
.PP

.PP
\fBEnumeration values: \fP
.in +1c
.TP
\fB\fIRed \fP\fP
Red channel. 
.TP
\fB\fIGreen \fP\fP
Green channel. 
.TP
\fB\fIBlue \fP\fP
Blue channel. 
.TP
\fB\fIGray \fP\fP
Grey channel. 
.TP
\fB\fIAll \fP\fP
All channels. 
.PP
Definition at line 73 of file kimageeffect.h.
.SS "enum \fBKImageEffect::Lighting\fP"
.PP
This enum provides a lighting direction specification. 
.PP
\fBSee also:\fP
.RS 4
\fBKImageEffect::hash()\fP 
.RE
.PP

.PP
\fBEnumeration values: \fP
.in +1c
.TP
\fB\fINorthLite \fP\fP
Lighting from the top of the image. 
.TP
\fB\fINWLite \fP\fP
Lighting from the top left of the image. 
.TP
\fB\fIWestLite \fP\fP
Lighting from the left of the image. 
.TP
\fB\fISWLite \fP\fP
Lighting from the bottom left of the image. 
.TP
\fB\fISouthLite \fP\fP
Lighting from the bottom of the image. 
.TP
\fB\fISELite \fP\fP
Lighting from the bottom right of the image. 
.TP
\fB\fIEastLite \fP\fP
Lighting from the right of the image. 
.TP
\fB\fINELite \fP\fP
Lighting from the top right of the image. 
.PP
Definition at line 84 of file kimageeffect.h.
.SS "enum \fBKImageEffect::ModulationType\fP"
.PP
This enum provides a modulation type specification. 
.PP
\fBSee also:\fP
.RS 4
\fBKImageEffect::modulate()\fP 
.RE
.PP

.PP
\fBEnumeration values: \fP
.in +1c
.TP
\fB\fIIntensity \fP\fP
Modulate image intensity. 
.TP
\fB\fISaturation \fP\fP
Modulate image saturation. 
.TP
\fB\fIHueShift \fP\fP
Modulate image hue. 
.TP
\fB\fIContrast \fP\fP
Modulate image contrast. 
.PP
Definition at line 98 of file kimageeffect.h.
.SS "enum \fBKImageEffect::NoiseType\fP"
.PP
This enum provides a noise type specification. 
.PP
\fBSee also:\fP
.RS 4
\fBKImageEffect::addNoise()\fP 
.RE
.PP

.PP
\fBEnumeration values: \fP
.in +1c
.TP
\fB\fIUniformNoise \fP\fP
Uniform distribution. 
.TP
\fB\fIGaussianNoise \fP\fP
Gaussian distribution. 
.TP
\fB\fIMultiplicativeGaussianNoise \fP\fP
Multiplicative Gaussian distribution. 
.TP
\fB\fIImpulseNoise \fP\fP
Impulse distribution. 
.TP
\fB\fILaplacianNoise \fP\fP
Laplacian distribution. 
.TP
\fB\fIPoissonNoise \fP\fP
Poisson distribution. 
.PP
Definition at line 108 of file kimageeffect.h.
.SS "enum \fBKImageEffect::RotateDirection\fP"
.PP
This enum provides a rotation specification. 
.PP
\fBSee also:\fP
.RS 4
\fBKImageEffect::rotate()\fP 
.RE
.PP

.PP
\fBEnumeration values: \fP
.in +1c
.TP
\fB\fIRotate90 \fP\fP
Rotate 90 degrees to the right. 
.TP
\fB\fIRotate180 \fP\fP
Rotate 180 degrees. 
.TP
\fB\fIRotate270 \fP\fP
Rotate 90 degrees to the left. 
.PP
Definition at line 120 of file kimageeffect.h.
.SS "enum \fBKImageEffect::BumpmapType\fP"
.PP
This enum lists possible bumpmapping implementations. 
.PP
\fBSee also:\fP
.RS 4
\fBKImageEffect::bumpmap()\fP 
.RE
.PP

.PP
Definition at line 129 of file kimageeffect.h.
.SS "enum \fBKImageEffect::Disposition\fP"
.PP
Disposition of a source image on top of a destination image. 
.PP
\fBSee also:\fP
.RS 4
\fBKImageEffect::computeDestinationRect\fP, \fBKImageEffect::blendOnLower\fP 
.RE
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
\fBEnumeration values: \fP
.in +1c
.TP
\fB\fINoImage \fP\fP
Don't overlay. 
.TP
\fB\fICentered \fP\fP
Center top image on botton image. 
.TP
\fB\fITiled \fP\fP
Tile top image on bottom image. 
.TP
\fB\fICenterTiled \fP\fP
Center and tile top image on bottom image. 
.TP
\fB\fICenteredMaxpect \fP\fP
Center and scale aspect. 
.TP
\fB\fITiledMaxpect \fP\fP
Tile and scale aspect. 
.TP
\fB\fIScaled \fP\fP
Scale. 
.TP
\fB\fICenteredAutoFit \fP\fP
Center and scale or scale aspect. 
.PP
Definition at line 326 of file kimageeffect.h.
.SH "Member Function Documentation"
.PP 
.SS "\fBQImage\fP KImageEffect::gradient (const \fBQSize\fP & size, const \fBQColor\fP & ca, const \fBQColor\fP & cb, \fBGradientType\fP type, int ncols = \fC3\fP)\fC [static]\fP"
.PP
Create a gradient from color a to color b of the specified type. 
.PP
\fBParameters:\fP
.RS 4
\fIsize\fP The desired size of the gradient. 
.br
\fIca\fP Color a 
.br
\fIcb\fP Color b 
.br
\fItype\fP The type of gradient. 
.br
\fIncols\fP The number of colors to use when not running on a truecolor display. The gradient will be dithered to this number of colors. Pass 0 to prevent dithering. 
.RE
.PP

.PP
Definition at line 123 of file kimageeffect.cpp.
.PP
References dither(), QImage::height(), QImage::scanLine(), QColor::setRgb(), and QImage::width().
.PP
Referenced by KPixmapEffect::gradient().
.SS "\fBQImage\fP KImageEffect::unbalancedGradient (const \fBQSize\fP & size, const \fBQColor\fP & ca, const \fBQColor\fP & cb, \fBGradientType\fP type, int xfactor = \fC100\fP, int yfactor = \fC100\fP, int ncols = \fC3\fP)\fC [static]\fP"
.PP
Create an unbalanced gradient. 
.PP
An unbalanced gradient is a gradient where the transition from color a to color b is not linear, but in this case, exponential.
.PP
\fBParameters:\fP
.RS 4
\fIsize\fP The desired size of the gradient. 
.br
\fIca\fP Color a 
.br
\fIcb\fP Color b 
.br
\fItype\fP The type of gradient. 
.br
\fIxfactor\fP The x decay length. Use a value between -200 and 200. 
.br
\fIyfactor\fP The y decay length. 
.br
\fIncols\fP The number of colors. See KImageEffect:gradient. 
.RE
.PP

.PP
Definition at line 387 of file kimageeffect.cpp.
.PP
References dither(), QImage::height(), QColor::rgb(), QImage::scanLine(), QColor::setRgb(), and QImage::width().
.PP
Referenced by blend(), and KPixmapEffect::unbalancedGradient().
.SS "\fBQImage\fP & KImageEffect::blend (const \fBQColor\fP & clr, \fBQImage\fP & dst, float opacity)\fC [static]\fP"
.PP
Blends a color into the destination image, using an opacity value for blending one into another. 
.PP
Very fast direct pixel manipulation is used.
.PP
This function uses MMX and SSE2 instructions to blend the image on processors that support it.
.PP
\fBParameters:\fP
.RS 4
\fIclr\fP source color to be blended into the destination image. 
.br
\fIdst\fP destination image in which the source will be blended into. 
.br
\fIopacity\fP opacity (between 0.0 and 1.0) which determines how much the source color will be blended into the destination image. 
.RE
.PP
\fBReturns:\fP
.RS 4
The destination image (dst) containing the result. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Karol Szwed (gallium@kde.org) 
.PP
Fredrik Ho\*(4glund (fredrik@kde.org) 
.RE
.PP

.PP
Definition at line 1066 of file kimageeffect.cpp.
.PP
References QImage::bits(), QImage::convertDepth(), QImage::height(), and QImage::width().
.PP
Referenced by KPixmapEffect::blend(), blend(), and selectedImage().
.SS "\fBQImage\fP & KImageEffect::blend (\fBQImage\fP & src, \fBQImage\fP & dst, float opacity)\fC [static]\fP"
.PP
Blend the src image into the destination image, using an opacity value for blending one into another. 
.PP
Very fast direct pixel manipulation is used.
.PP
This function uses MMX and SSE2 instructions to blend the images on processors that support it.
.PP
\fBParameters:\fP
.RS 4
\fIsrc\fP source image to be blended into the destination image. 
.br
\fIdst\fP destination image in which the source will be blended into. 
.br
\fIopacity\fP opacity (between 0.0 and 1.0) which determines how much the source image will be blended into the destination image. 
.RE
.PP
\fBReturns:\fP
.RS 4
The destination image (dst) containing the result. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Karol Szwed (gallium@kde.org) 
.PP
Fredrik Ho\*(4glund (fredrik@kde.org) 
.RE
.PP

.PP
Definition at line 1307 of file kimageeffect.cpp.
.PP
References QImage::bits(), QImage::convertDepth(), QImage::height(), and QImage::width().
.SS "\fBQImage\fP & KImageEffect::blend (\fBQImage\fP & image, float initial_intensity, const \fBQColor\fP & bgnd, \fBGradientType\fP eff, bool anti_dir = \fCfalse\fP)\fC [static]\fP"
.PP
Blend the provided image into a background of the indicated color. 
.PP
\fBParameters:\fP
.RS 4
\fIinitial_intensity\fP this parameter takes values from -1 to 1: a) if positive: how much to fade the image in its less affected spot b) if negative: roughly indicates how much of the image remains unaffected 
.br
\fIbgnd\fP indicates the color of the background to blend in 
.br
\fIeff\fP lets you choose what kind of blending you like 
.br
\fIanti_dir\fP blend in the opposite direction (makes no much sense with concentric blending effects) 
.br
\fIimage\fP must be 32bpp 
.RE
.PP

.PP
Definition at line 1536 of file kimageeffect.cpp.
.PP
References QImage::bits(), QImage::height(), intensity(), and QImage::width().
.SS "\fBQImage\fP & KImageEffect::blend (\fBQImage\fP & image1, \fBQImage\fP & image2, \fBGradientType\fP gt, int xf = \fC100\fP, int yf = \fC100\fP)\fC [static]\fP"
.PP
Blend an image into another one, using a gradient type for blending from one to another. 
.PP
\fBParameters:\fP
.RS 4
\fIimage1\fP source1 and result of blending 
.br
\fIimage2\fP source2 of blending 
.br
\fIgt\fP gradient type for blending between source1 and source2 
.br
\fIxf\fP x decay length for unbalanced gradient tpye 
.br
\fIyf\fP y decay length for unbalanced gradient tpye 
.RE
.PP

.PP
Definition at line 1744 of file kimageeffect.cpp.
.PP
References blend(), Red, and unbalancedGradient().
.SS "\fBQImage\fP & KImageEffect::blend (\fBQImage\fP & image1, \fBQImage\fP & image2, \fBQImage\fP & blendImage, \fBRGBComponent\fP channel)\fC [static]\fP"
.PP
Blend an image into another one, using a color channel of a third image for the decision of blending from one to another. 
.PP
\fBParameters:\fP
.RS 4
\fIimage1\fP Source 1 and result of blending 
.br
\fIimage2\fP Source 2 of blending 
.br
\fIblendImage\fP If the gray value of of pixel is 0, the result for this pixel is that of image1; for a gray value of 1, the pixel of image2 is used; for a value in between, a corresponding blending is used. 
.br
\fIchannel\fP The RBG channel to use for the blending decision. 
.RE
.PP

.PP
Definition at line 1762 of file kimageeffect.cpp.
.PP
References QImage::bits(), Blue, QImage::colorTable(), QImage::convertDepth(), Green, QImage::height(), Red, and QImage::width().
.SS "bool KImageEffect::blend (const \fBQImage\fP & upper, const \fBQImage\fP & lower, \fBQImage\fP & output)\fC [static]\fP"
.PP
Blend an image into another one, using alpha in the expected way. 
.PP
\fBParameters:\fP
.RS 4
\fIupper\fP the 'upper' image 
.br
\fIlower\fP the 'lower' image 
.br
\fIoutput\fP the target image 
.RE
.PP
\fBAuthor:\fP
.RS 4
Rik Hemsley (rikkus) <rik@kde.org> 
.RE
.PP

.PP
Definition at line 2377 of file kimageeffect.cpp.
.PP
References QImage::copy(), QImage::scanLine(), and QImage::width().
.SS "bool KImageEffect::blend (int & x, int & y, const \fBQImage\fP & upper, const \fBQImage\fP & lower, \fBQImage\fP & output)\fC [static]\fP"
.PP
Blend an image into another one, using alpha in the expected way and over coordinates \fCx\fP and \fCy\fP with respect to the lower image. 
.PP
The output is a \fBQImage\fP which is the \fCupper\fP image already blended with the \fClower\fP one, so its size will be (in general) the same than \fCupper\fP instead of the same size than \fClower\fP like the method above. In fact, the size of \fCoutput\fP is like upper's one only when it can be painted on lower, if there has to be some clipping, output's size will be the clipped area and x and y will be set to the correct up-left corner where the clipped rectangle begins. 
.PP
\fBParameters:\fP
.RS 4
\fIx\fP x-coordinate of lower image 
.br
\fIy\fP y-coordinate of lower image 
.br
\fIupper\fP the 'upper' image 
.br
\fIlower\fP the 'lower' image 
.br
\fIoutput\fP the target image 
.RE
.PP

.PP
Definition at line 2449 of file kimageeffect.cpp.
.PP
References QImage::create(), QImage::height(), and QImage::width().
.SS "bool KImageEffect::blendOnLower (int x, int y, const \fBQImage\fP & upper, const \fBQImage\fP & lower)\fC [static]\fP"
.PP
Blend an image into another one, using alpha in the expected way and over coordinates \fCx\fP and \fCy\fP with respect to the lower image. 
.PP
The output is painted in the own \fClower\fP image. This is an optimization of the blend method above provided by convenience. 
.PP
\fBParameters:\fP
.RS 4
\fIx\fP x-coordinate of lower image 
.br
\fIy\fP y-coordinate of lower image 
.br
\fIupper\fP the 'upper' image 
.br
\fIlower\fP the 'lower' image, which becomes the output image 
.RE
.PP

.PP
Definition at line 2513 of file kimageeffect.cpp.
.PP
References QImage::height(), QImage::scanLine(), and QImage::width().
.PP
Referenced by blendOnLower().
.SS "void KImageEffect::blendOnLower (const \fBQImage\fP & upper, const \fBQPoint\fP & upperOffset, \fBQImage\fP & lower, const \fBQRect\fP & lowerRect)\fC [static]\fP"
.PP
Blend part of an image into part of another, using the alpha channel in the expected way. 
.PP
Note that the destination rectangle will be correctly clipped.
.PP
\fBParameters:\fP
.RS 4
\fIupper\fP the 'upper' image 
.br
\fIupperOffset\fP Offset for the part of the upper image to be used. 
.br
\fIlower\fP the 'lower' image 
.br
\fIlowerRect\fP Rectangle for the part of the lower image where the blending will occur. 
.RE
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 2583 of file kimageeffect.cpp.
.PP
References QRect::height(), QRect::isValid(), QImage::rect(), QRect::setHeight(), QRect::setWidth(), QRect::width(), QRect::x(), and QRect::y().
.SS "void KImageEffect::blendOnLower (const \fBQImage\fP & upper, const \fBQPoint\fP & upperOffset, \fBQImage\fP & lower, const \fBQRect\fP & lowerRect, float opacity)\fC [static]\fP"
.PP
Blend part of an image into part of another, using the opacity value and the alpha channel in the expected way. 
.PP
Note that the destination rectangle will be correctly clipped.
.PP
\fBParameters:\fP
.RS 4
\fIupper\fP the 'upper' image 
.br
\fIupperOffset\fP Offset for the part of the upper image to be used. 
.br
\fIlower\fP the 'lower' image 
.br
\fIlowerRect\fP Rectangle for the part of the lower image where the blending will occur. 
.br
\fIopacity\fP Opacity (between 0.0 and 1.0) which determines how much the source image will be blended into the destination image. 
.RE
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 2605 of file kimageeffect.cpp.
.PP
References QRect::height(), QRect::isValid(), QRect::rect(), QRect::setHeight(), QRect::setWidth(), QRect::width(), QRect::x(), and QRect::y().
.SS "\fBQRect\fP KImageEffect::computeDestinationRect (const \fBQSize\fP & lowerSize, \fBDisposition\fP disposition, \fBQImage\fP & upper)\fC [static]\fP"
.PP
Compute the destination rectangle where to draw the upper image on top of another image using the given disposition. 
.PP
For tiled disposition, the rectangle should be duplicated on the whole area to obtained the wanted effect.
.PP
\fBParameters:\fP
.RS 4
\fIlowerSize\fP The size of the destination image. 
.br
\fIdisposition\fP The wanted disposition. 
.br
\fIupper\fP The upper image. Note that this image may be scaled to adjust to the requested disposition.
.RE
.PP
\fBReturns:\fP
.RS 4
the computed rectangle. Its size may exceed \fIlowerSize\fP. 
.RE
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 2627 of file kimageeffect.cpp.
.PP
References Centered, CenteredAutoFit, CenteredMaxpect, CenterTiled, QRect::height(), NoImage, Scaled, QRect::setCoords(), QRect::setRect(), Tiled, TiledMaxpect, and QRect::width().
.PP
Referenced by blendOnLower().
.SS "void KImageEffect::blendOnLower (\fBQImage\fP & upper, \fBQImage\fP & lower, \fBDisposition\fP disposition, float opacity)\fC [static]\fP"
.PP
Blend an image on top of another using a given disposition and a given opacity. 
.PP
The alpha channel of the upper image is used in the expected way. Beware the upper image may be modified. 
.PP
\fBSince:\fP
.RS 4
3.2 
.RE
.PP

.PP
Definition at line 2692 of file kimageeffect.cpp.
.PP
References blendOnLower(), QRect::bottom(), computeDestinationRect(), QRect::height(), QRect::left(), QRect::right(), QRect::top(), and QRect::width().
.SS "\fBQImage\fP & KImageEffect::channelIntensity (\fBQImage\fP & image, float percent, \fBRGBComponent\fP channel)\fC [static]\fP"
.PP
Modifies the intensity of a pixmap's RGB channel component. 
.PP
\fBParameters:\fP
.RS 4
\fIimage\fP The \fBQImage\fP to process. 
.br
\fIpercent\fP Percent value. Use a negative value to dim. 
.br
\fIchannel\fP Which channel(s) should be modified 
.RE
.PP
\fBReturns:\fP
.RS 4
The \fCimage\fP, provided for convenience. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 845 of file kimageeffect.cpp.
.PP
References QImage::bits(), QImage::colorTable(), QImage::depth(), Green, QImage::height(), QImage::numColors(), Red, and QImage::width().
.PP
Referenced by KPixmapEffect::channelIntensity().
.SS "\fBQImage\fP & KImageEffect::fade (\fBQImage\fP & image, float val, const \fBQColor\fP & color)\fC [static]\fP"
.PP
Fade an image to a certain background color. 
.PP
The number of colors will not be changed.
.PP
\fBParameters:\fP
.RS 4
\fIimage\fP The \fBQImage\fP to process. 
.br
\fIval\fP The strength of the effect. 0 <= val <= 1. 
.br
\fIcolor\fP The background color. 
.RE
.PP
\fBReturns:\fP
.RS 4
Returns the image(), provided for convenience. 
.RE
.PP

.PP
Definition at line 2043 of file kimageeffect.cpp.
.PP
References QImage::color(), QImage::scanLine(), and QImage::setColor().
.PP
Referenced by KPixmapEffect::fade().
.SS "\fBQImage\fP & KImageEffect::flatten (\fBQImage\fP & image, const \fBQColor\fP & ca, const \fBQColor\fP & cb, int ncols = \fC0\fP)\fC [static]\fP"
.PP
This recolors a pixmap. 
.PP
The most dark color will become color a, the most bright one color b, and in between.
.PP
\fBParameters:\fP
.RS 4
\fIimage\fP A \fBQImage\fP to process. 
.br
\fIca\fP Color a 
.br
\fIcb\fP Color b 
.br
\fIncols\fP The number of colors to dither the image to. Pass 0 to prevent dithering. 
.RE
.PP

.PP
Definition at line 1946 of file kimageeffect.cpp.
.PP
References QImage::color(), dither(), QImage::pixel(), QImage::setColor(), and QImage::setPixel().
.PP
Referenced by KPixmapEffect::pattern().
.SS "\fBQImage\fP & KImageEffect::hash (\fBQImage\fP & image, \fBLighting\fP lite = \fCNorthLite\fP, unsigned int spacing = \fC0\fP)\fC [static]\fP"
.PP
Build a hash on any given \fBQImage\fP. 
.PP
\fBParameters:\fP
.RS 4
\fIimage\fP The \fBQImage\fP to process 
.br
\fIlite\fP The hash faces the indicated lighting (cardinal poles). 
.br
\fIspacing\fP How many unmodified pixels in between hashes. 
.RE
.PP
\fBReturns:\fP
.RS 4
Returns the image(), provided for convenience. 
.RE
.PP

.PP
Definition at line 1865 of file kimageeffect.cpp.
.PP
References QImage::bits(), EastLite, NELite, NorthLite, NWLite, SELite, SouthLite, SWLite, WestLite, and QImage::width().
.PP
Referenced by KPixmapEffect::hash().
.SS "\fBQImage\fP & KImageEffect::intensity (\fBQImage\fP & image, float percent)\fC [static]\fP"
.PP
Either brighten or dim the image by a specified percent. 
.PP
For example, .50 will modify the colors by 50%.
.PP
This function uses MMX instructions to process the image on processors that support it.
.PP
\fBParameters:\fP
.RS 4
\fIimage\fP The \fBQImage\fP to process. 
.br
\fIpercent\fP The percent value. Use a negative value to dim. 
.RE
.PP
\fBReturns:\fP
.RS 4
Returns The image(), provided for convenience. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.PP
Benjamin Roe (ben@benroe.com) 
.RE
.PP

.PP
Definition at line 653 of file kimageeffect.cpp.
.PP
References QImage::bits(), QImage::colorTable(), QImage::depth(), KCPUInfo::haveExtension(), QImage::height(), QImage::numColors(), and QImage::width().
.PP
Referenced by blend(), and KPixmapEffect::intensity().
.SS "\fBQImage\fP & KImageEffect::modulate (\fBQImage\fP & image, \fBQImage\fP & modImage, bool reverse, \fBModulationType\fP type, int factor, \fBRGBComponent\fP channel)\fC [static]\fP"
.PP
Modulate the image with a color channel of another image. 
.PP
\fBParameters:\fP
.RS 4
\fIimage\fP The \fBQImage\fP to modulate and result. 
.br
\fImodImage\fP The \fBQImage\fP to use for modulation. 
.br
\fIreverse\fP Invert the meaning of image/modImage; result is image! 
.br
\fItype\fP The modulation Type to use. 
.br
\fIfactor\fP The modulation amplitude; with 0 no effect [-200;200]. 
.br
\fIchannel\fP The RBG channel of image2 to use for modulation. 
.RE
.PP
\fBReturns:\fP
.RS 4
Returns the image(), provided for convenience. 
.RE
.PP

.PP
Definition at line 936 of file kimageeffect.cpp.
.PP
References All, Blue, QImage::colorTable(), Contrast, QImage::convertDepth(), Gray, Green, QImage::height(), HueShift, Intensity, Red, QColor::rgb(), Saturation, QImage::scanLine(), QColor::setHsv(), QColor::setRgb(), and QImage::width().
.SS "\fBQImage\fP & KImageEffect::toGray (\fBQImage\fP & image, bool fast = \fCfalse\fP)\fC [static]\fP"
.PP
Convert an image to grayscale. 
.PP
\fBParameters:\fP
.RS 4
\fIimage\fP The \fBQImage\fP to process. 
.br
\fIfast\fP Set to \fCtrue\fP in order to use a faster but non-photographic quality algorithm. Appropriate for things such as toolbar icons. 
.RE
.PP
\fBReturns:\fP
.RS 4
Returns the image(), provided for convenience. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 2125 of file kimageeffect.cpp.
.PP
Referenced by charcoal(), and KPixmapEffect::toGray().
.SS "\fBQImage\fP & KImageEffect::desaturate (\fBQImage\fP & image, float desat = \fC0.3\fP)\fC [static]\fP"
.PP
Desaturate an image evenly. 
.PP
\fBParameters:\fP
.RS 4
\fIimage\fP The \fBQImage\fP to process. 
.br
\fIdesat\fP A value between 0 and 1 setting the degree of desaturation 
.RE
.PP
\fBReturns:\fP
.RS 4
Returns the image(), provided for convenience. 
.RE
.PP

.PP
Definition at line 2175 of file kimageeffect.cpp.
.PP
References QImage::bits(), QImage::colorTable(), QImage::depth(), QImage::height(), QImage::numColors(), QColor::rgb(), QColor::setHsv(), QColor::setRgb(), and QImage::width().
.PP
Referenced by KPixmapEffect::desaturate().
.SS "\fBQImage\fP & KImageEffect::contrast (\fBQImage\fP & image, int c)\fC [static]\fP"
.PP
Fast, but low quality contrast of an image. 
.PP
Also see contrastHSV.
.PP
\fBParameters:\fP
.RS 4
\fIimage\fP The \fBQImage\fP to process. 
.br
\fIc\fP A contrast value between -255 to 255. 
.RE
.PP
\fBReturns:\fP
.RS 4
The image(), provided for convenience. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) ### \fBKDE\fP 4: remove 
.RE
.PP

.PP
Definition at line 2198 of file kimageeffect.cpp.
.PP
References QImage::bits(), QImage::colorTable(), QImage::depth(), QImage::height(), QImage::numColors(), and QImage::width().
.PP
Referenced by KPixmapEffect::contrast().
.SS "\fBQImage\fP & KImageEffect::dither (\fBQImage\fP & image, const \fBQColor\fP * palette, int size)\fC [static]\fP"
.PP
Dither an image using Floyd-Steinberg dithering for low-color situations. 
.PP
\fBParameters:\fP
.RS 4
\fIimage\fP The \fBQImage\fP to process. 
.br
\fIpalette\fP The color palette to use 
.br
\fIsize\fP The size of the palette 
.RE
.PP
\fBReturns:\fP
.RS 4
Returns the image(), provided for convenience. 
.RE
.PP

.PP
Definition at line 2260 of file kimageeffect.cpp.
.PP
References QImage::scanLine(), QImage::setColor(), QImage::setNumColors(), and QImage::width().
.PP
Referenced by KPixmapEffect::blend(), KPixmapEffect::dither(), flatten(), gradient(), KPixmapEffect::hash(), and unbalancedGradient().
.SS "\fBQImage\fP & KImageEffect::selectedImage (\fBQImage\fP & img, const \fBQColor\fP & col)\fC [static]\fP"
.PP
Calculate the image for a selected image, for instance a selected icon on the desktop. 
.PP
\fBParameters:\fP
.RS 4
\fIimg\fP the \fBQImage\fP to select 
.br
\fIcol\fP the selected color, usually from \fBQColorGroup::highlight()\fP. 
.RE
.PP

.PP
Definition at line 2704 of file kimageeffect.cpp.
.PP
References blend().
.PP
Referenced by KPixmapEffect::selectedPixmap().
.SS "void KImageEffect::contrastHSV (\fBQImage\fP & img, bool sharpen = \fCtrue\fP)\fC [static]\fP"
.PP
High quality, expensive HSV contrast. 
.PP
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.
.PP
\fBParameters:\fP
.RS 4
\fIimg\fP The \fBQImage\fP to process. 
.br
\fIsharpen\fP If true sharpness is increase, (spiffed). Otherwise it is decreased, (dulled). 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 4642 of file kimageeffect.cpp.
.PP
References QColor::blue(), QColor::green(), QColor::red(), QColor::setHsv(), and QColor::setRgb().
.SS "void KImageEffect::normalize (\fBQImage\fP & img)\fC [static]\fP"
.PP
Normalises the pixel values to span the full range of color values. 
.PP
This is a contrast enhancement technique. 
.PP
\fBParameters:\fP
.RS 4
\fIimg\fP the image that is normalised 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 3721 of file kimageeffect.cpp.
.PP
Referenced by charcoal().
.SS "void KImageEffect::equalize (\fBQImage\fP & img)\fC [static]\fP"
.PP
Performs histogram equalisation on the reference image. 
.PP
\fBParameters:\fP
.RS 4
\fIimg\fP the image that is equalised 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 3931 of file kimageeffect.cpp.
.PP
Referenced by emboss().
.SS "void KImageEffect::threshold (\fBQImage\fP & img, unsigned int value = \fC128\fP)\fC [static]\fP"
.PP
Thresholds the reference image. 
.PP
You can also threshold images by using ThresholdDither in the various QPixmap/QImage convert methods, but this lets you specify a threshold value.
.PP
\fBParameters:\fP
.RS 4
\fIimg\fP The \fBQImage\fP to process. 
.br
\fIvalue\fP The threshold value. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 2839 of file kimageeffect.cpp.
.PP
References QImage::bits(), QImage::colorTable(), QImage::height(), QImage::numColors(), and QImage::width().
.PP
Referenced by solarize().
.SS "void KImageEffect::solarize (\fBQImage\fP & img, double factor = \fC50.0\fP)\fC [static]\fP"
.PP
Produces a 'solarization' effect seen when exposing a photographic film to light during the development process. 
.PP
\fBParameters:\fP
.RS 4
\fIimg\fP The \fBQImage\fP to process. 
.br
\fIfactor\fP The extent of the solarization (0-99.9) 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 3450 of file kimageeffect.cpp.
.PP
References QImage::bits(), QImage::colorTable(), QImage::height(), QImage::numColors(), threshold(), and QImage::width().
.SS "\fBQImage\fP KImageEffect::emboss (\fBQImage\fP & src, double radius, double sigma)\fC [static]\fP"
.PP
Embosses the source image. 
.PP
This involves highlighting the edges and applying various other enhancements in order to get a metal effect.
.PP
\fBParameters:\fP
.RS 4
\fIsrc\fP The \fBQImage\fP to process. 
.br
\fIradius\fP The radius of the gaussian not counting the center pixel. Use 0 and a suitable radius will be automatically used. 
.br
\fIsigma\fP The standard deviation of the gaussian. Use 1 if you're not sure. 
.RE
.PP
\fBReturns:\fP
.RS 4
The embossed image. The original is not changed. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 4069 of file kimageeffect.cpp.
.PP
References QImage::convertDepth(), and equalize().
.PP
Referenced by emboss().
.SS "\fBQImage\fP KImageEffect::emboss (\fBQImage\fP & src)\fC [static]\fP"
.PP
Convenience method. 
.PP
Definition at line 4063 of file kimageeffect.cpp.
.PP
References emboss().
.SS "\fBQImage\fP KImageEffect::despeckle (\fBQImage\fP & src)\fC [static]\fP"
.PP
Minimizes speckle noise in the source image using the 8 hull algorithm. 
.PP
\fBParameters:\fP
.RS 4
\fIsrc\fP The \fBQImage\fP to process. 
.RE
.PP
\fBReturns:\fP
.RS 4
The despeckled image. The original is not changed. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 2935 of file kimageeffect.cpp.
.PP
References QImage::colorTable(), QImage::scanLine(), and QImage::width().
.SS "\fBQImage\fP KImageEffect::charcoal (\fBQImage\fP & src, double radius, double sigma)\fC [static]\fP"
.PP
Produces a neat little 'charcoal' effect. 
.PP
\fBParameters:\fP
.RS 4
\fIsrc\fP The \fBQImage\fP to process. 
.br
\fIradius\fP The radius of the gaussian not counting the center pixel. Use 0 and a suitable radius will be automatically used. 
.br
\fIsigma\fP The standard deviation of the gaussian. Use 1 if you're not sure. 
.RE
.PP
\fBReturns:\fP
.RS 4
The charcoal image. The original is not changed. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 3711 of file kimageeffect.cpp.
.PP
References blur(), edge(), QImage::invertPixels(), normalize(), and toGray().
.PP
Referenced by charcoal().
.SS "\fBQImage\fP KImageEffect::charcoal (\fBQImage\fP & src, double factor = \fC50.0\fP)\fC [static]\fP"
.PP
This is provided for binary compatability only! Use the above method with a radius and sigma instead! 
.PP
Definition at line 3705 of file kimageeffect.cpp.
.PP
References charcoal().
.SS "\fBQImage\fP KImageEffect::rotate (\fBQImage\fP & src, \fBRotateDirection\fP r)\fC [static]\fP"
.PP
Rotates the image by the specified amount. 
.PP
\fBParameters:\fP
.RS 4
\fIsrc\fP The \fBQImage\fP to process. 
.br
\fIr\fP The rotate direction. 
.RE
.PP
\fBReturns:\fP
.RS 4
The rotated image. The original is not changed. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 3352 of file kimageeffect.cpp.
.PP
References QImage::colorTable(), QImage::create(), Rotate180, Rotate270, Rotate90, QImage::scanLine(), and QImage::setNumColors().
.SS "\fBQImage\fP KImageEffect::sample (\fBQImage\fP & src, int w, int h)\fC [static]\fP"
.PP
Scales an image using simple pixel sampling. 
.PP
This does not produce nearly as nice a result as \fBQImage::smoothScale()\fP, but has the advantage of being much faster - only a few milliseconds.
.PP
\fBParameters:\fP
.RS 4
\fIsrc\fP The \fBQImage\fP to process. 
.br
\fIw\fP The new width. 
.br
\fIh\fP The new height. 
.RE
.PP
\fBReturns:\fP
.RS 4
The scaled image. The original is not changed. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 2746 of file kimageeffect.cpp.
.PP
References QImage::height(), QImage::scanLine(), QImage::setNumColors(), and QImage::width().
.SS "\fBQImage\fP KImageEffect::addNoise (\fBQImage\fP & src, \fBNoiseType\fP type = \fCGaussianNoise\fP)\fC [static]\fP"
.PP
Adds noise to an image. 
.PP
\fBParameters:\fP
.RS 4
\fIsrc\fP The \fBQImage\fP to process. 
.br
\fItype\fP The algorithm used to generate the noise. 
.RE
.PP
\fBReturns:\fP
.RS 4
The image with noise added. The original is not changed. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 3141 of file kimageeffect.cpp.
.PP
References QImage::colorTable(), and QImage::scanLine().
.SS "\fBQImage\fP KImageEffect::blur (\fBQImage\fP & src, double radius, double sigma)\fC [static]\fP"
.PP
Blurs an image by convolving pixel neighborhoods. 
.PP
\fBParameters:\fP
.RS 4
\fIsrc\fP The \fBQImage\fP to process. 
.br
\fIradius\fP The radius of the gaussian not counting the center pixel. Use 0 and a suitable radius will be automatically used. 
.br
\fIsigma\fP The standard deviation of the gaussian. Use 1 if you're not sure. 
.RE
.PP
\fBReturns:\fP
.RS 4
The blurred image. The original is not changed. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 4288 of file kimageeffect.cpp.
.PP
References QImage::convertDepth(), QImage::create(), QImage::jumpTable(), and QImage::scanLine().
.PP
Referenced by blur(), and charcoal().
.SS "\fBQImage\fP KImageEffect::blur (\fBQImage\fP & src, double factor = \fC50.0\fP)\fC [static]\fP"
.PP
This is provided for binary compatability only! Use the above method with a radius and sigma instead! 
.PP
Definition at line 4282 of file kimageeffect.cpp.
.PP
References blur().
.SS "\fBQImage\fP KImageEffect::edge (\fBQImage\fP & src, double radius)\fC [static]\fP"
.PP
Detects edges in an image using pixel neighborhoods and an edge detection mask. 
.PP
\fBParameters:\fP
.RS 4
\fIsrc\fP The \fBQImage\fP to process. 
.br
\fIradius\fP The radius of the gaussian not counting the center pixel. Use 0 and a suitable radius will be automatically used. 
.RE
.PP
\fBReturns:\fP
.RS 4
The image with edges detected. The original is not changed. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 4031 of file kimageeffect.cpp.
.PP
Referenced by charcoal().
.SS "\fBQImage\fP KImageEffect::implode (\fBQImage\fP & src, double factor = \fC30.0\fP, unsigned int background = \fC0xFFFFFFFF\fP)\fC [static]\fP"
.PP
Implodes an image by a specified percent. 
.PP
\fBParameters:\fP
.RS 4
\fIsrc\fP The \fBQImage\fP to process. 
.br
\fIfactor\fP The extent of the implosion. 
.br
\fIbackground\fP An RGBA value to use for the background. After the effect some pixels may be 'empty'. This value is used for those pixels. 
.RE
.PP
\fBReturns:\fP
.RS 4
The imploded image. The original is not changed. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 3271 of file kimageeffect.cpp.
.PP
References QImage::colorTable(), QImage::height(), QImage::scanLine(), and QImage::width().
.SS "\fBQImage\fP KImageEffect::oilPaintConvolve (\fBQImage\fP & src, double radius)\fC [static]\fP"
.PP
Produces an oil painting effect. 
.PP
\fBParameters:\fP
.RS 4
\fIsrc\fP The \fBQImage\fP to process. 
.br
\fIradius\fP The radius of the gaussian not counting the center pixel. Use 0 and a suitable radius will be automatically used. 
.RE
.PP
\fBReturns:\fP
.RS 4
The new image. The original is not changed. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 3641 of file kimageeffect.cpp.
.PP
References QImage::convertDepth(), QImage::detach(), QImage::height(), QImage::jumpTable(), QImage::scanLine(), and QImage::width().
.PP
Referenced by oilPaint().
.SS "\fBQImage\fP KImageEffect::oilPaint (\fBQImage\fP & src, int radius = \fC3\fP)\fC [static]\fP"
.PP
This is provided for binary compatability only! Use the above method instead! 
.PP
Definition at line 3635 of file kimageeffect.cpp.
.PP
References oilPaintConvolve().
.SS "\fBQImage\fP KImageEffect::sharpen (\fBQImage\fP & src, double radius, double sigma)\fC [static]\fP"
.PP
Sharpens the pixels in the image using pixel neighborhoods. 
.PP
\fBParameters:\fP
.RS 4
\fIsrc\fP The \fBQImage\fP to process. 
.br
\fIradius\fP The radius of the gaussian not counting the center pixel. Use 0 and a suitable radius will be automatically used. 
.br
\fIsigma\fP The standard deviation of the gaussian. Use 1 if you're not sure. 
.RE
.PP
\fBReturns:\fP
.RS 4
The sharpened image. The original is not changed. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 4464 of file kimageeffect.cpp.
.PP
Referenced by sharpen().
.SS "\fBQImage\fP KImageEffect::sharpen (\fBQImage\fP & src, double factor = \fC30.0\fP)\fC [static]\fP"
.PP
This is provided for binary compatability only! Use the above method instead! 
.PP
Definition at line 4458 of file kimageeffect.cpp.
.PP
References sharpen().
.SS "\fBQImage\fP KImageEffect::spread (\fBQImage\fP & src, unsigned int amount = \fC3\fP)\fC [static]\fP"
.PP
Randomly displaces pixels. 
.PP
\fBParameters:\fP
.RS 4
\fIsrc\fP The \fBQImage\fP to process. 
.br
\fIamount\fP The vicinity for choosing a random pixel to swap. 
.RE
.PP
\fBReturns:\fP
.RS 4
The image with pixels displaced. The original is not changed. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 3473 of file kimageeffect.cpp.
.PP
References QImage::detach(), and QImage::scanLine().
.SS "\fBQImage\fP KImageEffect::shade (\fBQImage\fP & src, bool color_shading = \fCtrue\fP, double azimuth = \fC30.0\fP, double elevation = \fC30.0\fP)\fC [static]\fP"
.PP
Shades the image using a distance light source. 
.PP
\fBParameters:\fP
.RS 4
\fIsrc\fP The \fBQImage\fP to process. 
.br
\fIcolor_shading\fP If true do color shading, otherwise do grayscale. 
.br
\fIazimuth\fP Determines the light source and direction. 
.br
\fIelevation\fP Determines the light source and direction. 
.RE
.PP
\fBReturns:\fP
.RS 4
The shaded image. The original is not changed. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 4504 of file kimageeffect.cpp.
.PP
References shade().
.PP
Referenced by shade().
.SS "\fBQImage\fP KImageEffect::swirl (\fBQImage\fP & src, double degrees = \fC50.0\fP, unsigned int background = \fC0xFFFFFFFF\fP)\fC [static]\fP"
.PP
Swirls the image by a specified amount. 
.PP
\fBParameters:\fP
.RS 4
\fIsrc\fP The \fBQImage\fP to process. 
.br
\fIdegrees\fP The tightness of the swirl. 
.br
\fIbackground\fP An RGBA value to use for the background. After the effect some pixels may be 'empty'. This value is used for those pixels. 
.RE
.PP
\fBReturns:\fP
.RS 4
The swirled image. The original is not changed. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 3524 of file kimageeffect.cpp.
.PP
References QImage::colorTable(), QImage::height(), QImage::scanLine(), and QImage::width().
.SS "\fBQImage\fP KImageEffect::wave (\fBQImage\fP & src, double amplitude = \fC25.0\fP, double frequency = \fC150.0\fP, unsigned int background = \fC0xFFFFFFFF\fP)\fC [static]\fP"
.PP
Modifies the pixels along a sine wave. 
.PP
\fBParameters:\fP
.RS 4
\fIsrc\fP The \fBQImage\fP to process. 
.br
\fIamplitude\fP The amplitude of the sine wave. 
.br
\fIfrequency\fP The frequency of the sine wave. 
.br
\fIbackground\fP An RGBA value to use for the background. After the effect some pixels may be 'empty'. This value is used for those pixels. 
.RE
.PP
\fBReturns:\fP
.RS 4
The new image. The original is not changed. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Daniel M. Duley (mosfet) 
.RE
.PP

.PP
Definition at line 3602 of file kimageeffect.cpp.
.PP
References QImage::scanLine().
.SS "\fBQImage\fP KImageEffect::bumpmap (\fBQImage\fP & img, \fBQImage\fP & map, double azimuth, double elevation, int depth, int xofs, int yofs, int waterlevel, int ambient, bool compensate, bool invert, \fBBumpmapType\fP type, bool tiled)\fC [static]\fP"
.PP
A bumpmapping algorithm. 
.PP
\fBParameters:\fP
.RS 4
\fIimg\fP the image you want bumpmap 
.br
\fImap\fP the map used 
.br
\fIazimuth\fP azimuth 
.br
\fIelevation\fP elevation 
.br
\fIdepth\fP depth (not the depth of the image, but of the map) 
.br
\fIxofs\fP X offset 
.br
\fIyofs\fP Y offset 
.br
\fIwaterlevel\fP level that full transparency should represent 
.br
\fIambient\fP ambient lighting factor 
.br
\fIcompensate\fP compensate for darkening 
.br
\fIinvert\fP invert bumpmap 
.br
\fItype\fP type of the bumpmap 
.br
\fItiled\fP tile the bumpmap over the image through the Y offset
.RE
.PP
\fBReturns:\fP
.RS 4
The destination image (dst) containing the result. 
.RE
.PP
\fBAuthor:\fP
.RS 4
Zack Rusin <zack@kde.org> 
.RE
.PP

.PP
Definition at line 4885 of file kimageeffect.cpp.
.PP
References QImage::create(), QImage::depth(), FXCLAMP, QImage::hasAlphaBuffer(), QImage::height(), QImage::scanLine(), and QImage::width().

.SH "Author"
.PP 
Generated automatically by Doxygen for kdefx Library from the source code.
