{"id":15039265,"url":"https://github.com/academysoftwarefoundation/openimageio","last_synced_at":"2026-04-02T21:09:24.359Z","repository":{"id":37886174,"uuid":"1322284","full_name":"AcademySoftwareFoundation/OpenImageIO","owner":"AcademySoftwareFoundation","description":"Reading, writing, and processing images in a wide variety of file formats, using a format-agnostic API, aimed at VFX applications.","archived":false,"fork":false,"pushed_at":"2025-05-08T17:23:25.000Z","size":189464,"stargazers_count":2086,"open_issues_count":178,"forks_count":621,"subscribers_count":135,"default_branch":"main","last_synced_at":"2025-05-08T18:32:52.313Z","etag":null,"topics":["c-plus-plus","c-plus-plus-11","image-processing","images","texture","vfx"],"latest_commit_sha":null,"homepage":"https://openimageio.readthedocs.org","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AcademySoftwareFoundation.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":"GOVERNANCE.md","roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2011-02-02T23:03:28.000Z","updated_at":"2025-05-08T02:18:28.000Z","dependencies_parsed_at":"2023-02-18T20:00:52.960Z","dependency_job_id":"9fd31aed-1b93-475f-8994-54ee9767408c","html_url":"https://github.com/AcademySoftwareFoundation/OpenImageIO","commit_stats":null,"previous_names":["academysoftwarefoundation/openimageio","openimageio/oiio"],"tags_count":502,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AcademySoftwareFoundation%2FOpenImageIO","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AcademySoftwareFoundation%2FOpenImageIO/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AcademySoftwareFoundation%2FOpenImageIO/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AcademySoftwareFoundation%2FOpenImageIO/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AcademySoftwareFoundation","download_url":"https://codeload.github.com/AcademySoftwareFoundation/OpenImageIO/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253746842,"owners_count":21957646,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["c-plus-plus","c-plus-plus-11","image-processing","images","texture","vfx"],"created_at":"2024-09-24T20:42:08.791Z","updated_at":"2026-04-02T21:09:24.335Z","avatar_url":"https://github.com/AcademySoftwareFoundation.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- SPDX-License-Identifier: CC-BY-4.0 --\u003e\n\u003c!-- Copyright Contributors to the OpenImageIO Project. --\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"ASWF/logos/openimageio-horizontal-gradient.png\"\u003e\n\u003c/p\u003e\n\n[![License](https://img.shields.io/badge/license-Apache2.0-blue.svg?style=flat-square)](https://github.com/AcademySoftwareFoundation/OpenImageIO/blob/main/LICENSE.md)\n[![CI](https://github.com/AcademySoftwareFoundation/OpenImageIO/actions/workflows/ci.yml/badge.svg)](https://github.com/AcademySoftwareFoundation/OpenImageIO/actions/workflows/ci.yml)\n[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/2694/badge)](https://bestpractices.coreinfrastructure.org/projects/2694)\n[![latest packaged version(s)](https://repology.org/badge/latest-versions/openimageio.svg)](https://repology.org/project/openimageio/versions)\n\n\nIntroduction\n------------\n\n**Mission statement**: OpenImageIO is a toolset for reading, writing, and\nmanipulating image files of any image file format relevant to VFX / animation\nvia a format-agnostic API with a feature set, scalability, and robustness\nneeded for feature film production.\n\nThe primary target audience for OIIO is VFX studios and developers of\ntools such as renderers, compositors, viewers, and other image-related\nsoftware you'd find in a production pipeline.\n\nOpenImageIO consists of:\n\n* Simple but powerful ImageInput and ImageOutput APIs that provide\n  an abstraction for reading and writing image files of nearly any\n  format, without the calling application needing to know any of the\n  details of these file formats, and indeed without the calling\n  application needing to be aware of which formats are available.\n\n* A library that manages subclasses of ImageInput and ImageOutput that\n  implement I/O from specific file formats, with each file format's\n  implementation stored as a plug-in.  Therefore, an application using\n  OpenImageIO's APIs can read and write any image file for which a\n  plugin can be found at runtime.\n\n* Plugins implementing I/O for several popular image file formats,\n  including TIFF, JPEG/JFIF, JPEG XL, OpenEXR, PNG, HDR/RGBE, ICO, BMP, Targa,\n  JPEG-2000, RMan Zfile, FITS, DDS, Softimage PIC, PNM, DPX, Cineon,\n  IFF, OpenVDB, Ptex, Photoshop PSD, Wavefront RLA, SGI, WebP,\n  GIF, DICOM, HEIF/HEIC/AVIF, many \"RAW\" digital camera formats, and a variety\n  of movie formats (readable as individual frames).  More are being developed\n  all the time.\n\n* Several command line image tools based on these classes, including\n  oiiotool (command-line format conversion and image processing), iinfo\n  (print detailed info about images), iconvert (convert among formats,\n  data types, or modify metadata), idiff (compare images), igrep (search\n  images for matching metadata), and iv (an image viewer). Because these\n  tools are based on ImageInput/ImageOutput, they work with any image\n  formats for which ImageIO plugins are available.\n\n* An ImageCache class that transparently manages a cache so that it\n  can access truly vast amounts of image data (tens of thousands of\n  image files totaling multiple TB) very efficiently using only a tiny\n  amount (tens of megabytes at most) of runtime memory.\n\n* A TextureSystem class that provides filtered MIP-map texture\n  lookups, atop the nice caching behavior of ImageCache.  This is used\n  in commercial renderers and has been used on many large VFX and\n  animated films.\n\n* ImageBuf and ImageBufAlgo functions -- a simple class for storing\n  and manipulating whole images in memory, and a collection of the\n  most useful computations you might want to do involving those images,\n  including many image processing operations.\n\n* Python bindings for all of the major APIs.\n\n\n\n🏢 Project administration and Licensing\n---------------------------------------\n\nOpenImageIO is (c) Copyright Contributors to the OpenImageIO project.\n\nFor original code, we use the [Apache-2.0 license](LICENSE.md), and for\ndocumentation, the [Creative Commons Attribution 4.0 Unported\nLicense](http://creativecommons.org/licenses/by/4.0/). In 2023 we asked\nhistorical users to [relicense](RELICENSING.md) from the original BSD-3-clause\nlicense to Apache-2.0, and over 99.86% of lines of code have been relicensed\nto Apache-2.0. A small amount of code incorporated into this repository from\nother projects are covered by compatible [third-party open source\nlicenses](THIRD-PARTY.md).\n\nThe OpenImageIO project is part of the [Academy Software\nFoundation](https://www.aswf.io/), a part of the Linux Foundation formed in\ncollaboration with the Academy of Motion Picture Arts and Sciences. The\n[Technical Charter](aswf/Technical-Charter.md) and [Project\nGovernance](GOVERNANCE.md) explain how the project is run, who makes\ndecisions, etc. Please be aware of our [Code of Conduct](CODE_OF_CONDUCT.md).\n\n\n💁 User Documentation\n---------------------\n\n[OpenImageIO Documentation](https://docs.openimageio.org)\nis the best place to start if you are interested in how to use OpenImageIO,\nits APIs, its component programs (once they are built). There is also a [PDF\nversion](https://readthedocs.org/projects/openimageio/downloads/pdf/latest/).\n\nAdditional resources:\n\n- [User quick start](docs/QuickStart.md) is a quick example of using\n  OpenImageIO in Python, C++, and the command line.\n\n\n👷 Building and installing OpenImageIO\n--------------------------------------\n- [Build and installation instructions](INSTALL.md) for OpenImageIO. Such\n  as it is. This could use some work, particularly for Windows.\n\n\n🚑 Contact \u0026 reporting problems\n-------------------------------\n\nSimple \"how do I...\", \"I'm having trouble\", or \"is this a bug\" questions are\nbest asked on the [oiio-dev developer mail\nlist](https://lists.aswf.io/g/oiio-dev). That's where the most people will see\nit and potentially be able to answer your question quickly (more so than a GH\n\"issue\"). For quick questions, you could also try the [ASWF\nSlack](https://slack.aswf.io) `#openimageio` channel.\n\nBugs, build problems, and discovered vulnerabilities that you are relatively\ncertain is a legit problem in the code, and **for which you can give clear\ninstructions for how to reproduce**, should be [reported as\nissues](https://github.com/AcademySoftwareFoundation/OpenImageIO/issues).\n\nIf confidentiality precludes a public question or issue, you may contact us\nprivately at [info@openimageio.org](info@openimageio.org), or for\nsecurity-related issues [security@openimageio.org](security@openimageio.org).\n\n\n🔧 Contributing and developer documentation\n-------------------------------------------\n\nOpenImageIO welcomes code contributions, and [nearly 250 people](CREDITS.md)\nhave done so over the years. We take code contributions via the usual GitHub\npull request (PR) mechanism.\n\n* [Architecture overview](docs/dev/Architecture.md) is a high-level\n  description of the major classes and their relationships.\n* [CONTRIBUTING](CONTRIBUTING.md) has detailed instructions about the\n  development process.\n* [AI Policy](docs/dev/AI_Policy.md) decribes our policies on AI coding\n  assistance tools.\n* [ROADMAP](docs/ROADMAP.md) is a high-level overview of the current\n  development priorities for the next annual release, expected in September,\n  2024.\n* [RELEASING](docs/dev/RELEASING.md) explains our policies and procedures for\n  making releases. We have a major, possibly-compatibility-breaking, release\n  annually in September/October, and minor bug fix and safe feature addition\n  release at the beginning of every month.\n* [Building the docs](src/doc/Building_the_docs.md) has instructions for\n  building the documentation locally, which may be helpful if you are editing\n  the documentation in nontrivial ways and want to preview the appearance.\n* Other developer documentation is in the [docs/dev](docs/dev) directory.\n* You may also have luck learning a bit about the organization and\n  architecture of the project by reading the [DeepWiki Analysis of\n  OpenImageIO](https://deepwiki.com/AcademySoftwareFoundation/OpenImageIO).\n  But take it with a grain of salt -- like any LLM-generated summary, there\n  may be inaccuracies lurking.\n\n\n☎️ Communications channels and additional resources\n--------------------------------------------------\n\n* [Main web page](http://www.openimageio.org)\n* [GitHub project page](http://github.com/AcademySoftwareFoundation/OpenImageIO)\n* [Developer mail list](https://lists.aswf.io/g/oiio-dev)\n* [ASWF Slack](https://slack.aswf.io) (look for the `#openimageio` channel)\n* Biweekly Technical Steering Committee (TSC) Zoom meetings are on the [ASWF\n  Calendar](https://calendar.openimageio.org) (click on the OpenImageIO\n  meeting entries, every second Monday, to get the Zoom link, anyone may join)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Facademysoftwarefoundation%2Fopenimageio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Facademysoftwarefoundation%2Fopenimageio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Facademysoftwarefoundation%2Fopenimageio/lists"}