<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <!--NewPage--> <HTML> <HEAD> <!-- Generated by javadoc (build 1.5.0_09) on Tue Aug 07 17:01:22 CEST 2007 --> <TITLE> QImageWriter </TITLE> <META NAME="keywords" CONTENT="com.trolltech.qt.gui.QImageWriter class"> <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style"> <SCRIPT type="text/javascript"> function windowTitle() { parent.document.title="QImageWriter"; } </SCRIPT> <NOSCRIPT> </NOSCRIPT> </HEAD> <BODY BGCOLOR="white" onload="windowTitle();"> <!-- ========= START OF TOP NAVBAR ======= --> <A NAME="navbar_top"><!-- --></A> <A HREF="#skip-navbar_top" title="Skip navigation links"></A> <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> <TR> <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A NAME="navbar_top_firstrow"><!-- --></A> <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> <TR ALIGN="center" VALIGN="top"> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> </TR> </TABLE> </TD> <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> </EM> </TD> </TR> <TR> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../../com/trolltech/qt/gui/QImageReader.ImageReaderError.html" title="enum in com.trolltech.qt.gui"><B>PREV CLASS</B></A> <A HREF="../../../../com/trolltech/qt/gui/QImageWriter.ImageWriterError.html" title="enum in com.trolltech.qt.gui"><B>NEXT CLASS</B></A></FONT></TD> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../../index.html?com/trolltech/qt/gui/QImageWriter.html" target="_top"><B>FRAMES</B></A> <A HREF="QImageWriter.html" target="_top"><B>NO FRAMES</B></A> <SCRIPT type="text/javascript"> <!-- if(window==top) { document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>'); } //--> </SCRIPT> <NOSCRIPT> <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A> </NOSCRIPT> </FONT></TD> </TR> <TR> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> SUMMARY: <A HREF="#nested_class_summary">NESTED</A> | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> </TR> </TABLE> <A NAME="skip-navbar_top"></A> <!-- ========= END OF TOP NAVBAR ========= --> <HR> <!-- ======== START OF CLASS DATA ======== --> <H2> <FONT SIZE="-1"> com.trolltech.qt.gui</FONT> <BR> Class QImageWriter</H2> <PRE> java.lang.Object <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A HREF="../../../../com/trolltech/qt/QSignalEmitter.html" title="class in com.trolltech.qt">com.trolltech.qt.QSignalEmitter</A> <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A HREF="../../../../com/trolltech/qt/QtJambiObject.html" title="class in com.trolltech.qt">com.trolltech.qt.QtJambiObject</A> <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><B>com.trolltech.qt.gui.QImageWriter</B> </PRE> <DL> <DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../../../com/trolltech/qt/QtJambiInterface.html" title="interface in com.trolltech.qt">QtJambiInterface</A></DD> </DL> <HR> <DL> <DT><PRE>public class <B>QImageWriter</B><DT>extends <A HREF="../../../../com/trolltech/qt/QtJambiObject.html" title="class in com.trolltech.qt">QtJambiObject</A></DL> </PRE> <P> <p>The <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> class provides a format independent interface for writing images to files or other devices.</p> <p><a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> supports setting format specific options, such as the gamma level, compression level and quality, prior to storing the image. If you do not need such options, you can use QImage::save() or QPixmap::save() instead.</p> <p>To store an image, you start by constructing a <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> object. Pass either a file name or a device pointer, and the image format to <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a>'s constructor. You can then set several options, such as the gamma level (by calling <a href="QImageWriter.html#setGamma(float)"><tt>setGamma</tt></a>) and quality (by calling <a href="QImageWriter.html#setQuality(int)"><tt>setQuality</tt></a>). <a href="QImageWriter.html#canWrite()"><tt>canWrite</tt></a> returns true if <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> can write the image (i.e., the image format is supported and the device is open for writing). Call <a href="QImageWriter.html#write(com.trolltech.qt.gui.QImage)"><tt>write</tt></a> to write the image to the device.</p> <p>If any error occurs when writing the image, <a href="QImageWriter.html#write(com.trolltech.qt.gui.QImage)"><tt>write</tt></a> will return false. You can then call <a href="QImageWriter.html#error()"><tt>error</tt></a> to find the type of error that occurred, or <a href="QImageWriter.html#errorString()"><tt>errorString</tt></a> to get a human readable description of what went wrong.</p> <p>Call <a href="QImageWriter.html#supportedImageFormats()"><tt>supportedImageFormats</tt></a> for a list of formats that <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> can write. <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> supports all built-in image formats, in addition to any image format plugins that support writing.</p> <P> <P> <DL> <DT><B>See Also:</B><DD><a href="QImageReader.html"><tt>QImageReader</tt></a>, <a href="QImageIOHandler.html"><tt>QImageIOHandler</tt></a>, <tt>QImageIOPlugin</tt></DL> <HR> <P> <!-- ======== NESTED CLASS SUMMARY ======== --> <A NAME="nested_class_summary"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> <B>Nested Class Summary</B></FONT></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE>static class</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.ImageWriterError.html" title="enum in com.trolltech.qt.gui">QImageWriter.ImageWriterError</A></B></CODE> <BR> This enum describes errors that can occur when writing images with <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a>.</TD> </TR> </TABLE> <A NAME="nested_classes_inherited_from_class_com.trolltech.qt.QSignalEmitter"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> <TH ALIGN="left"><B>Nested classes/interfaces inherited from class com.trolltech.qt.<A HREF="../../../../com/trolltech/qt/QSignalEmitter.html" title="class in com.trolltech.qt">QSignalEmitter</A></B></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal0.html" title="class in com.trolltech.qt">QSignalEmitter.Signal0</A>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal1.html" title="class in com.trolltech.qt">QSignalEmitter.Signal1</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal1.html" title="type parameter in QSignalEmitter.Signal1">A</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal2.html" title="class in com.trolltech.qt">QSignalEmitter.Signal2</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal2.html" title="type parameter in QSignalEmitter.Signal2">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal2.html" title="type parameter in QSignalEmitter.Signal2">B</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal3.html" title="class in com.trolltech.qt">QSignalEmitter.Signal3</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal3.html" title="type parameter in QSignalEmitter.Signal3">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal3.html" title="type parameter in QSignalEmitter.Signal3">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal3.html" title="type parameter in QSignalEmitter.Signal3">C</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal4.html" title="class in com.trolltech.qt">QSignalEmitter.Signal4</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal4.html" title="type parameter in QSignalEmitter.Signal4">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal4.html" title="type parameter in QSignalEmitter.Signal4">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal4.html" title="type parameter in QSignalEmitter.Signal4">C</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal4.html" title="type parameter in QSignalEmitter.Signal4">D</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal5.html" title="class in com.trolltech.qt">QSignalEmitter.Signal5</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal5.html" title="type parameter in QSignalEmitter.Signal5">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal5.html" title="type parameter in QSignalEmitter.Signal5">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal5.html" title="type parameter in QSignalEmitter.Signal5">C</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal5.html" title="type parameter in QSignalEmitter.Signal5">D</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal5.html" title="type parameter in QSignalEmitter.Signal5">E</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="class in com.trolltech.qt">QSignalEmitter.Signal6</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="type parameter in QSignalEmitter.Signal6">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="type parameter in QSignalEmitter.Signal6">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="type parameter in QSignalEmitter.Signal6">C</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="type parameter in QSignalEmitter.Signal6">D</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="type parameter in QSignalEmitter.Signal6">E</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="type parameter in QSignalEmitter.Signal6">F</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="class in com.trolltech.qt">QSignalEmitter.Signal7</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">C</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">D</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">E</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">F</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">G</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="class in com.trolltech.qt">QSignalEmitter.Signal8</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">C</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">D</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">E</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">F</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">G</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">H</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="class in com.trolltech.qt">QSignalEmitter.Signal9</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">C</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">D</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">E</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">F</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">G</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">H</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">I</A>></CODE></TD> </TR> </TABLE> <!-- ======== CONSTRUCTOR SUMMARY ======== --> <A NAME="constructor_summary"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> <B>Constructor Summary</B></FONT></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#QImageWriter()">QImageWriter</A></B>()</CODE> <BR> Constructs an empty <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> object.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#QImageWriter(com.trolltech.qt.core.QIODevice, com.trolltech.qt.core.QByteArray)">QImageWriter</A></B>(<A HREF="../../../../com/trolltech/qt/core/QIODevice.html" title="class in com.trolltech.qt.core">QIODevice</A> device, <A HREF="../../../../com/trolltech/qt/core/QByteArray.html" title="class in com.trolltech.qt.core">QByteArray</A> format)</CODE> <BR> Constructs a <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> object using the device <tt>device</tt> and image format <tt>format</tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#QImageWriter(java.lang.String)">QImageWriter</A></B>(java.lang.String fileName)</CODE> <BR> Equivalent to <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a>(<tt>fileName</tt>, QByteArray()).</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)">QImageWriter</A></B>(java.lang.String fileName, <A HREF="../../../../com/trolltech/qt/core/QByteArray.html" title="class in com.trolltech.qt.core">QByteArray</A> format)</CODE> <BR> Constructs a <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> objects that will write to a file with the name <tt>fileName</tt>, using the image format <tt>format</tt>.</TD> </TR> </TABLE> <!-- ========== METHOD SUMMARY =========== --> <A NAME="method_summary"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> <B>Method Summary</B></FONT></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#canWrite()">canWrite</A></B>()</CODE> <BR> Returns true if <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> can write the image (i.e., the image format is supported and the assigned device is open for reading.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#compression()">compression</A></B>()</CODE> <BR> Returns the compression of the image.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../../com/trolltech/qt/core/QIODevice.html" title="class in com.trolltech.qt.core">QIODevice</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#device()">device</A></B>()</CODE> <BR> Returns the device currently assigned to <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a>, or 0 if no device has been assigned.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../../com/trolltech/qt/gui/QImageWriter.ImageWriterError.html" title="enum in com.trolltech.qt.gui">QImageWriter.ImageWriterError</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#error()">error</A></B>()</CODE> <BR> Returns the type of error that last occurred.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.lang.String</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#errorString()">errorString</A></B>()</CODE> <BR> Returns a human readable description of the last error that occurred.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.lang.String</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#fileName()">fileName</A></B>()</CODE> <BR> If the currently assigned device is a <a href="%2E%2E/core/QFile.html"><tt>QFile</tt></a>, or if <a href="QImageWriter.html#setFileName(java.lang.String)"><tt>setFileName</tt></a> has been called, this function returns the name of the file <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> writes to.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../../com/trolltech/qt/core/QByteArray.html" title="class in com.trolltech.qt.core">QByteArray</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#format()">format</A></B>()</CODE> <BR> Returns the format <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> uses for writing images.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE>static <A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html" title="class in com.trolltech.qt.gui">QImageWriter</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#fromNativePointer(com.trolltech.qt.QNativePointer)">fromNativePointer</A></B>(<A HREF="../../../../com/trolltech/qt/QNativePointer.html" title="class in com.trolltech.qt">QNativePointer</A> nativePointer)</CODE> <BR> This function returns the QImageWriter instance pointed to by nativePointer</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> float</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#gamma()">gamma</A></B>()</CODE> <BR> Returns the gamma level of the image.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#quality()">quality</A></B>()</CODE> <BR> Returns the quality level of the image.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#setCompression(int)">setCompression</A></B>(int compression)</CODE> <BR> This is an image format specific function that set the compression of an image.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#setDevice(com.trolltech.qt.core.QIODevice)">setDevice</A></B>(<A HREF="../../../../com/trolltech/qt/core/QIODevice.html" title="class in com.trolltech.qt.core">QIODevice</A> device)</CODE> <BR> Sets <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a>'s device to <tt>device</tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#setFileName(java.lang.String)">setFileName</A></B>(java.lang.String fileName)</CODE> <BR> Sets the file name of <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> to <tt>fileName</tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#setFormat(com.trolltech.qt.core.QByteArray)">setFormat</A></B>(<A HREF="../../../../com/trolltech/qt/core/QByteArray.html" title="class in com.trolltech.qt.core">QByteArray</A> format)</CODE> <BR> Sets the format <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> will use when writing images, to <tt>format</tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#setGamma(float)">setGamma</A></B>(float gamma)</CODE> <BR> This is an image format specific function that sets the gamma level of the image to <tt>gamma</tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#setQuality(int)">setQuality</A></B>(int quality)</CODE> <BR> This is an image format specific function that sets the quality level of the image to <tt>quality</tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#setText(java.lang.String, java.lang.String)">setText</A></B>(java.lang.String key, java.lang.String text)</CODE> <BR> Sets the image text associated with the key <tt>key</tt> to <tt>text</tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE>static java.util.List<<A HREF="../../../../com/trolltech/qt/core/QByteArray.html" title="class in com.trolltech.qt.core">QByteArray</A>></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#supportedImageFormats()">supportedImageFormats</A></B>()</CODE> <BR> Returns the list of image formats supported by <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#supportsOption(com.trolltech.qt.gui.QImageIOHandler.ImageOption)">supportsOption</A></B>(<A HREF="../../../../com/trolltech/qt/gui/QImageIOHandler.ImageOption.html" title="enum in com.trolltech.qt.gui">QImageIOHandler.ImageOption</A> option)</CODE> <BR> Returns true if the writer supports <tt>option</tt>; otherwise returns false.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html#write(com.trolltech.qt.gui.QImage)">write</A></B>(<A HREF="../../../../com/trolltech/qt/gui/QImage.html" title="class in com.trolltech.qt.gui">QImage</A> image)</CODE> <BR> Writes the image <tt>image</tt> to the assigned device or file name.</TD> </TR> </TABLE> <A NAME="methods_inherited_from_class_com.trolltech.qt.QtJambiObject"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> <TH ALIGN="left"><B>Methods inherited from class com.trolltech.qt.<A HREF="../../../../com/trolltech/qt/QtJambiObject.html" title="class in com.trolltech.qt">QtJambiObject</A></B></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><A HREF="../../../../com/trolltech/qt/QtJambiObject.html#dispose()">dispose</A>, <A HREF="../../../../com/trolltech/qt/QtJambiObject.html#disposed()">disposed</A>, <A HREF="../../../../com/trolltech/qt/QtJambiObject.html#finalize()">finalize</A>, <A HREF="../../../../com/trolltech/qt/QtJambiObject.html#reassignNativeResources(com.trolltech.qt.QtJambiObject, java.lang.Class)">reassignNativeResources</A>, <A HREF="../../../../com/trolltech/qt/QtJambiObject.html#tr(java.lang.String)">tr</A>, <A HREF="../../../../com/trolltech/qt/QtJambiObject.html#tr(java.lang.String, java.lang.String)">tr</A>, <A HREF="../../../../com/trolltech/qt/QtJambiObject.html#tr(java.lang.String, java.lang.String, int)">tr</A></CODE></TD> </TR> </TABLE> <A NAME="methods_inherited_from_class_com.trolltech.qt.QSignalEmitter"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> <TH ALIGN="left"><B>Methods inherited from class com.trolltech.qt.<A HREF="../../../../com/trolltech/qt/QSignalEmitter.html" title="class in com.trolltech.qt">QSignalEmitter</A></B></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><A HREF="../../../../com/trolltech/qt/QSignalEmitter.html#blockSignals(boolean)">blockSignals</A>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.html#disconnect()">disconnect</A>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.html#disconnect(java.lang.Object)">disconnect</A>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.html#signalsBlocked()">signalsBlocked</A>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.html#signalSender()">signalSender</A>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.html#thread()">thread</A></CODE></TD> </TR> </TABLE> <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> <TH ALIGN="left"><B>Methods inherited from class java.lang.Object</B></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE>clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD> </TR> </TABLE> <A NAME="methods_inherited_from_class_com.trolltech.qt.QtJambiInterface"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> <TH ALIGN="left"><B>Methods inherited from interface com.trolltech.qt.<A HREF="../../../../com/trolltech/qt/QtJambiInterface.html" title="interface in com.trolltech.qt">QtJambiInterface</A></B></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><A HREF="../../../../com/trolltech/qt/QtJambiInterface.html#disableGarbageCollection()">disableGarbageCollection</A>, <A HREF="../../../../com/trolltech/qt/QtJambiInterface.html#nativeId()">nativeId</A>, <A HREF="../../../../com/trolltech/qt/QtJambiInterface.html#nativePointer()">nativePointer</A>, <A HREF="../../../../com/trolltech/qt/QtJambiInterface.html#reenableGarbageCollection()">reenableGarbageCollection</A>, <A HREF="../../../../com/trolltech/qt/QtJambiInterface.html#setJavaOwnership()">setJavaOwnership</A></CODE></TD> </TR> </TABLE> <P> <!-- ========= CONSTRUCTOR DETAIL ======== --> <A NAME="constructor_detail"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> <B>Constructor Detail</B></FONT></TH> </TR> </TABLE> <A NAME="QImageWriter()"><!-- --></A><H3> QImageWriter</H3> <PRE> public <B>QImageWriter</B>()</PRE> <DL> <DD><p>Constructs an empty <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> object. Before writing, you must call <a href="QImageWriter.html#setFormat(com.trolltech.qt.core.QByteArray)"><tt>setFormat</tt></a> to set an image format, then <a href="QImageWriter.html#setDevice(com.trolltech.qt.core.QIODevice)"><tt>setDevice</tt></a> or <a href="QImageWriter.html#setFileName(java.lang.String)"><tt>setFileName</tt></a>.</p> <P> </DL> <HR> <A NAME="QImageWriter(com.trolltech.qt.core.QIODevice, com.trolltech.qt.core.QByteArray)"><!-- --></A><H3> QImageWriter</H3> <PRE> public <B>QImageWriter</B>(<A HREF="../../../../com/trolltech/qt/core/QIODevice.html" title="class in com.trolltech.qt.core">QIODevice</A> device, <A HREF="../../../../com/trolltech/qt/core/QByteArray.html" title="class in com.trolltech.qt.core">QByteArray</A> format)</PRE> <DL> <DD><p>Constructs a <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> object using the device <tt>device</tt> and image format <tt>format</tt>.</p> <P> </DL> <HR> <A NAME="QImageWriter(java.lang.String)"><!-- --></A><H3> QImageWriter</H3> <PRE> public <B>QImageWriter</B>(java.lang.String fileName)</PRE> <DL> <DD><p>Equivalent to <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a>(<tt>fileName</tt>, QByteArray()). <P> </DL> <HR> <A NAME="QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><!-- --></A><H3> QImageWriter</H3> <PRE> public <B>QImageWriter</B>(java.lang.String fileName, <A HREF="../../../../com/trolltech/qt/core/QByteArray.html" title="class in com.trolltech.qt.core">QByteArray</A> format)</PRE> <DL> <DD><p>Constructs a <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> objects that will write to a file with the name <tt>fileName</tt>, using the image format <tt>format</tt>. If <tt>format</tt> is not provided, <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> will detect the image format by inspecting the extension of <tt>fileName</tt>.</p> <P> </DL> <!-- ============ METHOD DETAIL ========== --> <A NAME="method_detail"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> <B>Method Detail</B></FONT></TH> </TR> </TABLE> <A NAME="canWrite()"><!-- --></A><H3> canWrite</H3> <PRE> public final boolean <B>canWrite</B>()</PRE> <DL> <DD><p>Returns true if <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> can write the image (i.e., the image format is supported and the assigned device is open for reading.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QImageWriter.html#write(com.trolltech.qt.gui.QImage)"><tt>write</tt></a>, <a href="QImageWriter.html#setDevice(com.trolltech.qt.core.QIODevice)"><tt>setDevice</tt></a>, <a href="QImageWriter.html#setFormat(com.trolltech.qt.core.QByteArray)"><tt>setFormat</tt></a></DL> </DD> </DL> <HR> <A NAME="compression()"><!-- --></A><H3> compression</H3> <PRE> public final int <B>compression</B>()</PRE> <DL> <DD><p>Returns the compression of the image.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QImageWriter.html#setCompression(int)"><tt>setCompression</tt></a></DL> </DD> </DL> <HR> <A NAME="device()"><!-- --></A><H3> device</H3> <PRE> public final <A HREF="../../../../com/trolltech/qt/core/QIODevice.html" title="class in com.trolltech.qt.core">QIODevice</A> <B>device</B>()</PRE> <DL> <DD><p>Returns the device currently assigned to <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a>, or 0 if no device has been assigned.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QImageWriter.html#setDevice(com.trolltech.qt.core.QIODevice)"><tt>setDevice</tt></a></DL> </DD> </DL> <HR> <A NAME="error()"><!-- --></A><H3> error</H3> <PRE> public final <A HREF="../../../../com/trolltech/qt/gui/QImageWriter.ImageWriterError.html" title="enum in com.trolltech.qt.gui">QImageWriter.ImageWriterError</A> <B>error</B>()</PRE> <DL> <DD><p>Returns the type of error that last occurred.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QImageWriter.html#ImageWriterError-enum"><tt>ImageWriterError</tt></a>, <a href="QImageWriter.html#errorString()"><tt>errorString</tt></a></DL> </DD> </DL> <HR> <A NAME="errorString()"><!-- --></A><H3> errorString</H3> <PRE> public final java.lang.String <B>errorString</B>()</PRE> <DL> <DD><p>Returns a human readable description of the last error that occurred.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QImageWriter.html#error()"><tt>error</tt></a></DL> </DD> </DL> <HR> <A NAME="fileName()"><!-- --></A><H3> fileName</H3> <PRE> public final java.lang.String <B>fileName</B>()</PRE> <DL> <DD><p>If the currently assigned device is a <a href="%2E%2E/core/QFile.html"><tt>QFile</tt></a>, or if <a href="QImageWriter.html#setFileName(java.lang.String)"><tt>setFileName</tt></a> has been called, this function returns the name of the file <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> writes to. Otherwise (i.e., if no device has been assigned or the device is not a <a href="%2E%2E/core/QFile.html"><tt>QFile</tt></a>), an empty <a href="%2E%2E/porting4.html#qstring"><tt>QString</tt></a> is returned.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QImageWriter.html#setFileName(java.lang.String)"><tt>setFileName</tt></a>, <a href="QImageWriter.html#setDevice(com.trolltech.qt.core.QIODevice)"><tt>setDevice</tt></a></DL> </DD> </DL> <HR> <A NAME="format()"><!-- --></A><H3> format</H3> <PRE> public final <A HREF="../../../../com/trolltech/qt/core/QByteArray.html" title="class in com.trolltech.qt.core">QByteArray</A> <B>format</B>()</PRE> <DL> <DD><p>Returns the format <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> uses for writing images.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QImageWriter.html#setFormat(com.trolltech.qt.core.QByteArray)"><tt>setFormat</tt></a></DL> </DD> </DL> <HR> <A NAME="gamma()"><!-- --></A><H3> gamma</H3> <PRE> public final float <B>gamma</B>()</PRE> <DL> <DD><p>Returns the gamma level of the image.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QImageWriter.html#setGamma(float)"><tt>setGamma</tt></a></DL> </DD> </DL> <HR> <A NAME="quality()"><!-- --></A><H3> quality</H3> <PRE> public final int <B>quality</B>()</PRE> <DL> <DD><p>Returns the quality level of the image.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QImageWriter.html#setQuality(int)"><tt>setQuality</tt></a></DL> </DD> </DL> <HR> <A NAME="setCompression(int)"><!-- --></A><H3> setCompression</H3> <PRE> public final void <B>setCompression</B>(int compression)</PRE> <DL> <DD><p>This is an image format specific function that set the compression of an image. For image formats that do not support setting the compression, this value is ignored.</p> <p>The value range of <tt>compression</tt> depends on the image format. For example, the "tiff" format supports two values, 0(no compression) and 1(LZW-compression).</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QImageWriter.html#compression()"><tt>compression</tt></a></DL> </DD> </DL> <HR> <A NAME="setDevice(com.trolltech.qt.core.QIODevice)"><!-- --></A><H3> setDevice</H3> <PRE> public final void <B>setDevice</B>(<A HREF="../../../../com/trolltech/qt/core/QIODevice.html" title="class in com.trolltech.qt.core">QIODevice</A> device)</PRE> <DL> <DD><p>Sets <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a>'s device to <tt>device</tt>. If a device has already been set, the old device is removed from <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> and is otherwise left unchanged.</p> <p>If the device is not already open, <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> will attempt to open the device in <tt>QIODevice::WriteOnly</tt> mode by calling open(). Note that this does not work for certain devices, such as <a href="%2E%2E/core/QProcess.html"><tt>QProcess</tt></a>, <a href="%2E%2E/network/QTcpSocket.html"><tt>QTcpSocket</tt></a> and <a href="%2E%2E/network/QUdpSocket.html"><tt>QUdpSocket</tt></a>, where more logic is required to open the device.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QImageWriter.html#device()"><tt>device</tt></a>, <a href="QImageWriter.html#setFileName(java.lang.String)"><tt>setFileName</tt></a></DL> </DD> </DL> <HR> <A NAME="setFileName(java.lang.String)"><!-- --></A><H3> setFileName</H3> <PRE> public final void <B>setFileName</B>(java.lang.String fileName)</PRE> <DL> <DD><p>Sets the file name of <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> to <tt>fileName</tt>. Internally, <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> will create a <a href="%2E%2E/core/QFile.html"><tt>QFile</tt></a> and open it in <tt>QIODevice::WriteOnly</tt> mode, and use this file when writing images.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QImageWriter.html#fileName()"><tt>fileName</tt></a>, <a href="QImageWriter.html#setDevice(com.trolltech.qt.core.QIODevice)"><tt>setDevice</tt></a></DL> </DD> </DL> <HR> <A NAME="setFormat(com.trolltech.qt.core.QByteArray)"><!-- --></A><H3> setFormat</H3> <PRE> public final void <B>setFormat</B>(<A HREF="../../../../com/trolltech/qt/core/QByteArray.html" title="class in com.trolltech.qt.core">QByteArray</A> format)</PRE> <DL> <DD><p>Sets the format <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> will use when writing images, to <tt>format</tt>. <tt>format</tt> is a case insensitive text string. Example:</p> <pre> QImageWriter writer; writer.setFormat("png"); <span class="comment">// same as writer.setFormat("PNG");</span></pre> <p>You can call <a href="QImageWriter.html#supportedImageFormats()"><tt>supportedImageFormats</tt></a> for the full list of formats <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a> supports.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QImageWriter.html#format()"><tt>format</tt></a></DL> </DD> </DL> <HR> <A NAME="setGamma(float)"><!-- --></A><H3> setGamma</H3> <PRE> public final void <B>setGamma</B>(float gamma)</PRE> <DL> <DD><p>This is an image format specific function that sets the gamma level of the image to <tt>gamma</tt>. For image formats that do not support setting the gamma level, this value is ignored.</p> <p>The value range of <tt>gamma</tt> depends on the image format. For example, the "png" format supports a gamma range from 0.0 to 1.0.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QImageWriter.html#gamma()"><tt>gamma</tt></a>, <a href="QImageWriter.html#quality()"><tt>quality</tt></a></DL> </DD> </DL> <HR> <A NAME="setQuality(int)"><!-- --></A><H3> setQuality</H3> <PRE> public final void <B>setQuality</B>(int quality)</PRE> <DL> <DD><p>This is an image format specific function that sets the quality level of the image to <tt>quality</tt>. For image formats that do not support setting the quality, this value is ignored.</p> <p>The value range of <tt>quality</tt> depends on the image format. For example, the "jpeg" format supports a quality range from 0 (low quality, high compression) to 100 (high quality, low compression).</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QImageWriter.html#quality()"><tt>quality</tt></a></DL> </DD> </DL> <HR> <A NAME="setText(java.lang.String, java.lang.String)"><!-- --></A><H3> setText</H3> <PRE> public final void <B>setText</B>(java.lang.String key, java.lang.String text)</PRE> <DL> <DD><p>Sets the image text associated with the key <tt>key</tt> to <tt>text</tt>. This is useful for storing copyright information or other information about the image. Example:</p> <pre> QImage image("some/image.jpeg"); QImageWriter writer("images/outimage.png", "png"); writer.setText("Author", "John Smith"); writer.write(image);</pre> <p>If you want to store a single block of data (e.g., a comment), you can pass an empty key, or use a generic key like "Description".</p> <p>The key and text will be embedded into the image data after calling <a href="QImageWriter.html#write(com.trolltech.qt.gui.QImage)"><tt>write</tt></a>.</p> <p>Support for this option is implemented through QImageIOHandler::Description.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><tt>QImage::setText</tt>, <tt>QImageReader::text</tt></DL> </DD> </DL> <HR> <A NAME="supportsOption(com.trolltech.qt.gui.QImageIOHandler.ImageOption)"><!-- --></A><H3> supportsOption</H3> <PRE> public final boolean <B>supportsOption</B>(<A HREF="../../../../com/trolltech/qt/gui/QImageIOHandler.ImageOption.html" title="enum in com.trolltech.qt.gui">QImageIOHandler.ImageOption</A> option)</PRE> <DL> <DD><p>Returns true if the writer supports <tt>option</tt>; otherwise returns false.</p> <p>Different image formats support different options. Call this function to determine whether a certain option is supported by the current format. For example, the PNG format allows you to embed text into the image's metadata (see text()).</p> <pre> QImageWriter writer(fileName); if (writer.supportsOption(QImageIOHandler::Description)) writer.setText("Author", "John Smith");</pre> <p>Options can be tested after the writer has been associated with a format.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><tt>QImageReader::supportsOption</tt>, <a href="QImageWriter.html#setFormat(com.trolltech.qt.core.QByteArray)"><tt>setFormat</tt></a></DL> </DD> </DL> <HR> <A NAME="write(com.trolltech.qt.gui.QImage)"><!-- --></A><H3> write</H3> <PRE> public final boolean <B>write</B>(<A HREF="../../../../com/trolltech/qt/gui/QImage.html" title="class in com.trolltech.qt.gui">QImage</A> image)</PRE> <DL> <DD><p>Writes the image <tt>image</tt> to the assigned device or file name. Returns true on success; otherwise returns false. If the operation fails, you can call <a href="QImageWriter.html#error()"><tt>error</tt></a> to find the type of error that occurred, or <a href="QImageWriter.html#errorString()"><tt>errorString</tt></a> to get a human readable description of the error.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QImageWriter.html#canWrite()"><tt>canWrite</tt></a>, <a href="QImageWriter.html#error()"><tt>error</tt></a>, <a href="QImageWriter.html#errorString()"><tt>errorString</tt></a></DL> </DD> </DL> <HR> <A NAME="supportedImageFormats()"><!-- --></A><H3> supportedImageFormats</H3> <PRE> public static java.util.List<<A HREF="../../../../com/trolltech/qt/core/QByteArray.html" title="class in com.trolltech.qt.core">QByteArray</A>> <B>supportedImageFormats</B>()</PRE> <DL> <DD><p>Returns the list of image formats supported by <a href="QImageWriter.html#QImageWriter(java.lang.String, com.trolltech.qt.core.QByteArray)"><tt>QImageWriter</tt></a>.</p> <p>By default, Qt can write the following formats:</p> <p><table align="center" cellpadding="2" cellspacing="1" border="0"> <thead><tr valign="top" class="qt-style"><th>Format</th><th>Description</th></tr></thead> <tr valign="top" class="odd"><td>BMP</td><td>Windows Bitmap</td></tr> <tr valign="top" class="even"><td>JPG</td><td>Joint Photographic Experts Group</td></tr> <tr valign="top" class="odd"><td>JPEG</td><td>Joint Photographic Experts Group</td></tr> <tr valign="top" class="even"><td>PNG</td><td>Portable Network Graphics</td></tr> <tr valign="top" class="odd"><td>PPM</td><td>Portable Pixmap</td></tr> <tr valign="top" class="even"><td>TIFF</td><td>Tagged Image File Format</td></tr> <tr valign="top" class="odd"><td>XBM</td><td>X11 Bitmap</td></tr> <tr valign="top" class="even"><td>XPM</td><td>X11 Pixmap</td></tr> </table></p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QImageWriter.html#setFormat(com.trolltech.qt.core.QByteArray)"><tt>setFormat</tt></a>, <tt>QImageReader::supportedImageFormats</tt>, <tt>QImageIOPlugin</tt></DL> </DD> </DL> <HR> <A NAME="fromNativePointer(com.trolltech.qt.QNativePointer)"><!-- --></A><H3> fromNativePointer</H3> <PRE> public static <A HREF="../../../../com/trolltech/qt/gui/QImageWriter.html" title="class in com.trolltech.qt.gui">QImageWriter</A> <B>fromNativePointer</B>(<A HREF="../../../../com/trolltech/qt/QNativePointer.html" title="class in com.trolltech.qt">QNativePointer</A> nativePointer)</PRE> <DL> <DD>This function returns the QImageWriter instance pointed to by nativePointer <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>nativePointer</CODE> - the QNativePointer of which object should be returned.</DL> </DD> </DL> <!-- ========= END OF CLASS DATA ========= --> <HR> <!-- ======= START OF BOTTOM NAVBAR ====== --> <A NAME="navbar_bottom"><!-- --></A> <A HREF="#skip-navbar_bottom" title="Skip navigation links"></A> <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> <TR> <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A NAME="navbar_bottom_firstrow"><!-- --></A> <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> <TR ALIGN="center" VALIGN="top"> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> </TR> </TABLE> </TD> <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> </EM> </TD> </TR> <TR> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../../com/trolltech/qt/gui/QImageReader.ImageReaderError.html" title="enum in com.trolltech.qt.gui"><B>PREV CLASS</B></A> <A HREF="../../../../com/trolltech/qt/gui/QImageWriter.ImageWriterError.html" title="enum in com.trolltech.qt.gui"><B>NEXT CLASS</B></A></FONT></TD> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../../index.html?com/trolltech/qt/gui/QImageWriter.html" target="_top"><B>FRAMES</B></A> <A HREF="QImageWriter.html" target="_top"><B>NO FRAMES</B></A> <SCRIPT type="text/javascript"> <!-- if(window==top) { document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>'); } //--> </SCRIPT> <NOSCRIPT> <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A> </NOSCRIPT> </FONT></TD> </TR> <TR> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> SUMMARY: <A HREF="#nested_class_summary">NESTED</A> | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> </TR> </TABLE> <A NAME="skip-navbar_bottom"></A> <!-- ======== END OF BOTTOM NAVBAR ======= --> <HR> </BODY> </HTML>