Skip to content

hivesolutions/pconvert

Repository files navigation

Simple PNG conversion tool using libpng.

Build

It should be simple to build the project using make. Please note that the project requires both Python and libpng.

make
make install

To build pconvert for a specific system use the SYS Makefile variable:

make SYS=darwin

It's also possible to build the Python extension and install in a local machine.

python setup.py install

Python Methods

blend_images

Argument Type Mandatory Default Description
bottom_path str true - The path to the bottom image.
top_path str true - The path to the top image.
target_path str true - The path of the target (resulting) image.
algorithm str false multiplicative The blending algorithm to be used.
is_inline bool false false If the inline methods should be used to perform the blending.

blend_multiple

Argument Type Mandatory Default Description
paths list true - The sequence of paths of the images to be blended from bottom to top.
target_path str true - The path of the target (resulting) image.
algorithm str false multiplicative The blending algorithm to be used to blend all images in a pair-wise fashion.
algorithms list false - The sequence of blending algorithms to use for each blending operation. If defined, algorithm will not be used.
is_inline bool false false If the inline methods should be used to perform the blending.

Example

Running a simple set of composition can be done using:

pconvert compose assets/demo/

To be able to convert one image into a normalized PNG format use the convert command as following:

pconvert convert assets/demo/tux.png tux.out.png

To run a simple benchmark operation (results in benchmark.txt) using pconvert use:

pconvert benchmark assets/demo/

Conan

This package makes use of the Conan (version 1.x) package manager to use run:

pip install --upgrade "conan<2"
conan install . --build missing

It's important to note that the usage of Conan is not mandatory and it's still possible to build P(NG)Convert without it.

CMake

Linux & MacOS

conan install . --build missing
cmake .
make

Windows

conan install . --build missing
cmake . -DCMAKE_CL_64=1 -DCMAKE_GENERATOR_PLATFORM=x64 -Ax64
msbuild ALL_BUILD.vcxproj /P:Configuration=Release

License

PConvert is currently licensed under the Apache License, Version 2.0.

Build Automation

Build Status Build Status GitHub Coverage Status PyPi Status