SZK Grease Pencil Groups++

Suzuka Ka

Addon for Blender that makes Grease Pencil better!

This Blender add-on adds groups functionality ( and more things 🎉 ) to Blender’s Grease Pencil!

SZK Grease Pencil Groups++ logo

It’s meant to make working with the Grease Pencil a more pleasant (and organized!) experience and to perform redundant tasks more quickly. Moreover, it also provides some new little features that make drawing with Grease Pencil more alike to drawing with other graphic softwares.

I made (and I’m making!) this addon for my daily use to simplify my life a bit, and I’m continously adding every improvement and idea I can think of, so its ensured to have the maximum quality possible! If you have an idea or something that you think will be cool to be implemented, I’m open to listen!

Current version: 1.4.8

Works for Blender 4.2 and below. Currently being updated to Grease Pencil 3.0.

Installation 💻

  1. Download the .zip file with the addon and place it wherever you like.
  2. In Blender, go to Edit → Preferences. Once there, press the Add-ons tab and press Install button on the top-right corner:

Untitled

  1. Select the .zip file.
  2. Once installed, search for “Grease Pencil Groups” in the search bar, and enable the addon.

Setup 🛠

The add-on pannel will appear in the Properties panel, along with the original layer panel.

To start using it, simply click the Initialize button to add the current layers in the active Grease Pencil:

setup 4.gif

💡 Note: adding a layer outside the Layers & Group panel will make the group system to be outdated. If so, don’t worry, a button will appear to refresh changes.

I personally suggest that if you preffer to use the add-on panel instead of the old layer panel, just drag it on top (or whereever you like), so you don’t miss it: drag 3.gif

I could have overriden Blender’s default layer panel, but I personally don’t like to get rid of original UI elements, in case some users would like to still use the native layer panel.

Interface 🖥️

TIP: Every button is documented and lots of operators have different options when they are pressed with CTRL/ALT/SHIFT. Everything is explained in their tooltip. Check the tooltip (by hoovering the mouse cursor) to discover new shortcuts and functionality.

=anim_webp_10-10-2023_19-13-04,39.webp

Manual ⚙

Adding Layers/Groups +

Use the New Layer and New Groups buttons to add new elements.

  1. Add Layer ✏:
    1. Hold SHIFT to add the new layer above the selected element
    2. Hold CTRL when a closed group is selected, to add the new layer into it.
    3. Hold ALT to add the new layer below the selected group/layer
  2. Add Group 📂:
    1. Hold SHIFT to place the selected element into the new group.
    2. Hold CONTROL while having selected a group to place the new group inside the selected.
    3. Hold ALT to add a group below the selected item.
    4. Hold SHIFT+CONTROL to add a new group and put all the elements that are below it inside.

Deleting a Layer/Group ❌

Click the trash icon 🗑️ next to the New Group button to delete an element.

If the selected element is a group, it will only delete the group, but leaves all their children.

You can delete the group and all its content by pressing the delete button while holding CONTROL.

delete.gif

Tip: Press SHIFT + Click to clean a Group 🧹:

clean group v2.gif

This will delete all hidden layers inside a group.

Editing layers and groups

Changing a property in a layer will affect only to that layer. Modifying a property in a group, will affect to all its layers and groups contained.

Hiding the group will hide all its elements. Also, adding a mask to a group will add that mask to all its children. If you edit masks in a group, all their children will be edited.

Hiding the group will hide all its elements. Also, adding a mask to a group will add that mask to all its children. If you edit masks in a group, all their children will be edited.

Moving elements ⤴

You can easily move the elements using the arrow buttons:

move arrows 1.gif

If you need to move an element “farther” and don’t want to move it step by step, you can use the Move To panel:

move panel.gif

There, simply click an element to put the selected element inside/above/below it (by holding SHIFT/CONTROL (see the panel for more information)).

You can trigger the Move panel in the 3D View by pressing M while being in Paint Mode

Tip: If you want to move the elements faster and directly from the list view and bypass the move menu, you can press the 👁️️ button next to the Move To panel to show/hide the move buttons/operators:

=anim_webp_12-10-2023_13-17-45,13.webp

By clicking the dots on the left, you will move the active layer/group like in the Move To panel.

Also, the same moving hotkeys apply here (see the tooltip for more info):

move panel uilist.gif

Merging Groups & Layers ⬇

You can merge layers as usual, but also combine the entire content of a group.

merge normal.gif

You can also copy a group into a single layer:

copy group to layer.gif

You can find the merge operator (and others) in the drop down menu accesed by this button in the top bar:

Untitled

Tip: You can decide what operators to show in the layer/group and top bar with “favourite operators” in preferences

The addon comes with an improved way to merge layers when their opacity is lower than 1.0*

*Blender don’t merge correctly the layers when they have transparency.

With Blender’s normal merge behaviour (the transparency changes)

With Blender’s normal merge behaviour (the transparency changes)


💪With the improved way to merge:

The result more faithful to the original state (without merging layers).

The result more faithful to the original state (without merging layers).

To activate this mode, press SHIFT + RightClick when executing the operator.

This will manually sets the (being slower to merge, but offering better results)

Customize Colors 🎨

You can edit the layer/groups colors by clicking their icon next to the name at the top of the list:

colors.gif

Tip: When changing the color of a group, you can:

  • hold SHIFT to change the color of all child groups 📂
  • hold CTRL to change the color of all layers
  • hold ALT to change all children’s colors ✏&📂

Open/close groups 📂

Click the folder icon to open/close a group.

better close.gif

You can hold ALT while clicking to open/collapse all children.

You can open/collapse all groups in the list by pressing a folder icon while holding ALT + CONTROL.

Tip: You can press SHIFT + Left Click in the group icon to add the element at the bottom directly to the group.

Press SHIFT + ALT + Left Click to ungroup the last element in the group.

Press SHIFT + Left Click to add the element below to a group

Press SHIFT + Left Click to add the element below to a group.

Press SHIFT + ALT + Left Click to ungroup the last element in the group

Press SHIFT + ALT + Left Click to ungroup the last element in the group.

Solo Modes 🔍

Blender’s solo mode has been improved*

Originally, after exiting the solo mode all layers became visible (no matter if they were originally hidden), loosing the previous visibility states.

With this addon, you don’t loose any change on your drawing since it saves its previous state.

You can solo the layers/groups visibility 👁️ and lock 🔐 state.

The lock solo mode is specially -super- useful (❗) when sculpting, editing the strokes, weight painting, moving frames in the dopesheet, etc. (I use it a lot!)

You can find them in the menu (next to the move arrows). Or you can add a shortcut to it (see Favourite Operators in Preferences).

Both solo modes offers different filter levels:

  1. Selected - Only the selected element will be visible. If the selected element is a group, all its descendants will be visible.
  2. Siblings - Only the selected element and its siblings will be visible.
  3. Top folder - All elements in the root folder (in case of existing) will be visible.

solo ez 3mb.gif

It offers 2 possibilities for the visibility solo mode:

  • Hide layers
  • Opacity fade

Read about them here.

Inherited alpha 🖌

Click the alpha button next to the layer/groups properties to activate it.

When Inherited alpha is enabled, the layer/group content will only be visible in their sibling’s opacity.

inherit alpha 1.gif

In this example, the base color and the shadow were drawn without considering whether they went outside the contour of the ball or not. When activating the alpha, its content is clipped by their siblings’ opactity, fitting perfectly into the ball’s silhouette.

This was a feature that prettends to imitate Krita’s inherited alpha.

Preferences 🛠

Settings ⚙

  • Use lighs by default - If True, (unparented*) new layers and groups will use lights when they are created.

    *If they are created inside a group, they will inherit the group’s current properties.

  • Keep Vertex colors when changing brushes - By default, each brush has its own main and secondary colour, so you lost the colour you had selected when changing to a new brush. Useful when you want to use another brush for its texture but you want to continue painting with the colour you had selected.

  • Solo visibility mode - Select the method used when soloing the layers’ visibility.

    • Offers 2 options:

      1. Hide layers: only the layers filtered will be visible, while the others will be completely hidden.

        solo hide.gif

      2. Opactiy fade: the layers filtered will be visible with its original opacity, while the rest will be faded by the selected opacity percentage in prefferences.

        solo opacity skull.gif


  • Duplicate Prefixes/Suffixes - Set the prefixes (left) and suffixes (right) added when duplicating a group and a layer.

  • Automatic check for new versions - If True (recommended), the addon will automatically check if there is a newer version uploaded.

This check happens only once when loading Blender

Appearance 👁️

  • Visibility icons on the left side - If True, the hide/show icon will be placed on the left (like in other graphic softwares like Krita or Photoshop).

=anim_webp_11-10-2023_14-03-50,28.webp

  • Show properties in list - Decide if showing of not extra info in the list.

    1. Use lights - Indicates if the layer/group is affected by lights

    2. Blend Mode - Shows an icon with the blend mode used when is different than ‘Regular’

    3. Opacity - Shows the opacity directly in the list when it is different than 100%.

      Untitled

    4. Parent - Show a bone icon when the layer/group is parented to another object.

    =anim_webp_12-10-2023_11-26-14,64.webp

Favourite Operators

You can select your favourite actions in order to show them in the top bar and in the selected layer/group.

fav operators 3.png

Hover/place the mouse over the icons to see their function.

Hotkeys ⌨

Hotkeys for the new functionalities.

Grease Pencil Paint mode 🖌

A - Switch between first and secondary color

E - Switch between Draw and Eraser

ALT + E - Switch between Paint and Sculpt mode

ALT + A - Pick/sample vertex color under mouse. (No need to manually go to the color each time to activate the color picker❗ 🎉🥳)

The colors are being sampled directly from the letters while painting (No need to go to the property and press E to activate the eyedropper 🥳)

The colors are being sampled directly from the letters while painting (No need to go to the property and press E to activate the eyedropper 🥳)

SHIFT + A - Select previous Brush.

M - (In 3D View) Show “Move panel”

Grease Pencil Edit mode 📐

M - (In 3D View) Move selected strokes to another layer


OPH.webp

FAQ❔

  • Why do you write a FAQ section if no one has asked you a single question related the add-on?

    Thats a very good question. I don’t know. I guess that if I ever got asked about something “frequently” (more than 0 times), I’ll clarify it here in case it’s useful for others 🐢.

  • Why did you put icons on the header?

    I personally like when I can distinguish clearly when some functionality comes from an addon I have installed and is not something native from Blender. Also, since I decided not to override the original Layer panel (in case someone would like to continue using it while having this addon installed), I wanted to make the panel to stand out from the other one.

    • Also, I like to show my dog, Dex:

      WhatsApp Image 2023-07-02 at 23.36.05.jpeg

Contact ✉

Twitter: @SuzukaKDev

Mail: suzukakadev@gmail.com


Related articles