1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
|
.. index:: Grease Pencil Modifiers
.. index:: Modifiers; Grease Pencil Modifiers
************
Introduction
************
.. reference::
:Panel: :menuselection:`Properties --> Modifiers`
Grease Pencil has their own set of modifiers.
Modifiers are automatic operations that affect an object in a non-destructive way.
With modifiers, you can perform many effects automatically that would otherwise be
too tedious to do manually and without affecting the base geometry of your object.
With :doc:`Geometry Nodes </modeling/geometry_nodes/index>`, it is possible to create custom Grease Pencil modifiers.
They work by changing how an object is displayed and rendered, but not the geometry which you can edit directly.
You can add several modifiers to a single object forming the modifier stack
and :ref:`Apply <grease-pencil_modifiers_apply>` a modifier if you wish to make its changes permanent.
There are four types of modifiers for Grease Pencil:
Edit
These are tools similar to the Deform ones (see below), however, they usually do not directly
affect the geometry of the object, but some other data, such as vertex groups.
Generate
The *Generate* group of modifiers includes constructive tools that either change
the general appearance of or automatically add new geometry to an object.
Deform
The *Deform* group of modifiers only changes the shape of an object without adding new geometry,
Color
The *Color* group of modifiers change the object color output.
Interface
=========
.. figure:: /images/grease-pencil_modifiers_introduction_interface.png
Panel layout (Thickness modifier as an example).
Each modifier's interface shares the same basic components like modifiers for meshes.
See :ref:`Modifiers Interface <bpy.types.Modifier.show>` for more information.
.. note::
Grease Pencil strokes, unlike meshes, still can not be edited directly in the place.
.. _grease-pencil_modifiers_apply:
Applying Modifiers
------------------
Applying a modifier makes the effects of the modifier "real";
converts the strokes to match the applied modifier's results, and deletes the modifier.
When applying a modifier to an object that shares Object Data between multiple objects,
the object must first be made a :ref:`Single User <data-system-datablock-make-single-user>`
which can be performed by confirming the pop-up message.
.. warning::
Applying a modifier that is not first in the stack will ignore the stack order
(it will be applied as if it was the first one), and may produce undesired results.
.. reference::
:Panel: :menuselection:`Properties --> Modifiers --> Modifier Header --> Specials`
Apply (Active Keyframe) :kbd:`Ctrl-A`
Applies the modifier for the current keyframe.
Apply (All Keyframes)
Applies the modifier for all keyframes.
.. note::
With :doc:`Geometry Nodes </modeling/index>` it is possible to add new layers to the geometry.
When applying, this will create a single keyframe on the first frame of evaluation.
Layers with duplicated names in evaluated geometry will be deduplicated.
It is also possible to have layers with empty names.
When applying these get renamed to `Layer` (and `Layer.001` etc.
when such a layer already exists in the original geometry).
.. _grease-pencil-modifier-influence-filters:
Influence Filters
-----------------
Most of the modifiers share some special properties that restrict the effect only to certain items.
Layer
Restricts the effect only to one layer or to any layers that share the same
material :ref:`Pass Index <bpy.types.MaterialGPencilStyle.pass_index>`.
Material
Restricts the effect only to material that share the same material or
material :ref:`Pass Index <bpy.types.MaterialGPencilStyle.pass_index>`.
Vertex Group
Restricts the effect only to a vertex group.
Custom Curve
When enabled, use a custom curve to shape the effect along the strokes
from start to end points.
The Invert toggle ``<->`` allows you to reverse the filters behavior.
|
