aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/README.md
blob: d389656203f343d6d692f671f24a4971ce1d7ede (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
Simple image filters
====================

A collection of simple image processing utilities using basic convolution
matrices.

Prerequisites
-------------

* Python 3.4 or higher
* [numpy]
* [opencv-python]

The versions below have been verified to work properly.

| Software      | Version
| ------------- | -------
| CPython       | 3.5.1
| numpy         | 1.11.0
| opencv-python | 3.1.0

[numpy]: http://www.numpy.org/
[opencv-python]: http://opencv.org/

Windows binaries for CPython can be acquired at
http://www.lfd.uci.edu/~gohlke/pythonlibs/.

OpenCV's Python bindings require [Visual C++ Redistributable for Visual Studio
2015] on Windows.

[Visual C++ Redistributable for Visual Studio 2015]: https://www.microsoft.com/en-us/download/details.aspx?id=48145

Usage
-----

Run the scripts from the top-level directory using `python -m`.
Pass the `--help` flag to a script to examine its detailed usage information.

For example (using Windows-style paths):

    > python -m bin.box_blur img\Lenna.png --radius 3

The complete list of usable scripts is given below.

* box_blur.py — Apply box blur to an image.
* gaussian_blur.py — Apply Gaussian blur to an image.
* shift.py — Shift an image by a few pixels in a specified direction.

Development
-----------

### Linting

Requires [Pylint].
To lint everything, run from the top-level directory:

    > pylint filters
    ...

    > pylint bin
    ...

[Pylint]: https://www.pylint.org/

License
-------

Distributed under the MIT License.
See [LICENSE.txt] for details.

[LICENSE.txt]: LICENSE.txt