Pixel art Clipping Layers and Transparency Masks, Transforms, Select and Fill Half-Pixels, Custom Brushes, Layer Blending Modes and Adjustments, Text Tool, Object 3D Symmetry, Brush Preview, and much more!

Pixel Art Studio for Blender v1.2.0 is packed with 22 new features and more than 20 new improvements (so in total 40+ changes), including many quality of life additions and bug fixes. With this release, Pixel Art Studio is now feature complete.

Since this is a big release, please report any bugs and issues that you might come across.

The next step is making the full manual and documentation, alongside more tutorials.

Check the list of new features and improvements (full changelog at the bottom).

Clipping Layers and Transparency Masks

In the new layer options menu, you can now Clip a Layer with the Layer Below (same functionality like Photoshop), as well add a Mask, which works like Krita's transparency masks and Photoshop masks. You can also toggle the masks on and off.

To open the layer options menu, click the arrow button to the right of the layers list (see the GIF below).

New selection engine: Paper Fold

The Paper Fold engine "folds" pixels and selections even in the most complex UV scenarios, for example, such as selections made on triangulated cylinder caps, which crosses over dozens of UV islands.

Realtime Brush Preview and Brush Line

The viewport now displays the realtime preview of the brush and the eraser (size, shape, opacity and color). You can now also hold a shortcut to draw a line (and keep drawing it) with the brush tool. Place a pixel, then press the default shortcut CTRL+SHIFT+Click and move the mouse (shortcut customizable: "Line from brush (hold and click)").

Select by Topology and Fill by Topology

One of the biggest issues of 3D pixel art texture painting: sub-texels (aka half-pixels, UV fringes, diagonal UVs, etc). To solve this, all selection tools now have the option to select by Topology (default shortcut: CTRL+SHIFT+T), which selects all pixels (including the half-pixels). The Bucket Fill now also fills by Topology and the bucket fill method fill by face now fills the whole topology of the selected faces (including half-pixels).

Bucket Fill and Gradient Bleed

Another tool to help counter half-pixels is the Bleed option now available for both the Bucket Fill and the Gradient tools. This is also a kind of UV dilation and fill expansion.

Layer Blending Modes

Layers and Groups can now be assigned a blending mode (Pixel Art Studio comes with most common blending modes, such as Multiply, Overlay, Screen, Color Dodge, etc), they are available under the list of layers.

Non-destructive Layer Adjustments

You can now adjust the Brightness and Contrast, HSL (Hue, Saturation and Lightness) and Color Curves of layers. The adjustments can be stacked per layer and they can be re-adjusted and removed anytime (non-destructive). Adjustments are available in the new Layer Extras panel.

Flip and Transform (Move, Rotate, Scale, Skew) in 2D and 3D

You can now Flip selections and layers horizontally (SHIFT+H) and vertically (SHIFT+V). There's also a Transform tool (CTRL+T) with the Move, Rotate, Scaling and Skew operations both for layers and selections. Everything works in 3D on top of the model (3D transformations were REALLY hard to implement) and in the Image Editor.

Press ENTER to confirm the transform or ESC to cancel (you can also undo each step with CTRL+Z).

3 options of pixel rotation algorithms when rotating transformations: Clean Rotation (cleanEdge by torcado, this one provides the cleanest results), Fast Rotation (aseprite) and RotSprite.

Symmetry anchored by the Object in the 3D Viewport

It's now possible to anchor the 3D symmetry in the 3D viewport by the Object's Center or by the 3D Cursor. For that, when activating any of the symmetry tools, click Object and then optionally Mirror at 3D Cursor.

Custom Brushes (local or global)

To create a custom brush:

  • Draw in the Image Editor, with only black pixels

  • Select the pixels and any extra transparent pixels that you want part of the brush

  • Activate the Brush tool again

  • In the Shape dropdown (where it says Circle or Square), select Custom.

  • Click the + button, set a name for the brush and select whether you want to mark the brush as an asset (so it's accessible in Blender's Asset Browser) and whether you want the brush available globally in Blender (Save into the add-on preferences).

You can use the custom brush in the Image Editor and in the 3D Viewport. To select a custom brush, go to the same spot as before, select Custom and choose the custom brush.

If you saved into the add-on preferences, it's available in Edit > Preferences > Add-ons > Pixel Art Studio > Presets, and it's going to be available every time you use Pixel Art Studio, in any .blend file.

Text tool

Add text with the new Text tool both in the Image Editor or 3D Viewport projected onto the model:

  • Input the text in the input text box (this is due to the complexity of text operations (select text, move cursor, etc), so I added a native Blender's input box)
  • Click the viewport to place the text
  • You can now move and do transform operations with the text transformation
  • You can also change the text options (bold, italic, font size and font face)
  • Once done, press ENTER

Path (Bézier Curve) and Polygon drawing tool

A Bézier curve tool has been added, with smoothed and hard corners, allowing to draw pixel art curves and polygons, including filled polygons. To use it:

  • Click to place a point
  • Hold and drag the mouse to draw smooth
  • Click and release to draw hard corners
  • Enter to confirm the path
  • Or add another point on top of the starting point to close the curve
  • It's possible to draw the curve filled with the primary or secondary color, working as a polygon drawing tool
  • Shortcuts documentation updated with this new tool

Export Layers as PNG, Import and Paste Images as Layers

In the Layer Extras menu you can find three import and export actions:

  • Import PNG: to import an external PNG image as a new layer
  • Export PNG: to export a layer or group as PNG
  • Paste Image as Layer: if you copy image data outside Blender, you can now paste it as a new layer

And at the top of toolbar you are going to find Paste as New Layer, which actually pastes what you copy INSIDE Pixel Art Studio as a new layer (copy and paste between Pixel Art Studio's own layers).

General New Quality of Life Features and Improvements

In the add-on settings customize the look of the selection marquees (now it's transparent by default).

More readability in selection marques: the marching ants are black and white, smaller and much faster, making selections easier to read.

Bucket Fill has explicit Fill by Pixels or Fill by Face toggles.

Bindable shortcuts for layer and group operations (by default Photoshop's like keybindings, like CTRL+J to duplicate layer and CTRL+G to Group).

Custom pixel density presets.


The default shortcut for the temporary colorpicker is ALT+left mouse button click, aligned with other painting tools. Users that need the ALT key free (such as to rotate the viewport), can still customize the shortcut to something else (Preferences > Add-ons > Pixel Art Studio > Shortcuts > customize "Eyedropper (hold and click)").

Pickup colors without clicking with the new "Eyedropper on Hover" color picker, default shortcut SHIFT+ALT+X. Activate it and move the mouse to pick colors.

The rectangle and ellipse drawing tools can now be filled with either the primary or secondary color. When filled with the secondary color, it gets an outline with the primary color.

When making a selection with the Wand Selection tool, then adjusting parameters (Tolerance, Contiguous), and clicking on top of the active selection again while the tool is still active, it's possible to configure it to make a new selection with the new paramaters.

Other quality of life improvements or new features:

  • The temporary colorpicker keeps picking colors as long as you hold the shortcut and move the mouse (ALT+left mouse click by default).
  • Pick colors from any object and from any area of the Blender viewport.
  • Translation framework: Pixel Art Studio is now ready to be multi-language (English only, for now).
  • Hold SHIFT while placing a gradient to place straight gradients. Move to increment by 45 degrees.
  • When you have the Image Editor and 3D viewport side by side, colors picked in one viewport automatically are picked into the other.
  • Changes made with and within selections are now mirrored when a symmetry tool is active.
  • The Bucket Fill now gets mirrored when a symmetry tool is active.
  • Added a "Scramble" blur brush, which shifts pixels around instead of changing colors.

General Improvements

Bucket fill fills enclosed areas that are split across multiple UV islands (ex: draw a shape on a cylinder cap that has been poked with triangles, the bucket fill is going to fill the shape and distribute each slice in each triangle's UV island).

The rectangle and ellipse tools now project straight between faces.

Other improvements:

  • Selection tools are faster in the Image Editor
  • Support to higher resolution textures
  • Performance improvements when painting textures higher than 1024x1024 (validated and tested in a mesh with 2 4096x4096 textures).

v1.2.0 Changelog

  • New feature: New selection engine called "Paper Fold".
  • New feature: Custom brushes. Custom brushes are created in the Image Editor, and can be persisted in the .blend file, marked as asset (to be shared in the Asset Browser) and persisted in the add-on preferences (for reuse in all .blend files).
  • New feature: Transform layers and selections (scale, rotate, skew)
  • New feature: Text tool
  • New feature: Layer blending modes
  • New feature: Layer adjustments
  • New feature: Layer masks and clipping masks (like Photoshop and Krita)
  • New feature: Bucket fill and gradient bleed (aka fill expansion, UV dilation)
  • New feature: Import PNG as layer and Export layer as PNG
  • New feature: Paste external image as layer
  • New feature: Path and Polygon tool
  • New feature: Flip selections horizontally and vertically
  • New feature: Customize the selection marquee (transparent by default)
  • New feature: hold CTRL+SHIFT while using the Brush tool to draw connecting lines and polygons
  • New feature: Show the brush and the eraser shape, color and opacity under the cursor (brush ghosting)
  • New feature: Bindable shortcuts for layer and group operations (Photoshop's like keybindings)
  • New feature: Manage custom density presets
  • New feature: The symmetry tools in the 3D viewport now have 4 modes: aligned with view (the only previous mode), centered aligned with the object, aligned with view at the 3D cursor, aligned with the object at the 3D cursor.
  • New feature: The selection tools have a new selection method: "Select by Topology" (only for the 3D viewport), to select the whole contour of the topology, to allow for painting and filling half and corner pixels.
  • New feature: A new temporary color picker has been added, "Eyedropper on Hover" to pickup colors without clicking, with customizable shortcuts. Default: SHIFT+ALT+X (the other temporary color picker with ALT+Left Click is still present).
  • New feature: Pick colors from any object and from any area of the Blender viewport
  • New feature: Translation (i18n) framework. Every public facing text is now an extracted string living in a single file, which can allow for translations in the future, making Pixel Art Studio multi-language.
  • New feature: Added a "Scramble" blur brush, which shifts pixels around instead of changing colors.
  • Improvement: The rectangle and ellipse drawing tools can now be filled with either the primary or secondary color. When filled with the secondary color, it gets an outline with the primary color.
  • Improvement: Selection marching ants are smaller and faster, making them more readable.
  • Improvement: Bucket fill fills enclosed areas that are split across multiple UV islands (ex: draw a shape on a cylinder cap that has been poked with triangles, the bucket fill is going to fill the shape and distribute each slice in each triangle's UV island).
  • Improvement: Selection tools are faster in the Image Editor
  • Improvement: The rectangle and ellipse tools now project straight between faces
  • Improvement: The default shortcut for the temporary colorpicker is ALT+left mouse button click, aligned with other painting tools. Users that need the ALT key free (such as to rotate the viewport), can still customize the shortcut to something else (Preferences > Add-ons > Pixel Art Studio > Shortcuts > customize "Eyedropper (hold and click)").
  • Improvement: The temporary colorpicker keeps picking colors as long as you hold the shortcut and move the mouse (ALT+left mouse click by default).
  • Improvement: The bucket fill tool has 2 clear methods of filling with 2 toggle buttons: Fill by Pixels and Fill by Selected Faces.
  • Improvement: The bucket fill method fill by face now fill the whole topology of the selected faces (including half-pixels).
  • Improvement: When making a selection with the Wand Selection tool, then adjusting parameters (Tolerance, Contiguous), and clicking on top of the active selection again while the tool is still active, it's possible to configure it to make a new selection with the new paramaters.
  • Improvement: Hold SHIFT while placing a gradient to place straight gradients. Move to increment by 45 degrees.
  • Improvement: When you have the Image Editor and 3D viewport side by side, colors picked in one viewport automatically are picked into the other.
  • Improvement: Performance improvements when painting textures higher than 1024x1024 (validated and tested in a mesh with 2 4096x4096 textures).
  • Improvement: Changes made with and within selections are now mirrored when a symmetry tool is active.
  • Improvement: The Bucket Fill now gets mirrored when a symmetry tool is active.
  • Bug fix: using the Activator Shortcut in the Image Editor does not steal the focus from the shortcut from the 3D viewport (when having both viewports side by side, like with the Pixel Art Studio workspace).
  • Bug fix: fixed a critical issue where the texture file would be replaced by stale layers when a blend file that previously had a Pixel Art Studio canvas was saved as another file. Now the file watcher conflict popup is triggered on file load when the file saved separately is opened.
  • Bug fix: merge layer down correctly makes the destination layer the active layer, instead of the layer below it
  • Bug fix: merging into the generated Pixel Art Grid layer, correctly merges the layer instead of deleting it.