halftone

KO | EN

gitlite — search

#hacktoberfest #go #android #machine-learning #deep-learning #docker #java #awesome #awesome-list #vue #security #openai #ios #open-source

(★ 33)

The simplest halftone image maker out there!

halftone 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">Halftone</h1>

This is a very simple python program that uses [open cv](https://docs.opencv.org/master/index.html) to generate images using the [halftone technique](https://en.wikipedia.org/wiki/Halftone).

*(If you like this repo, you may also like [this one](https://github.com/GravO8/halftone-lines))*

# Command line usage

Put the source image in the same directory as halftone.py and call it like so:

`python3 halftone.py woman.jpg`

![command-line-usage](https://user-images.githubusercontent.com/25433159/81508242-f51cb500-92fa-11ea-9bf2-14ce45190288.jpg)

You can also learn about the [optional arguments](#optional-arguments), doing so: `python3 halftone.py -h`

# Calling from another module

```python
import halftone

halftone.halftone("woman.jpg")
```

Learn more about the methods' signature and behaviour with `python3 -m pydoc halftone`

# Optional arguments

## Side

The generated image is composed of squares with dots in them. This optional argument specifies how big each of these squares can be.

As you can see from the generated images below, when all other parameters are constant, as you increase `size` the image becomes more smooth (because each individual dot gets smoother). (below each output image is its corresponding `size` and dimensions)

![side-variation](https://user-images.githubusercontent.com/25433159/81510498-f6a1a980-9309-11ea-8484-74d2c36a5986.jpg)

If you set `side = 1`, you won't get very good results (because each square will effectively be just one pixel).

If you set `side = 2` each square will be 2 pixels wide and although you probably won't get a very clear image, you get a cool looking texture if you zoom in enough.

Values of `side` that are too large create big images that may take a while to generate.

The default `side` value is 20 pixels because from my experience playing with this variable, 20 gives you a nice equilibrium between image size and image smoothness.

## Jump

The generated image is created from an input image which is scanned left to right, top to bottom. Instead of scanning the image pixel by pixel, the image is scanned in blocks, i.e. squares that are `jump` pixels wide. Each of these blocks will be converted into a dot in the output image.

As you can see from the images below, when all other parameters are constant, as you increase `jump` the image becomes less clear because bigger blocks are being condensed to the same space (`size` is constant). (below each output image is its corresponding `jump` and dimensions)

![jump-variation](https://user-images.githubusercontent.com/25433159/81511641-a1b66100-9312-11ea-95ee-5ab34feb68c0.jpg)

The higher the value of `jump`, the lower the number of dots in the output image will be (in fact, if you set this value high enough, the output picture will be a single dot).

If you set `jump = 1`, you're forcing the program to create a dot for each pixel in the original image (!) which will take forever and generate huge output images.

## Colors

`bg_color` sets the background color of the output image.

`fg_color` sets the foreground color of the output image, i.e. the color of the dots.

Below are some examples of what you can achieve playing with these values.

I recommend using a light color for the background and a dark color for the foreground; otherwise the image will look... weird. That's why the default color for `bg_color` is white, and default color for `fg_color` is black.

If you are calling the program using the command line interface, you have to specify the color like so: `python3 halftone.py woman.jpg -fg '(255,0,0)'` (using `''` to delimit the rgb value).

If you are calling the program from another module, this optional argument is a tuple, so you specify it like so: `halftone.halftone("woman.jpg", fg_color = (255,0,0))`.

## Alpha

Each dot is drawn in a `side` pixels wide square. If `alpha = 1`, each dot's radius will never be greater than `side` (i.e. at most, the dots are inscribed in their squares). When the dots' size is limited like this, the output image can look a bit faded, as you can see from the images below.

(below each output image is its corresponding `alpha`; the dimensions were omitted because changing `alpha` doesn't affect the image size)

![alpha-variation](https://user-images.githubusercontent.com/25433159/81931225-aa908680-95e1-11ea-8e2a-dd920d3dfb94.jpg)

If you set `alpha = 0`, the output image will have no dots (their radius will all be 0).

# Original image credits

The photo I've been using is called **Woman in White Robe Smiling** and you can see the original version [here](https://www.pexels.com/photo/woman-in-white-robe-smiling-4156467/). Check out this photo's original photographer [here](https://www.pexels.com/@breston-kenya-477564).

# License

This program is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

halftone

halftone 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

halftone

halftone 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README