Playable character Calibrator

Playable character Calibrator - is a developing tool which gives able to define collision box for each using frame of the playable character, and also this tool can give able to calibrate wrong position of the frames on the wrong SMBX64 playable character sprite.

Collision boxes editing
You can define the collision box, is a rectangles which will contact with other objects: blocks, NPC's, other playable characters, etc.

Frame calibrating
Here you can correct frames positions on the source image.

Animation editing
Here you can define the playable character's animations and test current state of calibration.

Setting up of collision boxes
At first, you need to open the playable character sprite. It is a 1000x1000 pixel image in GIF with masks or transparent PNG (tool is support both types). If you was open tool at first time, you will be asked for sprite image.

When you open sprite, you will see the main window. If this sprite is never edited (configuration bank is not have INI file for this sprite name), all collision boxes will have size 100x100 pixels and zero offsets.

To enable editing of collision boxes, press the "Edit" button. You will noticed about using of sprite in the SMBX where SMBX64 standard have persistence collision boxes for playable characters.

GUI description

 * Current frame - is a frame which you currently edit. When you change those values you open other frames to configure.
 * Physics calibration - is a collision box rectangle parameters which define a collision box rectangle for this sprite. Collision box is a green rectangle over playable character sprite.
 * Width / Height - is a size of collision box. You character can be huge and can be small.
 * Offset X/Y - is a position relative to left-top corner of this frame.
 * Copy - Store current collision box values into clipboard
 * Paste - apply collision box properties from clipboard
 * Apply to all - will copy current frame settings to all 100 frames on your sprite. Be careful, it will overwrite your settings on other frames!
 * Enable this frame - if this check box is checked, this frame will be drawn on the "square man" template sprite.
 * Matrix - you can select current frame in the interactive mode. Also you can quickly edit "Enable this frame" on all available frames.
 * Save config - Save current sprite settings into INI file.
 * Open sprite - Open other sprite to edit collision boxes.


 * Generate "Square man" template - Generate playable sprite where will be drawn a collision boxes. Use them to test your collision boxes in the game.
 * Animator - Open animation player and editor. You can test your sprite in the animation mode
 * Image frames calibration - is a special tool which will allow move drawn frames on the image. Unlike main window, here you correcting image position to fit them into collision box.

Correcting frames position on sprite
This is a special feature which allow to move your frame on the sprite to fit them into exist collision box without edit of them. This necessary for SMBX64 standard where collision boxes are strictly fixed.


 * Current frame - is a frame which you currently edit. When you change those values you open other frames to configure.
 * Image calibration - is positing of frame on the image.
 * Offset X/Y - is a capture position, set values eqial to
 * Crop width/height - is a capture rectangle size, use them to fix junk pixels in bottom or in the right side
 * Matrix - you can select current frame in the interactive mode.
 * Save image - overwrite original image (backup will be created in the filename_orig.png). You can create masked GIF for SMBX64 standard and PNG

Animating of character
Here you can play animations of playable character. Also you can edit them.