Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rtmigo/img2texture

CLI for converting images to seamless tiles
https://github.com/rtmigo/img2texture

3d alpha blending cli gradient image image-processing imaging jpeg jpg overlay pattern photo pil python raster seamless texture tile tileable

Last synced: 21 days ago
JSON representation

CLI for converting images to seamless tiles

Host: GitHub
URL: https://github.com/rtmigo/img2texture
Owner: rtmigo
License: mit
Created: 2021-09-23T00:01:22.000Z (over 3 years ago)
Default Branch: master
Last Pushed: 2023-10-07T14:57:52.000Z (over 1 year ago)
Last Synced: 2024-12-31T10:35:30.055Z (22 days ago)
Topics: 3d, alpha, blending, cli, gradient, image, image-processing, imaging, jpeg, jpg, overlay, pattern, photo, pil, python, raster, seamless, texture, tile, tileable
Language: Python
Homepage: https://pypi.org/project/img2texture
Size: 2.05 MB
Stars: 78
Watchers: 3
Forks: 13
Open Issues: 1
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

        [![PyPI version shields.io](https://img.shields.io/pypi/v/img2texture.svg)](https://pypi.python.org/pypi/img2texture/)

[![Generic badge](https://img.shields.io/badge/Python-3.8+-blue.svg)](#)

[![Generic badge](https://img.shields.io/badge/OS-Windows%20|%20macOS%20|%20Linux-blue.svg)](#)

[![Downloads](https://pepy.tech/badge/img2texture/month)](https://pepy.tech/project/img2texture)

# [img2texture](https://github.com/rtmigo/img2texture#readme)

Command line utility for converting images to seamless tiles.

It overlays images with an alpha gradient.

The resulting tiles can be used as textures in games, compositing and 3D modeling applications, etc.

*⚠️ If the images below are not displayed, check out the 

[original of this document on GitHub](https://github.com/rtmigo/img2texture#readme).*

### Original image x4

![Source tiled](docs/1_orion_src_2x2.jpg)

Orion galaxy by NASA/ESA, in four copies side by side. 

We cannot use the original image as an endless space background: the seams are visible.

### Converted image x4

![Converted tiled](docs/2_orion_seamless_2x2.jpg)

The result of `img2texture`, in four copies side by side. 

The image is slightly reduced in size and the edges are modified with 

alpha-blending.

The converted image can be tiled and panned in any 

direction. It will feel endless and seamless.

# Install

The easiest way is to download and extract a [binary executable](https://github.com/rtmigo/img2texture/releases):

* [for macOS](https://github.com/rtmigo/img2texture/releases/latest/download/img2texture_darwin_amd64.tgz)

* [for Linux](https://github.com/rtmigo/img2texture/releases/latest/download/img2texture_linux_amd64.tgz)

* [for Windows](https://github.com/rtmigo/img2texture/releases/latest/download/img2texture_windows_amd64.zip)

Or install as a Python package:

```bash

pip3 install img2texture

```

# Run

Create new `seamless.jpg` from `source.jpg`.

```bash

img2texture /path/to/source.jpg /path/to/seamless.jpg 

```

## --overlap

The `--overlap` option determines how much of the image will be used to hide the seams.

For example, the following command uses 25% of the width and 25% of the height 

of the original image:

```bash

img2texture source.jpg seamless.jpg --overlap 0.25 

```

Increasing the value makes the seam less visible. However, the image becomes smaller.

  Sample images

*⚠️ If the images below are not displayed, check out the 

[original of this document on GitHub](https://github.com/rtmigo/img2texture#readme).*

### --overlap 0.05

5% of the width and 5% of the height are used to mask the seam.

![--overlap 0.05](docs/3_orion_05_2x2.jpg)

### --overlap 0.4

40% of the width and 40% of the height are used to mask the seam.

![--overlap 40](docs/3_orion_40_2x2.jpg)

## --tile

The `--tile` option will create a 2x2 tiled version in addition to the converted image.

The following command will create `seamless.jpg` and `seamless_2x2.jpg`. 

```bash

img2texture source.jpg seamless.jpg --tile 

```

All the samples on this page were created with `--tile`.

# Use programmatically

If you don't need CLI but need to create seamless image in your own program:

```python3

from PIL import Image

from img2texture import image_to_seamless

# load PIL image

src_image = Image.open("/path/to/source.png")

# convert to seamless PIL image

result_image = image_to_seamless(src_image, overlap=0.1)

# save

result_image.save("/path/to/result.png")

```

`overlap=0.1` means 10%, and `overlap=(0.1, 0.2)` means 10% horizontal, 20% vertical. 

# License

Copyright © 2021 [Artёm iG](https://github.com/rtmigo).

Released under the [MIT License](LICENSE).