From efd0addcd07923ee23e31ff3032ae43b8fdcda53 Mon Sep 17 00:00:00 2001 From: lesageethan Date: Sun, 24 Dec 2023 14:24:38 +0000 Subject: [PATCH 1/3] Added support for images with transparent pixels. Also added black and white mode --- README.rst | 12 ++++++------ examples/david_crop-bw.png | Bin 0 -> 5011 bytes examples/david_crop-colour.png | Bin 0 -> 24339 bytes examples/david_crop.png | Bin 0 -> 54529 bytes main.py | 26 +++++++++++++++++++------- 5 files changed, 25 insertions(+), 13 deletions(-) create mode 100644 examples/david_crop-bw.png create mode 100644 examples/david_crop-colour.png create mode 100644 examples/david_crop.png diff --git a/README.rst b/README.rst index 3da0123..55bbd54 100644 --- a/README.rst +++ b/README.rst @@ -1,9 +1,9 @@ -qwer -==== +# qwer -Floyd-Steinberg dithering in python +This script accomplishes [Floyd-Steinberg dithering](https://en.wikipedia.org/wiki/Floyd%E2%80%93Steinberg_dithering) in Python. Takes inputs as bitmap or png files. -Usage ------ +# Usage -``qwer lena.bmp -o lena.png`` +To use the script in colour, write as follows: ``qwer lena.bmp -o lena.png`` + +If you wish to use the script in black and white: ``qwer lena.bmp -o lena.png --bw`` diff --git a/examples/david_crop-bw.png b/examples/david_crop-bw.png new file mode 100644 index 0000000000000000000000000000000000000000..d23e369b9d85ff5d3b40927060836e0c63313d35 GIT binary patch literal 5011 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 literal 0 HcmV?d00001 diff --git a/examples/david_crop-colour.png b/examples/david_crop-colour.png new file mode 100644 index 0000000000000000000000000000000000000000..b4b1ba91dca6e067dd88238ee5a07d5e5b9bbb9d GIT binary patch literal 24339 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�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 Date: Sun, 24 Dec 2023 14:25:35 +0000 Subject: [PATCH 2/3] Changed README file --- README.rst => README.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename README.rst => README.md (100%) diff --git a/README.rst b/README.md similarity index 100% rename from README.rst rename to README.md From 105a2bbda52e2b2b3faa1dac39b47628f855d437 Mon Sep 17 00:00:00 2001 From: lesageethan Date: Sun, 24 Dec 2023 14:30:55 +0000 Subject: [PATCH 3/3] Added README explanation --- README.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 55bbd54..b392365 100644 --- a/README.md +++ b/README.md @@ -2,8 +2,14 @@ This script accomplishes [Floyd-Steinberg dithering](https://en.wikipedia.org/wiki/Floyd%E2%80%93Steinberg_dithering) in Python. Takes inputs as bitmap or png files. -# Usage +It is extremely useful for compression, especially the 1-bit ``--bw`` mode. In testing, this script in black and white mode was able to reduce 181x215 pixel image from 53.2KB to 4.89KB, albeit with all colour lost. Colour (default) mode reduced the image to 23.7KB. -To use the script in colour, write as follows: ``qwer lena.bmp -o lena.png`` +## Usage -If you wish to use the script in black and white: ``qwer lena.bmp -o lena.png --bw`` +To use the script in colour, write as follows: ``python main.py lena.bmp -o lena.png`` + +If you wish to use the script in black and white: ``python main.py -o lena.png --bw`` + +## Creds + +This script was originally created by [trimailov](https://github.com/trimailov). [lesageethan](https://github.com/lesageethan) added the 1-bit mode and transparency support. \ No newline at end of file