Main Page
From OpenImageIO Wiki
OpenImageIO
Contents |
Overview
OpenImageIO is a library for reading and writing images, and a bunch of related classes, utilities, and applications. Main features include:
- Extremely simple but powerful ImageInput and ImageOutput APIs for reading and writing 2D images that is format agnostic -- that is, a "client app" doesn't need to know the details about any particular image file formats. Specific formats are implemented by DLL/DSO plugins.
- Format plugins for TIFF, JPEG/JFIF, OpenEXR, PNG, HDR/RGBE, Targa, JPEG-2000, FITS, BMP, ICO, RMan Zfile, Softimage PIC, DDS, SGI, PNM/PPM/PGM/PBM. More coming! The plugins are really good at understanding all the strange corners of the image formats, and are very careful about preserving image metadata (including Exif, GPS, and IPTC data).
- An ImageCache class that transparently manages a cache so that it can access truly vast amounts of image data (thousands of image files totaling hundreds of GB) very efficiently using only a tiny amount (tens of megabytes at most) of runtime memory. Additionally, a TextureSystem class provides filtered MIP-map texture lookups, atop the nice caching behavior of ImageCache.
- Several image tools based on these classes, including iinfo (print detailed info about images), iconvert (convert among formats, data types, or modify metadata), idiff (compare images), igrep (search images for matching metadata). Because these tools are based on ImageInput/ImageOutput, they work with any image formats for which ImageIO plugins are available.
- A really nice image viewer, iv, also based on OpenImageIO classes (and so will work with any formats for which plugins are available).
- Supported on Linux, OS X, and Windows.
- All available under the BSD license, so you may modify it and use it in both open source or proprietary apps.
News
May 28, 2010: Release 0.8: We have branched oiio/branches/RB-0.8 and tagged oiio/tags/Release-0.8.0.
April 26, 2010: GSoC results have been announced: our summer 2010 GSoC students are Robert Matusewicz, Leszek Godlewski, and Krzysztof Blicharski.
Mar 18, 2010: We have been accepted to Google Summer of Code 2010. Please see the links at the top of this page for details. The application process for students begins March 29, and the final deadline for student applications is April 9.
Documentation
Documentation can be found here: OpenImageIO Documentation
Mail Lists
There are two mail lists associated with OpenImageIO:
- oiio-users
- For users of the OIIO tools, APIs, or people integrating OpenImageIO into other applications or tools.
- oiio-dev
- For developers of the OpenImageIO code itself, or users who are really interested in the OIIO internals.
- oiio-commits
- For OIIO developers who feel like they need to see every SVN commit that happens.
You can sign up for these mail lists on your own.
Downloading and building the code
At present, there is not a separate precompiled or binary-only distribution of OpenImageIO (though we hope to eventually have one). For now, you'll have to check out and build the code yourself.
Read access to the SVN repository is available for anybody. Write/commit access is restricted to senior developers.
Please refer to Checking out and building OpenImageIO for details on how to check out and build OpenImageIO.
Please refer to Developing OIIO for various rules and procedures for developing OpenImageIO.
Bug/issue tracking
See http://trac.openimageio.org for our bugs / issues / tasks / to-do list. Anonymous users may add new tickets (please check that it's not a known problem, and if you're not fairly sure it's a legitimate bug, ask on oiio-users or oiio-dev first). You need an account to edit, accept, assign, or close out tickets. Request accounts by emailing Larry Gritz your desired userid and password.
Contact
For more information, contact Larry Gritz
Consult the User's Guide for information on using the wiki software.
