View & accessibility
Thumbnails
Motion
Bforartists
5.1
Editors

Grease Pencil Object

Grease Pencil objects each have a list of 2D layers for grouping and arranging strokes in a List view. Any stroke can only belong to a single 2D layer. There is always only one active layer in the list (the selected…

10
 min read
Up to date for 
5.1
draft

Layers panel

Layers panel

Grease Pencil objects each have a list of 2D layers for grouping and arranging strokes in a List view. Any stroke can only belong to a single 2D layer. There is always only one active layer in the list (the selected one). When you draw, the new strokes are added to the active layer. By default the view order of the layers in the viewport is top to bottom.

Every layer correspond to a channel in the Dope Sheet editor (in Grease Pencil mode). Layers can also be used together with Modifiers to only affects part of your drawing.

Layer list

Layer name

The name of the layer.

Grease pencil layers right click menu
Grease pencil layers right click menu
Grease pencil layers right click menu

A right click at a group in the list reveals a menu with further options.

When you click at a group layer, then you will reveal further options.

Edit Source

Allows you to edit the source code.

Reset Panel Zoom
Reset Panel Zoom

Resets the zoom of the panel to the default value. Note that this entry is dysfunctional. You cannot zoom the panel.

EntryWhat it does
Delete GroupDeletes the selected group. It does not keep the children, and deletes the whole hierarchy.
UngroupUngroups the selected group.
Merge GroupCombine the layers in this group into a single layer.
ColorsAllows you to color your layer groups in the list. It does not show
EntryWhat it does
Mask LayerToggle the Masks visibility in the layer.
Onion SkinningToggle the use the layer for Onion Skinning.
Viewport/Render VisibilityToggle layer visibility in the viewport and in render.
LockToggle layer from being editable.

Search Field

Search Field

You can expand a search field at the bottom of the list. Type in your term and hit enter to filter for your term.

Add New Layer

Add New Layer

Adds a new layer.

EntryWhat it does
Add New Layer GroupAdds a group. You can then drag n drop layers into it.
Remove Layer GroupDeletes the selected group. But keeps the children, and the hierarchy.

Add Extra menu

Add Extra menu
Add Extra menu

Extra operators per layer or layer group.

Add Group

Add Group

Adds a group. You can then drag n drop layers into it. The group will be added as a child when you have a group selected.

EntryWhat it does
Delete GroupDeletes the selected group. Note: Only shows on Layer Groups
UngroupUngroups the selected group. Note: Only shows on Layer Groups
Merge GroupMerges any children groups with parent group. If there are no children groups, it will merge no layer groups. Note: Only shows on Layer Groups
Move To TopMoves the active selected grease pencil layer to top
Move To BottomMoves the active selected grease pencil layer to bottom
Duplicate LayerMakes an exact copy of the selected layer appending a number to differentiate its name. This method does not duplicate empty keyframes.
Duplicate Empty KeyframesMakes an exact copy of the selected layer appending a number to differentiate its name. This method does duplicate empty keyframes.
Show AllTurns on the visibility of every layer in the list.
Hide OthersTurns off the visibility of every layer in the list except the active one.
Lock AllLocks edition of all the layers in the list
Unlock AllUnlocks edition of all the layers in the list.
Merge DownMerge the selected layer with the layer below. The new layer keeps the name of the lower layer.
Merge AllMerge the selected layer with all layers. The new layer keeps the name of the active layer.
Mask with Layer AboveMask the active layer with the layer above.
Mask with Layer BelowMask the active layer with the layer below
Copy Layer to SelectedAppends the active layer to the selected object.
Copy all Layers to SelectedAppends all layers to the selected object.
EntryWhat it does
Reorder LayerMove the selected layer up or down in the list.
Isolate LayersLocks and hides all not active layers.
Isolate layersLocks all not active layers.
Autolock Inactive layersAutomatically lock all layers except the active one to avoid accidental changes
Ignore Material LockingAllow editing strokes even if they use locked materials.

Blend Mode

Blend Mode

The layer blending operation to perform. See Color Blend Modes.

EntryWhat it does
OpacityUsed to set the opacity of the layer.
Use Scene LightingWhen enabled, the layer is affected by lights.

Layers panel - Masks subpanel

Layers panel - Masks subpanel
Layers panel - Masks subpanel

Use another grease pencil layer as a mask.

List view

EntryWhat it does
Name of the grease pencil layerThe name of the layer.
InvertInvert the mask.
HideSet mask layer visible or invisible.

Search Field

Search Field

You can expand a search field at the bottom of the list. Type in your term and hit enter to filter for your term.

Add

Add

Add a grease pencil layer as a mask layer. The layer must already exist.

EntryWhat it does
SubtractRemove the grease pencil layer from the list.
Move Up / DownMove the selected grease pencil mask one up or one down.

Layers panel - Transform subpanel

Layers panel - Transform subpanel
Layers panel - Transform subpanel

Allows to transform the current grease pencil layer in the 3d view.

Layers panel - Adjustment subpanel

Layers panel - Adjustment subpanel
Layers panel - Adjustment subpanel
EntryWhat it does
Tint ColorColor that tint any material colors used in the layer. · Factor: The Factor controls the amount of tint color to apply.
Stroke ThicknessThickness value that override the strokes thickness in the layer.

Layers panel - Relations subpanel

Layers panel - Relations subpanel
Layers panel - Relations subpanel

Select a Parent object and Type to manipulate the layer. The layer will inherit the transformations of the parent.

This can be used for rigging for cut-out animation.

Parent

The Parent object.

Type

Type

What type of object. When the parent is an armature, then you can choose between object, armature or bone.

Bone

Bone

When the type is a bone, then choose which bone of the armature.

EntryWhat it does
Pass IndexThe layer index number. It can be used with some modifiers to restrict changes to only certain areas.
View LayerDefines the View Layer to use for the Grease Pencil layer. If empty, the layer will be included in all View Layers. This is useful to separate drawings parts for compositing. · Use Masks in Render: Include the mask layer when you render the view layer. You need to have a view layer selected to reveal this option.

Layers panel - Display subpanel

Custom Channel Color

Custom Channel Color
Custom Channel Color

Sets the color to use in the channel region of the Dope Sheet.

Show Only On Keyframed

Show Only On Keyframed
Show Only On Keyframed

The layer is just visible in the viewport if it has a keyframe in the actual frame.

Onion Skinning Panel

Onion Skinning Panel

Onion Skinning show ghosts of the keyframes before and after the current frame. This allows animators to judge and pose in between two frames.

Onion Skinning Panel

Mode

Mode
EntryWhat it does
FramesShows Frames in the range determined by the Before/After settings.
KeyframesShows Keyframes in the range determined by the Before/After settings.
SelectedShows only on the manually selected keyframes in the Dope Sheet.

Opacity

Control the opacity of the ghost frames.

Filter By Type

Filter By Type

Filters what type of frames to show in the Onion Skinning range.

Keyframes Before/After

Sets how many frames or keyframes, depending on the Mode, to show before and after the current frame.

Custom Colors

Custom Colors

Before/After

Custom color of the ghost frames before and after the current frame.

Display

Display
EntryWhat it does
FadeOpacity of the ghosts frames decrease the further away from the current frame.
Show Start FrameDisplay onion keyframes on looping animations.

Settings Panel

Settings Panel

Stroke depth order

Stroke depth order
EntryWhat it does
2D LayersDisplay strokes by using the Grease Pencil layer order and stroke order to define depth.
3D LocationDisplay strokes by using the real 3D position in 3D space.

Attributes panel

Attributes panel

A list of the attributes at this object. Attributes can be used to identify an object in the shader editor or the geometry nodes editor

Add Attribute +

Add Attribute +

A List of the attributes for this mesh.

Remove Attribute -

Delete the selected attribute.

Attribute Specials menu

Attribute Specials menu

Convert Attrribute

Convert Attrribute

Change how the selected attribute is stored.

This operator opens a popup menu where you can change the settings of the attribute.

Name

The name of the attribute.

Domain
Domain

Type of element that the attribute is stored on. In this case the grease pencil layer.

Data Type
Data Type

Just Generic. What data type to use for the attribute calculation.

Vertex groups panel

Vertex groups panel

A Vertex group is a group of vertices, a selection of the mesh. It is for example used to weight a specific mesh part to a bone. Or to control the growth of hair particles.

This panel allows you to manage and edit vertex groups. Weight painting creates vertex groups automatically.

Vertex groups panel

In Edit mode this panel shows the inactive controls active.

Vertex groups exists for mesh and lattice objects.

Active Vertex Group list

A List of the vertex groups for this mesh.

EntryWhat it does
Group nameThe name of the group. It can be renamed by double clicking at it.
LockThe lock icon at the end of a group name locks the group from being editable.
Drag HandlerThe two vertical lines at the end is a handler with which you can expand the list.
Search FieldYou can expand a search field at the bottom of the list. Type in your term and hit enter to filter for your term. · Invert: Exclude the search term instead of searching for it. · Sort by Name: Sort the List by name.
EntryWhat it does
Add +Create an empty vertex group.
Remove -Deletes the active vertex group.

Vertex Group Specials menu

Vertex Group Specials menu
Vertex Group Specials menu
EntryWhat it does
Sort by NameSorts the vertex groups alphabetically by name.
Sort by Bone HierarchySorts the vertex groups by the hierarchy of the assigned bones.

Copy Vertex Group

Copy Vertex Group

Add a copy of the active vertex group as a new group. The new group will be named like the original group with “_copy” appended at the end of its name. And it will contain associations to exactly the same vertices with the exact same weights as in the source vertex group.

EntryWhat it does
Copy Vertex Groups to LinkedCopy vertex groups of this mesh to all linked objects which use the same mesh data (all users of the data).
Copy Vertex Group to SelectedCopy all vertex groups to other selected objects provided they have matching indices (typically this is true for copies of the mesh which are only deformed and not otherwise edited).
Mirror Vertex GroupMirrors weights and/or flips group names from one side of a symmetrical mesh to the other. Only mirroring along local X axis is supported. Vertices that have no corresponding vertex on the other side will not be affected. Note, the weights are not transferred to the corresponding opposite bone weight group.
Mirror Vertex Group (Topology)Performs the Mirror Vertex Group with the Topology Mirror option enabled.
Remove from All GroupsUnassigns the selected vertices from all groups. Even locked.
Clear Active GroupRemove all assigned vertices from the active group. The group is made empty. Note that the vertices may still be assigned to other vertex groups of the object. This feature does not affect locked groups.
Delete All Unlocked GroupsRemove all vertex groups from the object that are not locked.
Delete All GroupsRemove all vertex groups from the object.
Lock AllLock all groups.
Unlock AllUnlock all groups.
Lock Invert AllInvert group locks.
EntryWhat it does
Move Vertex Group UpMoves the selected vertex group up in the list.
Move Vertex Group DownMoves the selected vertex group down in the list.

Assign

Assign

Assign the selected vertices to the active vertex group.

EntryWhat it does
RemoveRemove the selected vertices from the active group.
SelectSelect all vertices in the group.
DeselectDeselect all vertices in the group.
WeightThe weight value that gets assigned to the selected vertices.

Custom Properties Panel

Custom Properties Panel

Here you can define custom properties that can be used for scripting.

Here you might also find custom properties from addons or scripts.

Add

Adds a new property.

Edit

Edit

Opens a panel where you can adjust the settings for the custom property.

Remove

Removes the property.