You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
11 years ago | |
---|---|---|
.. | ||
AUTHORS | 15 years ago | |
CMakeLists.txt | 11 years ago | |
ChangeLog | 15 years ago | |
Mainpage.dox | 15 years ago | |
Makefile.am | 12 years ago | |
README | 12 years ago | |
bmp.kimgio | 15 years ago | |
configure.in.in | 15 years ago | |
dds.cpp | 12 years ago | |
dds.h | 14 years ago | |
dds.kimgio | 15 years ago | |
eps.cpp | 12 years ago | |
eps.h | 14 years ago | |
eps.kimgio | 15 years ago | |
exr.cpp | 12 years ago | |
exr.h | 14 years ago | |
exr.kimgio | 15 years ago | |
g3.kimgio | 15 years ago | |
g3r.cpp | 14 years ago | |
g3r.h | 14 years ago | |
gif.kimgio | 15 years ago | |
gimp.h | 12 years ago | |
hdr.cpp | 12 years ago | |
hdr.h | 14 years ago | |
hdr.kimgio | 15 years ago | |
ico.cpp | 13 years ago | |
ico.h | 14 years ago | |
ico.kimgio | 15 years ago | |
jp2.cpp | 12 years ago | |
jp2.h | 14 years ago | |
jp2.kimgio | 15 years ago | |
jpeg.kimgio | 15 years ago | |
mng.kimgio | 15 years ago | |
pbm.kimgio | 15 years ago | |
pcx.cpp | 13 years ago | |
pcx.h | 14 years ago | |
pcx.kimgio | 15 years ago | |
pgm.kimgio | 15 years ago | |
png.kimgio | 15 years ago | |
ppm.kimgio | 15 years ago | |
psd.cpp | 13 years ago | |
psd.h | 14 years ago | |
psd.kimgio | 15 years ago | |
rgb.cpp | 11 years ago | |
rgb.h | 13 years ago | |
rgb.kimgio | 15 years ago | |
tga.cpp | 13 years ago | |
tga.h | 14 years ago | |
tga.kimgio | 15 years ago | |
tiff.kimgio | 15 years ago | |
tiffr.cpp | 13 years ago | |
tiffr.h | 14 years ago | |
xbm.kimgio | 15 years ago | |
xcf.cpp | 11 years ago | |
xcf.h | 14 years ago | |
xcf.kimgio | 15 years ago | |
xpm.kimgio | 15 years ago | |
xv.kimgio | 15 years ago | |
xview.cpp | 13 years ago | |
xview.h | 14 years ago |
README
KDE Image I/O library --------------------- This library allows applications that use the Qt library (i.e. QImageIO, QImage, QPixmap and friends) to read and write images in extra formats. Current formats include: JPEG <read> <write> JPEG2000 <read> <write> XV <read> <write> EPS <read> <write> NETPBM <incomplete> PNG <read> <write, only with newer libraries> TIFF <read> TGA <read> <write> PCX <read> <write> SGI <read> <write> (images/x-rgb: *.bw, *.rgb, *.rgba, *.sgi) DDS <read> XCF <read> (Some example files are in kdenonbeta/kimgio_examples.) To use these formats, you only need to: 1. link the application with the libtdeio library 2. Include the <kimageio.h> header 3. call KImageIO::registerFormats() once, somewhere in your code before you load an image. Writing handlers ---------------- 0. Please read the documentation for the QImageIO class in the Qt documentation. 1. When writing handlers, there is a function naming convention; suppose, for example, we were writing PNG read and write handlers, we would name them void kimgio_png_read ( QImageIO * ); void kimgio_png_write( QImageIO * ); ie kimgio_<format>_<read/write> This should reduce the chance of identifier clashes with other code. 2. Remember that a given KDE application may try to load dozens of images at once such as when loading icons, or creating thumbnails. Also, it may well be loading them over a network connection. Therefore, - Avoid creating temporary files or allocating too much memory when decoding and encoding. Especially try to avoid firing off external programs. - Don't assume that the IODevice which is the source or target of the image data is pointing to a file on the local filesystem. Use the IODevice methods to read and write image data. - Check for file corruption or premature end of the image, especially before using values read from the file e.g. for memory allocations. 3. If you only have either a reader or the writer for a particular format, don't use NULL in QImageIO::defineIOHandler. Instead, write a stub function for the unimplemented handler which displays a message on standard output. This prevents kimgio-using programs dumping core when attempting to call the unimplemented handler. Yours in good faith and pedantry, Sirtaj Singh Kang <taj@kde.org>, 23 September 1998.