[Extension] Magic Pencil

[thkwznk]

Magic Pencil - Download - Source Code

Magic Pencil is an extension for Aseprite that provides additional options for the pencil tool.

---

How to use the extension

Go to the Edit menu and click the Magic Pencil option, select an effect from the dialog window and use the pencil tool.

Please note that most options use magic colors, selected colors will be restored after closing the Magic Pencil dialog window or selecting the Regular option.

---

Options

Tool [Outline] - adds an outline around a closed shape that you click on, works with foreground (left-click) and background (right-click) colors.

Brush [Outline] - adds an outline around the brush as you draw. After selecting this option, the outline’s color can be changed under this option in the dialog window.

Lift - moves a part of the image into its own layer.

Unique [Mix] - mixes colors, left-click uses the RGB color model to mix colors, while right-click uses HSV.

Proportional [Mix] - mixes colors taking into account the number of pixels of each color, left-click uses the RGB color model to mix colors, while right-click uses HSV.

Colorize - changes color (hue), works with foreground (left-click) and background (right-click) colors.

Desaturate - removes color (hue) completely.

Hue/Saturation/Value/Lightness [Shift] - changes the colors based on the selected property, left-click to add, right-click to subtract. You can change how much of a shift will be applied by changing the percentage slider under these options.

Indexed Mode - when enabled, prevents new colors from being introduced, and any option that modifies colors will use colors from the palette.

---

Known issues

• Using any option from the Magic Pencil on a completely empty cel will result in the first stroke being treated as a regular pencil
• Selecting colors from the palette when using any option from the Magic Pencil other than Outline or Colorize (which actually use the selected color) will interfere with its working and result in odd behavior

---

Previews

[J19]

I really like the lift magic pencil. Is there a way for it to lift the selected content in multiple frames?

[thkwznk]

@J19 Not at the moment, all options work with the active cel.

Does the pencil allow for drawing in multiple frames?

[Eidern_eidern]

Hello,
I’m sorry to ask this question, but after installing the extension (on Mac), and restarting Aseprite, I’m still not able to see any MagicPencil menu in the Edit menu.
Did I forgot one important step (as it seems ) ?

[thkwznk]

These are all the steps you should need.

If you’ve never installed any extensions you can take a look a this thread which explains and solves this particular issue.

[Eidern_eidern]

Thanks for trying…
Uugh so it seems that I’m stuck , the post did not have the answer (because the guy did tell that it don’t have any Aseprite.ini file in its folder as requested, so its issue isn’t fixed), and the Apple tree structure has no common point with the windows…
Anyway, so I did not forgot anything, and I’m starting digging deeper then.

[Eidern_eidern]

And found !:
So I’ll add here the Todo for Mac users, because I’m not even in a particular case as I didn’t got Aseprite from steam, but from a legal purchased file, So I guess all the Mac users got the ini file created by default, and the ini files suggests that it’s a portable build and reinstall everything at start. (without any extensions).

the default directory is there:

Macintosh HD/ User/[YOUR NAME]/ Library/Application Support/Aseprite/
If there is any Aseprite.ini , just rename it (as Aseprite.bak for example, in case for Mac there are some ini that must be important, so far I did not see , but maybe it overrides some shortcuts, I dunno )
and at restart of Aseprite you’ll get access to the extensions .

[Eidern_eidern]

@Eidern_eidern

And found !:
So I’ll add here the Todo for Mac users, because I’m not even in a particular case as I didn’t got Aseprite from steam, but from a legal purchased file, So I guess all the Mac users got the ini file created by default, and the ini files suggests that it’s a portable build and reinstall everything at start. (without any extensions).

the default directory is there:

Macintosh HD/ User/[YOUR NAME]/ Library/Application Support/Aseprite/
If there is any Aseprite.ini , just rename it (as Aseprite.bak for example, in case for Mac there are some ini that must be important, so far I did not see , but maybe it overrides some shortcuts, I dunno )
and at restart of Aseprite you’ll get access to the extensions .

It seems that I complained one day too soon : the new Aseprite version launched yesterday now supports shortcut and extensions, meaning that you no longer need to delete the Aseprite.ini file

[Gujhack]

How do i get it to highlight non-conforming pixels (no single-pixel challenge, banding, etc)?

[thkwznk]

This extension doesn’t have that feature, I have a script that does just that which I plan to release separately, soon.

[thkwznk]

An update to v1.0.1 was released - this is a small post-release update, I significantly refactored the code and in the process discovered and fixed a few issues.

Changes:

• [Fix] Outline now respects the active selection
• [Fix] Color mixing in HSV color model now always correctly mixes hue
• [Fix] Improved stability and left/right click detection

[thkwznk]

An update to v1.0.2 was released - this update fixes a few rare bugs and introduces a new option - Indexed Mode, when enabled, prevents new colors from being introduced, and any option that modifies colors will use colors from the palette. This was a suggestion from the Illusion of Mana.

Changes:

• [Improvement] Added an option for the Indexed Mode
• [Improvement] Colorize now works with grayscale pixels
• [Fix] Opening the Magic Pencil with an empty cel selected no longer crashes the extension
• [Fix] Adding outline to a cel with transparent pixels on the edges of the image now behaves correctly

[thkwznk]

An update to v1.0.3 was released - with this update a few new options are introduced - you can now outline as you draw with the Outline Brush, paint your own selection, shift colors in the RGB color model, and enjoy Magic Pencil without crashing Aseprite.

Changes:

• [Improvement] Added an option for the Outline Brush, the original Outline option is now renamed to Outline Tool, suggested by @apoonto
• [Improvement] Added an option to shift colors in the RGB color model
• [Improvement] Added an option for the Selection
• [Improvement] Lift now creates a layer directly above (with left-click) or below (with right-click) the current one
• [Fix] Undoing last action (Ctrl+Z) with mouse over Magic Pencil dialog no longer crashes Aseprite
• [Fix] Magic Pencil no longer unlinks linked cels, reported by @stahli_25

[Cheese_Nguyen]

hi i have an issue here
somehow it keep giving me these error log
i have no idea how to fix it, pls help

[thkwznk]

I believe the issue is that you’re running Asperite version 1.3-beta4 which was released last year. The extension wasn’t tested with this version.

Could you update to a newer version from the 1.3 beta branch or the newest 1.2 release?