Grease Pencil: Layer Groups, Attributes, and some updates #104955

Merged
Falk David merged 12 commits from filedescriptor/blender-manual:gpv3-manual-updates into blender-v4.3-release 2024-10-08 17:28:05 +02:00
6 changed files with 44 additions and 34 deletions

View File

@ -50,9 +50,6 @@ Shear :kbd:`Shift-Ctrl-Alt-S`
To Sphere :kbd:`Shift-Alt-S` To Sphere :kbd:`Shift-Alt-S`
Move selected points outward in a spherical shape around the selected strokes' center. Move selected points outward in a spherical shape around the selected strokes' center.
Transform Fill
Change the Translation, Rotation and scale of strokes fill.
:ref:`Interpolate <tool-grease-pencil-draw-interpolate>` :kbd:`Ctrl-E` :ref:`Interpolate <tool-grease-pencil-draw-interpolate>` :kbd:`Ctrl-E`
Automatically create a breakdown keyframe between two normal keyframes. Automatically create a breakdown keyframe between two normal keyframes.

View File

@ -14,6 +14,8 @@ Modifiers are automatic operations that affect an object in a non-destructive wa
With modifiers, you can perform many effects automatically that would otherwise be 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. 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. 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 You can add several modifiers to a single object forming the modifier stack
and *Apply* a modifier if you wish to make its changes permanent. and *Apply* a modifier if you wish to make its changes permanent.
@ -22,7 +24,7 @@ and *Apply* a modifier if you wish to make its changes permanent.
Grease Pencil Modifiers menu. Grease Pencil Modifiers menu.
There are three types of modifiers for Grease Pencil: There are four types of modifiers for Grease Pencil:
Edit Edit
These are tools similar to the Deform ones (see below), however, they usually do not directly These are tools similar to the Deform ones (see below), however, they usually do not directly
@ -36,8 +38,6 @@ Color
The *Color* group of modifiers change the object color output. The *Color* group of modifiers change the object color output.
.. _bpy.ops.object.gpencil_modifier_apply:
Interface Interface
========= =========

View File

@ -17,6 +17,7 @@ Grease Pencil
Strokes can be grouped in 2D layers, a special Grease Pencil layers Strokes can be grouped in 2D layers, a special Grease Pencil layers
that help to organize the drawing order and visibility of the strokes. that help to organize the drawing order and visibility of the strokes.
Layers can be organized into layer groups.
:doc:`Onion Skinning </grease_pencil/properties/onion_skinning>` :doc:`Onion Skinning </grease_pencil/properties/onion_skinning>`
@ -37,11 +38,19 @@ General settings for Grease Pencil strokes.
Attributes Attributes
========== ==========
An attribute is data stored per curve element. Every attribute has a data type, domain and name. Layers can store :doc:`Custom Attributes </modeling/geometry_nodes/attributes_reference>`.
This panel only lists custom attributes which excludes all the built-in attributes like ``position`` and The attributes are stored on the :ref:`Layer <attribute-domains>` domain.
other attributes like vertex groups.
See :doc:`Attributes Reference </modeling/geometry_nodes/attributes_reference>` for more information. For example, the :ref:`Layer Adjustments <layer-adjustments>` are stored as layer attributes.
Attributes
:ref:`List view <ui-list-view>` of all the attributes stored on the layers.
Name
Name of the layer attribute.
Data Type
The :ref:`Data Type <attribute-data-types>` of the attribute.
:doc:`Vertex Groups </modeling/meshes/properties/vertex_groups/index>` :doc:`Vertex Groups </modeling/meshes/properties/vertex_groups/index>`
@ -64,3 +73,4 @@ Create and manage your own properties to store data in the Grease Pencil's data-
layers.rst layers.rst
onion_skinning.rst onion_skinning.rst
strokes.rst strokes.rst

View File

@ -15,13 +15,18 @@ Layers
Grease Pencil Layers panel. Grease Pencil Layers panel.
Grease Pencil objects can be organized into a tree known as layers for grouping and arranging strokes. Grease Pencil objects can be organized into a tree known as the layer tree for grouping and arranging strokes.
Any stroke can only belong to a single 2D layer. Any stroke can only belong to a single 2D layer.
There is always only one active layer in the list (the selected one). The selected layer is the active layer. Only one layer or group can be active at a time.
When you draw, the new strokes are added to the active layer. 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. By default the view order of the layers in the viewport is top to bottom.
Layers can be grouped using Layer Groups.
A layer can only be in one group at a time.
Layers can be moved into groups using drag-and-drop.
Groups can be color coded with a color tag.
Every layer correspond to a channel in the Dope Sheet editor (in Grease Pencil mode). Every layer correspond to a channel in the Dope Sheet editor (in Grease Pencil mode).
See :doc:`Dope Sheet </editors/dope_sheet/modes/grease_pencil>` for more information. See :doc:`Dope Sheet </editors/dope_sheet/modes/grease_pencil>` for more information.
@ -48,8 +53,8 @@ the layer becomes prepared to be masked by other layer(s).
Activate *Fade Inactive Layers* in overlays to control the opacity of the non-active layers. Activate *Fade Inactive Layers* in overlays to control the opacity of the non-active layers.
See :doc:`Overlays </editors/3dview/display/overlays>` for more information. See :doc:`Overlays </editors/3dview/display/overlays>` for more information.
Layers List Layer Tree
:ref:`List view <ui-list-view>` of all layers for the Grease Pencil object. Tree view of all layers and groups for the Grease Pencil object.
Next to the layer name there are four icons buttons that control common properties of the layer: Next to the layer name there are four icons buttons that control common properties of the layer:
@ -113,7 +118,7 @@ Layer Specials
Merge Down Merge Down
Combine the selected layer with the layer below, the new layer keeps the name of the lower layer. Combine the selected layer with the layer below, the new layer keeps the name of the lower layer.
Merge Group Merge Group
Combine layers in the active group into a single layer. Combine layers in the active layer group into a single layer.
Merge All Merge All
Combine all layers into the active layer. Combine all layers into the active layer.
@ -123,13 +128,13 @@ Layer Specials
Copy All Layers to Selected Copy All Layers to Selected
Copy all layers to the selected Grease Pencil object. Copy all layers to the selected Grease Pencil object.
.. .. _bpy.ops.gpencil.layer_isolate: .. _bpy.ops.grease_pencil.layer_isolate:
.. Visibility (screen icon) Visibility (screen icon)
.. Toggle whether the active layer is the only one that can be edited and is visible. Toggle whether the active layer is the only one that can be edited and is visible.
.. Isolate Lock (padlock icon) Isolate Lock (padlock icon)
.. Toggle whether the active layer is the only one that can be edited. Toggle whether the active layer is the only one that can be edited.
Below the layers list there are additional settings: Below the layers list there are additional settings:
@ -201,6 +206,8 @@ Transform
Allows per-layer location, rotation and scale transformations. Allows per-layer location, rotation and scale transformations.
.. _layer-adjustments:
Adjustments Adjustments
=========== ===========

View File

@ -19,25 +19,25 @@ See :doc:`2D Layers </grease_pencil/properties/layers>` for more information.
Options Options
======= =======
.. _bpy.types.GreasePencil.onion_mode: .. _bpy.types.GreasePencilv3.onion_mode:
Mode Mode
:Keyframes: Shows Keyframes in the range determined by the *Before*/*After* settings. :Keyframes: Shows Keyframes in the range determined by the *Before*/*After* settings.
:Frames: Shows Frames in the range determined by the *Before*/*After* settings. :Frames: Shows Frames in the range determined by the *Before*/*After* settings.
:Selected: Shows only on the manually selected keyframes in the Dope Sheet. :Selected: Shows only on the manually selected keyframes in the Dope Sheet.
.. _bpy.types.GreasePencil.onion_factor: .. _bpy.types.GreasePencilv3.onion_factor:
Opacity Opacity
Control the opacity of the ghost frames. Control the opacity of the ghost frames.
.. _bpy.types.GreasePencil.onion_keyframe_type: .. _bpy.types.GreasePencilv3.onion_keyframe_type:
Filter by Type Filter by Type
Filters what type of frames to show in the Onion Skinning range. Filters what type of frames to show in the Onion Skinning range.
.. _bpy.types.GreasePencil.ghost_before_range: .. _bpy.types.GreasePencilv3.ghost_before_range:
.. _bpy.types.GreasePencil.ghost_after_range: .. _bpy.types.GreasePencilv3.ghost_after_range:
Keyframes Before/After Keyframes Before/After
Sets how many frames or keyframes, depending on the *Mode*, to show before and after the current frame. Sets how many frames or keyframes, depending on the *Mode*, to show before and after the current frame.
@ -46,8 +46,8 @@ Keyframes Before/After
Custom Colors Custom Colors
============= =============
.. _bpy.types.GreasePencil.before_color: .. _bpy.types.GreasePencilv3.before_color:
.. _bpy.types.GreasePencil.after_color: .. _bpy.types.GreasePencilv3.after_color:
Before/After Before/After
Color to use before and after the current frame on ghost frames. Color to use before and after the current frame on ghost frames.
@ -56,17 +56,12 @@ Before/After
Display Display
======= =======
.. _bpy.types.GreasePencil.use_ghosts_always: .. _bpy.types.GreasePencilv3.use_onion_fade:
View in Render
Show the onion skinning in final render image e.g. for a motion blur effect.
.. _bpy.types.GreasePencil.use_onion_fade:
Fade Fade
Opacity of the ghosts frames decrease the further away from the current frame. Opacity of the ghosts frames decrease the further away from the current frame.
.. _bpy.types.GreasePencil.use_onion_loop: .. _bpy.types.GreasePencilv3.use_onion_loop:
Show Start Frame Show Start Frame
Help working on loop animations showing the first keyframe/frame Help working on loop animations showing the first keyframe/frame

View File

@ -128,6 +128,7 @@ to determine the domains of attributes.
- **Instance** domain attributes exist on the :doc:`/modeling/geometry_nodes/instances` in a geometry. - **Instance** domain attributes exist on the :doc:`/modeling/geometry_nodes/instances` in a geometry.
They can be used to store different values on copies of geometry data. Instance domain attributes are They can be used to store different values on copies of geometry data. Instance domain attributes are
only supported in geometry nodes. only supported in geometry nodes.
- **Layer** domain attributes are associated with a :doc:`Grease Pencil Layer </grease_pencil/properties/layers>`.
Attributes are automatically interpolated to other domains. For example, when the Attributes are automatically interpolated to other domains. For example, when the
:doc:`/modeling/geometry_nodes/geometry/read/position` is connected to the selection input of :doc:`/modeling/geometry_nodes/geometry/read/position` is connected to the selection input of