diff options
Diffstat (limited to 'doc/html/tqimage.html')
| -rw-r--r-- | doc/html/tqimage.html | 33 |
1 files changed, 7 insertions, 26 deletions
diff --git a/doc/html/tqimage.html b/doc/html/tqimage.html index d47f9d982..8d7cd5213 100644 --- a/doc/html/tqimage.html +++ b/doc/html/tqimage.html @@ -197,12 +197,8 @@ significant byte is reserved for the alpha buffer. *p = <a href="ntqcolor.html#qRgb">tqRgb</a>(255,255,0); </pre> -<p> On TQt/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 +<p> The scanlines are 32-bit aligned for all depths. The constructor taking a <tt>uchar*</tt> argument always expects 32-bit aligned data. -On TQt/Embedded, an additional constructor allows the number of -bytes-per-line to be specified. <p> TQImage supports a variety of methods for getting information about the image, for example, <a href="#colorTable">colorTable</a>(), <a href="#allGray">allGray</a>(), <a href="#isGrayscale">isGrayscale</a>(), <a href="#bitOrder">bitOrder</a>(), <a href="#bytesPerLine">bytesPerLine</a>(), <a href="#depth">depth</a>(), <a href="#dotsPerMeterX">dotsPerMeterX</a>() and @@ -325,19 +321,6 @@ will be allocated (and destructed later). <p> Note that <em>yourdata</em> must be 32-bit aligned. <p> The endianness is given in <em>bitOrder</em>. -<h3 class=fn><a name="TQImage-8"></a>TQImage::TQImage ( uchar * yourdata, int w, int h, int depth, int bpl, TQRgb * colortable, int numColors, <a href="tqimage.html#Endian-enum">Endian</a> bitOrder ) -</h3> -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 -<em>yourdata</em>. The image's width is <em>w</em> and its height is <em>h</em>. The -color depth is <em>depth</em>. <em>bpl</em> specifies the number of bytes per -line. -<p> If <em>colortable</em> is 0, a color table sufficient for <em>numColors</em> -will be allocated (and destructed later). -<p> The endianness is specified by <em>bitOrder</em>. -<p> <b>Warning:</b> This constructor is only available on TQt/Embedded. - <h3 class=fn><a name="TQImage-9"></a>TQImage::TQImage ( const <a href="tqimage.html">TQImage</a> & image ) </h3> Constructs a <a href="shclass.html">shallow copy</a> of <em>image</em>. @@ -351,7 +334,7 @@ Destroys the image and cleans up. 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. -<p> This function is slow for large 16-bit (TQt/Embedded only) and 32-bit images. +<p> This function is slow for large 32-bit images. <p> <p>See also <a href="#isGrayscale">isGrayscale</a>(). <h3 class=fn><a href="tqimage.html#Endian-enum">Endian</a> <a name="bitOrder"></a>TQImage::bitOrder () const @@ -408,7 +391,7 @@ be converted. </h3> Converts the depth (bpp) of the image to <em>depth</em> and returns the converted image. The original image is not changed. -<p> The <em>depth</em> argument must be 1, 8, 16 (TQt/Embedded only) or 32. +<p> The <em>depth</em> argument must be 1, 8 or 32. <p> Returns <tt>*this</tt> if <em>depth</em> is equal to the image depth, or a <a href="#isNull">null</a> image if this image cannot be converted. @@ -510,7 +493,7 @@ pixels; otherwise, the mask is larger than the data pixels. <p> Returns the depth of the image. <p> 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. -<p> The supported depths are 1, 8, 16 (TQt/Embedded only) and 32. +<p> The supported depths are 1, 8 and 32. <p> <p>See also <a href="#convertDepth">convertDepth</a>(). <h3 class=fn>void <a name="detach"></a>TQImage::detach () @@ -623,7 +606,7 @@ using color index <em>i</em> with a pixel using color index 255 minus <em>i</em> <h3 class=fn>bool <a name="isGrayscale"></a>TQImage::isGrayscale () const </h3> -For 16-bit (TQt/Embedded only) and 32-bit images, this function is +For 32-bit images, this function is equivalent to <a href="#allGray">allGray</a>(). <p> For 8-bpp images, this function returns TRUE if <a href="#color">color</a>(i) is TQRgb(i,i,i) for all indices of the color table; otherwise returns @@ -696,8 +679,8 @@ changed. </h3> <p> Returns the size of the color table for the image. -<p> Notice that <a href="#numColors">numColors</a>() returns 0 for 16-bpp (TQt/Embedded only) -and 32-bpp images because these images do not use color tables, +<p> Notice that <a href="#numColors">numColors</a>() returns 0 for +32-bpp images because these images do not use color tables, but instead encode pixel values as RGB triplets. <p> <p>See also <a href="#setNumColors">setNumColors</a>() and <a href="#colorTable">colorTable</a>(). @@ -871,8 +854,6 @@ read/write the pixel value. You cannot use the <tt>uchar*</tt> pointer directly, because the pixel format depends on the byte order on the underlying platform. Hint: use <a href="ntqcolor.html#qRed">tqRed()</a>, <a href="ntqcolor.html#qGreen">tqGreen()</a> and <a href="ntqcolor.html#qBlue">tqBlue()</a>, etc. (ntqcolor.h) to access the pixels. -<p> <b>Warning:</b> If you are accessing 16-bpp image data, you must handle -endianness yourself. (TQt/Embedded only) <p> <p>See also <a href="#bytesPerLine">bytesPerLine</a>(), <a href="#bits">bits</a>(), and <a href="#jumpTable">jumpTable</a>(). <p>Example: <a href="desktop-example.html#x1729">desktop/desktop.cpp</a>. |