Spritesheet Cutter/Map Editor Files

===================================================================
SPRITESHEET CUTTER / MAP EDITOR (GRIDCUTTER)
===================================================================

The program is compiled for Windows, Linux, and Apple Silicon (M1/M2/M3). 

* Note for macOS: Under Apple Silicon, the drag & drop function 
  currently works only to a limited extent or not at all.

If you have any feature requests, please let us know. Otherwise, 
have fun using it!


-------------------------------------------------------------------
CURRENT FUNCTIONS
-------------------------------------------------------------------

- Image Loading: Load images via the menu, via drag & drop into the 
  open window, or by dragging an image directly onto the icon.
- Grid Setup: Easily set up and configure grids.
- Deletion: Delete single or multiple images using the right mouse button.
- Reordering: Move or swap single or multiple images via drag & drop.
- Saving & Export: Save single or multiple images, automatically 
  numbered consecutively. You can also export via drag & drop.
- Dynamic Grid Editing: Add empty rows or columns by hovering the mouse 
  over the image border. Delete empty columns/rows or line up an empty grid.
- External Editing: Edit images with an external program; changes are 
  applied directly inside GridCutter.
- Alpha Channel: Support for saving alpha channels (transparency).
- Animations: Grid animation options are available.
- Sprite Management: Load single or multiple sprites via drag & drop 
  (from Explorer to GridCutter), add images to empty grids, select 
  multiple sprites, and mass export/delete.
- Localization: Multiple languages can be selected, and anyone can 
  easily translate the program themselves.
- Color to Transparency: Convert a selection to transparency. All colors 
  contained within the selected box will be converted to transparency 
  for the entire image. (An interesting gimmick that costs computing time!)


-------------------------------------------------------------------
IMPORTANT NOTE: FEEDBACK & BUG REPORTS
-------------------------------------------------------------------

This program has currently only been tested by myself. Due to differing 
PC configurations or undiscovered software bugs, crashes or other 
errors may occur on your system.

Since no feedback has been received so far, improving the software 
is quite difficult. I HIGHLY RELY ON YOUR INPUT! 

Please feel free to report issues, bugs, or feature requests here:

* Discussion Forum: 
  https://sourceforge.net/p/gridcutter/discussion/general/

Thank you very much for your support!


-------------------------------------------------------------------
MAC OS INSTRUCTIONS (FFMPEG SETUP)
-------------------------------------------------------------------

This program uses FFmpeg to create GIFs. Please install FFmpeg manually.

OPTION 1 (Recommended):
Download the FFmpeg Installer (PKG) matching your Mac's processor from 
https://ffmpeg.martin-riedl.de/ and run the installation.

OPTION 2 (For Developers / Advanced Users):
If you use Homebrew, open your Terminal and install it by running:
brew install ffmpeg


-------------------------------------------------------------------
WINDOWS INSTRUCTIONS (FFMPEG SETUP)
-------------------------------------------------------------------

1. Download the Windows version from the BtbN FFmpeg Builds repository:
   https://github.com/BtbN/FFmpeg-Builds/releases
   (Choose the latest GPL, static version)

2. Copy the "ffmpeg.exe" file into your SpriteSheet Cutter directory.

3. If necessary, specify the path to the executable in the 
   GridCutter settings.



--------
The animation is from https://pixabay.com/de/gifs/fahrrad-kürbis-blätter-fallen-713/ lavnatalia
--------

 Version Change
----------------
1.03 Alpha(03.09.2026)
- removed: The automatic update check was removed due to server connection issues. Please check for new versions manually on the project page.
- add: ffmpeg path settings
- add: Various ffmpeg hints in the window


1.02 Alpha(17.08.2026)
- add: Text show/hide toggle button

1.01 Alpha(27.07.2026)
- FIX: load the picture faster
- FIX: Individual images are loaded with transparency
- FIX: better fit to the window
- Changed: max sheet size to 20,000
- BUG: external Programm was not call(Type "mspaint" into the settings.)
- BUG: Images saved externally with transparency are completely redrawn and no longer blended. 
- BUG: New images are transparent.
- add: batch duration editing
- remove: Duration mode option setting


1.0 Alpha(03.05.2026)
- add: XML Export for 3D Engines
- add: Gif Export; Frame Duration (Delay) use ffmpeg <- TODOs Selecting everything is not yet possible
- add: easy Settings Menu
- new: info menu with Animation from pixabay.com
- FIX: faster

0.94 Alpha(16.04.2026)
- add: Backup List
- Fix: Random Name
- Fix: Backup
- Fix: memory consumption

0.93 Alpha(05.10.2024)
- Fix: name unnaming error
- Fix: update Check


Version 0.92(05.08.2024)
- Added: check if there is an update, see the help
- Fix: Undoing still resulted in many errors and caused the program to crash
- Fix: selecting multiple images was not displayed properly
- Improved: Less memory is required.

Version 0.91(December 23, 2023)
- Map mode/copy mode
- Convert selection to transparency bug fixed
- Errors are now caught and displayed for debugging, these can be used
- to better understand and fix program errors.
- new languages ​​added, anyone can translate the program themselves, explanation can be found on YouTube
- try to translate into Russian/French with Google Translate.
- GridCutter.ini is linked to the directory of the main file. An ini on the desktop is therefore no longer necessary.
Only possible for Windows. Under Linux, the program file (shortcut) and ini file must be together in one directory. Otherwise, no configurations are saved and the program is portab


Version 0.84
- Bug fixed
- Export via drag & drop
- Delete or arrange grid
- Select multiple and delete or swap or export via drag & drop

Version 0.74(11/22/2022)
- New button added
- Animation rate can be changed with up and down buttons.
- the resolution in the editing changed, thereby more speed, and RAM saved
- GridCutter ini: set frame rate to a delay value
Enter image editing program

Version 0.73(11/16/2022)
- Bars fixed when dragging/dropping the image
- Background color can be converted to transparency

Version 0.72(11/15/2022)
- Drag/drop individual images outside, a grid is added
- Drag/drop images can be placed in the selected grid
- Error in deleting and copying the alpha channel fixed
- Columns and rows can be removed. Take via menu or sprite and move to the left or up
the image will be larger or smaller

Version 0.71(11/14/2022)
- Drag/drop to load multiple images at the same time
- Bug fixed

Version 0.7(11/11/2022)
- Apha Channel storage possible

Version 0.6
- Add empty rows or columns
- Copying and pasting of images is possible
- Image size is displayed at the bottom right
- Images can be edited with Paint, the changes are applied directly to the GrdiCutter

Version 0.5
- Undo Ctrl Z and Redo Ctrl Y function added
- Start program with image file by dragging and dropping onto icon
- Scaling now runs in an extra canvas. No more flickering
- Shortcut key command for undo created (on Mac it is the control Z)
- ESC to exit the program
- Exiting the program will ask you to save before making changes
- Minor errors removed

Version 0.4
- Sprites can be saved from left to right
- Sprites can be saved from top to bottom then to the right
- Sprites can be saved randomly
- Display numbers
- Sprites can be moved with the mouse
- Individual sprites can be removed