IM Image Representation, Storage, Capture and Processing Version 3.3 IM is a toolkit for Digital Imaging. IM is based on 4 concepts: Image Representation, Storage, Processing and Capture. The main goal of the library is to provide a simple API and abstraction of images for scientific applications. The most popular file formats are supported: TIFF, BMP, PNG, JPEG, GIF and AVI. Image representation includes scientific data types. About a hundred Image Processing operations are available. This work was developed at Tecgraf/PUC-Rio by means of the partnership with PETROBRAS/CENPES. Project Management: Antonio Escaño Scuri Tecgraf - Computer Graphics Technology Group, PUC-Rio, Brazil http://www.tecgraf.puc -rio.br/im Overview IM is a toolkit for Digital Imaging. IM is based on 4 concepts: Image Representation, Storage, Processing and Capture. Image Visualization is a task that it is left for a graphics library. It provides support for image capture, several image file formats and many image processing operations. The most popular file formats are supported: TIFF, BMP, PNG, JPEG, GIF and AVI. Image representation includes scientific data types (like IEEE floating point data) and attributes (or metadata like GeoTIFF and Exif tags). Animation, video and volumes are supported as image sequences, but there is no digital audio support. The main goal of the library is to provide a simple API and abstraction of images for scientific applications. The toolkit API is written in C. The core library source code is implemented in C++ and it is very portable, it can be compiled in Windows and UNIX with no modifications. New image processing operations can be implemented in C or in C++. IM is free software, can be used for public and commercial applications. IM has been used in Tecgraf for many theses and dissertations. Check the Publications in Tecgraf's web site http://www.tecgraf.puc -rio.br/ . Availability The library is available for several compilers : GCC and CC, in the UNIX environment Visual C++, Borland C++, Watcom C++ and GCC (Cygwin and MingW), in the Windows environment The library is available for several operating systems : UNIX (SunOS, IRIX, AIX, FreeBSD and Linux) Microsoft Windows NT/2K/XP Support The official support mechanism is by e-mail, using [email protected] -rio.br . Before sending your message: Check if the reported behavior is not described in the user guide. Check if the reported behavior is not described in the specific format characteristics. Check the History to see if your version is updated. Check the To Do list to see if your problem has already been reported. After all of the above have been checked, report the problem, including in your message: function, element, format, platform, and compiler. We host IM support features at LuaForge . It provides us Lists, News, CVS and Files. The IM page at LuaForge is available at: http://luaforge.net/projects/imtoolkit/ . The discussion list is available at: http://lists.luaforge.net/mailman/listinfo/imtoolkit -users . Source code, pre-compiled binaries and samples can be downloaded at: http://luaforge.net/frs/?group_id=86 . The CVS can be browsed at: http://luaforge.net/scm/?group_id=86 . If you want us to develop a specific feature for the toolkit, Tecgraf is available for partnerships and cooperation. Please contact [email protected] -rio.br . Lua documentation and resources can be found at http://www.lua.org/ . Credits This work was developed at Tecgraf by means of the partnership with PETROBRAS/CENPES. Thanks to the people that worked in the library: Marcelo Gattass and Luiz Henrique Figueiredo Antonio Scuri Antonio Nabuco Tartarini Diego Fernandes Nehab Erick de Moura Ferreira Carolina Alfaro We also thank the developers of the third party libraries: Sam Leffler (libTIFF author) Frank Warmerdam, Andrey Kiselev, Mike Welles and Dwight Kelly ( libTIFF actual maintainers) Thomas Lane ( libJPEG ) Lutz Müller ( libExif ) Glenn Randers-Pehrson ( libPNG ) Jean-loup Gailly and Mark Adler ( zlib ) Gershon Elber (GIFLib) Michael Adams ( libJasper ) Svein Bøe, Tor Lønnestad and Otto Milvang ( XITE ) Jason Perkins ( Premake ) Marc Alexander Lehmann ( libLZF ) (to many others that contribute to these library, keeping them free and updated) The IM toolkit distribution includes the some third party libraries that are not developed by Tecgraf. Their license are also free and have the same freedom as the Tecgraf Library License . You can read the respective licenses in the files: zlib.txt , libpng.txt , libjpeg.txt , libtiff.txt , libjasper.txt , liblzf.txt . Documentation This toolkit is available at http://www.tecgraf.puc -rio.br/im . The full documentation can be downloaded from the Download Files . The documentation is also available in Adobe Acrobat and Windows HTML Help formats. The HTML navigation uses the WebBook tool, available at http://www.tecgraf.puc -rio.br/webbook . The library Reference documentation is generated by Doxygen ( http://www.stack.nl/~dimitri/doxygen/ ). Publications Scuri, A. "IM - Imaging Toolkit". Software Developer's Journal. Jan/2006. [ http://en.sdjournal.org/products/articleInfo/25 ] Scuri, A., "IM – An Imaging Tool", Poster, SIBGRAPI 2004 [ poster.pdf , poster_text.pdf ] Tecgraf Library License All the products under this license are free software: they can be used for both academic and commercial purposes at absolutely no cost. There are no royalties or GNU- like "copyleft" restrictions. They are licensed under the terms of the MIT license reproduced below, and so are compatible with GPL and also qualifies as Open Source software. They are not in the public domain, Tecgraf and Petrobras keep their copyright. The legal details are below. The spirit of this license is that you are free to use the libraries for any purpose at no cost without having to ask us. The only requirement is that if you do use them, then you should give us credit by including the copyright notice below somewhere in your product or its documentation. A nice, but optional, way to give us further credit is to include a Tecgraf logo in a web page for your product. The libraries are designed and implemented by a team at Tecgraf/PUC-Rio in Brazil. The implementation is not derived from licensed software. The library was developed by request of Petrobras. Petrobras permits Tecgraf to distribute the library under the conditions here presented. The Tecgraf products under this license are: IUP , CD and IM . Copyright © 1994-2007 Tecgraf / PUC -Rio and PETROBRAS S/A . Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. Download The main download site is the LuaForge site available at: http://luaforge.net/project/showfiles.php?group_id=86 Before downloading any precompiled binaries, you should read before the Tecgraf Library Download Tips . Some other files are available directly at the IM download folder: http://www.tecgraf.puc -rio.br/im/download/ Tecgraf/PUC-Rio Library Download Tips All the libraries were build using Tecmake . Please use it if you intend to recompile the sources. Tecmake can be found at http://www.tecgraf.puc -rio.br/tecmake . The IM files can be downloaded at http://luaforge.net/project/showfiles.php?group_id=86 . The CD files can be downloaded at http://luaforge.net/project/showfiles.php?group_id=88 . The IUP files can be downloaded at http://luaforge.net/project/showfiles.php?group_id=89 . The Lua files can be downloaded at http://luaforge.net/project/showfiles.php?group_id=110 . Build Configuration Libraries and executables were built using speed optimization. In UNIX the dynamic libraries were NOT built with the -fpic parameter. In MacOS X the dynamic libraries are in bundle format. The source code along with the "config.mak" files for Tecmake are also available. The DLLs were built using the cdecl calling convention. This should be a problem for Visual Basic users. In Visual C++ we use the single thread C Run Time Library for static libraries and the multi thread C RTL for DLLs. Because this is the default in Visual Studio for new projects. In Visual C++ 8 both use the multi thread C RTL. Packaging The package files available for download are named according to the platform where they were build. In UNIX all strings are based in the result of the command "uname -a". The package name is a concatenation of the platform uname , the system major version number and the system minor version number. Some times a suffix must be added to complement the name. The default compiler is gcc, if the native compiler is used the name receive the suffix "cc". Binaries for 64-bits receive the suffix: "_64". In Linux when gcc is changed for the same uname in a new platform the major version number of the compiler is added as a suffix: "g3" for gcc 3 and "g4" for gcc 4. In Windows the platform name is the compiler and its major version number.