From b80bbe0fe62c92226546c9f4fed6725d051133d4 Mon Sep 17 00:00:00 2001 From: Rangi <35663410+Rangi42@users.noreply.github.com> Date: Sat, 19 Sep 2026 14:40:02 -0400 Subject: [PATCH] Correct documentation for `rgbgfx -x` re: interaction with `-N` (#2126) --- man/rgbgfx.1 | 12 ++++++++++-- test/gfx/trim_past_n.err | 2 ++ test/gfx/trim_past_n.flags | 1 + test/gfx/trim_past_n.png | Bin 0 -> 148 bytes 4 files changed, 13 insertions(+), 2 deletions(-) create mode 100644 test/gfx/trim_past_n.err create mode 100644 test/gfx/trim_past_n.flags create mode 100644 test/gfx/trim_past_n.png diff --git a/man/rgbgfx.1 b/man/rgbgfx.1 index 253cdc9b..f4570c32 100644 --- a/man/rgbgfx.1 +++ b/man/rgbgfx.1 @@ -491,9 +491,17 @@ deduplication if .Fl u was enabled, so you probably don't want to use this option in combination with .Fl u . -Note also that the tiles that don't get output will not count towards +.Pp +Also note that the tiles that don't get output in the tile data +.Em do +still count towards .Fl N Ap s -limit. +limit, since they may get output in the tilemap or attribute map. +If you need to omit input tiles from all output in a way that does not count towards +.Fl N , +use +.Fl B +background tiles. .It Fl Y , Fl \-mirror-y Deduplicate tiles that are vertically symmetrical mirror images of each other across the Y axis. Implies diff --git a/test/gfx/trim_past_n.err b/test/gfx/trim_past_n.err new file mode 100644 index 00000000..1625857c --- /dev/null +++ b/test/gfx/trim_past_n.err @@ -0,0 +1,2 @@ +FATAL: Image contains 9 tiles, exceeding the limit of 4 + 4 +Conversion aborted after 1 error diff --git a/test/gfx/trim_past_n.flags b/test/gfx/trim_past_n.flags new file mode 100644 index 00000000..1706562e --- /dev/null +++ b/test/gfx/trim_past_n.flags @@ -0,0 +1 @@ +-N 4,4 -x 1 -c dmg diff --git a/test/gfx/trim_past_n.png b/test/gfx/trim_past_n.png new file mode 100644 index 0000000000000000000000000000000000000000..4873231a51e060f806317ad06fb110dbaa851db2 GIT binary patch literal 148 zcmeAS@N?(olHy`uVBq!ia0vp^5+KY3BpCYFRJ8)BXipc%kcwNrJ&s%l95|Snt95@U z9$e2|r@=3<=C$6^c8eZ~K-Q8=EqVpPYcracohkAWWQ?CCa_5lj0)0;%H_Z=U_?30E uw@fW`5PWp~RY`Ym?RLfF%w+j