|
|
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.
QImage gradient (const QSize &size, const QColor &ca, const QColor &cb, GradientType type, int ncols=3) |
Create a gradient from color a to color b of the specified type.
Parameters:
size | The desired size of the gradient. |
ca | Color a |
cb | Color b |
type | The type of gradient. |
ncols | 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. |
QImage unbalancedGradient (const QSize &size, const QColor &ca, const QColor &cb, GradientType type, int xfactor = 100, int yfactor = 100, int ncols = 3) |
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.
Parameters:
size | The desired size of the gradient. |
ca | Color a |
cb | Color b |
type | The type of gradient. |
xfactor | The x decay length. Use a value between -200 and 200. |
yfactor | The y decay length. |
ncols | The number of colors. See KPixmapEffect:gradient. |
QImage& blend (QImage &image, float initial_intensity, const QColor &bgnd, GradientType eff, bool anti_dir=false) |
Blends the provided image into a background of the indicated color
Parameters:
initial_intensity | 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 |
bgnd | indicates the color of the background to blend in |
eff | lets you choose what kind of blending you like |
anti_dir | blend in the opposite direction (makes no much sense with concentric blending effects) |
QImage& channelIntensity (QImage &image, float percent, RGBComponent channel) |
Modifies the intensity of a pixmap's RGB channel component.
Parameters:
image | The QImage to process. |
percent | percent value. Use a negative value to dim. |
channel | which channel(s) should be modified |
Returns: Returns the image, provided for convenience.
QImage& fade (QImage &img, float val, const QColor &color) |
Fade an image to a certain background color. The number of colors will not be changed.
Parameters:
image | The QImage to process. |
val | The strength of the effect. 0 <= val <= 1. |
color | The background color. |
Returns: Returns the image, provided for convenience.
QImage& flatten (QImage &image, const QColor &ca, const QColor &cb, int ncols=0) |
This recolors an image. The most dark color will become color a, This recolors a pixmap. The most dark color will become color a, the most bright one color b, and in between.
Parameters:
image | A QImage to process. |
ca | Color a |
cb | Color b |
QImage& hash (QImage &image, Lighting lite=NorthLite, unsigned int spacing=0) |
Builds a hash on any given QImage
Parameters:
image | The QImage to process |
lite | - the hash faces the indicated lighting (cardinal poles) |
spacing | - how many unmodified pixels inbetween hashes |
Returns: Returns the image, provided for convenience.
QImage& intensity (QImage &image, float percent) |
Either brightens or dims the image by a specified percent. For example, .5 will modify the colors by 50%.
Parameters:
image | The QImage to process. |
percent | the percent value. Use a negative value to dim. |
Returns: Returns the image, provided for convenience.
QImage& toGray (QImage &image, bool fast = false) |
Converts an image to grayscale.
Parameters:
image | The QImage to process. |
fast | Set to true in order to use a faster but non-photographic quality algorithm. Appropriate for things such as toolbar icons. |
Returns: Returns the image, provided for convenience.
QImage& desaturate (QImage &image, float desat = 0.3) |
Desaturates an image evenly.
Parameters:
image | The QImage to process. |
desat | A value between 0 and 1 setting the degree of desaturation |
Returns: Returns the image, provided for convenience.
QImage& contrast (QImage &image, int c) |
Modifies the contrast of an image.
Parameters:
image | The QImage to process. |
c | A contrast value between -255 to 255. |
Returns: Returns the image, provided for convenience.
Generated by: root@tantive.terraplex.com on Sun Feb 27 17:39:25 2000, using kdoc 2.0a33. |