Sophie

Sophie

distrib > * > 2009.0 > i586 > by-pkgid > a6711891ce757817bba854bf3f25205a > files > 2155

qtjambi-doc-4.3.3-3mdv2008.1.i586.rpm

<class name="QPictureIO" doc="/**
&lt;p&gt;&lt;b&gt;This class is obsolete.&lt;/b&gt; It is provided to keep old source code working. We strongly advise against using it in new code.&lt;/p&gt;
&lt;p&gt;The &lt;a href=&quot;QPictureIO.html#QPictureIO()&quot;&gt;&lt;tt&gt;QPictureIO&lt;/tt&gt;&lt;/a&gt; class contains parameters for loading and saving pictures.&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;QPictureIO.html#QPictureIO()&quot;&gt;&lt;tt&gt;QPictureIO&lt;/tt&gt;&lt;/a&gt; contains a &lt;a href=&quot;%2E%2E/core/QIODevice.html&quot;&gt;&lt;tt&gt;QIODevice&lt;/tt&gt;&lt;/a&gt; object that is used for picture data I/O. The programmer can install new picture file formats in addition to those that Qt provides.&lt;/p&gt;
&lt;p&gt;You don't normally need to use this class; QPicture::load(), QPicture::save().&lt;/p&gt;

@see &lt;a href=&quot;QPicture.html&quot;&gt;&lt;tt&gt;QPicture&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QPixmap.html&quot;&gt;&lt;tt&gt;QPixmap&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;%2E%2E/core/QFile.html&quot;&gt;&lt;tt&gt;QFile&lt;/tt&gt;&lt;/a&gt; */">
    <method name="public QPictureIO()" doc="/**
&lt;p&gt;Constructs a &lt;a href=&quot;QPictureIO.html#QPictureIO()&quot;&gt;&lt;tt&gt;QPictureIO&lt;/tt&gt;&lt;/a&gt; object with all parameters set to zero.&lt;/p&gt;
 */"/>
    <method name="public final java.lang.String description()" doc="/**
&lt;p&gt;Returns the picture description string.&lt;/p&gt;

@see &lt;a href=&quot;QPictureIO.html#setDescription(java.lang.String)&quot;&gt;&lt;tt&gt;setDescription&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final java.lang.String fileName()" doc="/**
&lt;p&gt;Returns the file name currently set.&lt;/p&gt;

@see &lt;a href=&quot;QPictureIO.html#setFileName(java.lang.String)&quot;&gt;&lt;tt&gt;setFileName&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final float gamma()" doc="/**
&lt;p&gt;Returns the gamma value at which the picture will be viewed.&lt;/p&gt;

@see &lt;a href=&quot;QPictureIO.html#setGamma(float)&quot;&gt;&lt;tt&gt;setGamma&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final com.trolltech.qt.core.QIODevice ioDevice()" doc="/**
&lt;p&gt;Returns the IO device currently set.&lt;/p&gt;

@see &lt;a href=&quot;QPictureIO.html#setIODevice(com.trolltech.qt.core.QIODevice)&quot;&gt;&lt;tt&gt;setIODevice&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final com.trolltech.qt.gui.QPicture picture()" doc="/**
&lt;p&gt;Returns the picture currently set.&lt;/p&gt;

@see &lt;a href=&quot;QPictureIO.html#setPicture(com.trolltech.qt.gui.QPicture)&quot;&gt;&lt;tt&gt;setPicture&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final int quality()" doc="/**
&lt;p&gt;Returns the quality of the written picture, related to the compression ratio.&lt;/p&gt;

@see &lt;a href=&quot;QPictureIO.html#setQuality(int)&quot;&gt;&lt;tt&gt;setQuality&lt;/tt&gt;&lt;/a&gt;
@see &lt;tt&gt;QPicture::save&lt;/tt&gt; */"/>
    <method name="public final boolean read()" doc="/**
&lt;p&gt;Reads an picture into memory and returns true if the picture was successfully read; otherwise returns false.&lt;/p&gt;
&lt;p&gt;Before reading an picture 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.&lt;/p&gt;
&lt;p&gt;Setting the picture file format string is optional.&lt;/p&gt;
&lt;p&gt;Note that this function does &lt;i&gt;not&lt;/i&gt; set the format&lt;/tt&gt; used to read the picture. If you need that information, use the &lt;a href=&quot;QPictureIO.html#pictureFormat(com.trolltech.qt.core.QIODevice)&quot;&gt;&lt;tt&gt;pictureFormat&lt;/tt&gt;&lt;/a&gt; static functions.&lt;/p&gt;
&lt;p&gt;Example:&lt;/p&gt;
&lt;pre&gt;            QPictureIO iio;
            QPixmap  pixmap;
            iio.setFileName(&amp;quot;vegeburger.pic&amp;quot;);
            if (iio.read()) {        &lt;span class=&quot;comment&quot;&gt;// OK&lt;/span&gt;
                QPicture picture = iio.picture();
                QPainter painter(&amp;amp;pixmap);
                painter.drawPicture(0, 0, picture);
            }&lt;/pre&gt;

@see &lt;a href=&quot;QPictureIO.html#setIODevice(com.trolltech.qt.core.QIODevice)&quot;&gt;&lt;tt&gt;setIODevice&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QPictureIO.html#setFileName(java.lang.String)&quot;&gt;&lt;tt&gt;setFileName&lt;/tt&gt;&lt;/a&gt;
@see &lt;tt&gt;setFormat&lt;/tt&gt;
@see &lt;a href=&quot;QPictureIO.html#write()&quot;&gt;&lt;tt&gt;write&lt;/tt&gt;&lt;/a&gt;
@see &lt;tt&gt;QPixmap::load&lt;/tt&gt; */"/>
    <method name="public final void setDescription(java.lang.String arg__1)" doc="/**
&lt;p&gt;Sets the picture description string for picture handlers that support picture descriptions to &lt;tt&gt;arg__1&lt;/tt&gt;.&lt;/p&gt;
&lt;p&gt;Currently, no picture format supported by Qt uses the description string.&lt;/p&gt;

@see &lt;a href=&quot;QPictureIO.html#description()&quot;&gt;&lt;tt&gt;description&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void setFileName(java.lang.String arg__1)" doc="/**
&lt;p&gt;Sets the name of the file to read or write an picture from to &lt;tt&gt;arg__1&lt;/tt&gt;.&lt;/p&gt;

@see &lt;a href=&quot;QPictureIO.html#fileName()&quot;&gt;&lt;tt&gt;fileName&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QPictureIO.html#setIODevice(com.trolltech.qt.core.QIODevice)&quot;&gt;&lt;tt&gt;setIODevice&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void setGamma(float arg__1)" doc="/**
&lt;p&gt;Sets the gamma value at which the picture will be viewed to &lt;tt&gt;arg__1&lt;/tt&gt;. If the picture format stores a gamma value for which the picture is intended to be used, then this setting will be used to modify the picture. Setting to 0.0 will disable gamma correction (i.e&amp;#x2e; any specification in the file will be ignored).&lt;/p&gt;
&lt;p&gt;The default value is 0.0&amp;#x2e;&lt;/p&gt;

@see &lt;a href=&quot;QPictureIO.html#gamma()&quot;&gt;&lt;tt&gt;gamma&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void setIODevice(com.trolltech.qt.core.QIODevice arg__1)" doc="/**
&lt;p&gt;Sets the IO device to be used for reading or writing an picture.&lt;/p&gt;
&lt;p&gt;Setting the IO device allows pictures to be read/written to any block-oriented &lt;a href=&quot;%2E%2E/core/QIODevice.html&quot;&gt;&lt;tt&gt;QIODevice&lt;/tt&gt;&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;If &lt;tt&gt;arg__1&lt;/tt&gt; is not null, this IO device will override file name settings.&lt;/p&gt;

@see &lt;a href=&quot;QPictureIO.html#setFileName(java.lang.String)&quot;&gt;&lt;tt&gt;setFileName&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void setPicture(com.trolltech.qt.gui.QPicture arg__1)" doc="/**
&lt;p&gt;Sets the picture to &lt;tt&gt;arg__1&lt;/tt&gt;.&lt;/p&gt;

@see &lt;a href=&quot;QPictureIO.html#picture()&quot;&gt;&lt;tt&gt;picture&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void setQuality(int arg__1)" doc="/**
&lt;p&gt;Sets the quality of the written picture to &lt;tt&gt;arg__1&lt;/tt&gt;, related to the compression ratio.&lt;/p&gt;
&lt;p&gt;&lt;tt&gt;arg__1&lt;/tt&gt; must be in the range -1..100. Specify 0 to obtain small compressed files, 100 for large uncompressed files. (-1 signifies the default compression.)&lt;/p&gt;

@see &lt;a href=&quot;QPictureIO.html#quality()&quot;&gt;&lt;tt&gt;quality&lt;/tt&gt;&lt;/a&gt;
@see &lt;tt&gt;QPicture::save&lt;/tt&gt; */"/>
    <method name="public final void setStatus(int arg__1)" doc="/**
&lt;p&gt;Sets the picture IO status to &lt;tt&gt;arg__1&lt;/tt&gt;. A non-zero value indicates an error, whereas 0 means that the IO operation was successful.&lt;/p&gt;

@see &lt;a href=&quot;QPictureIO.html#status()&quot;&gt;&lt;tt&gt;status&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final int status()" doc="/**
&lt;p&gt;Returns the picture's IO status. A non-zero value indicates an error, whereas 0 means that the IO operation was successful.&lt;/p&gt;

@see &lt;a href=&quot;QPictureIO.html#setStatus(int)&quot;&gt;&lt;tt&gt;setStatus&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final boolean write()" doc="/**
&lt;p&gt;Writes an picture to an IO device and returns true if the picture was successfully written; otherwise returns false.&lt;/p&gt;
&lt;p&gt;Before writing an picture 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.&lt;/p&gt;
&lt;p&gt;The picture will be written using the specified picture format.&lt;/p&gt;
&lt;p&gt;Example:&lt;/p&gt;
&lt;pre&gt;            QPictureIO iio;
            QPicture   picture;
            QPainter painter(&amp;amp;picture);
            painter.drawPixmap(0, 0, pixmap);
            iio.setPicture(picture);
            iio.setFileName(&amp;quot;vegeburger.pic&amp;quot;);
            iio.setFormat(&amp;quot;PIC&amp;quot;);
            if (iio.write())
                return true; &lt;span class=&quot;comment&quot;&gt;// returned true if written successfully&lt;/span&gt;&lt;/pre&gt;

@see &lt;a href=&quot;QPictureIO.html#setIODevice(com.trolltech.qt.core.QIODevice)&quot;&gt;&lt;tt&gt;setIODevice&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QPictureIO.html#setFileName(java.lang.String)&quot;&gt;&lt;tt&gt;setFileName&lt;/tt&gt;&lt;/a&gt;
@see &lt;tt&gt;setFormat&lt;/tt&gt;
@see &lt;a href=&quot;QPictureIO.html#read()&quot;&gt;&lt;tt&gt;read&lt;/tt&gt;&lt;/a&gt;
@see &lt;tt&gt;QPixmap::save&lt;/tt&gt; */"/>
    <method name="public native static java.util.List&lt;com.trolltech.qt.core.QByteArray&gt; inputFormats()" doc="/**
&lt;p&gt;Returns a sorted list of picture formats that are supported for picture input.&lt;/p&gt;
 */"/>
    <method name="public native static java.util.List&lt;com.trolltech.qt.core.QByteArray&gt; outputFormats()" doc="/**
&lt;p&gt;Returns a sorted list of picture formats that are supported for picture output.&lt;/p&gt;
 */"/>
    <method name="public native static com.trolltech.qt.core.QByteArray pictureFormat(java.lang.String fileName)" doc="/**
&lt;p&gt;Returns a string that specifies the picture format of the file &lt;tt&gt;fileName&lt;/tt&gt;, or null if the file cannot be read or if the format is not recognized.&lt;/p&gt;
 */"/>
    <method name="public static com.trolltech.qt.core.QByteArray pictureFormat(com.trolltech.qt.core.QIODevice arg__1)" doc="/**
&lt;p&gt;Returns a string that specifies the picture format of the picture read from IO device &lt;tt&gt;arg__1&lt;/tt&gt;, or 0 if the device cannot be read or if the format is not recognized.&lt;/p&gt;
&lt;p&gt;Make sure that &lt;tt&gt;arg__1&lt;/tt&gt; is at the right position in the device (for example, at the beginning of the file).&lt;/p&gt;

@see &lt;tt&gt;QIODevice::at&lt;/tt&gt; */"/>
</class>