<aname="1"></a><p> To start a drag, for example in a <ahref="tqwidget.html#mouseMoveEvent">mouse motion event</a>, create an object of the <ahref="ntqdragobject.html">TQDragObject</a>
subclass appropriate for your media, such as <ahref="qtextdrag.html">TQTextDrag</a> for text and
<ahref="qimagedrag.html">TQImageDrag</a> for images. Then call the drag() method. This is all you
<ahref="tqimagedrag.html">TQImageDrag</a> for images. Then call the drag() method. This is all you
need for simple dragging of existing types.
<p> For example, to start dragging some text from a widget:
Returns the clipboard image, or returns a null image if the
clipboard does not contain an image or if it contains an image in
@ -213,9 +213,9 @@ clipboard is used. If <em>mode</em> is TQClipboard::Clipboard, the
image is retrieved from the global clipboard. If <em>mode</em> is
TQClipboard::Selection, the image is retrieved from the global
mouse selection.
<p><p>See also <ahref="#setImage">setImage</a>(), <ahref="#pixmap">pixmap</a>(), <ahref="#data">data</a>(), and <ahref="ntqimage.html#isNull">TQImage::isNull</a>().
<p><p>See also <ahref="#setImage">setImage</a>(), <ahref="#pixmap">pixmap</a>(), <ahref="#data">data</a>(), and <ahref="tqimage.html#isNull">TQImage::isNull</a>().
<p>Inherits <ahref="tqobject.html">TQObject</a> and <ahref="qmimesource.html">TQMimeSource</a>.
<p>Inherited by <ahref="qstoreddrag.html">TQStoredDrag</a>, <ahref="qtextdrag.html">TQTextDrag</a>, <ahref="qimagedrag.html">TQImageDrag</a>, and <ahref="qicondrag.html">TQIconDrag</a>.
<p>Inherited by <ahref="qstoreddrag.html">TQStoredDrag</a>, <ahref="qtextdrag.html">TQTextDrag</a>, <ahref="tqimagedrag.html">TQImageDrag</a>, and <ahref="qicondrag.html">TQIconDrag</a>.
<p><ahref="qdragobject-members.html">List of all member functions.</a>
Draws at (<em>x</em>, <em>y</em>) the <em>sw</em> by <em>sh</em> area of pixels from (<em>sx</em>, <em>sy</em>) in <em>image</em>, using <em>conversionFlags</em> if the image
needs to be converted to a pixmap. The default value for <em>conversionFlags</em> is 0; see convertFromImage() for information about
@ -618,12 +618,12 @@ if device() is a <a href="ntqprinter.html">TQPrinter</a> or <a href="ntqpicture.
<p><p>See also <ahref="#drawPixmap">drawPixmap</a>() and <ahref="ntqpixmap.html#convertFromImage">TQPixmap::convertFromImage</a>().
Converts image <em>img</em> and sets this pixmap. Returns TRUE if
successful; otherwise returns FALSE.
@ -320,19 +320,19 @@ sets all the default options.
converted to an image, the pixels painted with color0 will produce
pixel index 0 in the image and those painted with color1 will
produce pixel index 1.
<p><p>See also <ahref="#convertToImage">convertToImage</a>(), <ahref="#isTQBitmap">isTQBitmap</a>(), <ahref="ntqimage.html#convertDepth">TQImage::convertDepth</a>(), <ahref="#defaultDepth">defaultDepth</a>(), and <ahref="ntqimage.html#hasAlphaBuffer">TQImage::hasAlphaBuffer</a>().
<p><p>See also <ahref="#convertToImage">convertToImage</a>(), <ahref="#isTQBitmap">isTQBitmap</a>(), <ahref="tqimage.html#convertDepth">TQImage::convertDepth</a>(), <ahref="#defaultDepth">defaultDepth</a>(), and <ahref="tqimage.html#hasAlphaBuffer">TQImage::hasAlphaBuffer</a>().
<p>Examples: <ahref="canvas-example.html#x2943">canvas/canvas.cpp</a> and <ahref="themes-example.html#x228">themes/wood.cpp</a>.
<h3class=fn>bool <aname="convertFromImage-2"></a>TQPixmap::convertFromImage ( const <ahref="ntqimage.html">TQImage</a> & image, <ahref="ntqpixmap.html#ColorMode-enum">ColorMode</a> mode = Auto )
<h3class=fn>bool <aname="convertFromImage-2"></a>TQPixmap::convertFromImage ( const <ahref="tqimage.html">TQImage</a> & image, <ahref="ntqpixmap.html#ColorMode-enum">ColorMode</a> mode = Auto )
</h3>
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
<p> Converts <em>image</em> and sets this pixmap using color mode <em>mode</em>.
Returns TRUE if successful; otherwise returns FALSE.
<p><p>See also <ahref="#ColorMode-enum">TQPixmap::ColorMode</a>.
@ -377,7 +377,7 @@ Returns the default pixmap optimization setting.
<p> Returns the depth of the pixmap.
<p> The pixmap depth is also called bits per pixel (bpp) or bit planes
of a pixmap. A null pixmap has depth 0.
<p><p>See also <ahref="#defaultDepth">defaultDepth</a>(), <ahref="#isNull">isNull</a>(), and <ahref="ntqimage.html#convertDepth">TQImage::convertDepth</a>().
<p><p>See also <ahref="#defaultDepth">defaultDepth</a>(), <ahref="#isNull">isNull</a>(), and <ahref="tqimage.html#convertDepth">TQImage::convertDepth</a>().
</h3> Convenience function. Gets the data associated with the absolute
name <em>abs_name</em> from the default mime source factory and decodes it
to a pixmap.
<p><p>See also <ahref="qmimesourcefactory.html">TQMimeSourceFactory</a>, <ahref="ntqimage.html#fromMimeSource">TQImage::fromMimeSource</a>(), and <ahref="qimagedrag.html#decode">TQImageDrag::decode</a>().
<p><p>See also <ahref="qmimesourcefactory.html">TQMimeSourceFactory</a>, <ahref="tqimage.html#fromMimeSource">TQImage::fromMimeSource</a>(), and <ahref="tqimagedrag.html#decode">TQImageDrag::decode</a>().
@ -554,9 +554,9 @@ using the specified format. If <em>format</em> is not specified
the file's format.
<p> See the <ahref="#convertFromImage">convertFromImage</a>() documentation for a description of the
<em>conversion_flags</em> argument.
<p> The <ahref="qimageio.html">TQImageIO</a> documentation lists the supported image formats and
<p> The <ahref="tqimageio.html">TQImageIO</a> documentation lists the supported image formats and
explains how to add extra formats.
<p><p>See also <ahref="#loadFromData">loadFromData</a>(), <ahref="#save">save</a>(), <ahref="#imageFormat">imageFormat</a>(), <ahref="ntqimage.html#load">TQImage::load</a>(), and <ahref="qimageio.html">TQImageIO</a>.
<p><p>See also <ahref="#loadFromData">loadFromData</a>(), <ahref="#save">save</a>(), <ahref="#imageFormat">imageFormat</a>(), <ahref="tqimage.html#load">TQImage::load</a>(), and <ahref="tqimageio.html">TQImageIO</a>.
<p>Examples: <ahref="picture-example.html#x124">picture/picture.cpp</a>, <ahref="scrollview-example.html#x640">scrollview/scrollview.cpp</a>, and <ahref="xform-example.html#x1247">xform/xform.cpp</a>.
@ -580,9 +580,9 @@ using the specified format. If <em>format</em> is not specified
the file's format.
<p> See the <ahref="#convertFromImage">convertFromImage</a>() documentation for a description of the
<em>conversion_flags</em> argument.
<p> The <ahref="qimageio.html">TQImageIO</a> documentation lists the supported image formats and
<p> The <ahref="tqimageio.html">TQImageIO</a> documentation lists the supported image formats and
explains how to add extra formats.
<p><p>See also <ahref="#load">load</a>(), <ahref="#save">save</a>(), <ahref="#imageFormat">imageFormat</a>(), <ahref="ntqimage.html#loadFromData">TQImage::loadFromData</a>(), and <ahref="qimageio.html">TQImageIO</a>.
<p><p>See also <ahref="#load">load</a>(), <ahref="#save">save</a>(), <ahref="#imageFormat">imageFormat</a>(), <ahref="tqimage.html#loadFromData">TQImage::loadFromData</a>(), and <ahref="tqimageio.html">TQImageIO</a>.
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
<p> Converts the image <em>image</em> to a pixmap that is assigned to this
@ -666,7 +666,7 @@ be in the range [0,100] or -1. Specify 0 to obtain small
compressed files, 100 for large uncompressed files, and -1 to use
the default settings. Returns TRUE if successful; otherwise
returns FALSE.
<p><p>See also <ahref="#load">load</a>(), <ahref="#loadFromData">loadFromData</a>(), <ahref="#imageFormat">imageFormat</a>(), <ahref="ntqimage.html#save">TQImage::save</a>(), and <ahref="qimageio.html">TQImageIO</a>.
<p><p>See also <ahref="#load">load</a>(), <ahref="#loadFromData">loadFromData</a>(), <ahref="#imageFormat">imageFormat</a>(), <ahref="tqimage.html#save">TQImage::save</a>(), and <ahref="tqimageio.html">TQImageIO</a>.
@ -777,9 +777,9 @@ The original pixmap is not changed.
for unwanted translation, i.e. <ahref="#xForm">xForm</a>() returns the smallest image
that contains all the transformed points of the original image.
<p> This function is slow because it involves transformation to a
<ahref="ntqimage.html">TQImage</a>, non-trivial computations and a transformation back to a
<ahref="tqimage.html">TQImage</a>, non-trivial computations and a transformation back to a
TQPixmap.
<p><p>See also <ahref="#trueMatrix">trueMatrix</a>(), <ahref="ntqwmatrix.html">TQWMatrix</a>, <ahref="ntqpainter.html#setWorldMatrix">TQPainter::setWorldMatrix</a>(), and <ahref="ntqimage.html#xForm">TQImage::xForm</a>().
<p><p>See also <ahref="#trueMatrix">trueMatrix</a>(), <ahref="ntqwmatrix.html">TQWMatrix</a>, <ahref="ntqpainter.html#setWorldMatrix">TQPainter::setWorldMatrix</a>(), and <ahref="tqimage.html#xForm">TQImage::xForm</a>().
<p>Examples: <ahref="desktop-example.html#x1747">desktop/desktop.cpp</a>, <ahref="fileiconview-example.html#x863">fileiconview/qfileiconview.cpp</a>, <ahref="movies-example.html#x514">movies/main.cpp</a>, and <ahref="qmag-example.html#x1787">qmag/qmag.cpp</a>.
@ -104,7 +104,7 @@ width of two sizes using <a href="#boundedTo">boundedTo</a>().
inside a given rectangle, preserving the aspect ratio.
<li><tt>TQSize::ScaleMax</tt> - The size is scaled to a rectangle as small as possible
outside a given rectangle, preserving the aspect ratio.
</ul><p><p>See also <ahref="#scale">TQSize::scale</a>(), <ahref="ntqimage.html#scale">TQImage::scale</a>(), and <ahref="ntqimage.html#smoothScale">TQImage::smoothScale</a>().
</ul><p><p>See also <ahref="#scale">TQSize::scale</a>(), <ahref="tqimage.html#scale">TQImage::scale</a>(), and <ahref="tqimage.html#smoothScale">TQImage::smoothScale</a>().
@ -193,7 +193,7 @@ type that can be generated from the stored type, toT() copies and
converts and leaves the object itself unchanged. If you ask for a
type that cannot be generated from the stored type, the result
depends on the type (see the function documentation for details).
<p> Note that three data types supported by TQVariant are <ahref="shclass.html#explicitly-shared">explicitly shared</a>, namely <ahref="ntqimage.html">TQImage</a>, <ahref="ntqpointarray.html">TQPointArray</a>, and <ahref="ntqcstring.html">TQCString</a>, and in these
<p> Note that three data types supported by TQVariant are <ahref="shclass.html#explicitly-shared">explicitly shared</a>, namely <ahref="tqimage.html">TQImage</a>, <ahref="ntqpointarray.html">TQPointArray</a>, and <ahref="ntqcstring.html">TQCString</a>, and in these
cases the toT() methods return a <ahref="shclass.html#shallow-copy">shallow copy</a>. In almost all cases
you must make a <ahref="shclass.html#deep-copy">deep copy</a> of the returned values before modifying
them.
@ -258,7 +258,7 @@ contain.
<li><tt>TQVariant::Double</tt> - a double
<li><tt>TQVariant::Font</tt> - a <ahref="ntqfont.html">TQFont</a>
<li><tt>TQVariant::IconSet</tt> - a <ahref="ntqiconset.html">TQIconSet</a>
<li><tt>TQVariant::Image</tt> - a <ahref="ntqimage.html">TQImage</a>
<li><tt>TQVariant::Image</tt> - a <ahref="tqimage.html">TQImage</a>
<li><tt>TQVariant::Int</tt> - an int
<li><tt>TQVariant::KeySequence</tt> - a <ahref="ntqkeysequence.html">TQKeySequence</a>
<li><tt>TQVariant::List</tt> - a <ahref="tqvaluelist.html">TQValueList</a><TQVariant>
@ -306,7 +306,7 @@ Constructs a new variant with a size policy value, <em>val</em>.
Constructs a copy of the variant, <em>p</em>, passed as the argument to
this constructor. Usually this is a <ahref="shclass.html#deep-copy">deep copy</a>, but a <ahref="shclass.html#shallow-copy">shallow copy</a>
is made if the stored data type is <ahref="shclass.html#explicitly-shared">explicitly shared</a>, as e.g.
Constructs a new variant with an image value, <em>val</em>.
<p> Because <ahref="ntqimage.html">TQImage</a> is <ahref="shclass.html#explicitly-shared">explicitly shared</a>, you may need to pass a <ahref="shclass.html#deep-copy">deep copy</a> to the variant using <ahref="ntqimage.html#copy">TQImage::copy</a>(), e.g. if you intend
<p> Because <ahref="tqimage.html">TQImage</a> is <ahref="shclass.html#explicitly-shared">explicitly shared</a>, you may need to pass a <ahref="shclass.html#deep-copy">deep copy</a> to the variant using <ahref="tqimage.html#copy">TQImage::copy</a>(), e.g. if you intend
Assigns the value of the variant <em>variant</em> to this variant.
<p> This is a <ahref="shclass.html#deep-copy">deep copy</a> of the variant, but note that if the variant
holds an <ahref="shclass.html#explicitly-shared">explicitly shared</a> type such as <ahref="ntqimage.html">TQImage</a>, a <ahref="shclass.html#shallow-copy">shallow copy</a> is
holds an <ahref="shclass.html#explicitly-shared">explicitly shared</a> type such as <ahref="tqimage.html">TQImage</a>, a <ahref="shclass.html#shallow-copy">shallow copy</a> is
Converts the image <em>img</em> into the unnamed format expected by
OpenGL functions such as glTexImage2D(). The returned image is not
usable as a <ahref="ntqimage.html">TQImage</a>, but <ahref="ntqimage.html#width">TQImage::width</a>(), <ahref="ntqimage.html#height">TQImage::height</a>() and
<ahref="ntqimage.html#bits">TQImage::bits</a>() may be used with OpenGL. The following few lines
usable as a <ahref="tqimage.html">TQImage</a>, but <ahref="tqimage.html#width">TQImage::width</a>(), <ahref="tqimage.html#height">TQImage::height</a>() and
<ahref="tqimage.html#bits">TQImage::bits</a>() may be used with OpenGL. The following few lines
are from the texture example. Most of the code is irrelevant, so
<tdalign="right"valign="center"><imgsrc="logo32.png"align="right"width="64"height="32"border="0"></td></tr></table><h1align=center>Complete Member List for TQImage</h1>
<p>This is the complete list of member functions for
<ahref="ntqimage.html">TQImage</a>, including inherited members.
@ -90,7 +90,7 @@ called first (assuming the <tt><EMBED></tt> tag has a SRC parameter).
first call to newWindow(). This includes any use of <ahref="ntqpaintdevice.html">TQPaintDevice</a>
(i.e. <ahref="ntqpixmap.html">TQPixmap</a>, <ahref="tqwidget.html">TQWidget</a>, and all subclasses), <ahref="ntqapplication.html">TQApplication</a>, anything
related to <ahref="ntqpainter.html">TQPainter</a> (<ahref="ntqbrush.html">TQBrush</a>, etc.), fonts, <ahref="ntqmovie.html">TQMovie</a>, <ahref="ntqtooltip.html">TQToolTip</a>, etc.
Useful classes which specifically <em>can</em> be used are <ahref="ntqimage.html">TQImage</a>,
Useful classes which specifically <em>can</em> be used are <ahref="tqimage.html">TQImage</a>,
<ahref="ntqfile.html">TQFile</a>, and <ahref="ntqbuffer.html">TQBuffer</a>.
<p> This restriction can easily be accommodated by structuring your
plugin so that the task of the TQNPInstance is to gather data,
<p> These classes have a detach() function that can be called if you want
your object to get a private copy of the shared data. They also have a
copy() function that returns a deep copy with a reference count of 1.
<p> The same is true for <ahref="ntqimage.html">TQImage</a>, which does not inherit TQMemArray. <ahref="ntqmovie.html">TQMovie</a> is also explicitly shared, but it does not support detach() or
<p> The same is true for <ahref="tqimage.html">TQImage</a>, which does not inherit TQMemArray. <ahref="ntqmovie.html">TQMovie</a> is also explicitly shared, but it does not support detach() or
copy().
<p><h2> Implicitly Shared Classes
</h2>
@ -214,7 +214,7 @@ functions by value without concern for the copying overhead.
<p> In this example, <tt>p1</tt> and <tt>p2</tt> share data until <ahref="ntqpainter.html#begin">TQPainter::begin</a>() is
called for <tt>p2</tt>, because painting a pixmap will modify it. The same
also happens if anything is <ahref="ntqimage.html#bitBlt">bitBlt()</a>'ed into
also happens if anything is <ahref="tqimage.html#bitBlt">bitBlt()</a>'ed into
<tt>p2</tt>.
<p><b>Warning:</b> Do not copy an implicitly shared container (<ahref="tqmap.html">TQMap</a>,
<ahref="tqvaluevector.html">TQValueVector</a>, etc.) while you are iterating over it.
saveimage = new <ahref="ntqpopupmenu.html">TQPopupMenu</a>( menubar );
savepixmap = new <ahref="ntqpopupmenu.html">TQPopupMenu</a>( menubar );
<aname="x1344"></a><aname="x1343"></a> for (const char* f = fmt.<ahref="tqptrlist.html#first">first</a>(); f; f = fmt.<ahref="tqptrlist.html#next">next</a>()) {
<tdalign="right"valign="center"><imgsrc="logo32.png"align="right"width="64"height="32"border="0"></td></tr></table><h1align=center>Complete Member List for TQImage</h1>
<p>This is the complete list of member functions for
<ahref="tqimage.html">TQImage</a>, including inherited members.
Converts the depth (bpp) of the image to <em>depth</em> and returns the
converted image. The original image is not changed.
@ -416,11 +416,11 @@ converted.
result (e.g. converting from 32-bit to 8-bit), use the <em>conversion_flags</em> to specify how you'd prefer this to happen.
<p><p>See also <ahref="ntqt.html#ImageConversionFlags-enum">TQt::ImageConversionFlags</a>, <ahref="#depth">depth</a>(), and <ahref="#isNull">isNull</a>().
Builds and returns a 1-bpp mask from the alpha buffer in this
image. Returns a <ahref="#isNull">null</a> image if <ahref="#setAlphaBuffer">alpha buffer mode</a> is disabled.
@ -489,7 +489,7 @@ image. Returns a <a href="#isNull">null</a> image if <a href="#setAlphaBuffer">a
convert to big-endianness using <ahref="#convertBitOrder">convertBitOrder</a>().
<p><p>See also <ahref="#createHeuristicMask">createHeuristicMask</a>(), <ahref="#hasAlphaBuffer">hasAlphaBuffer</a>(), and <ahref="#setAlphaBuffer">setAlphaBuffer</a>().
Creates and returns a 1-bpp heuristic mask for this image. It
works by selecting a color from one of the corners, then chipping
@ -557,11 +557,11 @@ you will want to use TQImage::pixel() to use a color from an
existing image or <ahref="ntqcolor.html#rgb">TQColor::rgb</a>() to use a specific color.
<p><p>See also <ahref="#invertPixels">invertPixels</a>(), <ahref="#depth">depth</a>(), <ahref="#hasAlphaBuffer">hasAlphaBuffer</a>(), and <ahref="#create">create</a>().
</h3> Convenience function. Gets the data associated with the absolute
name <em>abs_name</em> from the default mime source factory and decodes it
to an image.
<p><p>See also <ahref="qmimesourcefactory.html">TQMimeSourceFactory</a>, <ahref="#fromMimeSource">TQImage::fromMimeSource</a>(), and <ahref="qimagedrag.html#decode">TQImageDrag::decode</a>().
<p><p>See also <ahref="qmimesourcefactory.html">TQMimeSourceFactory</a>, <ahref="#fromMimeSource">TQImage::fromMimeSource</a>(), and <ahref="tqimagedrag.html#decode">TQImageDrag::decode</a>().
Returns a string that specifies the image format of the file <em>fileName</em>, or 0 if the file cannot be read or if the format is not
recognized.
<p> The <ahref="qimageio.html">TQImageIO</a> documentation lists the guaranteed supported image
<p> The <ahref="tqimageio.html">TQImageIO</a> documentation lists the guaranteed supported image
formats, or use <ahref="#inputFormats">TQImage::inputFormats</a>() and <ahref="#outputFormats">TQImage::outputFormats</a>()
to get lists that include the installed formats.
<p><p>See also <ahref="#load">load</a>() and <ahref="#save">save</a>().
@ -601,14 +601,14 @@ over a copy, e.g.
}
</pre>
<p><p>See also <ahref="#outputFormatList">outputFormatList</a>(), <ahref="#inputFormats">inputFormats</a>(), and <ahref="qimageio.html">TQImageIO</a>.
<p><p>See also <ahref="#outputFormatList">outputFormatList</a>(), <ahref="#inputFormats">inputFormats</a>(), and <ahref="tqimageio.html">TQImageIO</a>.
Returns a list of image formats that are supported for image
input.
<p><p>See also <ahref="#outputFormats">outputFormats</a>(), <ahref="#inputFormatList">inputFormatList</a>(), and <ahref="qimageio.html">TQImageIO</a>.
<p><p>See also <ahref="#outputFormats">outputFormats</a>(), <ahref="#inputFormatList">inputFormatList</a>(), and <ahref="tqimageio.html">TQImageIO</a>.
using the specified format. If <em>format</em> is not specified (which
is the default), the loader reads a few bytes from the header to
guess the file format.
<p> The <ahref="qimageio.html">TQImageIO</a> documentation lists the supported image formats and
<p> The <ahref="tqimageio.html">TQImageIO</a> documentation lists the supported image formats and
explains how to add extra formats.
<p><p>See also <ahref="#loadFromData">loadFromData</a>(), <ahref="#save">save</a>(), <ahref="#imageFormat">imageFormat</a>(), <ahref="ntqpixmap.html#load">TQPixmap::load</a>(), and <ahref="qimageio.html">TQImageIO</a>.
<p><p>See also <ahref="#loadFromData">loadFromData</a>(), <ahref="#save">save</a>(), <ahref="#imageFormat">imageFormat</a>(), <ahref="ntqpixmap.html#load">TQPixmap::load</a>(), and <ahref="tqimageio.html">TQImageIO</a>.
using the specified format. If <em>format</em> is not specified (which
is the default), the loader reads a few bytes from the header to
guess the file format.
<p> The <ahref="qimageio.html">TQImageIO</a> documentation lists the supported image formats and
<p> The <ahref="tqimageio.html">TQImageIO</a> documentation lists the supported image formats and
explains how to add extra formats.
<p><p>See also <ahref="#load">load</a>(), <ahref="#save">save</a>(), <ahref="#imageFormat">imageFormat</a>(), <ahref="ntqpixmap.html#loadFromData">TQPixmap::loadFromData</a>(), and <ahref="qimageio.html">TQImageIO</a>.
<p><p>See also <ahref="#load">load</a>(), <ahref="#save">save</a>(), <ahref="#imageFormat">imageFormat</a>(), <ahref="ntqpixmap.html#loadFromData">TQPixmap::loadFromData</a>(), and <ahref="tqimageio.html">TQImageIO</a>.
Returns TRUE if this image and image <em>i</em> have the same contents;
otherwise returns FALSE. The comparison can be slow, unless there
@ -754,13 +754,13 @@ over a copy, e.g.
}
</pre>
<p><p>See also <ahref="#inputFormatList">inputFormatList</a>(), <ahref="#outputFormats">outputFormats</a>(), and <ahref="qimageio.html">TQImageIO</a>.
<p><p>See also <ahref="#inputFormatList">inputFormatList</a>(), <ahref="#outputFormats">outputFormats</a>(), and <ahref="tqimageio.html">TQImageIO</a>.
Returns a list of image formats that are supported for image
output.
<p><p>See also <ahref="#inputFormats">inputFormats</a>(), <ahref="#outputFormatList">outputFormatList</a>(), and <ahref="qimageio.html">TQImageIO</a>.
<p><p>See also <ahref="#inputFormats">inputFormats</a>(), <ahref="#outputFormatList">outputFormatList</a>(), and <ahref="tqimageio.html">TQImageIO</a>.
@ -799,7 +799,7 @@ compressed files, 100 for large uncompressed files, and -1 (the
default) to use the default settings.
<p> Returns TRUE if the image was successfully saved; otherwise
returns FALSE.
<p><p>See also <ahref="#load">load</a>(), <ahref="#loadFromData">loadFromData</a>(), <ahref="#imageFormat">imageFormat</a>(), <ahref="ntqpixmap.html#save">TQPixmap::save</a>(), and <ahref="qimageio.html">TQImageIO</a>.
<p><p>See also <ahref="#load">load</a>(), <ahref="#loadFromData">loadFromData</a>(), <ahref="#imageFormat">imageFormat</a>(), <ahref="ntqpixmap.html#save">TQPixmap::save</a>(), and <ahref="tqimageio.html">TQImageIO</a>.
Returns a copy of the image scaled to a rectangle of width <em>w</em>
and height <em>h</em> according to the ScaleMode <em>mode</em>.
@ -836,12 +836,12 @@ function returns a <a href="#isNull">null</a> image.
quality, use <ahref="#smoothScale">smoothScale</a>() instead.
<p><p>See also <ahref="#scaleWidth">scaleWidth</a>(), <ahref="#scaleHeight">scaleHeight</a>(), <ahref="#smoothScale">smoothScale</a>(), and <ahref="#xForm">xForm</a>().
Returns a scaled copy of the image. The returned image has a
height of <em>h</em> pixels. This function automatically calculates the
@ -851,7 +851,7 @@ returned.
<p><p>See also <ahref="#scale">scale</a>(), <ahref="#scaleWidth">scaleWidth</a>(), <ahref="#smoothScale">smoothScale</a>(), and <ahref="#xForm">xForm</a>().
Returns a smoothly scaled copy of the image. The returned image
has a size of width <em>w</em> by height <em>h</em> pixels if <em>mode</em> is <ahref="#ScaleMode-enum">ScaleFree</a>. The modes <ahref="#ScaleMode-enum">ScaleMin</a> and <ahref="#ScaleMode-enum">ScaleMax</a> may be used to
@ -970,24 +970,24 @@ notice appear in supporting documentation. This software is
provided "as is" without express or implied warranty.
<p><p>See also <ahref="#scale">scale</a>() and <ahref="#mirror">mirror</a>().
@ -1075,7 +1075,7 @@ that contains all the transformed points of the original image.
<p><p>See also <ahref="#scale">scale</a>(), <ahref="ntqpixmap.html#xForm">TQPixmap::xForm</a>(), <ahref="ntqpixmap.html#trueMatrix">TQPixmap::trueMatrix</a>(), and <ahref="ntqwmatrix.html">TQWMatrix</a>.
<tdalign="right"valign="center"><imgsrc="logo32.png"align="right"width="64"height="32"border="0"></td></tr></table><h1align=center>Complete Member List for TQImageConsumer</h1>
<p>This is the complete list of member functions for
<ahref="qimageconsumer.html">TQImageConsumer</a>, including inherited members.
<ahref="tqimageconsumer.html">TQImageConsumer</a>, including inherited members.
<tdalign="right"valign="center"><imgsrc="logo32.png"align="right"width="64"height="32"border="0"></td></tr></table><h1align=center>Complete Member List for TQImageDecoder</h1>
<p>This is the complete list of member functions for
<ahref="qimagedecoder.html">TQImageDecoder</a>, including inherited members.
<ahref="tqimagedecoder.html">TQImageDecoder</a>, including inherited members.
<p> TQImageFormatType and TQImageFormat are the classes that you might
need to implement support for additional image formats.
@ -84,10 +84,10 @@ We recommend using the MNG or PNG format.
<p>See also <ahref="graphics.html">Graphics Classes</a>, <ahref="images.html">Image Processing Classes</a>, and <ahref="multimedia.html">Multimedia Classes</a>.
<tdalign="right"valign="center"><imgsrc="logo32.png"align="right"width="64"height="32"border="0"></td></tr></table><h1align=center>Complete Member List for TQImageDrag</h1>
<p>This is the complete list of member functions for
<ahref="qimagedrag.html">TQImageDrag</a>, including inherited members.
<ahref="tqimagedrag.html">TQImageDrag</a>, including inherited members.
<tdalign="right"valign="center"><imgsrc="logo32.png"align="right"width="64"height="32"border="0"></td></tr></table><h1align=center>Complete Member List for TQImageFormat</h1>
<p>This is the complete list of member functions for
<ahref="qimageformat.html">TQImageFormat</a>, including inherited members.
<ahref="tqimageformat.html">TQImageFormat</a>, including inherited members.
@ -46,11 +46,11 @@ The TQImageFormat class is an incremental image decoder for a specific image for
<p>
<p> By making a derived class of <ahref="qimageformattype.html">TQImageFormatType</a>, which in turn
<p> By making a derived class of <ahref="tqimageformattype.html">TQImageFormatType</a>, which in turn
creates objects that are a subclass of TQImageFormat, you can add
support for more incremental image formats, allowing such formats
to be sources for a <ahref="ntqmovie.html">TQMovie</a> or for the first frame of the image
stream to be loaded as a <ahref="ntqimage.html">TQImage</a> or <ahref="ntqpixmap.html">TQPixmap</a>.
stream to be loaded as a <ahref="tqimage.html">TQImage</a> or <ahref="ntqpixmap.html">TQPixmap</a>.
<p> Your new subclass must reimplement the <ahref="#decode">decode</a>() function in order
to process your new format.
<p> New TQImageFormat objects are generated by new TQImageFormatType
@ -58,7 +58,7 @@ factories.
<p>See also <ahref="graphics.html">Graphics Classes</a>, <ahref="images.html">Image Processing Classes</a>, and <ahref="multimedia.html">Multimedia Classes</a>.
<tdalign="right"valign="center"><imgsrc="logo32.png"align="right"width="64"height="32"border="0"></td></tr></table><h1align=center>Complete Member List for TQImageFormatPlugin</h1>
<p>This is the complete list of member functions for
<ahref="ntqimageformatplugin.html">TQImageFormatPlugin</a>, including inherited members.
<ahref="tqimageformatplugin.html">TQImageFormatPlugin</a>, including inherited members.
<tdalign="right"valign="center"><imgsrc="logo32.png"align="right"width="64"height="32"border="0"></td></tr></table><h1align=center>Complete Member List for TQImageFormatType</h1>
<p>This is the complete list of member functions for
<ahref="qimageformattype.html">TQImageFormatType</a>, including inherited members.
<ahref="tqimageformattype.html">TQImageFormatType</a>, including inherited members.
<tdalign="right"valign="center"><imgsrc="logo32.png"align="right"width="64"height="32"border="0"></td></tr></table><h1align=center>Complete Member List for TQImageIO</h1>
<p>This is the complete list of member functions for
<ahref="qimageio.html">TQImageIO</a>, including inherited members.
<ahref="tqimageio.html">TQImageIO</a>, including inherited members.
@ -87,7 +87,7 @@ XBM, XPM and PNM. It may also support JPEG, MNG and GIF, if
specially configured during compilation. The different PNM formats
are: PBM (P1 or P4), PGM (P2 or P5), and PPM (P3 or P6).
<p> You don't normally need to use this class; <ahref="ntqpixmap.html#load">TQPixmap::load</a>(),
<ahref="ntqpixmap.html#save">TQPixmap::save</a>(), and <ahref="ntqimage.html">TQImage</a> contain sufficient functionality.
<ahref="ntqpixmap.html#save">TQPixmap::save</a>(), and <ahref="tqimage.html">TQImage</a> contain sufficient functionality.
<p> For image files that contain sequences of images, only the first
is read. See <ahref="ntqmovie.html">TQMovie</a> for loading multiple images.
<p> PBM, PGM, and PPM format <em>output</em> is always in the more condensed
@ -100,7 +100,7 @@ license the technology. Such countries include Canada, Japan, the
USA, France, Germany, Italy and the UK.
<p> GIF support may be removed completely in a future version of TQt.
We recommend using the PNG format.
<p><p>See also <ahref="ntqimage.html">TQImage</a>, <ahref="ntqpixmap.html">TQPixmap</a>, <ahref="ntqfile.html">TQFile</a>, <ahref="ntqmovie.html">TQMovie</a>, <ahref="graphics.html">Graphics Classes</a>, <ahref="images.html">Image Processing Classes</a>, and <ahref="io.html">Input/Output and Networking</a>.
<p><p>See also <ahref="tqimage.html">TQImage</a>, <ahref="ntqpixmap.html">TQPixmap</a>, <ahref="ntqfile.html">TQFile</a>, <ahref="ntqmovie.html">TQMovie</a>, <ahref="graphics.html">Graphics Classes</a>, <ahref="images.html">Image Processing Classes</a>, and <ahref="io.html">Input/Output and Networking</a>.
@ -923,7 +923,7 @@ This event handler is called when a drag is in progress and the
mouse enters this widget.
<p> See the <ahref="dnd.html">Drag-and-drop documentation</a> for an
overview of how to provide drag-and-drop in your application.
<p><p>See also <ahref="qtextdrag.html">TQTextDrag</a>, <ahref="qimagedrag.html">TQImageDrag</a>, and <ahref="qdragenterevent.html">TQDragEnterEvent</a>.
<p><p>See also <ahref="qtextdrag.html">TQTextDrag</a>, <ahref="tqimagedrag.html">TQImageDrag</a>, and <ahref="qdragenterevent.html">TQDragEnterEvent</a>.
@ -932,7 +932,7 @@ This event handler is called when a drag is in progress and the
mouse leaves this widget.
<p> See the <ahref="dnd.html">Drag-and-drop documentation</a> for an
overview of how to provide drag-and-drop in your application.
<p><p>See also <ahref="qtextdrag.html">TQTextDrag</a>, <ahref="qimagedrag.html">TQImageDrag</a>, and <ahref="qdragleaveevent.html">TQDragLeaveEvent</a>.
<p><p>See also <ahref="qtextdrag.html">TQTextDrag</a>, <ahref="tqimagedrag.html">TQImageDrag</a>, and <ahref="qdragleaveevent.html">TQDragLeaveEvent</a>.
@ -940,7 +940,7 @@ This event handler is called when a drag is in progress and the
mouse enters this widget, and whenever it moves within the widget.
<p> See the <ahref="dnd.html">Drag-and-drop documentation</a> for an
overview of how to provide drag-and-drop in your application.
<p><p>See also <ahref="qtextdrag.html">TQTextDrag</a>, <ahref="qimagedrag.html">TQImageDrag</a>, and <ahref="qdragmoveevent.html">TQDragMoveEvent</a>.
<p><p>See also <ahref="qtextdrag.html">TQTextDrag</a>, <ahref="tqimagedrag.html">TQImageDrag</a>, and <ahref="qdragmoveevent.html">TQDragMoveEvent</a>.
@ -44,7 +44,7 @@ If you want to show a single pixmap on a TQCanvas use a TQCanvasSprite with just
.PP
When pixmaps are inserted into a TQCanvasPixmapArray they are held as TQCanvasPixmaps. TQCanvasSprites are used to show pixmaps on TQCanvases and hold their pixmaps in a TQCanvasPixmapArray. If you retrieve a frame (pixmap) from a TQCanvasSprite it will be returned as a TQCanvasPixmap.
.PP
The pixmap is a QPixmap and can only be set in the constructor. There are three different constructors, one taking a QPixmap, one a TQImage and one a file name that refers to a file in any supported file format (see QImageIO).
The pixmap is a QPixmap and can only be set in the constructor. There are three different constructors, one taking a QPixmap, one a TQImage and one a file name that refers to a file in any supported file format (see TQImageIO).
.PP
TQCanvasPixmap can have a hotspot which is defined in terms of an (x, y) offset. When you create a TQCanvasPixmap from a PNG file or from a TQImage that has a TQImage::offset(), the offset() is initialized appropriately, otherwise the constructor leaves it at (0, 0). You can set it later using setOffset(). When the TQCanvasPixmap is used in a TQCanvasSprite, the offset position is the point at TQCanvasItem::x() and TQCanvasItem::y(), not the top-left corner of the pixmap.
QClipboard features some convenience functions to access common data types: setText() allows the exchange of Unicode text and setPixmap() and setImage() allows the exchange of QPixmaps and QImages between applications. The setData() function is the ultimate in flexibility: it allows you to add any QMimeSource into the clipboard. There are corresponding getters for each of these, e.g. text(), image() and pixmap().
QClipboard features some convenience functions to access common data types: setText() allows the exchange of Unicode text and setPixmap() and setImage() allows the exchange of QPixmaps and TQImages between applications. The setData() function is the ultimate in flexibility: it allows you to add any QMimeSource into the clipboard. There are corresponding getters for each of these, e.g. text(), image() and pixmap().
@ -429,7 +429,7 @@ The simple approach to dragging items out of the icon view is to subclass QIconV
.br
.fi
.PP
In this example we create a QTextDrag object, (derived from QDragObject), containing the item's label and return it as the drag object. We could just as easily have created a QImageDrag from the item's pixmap and returned that instead.
In this example we create a QTextDrag object, (derived from QDragObject), containing the item's label and return it as the drag object. We could just as easily have created a TQImageDrag from the item's pixmap and returned that instead.
.PP
QIconViews and their QIconViewItems can also be the targets of drag and drops. To make the QIconView itself able to accept drops connect to the dropped() signal. When a drop occurs this signal will be emitted with a QDragEvent and a TQValueList of QIconDragItems. To make a QIconViewItem into a drop target subclass QIconViewItem and reimplement QIconViewItem::acceptDrop() and QIconViewItem::dropped().
The functions scale() and smoothScale() use different modes for scaling the image. The purpose of these modes is to retain the ratio of the image if this is required.
.PP
@ -398,11 +398,11 @@ The functions scale() and smoothScale() use different modes for scaling the imag
.PP
</center>
.TP
\fCQImage::ScaleFree\fR - The image is scaled freely: the resulting image fits exactly into the specified size; the ratio will not necessarily be preserved.
\fCTQImage::ScaleFree\fR - The image is scaled freely: the resulting image fits exactly into the specified size; the ratio will not necessarily be preserved.
.TP
\fCQImage::ScaleMin\fR - The ratio of the image is preserved and the resulting image is guaranteed to fit into the specified size (it is as large as possible within these constraints) - the image might be smaller than the requested size.
\fCTQImage::ScaleMin\fR - The ratio of the image is preserved and the resulting image is guaranteed to fit into the specified size (it is as large as possible within these constraints) - the image might be smaller than the requested size.
.TP
\fCQImage::ScaleMax\fR - The ratio of the image is preserved and the resulting image fills the whole specified rectangle (it is as small as possible within these constraints) - the image might be larger than the requested size.
\fCTQImage::ScaleMax\fR - The ratio of the image is preserved and the resulting image fills the whole specified rectangle (it is as small as possible within these constraints) - the image might be larger than the requested size.
.SH MEMBER FUNCTION DOCUMENTATION
.SH "TQImage::TQImage ()"
Constructs a null image.
@ -427,9 +427,9 @@ If \fIformat\fR is specified, the loader attempts to read the image using the sp
.PP
If the loading of the image failed, this object is a null image.
.PP
The QImageIO documentation lists the supported image formats and explains how to add extra formats.
The TQImageIO documentation lists the supported image formats and explains how to add extra formats.
Returns a string that specifies the image format of the file \fIfileName\fR, or 0 if the file cannot be read or if the format is not recognized.
.PP
The QImageIO documentation lists the guaranteed supported image formats, or use TQImage::inputFormats() and TQImage::outputFormats() to get lists that include the installed formats.
The TQImageIO documentation lists the guaranteed supported image formats, or use TQImage::inputFormats() and TQImage::outputFormats() to get lists that include the installed formats.
@ -708,17 +708,17 @@ Loads an image from the file \fIfileName\fR. Returns TRUE if the image was succe
.PP
If \fIformat\fR is specified, the loader attempts to read the image using the specified format. If \fIformat\fR is not specified (which is the default), the loader reads a few bytes from the header to guess the file format.
.PP
The QImageIO documentation lists the supported image formats and explains how to add extra formats.
The TQImageIO documentation lists the supported image formats and explains how to add extra formats.
.PP
See also loadFromData(), save(), imageFormat(), QPixmap::load(), and QImageIO.
See also loadFromData(), save(), imageFormat(), QPixmap::load(), and TQImageIO.
Loads an image from the first \fIlen\fR bytes of binary data in \fIbuf\fR. Returns TRUE if the image was successfully loaded; otherwise returns FALSE.
.PP
If \fIformat\fR is specified, the loader attempts to read the image using the specified format. If \fIformat\fR is not specified (which is the default), the loader reads a few bytes from the header to guess the file format.
.PP
The QImageIO documentation lists the supported image formats and explains how to add extra formats.
The TQImageIO documentation lists the supported image formats and explains how to add extra formats.
.PP
See also load(), save(), imageFormat(), QPixmap::loadFromData(), and QImageIO.
See also load(), save(), imageFormat(), QPixmap::loadFromData(), and TQImageIO.
.\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the
.\" license file included in the distribution for a complete license
.\" statement.
@ -7,7 +7,7 @@
.ad l
.nh
.SH NAME
QImageConsumer \- Abstraction used by QImageDecoder
TQImageConsumer \- Abstraction used by TQImageDecoder
.SH SYNOPSIS
\fC#include <ntqasyncimageio.h>\fR
.PP
@ -36,37 +36,37 @@ QImageConsumer \- Abstraction used by QImageDecoder
.br
.in -1c
.SH DESCRIPTION
The QImageConsumer class is an abstraction used by QImageDecoder.
The TQImageConsumer class is an abstraction used by TQImageDecoder.
.PP
The QMovie class, or QLabel::setMovie(), are easy to use and for most situations do what you want with regards animated images.
.PP
A QImageConsumer consumes information about changes to the TQImage maintained by a QImageDecoder. Think of the TQImage as the model or source of the image data, with the QImageConsumer as a view of that data and the QImageDecoder being the controller that orchestrates the relationship between the model and the view.
A TQImageConsumer consumes information about changes to the TQImage maintained by a TQImageDecoder. Think of the TQImage as the model or source of the image data, with the TQImageConsumer as a view of that data and the TQImageDecoder being the controller that orchestrates the relationship between the model and the view.
.PP
You'd use the QImageConsumer class, for example, if you were implementing a web browser with your own image loaders.
You'd use the TQImageConsumer class, for example, if you were implementing a web browser with your own image loaders.
.PP
See also QImageDecoder, Graphics Classes, Image Processing Classes, and Multimedia Classes.
See also TQImageDecoder, Graphics Classes, Image Processing Classes, and Multimedia Classes.
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
.PP
One of the two frameDone() functions will be called when a frame of an animated image has ended and been revealed as changed().
.PP
When this function is called, the area \fIrect\fR in the current image should be moved by \fIoffset\fR and displayed.
.PP
The decoder will not make any further changes to the image until the next call to QImageFormat::decode().
.SH "void QImageConsumer::setFramePeriod ( int milliseconds )\fC [pure virtual]\fR"
The decoder will not make any further changes to the image until the next call to TQImageFormat::decode().
.SH "void TQImageConsumer::setFramePeriod ( int milliseconds )\fC [pure virtual]\fR"
Notes that the frame about to be decoded should not be displayed until the given number of \fImilliseconds\fR after the time that this function is called. Of course, the image may not have been decoded by then, in which case the frame should not be displayed until it is complete. A value of -1 (the assumed default) indicates that the image should be displayed even while it is only partially loaded.
.SH "void QImageConsumer::setLooping ( int n )\fC [pure virtual]\fR"
.SH "void TQImageConsumer::setLooping ( int n )\fC [pure virtual]\fR"
Called to indicate that the sequence of frames in the image should be repeated \fIn\fR times, including the sequence during decoding.
.TP
0 = Forever
@ -77,13 +77,13 @@ Called to indicate that the sequence of frames in the image should be repeated \
.TP
etc.
.PP
To make the QImageDecoder do this, just delete it and pass the information to it again for decoding (setLooping() will be called again, of course, but that can be ignored), or keep copies of the changed areas at the ends of frames.
.SH "void QImageConsumer::setSize ( int, int )\fC [pure virtual]\fR"
To make the TQImageDecoder do this, just delete it and pass the information to it again for decoding (setLooping() will be called again, of course, but that can be ignored), or keep copies of the changed areas at the ends of frames.
.SH "void TQImageConsumer::setSize ( int, int )\fC [pure virtual]\fR"
This function is called as soon as the size of the image has been
determined.
.SH "SEE ALSO"
.BR http://doc.trolltech.com/qimageconsumer.html
.BR http://doc.trolltech.com/tqimageconsumer.html
.BR http://www.trolltech.com/faq/tech.html
.SH COPYRIGHT
Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the
.BI "QImageFormatType * \fBformat\fR ( const char * name )"
.BI "TQImageFormatType * \fBformat\fR ( const char * name )"
.br
.ti -1c
.BI "QStrList \fBinputFormats\fR ()"
.br
.ti -1c
.BI "void \fBregisterDecoderFactory\fR ( QImageFormatType * f )"
.BI "void \fBregisterDecoderFactory\fR ( TQImageFormatType * f )"
.br
.ti -1c
.BI "void \fBunregisterDecoderFactory\fR ( QImageFormatType * f )"
.BI "void \fBunregisterDecoderFactory\fR ( TQImageFormatType * f )"
.br
.in -1c
.SH DESCRIPTION
The QImageDecoder class is an incremental image decoder for all supported image formats.
The TQImageDecoder class is an incremental image decoder for all supported image formats.
.PP
New formats are installed by creating objects of class QImageFormatType; the QMovie class can be used for all installed incremental image formats. QImageDecoder is only useful for creating new ways of feeding data to an QImageConsumer.
New formats are installed by creating objects of class TQImageFormatType; the QMovie class can be used for all installed incremental image formats. TQImageDecoder is only useful for creating new ways of feeding data to an TQImageConsumer.
.PP
A QImageDecoder is a machine that decodes images. It takes encoded image data via its decode() method and expresses its decoding by supplying information to a QImageConsumer. It implements its decoding by using a QImageFormat created by one of the currently-existing QImageFormatType factory objects.
A TQImageDecoder is a machine that decodes images. It takes encoded image data via its decode() method and expresses its decoding by supplying information to a TQImageConsumer. It implements its decoding by using a TQImageFormat created by one of the currently-existing TQImageFormatType factory objects.
.PP
QImageFormatType and QImageFormat are the classes that you might need to implement support for additional image formats.
TQImageFormatType and TQImageFormat are the classes that you might need to implement support for additional image formats.
.PP
Qt supports GIF reading if it is configured that way during installation (see ntqgif.h). If it is, we are required to state that" The Graphics Interchange Format(c) is the Copyright property of CompuServe Incorporated. GIF(sm) is a Service Mark property of CompuServe Incorporated."
.PP
@ -61,32 +61,32 @@ GIF support may be removed completely in a future version of Qt. We recommend us
.PP
See also Graphics Classes, Image Processing Classes, and Multimedia Classes.
.SH MEMBER FUNCTION DOCUMENTATION
.SH "QImageDecoder::QImageDecoder ( QImageConsumer * c )"
Constructs a QImageDecoder that will send change information to the QImageConsumer \fIc\fR.
.SH "QImageDecoder::~QImageDecoder ()"
Destroys a QImageDecoder. The image it built is destroyed. The decoder built by the factory for the file format is destroyed. The consumer for which it decoded the image is \fInot\fR destroyed.
Call this function to decode some data into image changes. The data in \fIbuffer\fR will be decoded, sending change information to the QImageConsumer of this QImageDecoder until one of the change functions of the consumer returns FALSE. The length of the data is given in \fIlength\fR.
.SH "TQImageDecoder::TQImageDecoder ( TQImageConsumer * c )"
Constructs a TQImageDecoder that will send change information to the TQImageConsumer \fIc\fR.
.SH "TQImageDecoder::~TQImageDecoder ()"
Destroys a TQImageDecoder. The image it built is destroyed. The decoder built by the factory for the file format is destroyed. The consumer for which it decoded the image is \fInot\fR destroyed.
Call this function to decode some data into image changes. The data in \fIbuffer\fR will be decoded, sending change information to the TQImageConsumer of this TQImageDecoder until one of the change functions of the consumer returns FALSE. The length of the data is given in \fIlength\fR.
.PP
Returns the number of bytes consumed: 0 if consumption is complete, and -1 if decoding fails due to invalid data.
Returns a QImageFormatType by name. This might be used when the user needs to force data to be interpreted as being in a certain format. \fIname\fR is one of the formats listed by QImageDecoder::inputFormats(). Note that you will still need to supply decodable data to result->decoderFor() before you can begin decoding the data.
Returns a TQImageFormatType by name. This might be used when the user needs to force data to be interpreted as being in a certain format. \fIname\fR is one of the formats listed by TQImageDecoder::inputFormats(). Note that you will still need to supply decodable data to result->decoderFor() before you can begin decoding the data.
Call this function to find the name of the format of the given header. The returned string is statically allocated. The function will look at the first \fIlength\fR characters in the \fIbuffer\fR.
.\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the
.\" license file included in the distribution for a complete license
.\" statement.
@ -7,28 +7,28 @@
.ad l
.nh
.SH NAME
QImageFormat \- Incremental image decoder for a specific image format
TQImageFormat \- Incremental image decoder for a specific image format
.SH SYNOPSIS
\fC#include <ntqasyncimageio.h>\fR
.PP
.SS "Public Members"
.in +1c
.ti -1c
.BI "virtual int \fBdecode\fR ( TQImage & img, QImageConsumer * consumer, const uchar * buffer, int length ) = 0"
.BI "virtual int \fBdecode\fR ( TQImage & img, TQImageConsumer * consumer, const uchar * buffer, int length ) = 0"
.br
.in -1c
.SH DESCRIPTION
The QImageFormat class is an incremental image decoder for a specific image format.
The TQImageFormat class is an incremental image decoder for a specific image format.
.PP
By making a derived class of QImageFormatType, which in turn creates objects that are a subclass of QImageFormat, you can add support for more incremental image formats, allowing such formats to be sources for a QMovie or for the first frame of the image stream to be loaded as a TQImage or QPixmap.
By making a derived class of TQImageFormatType, which in turn creates objects that are a subclass of TQImageFormat, you can add support for more incremental image formats, allowing such formats to be sources for a QMovie or for the first frame of the image stream to be loaded as a TQImage or QPixmap.
.PP
Your new subclass must reimplement the decode() function in order to process your new format.
.PP
New QImageFormat objects are generated by new QImageFormatType factories.
New TQImageFormat objects are generated by new TQImageFormatType factories.
.PP
See also Graphics Classes, Image Processing Classes, and Multimedia Classes.
It should decode some or all of the bytes from \fIbuffer\fR into \fIimg\fR, calling the methods of \fIconsumer\fR as the decoding proceeds to inform that consumer of changes to the image. The length of the data is given in \fIlength\fR. The consumer may be 0, in which case the function should just process the data into \fIimg\fR without telling any consumer about the changes. Note that the decoder must store enough state to be able to continue in subsequent calls to this method - this is the essence of the incremental image loading.
@ -38,7 +38,7 @@ The function should return without processing all the data if it reaches the end
The function must return the number of bytes it has processed.
.SH "SEE ALSO"
.BR http://doc.trolltech.com/qimageformat.html
.BR http://doc.trolltech.com/tqimageformat.html
.BR http://www.trolltech.com/faq/tech.html
.SH COPYRIGHT
Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the
@ -26,34 +26,34 @@ QImageFormatType \- Factory that makes QImageFormat objects
.SS "Protected Members"
.in +1c
.ti -1c
.BI "\fBQImageFormatType\fR ()"
.BI "\fBTQImageFormatType\fR ()"
.br
.in -1c
.SH DESCRIPTION
The QImageFormatType class is a factory that makes QImageFormat objects.
The TQImageFormatType class is a factory that makes TQImageFormat objects.
.PP
Whereas the QImageIO class allows for \fIcomplete\fR loading of images, QImageFormatType allows for \fIincremental\fR loading of images.
Whereas the TQImageIO class allows for \fIcomplete\fR loading of images, TQImageFormatType allows for \fIincremental\fR loading of images.
.PP
New image file formats are installed by creating objects of derived classes of QImageFormatType. They must implement decoderFor() and formatName().
New image file formats are installed by creating objects of derived classes of TQImageFormatType. They must implement decoderFor() and formatName().
.PP
QImageFormatType is a very simple class. Its only task is to recognize image data in some format and make a new object, subclassed from QImageFormat, which can decode that format.
TQImageFormatType is a very simple class. Its only task is to recognize image data in some format and make a new object, subclassed from TQImageFormat, which can decode that format.
.PP
The factories for formats built into TQt are automatically defined before any other factory is initialized. If two factories would recognize an image format, the factory created last will override the earlier one; you can thus override current and future built-in formats.
.PP
See also Graphics Classes, Image Processing Classes, and Multimedia Classes.
Returns a decoder for decoding an image that starts with the bytes in \fIbuffer\fR. The length of the data is given in \fIlength\fR. This function should only return a decoder if it is certain that the decoder applies to data with the given header. Returns 0 if there is insufficient data in the header to make a positive identification or if the data is not recognized.
@ -105,9 +105,9 @@ QImageIO \- Parameters for loading and saving images
.br
.in -1c
.SH DESCRIPTION
The QImageIO class contains parameters for loading and saving images.
The TQImageIO class contains parameters for loading and saving images.
.PP
QImageIO contains a TQIODevice object that is used for image data I/O. The programmer can install new image file formats in addition to those that TQt provides.
TQImageIO contains a TQIODevice object that is used for image data I/O. The programmer can install new image file formats in addition to those that TQt provides.
.PP
Qt currently supports the following image file formats: PNG, BMP, XBM, XPM and PNM. It may also support JPEG, MNG and GIF, if specially configured during compilation. The different PNM formats are: PBM (P1 or P4), PGM (P2 or P5), and PPM (P3 or P6).
.PP
@ -123,28 +123,28 @@ GIF support may be removed completely in a future version of Qt. We recommend us
.PP
See also TQImage, QPixmap, QFile, QMovie, Graphics Classes, Image Processing Classes, and Input/Output and Networking.
.SH MEMBER FUNCTION DOCUMENTATION
.SH "QImageIO::QImageIO ()"
Constructs a QImageIO object with all parameters set to zero.
Defines an image I/O handler for the image format called \fIformat\fR, which is recognized using the regular expression \fIheader\fR, read using \fIreadImage\fR and written using \fIwriteImage\fR.
.PP
\fIflags\fR is a string of single-character flags for this format. The only flag defined currently is T (upper case), so the only legal value for \fIflags\fR are "T" and the empty string. The "T" flag means that the image file is a text file, and TQt should treat all newline conventions as equivalent. (XPM files and some PPM files are text files for example.)
.PP
\fIformat\fR is used to select a handler to write a TQImage; \fIheader\fR is used to select a handler to read an image file.
.PP
If \fIreadImage\fR is a null pointer, the QImageIO will not be able to read images in \fIformat\fR. If \fIwriteImage\fR is a null pointer, the QImageIO will not be able to write images in \fIformat\fR. If both are null, the QImageIO object is valid but useless.
If \fIreadImage\fR is a null pointer, the TQImageIO will not be able to read images in \fIformat\fR. If \fIwriteImage\fR is a null pointer, the TQImageIO will not be able to write images in \fIformat\fR. If both are null, the TQImageIO object is valid but useless.
.PP
Example:
.PP
.nf
.br
void readGIF( QImageIO *image )
void readGIF( TQImageIO *image )
.br
{
.br
@ -153,7 +153,7 @@ Example:
}
.br
.br
void writeGIF( QImageIO *image )
void writeGIF( TQImageIO *image )
.br
{
.br
@ -165,7 +165,7 @@ Example:
// add the GIF image handler
.br
.br
QImageIO::defineIOHandler( "GIF",
TQImageIO::defineIOHandler( "GIF",
.br
"^GIF[0-9][0-9][a-z]",
.br
@ -182,27 +182,27 @@ Before the regex test, all the 0 bytes in the file header are converted to 1 byt
The regexp is only applied on the first 14 bytes of the file.
.PP
Note that TQt assumes that there is only one handler per format; if two handlers support the same format, TQt will choose one arbitrarily. It is not possible to have one handler support reading, and another support writing.
.SH "TQString QImageIO::description () const"
.SH "TQString TQImageIO::description () const"
Returns the image description string.
.PP
See also setDescription().
.SH "TQString QImageIO::fileName () const"
.SH "TQString TQImageIO::fileName () const"
Returns the file name currently set.
.PP
See also setFileName().
.SH "const char * QImageIO::format () const"
.SH "const char * TQImageIO::format () const"
Returns the image format string or 0 if no format has been explicitly set.
.SH "float QImageIO::gamma () const"
.SH "float TQImageIO::gamma () const"
Returns the gamma value at which the image will be viewed.
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
.PP
Returns a string that specifies the image format of the image read from IO device \fId\fR, or 0 if the device cannot be read or if the format is not recognized.
@ -210,25 +210,25 @@ Returns a string that specifies the image format of the image read from IO devic
Make sure that \fId\fR is at the right position in the device (for example, at the beginning of the file).
Sets the name of the file to read or write an image from to \fIfileName\fR.
.PP
See also setIODevice().
.SH "void QImageIO::setFormat ( const char * format )"
.SH "void TQImageIO::setFormat ( const char * format )"
Sets the image format to \fIformat\fR for the image to be read or written.
.PP
It is necessary to specify a format before writing an image, but it is not necessary to specify a format before reading an image.
@ -270,13 +270,13 @@ It is necessary to specify a format before writing an image, but it is not neces
If no format has been set, TQt guesses the image format before reading it. If a format is set the image will only be read if it has that format.
.PP
See also read(), write(), and format().
.SH "void QImageIO::setGamma ( float gamma )"
.SH "void TQImageIO::setGamma ( float gamma )"
Sets the gamma value at which the image will be viewed to \fIgamma\fR. If the image format stores a gamma value for which the image is intended to be used, then this setting will be used to modify the image. Setting to 0.0 will disable gamma correction (i.e. any specification in the file will be ignored).
Sets the image's parameter string to \fIparameters\fR. This is for image handlers that require special parameters.
.PP
Although the current image formats supported by TQt ignore the parameters string, it may be used in future extensions or by contributions (for example, JPEG).
.PP
See also parameters().
.SH "void QImageIO::setQuality ( int q )"
.SH "void TQImageIO::setQuality ( int q )"
Sets the quality of the written image to \fIq\fR, related to the compression ratio.
.PP
\fIq\fR must be in the range -1..100. Specify 0 to obtain small compressed files, 100 for large uncompressed files. (-1 signifies the default compression.)
.PP
See also quality() and TQImage::save().
.SH "void QImageIO::setStatus ( int status )"
.SH "void TQImageIO::setStatus ( int status )"
Sets the image IO status to \fIstatus\fR. A non-zero value indicates an error, whereas 0 means that the IO operation was successful.
.PP
See also status().
.SH "int QImageIO::status () const"
.SH "int TQImageIO::status () const"
Returns the image's IO status. A non-zero value indicates an error, whereas 0 means that the IO operation was successful.
.PP
See also setStatus().
.SH "bool QImageIO::write ()"
.SH "bool TQImageIO::write ()"
Writes an image to an IO device and returns TRUE if the image was successfully written; otherwise returns FALSE.
.PP
Before writing an image you must set an IO device or a file name. If both an IO device and a file name have been set, the IO device will be used.
@ -319,7 +319,7 @@ Example:
.PP
.nf
.br
QImageIO iio;
TQImageIO iio;
.br
TQImage im;
.br
@ -340,7 +340,7 @@ Example:
See also setIODevice(), setFileName(), setFormat(), read(), and QPixmap::save().
.SH "SEE ALSO"
.BR http://doc.trolltech.com/qimageio.html
.BR http://doc.trolltech.com/tqimageio.html
.BR http://www.trolltech.com/faq/tech.html
.SH COPYRIGHT
Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the
Returns TRUE if the object can provide the data in format \fImimeType\fR; otherwise returns FALSE.
.PP
If you inherit from QMimeSource, for consistency reasons it is better to implement the more abstract canDecode() functions such as QTextDrag::canDecode() and QImageDrag::canDecode().
If you inherit from QMimeSource, for consistency reasons it is better to implement the more abstract canDecode() functions such as QTextDrag::canDecode() and TQImageDrag::canDecode().
@ -74,7 +74,7 @@ QMimeSourceFactory \- Extensible provider of mime-typed data
.SH DESCRIPTION
The QMimeSourceFactory class is an extensible provider of mime-typed data.
.PP
A QMimeSourceFactory provides an abstract interface to a collection of information. Each piece of information is represented by a QMimeSource object which can be examined and converted to concrete data types by functions such as QImageDrag::canDecode() and QImageDrag::decode().
A QMimeSourceFactory provides an abstract interface to a collection of information. Each piece of information is represented by a QMimeSource object which can be examined and converted to concrete data types by functions such as TQImageDrag::canDecode() and TQImageDrag::decode().
.PP
The base QMimeSourceFactory can be used in two ways: as an abstraction of a collection of files or as specifically stored data. For it to access files, call setFilePath() before accessing data. For stored data, call setData() for each item (there are also convenience functions, e.g. setText(), setImage() and setPixmap(), that simply call setData() with appropriate parameters).
.PP
@ -143,7 +143,7 @@ Returns a reference to the data associated with \fIabs_name\fR. The return value
.PP
If there is no data associated with \fIabs_name\fR in the factory's store, the factory tries to access the local filesystem. If \fIabs_name\fR isn't an absolute file name, the factory will search for it in all defined paths (see setFilePath()).
.PP
The factory understands all the image formats supported by QImageIO. Any other mime types are determined by the file name extension. The default settings are
The factory understands all the image formats supported by TQImageIO. Any other mime types are determined by the file name extension. The default settings are
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
.PP
@ -638,7 +638,7 @@ Resizes the pixmap to size \fIsize\fR.
.SH "bool QPixmap::save ( const TQString & fileName, const char * format, int quality = -1 ) const"
Saves the pixmap to the file \fIfileName\fR using the image file format \fIformat\fR and a quality factor \fIquality\fR. \fIquality\fR must be in the range [0,100] or -1. Specify 0 to obtain small compressed files, 100 for large uncompressed files, and -1 to use the default settings. Returns TRUE if successful; otherwise returns FALSE.
.PP
See also load(), loadFromData(), imageFormat(), TQImage::save(), and QImageIO.
See also load(), loadFromData(), imageFormat(), TQImage::save(), and TQImageIO.
.PP
Example: qmag/qmag.cpp.
.SH "bool QPixmap::save ( TQIODevice * device, const char * format, int quality = -1 ) const"
