| |
@@ -1,108 +0,0 @@
|
| |
- diff -urN ../legofy-origen/LICENSE ./LICENSE
|
| |
- --- ../legofy-origen/LICENSE 1969-12-31 18:00:00.000000000 -0600
|
| |
- +++ ./LICENSE 2016-03-10 19:30:26.631146593 -0600
|
| |
- @@ -0,0 +1,22 @@
|
| |
- +The MIT License (MIT)
|
| |
- +
|
| |
- +Copyright (c) 2015 Juan Potato
|
| |
- +All rights reserved
|
| |
- +
|
| |
- +Permission is hereby granted, free of charge, to any person obtaining a copy
|
| |
- +of this software and associated documentation files (the "Software"), to deal
|
| |
- +in the Software without restriction, including without limitation the rights
|
| |
- +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
| |
- +copies of the Software, and to permit persons to whom the Software is
|
| |
- +furnished to do so, subject to the following conditions:
|
| |
- +
|
| |
- +The above copyright notice and this permission notice shall be included in all
|
| |
- +copies or substantial portions of the Software.
|
| |
- +
|
| |
- +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
| |
- +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
| |
- +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
| |
- +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
| |
- +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
| |
- +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
| |
- +SOFTWARE.
|
| |
- diff -urN ../legofy-origen/README.md ./README.md
|
| |
- --- ../legofy-origen/README.md 1969-12-31 18:00:00.000000000 -0600
|
| |
- +++ ./README.md 2016-03-10 19:31:46.633962174 -0600
|
| |
- @@ -0,0 +1,78 @@
|
| |
- +# Legofy [![Build Status](https://travis-ci.org/JuanPotato/Legofy.svg?branch=master)](https://travis-ci.org/JuanPotato/Legofy) [![PyPI Downloads](https://img.shields.io/pypi/dm/legofy.svg)](https://pypi.python.org/pypi/legofy) [![PyPI version](https://img.shields.io/pypi/v/legofy.svg)](https://pypi.python.org/pypi/legofy) [![License](https://img.shields.io/pypi/l/legofy.svg)](https://pypi.python.org/pypi/legofy) [![Coverage Status](https://coveralls.io/repos/JuanPotato/Legofy/badge.svg?branch=master&service=github)](https://coveralls.io/github/JuanPotato/Legofy?branch=master) [![Code Health](https://landscape.io/github/JuanPotato/Legofy/master/landscape.svg?style=flat)](https://landscape.io/github/JuanPotato/Legofy/master) [![Join the chat at https://gitter.im/JuanPotato/Legofy](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/JuanPotato/Legofy?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
| |
- +
|
| |
- +
|
| |
- +### What is it?
|
| |
- +Legofy is a python program that takes a static image or gif and makes it so that it looks as if it was built out of LEGO.
|
| |
- +
|
| |
- +<a href="https://commons.wikimedia.org/wiki/File:Zoysia_grass_flower.jpg">
|
| |
- +<img alt="Before" title="Before (The inflorescence of Zoysia grass, a variety of lawn grass. Picture by Hari Krishnan)" height="500" src="legofy/assets/flower.jpg?raw=true">
|
| |
- +</a>
|
| |
- +<img alt="After" title="After" height="500" src="legofy/assets/flower_lego.png?raw=true">
|
| |
- +
|
| |
- +
|
| |
- +### Requirements
|
| |
- +* Python
|
| |
- +* Python modules: Pillow, click # pip will install these automatically if using `pip install legofy`
|
| |
- +* imagemagick # not needed but recommended
|
| |
- +
|
| |
- +### Bugs
|
| |
- +If you find a bug:
|
| |
- + 1. Check in the [open issues](https://github.com/JuanPotato/Legofy/issues) if the bug already exists.
|
| |
- + 2. If the bug is not there, create a [new issue](https://github.com/JuanPotato/Legofy/issues/new) with clear steps on how to reproduce it.
|
| |
- +
|
| |
- +### Quickstart
|
| |
- +```shell
|
| |
- +$ pip install legofy
|
| |
- +```
|
| |
- +or install from source
|
| |
- +```shell
|
| |
- +$ git clone https://github.com/JuanPotato/Legofy.git
|
| |
- +$ cd Legofy
|
| |
- +$ python setup.py install
|
| |
- +```
|
| |
- +Wait! I don't know what any of this means? Use pip then, or if you really want to install from source [have some help.](#installation)
|
| |
- +
|
| |
- +### Usage
|
| |
- +```
|
| |
- +Usage: legofy [OPTIONS] IMAGE [OUTPUT]
|
| |
- +
|
| |
- + Legofy an image!
|
| |
- +
|
| |
- +Options:
|
| |
- + --size INTEGER Number of bricks the longest side of the legofied image should have.
|
| |
- + --dither / --no-dither Use dither algorithm to spread the color approximation error.
|
| |
- + --palette [all|effects|mono|solid|transparent]
|
| |
- + Palette to use based on real Lego colors.
|
| |
- + --help Show this message and exit.
|
| |
- +```
|
| |
- +
|
| |
- +#### Palette
|
| |
- +There are 3 palettes: solid (33 colors), transparent (14 colors) and effects (4 colors).
|
| |
- +You can use one of them or all the 3.
|
| |
- +```shell
|
| |
- +$ legofy --palette solid image.jpg
|
| |
- +$ legofy --palette transparent image.jpg
|
| |
- +$ legofy --palette effects image.jpg
|
| |
- +$ legofy --palette all image.jpg
|
| |
- +```
|
| |
- +There is another one palette, mono, with only 2 colors (black and white...). It's just for test and fun...
|
| |
- +
|
| |
- +
|
| |
- +### Troubleshooting
|
| |
- + * [Mac](http://pillow.readthedocs.org/en/3.0.x/installation.html#os-x-installation)
|
| |
- + * [Linux](http://pillow.readthedocs.org/en/3.0.x/installation.html#linux-installation)
|
| |
- + * [Windows](http://pillow.readthedocs.org/en/3.0.x/installation.html#windows-installation)
|
| |
- +
|
| |
- +### Installation
|
| |
- +1. Download and install all requirements
|
| |
- + * python from the [official python website](https://www.python.org/)
|
| |
- + * imagemagick from the [official imagemagick website](https://imagemagick.org/)
|
| |
- +2. Download this project by using the download zip button on this page, or running `git clone https://github.com/JuanPotato/Legofy`
|
| |
- + * If you downloaded a zip file, please unzip it
|
| |
- +3. Open a command line and navigate to the project folder
|
| |
- +4. Run `python setup.py install` while in the project folder
|
| |
- +5. You can now use Legofy anywhere, see [usage](#usage) for more help
|
| |
- +
|
| |
- +### Forks
|
| |
- +
|
| |
- +* JavaScript: [Legofy](https://github.com/Wildhoney/Legofy)
|
| |
%autorelease
and%autochangelog
%pyproject
macros