File: introduction.rst

package info (click to toggle)
blender-doc 4.3-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 253,604 kB
  • sloc: python: 13,030; javascript: 322; makefile: 113; sh: 107
file content (88 lines) | stat: -rw-r--r-- 2,688 bytes parent folder | download
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

************
Introduction
************

.. _editors-graph_editor-channels_region:

Channels Region
===============

.. figure:: /images/editors_graph-editor_channels_region.png

   The Channels region.

This region is found on the left side of time-based editors like the :doc:`/editors/timeline`,
the :doc:`Dope Sheet Editor </editors/dope_sheet/introduction>`, and the Graph Editor.
It shows a tree of items (objects, bones...) and their animated properties,
with the latter also being called "channels." Each channel has an associated F-curve
describing how its value changes over time.

The rows are color-coded as follows:

- Dark blue: scenes, objects
- Light blue: :doc:`actions </animation/actions>`, :doc:`shape keys </animation/shape_keys/index>` etc.
- Green: channel groups
- Gray: channels

.. _bpy.types.DopeSheet.use_filter_invert:
.. _bpy.types.DopeSheet.filter_text:

Search :kbd:`Ctrl-F`
   Lets you filter the channels by typing a part of their name. Click the Invert button to instead
   show channels that *don't* include the search text.


Controls
--------

The headers contain the following toggle buttons:

Pin (pin icon)
   Keep the row and its children visible even when selecting a different object.
Hide (eye icon)
   Hides the keyframes and curve associated with the channel.
Modifiers (wrench icon)
   Deactivates the modifiers of the curve.
Mute (checkbox)
   Deactivates the curve, making the animation behave as though it doesn't exist.
Lock :kbd:`Tab` (padlock icon)
   Prevent the curve from being edited.

   .. note::

      This also works in the :doc:`Nonlinear Animation Editor </editors/nla/introduction>`,
      but note that it only locks the strips there, not the underlying F-curves.


Selection
---------

- Select single header: click :kbd:`LMB`
- Add/Remove single header to/from selection: click :kbd:`Ctrl-LMB`
- Select range: click :kbd:`Shift-LMB`
- Select All: :kbd:`A`
- Deselect All: press :kbd:`Alt-A` or double-tap :kbd:`A`
- Box Select: drag :kbd:`LMB`
- Box Add: drag :kbd:`Shift-LMB`
- Box Remove: drag :kbd:`Ctrl-LMB`
- Select all keyframes in the channel: double-click :kbd:`LMB` on its header.


Editing
-------

- Rename (anything but a channel): double-click :kbd:`LMB`
- Delete selected: :kbd:`X` or :kbd:`Delete`
- Lock selected: :kbd:`Tab`

Sliders
^^^^^^^

.. figure:: /images/editors_dope-sheet_introduction_action-editor-sliders.png

   The Action editor showing sliders.

If you enable :menuselection:`View --> Show Sliders`, the region will show a
value slider next to each channel. Changing such a slider will change the value
of the curve at the current frame, creating a keyframe if one doesn't already exist.