HexDissect

HexDissect — Simple Pixel Art Slicer

HexDissect is a small command-line utility for pixel artists and game developers who want a fast, no-nonsense way to break images into evenly sized square tiles.

You drop images into a folder, run the tool, choose a tile size, and HexDissect slices everything cleanly and predictably. No GUI, no project files, no metadata — just files in, files out.

This tool was built for grid-aligned pixel art workflows where precision and repeatability matter more than flexibility.

What It Does

• Scans an input folder for supported image files

• Allows slicing one image or all images at once

• Cuts images into square tiles of a user-defined size

• Aborts if an image is not evenly divisible

• Outputs PNG tiles with fixed-width serial numbering

• Automatically creates required folders

What It Does Not Do

• No graphical interface

• No resizing, padding, trimming, or auto-detection

• No config files or background services

• No “smart” behavior — exact input is required

This is a deterministic utility, not a creative assistant.

Folder Workflow

1. Put images in:   insputs/
2. Run HexDissect
3. Enter tile size (> 8)
4. Get results in: outputs/<image_name>/

(The folder name insputs is accidental, but will not be fixed, because I like it.)

Third-Party Libraries

HexDissect includes the following third-party single-header libraries, which are not authored by this project:

• stb_image.h — image loading

• stb_image_write.h — image writing

Both libraries are part of the stb collection by Sean Barrett and are used under their respective permissive licenses.

All credit for those components belongs to their original author(s).

AI / Tooling Disclosure

This software was developed by a human developer with ChatGPT used as an assisted coding and documentation tool.

All specifications, architectural decisions, and final validation were performed manually. ChatGPT was used to accelerate implementation and reduce boilerplate, not to autonomously design or ship the software.

This disclosure is provided so users understand the development context and can set appropriate expectations.

License / Use

This is a small utility tool provided as-is.

No warranty is expressed or implied.
If it breaks, it stops and tells you why.