img2texture
Command line utility for converting images to seamless tiles.
The resulting tiles can be used as textures in games, compositing and 3D modeling applications, etc.
Sample images
Original image x4
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
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
$ pip3 install img2texture
Run
Create new seamless.jpg from source.jpg.
$ 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:
$ img2texture source.jpg seamless.jpg --overlap 0.25
Increasing the value makes the seam less visible. However, the image becomes smaller.
Sample images
--overlap 0.05
5% of the width and 5% of the height are used to mask the seam.
--overlap 0.4
40% of the width and 40% of the height are used to mask the seam.
--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.
$ img2texture source.jpg seamless.jpg --tile
All the samples on this page were created with --tile.
907 Jan 4, 2023
6 Oct 27, 2022
30 Dec 31, 2022
4 May 18, 2022
5 Apr 9, 2022
24 Dec 14, 2022
2.6k Dec 30, 2022
7 Jul 25, 2022
546 Jan 3, 2023
27 Dec 28, 2022
12 Dec 23, 2022
2 Oct 12, 2021
2 Apr 05, 2022
10.4k Dec 31, 2022
18 Nov 13, 2022
6 Oct 20, 2021
2 Nov 22, 2021
4 Jan 11, 2022
15 Nov 10, 2022
1 Nov 30, 2021
6 Oct 22, 2021
88 Dec 15, 2022
7 Oct 29, 2022
3 Dec 10, 2021
2 Mar 07, 2022
1.8k Jan 02, 2023
8 Sep 21, 2022
4 Feb 10, 2022
15 Dec 28, 2022