Skip to content

Image utility library that utilizes OpenImageIO to provide the basic image manipulation in more convenient way

Notifications You must be signed in to change notification settings

alijafargholi/image_utils

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Image Utils Awesome

Utility/Convenient API that handles the common image processing such as read, write, image conversion, resize, etc.

The idea behind this utility module is to mimic the basic Nuke feature via python. This library uses OpenImageIO at its core and utilizes its API features

==If you are comfortable with using OpenImageIo itself, I recommend using that instead of this library. This library is mostly for training purposes==

Documentation

For more info, please visit the documentation page

Getting Started

>>> from image_utils.nodes.image import constant
>>> from image_utils.nodes.image import Read
>>> from image_utils.nodes.transform import resize
>>> from image_utils.nodes.merge import over
>>> # create a red 4k constant image
>>> constant_image = constant(4000, 4000, (1, 0, 0, 0))
>>> # read an image into buffer
>>> buffer_image = image.Read('input.exr')
>>> # resize the input image to 4k
>>> resize_image = resize(buffer_image, 4000, 4000)
>>> # comp the input image over the contant image
>>> comp_image = over(resize_image, constant_image)
>>> # save the comp image into disk as PNG
>>> comp_image.write('comp.png')

Prerequisites

This API utilize the OpenImageIo library

  • For Windows installation please visit here
  • For MacOs installation you can use brew
    brew install OpenImageIO

Installing

Clone the repository somewhere in your PYTHONPATH

Running the tests

WIP

Contributing

  • Ali Jafargholi

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

  • Hat tip to anyone who toke the time to test/use this

About

Image utility library that utilizes OpenImageIO to provide the basic image manipulation in more convenient way

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages