Create various icon masks and shading effects with the imageedit library
Project description
Python.ImageEdit
Create various icon masks and shading effects with the imageedit library. Four example files: round.py, makeProjIcons.py, makePWAImages.py and getPWAScreenshots.py. Includes imagetracer.py. imagetracer.py uses JS and is much faster than previous implementations. Takes a few seconds and has no cap.
Library Files
See the Docs for more information.
Example Files
- makeProjIcons.py
- makePWAImages.py
- round.py
Comparison to similar solutions
Similar solutions include but are not limited to:
GUI
Web
https://realfavicongenerator.net/
Advantages of this solution
- Minimal: few dependencies required (python and pillow)
- Quick: when given a regular or mask image it can produce a large number or variants in a relatively short amount of time
- Customisable: write your own scripts to leverage imageEdit (python knowledge required)
- Produce a PWA mask icon out of the box
- SVG tracing lib doesn't require potrace/ pypotrace which can be challenging to set up on Windows
- SVG tracing using imageTracerJs.py (https://github.com/jankovicsandras/imagetracerjs) is pretty good (requires pyppeteer: https://github.com/miyakogi/pyppeteer)
Disadvantages of this solution
- Specific image dimensions needed out of the box: whilst this is something that could be changed, maskable icons are 640x640 and regular icons are 512x512
How to use out of the box (makePWAImages)
- Put regular 512x512 image or mask 640x640 image under main/input in this example I am using lightfox.png
- Run
makePWAImages.py
and navigate to main/output/lightfox.png/pwa
Install With PIP
pip install imageedit
Head to https://pypi.org/project/imageedit/ for more info
See python files under main for example usage
Language information
Built for
This program has been written for Python 3 and has been tested with Python version 3.8.0 https://www.python.org/downloads/release/python-380/.
Install Python on Windows
Chocolatey
choco install python
Download
To install Python, go to https://www.python.org/ and download the latest version.
Install Python on Linux
Apt
sudo apt install python3.8
How to run
With VSCode
- Open the .py file in vscode
- Ensure a python 3.8 interpreter is selected (Ctrl+Shift+P > Python:Select Interpreter > Python 3.8)
- Run by pressing Ctrl+F5 (if you are prompted to install any modules, accept)
From the Terminal
./[file].py
Changelog
See the CHANGELOG for more information.
Download
Clone
Using The Command Line
- Press the Clone or download button in the top right
- Copy the URL (link)
- Open the command line and change directory to where you wish to clone to
- Type 'git clone' followed by URL in step 2
$ git clone https://github.com/[user-name]/[repository]
More information can be found at https://help.github.com/en/articles/cloning-a-repository
Using GitHub Desktop
- Press the Clone or download button in the top right
- Click open in desktop
- Choose the path for where you want and click Clone
More information can be found at https://help.github.com/en/desktop/contributing-to-projects/cloning-a-repository-from-github-to-github-desktop
Download Zip File
- Download this GitHub repository
- Extract the zip archive
- Copy/ move to the desired location
Licence
MIT License Copyright (c) fredhappyface (See the LICENSE for more information.)
Screenshots
Desktop
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
Built Distribution
Hashes for imageedit-2020.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e612612dd2469f6a49fed4201a2e5d98a6b168dc51f96efb58552c502c96a9d4 |
|
MD5 | b5b4ded900a77a6963e5b5f5aab14dd8 |
|
BLAKE2b-256 | 3934620d02d24020741ec30cca00ab89348b6bb9ae4dc096ba79d51678f42a85 |