Takes an image that has placeholders and applies separate component issues to it.
Project description
Overview
This is a library and tool that streamlines applying component images to a template image. A config is provided that defines boundaries of the regions within the template image to apply the component images to.
There is strictness to prevent overlapping configs and additional support for determining coverage of the template image.
Masking is not current supported.
Installation
$ sudo pip install image_template_overlay_apply
You may choose to clone the project instead:
$ git clone https://github.com/dsoprea/image_template_overlay_apply.git
$ cd image_template_overlay_apply
$ sudo pip install -e .
Library Usage
It is recommended that you use the source-code of the tool as a roadmap to using the library. There is also excellent unit-test coverage that may be used for guidance.
Tool Usage
The tool has full command-line documentation. You can also read the template from STDIN and write the output image to STDOUT (using the same format as the input).
Example
Using example data in assets/example.
Config:
{
"placeholders": {
"top-left": {
"left": 0,
"top": 0,
"width": 50,
"height": 100
},
"top-right": {
"left": 50,
"top": 0,
"width": 50,
"height": 100
},
"middle-center": {
"left": 0,
"top": 100,
"width": 100,
"height": 100
},
"bottom-center": {
"left": 0,
"top": 200,
"width": 100,
"height": 100
}
}
}
Running:
$ template_image_apply_overlays \
assets/example/layout.json \
--template-filepath assets/example/template.png \
--component-filepath top-left assets/example/top_left.png \
--component-filepath top-right assets/example/top_right.png \
--component-filepath middle-center assets/example/middle_center.png \
--component-filepath bottom-center assets/example/bottom_center.png \
--output-filepath /tmp/output.png
Applying: [top-left] [top_left.png]
Applying: [top-right] [top_right.png]
Applying: [middle-center] [middle_center.png]
Applying: [bottom-center] [bottom_center.png]
Writing.
The output will look like:
Tests
To run the unit-tests:
$ nose2 -v tests
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for image_template_overlay_apply-0.0.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | c07a40f44c9973f2b43ced06de5f8abf396b1be991d9e656109a20e772828ffc |
|
MD5 | 4c8cf1edb6ba3d2b2181511722835e44 |
|
BLAKE2b-256 | 8b96ea5bf4b584e9572419e3ea54e329501c6e90b458ce08dc1d3c6846c9fcd0 |