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
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
|
*****
Usage
*****
Drivers can be added to properties via their context menu, a shortcut, copy-pasted,
or by typing an expression directly into the property's value.
After adding drivers, they are usually modified in the :doc:`Drivers editor </editors/drivers_editor>`,
or via a simplified *Edit Driver* popover invoked from the property context menu.
.. _bpy.ops.anim.driver_button_add:
Add Driver
==========
.. reference::
:Menu: :menuselection:`Context menu --> Add Driver`
:Shortcut: :kbd:`Ctrl-D`
The usual way to add a driver to a property is to :kbd:`RMB` click a property,
then choose *Add Driver* in the context menu.
Drivers can also be added by pressing :kbd:`Ctrl-D` with the mouse over the property.
This operation adds a driver with a single variable (which needs to be filled in),
and displays the *Edit Driver* popover.
.. _bpy.ops.anim.driver_button_edit:
Edit Driver
===========
.. reference::
:Menu: :menuselection:`Context menu --> Edit Driver`
Displays a popover window that allows editing the custom expression and input variables
of the driver without opening the full *Drivers Editor*.
Many drivers don't use their :doc:`F-Curve </editors/graph_editor/fcurves/introduction>`
component, so this reduced interface is sufficient.
.. _bpy.ops.screen.drivers_editor_show:
Open Drivers Editor
===================
.. reference::
:Menu: :menuselection:`Context menu --> Open Drivers Editor`
Opens a new window with the *Drivers Editor* and
selects the driver associated with the property.
.. _bpy.ops.anim.copy_driver_button:
.. _bpy.ops.anim.paste_driver_button:
Copy & Paste
============
.. reference::
:Menu: :menuselection:`Context menu --> Copy Driver`
:Menu: :menuselection:`Context menu --> Paste Driver`
Drivers can be copied and pasted via the context menu.
When adding drivers with the same settings, this can save time modifying settings.
.. _bpy.ops.ui.copy_driver_to_selected_button:
Copy Driver to Selected
=======================
.. reference::
:Menu: :menuselection:`Context menu --> Copy Drivers to Selected`
:Menu: :menuselection:`Context menu --> Copy Driver to Selected`
:Menu: :menuselection:`Context menu --> Copy All Drivers to Selected`
Copy the property's driver from the active item to the same
property of all selected items, if the same property exists.
.. _bpy.ops.ui.copy_as_driver_button:
Copy As New Driver
==================
.. reference::
:Menu: :menuselection:`Context menu --> Copy As New Driver`
A driver that sets the property value to the value of a different property can be
quickly created by using the *Copy As New Driver* context menu option of the input
property, and then pasting the result onto the output property via *Paste Driver*.
It is also possible to add the new driver variable to an existing driver using
the :ref:`Paste Driver Variables <drivers-variables>` button in the editor panel.
Expression
==========
This is a quick way to add drivers with a scripted expression.
First click the property you want to add a driver to, then type a hash ``#`` and a scripted expression.
Some examples:
- ``#frame``
- ``#frame / 20.0``
- ``#sin(frame)``
- ``#cos(frame)``
.. _bpy.ops.anim.driver_button_remove:
Removing Drivers
================
.. reference::
:Menu: :menuselection:`Context menu --> Delete Driver(s)`
:Menu: :menuselection:`Context menu --> Delete Single Driver`
:Shortcut: :kbd:`Ctrl-Alt-D`
Removes driver(s) associated with the property, either for the single selected property
or sub-channel, or all components of a vector.
|
