Graphical interface to create rectangular sections on a sprite sheet. Those rectangular sections are later saved to a text file. The format of said text file is compatible with other tools in these repositories.
Make sure to have:
libsdl2-dev (plus ttf, image and mixer extensions)
Download, build and install the following repos from github.com/themarlboroman
- libdansdl2
- libdansdl2-tools
- tools
- lm
- dfw
You will need to define one of the possible build environments, either the AppImage build (if you have the necessary deps to build one) or the standalone build:
mkdir -p build cd build cmake .. -D BUILD_REGULAR=YES/NO or cmake .. -D BUILD_APPIMAGE=YES/NO
Be wary that both can't be built at the same time. Yes, I know it is confusing. Yes, I know I can work around it.
You can also opt to build a debug or production environment, which can greatly break the application depending on the libdansdl2 library that has been built!
cmake .. -D BUILD_DEBUG=YES/NO
Then just do the usual make dance.
Press f1 in the application main screen or run with -h. Or even read the help.txt file.
-h shows the help file. -f session_file: opens the session file -i image_file: uses background image
Upon first running the configuration in data/config.json will be copied straight to $HOME/.config.json. Values that can be useful to change are:
- default_sprite_w: the default width of a new sprite.
- default_sprite_h: the default height of a new sprite.
- movement_factor: how many pixels per tic are moved in an arrow keypress.
- window_w_px: width of the window
- window_w_logical: logical width of the window. If you are so inclined, you could set it to half of the window width and have a zoomed view. In most cases, this must be kept in sync with the above value.
- window_h_px: height of the window
- window_h_logical: logical height of the window
Nothing more will be added here, the CHANGELOG.md file will suffice.
- As of July 2020 the project has been rewritten.
- As of November 5th 2015 the code has been patched with a compatibility layer to support many radical changes to the libdansdl2. Should the code be updated, the compatibility layer will be removed.
- As of July 2016 the code has been updated to drop SDL2 graphic capabilities and now uses OpenGL. There should be a few glitches here and there.
- As of July 2017 the code does not compile with the current branches of libdansdl2 and herramientas_proyecto due to translation of code and changes in the core functionality.
- 26/07/2017: Bugs:
- Fixed camera bug: camera was limited to image size when image size was yet unknown.
- Fixed stupid zoom bug. Turns out it wasn't opengl. It was me and something about atlas vs complete sampling in libdansdl2.