{"library":"openimageio","title":"OpenImageIO","description":"OpenImageIO (OIIO) is a high-performance, open-source library and toolset for reading, writing, and processing images in a wide variety of file formats, using a format-agnostic API. Primarily aimed at visual effects (VFX) and animation applications, it provides robust support for formats like OpenEXR, TIFF, JPEG, PNG, and many more. The library is actively maintained by the Academy Software Foundation, with frequent minor releases within its major versions.","language":"python","status":"active","last_verified":"Sun May 17","install":{"commands":["pip install openimageio","pip install --force-reinstall \"openimageio[all]\" # For comprehensive format support and to rebuild if issues arise"],"cli":{"name":"oiiotool","version":"3.1.13.1"}},"imports":["import OpenImageIO as oiio","from OpenImageIO import ImageInput","from OpenImageIO import ImageBuf"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import OpenImageIO as oiio\nimport numpy as np\nimport os\n\n# Create a dummy image (e.g., a red square)\nwidth, height, channels = 256, 256, 3\nspec = oiio.ImageSpec(width, height, channels, oiio.TypeDesc('float'))\n# Create a NumPy array with red pixels\npixels = np.zeros((height, width, channels), dtype=np.float32)\npixels[:, :, 0] = 1.0 # Red channel to full intensity\n\n# Create an ImageBuf from the spec and pixels\nimg_buf = oiio.ImageBuf(spec, pixels)\n\n# Define output file path\noutput_filename = 'red_square.exr'\n\n# Write the image\ntry:\n    img_buf.write(output_filename)\n    print(f\"Successfully wrote {output_filename}\")\n\n    # Read the image back\n    read_img_buf = oiio.ImageBuf(output_filename)\n    if read_img_buf.has_error:\n        raise RuntimeError(f\"Error reading {output_filename}: {read_img_buf.geterror()}\")\n    \n    # Get pixel data as a NumPy array\n    read_pixels = read_img_buf.get_pixels(oiio.TypeDesc('float'))\n    print(f\"Read image with shape: {read_pixels.shape}\")\n\nexcept Exception as e:\n    print(f\"An error occurred: {e}\")\nfinally:\n    if os.path.exists(output_filename):\n        os.remove(output_filename) # Clean up the dummy file","lang":"python","description":"This quickstart demonstrates how to create an in-memory image (a red square) using OpenImageIO and NumPy, write it to an OpenEXR file, and then read it back. It utilizes `ImageSpec` to define image properties and `ImageBuf` for convenient image manipulation and I/O. The `get_pixels` method retrieves pixel data as a NumPy array.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-17","installed_version":"3.1.13.1","pypi_latest":"3.1.13.1","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":50,"avg_install_s":3.9,"avg_import_s":0.04,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"--force-reinstall","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"openimageio","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"--force-reinstall","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"openimageio","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.9,"import_time_s":0.03,"mem_mb":1.3,"disk_size":"102M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"--force-reinstall","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"openimageio","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"--force-reinstall","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"openimageio","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.7,"import_time_s":0.05,"mem_mb":1.4,"disk_size":"109M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"--force-reinstall","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"openimageio","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"--force-reinstall","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"openimageio","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.6,"import_time_s":0.05,"mem_mb":1.4,"disk_size":"97M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"--force-reinstall","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"openimageio","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"--force-reinstall","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"openimageio","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.6,"import_time_s":0.04,"mem_mb":1.2,"disk_size":"97M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"--force-reinstall","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"openimageio","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"--force-reinstall","exit_code":0,"wheel_type":null,"failure_reason":null,"import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"openimageio","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":4.6,"import_time_s":0.05,"mem_mb":1.2,"disk_size":"112M"}]}}