gui1ty / rpms / legofy

Forked from rpms/legofy 7 months ago
Clone
Blob Blame History Raw
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)