/oiio-python

OpenImageIO Python 3.x package

Primary LanguageC++MIT LicenseMIT

oiio-python

OpenImageIO Python 3.x package.

Build pipeline CI Status
Windows Server 2016 Build Status
Ubuntu 16.041 Build Status
macOS 10.13 Build Status

1 Should also work on CentOS 7 for example.

About the project

OpenImageIO is built using vcpkg and packaged into Python wheels on Windows, Linux and macOS platforms (thanks to Azure Pipelines).

To make this work, some customization of the vcpkg port files were necessary and thus these modifications are stored in this repository.

Download wheels

Download the wheels under "Releases". CI jobs produce wheels and they can be downloaded from the respective CI job.

Usage

  • Install the wheel: pip install ...
  • From within Python, import OpenImageIO: from oiio import OpenImageIO as oiio

See the tests folder for code examples used to test the built wheels' functionality.

Notes

  • Official OpenImageIO repository at OpenImageIO/oiio, note the .travis.yml and appveyor.yml
  • The python3 files for oiio at vcpkg/ports/python3
  • The vcpkg files for oiio at vcpkg/ports/openimageio
  • Get SHA512 of file:
    • macOS: openssl dgst -sha512 [FILE]
  • A new release is automatically performed when a commit is performed on the master branch.
  • Updating to a newer OpenImageIO version:
    1. Update the oiio.version variable in the .yml files
    2. Update the version and SHA512 in the OpenImageIO port files.