From 57667f14afb5eb850832b919acd921393ea3bed8 Mon Sep 17 00:00:00 2001
From: Domino Goupil <1er@live.ca>
Date: Fri, 4 Oct 2019 03:58:00 -0400
Subject: [PATCH 1/5] Add CLI arguments and avoid temp files

---
 README.md | 61 ++++++++-----------------------------------------------
 bleed.sh  | 25 ++++++++++++++++++++---
 2 files changed, 31 insertions(+), 55 deletions(-)

diff --git a/README.md b/README.md
index 552d474..3ea3183 100644
--- a/README.md
+++ b/README.md
@@ -1,62 +1,19 @@
 # tile-bleed-margin-generator
-Automatically stretch out the 1px edge of each tile in a sprite sheet to compensate for tile bleed in 2D game development.
 
-## bleed.sh
+Automatically stretch out the 1px edge of each tile in a tile sheet to compensate for tile bleed in 2D game development.
 
-Change the script to be specific to your case.
+This should solve rounding errors which can cause tiles to slightly bleed into their neighbors, such as the very common "gap between tiles" problem in Unity.
 
-### You'll need to figure out a few things:
+## Dependencies
 
-1. First you need to know how big your tiles are; mine are *16x16* (`TILE_SIZE = 16`)
-2. then how big your spritesheet is; mine is *640x576* (`SPRITESHEET_WIDTH = 640`, `SPRITESHEET_HEIGHT = 576`)
-3. How many columns there are:
-```
-COLUMN_COUNT = (SPRITESHEET_WIDTH / TILE_SIZE)
-```
+This script depends on ImageMagick (tested using ImageMagick 7). `convert`, `montage` and `identify` must be in your PATH.
 
-so mine is: `(640/16)`
+Until someone makes a Windows version (`.cmd` or `.ps`) you should be able to run it using bash in the Windows Subsystem for Linux.
 
-4. How many rows there are:
+## Sample usage
 
-```
-ROW_COUNT = (SPRITESHEET_HEIGHT / TILE_SIZE)
-```
+    ./bleed.sh input.png output.png 16
 
-so mine is: `(576/16)`
+...where `input.png` is a tile sheet with 16x16 tiles without any gap between tiles. If your tiles are not square, you can specify a tile height as a 4th argument.
 
-5. How many tiles are in the spritesheet:
-
-```
-NUMBER_OF_TILES = COLUMN_COUNT * ROW_COUNT
-```
-
-so in my case I had to do: `(640/16)*(576/16)` which is 1440.
-
-```
-NUMBER_OF_TILES = 1440
-```
-
-6. You need the file name of the spritesheet too.
-
-That's all you need. so now:
-
-### Modify the script to your case
-
-1. Change all instances of `16` to your `TILE_SIZE`
-2. Change `spritesheet.png` to your file
-3. Change all instances of `1439` to your `NUMBER_OF_TILES - 1` so in my case it was *`1439`* instead of `1440`. (This is due to indexing starting at 0)
-4. Change all instances of `48` to your `TILESIZE` multiplied by 3 (`TILESIZE * 3` so mine was `16*3`)
-5. Change all instances of `40` to your `COLUMN_COUNT`
-6. Change all instances of `36` to your `ROW_COUNT`
-
-Make sure your script is in the same directory as the file, open Terminal and `cd` to this folder and run:
-
-`sh bleed.sh`
-
-you should now have loads of files, but the only one you are interested in is:
-
-`spritesheet-bleed.png`
-
-## TODO: Improvements
-
-Make all of these calculations automatic and based on arguments.
+The resulting `output.png` can then be used by some game engines specifying a 2px gap between tiles, and perhaps 1px offset from the top left corner for the first tile.
diff --git a/bleed.sh b/bleed.sh
index 4f3a6ce..d331da6 100644
--- a/bleed.sh
+++ b/bleed.sh
@@ -1,3 +1,22 @@
-convert -crop 16x16 spritesheet.png sprite.png
-convert sprite-{0..1439}.png -set option:distort:viewport 48x48-16-16 -virtual-pixel Edge -filter point -distort SRT 0 +repage sprite-bleed.png
-montage sprite-bleed-{0..1439}.png -tile 40x36 -geometry 48x48+0+0 -background none spritesheet-bleed.png
+#!/bin/bash
+
+if [ $# -lt 3 ]
+  then
+    echo "usage: SOURCE DESTINATION TILEWIDTH [TILEHEIGHT]"
+    exit
+fi
+
+sourcepath=$1
+destpath=$2
+tilew=$3
+tileh=${4:-$3}
+
+sourcew=`identify -format %w $sourcepath`
+sourceh=`identify -format %h $sourcepath`
+columns=$(($sourcew / $tilew))
+rows=$(($sourceh / $tileh))
+newtilew=$(($tilew + 2))
+newtileh=$(($tileh + 2))
+
+convert -crop ${tilew}x${tileh} $sourcepath -define distort:viewport=${newtilew}x${newtileh}-1-1 -filter point -distort SRT 0 +repage miff:- |
+montage - -tile ${columns}x${rows} -geometry +0+0 -background none $destpath

From f235d5722ff71c7f660a58902b5c11f94e444ee9 Mon Sep 17 00:00:00 2001
From: Domino Goupil <1er@live.ca>
Date: Thu, 10 Oct 2019 17:01:51 -0400
Subject: [PATCH 2/5] Better CLI, custom gaps, bleed and margins

---
 README.md  |  15 ++--
 bleed.sh   | 236 +++++++++++++++++++++++++++++++++++++++++++++++++----
 input.png  | Bin 0 -> 4807 bytes
 output.png | Bin 0 -> 434 bytes
 4 files changed, 229 insertions(+), 22 deletions(-)
 create mode 100644 input.png
 create mode 100644 output.png

diff --git a/README.md b/README.md
index 3ea3183..0ccead9 100644
--- a/README.md
+++ b/README.md
@@ -2,18 +2,21 @@
 
 Automatically stretch out the 1px edge of each tile in a tile sheet to compensate for tile bleed in 2D game development.
 
-This should solve rounding errors which can cause tiles to slightly bleed into their neighbors, such as the very common "gap between tiles" problem in Unity.
+This should solve rounding errors which can cause tiles to slightly bleed into their neighbors, such as the very common "gap between tiles" problem in Unity. The script was forked cjonasw's but I added so many features that it ended up quite different from the original.
 
 ## Dependencies
 
-This script depends on ImageMagick (tested using ImageMagick 7). `convert`, `montage` and `identify` must be in your PATH.
+This script was written for bash and depends on ImageMagick (tested using `ImageMagick 6.9.7-4`). The `convert`, `montage` and `identify` commands must be in your PATH.
 
-Until someone makes a Windows version (`.cmd` or `.ps`) you should be able to run it using bash in the Windows Subsystem for Linux.
+Until someone makes a Windows version (`.cmd` or `.ps`) you should be able to run it on Windows 10 using bash in the Windows Subsystem for Linux, provided you've installed ImageMagick within your virtual linux.
 
 ## Sample usage
 
-    ./bleed.sh input.png output.png 16
+    ./bleed.sh input.png output.png --tile-size 16 16 --bleed 3 --input-gap 4 4 --output-gap 1 1 --input-offset 20 20 --output-offset 3 3
 
-...where `input.png` is a tile sheet with 16x16 tiles without any gap between tiles. If your tiles are not square, you can specify a tile height as a 4th argument.
+The script determines the number of tiles based on the size of the file. It ignores content above and the the left of the specified `--input-offset`, and any leftover space that is smaller than a tile on the bottom right. See the sample files in the repository.
 
-The resulting `output.png` can then be used by some game engines specifying a 2px gap between tiles, and perhaps 1px offset from the top left corner for the first tile.
+## Known issues
+
+-   Unknown options or options with the wrong number of parameters produce unclear error messages.
+-   The `--help` flag doesn't work properly because the command fails on missing arguments first. Mitigated by showing the usage on missing arguments.
\ No newline at end of file
diff --git a/bleed.sh b/bleed.sh
index d331da6..e78665a 100644
--- a/bleed.sh
+++ b/bleed.sh
@@ -1,22 +1,226 @@
 #!/bin/bash
 
-if [ $# -lt 3 ]
-  then
-    echo "usage: SOURCE DESTINATION TILEWIDTH [TILEHEIGHT]"
-    exit
+usage() {
+	cat <<-EOM
+		Usage: bleed INPUT_FILE OUTPUT_FILE [OPTIONS...]
+		
+		Extends the edge of of every tile in a tileset by 1px to avoid issues with
+		neighboring tile bleeding and gaps between rendered tiles.
+		
+		Tested with ImageMagick 6.9.7-4
+		
+		Options must appear after the positional arguments:
+		  -t, --tile-size XX YY         the size of the tiles
+		                                (defaults to 16x16)
+		  -b, --bleed XX                how much bleeding should be produced around
+		                                each generated tile
+		                                (defaults to 1)
+		  -g, --input-gap XX YY         the horizontal and vertical gap between
+		                                tiles in the input image
+		                                (defaults to 0x0)
+		  -o, --input-offset XX YY      the offset of the first tile from the
+		                                top left corner of the input image
+		                                (defaults to 0x0)
+		  -G, --output-gap XX YY        the horizontal and vertical gap to leave
+		                                between tiles in the output image as
+		                                transparent pixels
+		                                (defaults to 0x0)
+		  -O, --output-offset XX YY     the margins added to the output image
+		                                (defaults to 0x0)
+		  -f, --force					overwrite the output file if it exists
+		  -v, --verbose                 display computations during execution
+		  -h, --help                    display this help text and exit
+	EOM
+}
+
+
+#### INITIALIZE VARIABLES
+
+positional_args=()
+
+input_path=
+input_tile_width=16
+input_tile_height=16
+input_offset_x=0
+input_offset_y=0
+input_gap_x=0
+input_gap_y=0
+
+output_path=
+output_offset_x=0
+output_offset_y=0
+output_gap_x=0
+output_gap_y=0
+output_bleed=1
+
+
+#### PARSE ARGUMENTS
+
+if [[ $# -lt 2 ]] ; then
+	echo "Missing arguments."
+	usage
+	exit 1
+fi
+
+input_path=$1
+shift
+output_path=$1
+shift
+
+while [[ $# > 0 ]] ; do
+	case $1 in
+		-t | --tile-size )
+			shift
+			input_tile_width=$1
+			shift
+			input_tile_height=$1
+			;;
+		-b | --bleed )
+			shift
+			output_bleed=$1
+			;;
+		-g | --input-gap )
+			shift
+			input_gap_x=$1
+			shift
+			input_gap_y=$1
+			;;
+		-o | --input-offset )
+			shift
+			input_offset_x=$1
+			shift
+			input_offset_y=$1
+			;;
+		-G | --output-gap )
+			shift
+			output_gap_x=$1
+			shift
+			output_gap_y=$1
+			;;
+		-O | --output-offset )
+			shift
+			output_offset_x=$1
+			shift
+			output_offset_y=$1
+			;;
+		-f | --force )
+			force=true
+			;;
+		-v | --verbose )
+			verbose=true
+			;;
+		-fv | -vf )
+			force=true
+			verbose=true
+			;;
+		-h | --help )
+			usage
+			exit
+			;;
+		* )
+			# todo: make sure --help flag is always checked
+			echo "Incorrect option sequence." >&2
+			usage >&2
+			exit 1
+	esac
+	shift
+done
+
+
+#### VALIDATE ARGUMENTS
+
+if [[ ! -f $input_path ]] ; then
+	echo "Input file not found." >&2; exit 1
+fi
+
+if [[ -e $output_path && $force != true ]] ; then
+	echo "A file with the specified output path already exists." >&2; exit 1
 fi
 
-sourcepath=$1
-destpath=$2
-tilew=$3
-tileh=${4:-$3}
+int_regex='^[0-9]+$'
+assert_int() {
+	if ! [[ $2 =~ $int_regex ]] ; then
+		echo "$1 must be an integer" >&2; exit 1
+	fi
+}
+assert_coords() {
+	if ! [[ $2 =~ $int_regex && $3 =~ $int_regex ]] ; then
+		echo "$1 must be two integers separated by a space" >&2; exit 1
+	fi
+}
+
+assert_coords "--tile-size" $input_tile_width $input_tile_height
+assert_int "--bleed" $output_bleed
+assert_coords "--input-gap" $input_gap_x $input_gap_y
+assert_coords "--input-offset" $input_offset_x $input_offset_y
+assert_coords "--output-gap" $output_gap_x $output_gap_y
+assert_coords "--output-offset" $output_offset_x $output_offset_y
+
+
+#### BEGIN COMPUTATION
+
+# ENABLE VERBOSE MODE IF DESIRED
+if [[ $verbose == true ]] ; then
+	set -x
+fi
+
+# GET IMAGE SIZE
+input_file_width=`identify -format %w $input_path`
+input_file_height=`identify -format %h $input_path`
+
+# CROP MARGINS
+input_right_margin=$(( ($input_file_width + $input_gap_x - $input_offset_x) % ($input_tile_width + $input_gap_x) ))
+input_bottom_margin=$(( ($input_file_height + $input_gap_y - $input_offset_y) % ($input_tile_height + $input_gap_y) ))
+input_usefull_width=$(( $input_file_width - $input_offset_x - $input_right_margin ))
+input_usefull_height=$(( $input_file_height - $input_offset_y - $input_bottom_margin ))
+crop_margins_geometry="${input_usefull_width}x${input_usefull_height}+${input_offset_x}+${input_offset_y}"
+
+# SLICE INTO TILES
+slice_width=$(($input_tile_width + $input_gap_x))
+slice_height=$(($input_tile_height + $input_gap_y))
+slice_to_tiles_geometry="${slice_width}x${slice_height}"
+
+# REMOVE TILE GAP
+crop_tile_gap_geometry="${input_tile_width}x${input_tile_width}+0+0"
+
+# ADD BLEEDING
+bleeding_width=$(($input_tile_width + (2 * $output_bleed) ))
+bleeding_height=$(($input_tile_height + (2 * $output_bleed) ))
+distort_bleed_geometry="${bleeding_width}x${bleeding_height}-${output_bleed}-${output_bleed}"
+
+# ADD TILE GAP
+output_tile_width=$(($bleeding_width + $output_gap_x ))
+output_tile_height=$(($bleeding_height + $output_gap_y ))
+output_tile_geometry="${output_tile_width}x${output_tile_height}+0+0"
+
+# MERGE TILES
+columns=$(( ($input_file_width + $input_gap_x - $input_offset_x) / ($input_tile_width + $input_gap_x) ))
+rows=$(( ($input_file_height + $input_gap_y - $input_offset_y) / ($input_tile_height + $input_gap_y) ))
+
+# REMOVE LAST GAP
+output_usefull_width=$(( ($output_tile_width * $columns) - $output_gap_x ))
+output_usefull_height=$(( ($output_tile_height * $rows) - $output_gap_y ))
+crop_extra_gap_geometry="${output_usefull_width}x${output_usefull_height}+0+0"
+
+# ADD MARGIN
+output_total_width=$(($output_usefull_width + (2 * $output_offset_x) ))
+output_total_height=$(($output_usefull_height + (2 * $output_offset_y) ))
+output_size_geometry="${output_total_width}x${output_total_height}"
+
+# DISABLE VERBOSE OUTPUT
+{ set +x; } 2>/dev/null
+
 
-sourcew=`identify -format %w $sourcepath`
-sourceh=`identify -format %h $sourcepath`
-columns=$(($sourcew / $tilew))
-rows=$(($sourceh / $tileh))
-newtilew=$(($tilew + 2))
-newtileh=$(($tileh + 2))
+#### SUBMIT TASK TO IMAGEMAGICK
 
-convert -crop ${tilew}x${tileh} $sourcepath -define distort:viewport=${newtilew}x${newtileh}-1-1 -filter point -distort SRT 0 +repage miff:- |
-montage - -tile ${columns}x${rows} -geometry +0+0 -background none $destpath
+convert $input_path \
+	-crop $crop_margins_geometry +repage +gravity \
+	-crop $slice_to_tiles_geometry +repage \
+	-crop $crop_tile_gap_geometry +repage \
+	-define distort:viewport=$distort_bleed_geometry -filter point -distort SRT 0 +repage \
+	-background none -extent $output_tile_geometry miff:- |
+montage - -tile ${columns}x${rows} -geometry +0+0 -background none +repage miff:- |
+convert - \
+	-crop $crop_extra_gap_geometry +repage \
+	-gravity center -background none -extent $output_size_geometry \
+	$output_path
\ No newline at end of file
diff --git a/input.png b/input.png
new file mode 100644
index 0000000000000000000000000000000000000000..8dee02ca0029b68858c1a13fb2acca16ce44f455
GIT binary patch
literal 4807
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

literal 0
HcmV?d00001

diff --git a/output.png b/output.png
new file mode 100644
index 0000000000000000000000000000000000000000..e5e44184dba59297efc5b5bf880115cb90bea2f7
GIT binary patch
literal 434
zcmeAS@N?(olHy`uVBq!ia0vp^i9qbd!2%>1Q$F1VQY`6?zK#qG8~eHcB(ehe3dtTp
zz6=aiY77hwEes65fI<x~7#K<o7#Ln9FfdrnU|<k0n6oR;1}MRl<n8Xlz_6-U*$BvE
zFY)wsWq-`YC1B1Ztrn>W6x!wK;uw-~@9m9)T+Ido3>SNU{NKMuTwhg-P1ri}S*%yL
zZcpdJoR%w&mT}vcz3<tx>*l5Z>uS!jG=2U4_U^W|+h3koJ%4rBLKm0LPp{nfZ=F|v
zr>Nu4?W3CwE^Ec8EQx5X3^{*Dtaxpsx=^#a5Ri1-SHCJ(I^)UJ^QsZ7!dF_IC76Uc
zjQA3tB{Ma0vZx8na7X|#_!2pM0>nY2LIH;}SO`UK!lfIGY!juH-gR1E2K0q$iEBhj
zN@7W>RdP`(kYX@0FtpS)GytLyLo+K=Q!4`_T>}#<1B0N)7muK5$jwj5OsmALL3v+h
Q1yBQnr>mdKI;Vst0I{=+n*aa+

literal 0
HcmV?d00001


From d06b82adf188bfb81497e59c14c2b310b991d38b Mon Sep 17 00:00:00 2001
From: Domino Goupil <1er@live.ca>
Date: Thu, 10 Oct 2019 17:06:59 -0400
Subject: [PATCH 3/5] Fix indentation in usage message

---
 bleed.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bleed.sh b/bleed.sh
index e78665a..93c1c98 100644
--- a/bleed.sh
+++ b/bleed.sh
@@ -27,7 +27,7 @@ usage() {
 		                                (defaults to 0x0)
 		  -O, --output-offset XX YY     the margins added to the output image
 		                                (defaults to 0x0)
-		  -f, --force					overwrite the output file if it exists
+		  -f, --force                   overwrite the output file if it exists
 		  -v, --verbose                 display computations during execution
 		  -h, --help                    display this help text and exit
 	EOM

From c2c985b2e878c95c17b09b272189876952d34873 Mon Sep 17 00:00:00 2001
From: DominoPivot <1er@live.ca>
Date: Thu, 10 Oct 2019 20:01:22 -0400
Subject: [PATCH 4/5] Fix missing words in description

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 0ccead9..84f1f6f 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 Automatically stretch out the 1px edge of each tile in a tile sheet to compensate for tile bleed in 2D game development.
 
-This should solve rounding errors which can cause tiles to slightly bleed into their neighbors, such as the very common "gap between tiles" problem in Unity. The script was forked cjonasw's but I added so many features that it ended up quite different from the original.
+This should solve rounding errors which can cause tiles to slightly bleed into their neighbors, such as the very common "gap between tiles" problem in Unity. The script started as a fork but I added so many features that it ended up quite different from [the original](https://github.com/cjonasw/tile-bleed-margin-generator).
 
 ## Dependencies
 
@@ -19,4 +19,4 @@ The script determines the number of tiles based on the size of the file. It igno
 ## Known issues
 
 -   Unknown options or options with the wrong number of parameters produce unclear error messages.
--   The `--help` flag doesn't work properly because the command fails on missing arguments first. Mitigated by showing the usage on missing arguments.
\ No newline at end of file
+-   The `--help` flag doesn't work properly because the command fails on missing arguments first. Mitigated by showing the usage on missing arguments.

From e05462956f3e9d37ca6813c2a7509b8730a7a9ef Mon Sep 17 00:00:00 2001
From: DominoPivot <1er@live.ca>
Date: Fri, 1 Jan 2021 18:30:04 -0500
Subject: [PATCH 5/5] Mentioned the Unity plugin by chonkypixel

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index 84f1f6f..a423bf8 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,8 @@ Automatically stretch out the 1px edge of each tile in a tile sheet to compensat
 
 This should solve rounding errors which can cause tiles to slightly bleed into their neighbors, such as the very common "gap between tiles" problem in Unity. The script started as a fork but I added so many features that it ended up quite different from [the original](https://github.com/cjonasw/tile-bleed-margin-generator).
 
+Alternatively, you might want to look at chonkypixel's solution which is integrated in the Unity editor. I haven't tested it myself, but it has a UI which does exactly the same thing. https://assetstore.unity.com/packages/2d/textures-materials/tiles/2d-tile-gap-fixing-tool-157060
+
 ## Dependencies
 
 This script was written for bash and depends on ImageMagick (tested using `ImageMagick 6.9.7-4`). The `convert`, `montage` and `identify` commands must be in your PATH.