sam-izdat / tinycio

A primitive, lightweight Python color library for PyTorch-involved projects

• Project site & docs
• PyPi

About

A primitive, lightweight Python color library for PyTorch-involved projects. It implements color space conversion, tone mapping, LUT usage and creation, basic color correction and color balancing, and HDR-LDR encoding/decoding.

Getting started

• Recommended: set up a clean Python environment
• Install PyTorch as instructed here
• Run pip install tinycio
• Run tcio-setup (installs freeimage binaries; iio docs on fi)

See the docs for the rest.

Requires

• Python >=3.8
• PyTorch >=2.0 (earlier versions untested)
• NumPy >=1.21
• imageio >=2.9 (with PNG-FI FreeImage plugin)
• tqdm >=4.64
• toml >=0.10

tinycio's Issues

consider levels and curves for cc, if at all useful without UI

IIO corrupting EXR images on Linux

For whatever reason, this happens with iio when loading EXR files, exclusively on Linux.

Need to replace EXR io with non-iio solution.

consider 2-channel, 4-channel image types, alongside ColorImage and MonoImage

RG useful for tangent space normals
RGBA could be useful for keeping as wrapper for color+opacity

error on wavelength howto page

comment for srgb color should read:

# Float3([0.    , 0.9257, 1.    ])

figure out what's going on with CIELUV

consider more in-depth gradient descent tutorial

explain which parts of the lib are differentiable

add acescc to script color space definitions

cc settings from example image script

Look into switching from imageio to openimageio

No apparent way to embed ICC color profiles with imageio API.