.TH "KImageIO" 3 "28 Jan 2004" "kio Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KImageIO \- Interface to the \fBKDE\fP Image IO plugin architecture.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <kimageio.h>\fP
.PP
.SS "Public Types"

.in +1c
.ti -1c
.RI "enum \fBMode\fP { \fBReading\fP, \fBWriting\fP }"
.br
.RI "\fIPossible image file access modes. \fP"
.in -1c
.SS "Static Public Member Functions"

.in +1c
.ti -1c
.RI "void \fBregisterFormats\fP ()"
.br
.RI "\fIRegisters all KImageIO supported formats. \fP"
.ti -1c
.RI "bool \fBcanWrite\fP (const  \fBQString\fP &type)"
.br
.RI "\fIChecks if a special type is supported for writing. \fP"
.ti -1c
.RI "bool \fBcanRead\fP (const  \fBQString\fP &type)"
.br
.RI "\fIChecks if a special type is supported for reading. \fP"
.ti -1c
.RI "\fBQStringList\fP \fBtypes\fP (\fBMode\fP mode=Writing)"
.br
.RI "\fIReturns a list of all KImageIO supported formats. \fP"
.ti -1c
.RI "\fBQString\fP \fBpattern\fP (\fBMode\fP mode=Reading)"
.br
.RI "\fIReturns a list of patterns of all KImageIO supported formats. \fP"
.ti -1c
.RI "\fBQString\fP \fBsuffix\fP (const  \fBQString\fP &type)"
.br
.RI "\fIReturns the suffix of an image type. \fP"
.ti -1c
.RI "\fBQString\fP \fBtypeForMime\fP (const  \fBQString\fP &mimeType)"
.br
.RI "\fIReturns the type of a MIME type. \fP"
.ti -1c
.RI "\fBQString\fP \fBtype\fP (const  \fBQString\fP &filename)"
.br
.RI "\fIReturns the type of given filename. \fP"
.ti -1c
.RI "\fBQStringList\fP \fBmimeTypes\fP (\fBMode\fP _mode=Writing)"
.br
.RI "\fIReturns a list of MIME types for all KImageIO supported formats. \fP"
.ti -1c
.RI "bool \fBisSupported\fP (const  \fBQString\fP &_mimeType, \fBMode\fP _mode=Writing)"
.br
.RI "\fITest to see whether a MIME type is supported to reading/writing. \fP"
.ti -1c
.RI "\fBQString\fP \fBmimeType\fP (const  \fBQString\fP &_filename)"
.br
.RI "\fIReturns the MIME type of \fC_filename\fP. \fP"
.in -1c
.SH "Detailed Description"
.PP 
Interface to the \fBKDE\fP Image IO plugin architecture. 

This library allows \fBKDE\fP applications to read and write images in a variety of formats, transparently via the \fBQImage\fP and \fBQPixmap\fP load and save methods.
.PP
The image processing backends are written as image handlers compatible with the \fBQImageIO\fP handler format. The backends are loaded on demand when a particular format is requested. Each format can be identified by a unique type id string.
.PP
\fB Formats\fP
.PP
\fB Currently supported formats include: 
.IP "\(bu" 2
JPEG  
.IP "\(bu" 2
XV   
.IP "\(bu" 2
EPS   
.IP "\(bu" 2
NETPBM  
.IP "\(bu" 2
PNG  <write, only with newer libraries> 
.IP "\(bu" 2
TIFF  
.IP "\(bu" 2
KRL 
.PP
\fP
.PP
\fB\fB Usage\fP\fP
.PP
\fB\fB Simply call the \fBKImageIO::registerFormats\fP() static method declared in kimgageio.h.\fP\fP
.PP
\fB\fB \fP\fP
.PP
\fB\fB\fB Example\fP\fP\fP
.PP
\fB\fB\fB 
.PP
.nf

	#include<qpixmap.h>
 	#include<kimgio.h>
.PP
\fP\fP\fP
.PP
\fB\fB\fB
.PP
.nf
	int main( int argc, char **argv )
	{
		....
		\fBKImageIO::registerFormats()\fP;
.PP
\fP\fP\fP
.PP
\fB\fB\fB
.PP
.nf
		...	// start main program
	}
 
.PP
\fP\fP\fP
.PP
\fB\fB\fB 
.PP
\fBSee also:\fP
.RS 4
KImageIO, \fBQPixmap\fP, \fBQImage\fP, \fBQImageIO\fP 
.RE
.PP
\fBAuthor:\fP
.RS 4
Sirtaj Singh Kang 
.RE
.PP
\fBVersion:\fP
.RS 4
\fBId\fP.RS 4
\fBkimageio.h\fP,v 1.9 2002/09/28 14:41:42 tjansen Exp 
.RE
.PP
.RE
.PP
\fP\fP\fP
.PP
Definition at line 62 of file kimageio.h.
.SH "Member Enumeration Documentation"
.PP 
.SS "enum \fBKImageIO::Mode\fP"
.PP
Possible image file access modes. Used in various KImageIO static function. Definition at line 70 of file kimageio.h.
.SH "Member Function Documentation"
.PP 
.SS "void KImageIO::registerFormats ()\fC [static]\fP"
.PP
Registers all KImageIO supported formats. Definition at line 378 of file kimageio.cpp.
.SS "bool KImageIO::canWrite (const \fBQString\fP & type)\fC [static]\fP"
.PP
Checks if a special type is supported for writing. \fBParameters:\fP
.RS 4
\fIthe\fP type id of the image type 
.RE
.PP
\fBReturns:\fP
.RS 4
true if the image format can be written 
.RE
.PP
Definition at line 392 of file kimageio.cpp.
.PP
References QValueList::ConstIterator().
.SS "bool KImageIO::canRead (const \fBQString\fP & type)\fC [static]\fP"
.PP
Checks if a special type is supported for reading. \fBParameters:\fP
.RS 4
\fIthe\fP type id of the image type 
.RE
.PP
\fBReturns:\fP
.RS 4
true if the image format can be read 
.RE
.PP
Definition at line 411 of file kimageio.cpp.
.PP
References QValueList::ConstIterator().
.SS "\fBQStringList\fP KImageIO::types (\fBMode\fP mode = Writing)\fC [static]\fP"
.PP
Returns a list of all KImageIO supported formats. \fBParameters:\fP
.RS 4
\fImode\fP Tells whether to retrieve modes that can be read or written. 
.RE
.PP
\fBReturns:\fP
.RS 4
a list of the type ids 
.RE
.PP
Definition at line 430 of file kimageio.cpp.
.PP
References QValueList::ConstIterator(), and types().
.PP
Referenced by types().
.SS "\fBQString\fP KImageIO::pattern (\fBMode\fP mode = Reading)\fC [static]\fP"
.PP
Returns a list of patterns of all KImageIO supported formats. These patterns can be passed to \fBKFileDialog::getOpenFileName\fP() or \fBKFileDialog::getSaveFileName\fP(), for example.
.PP
\fBParameters:\fP
.RS 4
\fImode\fP Tells whether to retrieve modes that can be read or written. 
.RE
.PP
Definition at line 384 of file kimageio.cpp.
.SS "\fBQString\fP KImageIO::suffix (const \fBQString\fP & type)\fC [static]\fP"
.PP
Returns the suffix of an image type. \fBParameters:\fP
.RS 4
\fItype\fP the type id of the file format 
.RE
.PP
\fBReturns:\fP
.RS 4
the suffix of the file format or QString::null if it does not exist 
.RE
.PP
Definition at line 450 of file kimageio.cpp.
.PP
References QValueList::ConstIterator().
.PP
Referenced by type().
.SS "\fBQString\fP KImageIO::typeForMime (const \fBQString\fP & mimeType)\fC [static]\fP"
.PP
Returns the type of a MIME type. \fBParameters:\fP
.RS 4
\fImimeType\fP the MIME type to search 
.RE
.PP
\fBReturns:\fP
.RS 4
type id of the MIME type or QString::null if the MIME type is not supported 
.RE
.PP
\fBSince:\fP
.RS 4
3.1 
.RE
.PP
Definition at line 469 of file kimageio.cpp.
.PP
References QValueList::ConstIterator().
.SS "\fBQString\fP KImageIO::type (const \fBQString\fP & filename)\fC [static]\fP"
.PP
Returns the type of given filename. \fBParameters:\fP
.RS 4
\fIfilename\fP the filename to check 
.RE
.PP
\fBReturns:\fP
.RS 4
if the file name's suffix is known the type id of the file type, otherwise QString::null 
.RE
.PP
Definition at line 488 of file kimageio.cpp.
.PP
References QValueList::ConstIterator(), QString::findRev(), QString::mid(), and suffix().
.SS "\fBQStringList\fP KImageIO::mimeTypes (\fBMode\fP _mode = Writing)\fC [static]\fP"
.PP
Returns a list of MIME types for all KImageIO supported formats. \fBParameters:\fP
.RS 4
\fImode\fP Tells whether to retrieve modes that can be read or written. 
.RE
.PP
\fBReturns:\fP
.RS 4
a list if MIME types of the supported formats 
.RE
.PP
Definition at line 511 of file kimageio.cpp.
.PP
References QValueList::ConstIterator().
.PP
Referenced by KFileDialog::getImageOpenURL().
.SS "bool KImageIO::isSupported (const \fBQString\fP & _mimeType, \fBMode\fP _mode = Writing)\fC [static]\fP"
.PP
Test to see whether a MIME type is supported to reading/writing. \fBParameters:\fP
.RS 4
\fI_mimeType\fP the MIME type to check 
.br
\fI_mode\fP Tells whether to check for reading or writing capabilities 
.RE
.PP
\fBReturns:\fP
.RS 4
true if the type is supported 
.RE
.PP
Definition at line 533 of file kimageio.cpp.
.PP
References QValueList::ConstIterator().
.SS "\fBQString\fP KImageIO::mimeType (const \fBQString\fP & _filename)\fC [static]\fP"
.PP
Returns the MIME type of \fC_filename\fP. \fBParameters:\fP
.RS 4
\fI_filename\fP the filename to check 
.RE
.PP
\fBReturns:\fP
.RS 4
the MIME type of the file, or QString::null 
.RE
.PP
Definition at line 556 of file kimageio.cpp.
.PP
References KMimeType::findByURL().

.SH "Author"
.PP 
Generated automatically by Doxygen for kio Library from the source code.
