diff options
Diffstat (limited to 'doc/man/man3/tqimage.3qt')
| -rw-r--r-- | doc/man/man3/tqimage.3qt | 22 |
1 files changed, 5 insertions, 17 deletions
diff --git a/doc/man/man3/tqimage.3qt b/doc/man/man3/tqimage.3qt index 42ba2b561..ef4aacbf3 100644 --- a/doc/man/man3/tqimage.3qt +++ b/doc/man/man3/tqimage.3qt @@ -363,8 +363,6 @@ If this looks complicated, it might be a good idea to convert the 1-bpp image to .br .fi .PP -On Qt/Embedded, scanlines are aligned to the pixel depth and may be padded to any degree, while on all other platforms, the scanlines are 32-bit aligned for all depths. The constructor taking a \fCuchar*\fR argument always expects 32-bit aligned data. On Qt/Embedded, an additional constructor allows the number of bytes-per-line to be specified. -.PP TQImage supports a variety of methods for getting information about the image, for example, colorTable(), allGray(), isGrayscale(), bitOrder(), bytesPerLine(), depth(), dotsPerMeterX() and dotsPerMeterY(), hasAlphaBuffer(), numBytes(), numColors(), and width() and height(). .PP Pixel colors are retrieved with pixel() and set with setPixel(). @@ -464,14 +462,6 @@ If \fIcolortable\fR is 0, a color table sufficient for \fInumColors\fR will be a Note that \fIyourdata\fR must be 32-bit aligned. .PP The endianness is given in \fIbitOrder\fR. -.SH "TQImage::TQImage ( uchar * yourdata, int w, int h, int depth, int bpl, TQRgb * colortable, int numColors, Endian bitOrder )" -Constructs an image that uses an existing memory buffer. The buffer must remain valid for the life of the TQImage. The image does not delete the buffer at destruction. The buffer is passed as \fIyourdata\fR. The image's width is \fIw\fR and its height is \fIh\fR. The color depth is \fIdepth\fR. \fIbpl\fR specifies the number of bytes per line. -.PP -If \fIcolortable\fR is 0, a color table sufficient for \fInumColors\fR will be allocated (and destructed later). -.PP -The endianness is specified by \fIbitOrder\fR. -.PP -\fBWarning:\fR This constructor is only available on Qt/Embedded. .SH "TQImage::TQImage ( const TQImage & image )" Constructs a shallow copy of \fIimage\fR. .SH "TQImage::~TQImage ()" @@ -479,7 +469,7 @@ Destroys the image and cleans up. .SH "bool TQImage::allGray () const" Returns TRUE if all the colors in the image are shades of gray (i.e. their red, green and blue components are equal); otherwise returns FALSE. .PP -This function is slow for large 16-bit (Qt/Embedded only) and 32-bit images. +This function is slow for 32-bit images. .PP See also isGrayscale(). .SH "Endian TQImage::bitOrder () const" @@ -521,7 +511,7 @@ See also bitOrder(), systemBitOrder(), and isNull(). .SH "TQImage TQImage::convertDepth ( int depth, int conversion_flags ) const" Converts the depth (bpp) of the image to \fIdepth\fR and returns the converted image. The original image is not changed. .PP -The \fIdepth\fR argument must be 1, 8, 16 (Qt/Embedded only) or 32. +The \fIdepth\fR argument must be 1, 8 or 32. .PP Returns \fC*this\fR if \fIdepth\fR is equal to the image depth, or a null image if this image cannot be converted. .PP @@ -597,7 +587,7 @@ Returns the depth of the image. .PP The image depth is the number of bits used to encode a single pixel, also called bits per pixel (bpp) or bit planes of an image. .PP -The supported depths are 1, 8, 16 (Qt/Embedded only) and 32. +The supported depths are 1, 8 and 32. .PP See also convertDepth(). .SH "void TQImage::detach ()" @@ -686,7 +676,7 @@ Note that inverting an 8-bit image means to replace all pixels using color index .PP See also fill(), depth(), and hasAlphaBuffer(). .SH "bool TQImage::isGrayscale () const" -For 16-bit (Qt/Embedded only) and 32-bit images, this function is equivalent to allGray(). +For 32-bit images, this function is equivalent to allGray(). .PP For 8-bpp images, this function returns TRUE if color(i) is TQRgb(i,i,i) for all indices of the color table; otherwise returns FALSE. .PP @@ -738,7 +728,7 @@ See also bytesPerLine() and bits(). .SH "int TQImage::numColors () const" Returns the size of the color table for the image. .PP -Notice that numColors() returns 0 for 16-bpp (Qt/Embedded only) and 32-bpp images because these images do not use color tables, but instead encode pixel values as RGB triplets. +Notice that numColors() returns 0 for 32-bpp images because these images do not use color tables, but instead encode pixel values as RGB triplets. .PP See also setNumColors() and colorTable(). .PP @@ -877,8 +867,6 @@ The scanline data is aligned on a 32-bit boundary. .PP \fBWarning:\fR If you are accessing 32-bpp image data, cast the returned pointer to \fCQRgb*\fR (TQRgb has a 32-bit size) and use it to read/write the pixel value. You cannot use the \fCuchar*\fR pointer directly, because the pixel format depends on the byte order on the underlying platform. Hint: use tqRed(), tqGreen() and tqBlue(), etc. (ntqcolor.h) to access the pixels. .PP -\fBWarning:\fR If you are accessing 16-bpp image data, you must handle endianness yourself. (Qt/Embedded only) -.PP See also bytesPerLine(), bits(), and jumpTable(). .PP Example: desktop/desktop.cpp. |