Aseprite Dithering Brushes
A downloadable Aseprite Extension
This is an extension for Aseprite that provides a dedicated tool window for dithering brushes.
Density controls the balance between the foreground and background colors. A higher density means that more of the pattern will be occupied by the foreground color.
The colors displayed are linked to the current foreground/background colors, and cannot be changed through the 'Dithering Brushes' menu directly.
The pattern preview shows the pattern associated with the current density using the current foreground/background colors.
The pattern size increment refers to the number of pixels by which the pattern should be expanded. Dithering patterns have a fixed minimum size of 4x4 pixels, so a pattern size increment of 2 will tile the 4x4 pattern into a 6x6 space. If **force tiling** is checked, increment values will be clamped to multiples of 4 to ensure that patterns tile perfectly. Patterns may not tile correctly for other increments. Negative values are not supported. For best results, use multiples of 4.
The brush scale refers to a scale factor that is applied to the incremented pattern. For a brush scale of 2, the 6x6 pattern from before will be scaled into a 12x12 brush. Values less than or equal to zero are not supported.
Version 2.0.0
The apply automatically option will automatically update the brush whenever any fields in the dithering brushes dialog are changed.
Download
Click download now to get access to the following files:
Comments
Log in with itch.io to leave a comment.
Using Aseprite v1.3-rc6-x64, tiling does not work at all regardless of whether "Force tiling" is checked or not.
I'm not able to test on rc6 without building from source. I assume you have tried this but just to confirm - tiling only really works with even brush sizes. If tiling is not otherwise working I am not sure what to tell you since all the extension is doing is creating a new variant of the built-in custom brush feature. I will investigate this further once I have rc6.
I minimized the options, made auto-update and fixed-tiling true by default, and also added some extra touch buttons. My tablet has a very small resolution (1280x800), so screen space is quite valuable to me.
Thanks for the update!
It's super rad. c:
Really cool stuff! Would it be possible having a way to automatically update the brush when you adjust the settings? Without having to press Apply each time, I mean.
That should be possible. I would probably also add a check box to enable auto-updating.
Just updated the extension, there is now a check box to automatically apply changes made in the dialog.
Any chance of adding rounded brushes or pressure sensitivity in the future?
Those are good ideas, I could definitely figure out rounded brushes. Pressure sensitivity might take a bit longer though.
I only took a small peak at the Aseprite API when making a touchscreen undo/redo button and I saw ya use some arrangement of pixels in your code to generate the patterns.
I didn't look too deeply into either, but it all looks more advanced than what I understand atm. I can't (yet) image the amount of work that went into it.
Thank ya so much for making this tool. It's helped a great deal with making variably shaded drawings for the Playdate.
I am glad you are finding the extension useful.
I took a closer look at the api/code and I am not sure how possible it is to have rounded brushes. The main issue is that custom brushes in aseprite are based on having a fixed image that gets tiled - if I make the image circular, the pattern becomes circular without affecting the actual brush shape. To see what I mean you can try drawing a circular pattern and then selecting the pattern and pressing CTRL+B to create a custom brush for it.
As far as pressure sensitivity goes, I don't really have any way to test that and I doubt the API provides any way to detect it.
Maybe in the future if the API becomes more advanced I can create a custom brush tool as opposed to a menu that creates custom brushes.
Ah, darn. I hadn't thought of the rounded brush tiling issue.
Such a shame that patterned brushes aren't supported better by the program. UnU
Anyway, as the extension is as it is now, I love it and it helps a ton. Thank you. c:
I'm using 1.3 and I've installed the extension but how do i open the menu?
From the top menu:
Edit > Dithering Brushes
it should be below 'Shift' and above 'New Brush'
I'm not seeing the extension, either.
I installed it as I would any other script and I do not see it within the Edit menu.
I'm on Aseprite v1.2.40
It is possible that it will only work for 1.3 and above, at least that's the version I use and have it working on.
It sure does!
Just tried it on two different machines.
Thanks for lettin' me know. UuU
Hi, i cant find the extension in aseprite?
If double clicking the file didn't work you can go to Edit / Preferences / Extensions then click where it says add extension and find where you downloaded it.
oh i mean its installed in the extensions tab, but i cant find the actual tool in aseprite under the edit tab. sorry for the confusion
What is your aseprite version?
Updated to 1.3 Beta, is working now!