Skip to main content

OpenLUT is a practical color management library.

Project description

openlut - OSS tools for practical color management.

build status

Dev Repo (Please submit Issues here): https://git.sofusrose.com/so-rose/openlut

Mirror Repo: https://www.github.com/so-rose/openlut

PyPi Package: https://pypi.python.org/pypi/openlut

What is it?

openlut is a practical color management library/tool that aims to simplify and unify all the various methods of making accurate color transformations.

Supported transforms include:

  • 1D and 3D LUTs
  • Color Matrices
  • Gamma Function
  • CDL Transform

It's built on my own color pipeline needs - I needed a simple but close-to-the-math solutions that dealt not with images, but with float arrays.

As a tool, its main feature is that it's exceptionally easy to import, transform, and then save not only images, but also transforms.

Documentation

Docs can be found at https://sofusrose.com/openlut. They're a work in progress for now (ColMap is 100% documented).

Installation

  1. Check Versions: Ensure you have Python 3.5+ installed.

  2. Get System Dependencies - needing to do this is an unfortunate side effect of PyPi.

    • On Debian/Ubuntu: sudo apt-get install python3-pip gcc libmagickwand-dev
    • On Mac: brew install python3 gcc imagemagick
  3. Ensure Core Python Packages are Up To Date: Simply run pip3 install --user -U pip setuptools wheel to do so.

  4. Install OpenLUT: Run pip3 install --user openlut.

    • This may take awhile, as it must compile the C++ Extension.

Development

  1. Clone the Repository: This is easy enough to do - just run git clone https://www.github.com/so-rose/openlut.

  2. Compile Openlut: Again, very easy - just run ./build <TARGET>, where <TARGET> is some build target as listed in ./build -l.

Troubleshooting

Pip doesn't work: If Python is installed, but pip won't run, try running curl https://bootstrap.pypa.io/get-pip.py | python3

Doesn't work on Windows: I'm unsure of how pip compiles C Extensions on Windows, and have little willpower to investigate. If you need Windows support, PM me and I'll see what I can do about it.

Something's broken...: There may be several bugs. If you start an Issue, then I can investigate.

I Want To Contribute!

Contributions are welcome! Let me know if you have any questions or issues.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for openlut, version 0.2.7
Filename, size File type Python version Upload date Hashes
Filename, size openlut-0.2.7-cp37-cp37m-win32.whl (75.1 kB) File type Wheel Python version cp37 Upload date Hashes View hashes
Filename, size openlut-0.2.7.tar.gz (25.8 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page