Carbs Toolbar

A collection of small features and additions for Aseprite  that I use more so then not.

 This makes it very quick to access and use by having all my buttons in one place!

Hopefully you find this little toolbar useful! :D

Feature list:

Setting Grid Size From Selection & New Sprite From Selection

Setting Checkerboard Grid Size From Selection

Expanding Sprite Sheet Size From Selection

Quick Outline & Quick Shadow

HSV Shift

Options In Expand Canvas

All Options Are Now Hide-able!

Help & Information Added In Toolbar!

Duplicate & Shift Options

Toolbar Scales To UI / Theme

No more having to resize the dialog when opening!

Selection Spritesheet ( A WhiteVault Request)

Export a spritesheet that ONLY contains your selected area. 

This supports Active / All layers contained in selection.

Also supports as Active Tag  / All Tags (Separated in rows)

If you change themes while the toolbar is open you will need to restart the toolbar to get it to automatically size.

Dupe + Rotate

Duplicate and rotate your current selection clockwise or counter clockwise in one quick button press :D Useful for making more duck friends :3

New Features In Update 3.0:

All Functions Now Have Customizable Hotkeys

You can now set a custom hotkey for any/all functions you may use frequently.

Selected options from the toolbar are used when using any of the custom hotkeys.

As so the toolbar will need to be open for the hotkeys to work, but it can be minimized so it's not in the way. 

Shrink Wrap Selection

Wraps current selection to the smallest selection possible that contains data.

Quickly select exactly what you need to select from a loose selection.

Thanks to SnowDrama for this feature request

Resize Sprite Selection

Resize your current selection down or up from 25% to 400%

Choose to keep your original selection will make your resized version a copy.

Thanks to SnowDrama for this feature request

Export Selection

Export a single file from the current selection from a selected cel.

Choose from the active layer only or all layers that are currently visible. To exclude a layer simply hide it.

Thanks to Kebbrokk for this feature request.

Export All Visible Layers

Export multiple files, one per layer from a selected cel.

This will include layers inside of a group but will not include groups in a group. To exclude a layer simply hide it.

Selecting "Shrinkwrap Layers" will export the layers using the smallest area with data per layer.

Thanks to SnowDrama for this feature request

Slice Selection

Creates a slice from your current selection bounds without needing to change to the slice tool.

As this is based on your selection you can quickly and accurately make slices as needed. Excellent when used with Shrink Wrap Selection.

Thanks to SnowDrama for this feature request.

Export All Slices

Creates files in the current documents directory for each slice found in your document.

This one is a doozy! With many options. 

Single Frame: Export each slice in your current document using only the current selected frame.

Only Current Tag: Export each slice in your current document using only the frames marked with the current tag.

As Sprite Sheet: Exports each slice, using tags and frames , in to a separate sprite sheet.

All export methods support transparency and will only export visible layers. To exclude a layer simply hide it.

Thanks to SnowDrama for this feature request. 

Further thanks to CarlosandresRG for requesting sprite sheet support.

Palette To Pixels

Paint your palette on to the canvas pixels by simply selecting and area.

This will paint one color per pixel selected starting with index 0 in the palette. 

Thanks to SnowDrama for this feature request.

Bug Fixes / Error Checking In Update 3.0:

• Fixed a bug where closing the help / info panel would reopen the help / info panel a second time.
• Fixed a bug causing an error if the user tried to open the toolbar with no active document.
• Error detection and message added  to let the user know they will need an active document in the event the used function needs one.
• Error detection and message to let the user know that the document needs to be saved at least once to set the export folder for new features.
• Fixed an issue that was not putting Dupe and Shift actions in to one undo transaction. This is now working and will undo all steps if user undos.
• Known issues: If the toolbar has not been opened at least once and a hotkey is set and pressed it will return nil when looking for toolbar as it needs to be open. Simply open the toolbar once to not get this error. I will try and patch this in when I can get a work around.

To install / Run:

File > Scripts > Open Script Folder

Take the include folder (Carbs Toolbar) in the ziped file you've downloaded and simply drop in your scripts folder.

Restart Aseprite or press F5 to refresh scripts in Aseprite

To open the toolbar:

File > Scripts> CarbsToolbar to open.

Hotkeys can now be configured as well in Edit > Keyboard Shortcuts look for folder marked Carbs Toolbar!

Feel free to reach out to me if you have any troubles at all @CarbsCode everywhere and ENJOY! <3

--Simple Usage License / Rights--

Simple Usage License / Rights © CarbsCode 2021 - 2024 All Rights Reserved.

By using the script included with this file you understand that you are using it ASIS with no guarantees. 

Though the script / toolbar is not intended to cause any harm, you understand that any such harm, such as lost of work,time or any other issues financial or otherwise, CarbsCode can not be held responsible. Always save your work regularly!

Please use at your own risk! If you change any of the script that may cause issues support may or may not be available. 

CarbsCode reserves the right to revise this license as needed.

YOU CAN / SHOULD:

Use this script as a toolbar to assist in Aseprite for personal and/or professional use.

Learn from the code within.

Make changes as you see fit for your use-case. However support may not be available for modified scripts so do so at your own risk.

YOU CAN'T / SHOULDN'T:

Re-sell, copy, transfer or distribute entire script or parts of this script without permission.

Usage of this tool in any training of AI (Artificial Intelligence) models with out permission is not permitted.

Usage of this tool to create NFT (Non-Fungible Tokens) is not permitted.

------------------

Please report any bugs if you find some and Carbs will try and resolve as soon as possible!

Hope you all enjoy the tool! Please feel free to reach out or leave a comment if you have any issues or feedback!

❤ Thank you all for the amazing support ❤

Bugs / Feature Requests:

Please check out the new issues page if you find any bugs or want to make a feature request!