class KPixmap

Off-screen paint device with extended features. More...

Definition#include <kpixmap.h>
InheritsQPixmap (qt) [public ]
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

Public Types

Public Methods


Detailed Description

Off-screen paint device with extended features.

KPixmap has two new color modes, WebColor and LowColor, applicable to 8bpp displays.

In WebColor mode all images are dithered to the Netscape palette, even when they have their own color table. WebColor is the default mode for KPixmap so that standard applications can share the Netscape palette across the desktop.

In LowColor mode images are checked to see if their color table matches the KDE icon palette. If the color tables do not match, the images are dithered to a minimal 3x3x3 color cube. LowColor mode can be used to load icons, background images etc. so that components of the desktop which are always present use no more than 40 colors.

enum ColorMode { Auto, Color, Mono, LowColor, WebColor }

ColorMode

enum GradientMode { Horizontal, Vertical, Diagonal, CrossDiagonal }

GradientMode

 KPixmap ()

KPixmap

Constructs a null pixmap.

 ~KPixmap ()

~KPixmap

Destructs the pixmap.

 KPixmap (const QPixmap& pix)

KPixmap

Copies the QPixmap pix.

bool  convertFromImage ( const QImage &img, int conversion_flags )

convertFromImage

Converts an image and sets this pixmap.

The conversion_flags argument is a bitwise-OR from the following choices. The options marked (default) are the choice if no other choice from the list is included (they are zero):

Color/Mono preference

Dithering mode preference, for RGB channels

Dithering mode preference, for alpha channel

Color matching versus dithering preference

Passing 0 for conversion_flags gives all the default options.

Returns: true if successful.

Reimplemented from QPixmap.

bool  convertFromImage ( const QImage &img, ColorMode mode = WebColor )

convertFromImage

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Reimplemented from QPixmap.

bool  load ( const QString& fileName, const char *format, int conversion_flags )

load

Loads a pixmap from the file fileName.

If format is specified, the loader attempts to read the pixmap using the specified format. If format is not specified (default), the loader reads a few bytes from the header to guess the file format.

See the convertFromImage() documentation for a description of the conversion_flags argument.

The QImageIO documentation lists the supported image formats and explains how to add extra formats.

Returns: true if successful, or false if the pixmap could not be loaded.

bool  load ( const QString& fileName, const char *format = 0, ColorMode mode = WebColor )

load

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

bool  checkColorTable (const QImage &image)

checkColorTable

Returns true if the image posesses a color table that matches the Icon palette or false otherwise.

An image with one color not found in the Icon palette is considered to be a match, since this extra color may be a transparent background.